distillate 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 //#region src/index.d.ts
-declare const VERSION = "0.1.0";
+/** The installed `distillate` package version. */
+declare const VERSION: string;
 //#endregion
 export { VERSION };

package/dist/index.js

@@ -1,4 +1,6 @@
+//#endregion
 //#region src/index.ts
-const VERSION = "0.1.0";
+/** The installed `distillate` package version. */
+const VERSION = "0.1.2";
 //#endregion
 export { VERSION };

package/dist/{serialize-E_4WyueA.js → serialize-5XQ5y_R-.js}

@@ -13,6 +13,12 @@ const C2LO = 658871167;
 const C2HI = 1291169091;
 let RLO = 0;
 let RHI = 0;
+const LANES = {
+	h1lo: 0,
+	h1hi: 0,
+	h2lo: 0,
+	h2hi: 0
+};
 function mul64(alo, ahi, blo, bhi) {
 	const a0 = alo & 65535;
 	const a1 = alo >>> 16;
@@ -75,8 +81,7 @@ function fmix64(lo, hi) {
 	RLO = l;
 	RHI = h;
 }
-function hash128(bytes, seed = 0) {
-	const len = bytes.length;
+function computeLanes(bytes, seed, len) {
 	const nblocks = len >>> 4;
 	let h1lo = seed >>> 0;
 	let h1hi = 0;
@@ -174,12 +179,30 @@ function hash128(bytes, seed = 0) {
 	add64(h2lo, h2hi, h1lo, h1hi);
 	h2lo = RLO;
 	h2hi = RHI;
-	return {
-		h1lo: h1lo >>> 0,
-		h1hi: h1hi >>> 0,
-		h2lo: h2lo >>> 0,
-		h2hi: h2hi >>> 0
-	};
+	LANES.h1lo = h1lo >>> 0;
+	LANES.h1hi = h1hi >>> 0;
+	LANES.h2lo = h2lo >>> 0;
+	LANES.h2hi = h2hi >>> 0;
+}
+const keyEncoder = new TextEncoder();
+let keyBuf = /* @__PURE__ */ new Uint8Array(256);
+function keyToLanes(key, seed) {
+	if (typeof key === "string") {
+		const cap = key.length * 3;
+		if (keyBuf.length < cap) keyBuf = new Uint8Array(cap);
+		const { written } = keyEncoder.encodeInto(key, keyBuf);
+		computeLanes(keyBuf, seed, written);
+		return;
+	}
+	const bytes = normalize(key);
+	computeLanes(bytes, seed, bytes.length);
+}
+function hash128KeyInto(key, seed, out) {
+	keyToLanes(key, seed);
+	out.h1lo = LANES.h1lo;
+	out.h1hi = LANES.h1hi;
+	out.h2lo = LANES.h2lo;
+	out.h2hi = LANES.h2hi;
 }
 function reduce(x, range) {
 	const xlo = x & 65535;
@@ -199,9 +222,9 @@ function reduce(x, range) {
 * (the RocksDB `+i^2` fix), reduced into range with Lemire multiply-shift.
 */
 function probeInto(key, count, range, seed, out) {
-	const { h1lo, h1hi, h2lo, h2hi } = hash128(normalize(key), seed);
-	const a = (h1lo ^ h1hi) >>> 0;
-	const b = (h2lo ^ h2hi) >>> 0;
+	keyToLanes(key, seed);
+	const a = (LANES.h1lo ^ LANES.h1hi) >>> 0;
+	const b = (LANES.h2lo ^ LANES.h2hi) >>> 0;
 	for (let i = 0; i < count; i++) out[i] = reduce(a + Math.imul(i, b) + i * i >>> 0, range);
 }
 //#endregion
@@ -268,4 +291,4 @@ function readHeader(frame) {
 	};
 }
 //#endregion
-export { probeInto as a, hash128 as i, readHeader as n, reduce as o, writeHeader as r, normalize as s, SerializationError as t };
+export { probeInto as a, hash128KeyInto as i, readHeader as n, reduce as o, writeHeader as r, SerializationError as t };

package/dist/{serialize-C5rwVPvv.cjs → serialize-CHHDM4TQ.cjs}

@@ -13,6 +13,12 @@ const C2LO = 658871167;
 const C2HI = 1291169091;
 let RLO = 0;
 let RHI = 0;
+const LANES = {
+	h1lo: 0,
+	h1hi: 0,
+	h2lo: 0,
+	h2hi: 0
+};
 function mul64(alo, ahi, blo, bhi) {
 	const a0 = alo & 65535;
 	const a1 = alo >>> 16;
@@ -75,8 +81,7 @@ function fmix64(lo, hi) {
 	RLO = l;
 	RHI = h;
 }
-function hash128(bytes, seed = 0) {
-	const len = bytes.length;
+function computeLanes(bytes, seed, len) {
 	const nblocks = len >>> 4;
 	let h1lo = seed >>> 0;
 	let h1hi = 0;
@@ -174,12 +179,30 @@ function hash128(bytes, seed = 0) {
 	add64(h2lo, h2hi, h1lo, h1hi);
 	h2lo = RLO;
 	h2hi = RHI;
-	return {
-		h1lo: h1lo >>> 0,
-		h1hi: h1hi >>> 0,
-		h2lo: h2lo >>> 0,
-		h2hi: h2hi >>> 0
-	};
+	LANES.h1lo = h1lo >>> 0;
+	LANES.h1hi = h1hi >>> 0;
+	LANES.h2lo = h2lo >>> 0;
+	LANES.h2hi = h2hi >>> 0;
+}
+const keyEncoder = new TextEncoder();
+let keyBuf = /* @__PURE__ */ new Uint8Array(256);
+function keyToLanes(key, seed) {
+	if (typeof key === "string") {
+		const cap = key.length * 3;
+		if (keyBuf.length < cap) keyBuf = new Uint8Array(cap);
+		const { written } = keyEncoder.encodeInto(key, keyBuf);
+		computeLanes(keyBuf, seed, written);
+		return;
+	}
+	const bytes = normalize(key);
+	computeLanes(bytes, seed, bytes.length);
+}
+function hash128KeyInto(key, seed, out) {
+	keyToLanes(key, seed);
+	out.h1lo = LANES.h1lo;
+	out.h1hi = LANES.h1hi;
+	out.h2lo = LANES.h2lo;
+	out.h2hi = LANES.h2hi;
 }
 function reduce(x, range) {
 	const xlo = x & 65535;
@@ -199,9 +222,9 @@ function reduce(x, range) {
 * (the RocksDB `+i^2` fix), reduced into range with Lemire multiply-shift.
 */
 function probeInto(key, count, range, seed, out) {
-	const { h1lo, h1hi, h2lo, h2hi } = hash128(normalize(key), seed);
-	const a = (h1lo ^ h1hi) >>> 0;
-	const b = (h2lo ^ h2hi) >>> 0;
+	keyToLanes(key, seed);
+	const a = (LANES.h1lo ^ LANES.h1hi) >>> 0;
+	const b = (LANES.h2lo ^ LANES.h2hi) >>> 0;
 	for (let i = 0; i < count; i++) out[i] = reduce(a + Math.imul(i, b) + i * i >>> 0, range);
 }
 //#endregion
@@ -274,16 +297,10 @@ Object.defineProperty(exports, "SerializationError", {
 		return SerializationError;
 	}
 });
-Object.defineProperty(exports, "hash128", {
-	enumerable: true,
-	get: function() {
-		return hash128;
-	}
-});
-Object.defineProperty(exports, "normalize", {
+Object.defineProperty(exports, "hash128KeyInto", {
 	enumerable: true,
 	get: function() {
-		return normalize;
+		return hash128KeyInto;
 	}
 });
 Object.defineProperty(exports, "probeInto", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "distillate",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Probabilistic data structures for JavaScript. Space-efficient, approximate-membership filters (Bloom, Blocked Bloom, Binary Fuse) with tunable error and a portable binary format; zero dependencies, universal.",
   "keywords": [
     "bloom-filter",
@@ -63,23 +63,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsdown",
-    "publint": "publint --strict",
-    "check": "publint --strict && attw --pack . --profile node16",
-    "attw": "attw --pack . --profile node16",
-    "test": "vitest run",
-    "changeset": "changeset",
-    "version": "changeset version",
-    "release": "changeset publish",
-    "bench": "tsx bench/core.bench.ts && tsx bench/bloom.bench.ts && tsx bench/blocked.bench.ts && tsx bench/fuse.bench.ts",
-    "typecheck": "tsc --noEmit",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "prepare": "husky"
-  },
   "lint-staged": {
     "*.ts": [
       "eslint --fix --no-warn-ignored",
@@ -93,8 +76,12 @@
     "@commitlint/cli": "^21.2.1",
     "@commitlint/config-conventional": "^21.2.0",
     "@eslint/js": "^10.0.1",
+    "@microsoft/api-extractor": "^7.58.12",
+    "@types/node": "^26.1.2",
+    "@vitest/coverage-v8": "^4.1.10",
     "eslint": "^10.8.0",
     "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-tsdoc": "^0.5.2",
     "fast-check": "^4.9.0",
     "husky": "^9.1.7",
     "lint-staged": "^17.2.0",
@@ -103,6 +90,8 @@
     "publint": "^0.3.22",
     "tsdown": "^0.22.14",
     "tsx": "^4.23.1",
+    "typedoc": "^0.28.20",
+    "typedoc-plugin-markdown": "^4.12.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.65.0",
     "vitest": "^4.1.10"
@@ -110,5 +99,24 @@
   "engines": {
     "node": ">=20"
   },
-  "packageManager": "pnpm@10.33.0"
-}
+  "scripts": {
+    "build": "tsdown",
+    "publint": "publint --strict",
+    "check": "publint --strict && attw --pack . --profile node16",
+    "attw": "attw --pack . --profile node16",
+    "test": "vitest run",
+    "coverage": "vitest run --coverage",
+    "api:report": "node scripts/api-extractor.mjs --local",
+    "api:check": "node scripts/api-extractor.mjs",
+    "docs:api": "typedoc",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish",
+    "bench": "tsx bench/core.bench.ts && tsx bench/bloom.bench.ts && tsx bench/blocked.bench.ts && tsx bench/fuse.bench.ts && tsx bench/accuracy.bench.ts",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  }
+}