sillstone 0.2.0 → 0.2.1

package/index.js

@@ -25,7 +25,10 @@ class FfiError extends Error {
 }
 
 let native = null;
+const platformKey = `${process.platform}-${process.arch}`;
 const candidates = [
+  path.join(__dirname, "prebuilds", platformKey, "sillstone_napi.node"),
+  path.join(__dirname, "prebuilds", platformKey, process.platform === "win32" ? "sillstone_ffi.dll" : (process.platform === "darwin" ? "libsillstone_ffi.dylib" : "libsillstone_ffi.so")),
   path.join(__dirname, "sillstone_napi.node"),
   path.join(__dirname, "build", "Release", "sillstone_napi.node"),
   path.join(__dirname, "build", "Debug", "sillstone_napi.node"),

package/package.json

@@ -1,8 +1,14 @@
 {
   "name": "sillstone",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Pure-Rust zero-dependency multimedia, hashing, and array computing suite",
   "main": "index.js",
+  "files": [
+    "index.js",
+    "prebuilds/",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "test": "node --test"
   },

package/scripts/build.js

@@ -1,49 +0,0 @@
-const { execSync } = require("child_process");
-const fs = require("fs");
-const path = require("path");
-
-const nodeDir = path.resolve(__dirname, "..");
-const outDir = path.join(nodeDir, "build", "Release");
-fs.mkdirSync(outDir, { recursive: true });
-
-const outFile = path.join(outDir, "sillstone_napi.node");
-const srcFile = path.join(nodeDir, "src", "generated.c");
-const repoRoot = path.resolve(nodeDir, "..", "..");
-const ffiLibDir = path.join(repoRoot, "target", "debug");
-
-console.log("Building N-API addon...");
-
-if (process.platform === "win32") {
-  const nodeDef = path.join(nodeDir, "src", "node.def");
-  const libNode = path.join(outDir, "libnode.a");
-  
-  // 1. Generate libnode.a import library if not present
-  try {
-    execSync(`dlltool -d "${nodeDef}" -D node.exe -l "${libNode}"`, { stdio: "inherit" });
-  } catch (e) {
-    console.error("dlltool failed:", e.message);
-  }
-
-  // 2. Compile generated.c with gcc linking against libnode.a and sillstone_ffi.dll
-  const cmd = `gcc -shared -O3 -I"${path.join(nodeDir, "src")}" -I"${path.join(repoRoot, "include")}" "${srcFile}" "${libNode}" -L"${ffiLibDir}" -lsillstone_ffi -o "${outFile}"`;
-  console.log("Executing:", cmd);
-  execSync(cmd, { stdio: "inherit" });
-} else if (process.platform === "darwin") {
-  const cmd = `gcc -shared -O3 -fPIC -undefined dynamic_lookup -I"${path.join(nodeDir, "src")}" -I"${path.join(repoRoot, "include")}" "${srcFile}" -L"${ffiLibDir}" -lsillstone_ffi -o "${outFile}"`;
-  execSync(cmd, { stdio: "inherit" });
-} else {
-  // Linux
-  const cmd = `gcc -shared -O3 -fPIC -I"${path.join(nodeDir, "src")}" -I"${path.join(repoRoot, "include")}" "${srcFile}" -L"${ffiLibDir}" -lsillstone_ffi -Wl,-rpath,'$ORIGIN/../../../../target/debug' -o "${outFile}"`;
-  console.log("Executing:", cmd);
-  execSync(cmd, { stdio: "inherit" });
-}
-
-if (process.platform === "win32") {
-  const dllSrc = path.join(ffiLibDir, "sillstone_ffi.dll");
-  const dllDst = path.join(outDir, "sillstone_ffi.dll");
-  if (fs.existsSync(dllSrc)) {
-    fs.copyFileSync(dllSrc, dllDst);
-    console.log("Copied sillstone_ffi.dll to:", dllDst);
-  }
-}
-console.log("N-API addon built successfully at:", outFile);

package/src/generated.c

@@ -1,511 +0,0 @@
-/* Generated by sillstone-idl-gen. DO NOT EDIT. */
-#include <node_api.h>
-#include <stdint.h>
-#include <stddef.h>
-#include <stdio.h>
-#include "sillstone.h"
-
-static void throw_status(napi_env env, int32_t status) {
-    char buf[16];
-    snprintf(buf, sizeof(buf), "%d", status);
-    napi_throw_error(env, buf, "FFI error");
-}
-
-static napi_value n_sillstone_version_major(napi_env env, napi_callback_info info) {
-    uint32_t val = sillstone_version_major();
-    napi_value result;
-    napi_create_uint32(env, val, &result);
-    return result;
-}
-
-static napi_value n_sillstone_version_minor(napi_env env, napi_callback_info info) {
-    uint32_t val = sillstone_version_minor();
-    napi_value result;
-    napi_create_uint32(env, val, &result);
-    return result;
-}
-
-static napi_value n_sillstone_version_patch(napi_env env, napi_callback_info info) {
-    uint32_t val = sillstone_version_patch();
-    napi_value result;
-    napi_create_uint32(env, val, &result);
-    return result;
-}
-
-static napi_value n_sillstone_buffer_checksum(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data;
-    size_t length;
-    napi_get_buffer_info(env, args[0], &data, &length);
-    uint64_t res = sillstone_buffer_checksum((const uint8_t*)data, length);
-    napi_value result;
-    napi_create_bigint_uint64(env, res, &result);
-    return result;
-}
-
-static napi_value n_sillstone_digest_sha256(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL;
-    size_t length = 0;
-    if (argc > 0) {
-        napi_get_buffer_info(env, args[0], &data, &length);
-    }
-    uint8_t out[32];
-    sillstone_digest_sha256((const uint8_t*)data, length, out);
-    napi_value result;
-    napi_create_buffer_copy(env, 32, out, NULL, &result);
-    return result;
-}
-
-static napi_value n_sillstone_digest_sha3_256(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL;
-    size_t length = 0;
-    if (argc > 0) {
-        napi_get_buffer_info(env, args[0], &data, &length);
-    }
-    uint8_t out[32];
-    sillstone_digest_sha3_256((const uint8_t*)data, length, out);
-    napi_value result;
-    napi_create_buffer_copy(env, 32, out, NULL, &result);
-    return result;
-}
-
-static napi_value n_sillstone_digest_sha3_512(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL;
-    size_t length = 0;
-    if (argc > 0) {
-        napi_get_buffer_info(env, args[0], &data, &length);
-    }
-    uint8_t out[64];
-    sillstone_digest_sha3_512((const uint8_t*)data, length, out);
-    napi_value result;
-    napi_create_buffer_copy(env, 64, out, NULL, &result);
-    return result;
-}
-
-static napi_value n_sillstone_digest_blake2b_512(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL;
-    size_t length = 0;
-    if (argc > 0) {
-        napi_get_buffer_info(env, args[0], &data, &length);
-    }
-    uint8_t out[64];
-    sillstone_digest_blake2b_512((const uint8_t*)data, length, out);
-    napi_value result;
-    napi_create_buffer_copy(env, 64, out, NULL, &result);
-    return result;
-}
-
-static napi_value n_sillstone_digest_blake3(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL;
-    size_t length = 0;
-    if (argc > 0) {
-        napi_get_buffer_info(env, args[0], &data, &length);
-    }
-    uint8_t out[32];
-    sillstone_digest_blake3((const uint8_t*)data, length, out);
-    napi_value result;
-    napi_create_buffer_copy(env, 32, out, NULL, &result);
-    return result;
-}
-
-static napi_value n_sillstone_math_dst1(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL;
-    size_t length = 0;
-    if (argc > 0) {
-        napi_get_buffer_info(env, args[0], &data, &length);
-    }
-    size_t count = length / sizeof(double);
-    napi_value result;
-    void* out_data = NULL;
-    napi_create_buffer(env, length, &out_data, &result);
-    sillstone_math_dst1((const double*)data, count, (double*)out_data);
-    return result;
-}
-
-static napi_value n_sillstone_math_dst2(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL;
-    size_t length = 0;
-    if (argc > 0) {
-        napi_get_buffer_info(env, args[0], &data, &length);
-    }
-    size_t count = length / sizeof(double);
-    napi_value result;
-    void* out_data = NULL;
-    napi_create_buffer(env, length, &out_data, &result);
-    sillstone_math_dst2((const double*)data, count, (double*)out_data);
-    return result;
-}
-
-static napi_value n_sillstone_math_dst3(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL;
-    size_t length = 0;
-    if (argc > 0) {
-        napi_get_buffer_info(env, args[0], &data, &length);
-    }
-    size_t count = length / sizeof(double);
-    napi_value result;
-    void* out_data = NULL;
-    napi_create_buffer(env, length, &out_data, &result);
-    sillstone_math_dst3((const double*)data, count, (double*)out_data);
-    return result;
-}
-
-static napi_value n_sillstone_unicode_grapheme_count(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL;
-    size_t length = 0;
-    if (argc > 0) {
-        napi_get_buffer_info(env, args[0], &data, &length);
-    }
-    size_t count = 0;
-    sillstone_unicode_grapheme_count((const uint8_t*)data, length, &count);
-    napi_value result;
-    napi_create_int64(env, (int64_t)count, &result);
-    return result;
-}
-
-static napi_value n_sillstone_unicode_char_category(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    uint32_t cp = 0;
-    if (argc > 0) {
-        napi_get_value_uint32(env, args[0], &cp);
-    }
-    uint8_t cat = 0;
-    sillstone_unicode_char_category(cp, &cat);
-    napi_value result;
-    napi_create_uint32(env, cat, &result);
-    return result;
-}
-
-static napi_value n_sillstone_curator_detect(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL; size_t length = 0;
-    if (argc > 0) napi_get_buffer_info(env, args[0], &data, &length);
-    uint32_t format = 0, modality = 0, pending = 0;
-    int32_t status = sillstone_curator_detect((const uint8_t*)data, length, &format, &modality, &pending);
-    if (status != 0) { throw_status(env, status); return NULL; }
-    napi_value result, v_fmt, v_mod, v_pend;
-    napi_create_object(env, &result);
-    napi_create_uint32(env, format, &v_fmt);
-    napi_set_named_property(env, result, "format", v_fmt);
-    napi_create_uint32(env, modality, &v_mod);
-    napi_set_named_property(env, result, "modality", v_mod);
-    napi_create_uint32(env, pending, &v_pend);
-    napi_set_named_property(env, result, "pending", v_pend);
-    return result;
-}
-
-static napi_value n_sillstone_curator_content_hash(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL; size_t length = 0;
-    if (argc > 0) napi_get_buffer_info(env, args[0], &data, &length);
-    uint8_t out_buf[32];
-    size_t out_len = 0;
-    int32_t status = sillstone_curator_content_hash((const uint8_t*)data, length, out_buf, 32, &out_len);
-    if (status != 0) { throw_status(env, status); return NULL; }
-    napi_value result;
-    napi_create_buffer_copy(env, 32, out_buf, NULL, &result);
-    return result;
-}
-
-static napi_value n_sillstone_curator_signature(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL; size_t length = 0;
-    if (argc > 0) napi_get_buffer_info(env, args[0], &data, &length);
-    uint8_t* out_ptr = NULL; size_t out_len = 0;
-    int32_t status = sillstone_curator_signature((const uint8_t*)data, length, &out_ptr, &out_len);
-    if (status != 0 || out_ptr == NULL) { throw_status(env, status != 0 ? status : -1); return NULL; }
-    napi_value result;
-    napi_create_buffer_copy(env, out_len, out_ptr, NULL, &result);
-    sillstone_curator_free(out_ptr, out_len);
-    return result;
-}
-
-static napi_value n_sillstone_curator_describe(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL; size_t length = 0;
-    if (argc > 0) napi_get_buffer_info(env, args[0], &data, &length);
-    uint8_t* out_ptr = NULL; size_t out_len = 0;
-    int32_t status = sillstone_curator_describe((const uint8_t*)data, length, &out_ptr, &out_len);
-    if (status != 0 || out_ptr == NULL) { throw_status(env, status != 0 ? status : -1); return NULL; }
-    napi_value result;
-    napi_create_buffer_copy(env, out_len, out_ptr, NULL, &result);
-    sillstone_curator_free(out_ptr, out_len);
-    return result;
-}
-
-static napi_value n_sillstone_curator_match(napi_env env, napi_callback_info info) {
-    size_t argc = 2;
-    napi_value args[2];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* a = NULL; size_t a_len = 0;
-    void* b = NULL; size_t b_len = 0;
-    if (argc > 0) napi_get_buffer_info(env, args[0], &a, &a_len);
-    if (argc > 1) napi_get_buffer_info(env, args[1], &b, &b_len);
-    uint32_t tag = 0, matched = 0; uint64_t slots[4] = {0};
-    int32_t status = sillstone_curator_match((const uint8_t*)a, a_len, (const uint8_t*)b, b_len, &tag, slots, 4, &matched);
-    if (status != 0) { throw_status(env, status); return NULL; }
-    napi_value result, v_tag, v_slots, v_matched;
-    napi_create_object(env, &result);
-    napi_create_uint32(env, tag, &v_tag);
-    napi_set_named_property(env, result, "tag", v_tag);
-    napi_create_array_with_length(env, 4, &v_slots);
-    for (uint32_t i = 0; i < 4; i++) {
-        napi_value sv;
-        napi_create_bigint_uint64(env, slots[i], &sv);
-        napi_set_element(env, v_slots, i, sv);
-    }
-    napi_set_named_property(env, result, "slots", v_slots);
-    napi_create_uint32(env, matched, &v_matched);
-    napi_set_named_property(env, result, "matched", v_matched);
-    return result;
-}
-
-static napi_value n_sillstone_curator_free(napi_env env, napi_callback_info info) {
-    napi_value result;
-    napi_get_undefined(env, &result);
-    return result;
-}
-
-static napi_value n_sillstone_image_phash(napi_env env, napi_callback_info info) {
-    size_t argc = 4;
-    napi_value args[4];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL; size_t length = 0;
-    if (argc > 0) napi_get_buffer_info(env, args[0], &data, &length);
-    uint32_t width = 0, height = 0, layout = 0;
-    if (argc > 1) napi_get_value_uint32(env, args[1], &width);
-    if (argc > 2) napi_get_value_uint32(env, args[2], &height);
-    if (argc > 3) napi_get_value_uint32(env, args[3], &layout);
-    uint64_t hash_val = 0;
-    int32_t status = sillstone_image_phash((const uint8_t*)data, length, width, height, layout, &hash_val);
-    if (status != 0) { napi_throw_error(env, NULL, "image hash failed"); return NULL; }
-    napi_value result;
-    napi_create_bigint_uint64(env, hash_val, &result);
-    return result;
-}
-
-static napi_value n_sillstone_image_ahash(napi_env env, napi_callback_info info) {
-    size_t argc = 4;
-    napi_value args[4];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL; size_t length = 0;
-    if (argc > 0) napi_get_buffer_info(env, args[0], &data, &length);
-    uint32_t width = 0, height = 0, layout = 0;
-    if (argc > 1) napi_get_value_uint32(env, args[1], &width);
-    if (argc > 2) napi_get_value_uint32(env, args[2], &height);
-    if (argc > 3) napi_get_value_uint32(env, args[3], &layout);
-    uint64_t hash_val = 0;
-    int32_t status = sillstone_image_ahash((const uint8_t*)data, length, width, height, layout, &hash_val);
-    if (status != 0) { napi_throw_error(env, NULL, "image hash failed"); return NULL; }
-    napi_value result;
-    napi_create_bigint_uint64(env, hash_val, &result);
-    return result;
-}
-
-static napi_value n_sillstone_image_dhash(napi_env env, napi_callback_info info) {
-    size_t argc = 4;
-    napi_value args[4];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL; size_t length = 0;
-    if (argc > 0) napi_get_buffer_info(env, args[0], &data, &length);
-    uint32_t width = 0, height = 0, layout = 0;
-    if (argc > 1) napi_get_value_uint32(env, args[1], &width);
-    if (argc > 2) napi_get_value_uint32(env, args[2], &height);
-    if (argc > 3) napi_get_value_uint32(env, args[3], &layout);
-    uint64_t hash_val = 0;
-    int32_t status = sillstone_image_dhash((const uint8_t*)data, length, width, height, layout, &hash_val);
-    if (status != 0) { napi_throw_error(env, NULL, "image hash failed"); return NULL; }
-    napi_value result;
-    napi_create_bigint_uint64(env, hash_val, &result);
-    return result;
-}
-
-static napi_value n_sillstone_image_whash(napi_env env, napi_callback_info info) {
-    size_t argc = 4;
-    napi_value args[4];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL; size_t length = 0;
-    if (argc > 0) napi_get_buffer_info(env, args[0], &data, &length);
-    uint32_t width = 0, height = 0, layout = 0;
-    if (argc > 1) napi_get_value_uint32(env, args[1], &width);
-    if (argc > 2) napi_get_value_uint32(env, args[2], &height);
-    if (argc > 3) napi_get_value_uint32(env, args[3], &layout);
-    uint64_t hash_val = 0;
-    int32_t status = sillstone_image_whash((const uint8_t*)data, length, width, height, layout, 3, &hash_val);
-    if (status != 0) { napi_throw_error(env, NULL, "image hash failed"); return NULL; }
-    napi_value result;
-    napi_create_bigint_uint64(env, hash_val, &result);
-    return result;
-}
-
-static napi_value n_sillstone_image_colorhash(napi_env env, napi_callback_info info) {
-    size_t argc = 4;
-    napi_value args[4];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL; size_t length = 0;
-    if (argc > 0) napi_get_buffer_info(env, args[0], &data, &length);
-    uint32_t width = 0, height = 0, layout = 0;
-    if (argc > 1) napi_get_value_uint32(env, args[1], &width);
-    if (argc > 2) napi_get_value_uint32(env, args[2], &height);
-    if (argc > 3) napi_get_value_uint32(env, args[3], &layout);
-    uint64_t hash_val = 0;
-    int32_t status = sillstone_image_colorhash((const uint8_t*)data, length, width, height, layout, 4, &hash_val);
-    if (status != 0) { napi_throw_error(env, NULL, "image hash failed"); return NULL; }
-    napi_value result;
-    napi_create_bigint_uint64(env, hash_val, &result);
-    return result;
-}
-
-static napi_value n_sillstone_text_tlsh(napi_env env, napi_callback_info info) {
-    size_t argc = 1;
-    napi_value args[1];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* data = NULL; size_t length = 0;
-    if (argc > 0) napi_get_buffer_info(env, args[0], &data, &length);
-    uint8_t out_buf[72];
-    int32_t status = sillstone_text_tlsh((const uint8_t*)data, length, out_buf);
-    if (status != 0) { napi_throw_error(env, NULL, "tlsh failed"); return NULL; }
-    napi_value result;
-    napi_create_buffer_copy(env, 72, out_buf, NULL, &result);
-    return result;
-}
-
-static napi_value n_sillstone_text_tlsh_distance(napi_env env, napi_callback_info info) {
-    size_t argc = 2;
-    napi_value args[2];
-    napi_get_cb_info(env, info, &argc, args, NULL, NULL);
-    void* a = NULL; size_t a_len = 0;
-    void* b = NULL; size_t b_len = 0;
-    if (argc > 0) napi_get_buffer_info(env, args[0], &a, &a_len);
-    if (argc > 1) napi_get_buffer_info(env, args[1], &b, &b_len);
-    uint32_t dist = 0;
-    int32_t status = sillstone_text_tlsh_distance((const uint8_t*)a, (const uint8_t*)b, &dist);
-    if (status != 0) { throw_status(env, status); return NULL; }
-    napi_value result;
-    napi_create_uint32(env, dist, &result);
-    return result;
-}
-
-NAPI_MODULE_INIT() {
-    napi_value fn_sillstone_version_major;
-    napi_create_function(env, NULL, 0, n_sillstone_version_major, NULL, &fn_sillstone_version_major);
-    napi_set_named_property(env, exports, "sillstone_version_major", fn_sillstone_version_major);
-    napi_value fn_sillstone_version_minor;
-    napi_create_function(env, NULL, 0, n_sillstone_version_minor, NULL, &fn_sillstone_version_minor);
-    napi_set_named_property(env, exports, "sillstone_version_minor", fn_sillstone_version_minor);
-    napi_value fn_sillstone_version_patch;
-    napi_create_function(env, NULL, 0, n_sillstone_version_patch, NULL, &fn_sillstone_version_patch);
-    napi_set_named_property(env, exports, "sillstone_version_patch", fn_sillstone_version_patch);
-    napi_value fn_sillstone_buffer_checksum;
-    napi_create_function(env, NULL, 0, n_sillstone_buffer_checksum, NULL, &fn_sillstone_buffer_checksum);
-    napi_set_named_property(env, exports, "sillstone_buffer_checksum", fn_sillstone_buffer_checksum);
-    napi_value fn_sillstone_digest_sha256;
-    napi_create_function(env, NULL, 0, n_sillstone_digest_sha256, NULL, &fn_sillstone_digest_sha256);
-    napi_set_named_property(env, exports, "sillstone_digest_sha256", fn_sillstone_digest_sha256);
-    napi_value fn_sillstone_digest_sha3_256;
-    napi_create_function(env, NULL, 0, n_sillstone_digest_sha3_256, NULL, &fn_sillstone_digest_sha3_256);
-    napi_set_named_property(env, exports, "sillstone_digest_sha3_256", fn_sillstone_digest_sha3_256);
-    napi_value fn_sillstone_digest_sha3_512;
-    napi_create_function(env, NULL, 0, n_sillstone_digest_sha3_512, NULL, &fn_sillstone_digest_sha3_512);
-    napi_set_named_property(env, exports, "sillstone_digest_sha3_512", fn_sillstone_digest_sha3_512);
-    napi_value fn_sillstone_digest_blake2b_512;
-    napi_create_function(env, NULL, 0, n_sillstone_digest_blake2b_512, NULL, &fn_sillstone_digest_blake2b_512);
-    napi_set_named_property(env, exports, "sillstone_digest_blake2b_512", fn_sillstone_digest_blake2b_512);
-    napi_value fn_sillstone_digest_blake3;
-    napi_create_function(env, NULL, 0, n_sillstone_digest_blake3, NULL, &fn_sillstone_digest_blake3);
-    napi_set_named_property(env, exports, "sillstone_digest_blake3", fn_sillstone_digest_blake3);
-    napi_value fn_sillstone_math_dst1;
-    napi_create_function(env, NULL, 0, n_sillstone_math_dst1, NULL, &fn_sillstone_math_dst1);
-    napi_set_named_property(env, exports, "sillstone_math_dst1", fn_sillstone_math_dst1);
-    napi_value fn_sillstone_math_dst2;
-    napi_create_function(env, NULL, 0, n_sillstone_math_dst2, NULL, &fn_sillstone_math_dst2);
-    napi_set_named_property(env, exports, "sillstone_math_dst2", fn_sillstone_math_dst2);
-    napi_value fn_sillstone_math_dst3;
-    napi_create_function(env, NULL, 0, n_sillstone_math_dst3, NULL, &fn_sillstone_math_dst3);
-    napi_set_named_property(env, exports, "sillstone_math_dst3", fn_sillstone_math_dst3);
-    napi_value fn_sillstone_unicode_grapheme_count;
-    napi_create_function(env, NULL, 0, n_sillstone_unicode_grapheme_count, NULL, &fn_sillstone_unicode_grapheme_count);
-    napi_set_named_property(env, exports, "sillstone_unicode_grapheme_count", fn_sillstone_unicode_grapheme_count);
-    napi_value fn_sillstone_unicode_char_category;
-    napi_create_function(env, NULL, 0, n_sillstone_unicode_char_category, NULL, &fn_sillstone_unicode_char_category);
-    napi_set_named_property(env, exports, "sillstone_unicode_char_category", fn_sillstone_unicode_char_category);
-    napi_value fn_sillstone_curator_detect;
-    napi_create_function(env, NULL, 0, n_sillstone_curator_detect, NULL, &fn_sillstone_curator_detect);
-    napi_set_named_property(env, exports, "sillstone_curator_detect", fn_sillstone_curator_detect);
-    napi_value fn_sillstone_curator_content_hash;
-    napi_create_function(env, NULL, 0, n_sillstone_curator_content_hash, NULL, &fn_sillstone_curator_content_hash);
-    napi_set_named_property(env, exports, "sillstone_curator_content_hash", fn_sillstone_curator_content_hash);
-    napi_value fn_sillstone_curator_signature;
-    napi_create_function(env, NULL, 0, n_sillstone_curator_signature, NULL, &fn_sillstone_curator_signature);
-    napi_set_named_property(env, exports, "sillstone_curator_signature", fn_sillstone_curator_signature);
-    napi_value fn_sillstone_curator_describe;
-    napi_create_function(env, NULL, 0, n_sillstone_curator_describe, NULL, &fn_sillstone_curator_describe);
-    napi_set_named_property(env, exports, "sillstone_curator_describe", fn_sillstone_curator_describe);
-    napi_value fn_sillstone_curator_match;
-    napi_create_function(env, NULL, 0, n_sillstone_curator_match, NULL, &fn_sillstone_curator_match);
-    napi_set_named_property(env, exports, "sillstone_curator_match", fn_sillstone_curator_match);
-    napi_value fn_sillstone_curator_free;
-    napi_create_function(env, NULL, 0, n_sillstone_curator_free, NULL, &fn_sillstone_curator_free);
-    napi_set_named_property(env, exports, "sillstone_curator_free", fn_sillstone_curator_free);
-    napi_value fn_sillstone_image_phash;
-    napi_create_function(env, NULL, 0, n_sillstone_image_phash, NULL, &fn_sillstone_image_phash);
-    napi_set_named_property(env, exports, "sillstone_image_phash", fn_sillstone_image_phash);
-    napi_value fn_sillstone_image_ahash;
-    napi_create_function(env, NULL, 0, n_sillstone_image_ahash, NULL, &fn_sillstone_image_ahash);
-    napi_set_named_property(env, exports, "sillstone_image_ahash", fn_sillstone_image_ahash);
-    napi_value fn_sillstone_image_dhash;
-    napi_create_function(env, NULL, 0, n_sillstone_image_dhash, NULL, &fn_sillstone_image_dhash);
-    napi_set_named_property(env, exports, "sillstone_image_dhash", fn_sillstone_image_dhash);
-    napi_value fn_sillstone_image_whash;
-    napi_create_function(env, NULL, 0, n_sillstone_image_whash, NULL, &fn_sillstone_image_whash);
-    napi_set_named_property(env, exports, "sillstone_image_whash", fn_sillstone_image_whash);
-    napi_value fn_sillstone_image_colorhash;
-    napi_create_function(env, NULL, 0, n_sillstone_image_colorhash, NULL, &fn_sillstone_image_colorhash);
-    napi_set_named_property(env, exports, "sillstone_image_colorhash", fn_sillstone_image_colorhash);
-    napi_value fn_sillstone_text_tlsh;
-    napi_create_function(env, NULL, 0, n_sillstone_text_tlsh, NULL, &fn_sillstone_text_tlsh);
-    napi_set_named_property(env, exports, "sillstone_text_tlsh", fn_sillstone_text_tlsh);
-    napi_value fn_sillstone_text_tlsh_distance;
-    napi_create_function(env, NULL, 0, n_sillstone_text_tlsh_distance, NULL, &fn_sillstone_text_tlsh_distance);
-    napi_set_named_property(env, exports, "sillstone_text_tlsh_distance", fn_sillstone_text_tlsh_distance);
-    return exports;
-}

package/src/node.def

@@ -1,16 +0,0 @@
-EXPORTS
-napi_create_array_with_length
-napi_create_bigint_uint64
-napi_create_buffer
-napi_create_buffer_copy
-napi_create_function
-napi_create_int64
-napi_create_object
-napi_create_uint32
-napi_get_buffer_info
-napi_get_cb_info
-napi_get_undefined
-napi_get_value_uint32
-napi_set_element
-napi_set_named_property
-napi_throw_error

package/src/node_api.h

@@ -1,104 +0,0 @@
-#ifndef SRC_NODE_API_H_
-#define SRC_NODE_API_H_
-
-#include <stddef.h>
-#include <stdint.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-typedef struct napi_env__* napi_env;
-typedef struct napi_value__* napi_value;
-typedef struct napi_ref__* napi_ref;
-typedef struct napi_handle_scope__* napi_handle_scope;
-typedef struct napi_escapable_handle_scope__* napi_escapable_handle_scope;
-typedef struct napi_callback_info__* napi_callback_info;
-typedef struct napi_async_context__* napi_async_context;
-typedef struct napi_async_work__* napi_async_work;
-
-typedef enum {
-  napi_ok,
-  napi_invalid_arg,
-  napi_object_expected,
-  napi_string_expected,
-  napi_name_expected,
-  napi_function_expected,
-  napi_number_expected,
-  napi_boolean_expected,
-  napi_array_expected,
-  napi_generic_failure,
-  napi_pending_exception,
-  napi_cancelled,
-  napi_escape_called_twice,
-  napi_handle_scope_mismatch,
-  napi_callback_scope_mismatch,
-  napi_queue_full,
-  napi_closing,
-  napi_bigint_expected,
-  napi_date_expected,
-  napi_arraybuffer_expected,
-  napi_detachable_arraybuffer_expected,
-  napi_would_deadlock
-} napi_status;
-
-typedef napi_value (*napi_callback)(napi_env env, napi_callback_info info);
-
-#if defined(_WIN32)
-#define NAPI_MODULE_EXPORT __declspec(dllexport)
-#else
-#define NAPI_MODULE_EXPORT __attribute__((visibility("default")))
-#endif
-
-#define NAPI_MODULE_INIT()                                             \
-  NAPI_MODULE_EXPORT napi_value                                        \
-  napi_register_module_v1(napi_env env, napi_value exports)
-
-napi_status napi_get_cb_info(napi_env env,
-                             napi_callback_info cbinfo,
-                             size_t* argc,
-                             napi_value* argv,
-                             napi_value* this_arg,
-                             void** data);
-
-napi_status napi_get_buffer_info(napi_env env,
-                                 napi_value value,
-                                 void** data,
-                                 size_t* length);
-
-napi_status napi_create_buffer(napi_env env,
-                               size_t size,
-                               void** data,
-                               napi_value* result);
-
-napi_status napi_create_buffer_copy(napi_env env,
-                                    size_t length,
-                                    const void* data,
-                                    void** result_data,
-                                    napi_value* result);
-
-napi_status napi_create_uint32(napi_env env, uint32_t value, napi_value* result);
-napi_status napi_get_value_uint32(napi_env env, napi_value value, uint32_t* result);
-napi_status napi_create_int64(napi_env env, int64_t value, napi_value* result);
-napi_status napi_create_bigint_uint64(napi_env env, uint64_t value, napi_value* result);
-napi_status napi_create_object(napi_env env, napi_value* result);
-napi_status napi_set_named_property(napi_env env,
-                                    napi_value object,
-                                    const char* utf8name,
-                                    napi_value value);
-napi_status napi_create_array_with_length(napi_env env, size_t length, napi_value* result);
-napi_status napi_set_element(napi_env env, napi_value object, uint32_t index, napi_value value);
-napi_status napi_get_undefined(napi_env env, napi_value* result);
-napi_status napi_throw_error(napi_env env, const char* code, const char* msg);
-napi_status napi_create_function(napi_env env,
-                                 const char* utf8name,
-                                 size_t length,
-                                 napi_callback cb,
-                                 void* data,
-                                 napi_value* result);
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif  // SRC_NODE_API_H_

package/test/checksum.test.js

@@ -1,65 +0,0 @@
-const test = require("node:test");
-const assert = require("node:assert");
-const crypto = require("node:crypto");
-const sillstone = require("../index.js");
-
-test("version matches expected", () => {
-  assert.strictEqual(sillstone.version(), "0.2.0");
-});
-
-test("checksum produces deterministic golden output", () => {
-  const data = Buffer.from("sillstone pure rust zero dep");
-  const sum = sillstone.bufferChecksum(data);
-  let h = 0xcbf29ce484222325n;
-  const prime = 0x0100000001b3n;
-  for (let i = 0; i < data.length; i++) {
-    h ^= BigInt(data[i]);
-    h = (h * prime) & 0xffffffffffffffffn;
-  }
-  assert.strictEqual(sum, h);
-});
-
-test("digests produce correct outputs", () => {
-  const data = Buffer.from("abc");
-  assert.strictEqual(
-    sillstone.sha256(data).toString("hex"),
-    crypto.createHash("sha256").update(data).digest("hex")
-  );
-  assert.strictEqual(
-    sillstone.sha3_256(data).toString("hex"),
-    crypto.createHash("sha3-256").update(data).digest("hex")
-  );
-  assert.strictEqual(
-    sillstone.sha3_512(data).toString("hex"),
-    crypto.createHash("sha3-512").update(data).digest("hex")
-  );
-  assert.strictEqual(
-    sillstone.blake3(Buffer.alloc(0)).toString("hex"),
-    "af1349b9f5f9a1a6a0404dea36dcc9499bcb25c9adc112b7cc9a93cae41f3262"
-  );
-});
-
-test("dst functions satisfy mathematical inversions", () => {
-  const x = [1.0, 2.0, 3.0, 4.0];
-  const d1 = sillstone.dst1(x);
-  assert.strictEqual(d1.length, 4);
-  const rec1 = sillstone.dst1(d1);
-  for (let i = 0; i < x.length; i++) {
-    assert.ok(Math.abs(x[i] - rec1[i]) < 1e-10);
-  }
-
-  const d2 = sillstone.dst2(x);
-  const rec2 = sillstone.dst3(d2);
-  for (let i = 0; i < x.length; i++) {
-    assert.ok(Math.abs(x[i] - rec2[i]) < 1e-10);
-  }
-});
-
-test("unicode grapheme clustering and character categories", () => {
-  const fam = "👨‍👩‍👧‍👦";
-  assert.strictEqual(sillstone.graphemeCount(fam), 1);
-  assert.strictEqual(sillstone.graphemeCount("Hello"), 5);
-  assert.strictEqual(sillstone.graphemeCount(""), 0);
-  const cat = sillstone.charCategory("A");
-  assert.ok(cat >= 0);
-});

package/test/reference.test.js

@@ -1,447 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright (c) 2026 sillstone
-"use strict";
-
-// Hex-exact conformance: the committed reference vectors through koffi.
-// Every one of the 45 vectors in the repository-root reference.json is
-// replayed through the cdylib and compared against every recorded
-// field — detect codes, tier-2 sub-digests (recomputed SDK-side with
-// the same folds the generator uses), tier-1 digests, facts and match
-// slots. The same vectors the Rust `gen-reference verify` gate and the
-// Python/Go SDKs check.
-
-const test = require("node:test");
-const assert = require("node:assert/strict");
-const crypto = require("node:crypto");
-const fs = require("node:fs");
-const path = require("node:path");
-
-const {
-  FfiError,
-  MODALITIES,
-  FORMATS,
-  contentHash,
-  describe,
-  detect,
-  fnv1a64,
-  findCdylib,
-  matchSignatures,
-  signature,
-} = require("../index.js");
-
-const REPO_ROOT = path.resolve(__dirname, "..", "..", "..");
-const REFERENCE = JSON.parse(fs.readFileSync(path.join(REPO_ROOT, "reference.json"), "utf8")).vectors;
-const BY_NAME = new Map(REFERENCE.map((v) => [v.name, v]));
-
-const MASK64 = (1n << 64n) - 1n;
-
-/** SplitMix64 next_u64 (BigInt, wrapping). @param {{s: bigint}} st */
-function splitmixNext(st) {
-  st.s = (st.s + 0x9e3779b97f4a7c15n) & MASK64;
-  let z = st.s;
-  z = ((z ^ (z >> 30n)) * 0xbf58476d1ce4e5b9n) & MASK64;
-  z = ((z ^ (z >> 27n)) * 0x94d049bb133111ebn) & MASK64;
-  return z ^ (z >> 31n);
-}
-
-/** The upstream conformance byte recipe: one next_u64 per byte, low byte. */
-function splitmixBytes(seed, length) {
-  const st = { s: BigInt(seed) };
-  const out = Buffer.alloc(length);
-  for (let i = 0; i < length; i++) out[i] = Number(splitmixNext(st) & 0xffn);
-  return out;
-}
-
-/** The 48 KiB pseudo-file recipe of the upstream facade suite. */
-function blob48(seed) {
-  return splitmixBytes(seed, 48 * 1024);
-}
-
-const VOCAB = [
-  "hash", "image", "audio", "signal", "codec", "block", "frame", "sample", "stream",
-  "vector", "median", "kernel", "window", "raster", "pixel", "tone", "hash", "luma",
-  "delta", "chunk", "radix", "filter", "table", "edge",
-];
-
-/** Deterministic ~bytes-sized prose from the seeded 24-word vocabulary. */
-function prose(seed, bytes) {
-  const st = { s: BigInt(seed) };
-  let out = "";
-  while (out.length < bytes) {
-    out += VOCAB[Number(splitmixNext(st) % BigInt(VOCAB.length))];
-    out += " ";
-  }
-  return out.slice(0, bytes);
-}
-
-/** Smooth periodic RGB content with real low-frequency energy. */
-function patternedPixels(seed, w, h) {
-  const st = { s: BigInt(seed) };
-  const fx = Number(splitmixNext(st) % 5n) + 1;
-  const fy = Number(splitmixNext(st) % 5n) + 1;
-  const p1 = Number(splitmixNext(st) % 628n) / 100.0;
-  const p2 = Number(splitmixNext(st) % 628n) / 100.0;
-  const TAU = 6.283185307179586;
-  const px = Buffer.alloc(w * h * 3);
-  let i = 0;
-  for (let y = 0; y < h; y++) {
-    for (let x = 0; x < w; x++) {
-      const u = x / w;
-      const v = y / h;
-      const r = 127.5 + 120.0 * Math.sin(u * fx * TAU + p1);
-      const g = 127.5 + 120.0 * Math.sin(v * fy * TAU + p2);
-      const b = 127.5 + 120.0 * Math.sin((u + v) * (fx + fy) + p1 + p2);
-      px[i++] = Math.trunc(r);
-      px[i++] = Math.trunc(g);
-      px[i++] = Math.trunc(b);
-    }
-  }
-  return px;
-}
-
-/** Encodes RGB triples as a bottom-up 24-bit BMP. */
-function bmp24(w, h, rgb) {
-  const row = Math.ceil((w * 3) / 4) * 4;
-  const img = row * h;
-  const f = [Buffer.from("BM", "ascii")];
-  const head = Buffer.alloc(52);
-  head.writeUInt32LE(54 + img, 0); // file size
-  head.writeUInt32LE(54, 8); // pixel offset (4 reserved bytes at 4..8)
-  head.writeUInt32LE(40, 12); // DIB header
-  head.writeInt32LE(w, 16);
-  head.writeInt32LE(h, 20);
-  head.writeUInt16LE(1, 24); // planes
-  head.writeUInt16LE(24, 26); // bpp
-  f.push(head);
-  const pad = Buffer.alloc(row - w * 3);
-  for (let y = h - 1; y >= 0; y--) {
-    const rowBuf = Buffer.alloc(w * 3);
-    for (let x = 0; x < w; x++) {
-      const i = (y * w + x) * 3;
-      rowBuf[x * 3] = rgb[i + 2];
-      rowBuf[x * 3 + 1] = rgb[i + 1];
-      rowBuf[x * 3 + 2] = rgb[i];
-    }
-    f.push(rowBuf, pad);
-  }
-  return Buffer.concat(f);
-}
-
-function fixture(name) {
-  return fs.readFileSync(path.join(REPO_ROOT, "tests", "fixtures", name));
-}
-
-// The gen-reference corpus, name -> input bytes (cached).
-const inputCache = new Map();
-function input(name) {
-  if (!inputCache.has(name)) {
-    inputCache.set(name, makeInput(name));
-  }
-  return inputCache.get(name);
-}
-
-/** The exact name->input mapping tools/gen-reference defines. */
-function makeInput(name) {
-  switch (name) {
-    case "detect-png":
-    case "sig-image-phash_rgb8_48x40":
-    case "describe-image-phash_rgb8_48x40":
-      return fixture("phash_rgb8_48x40.png");
-    case "detect-jpeg":
-    case "sig-image-base_444-jpeg":
-      return fixture("base_444.jpg");
-    case "detect-bmp":
-    case "sig-image-bmp-patterned-48x40":
-    case "describe-image-bmp-patterned-48x40":
-      return bmp24(48, 40, patternedPixels(0xbeef0001, 48, 40));
-    case "detect-wav":
-    case "sig-audio-tone-wav":
-    case "describe-audio-tone-wav":
-      return fixture("tone.wav");
-    case "detect-flac":
-    case "sig-audio-tone-flac":
-      return fixture("tone.flac");
-    case "detect-mp3":
-    case "sig-audio-l3_short-mp3":
-      return fixture("l3_short.mp3");
-    case "detect-mp4":
-    case "sig-video-a_64x48-mp4":
-    case "describe-video-a_64x48-mp4":
-      return fixture("a_64x48.mp4");
-    case "detect-mov":
-      return fixture("a_64x48.mov");
-    case "detect-pdf":
-    case "sig-pdf-text_page":
-    case "describe-pdf-text_page":
-      return fixture("text_page.pdf");
-    case "detect-zip":
-      return Buffer.from([0x50, 0x4b, 0x03, 0x04, 0x14, 0x00, 0x00, 0x00, 0x00, 0x00]);
-    case "detect-gif":
-      return Buffer.from("GIF89a\x01\x00\x01\x00", "binary");
-    case "detect-text":
-      return Buffer.from("just some words", "binary");
-    case "detect-binary":
-      return Buffer.from([0x00, 0xff, 0x02, 0xfe]);
-    case "sig-image-phash_gray8_40x32":
-      return fixture("phash_gray8_40x32.png");
-    case "sig-image-base_444-png":
-      return fixture("base_444.png");
-    case "sig-text-prose-4kib":
-    case "describe-text-prose-4kib":
-      return Buffer.from(prose(0xd1, 4096), "binary");
-    case "sig-binary-splitmix64-48kib":
-    case "describe-binary-splitmix64-48kib":
-      return blob48(0xd15e5eed);
-    case "sig-binary-splitmix64-48kib-prefix-insert": {
-      const out = Buffer.alloc(1 + 48 * 1024);
-      out[0] = 0xaa;
-      blob48(0xd15e5eed).copy(out, 1);
-      return out;
-    }
-    case "sig-binary-splitmix64-48kib-unrelated":
-      return blob48(0xbadc0ffe);
-    case "match-image-self":
-    case "match-image-distinct":
-    case "match-error-cross-modality":
-      return fixture("phash_rgb8_48x40.png");
-    case "match-image-png-vs-jpeg-same-pixels":
-      return fixture("base_444.png");
-    case "match-audio-self":
-      return fixture("tone.wav");
-    case "match-text-self":
-    case "match-text-distinct":
-      return Buffer.from(prose(0xd1, 4096), "binary");
-    case "match-binary-near-duplicate":
-    case "match-binary-unrelated":
-      return blob48(0xd15e5eed);
-    case "match-video-mp4-vs-mov":
-      return fixture("a_64x48.mp4");
-    default:
-      throw new Error(`no input recipe for ${name}`);
-  }
-}
-
-/** The right-hand input of each match vector. */
-function matchRight(name) {
-  switch (name) {
-    case "match-image-distinct":
-    case "match-image-png-vs-jpeg-same-pixels":
-      return name === "match-image-distinct"
-        ? fixture("phash_gray8_40x32.png")
-        : fixture("base_444.jpg");
-    case "match-text-distinct":
-      return Buffer.from(prose(0xd2, 4096), "binary");
-    case "match-binary-near-duplicate": {
-      const out = Buffer.alloc(1 + 48 * 1024);
-      out[0] = 0xaa;
-      blob48(0xd15e5eed).copy(out, 1);
-      return out;
-    }
-    case "match-binary-unrelated":
-      return blob48(0xbadc0ffe);
-    case "match-video-mp4-vs-mov":
-      return fixture("a_64x48.mov");
-    default:
-      return input(name); // self-matches
-  }
-}
-
-/** f64 bit pattern from a recorded 16-hex-digit string. @param {string} hex */
-const bits = (hex) => BigInt(`0x${hex}`);
-const fnvHex = (bytes) => fnv1a64(bytes).toString(16).padStart(16, "0");
-const shaHex = (bytes) => crypto.createHash("sha256").update(bytes).digest("hex");
-
-/** Words folded little-endian, the canonical payload behind the digests. */
-function wordsLe(words) {
-  const out = Buffer.alloc(words.length * 8);
-  words.forEach((w, i) => out.writeBigUInt64LE(w, i * 8));
-  return out;
-}
-
-test("cdylib is discoverable", () => {
-  assert.ok(fs.statSync(findCdylib()).isFile());
-});
-
-// --- detect: 13 verdict vectors --------------------------------------
-for (const [name, v] of BY_NAME) {
-  if (!name.startsWith("detect-")) continue;
-  test(`${name} verdict is reproduced`, () => {
-    const det = detect(input(name));
-    assert.equal(det.format, v.format, name);
-    assert.equal(det.modality, v.modality, name);
-    assert.equal(det.pending, v.pending, name);
-    assert.ok(FORMATS.includes(det.format) && MODALITIES.includes(det.modality), name);
-  });
-}
-
-// --- signature: 14 fold vectors --------------------------------------
-for (const [name, v] of BY_NAME) {
-  if (!name.startsWith("sig-")) continue;
-  test(`${name} signature folds are reproduced hex-exact`, () => {
-    const sig = signature(input(name));
-    assert.equal(sig.modality, v.modality, name);
-    if (sig.modality === "image") {
-      assert.equal(sig.phash, BigInt(v.phash), name);
-    } else if (sig.modality === "audio") {
-      assert.equal(sig.peakCount, v.peak_count, name);
-      assert.equal(sig.peakCount, sig.peaksBytes.length, name);
-      assert.equal(sig.peakCount % 6, 0, name);
-      assert.equal(sig.frames, v.frames, name);
-      assert.equal(fnvHex(sig.peaksBytes), v.peaks_fnv1a64, name);
-      assert.equal(shaHex(sig.peaksBytes), v.peaks_sha256, name);
-    } else if (sig.modality === "text") {
-      assert.equal(sig.wordCount, v.minhash_words, name);
-      assert.equal(sig.words.length * 8, v.minhash_words, name);
-      assert.equal(fnvHex(wordsLe(sig.words)), v.minhash_fnv1a64, name);
-      assert.equal(shaHex(wordsLe(sig.words)), v.minhash_sha256, name);
-    } else if (sig.modality === "binary") {
-      assert.equal(sig.chunkCount, v.chunk_count, name);
-      assert.equal(sig.chunkCount, sig.digestBytes.length, name);
-      assert.equal(sig.chunkCount % 32, 0, name);
-      assert.equal(fnvHex(sig.digestBytes), v.chunks_fnv1a64, name);
-      assert.equal(shaHex(sig.digestBytes), v.chunks_sha256, name);
-    } else {
-      const frames = wordsLe(sig.frameHashes);
-      const minhash = wordsLe(sig.minhash);
-      assert.equal(sig.frameCount, v.frame_count, name);
-      assert.equal(sig.frameCount, frames.length, name);
-      assert.equal(fnvHex(frames), v.frames_fnv1a64, name);
-      assert.equal(shaHex(frames), v.frames_sha256, name);
-      assert.equal(minhash.length, v.minhash_words, name);
-      assert.equal(fnvHex(minhash), v.minhash_fnv1a64, name);
-      assert.equal(sig.width, v.width, name);
-      assert.equal(sig.height, v.height, name);
-      assert.equal(sig.durationBits, bits(v.duration_bits), name);
-    }
-  });
-}
-
-// --- describe: 7 both-tiers vectors ----------------------------------
-for (const [name, v] of BY_NAME) {
-  if (!name.startsWith("describe-")) continue;
-  test(`${name} description is reproduced hex-exact`, () => {
-    const d = describe(input(name));
-    assert.equal(d.format, v.format, name);
-    assert.equal(d.modality, v.modality, name);
-    assert.equal(d.tier1, v.tier1, name);
-    const s = d.signature;
-    if (s.modality === "image") {
-      assert.equal(s.phash, BigInt(v.phash), name);
-      assert.deepEqual(d.facts, { width: v.facts.width, height: v.facts.height, keypoints: v.facts.keypoints }, name);
-    } else if (s.modality === "audio") {
-      assert.equal(s.peakCount, v.peak_count, name);
-      assert.equal(fnvHex(s.peaksBytes), v.peaks_fnv1a64, name);
-      assert.equal(shaHex(s.peaksBytes), v.peaks_sha256, name);
-      assert.equal(s.frames, v.frames, name);
-      assert.deepEqual(
-        d.facts,
-        { sampleRate: v.facts.sample_rate, channels: v.facts.channels, frames: v.facts.frames, peaks: v.facts.peaks },
-        name,
-      );
-    } else if (s.modality === "text") {
-      assert.equal(s.wordCount, v.minhash_words, name);
-      assert.equal(fnvHex(wordsLe(s.words)), v.minhash_fnv1a64, name);
-      assert.equal(shaHex(wordsLe(s.words)), v.minhash_sha256, name);
-      assert.deepEqual(d.facts, { words: v.facts.words, canonicalLen: v.facts.canonical_len }, name);
-    } else if (s.modality === "binary") {
-      assert.equal(s.chunkCount, v.chunk_count, name);
-      assert.equal(fnvHex(s.digestBytes), v.chunks_fnv1a64, name);
-      assert.equal(shaHex(s.digestBytes), v.chunks_sha256, name);
-      assert.deepEqual(d.facts, { len: v.facts.len, chunks: v.facts.chunks }, name);
-    } else {
-      const frames = wordsLe(s.frameHashes);
-      assert.equal(s.frameCount, v.frame_count, name);
-      assert.equal(fnvHex(frames), v.frames_fnv1a64, name);
-      assert.equal(shaHex(frames), v.frames_sha256, name);
-      assert.equal(wordsLe(s.minhash).length, v.minhash_words, name);
-      assert.equal(fnvHex(wordsLe(s.minhash)), v.minhash_fnv1a64, name);
-      assert.equal(s.width, v.width, name);
-      assert.equal(s.height, v.height, name);
-      assert.equal(s.durationBits, bits(v.duration_bits), name);
-      assert.deepEqual(
-        d.facts,
-        {
-          width: v.facts.width,
-          height: v.facts.height,
-          durationBits: bits(v.facts.duration_bits),
-          framesSampled: v.facts.frames_sampled,
-        },
-        name,
-      );
-    }
-  });
-}
-
-// --- match: 10 outcome vectors ---------------------------------------
-/** Recorded decimal delta_t -> the u64 two's-complement slot. */
-const deltaSlot = (dt) => BigInt(dt < 0 ? dt + 0x10000000000000000 : dt);
-
-for (const [name, v] of BY_NAME) {
-  if (!name.startsWith("match-")) continue;
-  if (v.outcome === "error") {
-    test(`${name} is refused with status -2`, () => {
-      assert.throws(() => matchSignatures(input(name), input("sig-text-prose-4kib")), (err) => {
-        assert.ok(err instanceof FfiError);
-        assert.equal(err.status, -2);
-        return true;
-      });
-    });
-    continue;
-  }
-  test(`${name} match slots are reproduced exactly`, () => {
-    const m = matchSignatures(input(name), matchRight(name));
-    assert.equal(m.matched, v.matched, name);
-    if (v.outcome === "image") {
-      assert.equal(m.tag, "image", name);
-      assert.equal(m.slots[0], BigInt(v.hamming), name);
-    } else if (v.outcome === "audio") {
-      assert.equal(m.tag, "audio", name);
-      assert.equal(m.slots[0], BigInt(v.votes), name);
-      assert.equal(m.slots[1], deltaSlot(v.delta_t), name);
-    } else if (v.outcome === "jaccard") {
-      assert.equal(m.tag, name.startsWith("match-text") ? "text" : "binary", name);
-      assert.equal(m.slots[0], bits(v.jaccard_bits), name);
-    } else {
-      assert.equal(m.tag, "video", name);
-      assert.equal(m.slots[0], bits(v.score_bits), name);
-      assert.equal(m.slots[1], bits(v.minhash_jaccard_bits), name);
-    }
-  });
-}
-
-// --- error vector + refusals -----------------------------------------
-test("non-AVC mp4 is refused with status -2", () => {
-  assert.throws(() => signature(fixture("e_mp4v.mp4")), (err) => {
-    assert.ok(err instanceof FfiError);
-    assert.equal(err.status, -2);
-    return true;
-  });
-});
-
-test("corrupt container is refused, not crashing", () => {
-  const corrupt = Buffer.concat([Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]), Buffer.from("garbage")]);
-  assert.throws(() => signature(corrupt), (err) => {
-    assert.ok(err instanceof FfiError);
-    assert.equal(err.status, -2);
-    return true;
-  });
-  assert.throws(() => describe(corrupt), FfiError);
-  assert.throws(() => contentHash(corrupt), (err) => {
-    assert.ok(err instanceof FfiError);
-    assert.equal(err.status, -2);
-    return true;
-  });
-});
-
-test("content hash matches a rust-derived pinned value", () => {
-  // text_page.pdf's tier-1 digest, derived once from the built cdylib
-  // and pinned here so a wrongly regenerated reference.json cannot
-  // mask drift. The same pin lives in the Python and Go harnesses and
-  // the Rust ffi tests.
-  const digest = contentHash(fixture("text_page.pdf"));
-  assert.equal(digest.length, 32);
-  assert.equal(
-    digest.toString("hex"),
-    "849978a1682ba75372094611c8fc290b9c39b84d75641bf0b6129cdbaa880fa9",
-  );
-});