From 55db5a65759e9058cb4f4ca76f1daabd06ccb440 Mon Sep 17 00:00:00 2001
From: UneBaguette <28904802+UneBaguette@users.noreply.github.com>
Date: Sat, 25 Apr 2026 18:52:41 +0200
Subject: [PATCH] chore: optimize build, removed duplicate README

---
 Makefile              |   8 +-
 README.md             |  10 +--
 scripts/tpl/README.md | 188 ------------------------------------------
 3 files changed, 9 insertions(+), 197 deletions(-)
 delete mode 100644 scripts/tpl/README.md

diff --git a/Makefile b/Makefile
index 0724dab..f462aad 100644
--- a/Makefile
+++ b/Makefile
@@ -1,11 +1,11 @@
 ROOT := pkg
 CRATE := blake3_wasm_rs
-VERSION := 0.4.0
+VERSION := 0.4.1
 
 CARGO := cargo
 WASM_BINDGEN := wasm-bindgen
 WASM_OPT := wasm-opt
-WASM_OPT_FLAGS := --enable-bulk-memory --enable-nontrapping-float-to-int -O
+WASM_OPT_FLAGS := --enable-bulk-memory --enable-nontrapping-float-to-int -O3
 WASM_TARGET := wasm32-unknown-unknown
 TARGET_DIR := target/$(WASM_TARGET)/release
 
@@ -20,7 +20,7 @@ build: build-all node-esm
 
 build-all:
 	@echo "Building all target..."
-	RUSTFLAGS='-C opt-level=s' $(CARGO) build --target $(WASM_TARGET) --release --features talc
+	RUSTFLAGS='-C opt-level=3' $(CARGO) build --target $(WASM_TARGET) --release --features talc
 	@mkdir -p $(ROOT)/bundler $(ROOT)/web $(ROOT)/node
 	$(WASM_BINDGEN) --target bundler --out-dir $(ROOT)/bundler $(TARGET_DIR)/$(CRATE).wasm
 	$(WASM_BINDGEN) --target web --out-dir $(ROOT)/web $(TARGET_DIR)/$(CRATE).wasm
@@ -34,7 +34,7 @@ build-all:
 	@echo '{"type":"commonjs"}' > $(ROOT)/node/package.json
 	@cp scripts/tpl/index.js.template $(ROOT)/index.js
 	@cp scripts/tpl/index.d.ts $(ROOT)/index.d.ts
-	@cp scripts/tpl/README.md $(ROOT)/README.md
+	@cp README.md $(ROOT)/README.md
 	@cp LICENSE $(ROOT)/LICENSE
 	@sed -i 's|// @ts-nocheck|// Types|' $(ROOT)/index.d.ts
 	@node -e "\
diff --git a/README.md b/README.md
index 2bfadab..3063d08 100644
--- a/README.md
+++ b/README.md
@@ -171,11 +171,11 @@ Tested on **Ryzen 7 5800X**, Node.js v24.
 
 | Size  | @noble/hashes | awasm-noble | awasm-noble (threads) | blake3-wasm |
 |-------|---------------|-------------|-----------------------|-------------|
-| 32 B  | 11 MB/s       | 34 MB/s     | 45 MB/s               | 70 MB/s     |
-| 1 KB  | 56 MB/s       | 499 MB/s    | 526 MB/s              | 885 MB/s    |
-| 64 KB | 52 MB/s       | 1,729 MB/s  | 1,684 MB/s            | 2,037 MB/s  |
-| 1 MB  | 51 MB/s       | 1,550 MB/s  | 4,036 MB/s            | 1,829 MB/s  |
-| 10 MB | 50 MB/s       | 1,497 MB/s  | 4,946 MB/s            | 1,877 MB/s  |
+| 32 B  | 11 MB/s       | 34 MB/s     | 45 MB/s               | 84 MB/s     |
+| 1 KB  | 56 MB/s       | 499 MB/s    | 526 MB/s              | 851 MB/s    |
+| 64 KB | 52 MB/s       | 1,729 MB/s  | 1,684 MB/s            | 2,014 MB/s  |
+| 1 MB  | 51 MB/s       | 1,550 MB/s  | 4,036 MB/s            | 1,787 MB/s  |
+| 10 MB | 50 MB/s       | 1,497 MB/s  | 4,946 MB/s            | 1,899 MB/s  |
 
 ## Security
 
diff --git a/scripts/tpl/README.md b/scripts/tpl/README.md
deleted file mode 100644
index 2bfadab..0000000
--- a/scripts/tpl/README.md
+++ /dev/null
@@ -1,188 +0,0 @@
-# blake3-wasm-rs
-
-[![npm version](https://img.shields.io/npm/v/blake3-wasm-rs)](https://www.npmjs.com/package/blake3-wasm-rs)
-[![CI](https://github.com/UneBaguette/blake3.wasm/actions/workflows/ci.yml/badge.svg)](https://github.com/UneBaguette/blake3.wasm/actions/workflows/ci.yml)
-[![license](https://img.shields.io/npm/l/blake3-wasm-rs)](https://github.com/UneBaguette/blake3.wasm/blob/master/LICENSE)
-[![npm downloads](https://img.shields.io/npm/dm/blake3-wasm-rs)](https://www.npmjs.com/package/blake3-wasm-rs)
-
-**blake3-wasm-rs** is a WebAssembly port of the BLAKE3 cryptographic hash function written in **Rust**. It enables fast and secure hashing right inside **browsers** and **Node.js**.
-
-## build
-
-```sh
-# lets build it!
-
-# For NodeJS
-wasm-pack build --target nodejs --release
-
-# For the web!
-wasm-pack build --target web --release
-```
-
-SIMD is enabled via `wasm32_simd` feature in `Cargo.toml` and requires:
-```toml
-# .cargo/config.toml
-[target.wasm32-unknown-unknown]
-rustflags = ["-C", "target-feature=+simd128"]
-```
-
-## Usage
-
-```ts
-import * as blake3 from 'blake3-wasm-rs';
-
-const data = new TextEncoder().encode('hello world');
-const key = new Uint8Array(32).fill(1);
-
-// One-shot hashing
-blake3.hash(data);
-blake3.hashXof(data, 64);        // variable output length
-blake3.keyedHash(data, key);     // key must be exactly 32 bytes
-blake3.deriveKey('my context', key);
-
-// Conctruct for Streaming
-{
-    using h = new blake3.Hasher();
-    h.update(data.slice(0, 5));
-    h.update(data.slice(5));
-    h.finalize();
-    h.finalizeXof(64);
-    h.reset();
-}
-
-// Streaming
-// Keyed (MAC mode)
-{
-    using mac = blake3.Hasher.newKeyed(key);
-    mac.update(data);
-    mac.finalize();
-}
-
-// Streaming
-// Key derivation mode
-{
-    using kdf = blake3.Hasher.newDeriveKey('my app v1 :: subkey');
-    kdf.update(key);
-    kdf.finalize();
-}
-
-// Batch hashing without re-allocating
-{
-    using h = new blake3.Hasher();
-    h.update(chunk1);
-    const first = h.finalizeAndReset();
-    h.update(chunk2);
-    const second = h.finalizeAndReset();
-}
-```
-
-#### Named imports
-
-```ts
-import { hash, hashXof, keyedHash, deriveKey, Hasher } from 'blake3-wasm-rs';
-
-const data = new TextEncoder().encode('hello world');
-const key = new Uint8Array(32).fill(1);
-
-// One-shot hashing
-hash(data);
-hashXof(data, 64);          // variable output length
-keyedHash(data, key);       // key must be exactly 32 bytes
-deriveKey('my context', key);
-
-// Streaming
-{
-    using h = new Hasher();
-    h.update(data.slice(0, 5));
-    h.update(data.slice(5));
-    h.finalize();
-    h.finalizeXof(64);
-    h.reset();
-}
-
-// Keyed (MAC mode)
-{
-    using mac = Hasher.newKeyed(key);
-    mac.update(data);
-    mac.finalize();
-}
-
-// Key derivation mode
-{
-    using kdf = Hasher.newDeriveKey('my app v1 :: subkey');
-    kdf.update(key);
-    kdf.finalize();
-}
-
-// Batch hashing without re-allocating
-{
-    using h = new Hasher();
-    h.update(chunk1);
-    const first = h.finalizeAndReset();
-    h.update(chunk2);
-    const second = h.finalizeAndReset();
-}
-```
-
-## API
-
-### Functions
-
-| Function                          | Returns      | Description                                     |
-|-----------------------------------|--------------|-------------------------------------------------|
-| `hash(data)`                      | `Uint8Array` | One-shot 32-byte BLAKE3 digest                  |
-| `hashXof(data, outLen)`           | `Uint8Array` | Variable-length digest (XOF mode)               |
-| `keyedHash(data, key)`            | `Uint8Array` | Keyed hash / MAC (key must be exactly 32 bytes) |
-| `deriveKey(context, keyMaterial)` | `Uint8Array` | Derive a 32-byte subkey                         |
-
-### Hasher class
-
-| Method                         | Returns      | Description                                               |
-|--------------------------------|--------------|-----------------------------------------------------------|
-| `new Hasher()`                 | `Hasher`     | Streaming hasher, unkeyed                                 |
-| `Hasher.newKeyed(key)`         | `Hasher`     | Streaming hasher, MAC mode (key must be exactly 32 bytes) |
-| `Hasher.newDeriveKey(context)` | `Hasher`     | Streaming hasher, KDF mode                                |
-| `.update(data)`                | `void`       | Feed data, can be called multiple times                   |
-| `.finalize()`                  | `Uint8Array` | 32-byte digest, non-destructive                           |
-| `.finalizeXof(outLen)`         | `Uint8Array` | Variable-length digest, non-destructive                   |
-| `.finalizeAndReset()`          | `Uint8Array` | Finalize then reset (useful for batch hashing)            |
-| `.reset()`                     | `void`       | Reset to initial state, preserves mode                    |
-| `.free()`                      | `void`       | Release WASM memory manually (prefer `using` instead)     |
-
-> **Memory management:** In all modern browsers (and wasm-bindgen ≥ 0.2.91), WASM memory is freed automatically via the TC39 weak references proposal when the JS object goes out of scope.
-> 
-> In practice, you often don't need to think about this. For deterministic cleanup or environments without weak reference support (older browsers, some Node.js setups), use `using` (TypeScript 5.2+ / ES2026) or call `.free()` manually. 
-> 
-> Never call `.free()` on a `using`-managed instance otherwise it will double-free.
-
-## Benchmarks
-
-Tested on **Apple M4**, Node.js v24.
-
-| Size  | @noble/hashes | awasm-noble | awasm-noble (threads) | blake3-wasm |
-|-------|---------------|-------------|-----------------------|-------------|
-| 32 B  | 28 MB/s       | 105 MB/s    | 94 MB/s               | 129 MB/s    |
-| 1 KB  | 105 MB/s      | 843 MB/s    | 819 MB/s              | 568 MB/s    |
-| 64 KB | 102 MB/s      | 1,898 MB/s  | 1,855 MB/s            | 2,004 MB/s  |
-| 1 MB  | 101 MB/s      | 1,943 MB/s  | 4,711 MB/s            | 1,893 MB/s  |
-| 10 MB | 101 MB/s      | 1,911 MB/s  | 6,456 MB/s            | 2,185 MB/s  |
-
-Tested on **Ryzen 7 5800X**, Node.js v24.
-
-| Size  | @noble/hashes | awasm-noble | awasm-noble (threads) | blake3-wasm |
-|-------|---------------|-------------|-----------------------|-------------|
-| 32 B  | 11 MB/s       | 34 MB/s     | 45 MB/s               | 70 MB/s     |
-| 1 KB  | 56 MB/s       | 499 MB/s    | 526 MB/s              | 885 MB/s    |
-| 64 KB | 52 MB/s       | 1,729 MB/s  | 1,684 MB/s            | 2,037 MB/s  |
-| 1 MB  | 51 MB/s       | 1,550 MB/s  | 4,036 MB/s            | 1,829 MB/s  |
-| 10 MB | 50 MB/s       | 1,497 MB/s  | 4,946 MB/s            | 1,877 MB/s  |
-
-## Security
-
-The underlying `blake3` Rust crate targets algorithmic constant time. However, the JavaScript boundary (via napi-rs or WASM) introduces non-determinism from the V8 runtime that is outside our control. For absolute security, use the `blake3` Rust crate directly in a Rust program.
-
-## See also
-
-- [@noble/hashes](https://github.com/paulmillr/noble-hashes) | pure JS implementation
-- [awasm-noble](https://github.com/paulmillr/awasm-noble) | auditable WASM implementation
-- [blake3-napi](https://github.com/UneBaguette/blake3-napi)  | native Node.js addon, faster for large inputs