@taulabs/openrscad-engine 0.11.0-beta.0

package/LICENSE-APACHE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 The OpenRSCAD Authors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/LICENSE-MIT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The OpenRSCAD Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,194 @@
+# @taulabs/openrscad-engine
+
+> **A fork.** This is [Tau](https://tau.new)'s build of
+> [OpenRSCAD](https://github.com/matthova/openrscad) by Matt Hova, published
+> under the `@taulabs` scope while our additions are prepared for contribution
+> back upstream. It tracks upstream and keeps its `Apache-2.0 OR MIT` licensing
+> and attribution unchanged. For the original, install `openrscad-engine`.
+>
+> What this fork adds on top of upstream: a structured export path that
+> preserves the authored scene — user-module hierarchy, per-owner materials and
+> source provenance — through GLB and 3MF, plus optional source-derived feature
+> edges. Fork sources live at
+> [taucad/openrscad](https://github.com/taucad/openrscad).
+
+The [OpenRSCAD](https://github.com/matthova/openrscad) geometry engine, compiled
+to WebAssembly. Parse OpenSCAD-compatible `.scad` source and render solid 3D
+meshes — the same Rust core that powers the
+[playground](https://matthova.github.io/openrscad) — in your own browser app
+or Node tool.
+
+- **Oracle-checked.** Representative output is compared with stock OpenSCAD by
+  geometry metrics; the wasm build uses the pure-Rust Manifold geometry kernel.
+- **Fast, incremental.** A persistent geometry cache makes warm edits
+  single-digit-millisecond.
+- **Self-contained.** No native dependencies, no threads, no `SharedArrayBuffer`
+  — so **no COOP/COEP headers are needed**, even from a CDN.
+
+> **Heads up — this is a 0.x release.**
+> - The JS API may change between minor versions. **Pin a version** (`"@taulabs/openrscad-engine": "~0.1.0"`, not `^0.1.0`) if you depend on it.
+> - The `.wasm` binary is a few MB. Load it in a **Web Worker** (see below) so a
+>   render never blocks your UI, and let your CDN serve it gzip/brotli-compressed.
+
+## Install
+
+```sh
+npm install @taulabs/openrscad-engine
+```
+
+## Quickstart (browser / bundler)
+
+The default export is a small, safe wrapper: pass plain objects, get a plain
+result back, and never manage wasm memory yourself.
+
+```js
+import { render } from "@taulabs/openrscad-engine";
+
+// The first call fetches + instantiates the wasm (resolving openrscad_bg.wasm
+// next to the module). Call ensureReady() yourself to preload it earlier.
+const r = await render("difference() { cube(20, center=true); sphere(12); }");
+
+if (r.ok) {
+  console.log(r.triangleCount, "triangles, volume", r.volume);
+  // r.positions / r.normals: non-indexed triangle soup, 9 f32 per triangle.
+} else {
+  console.error(r.error, r.diagnostics);
+}
+```
+
+Works out of the box in Vite, webpack 5, and any ES-module bundler.
+
+### Native 3D files
+
+```js
+import { exportShape3D } from "@taulabs/openrscad-engine";
+
+const result = await exportShape3D(
+  'color("red") { cube(10); translate([0, 0, 20]) cube(10); }',
+  "glb",
+  { includeEdges: true },
+);
+if (!result.ok) throw new Error(result.error);
+// One owned Uint8Array. Authored module calls become nested named glTF nodes;
+// geometry outside a user module uses deterministic hexadecimal color names.
+console.log(result.bytes);
+```
+
+`exportShape3D` supports `stl`, `off`, `obj`, `3mf`, `amf`, and `glb`. GLB and
+3MF share one exact attributed boundary. GLB preserves authored user-module
+hierarchy and uses materials for color; anonymous top-level geometry falls back
+to deterministic color/connectivity parts. 3MF keeps each spatial solid
+manifold, assigns materials per triangle, and derives object names and
+namespaced source metadata without changing that physical partition.
+`includeEdges` is GLB-only, defaults to false, and emits owner-local mesh
+feature lines rather than analytic/BRep curves.
+
+Use `renderToGlb(source, { includeEdges })` for interactive preview semantics
+(`$preview=true`, including factual highlight/background display modes). File
+exports always evaluate with `$preview=false`.
+
+### Customizer params and include/use files
+
+```js
+await render("width = 10; cube([width, 10, 10]);", {
+  params: { width: 40 },                     // numbers/booleans are stringified;
+  files: { "lib.scad": "function f() = 3;" },// strings must be quoted: '"hi"'
+});
+```
+
+## No-install: import straight from a CDN
+
+Because the package publishes the browser (`web`) target, you can import it with
+no build step at all. **Use the raw file path** (not `/+esm` or `esm.run`, which
+mangle wasm glue) and **pin the version**:
+
+```js
+import init, { render_with_files } from
+  "https://cdn.jsdelivr.net/npm/openrscad-engine@0.1.0/pkg/web/openrscad.js";
+
+await init();                       // resolves the sibling openrscad_bg.wasm
+const r = render_with_files("cube(10);", [], [], [], []);
+try {
+  console.log(r.triangle_count);
+} finally {
+  r.free();                         // raw exports are wasm-owned — free them
+}
+```
+
+The CDN path exposes the **raw** wasm-bindgen exports (below); for the friendlier
+wrapper, install the package instead.
+
+## Run it in a Web Worker (recommended)
+
+See [`examples/worker.js`](./examples/worker.js) for a ready-made module worker.
+In short:
+
+```js
+// worker.js
+import { render } from "@taulabs/openrscad-engine";
+self.onmessage = async (e) => {
+  const result = await render(e.data.source);
+  self.postMessage({ result }, [result.positions.buffer, result.normals.buffer]);
+};
+```
+
+```js
+// app.js
+const worker = new Worker(new URL("./worker.js", import.meta.url), { type: "module" });
+worker.onmessage = (e) => draw(e.data.result);
+worker.postMessage({ source: "cube(10);" });
+```
+
+## Node
+
+```js
+import { render, version } from "@taulabs/openrscad-engine";   // ESM
+console.log(await version());
+const r = await render("sphere(8);");
+```
+
+The wasm instantiates on import in Node — no init step. CommonJS `require()`
+consumers get the raw wasm-bindgen exports (call `.free()` on results). A full
+example is in [`examples/node-render.mjs`](./examples/node-render.mjs).
+
+## API
+
+The wrapper (default export) — all methods are async and initialize the engine
+on first use:
+
+| method | returns | notes |
+|---|---|---|
+| `render(source, opts?)` | `Promise<RenderOutput>` | full pipeline → mesh + diagnostics |
+| `renderToGlb(source, opts?)` | `Promise<ExportShape3DOutput>` | preview-semantics GLB for interactive viewers |
+| `exportShape2D(source, "dxf" \| "svg", opts?)` | `Promise<string>` | 2D models only |
+| `exportShape3D(source, format, opts?)` | `Promise<ExportShape3DOutput>` | native STL/OFF/OBJ/3MF/AMF/GLB |
+| `parameters(source)` | `Promise<string>` | customizer schema JSON |
+| `version()` | `Promise<string>` | engine version |
+| `clearCache()` | `Promise<void>` | drop the persistent geometry cache |
+| `ensureReady(wasmUrl?)` | `Promise<void>` | preload / point at a custom `.wasm` |
+
+All render/export options accept customizer `params`, text `files`, binary
+`binaryFiles`, and `fontFiles`. GLB export additionally accepts `includeEdges`,
+`sourceUnitToMeters`, and `coordinateSystem` (`"y-up"` by default). Other 3D
+formats expose only the common request options. `renderToGlb` accepts
+`includeEdges` and owns fixed viewer units/coordinates.
+
+`RenderOutput` includes `ok`, `error`, `positions`/`normals` (Float32Array
+triangle soup, 9 f32 per triangle, flat per-face normals — parallel arrays you
+own), `is2d`, `triangleCount`, `vertexCount`, `volume`, `area`, `echo`,
+`warnings`, `diagnostics` (parsed `[{severity,message,start,end}]`, with byte
+offsets), plus `preview` and `provenance` channels for color and editor↔preview
+linking. Full types ship with the package.
+
+### Subpath entry points (advanced)
+
+- `@taulabs/openrscad-engine/web` — the raw `--target web` wasm-bindgen module (call `init()`, then the exports; `.free()` results).
+- `@taulabs/openrscad-engine/node` — the raw `--target nodejs` module (auto-init).
+- `@taulabs/openrscad-engine/openrscad_bg.wasm` — the wasm binary URL, for `init({ module_or_path })` with a custom loader.
+
+Prefer the default wrapper unless you specifically need the raw surface — it
+copies mesh data into values you own and frees the wasm object for you.
+
+## License
+
+Apache-2.0 OR MIT, at your option.

package/dist/browser.d.ts

@@ -0,0 +1,16 @@
+/** Initialize the wasm module (idempotent — safe to call repeatedly). Pass a
+ *  URL/Request/etc. to load the `.wasm` from a custom location; omit it to
+ *  resolve `openrscad_bg.wasm` beside the glue module. */
+export declare function ensureReady(wasmUrl?: string | URL | Request): 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=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAmBA;;0DAE0D;AAC1D,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;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/browser.js

@@ -0,0 +1,33 @@
+// Browser / bundler entry (the default `.` export for web and CDN consumers).
+//
+// The wasm module is fetched and instantiated on first use via `init()`. Call
+// `ensureReady(wasmUrl?)` up front to control when — and from where — the
+// `.wasm` loads (preload it, or point at a custom/CDN URL); otherwise the first
+// `render()` initializes it, resolving `openrscad_bg.wasm` next to the glue module.
+import init, { 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/web/openrscad.js";
+import { makeApi } from "./core.js";
+let ready = null;
+/** Initialize the wasm module (idempotent — safe to call repeatedly). Pass a
+ *  URL/Request/etc. to load the `.wasm` from a custom location; omit it to
+ *  resolve `openrscad_bg.wasm` beside the glue module. */
+export function ensureReady(wasmUrl) {
+    return (ready ??= init(wasmUrl ? { module_or_path: wasmUrl } : undefined).then(() => undefined));
+}
+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=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,8EAA8E;AAC9E,0EAA0E;AAC1E,gFAAgF;AAChF,oFAAoF;AACpF,OAAO,IAAI,EAAE,EACX,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,yBAAyB,CAAC;AACjC,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAEpD,IAAI,KAAK,GAAyB,IAAI,CAAC;AAEvC;;0DAE0D;AAC1D,MAAM,UAAU,WAAW,CAAC,OAAgC;IAC1D,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AACnG,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/dist/core.d.ts

@@ -0,0 +1,158 @@
+/** A structured diagnostic. `start`/`end` are UTF-8 byte offsets into the
+ *  source (or -1 when unknown) — note JS strings are UTF-16, so map offsets if
+ *  you place them in an editor. */
+export interface Diagnostic {
+    severity: "error" | "warning";
+    message: string;
+    start: number;
+    end: number;
+}
+/** A parsed render. Mesh data is a non-indexed triangle soup: `positions` and
+ *  `normals` both hold 9 f32 per triangle (flat, per-face normals), and are
+ *  independent copies you own (safe to transfer to another worker/thread). */
+export interface RenderOutput {
+    ok: boolean;
+    /** Error message, or "" when `ok`. */
+    error: string;
+    positions: Float32Array;
+    normals: Float32Array;
+    /** True for 2D models (exportable to DXF/SVG via `exportShape2D`). */
+    is2d: boolean;
+    triangleCount: number;
+    vertexCount: number;
+    volume: number;
+    area: number;
+    /** Newline-joined `ECHO:` output. */
+    echo: string;
+    /** Newline-joined warnings. */
+    warnings: string;
+    /** Recoverable geometry errors. A mesh may still be present when non-empty. */
+    geomErrors: string;
+    diagnostics: Diagnostic[];
+    /** Per-color preview channel (a concatenated triangle soup + a JSON array of
+     *  `{start,count,color,mode}`). Empty unless the model uses `color`/`#`/`%`
+     *  (the viewer then uses `positions`). */
+    preview: {
+        positions: Float32Array;
+        normals: Float32Array;
+        groups: string;
+    };
+    /** Editor↔preview provenance channel (a per-leaf triangle soup + a JSON array
+     *  of `{start,count,spans}` byte-offset stacks). Empty for models with no
+     *  geometry. */
+    provenance: {
+        positions: Float32Array;
+        normals: Float32Array;
+        groups: string;
+    };
+    /** `$vp*` viewport variables as JSON, or "" when the source has no `$vp`. */
+    viewport: string;
+}
+export interface RenderOptions {
+    /** Customizer overrides. Values are OpenSCAD literals as strings — numbers and
+     *  booleans are stringified for you, but strings must be quoted (`'"hi"'`) and
+     *  vectors bracketed (`"[1,2,3]"`), matching the language. */
+    params?: Record<string, string | number | boolean>;
+    /** In-memory files for `include`/`use` resolution, keyed by path:
+     *  `{ "lib.scad": "function f() = 1;" }`. */
+    files?: Record<string, string>;
+    /** Binary files for `import()`, keyed by path. */
+    binaryFiles?: Record<string, Uint8Array>;
+    /** Font files made available to `text()` for this request. */
+    fontFiles?: readonly Uint8Array[];
+}
+export type ExportShape3DFormat = "stl" | "off" | "obj" | "3mf" | "amf" | "glb";
+export interface ExportGlbOptions extends RenderOptions {
+    /** Add native owner-local mesh feature lines to GLB output. */
+    includeEdges?: boolean;
+    /** Scale from source coordinates to metres in GLB. Defaults to millimetres. */
+    sourceUnitToMeters?: number;
+    /** GLB coordinate convention. Standard glTF Y-up is the default. */
+    coordinateSystem?: "y-up" | "z-up";
+}
+export interface RenderToGlbOptions extends RenderOptions {
+    /** Add native owner-local feature lines. */
+    includeEdges?: boolean;
+}
+export interface ExportShape3DOutput {
+    ok: boolean;
+    error: string;
+    bytes: Uint8Array<ArrayBuffer>;
+    format: ExportShape3DFormat;
+    is2d: boolean;
+    triangleCount: number;
+    vertexCount: number;
+    volume: number;
+    area: number;
+    echo: string;
+    warnings: string;
+    geomErrors: string;
+    diagnostics: Diagnostic[];
+    viewport: string;
+}
+/** The subset of the wasm `RenderResult` this facade reads. */
+interface RawResult {
+    ok: boolean;
+    error: string;
+    positions: Float32Array;
+    normals: Float32Array;
+    is_2d: boolean;
+    triangle_count: number;
+    vertex_count: number;
+    volume: number;
+    area: number;
+    echo: string;
+    warnings: string;
+    geom_errors: string;
+    diagnostics: string;
+    preview_positions: Float32Array;
+    preview_normals: Float32Array;
+    groups: string;
+    provenance_positions: Float32Array;
+    provenance_normals: Float32Array;
+    provenance: string;
+    viewport: string;
+    free(): void;
+}
+interface RawExportResult {
+    ok: boolean;
+    error: string;
+    format: string;
+    is_2d: boolean;
+    triangle_count: number;
+    vertex_count: number;
+    volume: number;
+    area: number;
+    echo: string;
+    warnings: string;
+    geom_errors: string;
+    diagnostics: string;
+    viewport: string;
+    take_bytes(): Uint8Array<ArrayBuffer>;
+    free(): void;
+}
+/** The generated wasm-bindgen exports this facade wraps. */
+export interface RawEngine {
+    render_with_files(source: string, names: string[], values: string[], fileNames: string[], fileContents: string[], binNames: string[], binData: string[], fontBlobs: string[]): RawResult;
+    export_2d(source: string, names: string[], values: string[], fileNames: string[], fileContents: string[], binNames: string[], binData: string[], fontBlobs: string[], format: string): string;
+    export_3d(source: string, names: string[], values: string[], fileNames: string[], fileContents: string[], binNames: string[], binData: string[], fontBlobs: string[], format: string, includeEdges: boolean, sourceUnitToMeters: number, coordinateSystem: string): RawExportResult;
+    render_to_glb(source: string, names: string[], values: string[], fileNames: string[], fileContents: string[], binNames: string[], binData: string[], fontBlobs: string[], includeEdges: boolean): RawExportResult;
+    parameters(source: string): string;
+    version(): string;
+    clear_cache(): void;
+}
+/** Build the public API from the raw engine bindings and an init hook. */
+export declare function makeApi(engine: RawEngine, ensureReady: () => Promise<void>): {
+    render: (source: string, opts?: RenderOptions) => Promise<RenderOutput>;
+    renderToGlb: (source: string, opts?: RenderToGlbOptions) => Promise<ExportShape3DOutput>;
+    exportShape2D: (source: string, format: "dxf" | "svg", opts?: RenderOptions) => Promise<string>;
+    exportShape3D: {
+        (source: string, format: "glb", opts?: ExportGlbOptions): Promise<ExportShape3DOutput>;
+        (source: string, format: Exclude<ExportShape3DFormat, "glb">, opts?: RenderOptions): Promise<ExportShape3DOutput>;
+    };
+    parameters: (source: string) => Promise<string>;
+    version: () => Promise<string>;
+    clearCache: () => Promise<void>;
+};
+export {};
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}