@taulabs/openrscad-engine 0.11.0-beta.2 → 0.11.0-beta.4

package/dist/node.d.ts

@@ -1,5 +1,13 @@
-/** Resolves immediately — the wasm is already instantiated on import in Node. */
+import { type Backend } from "./core.js";
+/** Resolves immediately — whichever binding bound is initialized on import. */
 export declare function ensureReady(): Promise<void>;
+/** Which binding this process bound. `"wasm"` means no platform package matched
+ *  the host and the in-package WebAssembly build took over. */
+export declare const backend: Backend;
+/** The native loader's failure chain when `backend` is `"wasm"` and the addon
+ *  was tried, else `undefined`. Never flattened to a string — it names every
+ *  candidate the loader attempted. */
+export declare const backendCause: unknown;
 export declare const render: (source: string, opts?: import("./core.js").RenderOptions) => Promise<import("./core.js").RenderOutput>;
 export declare const renderToGlb: (source: string, opts?: import("./core.js").RenderToGlbOptions) => Promise<import("./core.js").ExportShape3DOutput>;
 export declare const exportShape2D: (source: string, format: "dxf" | "svg", opts?: import("./core.js").RenderOptions) => Promise<string>;
@@ -10,5 +18,11 @@ export declare const exportShape3D: {
 export declare const parameters: (source: string) => Promise<string>;
 export declare const version: () => Promise<string>;
 export declare const clearCache: () => Promise<void>;
-export type { Diagnostic, ExportGlbOptions, ExportShape3DFormat, ExportShape3DOutput, RenderOptions, RenderOutput, RenderToGlbOptions, } from "./core.js";
+export declare const exportCache: (opts?: {
+    sinceEpoch?: number;
+}) => Promise<Uint8Array>;
+export declare const importCache: (bytes: Uint8Array) => Promise<import("./core.js").CacheImportReport>;
+export declare const cacheStats: () => Promise<import("./core.js").CacheStats>;
+export declare const cacheKeys: () => Promise<BigUint64Array>;
+export type { Backend, CacheImportReport, CacheStats, Diagnostic, ExportGlbOptions, ExportShape3DFormat, ExportShape3DOutput, RenderOptions, RenderOutput, RenderToGlbOptions, } from "./core.js";
 //# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAiBA,iFAAiF;AACjF,wBAAgB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3C;AAcD,eAAO,MAAM,MAAM,yGAAa,CAAC;AACjC,eAAO,MAAM,WAAW,qHAAkB,CAAC;AAC3C,eAAO,MAAM,aAAa,sGAAoB,CAAC;AAC/C,eAAO,MAAM,aAAa;;;CAAoB,CAAC;AAC/C,eAAO,MAAM,UAAU,qCAAiB,CAAC;AACzC,eAAO,MAAM,OAAO,uBAAc,CAAC;AACnC,eAAO,MAAM,UAAU,qBAAiB,CAAC;AAEzC,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAW,KAAK,OAAO,EAAkB,MAAM,WAAW,CAAC;AAElE,+EAA+E;AAC/E,wBAAgB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3C;AA8BD;+DAC+D;AAC/D,eAAO,MAAM,OAAO,EAAE,OAAe,CAAC;AAEtC;;sCAEsC;AACtC,eAAO,MAAM,YAAY,EAAE,OAAe,CAAC;AAI3C,eAAO,MAAM,MAAM,yGAAa,CAAC;AACjC,eAAO,MAAM,WAAW,qHAAkB,CAAC;AAC3C,eAAO,MAAM,aAAa,sGAAoB,CAAC;AAC/C,eAAO,MAAM,aAAa;;;CAAoB,CAAC;AAC/C,eAAO,MAAM,UAAU,qCAAiB,CAAC;AACzC,eAAO,MAAM,OAAO,uBAAc,CAAC;AACnC,eAAO,MAAM,UAAU,qBAAiB,CAAC;AACzC,eAAO,MAAM,WAAW;cAiBgsT,CAAC;yBAjB/qT,CAAC;AAC3C,eAAO,MAAM,WAAW,uEAAkB,CAAC;AAC3C,eAAO,MAAM,UAAU,+CAAiB,CAAC;AACzC,eAAO,MAAM,SAAS,+BAAgB,CAAC;AAEvC,YAAY,EACV,OAAO,EACP,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,WAAW,CAAC"}

package/dist/node.js

@@ -1,24 +1,59 @@
 // Node entry (the `node` + `import` export condition).
 //
-// The nodejs-target glue instantiates the wasm synchronously on import, so there
-// is no async init step: `ensureReady()` resolves immediately and exists only
-// for API parity with the browser entry. (CommonJS `require()` consumers resolve
-// to the raw `pkg/node/openrscad.js` glue directly — see the package `exports` map.)
-import { render_with_files as rawRenderWithFiles, export_2d as rawExport2d, export_3d as rawExport3d, render_to_glb as rawRenderToGlb, parameters as rawParameters, version as rawVersion, clear_cache as rawClearCache, } from "../pkg/node/openrscad.js";
+// One package, two payloads. `@taulabs/openrscad-engine` compiles one Rust
+// pipeline (`crates/openrscad-api`) through two marshalling layers, so this
+// entry binds the N-API addon when a platform package — or a colocated build —
+// matches the host, and the in-package wasm Node build when none does. Both
+// bindings are fed the same `makeApi()` facade, so there is no second place for
+// the two engines' semantics to drift apart; `src/api-parity.ts` asserts this
+// module and the browser entry stay structurally identical.
+//
+// The addon is loaded through the NAPI-RS-generated loader (never a
+// hand-written platform table), which throws one `Error` whose `cause` chains
+// every failed candidate. An uncovered platform must not lose the engine, so
+// that error is kept on `backendCause` and the wasm build takes over instead of
+// the import throwing. `backend` says which one bound — the fallback is never
+// silent. (CommonJS `require()` consumers resolve the raw `pkg/node/openrscad.js`
+// glue directly and are always wasm — see the package `exports` map.)
 import { makeApi } from "./core.js";
-/** Resolves immediately — the wasm is already instantiated on import in Node. */
+/** Resolves immediately — whichever binding bound is initialized on import. */
 export function ensureReady() {
     return Promise.resolve();
 }
-const engine = {
-    render_with_files: rawRenderWithFiles,
-    export_2d: rawExport2d,
-    export_3d: rawExport3d,
-    render_to_glb: rawRenderToGlb,
-    parameters: rawParameters,
-    version: rawVersion,
-    clear_cache: rawClearCache,
-};
+async function loadWasm() {
+    const glue = await import("../pkg/node/openrscad.js");
+    return {
+        render_with_files: glue.render_with_files,
+        export_2d: glue.export_2d,
+        export_3d: glue.export_3d,
+        render_to_glb: glue.render_to_glb,
+        parameters: glue.parameters,
+        version: glue.version,
+        clear_cache: glue.clear_cache,
+        cache_export: glue.cache_export,
+        cache_import: glue.cache_import,
+        cache_stats: glue.cache_stats,
+        cache_keys: glue.cache_keys,
+    };
+}
+let bound = "native";
+let cause;
+let engine;
+try {
+    engine = (await import("./native/index.js"));
+}
+catch (error) {
+    cause = error;
+    bound = "wasm";
+    engine = await loadWasm();
+}
+/** Which binding this process bound. `"wasm"` means no platform package matched
+ *  the host and the in-package WebAssembly build took over. */
+export const backend = bound;
+/** The native loader's failure chain when `backend` is `"wasm"` and the addon
+ *  was tried, else `undefined`. Never flattened to a string — it names every
+ *  candidate the loader attempted. */
+export const backendCause = cause;
 const api = makeApi(engine, ensureReady);
 export const render = api.render;
 export const renderToGlb = api.renderToGlb;
@@ -27,4 +62,8 @@ export const exportShape3D = api.exportShape3D;
 export const parameters = api.parameters;
 export const version = api.version;
 export const clearCache = api.clearCache;
+export const exportCache = api.exportCache;
+export const importCache = api.importCache;
+export const cacheStats = api.cacheStats;
+export const cacheKeys = api.cacheKeys;
 //# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,iFAAiF;AACjF,8EAA8E;AAC9E,iFAAiF;AACjF,qFAAqF;AACrF,OAAO,EACL,iBAAiB,IAAI,kBAAkB,EACvC,SAAS,IAAI,WAAW,EACxB,SAAS,IAAI,WAAW,EACxB,aAAa,IAAI,cAAc,EAC/B,UAAU,IAAI,aAAa,EAC3B,OAAO,IAAI,UAAU,EACrB,WAAW,IAAI,aAAa,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAEpD,iFAAiF;AACjF,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,MAAM,GAAG;IACb,iBAAiB,EAAE,kBAAkB;IACrC,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,aAAa,EAAE,cAAc;IAC7B,UAAU,EAAE,aAAa;IACzB,OAAO,EAAE,UAAU;IACnB,WAAW,EAAE,aAAa;CACH,CAAC;AAE1B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEzC,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;AAC/C,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;AACzC,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;AACnC,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,+EAA+E;AAC/E,4EAA4E;AAC5E,gFAAgF;AAChF,8EAA8E;AAC9E,4DAA4D;AAC5D,EAAE;AACF,oEAAoE;AACpE,8EAA8E;AAC9E,6EAA6E;AAC7E,gFAAgF;AAChF,8EAA8E;AAC9E,kFAAkF;AAClF,sEAAsE;AACtE,OAAO,EAAE,OAAO,EAAgC,MAAM,WAAW,CAAC;AAElE,+EAA+E;AAC/E,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IACtD,OAAO;QACL,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;KACJ,CAAC;AAC5B,CAAC;AAED,IAAI,KAAK,GAAY,QAAQ,CAAC;AAC9B,IAAI,KAAc,CAAC;AACnB,IAAI,MAAiB,CAAC;AACtB,IAAI,CAAC;IACH,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAyB,CAAC;AACvE,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,KAAK,GAAG,KAAK,CAAC;IACd,KAAK,GAAG,MAAM,CAAC;IACf,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED;+DAC+D;AAC/D,MAAM,CAAC,MAAM,OAAO,GAAY,KAAK,CAAC;AAEtC;;sCAEsC;AACtC,MAAM,CAAC,MAAM,YAAY,GAAY,KAAK,CAAC;AAE3C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEzC,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;AAC/C,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;AACzC,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;AACnC,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;AAC3C,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;AAC3C,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taulabs/openrscad-engine",
-  "version": "0.11.0-beta.2",
+  "version": "0.11.0-beta.4",
   "description": "Tau's fork of the OpenRSCAD geometry engine, compiled to WebAssembly — parse .scad source and render solid 3D meshes in the browser or Node. Adds an authored-scene GLB/3MF export path with source-derived feature edges; tracks upstream.",
   "type": "module",
   "license": "Apache-2.0 OR MIT",
@@ -44,6 +44,10 @@
         "default": "./dist/browser.js"
       }
     },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "default": "./dist/core.js"
+    },
     "./web": {
       "types": "./pkg/web/openrscad.d.ts",
       "default": "./pkg/web/openrscad.js"
@@ -61,6 +65,7 @@
   ],
   "files": [
     "dist",
+    "!dist/native/*.node",
     "pkg/web",
     "pkg/node",
     "examples",
@@ -68,21 +73,44 @@
     "LICENSE-APACHE",
     "LICENSE-MIT"
   ],
+  "engines": {
+    "node": ">=20"
+  },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "scripts": {
-    "build": "npm run build:wasm && npm run build:facade",
+    "build": "npm run build:wasm && npm run build:addon && npm run build:facade",
     "build:wasm": "wasm-pack build ../../crates/openrscad-wasm --release --target web --out-dir \"$PWD/pkg/web\" --out-name openrscad && wasm-pack build ../../crates/openrscad-wasm --release --target nodejs --out-dir \"$PWD/pkg/node\" --out-name openrscad && rm -f pkg/web/.gitignore pkg/node/.gitignore",
     "build:wasm:profile": "wasm-pack build ../../crates/openrscad-wasm --release --target web --out-dir \"$PWD/pkg/web\" --out-name openrscad -- --features benchmark-profile && wasm-pack build ../../crates/openrscad-wasm --release --target nodejs --out-dir \"$PWD/pkg/node\" --out-name openrscad -- --features benchmark-profile && rm -f pkg/web/.gitignore pkg/node/.gitignore",
-    "build:facade": "tsc -p tsconfig.json",
+    "build:addon": "napi build --platform --release --esm --js index.js --dts index.d.ts --output-dir ./src/native --manifest-path ../../crates/openrscad-napi/Cargo.toml",
+    "build:facade": "tsc -p tsconfig.json && node scripts/copy-native.mjs",
     "test": "npm run build:facade && node --test test/*.test.mjs"
   },
   "devDependencies": {
+    "@napi-rs/cli": "3.8.6",
     "typescript": "^5.5.3"
   },
   "contributors": [
     "Richard Fontein (Tau)"
-  ]
-}
+  ],
+  "napi": {
+    "binaryName": "openrscad",
+    "packageName": "@taulabs/openrscad-engine",
+    "targets": [
+      "aarch64-apple-darwin",
+      "x86_64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu",
+      "x86_64-pc-windows-msvc"
+    ]
+  },
+  "optionalDependencies": {
+    "@taulabs/openrscad-engine-darwin-arm64": "0.11.0-beta.4",
+    "@taulabs/openrscad-engine-darwin-x64": "0.11.0-beta.4",
+    "@taulabs/openrscad-engine-linux-x64-gnu": "0.11.0-beta.4",
+    "@taulabs/openrscad-engine-linux-arm64-gnu": "0.11.0-beta.4",
+    "@taulabs/openrscad-engine-win32-x64-msvc": "0.11.0-beta.4"
+  }
+}

package/pkg/node/openrscad.d.ts

@@ -107,6 +107,28 @@ export class RenderResult {
     readonly warnings: string;
 }
 
+/**
+ * Serialize the geometry-cache entries added at or after `since_epoch`
+ * (`0` = everything) as an opaque, versioned blob for the host to persist.
+ */
+export function cache_export(since_epoch: number): Uint8Array;
+
+/**
+ * Rehydrate entries from a `cache_export` blob of the same engine version and
+ * kernel. Returns a JSON report; throws on a foreign or malformed blob.
+ */
+export function cache_import(bytes: Uint8Array): string;
+
+/**
+ * Every resident structural key, ascending, as a `BigUint64Array`.
+ */
+export function cache_keys(): BigUint64Array;
+
+/**
+ * Resident-cache accounting, caps and envelope as JSON.
+ */
+export function cache_stats(): string;
+
 /**
  * Drop the persistent geometry cache (e.g. when loading a new document).
  */

package/pkg/node/openrscad.js

@@ -444,6 +444,78 @@ class RenderResult {
 if (Symbol.dispose) RenderResult.prototype[Symbol.dispose] = RenderResult.prototype.free;
 exports.RenderResult = RenderResult;
 
+/**
+ * Serialize the geometry-cache entries added at or after `since_epoch`
+ * (`0` = everything) as an opaque, versioned blob for the host to persist.
+ * @param {number} since_epoch
+ * @returns {Uint8Array}
+ */
+function cache_export(since_epoch) {
+    const ret = wasm.cache_export(since_epoch);
+    var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v1;
+}
+exports.cache_export = cache_export;
+
+/**
+ * Rehydrate entries from a `cache_export` blob of the same engine version and
+ * kernel. Returns a JSON report; throws on a foreign or malformed blob.
+ * @param {Uint8Array} bytes
+ * @returns {string}
+ */
+function cache_import(bytes) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.cache_import(ptr0, len0);
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+exports.cache_import = cache_import;
+
+/**
+ * Every resident structural key, ascending, as a `BigUint64Array`.
+ * @returns {BigUint64Array}
+ */
+function cache_keys() {
+    const ret = wasm.cache_keys();
+    var v1 = getArrayU64FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 8, 8);
+    return v1;
+}
+exports.cache_keys = cache_keys;
+
+/**
+ * Resident-cache accounting, caps and envelope as JSON.
+ * @returns {string}
+ */
+function cache_stats() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const ret = wasm.cache_stats();
+        deferred1_0 = ret[0];
+        deferred1_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+    }
+}
+exports.cache_stats = cache_stats;
+
 /**
  * Drop the persistent geometry cache (e.g. when loading a new document).
  */
@@ -734,6 +806,10 @@ exports.version = version;
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbg_Error_92b29b0548f8b746: function(arg0, arg1) {
+            const ret = Error(getStringFromWasm0(arg0, arg1));
+            return ret;
+        },
         __wbg___wbindgen_string_get_b0ca35b86a603356: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'string' ? obj : undefined;
@@ -801,11 +877,24 @@ function getArrayF32FromWasm0(ptr, len) {
     return getFloat32ArrayMemory0().subarray(ptr / 4, ptr / 4 + len);
 }
 
+function getArrayU64FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getBigUint64ArrayMemory0().subarray(ptr / 8, ptr / 8 + len);
+}
+
 function getArrayU8FromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
 }
 
+let cachedBigUint64ArrayMemory0 = null;
+function getBigUint64ArrayMemory0() {
+    if (cachedBigUint64ArrayMemory0 === null || cachedBigUint64ArrayMemory0.byteLength === 0) {
+        cachedBigUint64ArrayMemory0 = new BigUint64Array(wasm.memory.buffer);
+    }
+    return cachedBigUint64ArrayMemory0;
+}
+
 let cachedDataViewMemory0 = null;
 function getDataViewMemory0() {
     if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
@@ -838,6 +927,13 @@ function isLikeNone(x) {
     return x === undefined || x === null;
 }
 
+function passArray8ToWasm0(arg, malloc) {
+    const ptr = malloc(arg.length * 1, 1) >>> 0;
+    getUint8ArrayMemory0().set(arg, ptr / 1);
+    WASM_VECTOR_LEN = arg.length;
+    return ptr;
+}
+
 function passArrayJsValueToWasm0(array, malloc) {
     const ptr = malloc(array.length * 4, 4) >>> 0;
     for (let i = 0; i < array.length; i++) {
@@ -885,6 +981,12 @@ function passStringToWasm0(arg, malloc, realloc) {
     return ptr;
 }
 
+function takeFromExternrefTable0(idx) {
+    const value = wasm.__wbindgen_externrefs.get(idx);
+    wasm.__externref_table_dealloc(idx);
+    return value;
+}
+
 let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
 cachedTextDecoder.decode();
 function decodeText(ptr, len) {

package/pkg/node/openrscad_bg.wasm.d.ts

@@ -3,6 +3,10 @@
 export const memory: WebAssembly.Memory;
 export const __wbg_exportshape3dresult_free: (a: number, b: number) => void;
 export const __wbg_renderresult_free: (a: number, b: number) => void;
+export const cache_export: (a: number) => [number, number];
+export const cache_import: (a: number, b: number) => [number, number, number, number];
+export const cache_keys: () => [number, number];
+export const cache_stats: () => [number, number];
 export const export_2d: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number) => [number, number];
 export const export_3d: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number) => number;
 export const exportshape3dresult_area: (a: number) => number;
@@ -45,12 +49,13 @@ export const renderresult_viewport: (a: number) => [number, number];
 export const renderresult_warnings: (a: number) => [number, number];
 export const version: () => [number, number];
 export const start: () => void;
-export const clear_cache: () => void;
 export const renderresult_area: (a: number) => number;
 export const renderresult_volume: (a: number) => number;
+export const clear_cache: () => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_free: (a: number, b: number, c: number) => void;
 export const __wbindgen_externrefs: WebAssembly.Table;
+export const __externref_table_dealloc: (a: number) => void;
 export const __externref_table_alloc: () => number;
 export const __wbindgen_start: () => void;

package/pkg/node/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openrscad-wasm",
-  "version": "0.11.0-beta.2",
+  "version": "0.11.0-beta.4",
   "license": "Apache-2.0 OR MIT",
   "repository": {
     "type": "git",

package/pkg/web/openrscad.d.ts

@@ -107,6 +107,28 @@ export class RenderResult {
     readonly warnings: string;
 }
 
+/**
+ * Serialize the geometry-cache entries added at or after `since_epoch`
+ * (`0` = everything) as an opaque, versioned blob for the host to persist.
+ */
+export function cache_export(since_epoch: number): Uint8Array;
+
+/**
+ * Rehydrate entries from a `cache_export` blob of the same engine version and
+ * kernel. Returns a JSON report; throws on a foreign or malformed blob.
+ */
+export function cache_import(bytes: Uint8Array): string;
+
+/**
+ * Every resident structural key, ascending, as a `BigUint64Array`.
+ */
+export function cache_keys(): BigUint64Array;
+
+/**
+ * Resident-cache accounting, caps and envelope as JSON.
+ */
+export function cache_stats(): string;
+
 /**
  * Drop the persistent geometry cache (e.g. when loading a new document).
  */
@@ -179,6 +201,10 @@ export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly __wbg_exportshape3dresult_free: (a: number, b: number) => void;
     readonly __wbg_renderresult_free: (a: number, b: number) => void;
+    readonly cache_export: (a: number) => [number, number];
+    readonly cache_import: (a: number, b: number) => [number, number, number, number];
+    readonly cache_keys: () => [number, number];
+    readonly cache_stats: () => [number, number];
     readonly export_2d: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number) => [number, number];
     readonly export_3d: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number) => number;
     readonly exportshape3dresult_area: (a: number) => number;
@@ -221,13 +247,14 @@ export interface InitOutput {
     readonly renderresult_warnings: (a: number) => [number, number];
     readonly version: () => [number, number];
     readonly start: () => void;
-    readonly clear_cache: () => void;
     readonly renderresult_area: (a: number) => number;
     readonly renderresult_volume: (a: number) => number;
+    readonly clear_cache: () => void;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;
     readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __externref_table_dealloc: (a: number) => void;
     readonly __externref_table_alloc: () => number;
     readonly __wbindgen_start: () => void;
 }

package/pkg/web/openrscad.js

@@ -442,6 +442,74 @@ export class RenderResult {
 }
 if (Symbol.dispose) RenderResult.prototype[Symbol.dispose] = RenderResult.prototype.free;
 
+/**
+ * Serialize the geometry-cache entries added at or after `since_epoch`
+ * (`0` = everything) as an opaque, versioned blob for the host to persist.
+ * @param {number} since_epoch
+ * @returns {Uint8Array}
+ */
+export function cache_export(since_epoch) {
+    const ret = wasm.cache_export(since_epoch);
+    var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v1;
+}
+
+/**
+ * Rehydrate entries from a `cache_export` blob of the same engine version and
+ * kernel. Returns a JSON report; throws on a foreign or malformed blob.
+ * @param {Uint8Array} bytes
+ * @returns {string}
+ */
+export function cache_import(bytes) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.cache_import(ptr0, len0);
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * Every resident structural key, ascending, as a `BigUint64Array`.
+ * @returns {BigUint64Array}
+ */
+export function cache_keys() {
+    const ret = wasm.cache_keys();
+    var v1 = getArrayU64FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 8, 8);
+    return v1;
+}
+
+/**
+ * Resident-cache accounting, caps and envelope as JSON.
+ * @returns {string}
+ */
+export function cache_stats() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const ret = wasm.cache_stats();
+        deferred1_0 = ret[0];
+        deferred1_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+    }
+}
+
 /**
  * Drop the persistent geometry cache (e.g. when loading a new document).
  */
@@ -721,6 +789,10 @@ export function version() {
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbg_Error_92b29b0548f8b746: function(arg0, arg1) {
+            const ret = Error(getStringFromWasm0(arg0, arg1));
+            return ret;
+        },
         __wbg___wbindgen_string_get_b0ca35b86a603356: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'string' ? obj : undefined;
@@ -788,11 +860,24 @@ function getArrayF32FromWasm0(ptr, len) {
     return getFloat32ArrayMemory0().subarray(ptr / 4, ptr / 4 + len);
 }
 
+function getArrayU64FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getBigUint64ArrayMemory0().subarray(ptr / 8, ptr / 8 + len);
+}
+
 function getArrayU8FromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
 }
 
+let cachedBigUint64ArrayMemory0 = null;
+function getBigUint64ArrayMemory0() {
+    if (cachedBigUint64ArrayMemory0 === null || cachedBigUint64ArrayMemory0.byteLength === 0) {
+        cachedBigUint64ArrayMemory0 = new BigUint64Array(wasm.memory.buffer);
+    }
+    return cachedBigUint64ArrayMemory0;
+}
+
 let cachedDataViewMemory0 = null;
 function getDataViewMemory0() {
     if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
@@ -825,6 +910,13 @@ function isLikeNone(x) {
     return x === undefined || x === null;
 }
 
+function passArray8ToWasm0(arg, malloc) {
+    const ptr = malloc(arg.length * 1, 1) >>> 0;
+    getUint8ArrayMemory0().set(arg, ptr / 1);
+    WASM_VECTOR_LEN = arg.length;
+    return ptr;
+}
+
 function passArrayJsValueToWasm0(array, malloc) {
     const ptr = malloc(array.length * 4, 4) >>> 0;
     for (let i = 0; i < array.length; i++) {
@@ -872,6 +964,12 @@ function passStringToWasm0(arg, malloc, realloc) {
     return ptr;
 }
 
+function takeFromExternrefTable0(idx) {
+    const value = wasm.__wbindgen_externrefs.get(idx);
+    wasm.__externref_table_dealloc(idx);
+    return value;
+}
+
 let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
 cachedTextDecoder.decode();
 const MAX_SAFARI_DECODE_BYTES = 2146435072;
@@ -906,6 +1004,7 @@ function __wbg_finalize_init(instance, module) {
     wasmInstance = instance;
     wasm = instance.exports;
     wasmModule = module;
+    cachedBigUint64ArrayMemory0 = null;
     cachedDataViewMemory0 = null;
     cachedFloat32ArrayMemory0 = null;
     cachedUint8ArrayMemory0 = null;

package/pkg/web/openrscad_bg.wasm.d.ts

@@ -3,6 +3,10 @@
 export const memory: WebAssembly.Memory;
 export const __wbg_exportshape3dresult_free: (a: number, b: number) => void;
 export const __wbg_renderresult_free: (a: number, b: number) => void;
+export const cache_export: (a: number) => [number, number];
+export const cache_import: (a: number, b: number) => [number, number, number, number];
+export const cache_keys: () => [number, number];
+export const cache_stats: () => [number, number];
 export const export_2d: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number) => [number, number];
 export const export_3d: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number) => number;
 export const exportshape3dresult_area: (a: number) => number;
@@ -45,12 +49,13 @@ export const renderresult_viewport: (a: number) => [number, number];
 export const renderresult_warnings: (a: number) => [number, number];
 export const version: () => [number, number];
 export const start: () => void;
-export const clear_cache: () => void;
 export const renderresult_area: (a: number) => number;
 export const renderresult_volume: (a: number) => number;
+export const clear_cache: () => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_free: (a: number, b: number, c: number) => void;
 export const __wbindgen_externrefs: WebAssembly.Table;
+export const __externref_table_dealloc: (a: number) => void;
 export const __externref_table_alloc: () => number;
 export const __wbindgen_start: () => void;

package/pkg/web/package.json

@@ -1,7 +1,7 @@
 {
   "name": "openrscad-wasm",
   "type": "module",
-  "version": "0.11.0-beta.2",
+  "version": "0.11.0-beta.4",
   "license": "Apache-2.0 OR MIT",
   "repository": {
     "type": "git",