@taulabs/openrscad-engine 0.11.0-beta.0

package/dist/core.js

@@ -0,0 +1,133 @@
+// Environment-agnostic facade over the raw wasm-bindgen exports.
+//
+// The generated `render*` functions return a wasm-owned `RenderResult` whose
+// getters COPY their data into fresh JS values (each getter clones), then the
+// object must be `.free()`d or it leaks wasm linear memory on every render. This
+// wrapper reads the fields callers actually want and always frees in a
+// `finally`, so consumers never touch `.free()` and never leak. The browser and
+// node entry points supply the concrete bindings and an `ensureReady` hook.
+const consumeExportResult = (result) => {
+    try {
+        return {
+            ok: result.ok,
+            error: result.error,
+            bytes: result.take_bytes(),
+            format: result.format,
+            is2d: result.is_2d,
+            triangleCount: result.triangle_count,
+            vertexCount: result.vertex_count,
+            volume: result.volume,
+            area: result.area,
+            echo: result.echo,
+            warnings: result.warnings,
+            geomErrors: result.geom_errors,
+            diagnostics: JSON.parse(result.diagnostics || "[]"),
+            viewport: result.viewport,
+        };
+    }
+    finally {
+        result.free();
+    }
+};
+function toLiteral(v) {
+    return typeof v === "string" ? v : String(v);
+}
+function toBase64(bytes) {
+    const chunks = [];
+    for (let offset = 0; offset < bytes.length; offset += 0x8000) {
+        chunks.push(String.fromCharCode(...bytes.subarray(offset, offset + 0x8000)));
+    }
+    return btoa(chunks.join(""));
+}
+/** Build the public API from the raw engine bindings and an init hook. */
+export function makeApi(engine, ensureReady) {
+    function split(opts) {
+        const paramEntries = Object.entries(opts.params ?? {});
+        const fileEntries = Object.entries(opts.files ?? {});
+        const binaryEntries = Object.entries(opts.binaryFiles ?? {});
+        return {
+            names: paramEntries.map(([k]) => k),
+            values: paramEntries.map(([, v]) => toLiteral(v)),
+            fileNames: fileEntries.map(([k]) => k),
+            fileContents: fileEntries.map(([, v]) => v),
+            binNames: binaryEntries.map(([k]) => k),
+            binData: binaryEntries.map(([, v]) => toBase64(v)),
+            fontBlobs: (opts.fontFiles ?? []).map(toBase64),
+        };
+    }
+    /** Parse `.scad` source and render it to mesh + diagnostics. */
+    async function render(source, opts = {}) {
+        await ensureReady();
+        const { names, values, fileNames, fileContents, binNames, binData, fontBlobs } = split(opts);
+        const r = engine.render_with_files(source, names, values, fileNames, fileContents, binNames, binData, fontBlobs);
+        try {
+            return {
+                ok: r.ok,
+                error: r.error,
+                positions: r.positions,
+                normals: r.normals,
+                is2d: r.is_2d,
+                triangleCount: r.triangle_count,
+                vertexCount: r.vertex_count,
+                volume: r.volume,
+                area: r.area,
+                echo: r.echo,
+                warnings: r.warnings,
+                geomErrors: r.geom_errors,
+                diagnostics: JSON.parse(r.diagnostics || "[]"),
+                preview: {
+                    positions: r.preview_positions,
+                    normals: r.preview_normals,
+                    groups: r.groups,
+                },
+                provenance: {
+                    positions: r.provenance_positions,
+                    normals: r.provenance_normals,
+                    groups: r.provenance,
+                },
+                viewport: r.viewport,
+            };
+        }
+        finally {
+            r.free();
+        }
+    }
+    /** Render a 2D model to DXF or SVG text (empty if the model isn't 2D). */
+    async function exportShape2D(source, format, opts = {}) {
+        await ensureReady();
+        const { names, values, fileNames, fileContents, binNames, binData, fontBlobs } = split(opts);
+        return engine.export_2d(source, names, values, fileNames, fileContents, binNames, binData, fontBlobs, format);
+    }
+    async function exportShape3D(source, format, opts = {}) {
+        await ensureReady();
+        const { names, values, fileNames, fileContents, binNames, binData, fontBlobs } = split(opts);
+        const glb = format === "glb" ? opts : {};
+        const result = engine.export_3d(source, names, values, fileNames, fileContents, binNames, binData, fontBlobs, format, glb.includeEdges ?? false, glb.sourceUnitToMeters ?? 0.001, glb.coordinateSystem ?? "y-up");
+        return consumeExportResult(result);
+    }
+    /** Render preview-semantics geometry directly to GLB for an interactive viewer. */
+    async function renderToGlb(source, opts = {}) {
+        await ensureReady();
+        const { names, values, fileNames, fileContents, binNames, binData, fontBlobs } = split(opts);
+        const result = engine.render_to_glb(source, names, values, fileNames, fileContents, binNames, binData, fontBlobs, opts.includeEdges ?? false);
+        return consumeExportResult(result);
+    }
+    /** The customizer parameter schema for a source string, as JSON
+     *  (`{"params":[…]}`). */
+    async function parameters(source) {
+        await ensureReady();
+        return engine.parameters(source);
+    }
+    /** The engine version string (matches the npm package version). */
+    async function version() {
+        await ensureReady();
+        return engine.version();
+    }
+    /** Drop the persistent geometry cache (e.g. when loading a new document). */
+    async function clearCache() {
+        await ensureReady();
+        engine.clear_cache();
+    }
+    return { render, renderToGlb, exportShape2D, exportShape3D, parameters, version, clearCache };
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,iFAAiF;AACjF,uEAAuE;AACvE,gFAAgF;AAChF,4EAA4E;AAwI5E,MAAM,mBAAmB,GAAG,CAAC,MAAuB,EAAuB,EAAE;IAC3E,IAAI,CAAC;QACH,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE;YAC1B,MAAM,EAAE,MAAM,CAAC,MAA6B;YAC5C,IAAI,EAAE,MAAM,CAAC,KAAK;YAClB,aAAa,EAAE,MAAM,CAAC,cAAc;YACpC,WAAW,EAAE,MAAM,CAAC,YAAY;YAChC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,WAAW;YAC9B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,IAAI,CAAiB;YACnE,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;AACH,CAAC,CAAC;AAuDF,SAAS,SAAS,CAAC,CAA4B;IAC7C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAiB;IACjC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC;QAC7D,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,OAAO,CAAC,MAAiB,EAAE,WAAgC;IACzE,SAAS,KAAK,CAAC,IAAmB;QAChC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAC7D,OAAO;YACL,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACnC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACjD,SAAS,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACtC,YAAY,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAC3C,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACvC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAClD,SAAS,EAAE,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;SAChD,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,KAAK,UAAU,MAAM,CAAC,MAAc,EAAE,OAAsB,EAAE;QAC5D,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7F,MAAM,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAChC,MAAM,EACN,KAAK,EACL,MAAM,EACN,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,SAAS,CACV,CAAC;QACF,IAAI,CAAC;YACH,OAAO;gBACL,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,IAAI,EAAE,CAAC,CAAC,KAAK;gBACb,aAAa,EAAE,CAAC,CAAC,cAAc;gBAC/B,WAAW,EAAE,CAAC,CAAC,YAAY;gBAC3B,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,UAAU,EAAE,CAAC,CAAC,WAAW;gBACzB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,IAAI,IAAI,CAAiB;gBAC9D,OAAO,EAAE;oBACP,SAAS,EAAE,CAAC,CAAC,iBAAiB;oBAC9B,OAAO,EAAE,CAAC,CAAC,eAAe;oBAC1B,MAAM,EAAE,CAAC,CAAC,MAAM;iBACjB;gBACD,UAAU,EAAE;oBACV,SAAS,EAAE,CAAC,CAAC,oBAAoB;oBACjC,OAAO,EAAE,CAAC,CAAC,kBAAkB;oBAC7B,MAAM,EAAE,CAAC,CAAC,UAAU;iBACrB;gBACD,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACrB,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,CAAC,CAAC,IAAI,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,KAAK,UAAU,aAAa,CAC1B,MAAc,EACd,MAAqB,EACrB,OAAsB,EAAE;QAExB,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7F,OAAO,MAAM,CAAC,SAAS,CACrB,MAAM,EACN,KAAK,EACL,MAAM,EACN,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,SAAS,EACT,MAAM,CACP,CAAC;IACJ,CAAC;IAaD,KAAK,UAAU,aAAa,CAC1B,MAAc,EACd,MAA2B,EAC3B,OAAyC,EAAE;QAE3C,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7F,MAAM,GAAG,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAE,IAAyB,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAC7B,MAAM,EACN,KAAK,EACL,MAAM,EACN,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,SAAS,EACT,MAAM,EACN,GAAG,CAAC,YAAY,IAAI,KAAK,EACzB,GAAG,CAAC,kBAAkB,IAAI,KAAK,EAC/B,GAAG,CAAC,gBAAgB,IAAI,MAAM,CAC/B,CAAC;QACF,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,mFAAmF;IACnF,KAAK,UAAU,WAAW,CACxB,MAAc,EACd,OAA2B,EAAE;QAE7B,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CACjC,MAAM,EACN,KAAK,EACL,MAAM,EACN,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,SAAS,EACT,IAAI,CAAC,YAAY,IAAI,KAAK,CAC3B,CAAC;QACF,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED;8BAC0B;IAC1B,KAAK,UAAU,UAAU,CAAC,MAAc;QACtC,MAAM,WAAW,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,mEAAmE;IACnE,KAAK,UAAU,OAAO;QACpB,MAAM,WAAW,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAED,6EAA6E;IAC7E,KAAK,UAAU,UAAU;QACvB,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAChG,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,14 @@
+/** Resolves immediately — the wasm is already instantiated on import in Node. */
+export declare function ensureReady(): Promise<void>;
+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>;
+export declare const exportShape3D: {
+    (source: string, format: "glb", opts?: import("./core.js").ExportGlbOptions): Promise<import("./core.js").ExportShape3DOutput>;
+    (source: string, format: Exclude<import("./core.js").ExportShape3DFormat, "glb">, opts?: import("./core.js").RenderOptions): Promise<import("./core.js").ExportShape3DOutput>;
+};
+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";
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +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"}

package/dist/node.js

@@ -0,0 +1,30 @@
+// 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";
+import { makeApi } from "./core.js";
+/** Resolves immediately — the wasm is already instantiated on import in Node. */
+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,
+};
+const api = makeApi(engine, ensureReady);
+export const render = api.render;
+export const renderToGlb = api.renderToGlb;
+export const exportShape2D = api.exportShape2D;
+export const exportShape3D = api.exportShape3D;
+export const parameters = api.parameters;
+export const version = api.version;
+export const clearCache = api.clearCache;
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +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"}

package/examples/node-render.mjs

@@ -0,0 +1,19 @@
+// Headless render in Node (ESM). Run with: node node-render.mjs
+//
+// The Node build instantiates the wasm on import, so `render()` works with no
+// init step. Mesh data comes back as a non-indexed triangle soup (9 f32 per
+// triangle in both `positions` and `normals`).
+import { render, version } from "@taulabs/openrscad-engine";
+
+console.log("@taulabs/openrscad-engine", await version());
+
+const r = await render("difference() { cube(20, center=true); sphere(12); }");
+if (!r.ok) {
+  console.error(r.error);
+  process.exit(1);
+}
+
+console.log(
+  `${r.triangleCount} triangles, ${r.vertexCount} verts, ` +
+    `volume ${r.volume.toFixed(2)}, area ${r.area.toFixed(2)}`,
+);

package/examples/worker.js

@@ -0,0 +1,18 @@
+// A module Web Worker that runs the OpenRSCAD engine off the main thread — the
+// recommended way to use it in a browser app (rendering a large model can take
+// tens of milliseconds and shouldn't block the UI).
+//
+// Spawn it from your app with a bundler that supports module workers, e.g. Vite:
+//
+//   const worker = new Worker(new URL("./worker.js", import.meta.url), { type: "module" });
+//   worker.onmessage = (e) => { /* e.data.result is a RenderOutput */ };
+//   worker.postMessage({ seq: 1, source: "cube(10);" });
+//
+import { render } from "@taulabs/openrscad-engine";
+
+self.onmessage = async (e) => {
+  const { seq, source, params, files } = e.data;
+  const result = await render(source, { params, files });
+  // Transfer the (largest) mesh buffers to hand them over without a copy.
+  self.postMessage({ seq, result }, [result.positions.buffer, result.normals.buffer]);
+};

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@taulabs/openrscad-engine",
+  "version": "0.11.0-beta.0",
+  "description": "Tau's fork of the OpenRSCAD geometry engine, compiled to WebAssembly \u2014 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",
+  "author": "Matt Hova",
+  "homepage": "https://github.com/taucad/openrscad",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/taucad/openrscad.git",
+    "directory": "packages/npm"
+  },
+  "bugs": {
+    "url": "https://github.com/taucad/openrscad/issues"
+  },
+  "keywords": [
+    "openscad",
+    "scad",
+    "cad",
+    "wasm",
+    "webassembly",
+    "geometry",
+    "csg",
+    "3d",
+    "mesh",
+    "openrscad",
+    "fork"
+  ],
+  "types": "./dist/browser.d.ts",
+  "exports": {
+    ".": {
+      "browser": {
+        "types": "./dist/browser.d.ts",
+        "default": "./dist/browser.js"
+      },
+      "node": {
+        "types": "./dist/node.d.ts",
+        "import": "./dist/node.js",
+        "require": "./pkg/node/openrscad.js"
+      },
+      "default": {
+        "types": "./dist/browser.d.ts",
+        "default": "./dist/browser.js"
+      }
+    },
+    "./web": {
+      "types": "./pkg/web/openrscad.d.ts",
+      "default": "./pkg/web/openrscad.js"
+    },
+    "./node": {
+      "types": "./pkg/node/openrscad.d.ts",
+      "default": "./pkg/node/openrscad.js"
+    },
+    "./openrscad_bg.wasm": "./pkg/web/openrscad_bg.wasm",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": [
+    "./pkg/*/openrscad.js",
+    "./dist/*.js"
+  ],
+  "files": [
+    "dist",
+    "pkg/web",
+    "pkg/node",
+    "examples",
+    "README.md",
+    "LICENSE-APACHE",
+    "LICENSE-MIT"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "npm run build:wasm && 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",
+    "test": "npm run build:facade && node --test test/*.test.mjs"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.3"
+  },
+  "contributors": [
+    "Richard Fontein (Tau)"
+  ]
+}

package/pkg/node/openrscad.d.ts

@@ -0,0 +1,174 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * One owned native 3D artifact plus the operational metadata needed by hosts.
+ */
+export class ExportShape3DResult {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Transfer artifact ownership to JavaScript. A second call returns empty.
+     */
+    take_bytes(): Uint8Array;
+    readonly area: number;
+    readonly diagnostics: string;
+    readonly echo: string;
+    readonly error: string;
+    readonly format: string;
+    readonly geom_errors: string;
+    readonly is_2d: boolean;
+    readonly ok: boolean;
+    readonly triangle_count: number;
+    readonly vertex_count: number;
+    readonly viewport: string;
+    readonly volume: number;
+    readonly warnings: string;
+}
+
+/**
+ * The result of rendering a `.scad` source string.
+ *
+ * Mesh data is a non-indexed triangle soup with flat (per-face) normals:
+ * `positions` and `normals` both hold 9 floats per triangle.
+ */
+export class RenderResult {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly area: number;
+    /**
+     * Structured diagnostics as a JSON array (`[{severity,message,start,end}]`),
+     * where start/end are byte offsets into the source, or -1 when unknown.
+     */
+    readonly diagnostics: string;
+    /**
+     * Newline-joined `ECHO:` output.
+     */
+    readonly echo: string;
+    /**
+     * Error message, or empty string if the render succeeded.
+     */
+    readonly error: string;
+    /**
+     * Newline-joined recoverable geometry errors (degraded render), or empty
+     * when the geometry is exact. See the field docs on `geom_errors`.
+     */
+    readonly geom_errors: string;
+    /**
+     * Per-group ranges/colors as JSON (`[{start,count,color,mode}]`); empty `[]`
+     * when the model uses no display attributes.
+     */
+    readonly groups: string;
+    /**
+     * Whether the model is a 2D object (exportable to DXF/SVG) vs a 3D solid.
+     */
+    readonly is_2d: boolean;
+    /**
+     * Per-face normals (9 f32 per triangle) as a `Float32Array`.
+     */
+    readonly normals: Float32Array;
+    /**
+     * Whether the render succeeded (no error).
+     */
+    readonly ok: boolean;
+    /**
+     * Triangle-soup vertex positions (9 f32 per triangle) as a `Float32Array`.
+     */
+    readonly positions: Float32Array;
+    readonly preview_normals: Float32Array;
+    /**
+     * Preview triangle soup (concatenated colored groups); empty when the model
+     * uses no color/`#`/`%` (the viewer then uses `positions`).
+     */
+    readonly preview_positions: Float32Array;
+    /**
+     * Per-group provenance ranges/span-stacks as JSON (`[{start,count,spans}]`);
+     * empty when the model has no pickable geometry.
+     */
+    readonly provenance: string;
+    readonly provenance_normals: Float32Array;
+    /**
+     * Provenance triangle soup (concatenated per-statement groups); empty only
+     * for models with no geometry.
+     */
+    readonly provenance_positions: Float32Array;
+    readonly triangle_count: number;
+    readonly vertex_count: number;
+    /**
+     * `$vp*` viewport variables as JSON, or empty when the source has no `$vp`.
+     */
+    readonly viewport: string;
+    readonly volume: number;
+    /**
+     * Newline-joined warnings.
+     */
+    readonly warnings: string;
+}
+
+/**
+ * Drop the persistent geometry cache (e.g. when loading a new document).
+ */
+export function clear_cache(): void;
+
+/**
+ * Render a 2D model and serialize it to DXF or SVG text. Returns an empty
+ * string if the model isn't 2D or fails to evaluate (the caller checks
+ * `RenderResult.is_2d` first). `format` is "dxf" or "svg".
+ */
+export function export_2d(source: string, names: string[], values: string[], file_names: string[], file_contents: string[], bin_names: string[], bin_data: string[], font_blobs: string[], format: string): string;
+
+/**
+ * Evaluate a 3D source and serialize it natively to one owned artifact.
+ */
+export function export_3d(source: string, names: string[], values: string[], file_names: string[], file_contents: string[], bin_names: string[], bin_data: string[], font_blobs: string[], format: string, include_edges: boolean, source_unit_to_meters: number, coordinate_system: string): ExportShape3DResult;
+
+/**
+ * The customizer parameter schema for a source string, as a JSON string
+ * (`{"params":[…]}`). The playground renders a control panel from this.
+ */
+export function parameters(source: string): string;
+
+/**
+ * Run the full pipeline on a source string.
+ */
+export function render(source: string): RenderResult;
+
+/**
+ * Like [`render_with_files`], but renders the fast, **non-watertight** preview
+ * (see `openrscad_geom::render_preview_cached_diag`): unions are concatenated rather
+ * than run through the CSG kernel. Suitable for opaque on-screen display only —
+ * stats and export still use the exact path. Differences/intersections/hulls
+ * still resolve exactly, so holes and clips look correct.
+ */
+export function render_preview_with_files(source: string, names: string[], values: string[], file_names: string[], file_contents: string[], bin_names: string[], bin_data: string[], font_blobs: string[]): RenderResult;
+
+/**
+ * Render a preview-semantics GLB for interactive viewers.
+ */
+export function render_to_glb(source: string, names: string[], values: string[], file_names: string[], file_contents: string[], bin_names: string[], bin_data: string[], font_blobs: string[], include_edges: boolean): ExportShape3DResult;
+
+/**
+ * Like [`render_with_params`], but `include`/`use` resolve against an in-memory
+ * set of files (`file_names[i]` → `file_contents[i]`) — the playground's other
+ * files and/or a bundled library.
+ */
+export function render_with_files(source: string, names: string[], values: string[], file_names: string[], file_contents: string[], bin_names: string[], bin_data: string[], font_blobs: string[]): RenderResult;
+
+/**
+ * Like [`render`], but with customizer overrides supplied as parallel arrays:
+ * `names[i]` is a top-level parameter and `values[i]` its new value as a
+ * literal string (`"30"`, `"true"`, `"\"hi\""`, `"[1,2,3]"`).
+ */
+export function render_with_params(source: string, names: string[], values: string[]): RenderResult;
+
+/**
+ * Initialize panic hook for readable errors in the browser console.
+ */
+export function start(): void;
+
+/**
+ * Engine version string.
+ */
+export function version(): string;