relaxnative 0.1.2 → 0.1.4

package/dist/cli.js

@@ -10,12 +10,12 @@ import {
   removePackage,
   runNativeTests,
   updateIndex
-} from "./chunk-ZTBXEEMF.js";
+} from "./chunk-2KRTGQYD.js";
 import {
   detectCompilers,
   getCacheRoot
-} from "./chunk-GVGWP3E2.js";
-import "./chunk-CRQZJC5B.js";
+} from "./chunk-UGGUZN4H.js";
+import "./chunk-HBO7F7P4.js";
 import "./chunk-LLZ4I4OR.js";
 import "./chunk-MLKGABMK.js";
 
@@ -64,6 +64,7 @@ Notes:
 	- Trust levels: local (no prompts), community (warning + confirmation), verified (silent install, requires signature)
 	- Add: pass --yes to make the command non-interactive (community installs will fail unless previously trusted)
 	- Bench: pass --traditional to include a JS baseline when available (built-in for add)
+	- Bench: --traditional requires --baseline <path> + --args "[...]" so both JS and native get the same inputs
 `);
 }
 function fmtOk(msg) {
@@ -179,6 +180,7 @@ async function main() {
     const iterationsRaw = getFlagValue(process.argv, "--iterations");
     const warmupRaw = getFlagValue(process.argv, "--warmup");
     const argsRaw = getFlagValue(process.argv, "--args");
+    const jsBaselinePath = getFlagValue(process.argv, "--baseline");
     const json = hasFlag(process.argv, "--json");
     const traditional = hasFlag(process.argv, "--traditional");
     const confirm = hasFlag(process.argv, "--confirm");
@@ -203,6 +205,32 @@ async function main() {
         process.exit(1);
       }
     }
+    let baseline;
+    if (traditional) {
+      if (!jsBaselinePath) {
+        console.error("Missing --baseline <path>. Example: --baseline ./benchmarks/matmul.js");
+        process.exit(1);
+      }
+      try {
+        const mod = await import(jsBaselinePath);
+        baseline = mod?.default ?? mod?.baseline ?? mod?.fn;
+        if (typeof baseline !== "function") {
+          console.error(
+            "Invalid baseline module: expected a default export (or named export baseline/fn) that is a function."
+          );
+          process.exit(1);
+        }
+      } catch (e) {
+        console.error("Failed to import baseline module:", e?.message ?? String(e));
+        process.exit(1);
+      }
+      if (!Array.isArray(args)) {
+        console.error(
+          "When using --traditional you must also pass --args as a JSON array so the baseline and native get identical inputs."
+        );
+        process.exit(1);
+      }
+    }
     const iterations = iterationsRaw ? Number(iterationsRaw) : 5e4;
     const warmup = warmupRaw ? Number(warmupRaw) : 2e3;
     trace("bench parsed flags", { iterations, warmup, hasArgs: Array.isArray(args) });
@@ -225,7 +253,8 @@ async function main() {
         const res = await benchmarkCompareTraditionalVsRelaxnative(nativeFile, fnName, {
           iterations,
           warmup,
-          args
+          args,
+          baseline
         });
         trace("bench traditional: done");
         if (json) console.log(JSON.stringify(res, null, 2));

package/dist/index.d.ts

@@ -12,9 +12,22 @@ type RelaxConfig = {
     defaultMode?: ExecutionMode;
 };
 type IsolationMode = 'in-process' | 'worker' | 'process';
+type NativeBuildOptions = {
+    /** Additional source files to compile+link into the same shared library (C/C++ only). */
+    sources?: string[];
+    /** Header search paths (-I). */
+    includePaths?: string[];
+    /** Library search paths (-L / /LIBPATH). */
+    libraryPaths?: string[];
+    /** Link libraries (-lfoo / foo.lib). */
+    libraries?: string[];
+    /** Additional raw compiler/linker flags. */
+    flags?: string[];
+};
 declare function loadNative(sourcePath: string, options?: {
     config?: RelaxConfig;
     isolation?: IsolationMode;
+    build?: NativeBuildOptions;
 }): Promise<any>;
 /**
  * Advanced API: returns both the wrapped module and the computed bindings.
@@ -23,6 +36,7 @@ declare function loadNative(sourcePath: string, options?: {
 declare function loadNativeWithBindings(sourcePath: string, options?: {
     config?: RelaxConfig;
     isolation?: IsolationMode;
+    build?: NativeBuildOptions;
     mutateBindings?: (bindings: any) => void;
 }): Promise<{
     mod: any;
@@ -390,9 +404,27 @@ type CompilerInfo$1 = {
 type NativeLanguage = 'c' | 'cpp' | 'rust';
 
 type CompileRequest = {
+    /**
+     * Primary entry source file.
+     *
+     * For multi-file builds, `sourcePath` is used as the "entry" for:
+     * - language detection (C vs C++)
+     * - output library naming
+     *
+     * The full compilation inputs are `sourcePath` + `sources`.
+     */
     sourcePath: string;
+    /** Additional source files to compile and link into the same shared library. */
+    sources?: string[];
     outDir: string;
+    /** Additional raw compiler/linker flags (advanced escape hatch). */
     flags?: string[];
+    /** Header search paths (translated to -I). */
+    includePaths?: string[];
+    /** Library search paths (translated to -L). */
+    libraryPaths?: string[];
+    /** Libraries to link (translated to -l<name>). Example: ['m', 'pthread'] */
+    libraries?: string[];
 };
 type CompileResult = {
     language: NativeLanguage;
@@ -404,4 +436,4 @@ declare function compileNative(compiler: CompilerInfo$1, platform: PlatformInfo,
 
 declare function compileWithCache(compiler: CompilerInfo$1, platform: PlatformInfo, request: CompileRequest): CompileResult;
 
-export { type BenchmarkOptions, type BenchmarkResult, type ExecutionMode, type HotReloadHandle, type HotReloadOptions, type InstallOptions, type InstallResult, InvalidFreeError, type IsolationMode, MemoryError, type NativeAddress, NativeBuffer, NativePointer, type NativeTestCase, type NativeTestKind, type NativeTestResult, NullPointerError, type Ownership, type RawAllocation, type RelaxConfig, type TraditionalBenchmarkResult, UseAfterFreeError, alloc, allocRaw, benchmarkCompareSyncVsWorker, benchmarkCompareTraditionalVsRelaxnative, benchmarkJsFunction, benchmarkNativeFunction, compileNative, compileWithCache, detectCompilers, discoverNativeTestFiles, discoverNativeTests, discoverNativeTestsFromFile, formatBenchmarkCompare, formatBenchmarkResult, formatBenchmarkTraditionalCompare, formatNativeTestResults, free, freeRaw, getInstalledPackageDir, getProjectRoot, getRegistryRoot, getSourceLine, installPackage, installPackageEnforcingTrust, listPackages, loadNative, loadNativeDevHot, loadNativeWithBindings, loadRegistry, index as native, readRelaxJson, removePackage, resolveRegistryImport, runNativeTests, updateIndex };
+export { type BenchmarkOptions, type BenchmarkResult, type ExecutionMode, type HotReloadHandle, type HotReloadOptions, type InstallOptions, type InstallResult, InvalidFreeError, type IsolationMode, MemoryError, type NativeAddress, NativeBuffer, type NativeBuildOptions, NativePointer, type NativeTestCase, type NativeTestKind, type NativeTestResult, NullPointerError, type Ownership, type RawAllocation, type RelaxConfig, type TraditionalBenchmarkResult, UseAfterFreeError, alloc, allocRaw, benchmarkCompareSyncVsWorker, benchmarkCompareTraditionalVsRelaxnative, benchmarkJsFunction, benchmarkNativeFunction, compileNative, compileWithCache, detectCompilers, discoverNativeTestFiles, discoverNativeTests, discoverNativeTestsFromFile, formatBenchmarkCompare, formatBenchmarkResult, formatBenchmarkTraditionalCompare, formatNativeTestResults, free, freeRaw, getInstalledPackageDir, getProjectRoot, getRegistryRoot, getSourceLine, installPackage, installPackageEnforcingTrust, listPackages, loadNative, loadNativeDevHot, loadNativeWithBindings, loadRegistry, index as native, readRelaxJson, removePackage, resolveRegistryImport, runNativeTests, updateIndex };

package/dist/index.js

@@ -24,7 +24,7 @@ import {
   runNativeTests,
   trustPolicy,
   updateIndex
-} from "./chunk-ZTBXEEMF.js";
+} from "./chunk-2KRTGQYD.js";
 import {
   alloc,
   allocRaw,
@@ -37,8 +37,8 @@ import {
   loadNativeDevHot,
   loadNativeWithBindings,
   memory_exports
-} from "./chunk-GVGWP3E2.js";
-import "./chunk-CRQZJC5B.js";
+} from "./chunk-UGGUZN4H.js";
+import "./chunk-HBO7F7P4.js";
 import {
   InvalidFreeError,
   MemoryError,

package/dist/memory/memory.selftest.js

@@ -1,8 +1,8 @@
 import {
   alloc,
   loadNative
-} from "../chunk-GVGWP3E2.js";
-import "../chunk-CRQZJC5B.js";
+} from "../chunk-UGGUZN4H.js";
+import "../chunk-HBO7F7P4.js";
 import "../chunk-LLZ4I4OR.js";
 import "../chunk-MLKGABMK.js";
 

package/dist/worker/processEntry.js

@@ -1,6 +1,6 @@
 import {
   wrapFunctions
-} from "../chunk-CRQZJC5B.js";
+} from "../chunk-HBO7F7P4.js";
 import {
   loadFfi
 } from "../chunk-LLZ4I4OR.js";
@@ -75,6 +75,39 @@ import { createRequire as createRequire2 } from "module";
 function reply(msg) {
   if (process.send) process.send(msg);
 }
+function reviveArg(a) {
+  if (!a || typeof a !== "object") return a;
+  if (a.__relaxnative_typedarray === true && a.bytes) {
+    const buf = Buffer.isBuffer(a.bytes) ? a.bytes : a.bytes?.type === "Buffer" && Array.isArray(a.bytes?.data) ? Buffer.from(a.bytes.data) : Array.isArray(a.bytes) ? Buffer.from(a.bytes) : Buffer.from([]);
+    const u8 = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+    const ab = u8.slice().buffer;
+    switch (a.type) {
+      case "Uint8Array":
+        return new Uint8Array(ab);
+      case "Int8Array":
+        return new Int8Array(ab);
+      case "Uint16Array":
+        return new Uint16Array(ab);
+      case "Int16Array":
+        return new Int16Array(ab);
+      case "Uint32Array":
+        return new Uint32Array(ab);
+      case "Int32Array":
+        return new Int32Array(ab);
+      case "BigInt64Array":
+        return new BigInt64Array(ab);
+      case "BigUint64Array":
+        return new BigUint64Array(ab);
+      case "Float32Array":
+        return new Float32Array(ab);
+      case "Float64Array":
+        return new Float64Array(ab);
+      default:
+        return new Uint8Array(ab);
+    }
+  }
+  return a;
+}
 process.on("message", async (msg) => {
   try {
     if (!msg || typeof msg.id !== "number") return;
@@ -139,8 +172,22 @@ process.on("message", async (msg) => {
       return;
     }
     try {
-      const result = await fn(...msg.args);
-      reply({ id: msg.id, ok: true, result });
+      const boxedArgs = Array.isArray(msg.args) ? msg.args : [];
+      const revivedArgs = Array.isArray(msg.args) ? msg.args.map(reviveArg) : msg.args;
+      const result = await fn(...revivedArgs);
+      if (Array.isArray(revivedArgs) && Array.isArray(boxedArgs)) {
+        for (let i = 0; i < revivedArgs.length; i++) {
+          const revived = revivedArgs[i];
+          const boxed = boxedArgs[i];
+          if (boxed?.__relaxnative_typedarray === true && revived && ArrayBuffer.isView(revived)) {
+            const view = revived;
+            boxed.bytes = Buffer.from(
+              view.buffer.slice(view.byteOffset, view.byteOffset + view.byteLength)
+            );
+          }
+        }
+      }
+      reply({ id: msg.id, ok: true, result, args: boxedArgs });
     } finally {
       guards.restore();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relaxnative",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "description": "Zero-config native C/C++/Rust execution for Node.js",
   "license": "MIT",
@@ -37,9 +37,11 @@
   ],
   "scripts": {
     "build": "tsup src/index.ts src/cli.ts src/worker/workerEntry.ts src/worker/processEntry.ts src/esmLoader.ts src/memory/memory.selftest.ts --format esm --dts",
-    "test": "vitest --run --pool=threads --maxWorkers=1",
-    "test:inband": "vitest --run --pool=threads --maxWorkers=1",
-    "test:native": "vitest --run --pool=threads --maxWorkers=1 src/memory/memory.test.ts",
+    "test": "vitest --run",
+    "test:inband": "vitest --run --pool=forks --maxWorkers=1",
+    "test:native": "vitest --run --pool=forks --maxWorkers=1 src/memory/memory.test.ts",
+    "test:threads": "vitest --run --pool=threads --maxWorkers=1",
+    "test:forks": "vitest --run --pool=forks --maxWorkers=1",
     "selftest:memory": "npm run build && node dist/memory/memory.selftest.js",
     "prepack": "npm run build",
     "release:beta": "npm publish --tag beta",