forgecad 0.10.1 → 0.10.2

package/dist-cli/{forgecad_geometry-QOQIIP53.js → forgecad_geometry-7TVSNVUB.js}

@@ -154,6 +154,25 @@ function geometry_create_revolved_regions(regions_json, degrees, segments) {
   }
   return ret[0] >>> 0;
 }
+function geometry_create_sdf_mesh(abi_version, opcodes, arg_a, arg_b, arg_c, constants, output, slot_count, options_json) {
+  const ptr0 = passArray8ToWasm0(opcodes, wasm.__wbindgen_malloc);
+  const len0 = WASM_VECTOR_LEN;
+  const ptr1 = passArray32ToWasm0(arg_a, wasm.__wbindgen_malloc);
+  const len1 = WASM_VECTOR_LEN;
+  const ptr2 = passArray32ToWasm0(arg_b, wasm.__wbindgen_malloc);
+  const len2 = WASM_VECTOR_LEN;
+  const ptr3 = passArray32ToWasm0(arg_c, wasm.__wbindgen_malloc);
+  const len3 = WASM_VECTOR_LEN;
+  const ptr4 = passArrayF64ToWasm0(constants, wasm.__wbindgen_malloc);
+  const len4 = WASM_VECTOR_LEN;
+  const ptr5 = passStringToWasm0(options_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+  const len5 = WASM_VECTOR_LEN;
+  const ret = wasm.geometry_create_sdf_mesh(abi_version, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4, output, slot_count, ptr5, len5);
+  if (ret[2]) {
+    throw takeFromExternrefTable0(ret[1]);
+  }
+  return ret[0] >>> 0;
+}
 function geometry_create_side_profile_cut(spec_json) {
   const ptr0 = passStringToWasm0(spec_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
   const len0 = WASM_VECTOR_LEN;
@@ -249,6 +268,9 @@ function geometry_delete_nurbs_curve(handle) {
 function geometry_delete_nurbs_surface(handle) {
   wasm.geometry_delete_nurbs_surface(handle);
 }
+function geometry_delete_sdf_mesh(handle) {
+  wasm.geometry_delete_sdf_mesh(handle);
+}
 function geometry_export_step(handle) {
   let deferred2_0;
   let deferred2_1;
@@ -509,6 +531,47 @@ function geometry_sample_nurbs_surface(handle, u_samples, v_samples) {
     wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
   }
 }
+function geometry_sdf_mesh_metadata(handle) {
+  let deferred2_0;
+  let deferred2_1;
+  try {
+    const ret = wasm.geometry_sdf_mesh_metadata(handle);
+    var ptr1 = ret[0];
+    var len1 = ret[1];
+    if (ret[3]) {
+      ptr1 = 0;
+      len1 = 0;
+      throw takeFromExternrefTable0(ret[2]);
+    }
+    deferred2_0 = ptr1;
+    deferred2_1 = len1;
+    return getStringFromWasm0(ptr1, len1);
+  } finally {
+    wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+  }
+}
+function geometry_sdf_mesh_tri_verts(handle) {
+  const ret = wasm.geometry_sdf_mesh_tri_verts(handle);
+  if (ret[3]) {
+    throw takeFromExternrefTable0(ret[2]);
+  }
+  var v1 = getArrayU32FromWasm0(ret[0], ret[1]).slice();
+  wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+  return v1;
+}
+function geometry_sdf_mesh_vert_properties(handle) {
+  const ret = wasm.geometry_sdf_mesh_vert_properties(handle);
+  if (ret[3]) {
+    throw takeFromExternrefTable0(ret[2]);
+  }
+  var v1 = getArrayF32FromWasm0(ret[0], ret[1]).slice();
+  wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+  return v1;
+}
+function geometry_sdf_mesher_abi_version() {
+  const ret = wasm.geometry_sdf_mesher_abi_version();
+  return ret >>> 0;
+}
 function geometry_select_edges(handle, query_json) {
   let deferred3_0;
   let deferred3_1;
@@ -621,9 +684,38 @@ function __wbg_get_imports() {
     "./forgecad_geometry_bg.js": import0
   };
 }
+function getArrayF32FromWasm0(ptr, len) {
+  ptr = ptr >>> 0;
+  return getFloat32ArrayMemory0().subarray(ptr / 4, ptr / 4 + len);
+}
+function getArrayU32FromWasm0(ptr, len) {
+  ptr = ptr >>> 0;
+  return getUint32ArrayMemory0().subarray(ptr / 4, ptr / 4 + len);
+}
+var cachedFloat32ArrayMemory0 = null;
+function getFloat32ArrayMemory0() {
+  if (cachedFloat32ArrayMemory0 === null || cachedFloat32ArrayMemory0.byteLength === 0) {
+    cachedFloat32ArrayMemory0 = new Float32Array(wasm.memory.buffer);
+  }
+  return cachedFloat32ArrayMemory0;
+}
+var cachedFloat64ArrayMemory0 = null;
+function getFloat64ArrayMemory0() {
+  if (cachedFloat64ArrayMemory0 === null || cachedFloat64ArrayMemory0.byteLength === 0) {
+    cachedFloat64ArrayMemory0 = new Float64Array(wasm.memory.buffer);
+  }
+  return cachedFloat64ArrayMemory0;
+}
 function getStringFromWasm0(ptr, len) {
   return decodeText(ptr >>> 0, len);
 }
+var cachedUint32ArrayMemory0 = null;
+function getUint32ArrayMemory0() {
+  if (cachedUint32ArrayMemory0 === null || cachedUint32ArrayMemory0.byteLength === 0) {
+    cachedUint32ArrayMemory0 = new Uint32Array(wasm.memory.buffer);
+  }
+  return cachedUint32ArrayMemory0;
+}
 var cachedUint8ArrayMemory0 = null;
 function getUint8ArrayMemory0() {
   if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
@@ -631,6 +723,24 @@ function getUint8ArrayMemory0() {
   }
   return cachedUint8ArrayMemory0;
 }
+function passArray32ToWasm0(arg, malloc) {
+  const ptr = malloc(arg.length * 4, 4) >>> 0;
+  getUint32ArrayMemory0().set(arg, ptr / 4);
+  WASM_VECTOR_LEN = arg.length;
+  return ptr;
+}
+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 passArrayF64ToWasm0(arg, malloc) {
+  const ptr = malloc(arg.length * 8, 8) >>> 0;
+  getFloat64ArrayMemory0().set(arg, ptr / 8);
+  WASM_VECTOR_LEN = arg.length;
+  return ptr;
+}
 function passStringToWasm0(arg, malloc, realloc) {
   if (realloc === void 0) {
     const buf = cachedTextEncoder.encode(arg);
@@ -698,6 +808,9 @@ function __wbg_finalize_init(instance, module) {
   wasmInstance = instance;
   wasm = instance.exports;
   wasmModule = module;
+  cachedFloat32ArrayMemory0 = null;
+  cachedFloat64ArrayMemory0 = null;
+  cachedUint32ArrayMemory0 = null;
   cachedUint8ArrayMemory0 = null;
   wasm.__wbindgen_start();
   return wasm;
@@ -791,6 +904,7 @@ export {
   geometry_create_nurbs_surface_handle,
   geometry_create_path_swept_regions,
   geometry_create_revolved_regions,
+  geometry_create_sdf_mesh,
   geometry_create_side_profile_cut,
   geometry_create_sphere,
   geometry_create_surface_grid,
@@ -804,6 +918,7 @@ export {
   geometry_delete,
   geometry_delete_nurbs_curve,
   geometry_delete_nurbs_surface,
+  geometry_delete_sdf_mesh,
   geometry_export_step,
   geometry_export_step_multi,
   geometry_fillet_edges,
@@ -818,6 +933,10 @@ export {
   geometry_nurbs_surface_tessellation,
   geometry_sample_nurbs_curve,
   geometry_sample_nurbs_surface,
+  geometry_sdf_mesh_metadata,
+  geometry_sdf_mesh_tri_verts,
+  geometry_sdf_mesh_vert_properties,
+  geometry_sdf_mesher_abi_version,
   geometry_select_edges,
   geometry_topology,
   geometry_transform,

package/dist-skill/CONTEXT.md

@@ -39,16 +39,16 @@ Author or modify ForgeCAD models, sketches, assemblies, and CLI workflows. Prefe
 ### Validation and export commands (ask the user to run these)
 
 ```bash
-forgecad run <file.forge.js>                        # geometry diagnostics, verify.* results — run after every edit
-forgecad run <file.forge.js> --debug-imports        # trace import-chain failures
-forgecad check print <file.forge.js> --json         # collisions, mesh health, walls, overhangs, bed contact
-forgecad render 3d <file.forge.js>                  # shaded PNG render
-forgecad render wireframe <file.forge.js>           # edges only — internal geometry, edge flow
-forgecad render section <file.forge.js> --plane XZ  # 2D cross-section (SVG/PNG)
-forgecad capture gif <file.forge.js>                # animated orbit or joint-playback GIF
-forgecad export stl <file.forge.js>                 # mesh for 3D printing
-forgecad export 3mf <file.forge.js>                 # mesh + metadata for 3D printing
-forgecad export step <file.forge.js>                # exact B-rep for CAD interchange
+forgecad run <file.forge.js> [file ...]                        # geometry diagnostics, verify.* results — run after every edit
+forgecad run <file.forge.js> --debug-imports                   # trace import-chain failures
+forgecad check print <file.forge.js> [file ...] --json         # collisions, mesh health, walls, overhangs, bed contact
+forgecad render 3d <file.forge.js> [file ...]                  # shaded PNG render
+forgecad render wireframe <file.forge.js> [file ...]           # edges only — internal geometry, edge flow
+forgecad render section <file.forge.js> [file ...] --plane XZ  # 2D cross-section (SVG/PNG)
+forgecad capture gif <file.forge.js> [file ...]                # animated orbit or joint-playback GIF
+forgecad export stl <file.forge.js> [file ...]                 # mesh for 3D printing
+forgecad export 3mf <file.forge.js> [file ...]                 # mesh + metadata for 3D printing
+forgecad export step <file.forge.js> [file ...]                # exact B-rep for CAD interchange
 ```
 
 Add `--param Name=Value` to test a specific parameter value. Pick the export that matches the goal: STL/3MF for printing, STEP for exact CAD interchange.
@@ -114,7 +114,7 @@ Resolve labels with `.face(name)` or `.face(query)` — see the Shape class docs
 
 **No explanatory text inside CAD geometry.** Model the physical artifact; explain the design through names, comments, BOM entries, and docs. Use `text2d()` only when letters are part of the real object (engraving, branding, gauge ticks); use `Viewport.label()` only for temporary review/debug annotation — never to compensate for unclear geometry.
 
-**SDF shapes preview natively** when returned directly; call `.toShape()` only when mesh-backed CAD/export behavior is needed. See [SDF docs](../../generated/sdf.md).
+**SDF shapes preview natively** when returned directly — including plain object/array trees of SDF leaves; call `.toShape()` only when mesh-backed CAD/export behavior is needed. See [SDF docs](../../generated/sdf.md).
 
 ---
 
@@ -307,7 +307,7 @@ chamfer(base, 3, base.edge('vert-br'))
 
 Adds a taper angle to the vertical faces of a solid so that it can be extracted from a mold. The neutral plane is the Z position where the draft angle is zero — faces above and below are tapered symmetrically. Typical values for injection molding are 1–5°.
 
-Truck supports vertical-prism solids with Z-axis pull directions. OCCT uses its native draft operation when available. Manifold throws.
+SDF, Manifold, and Truck lower supported vertical-prism solids with Z-axis pull directions to a tapered loft. OCCT uses its native draft operation when available.
 
 ```ts
 // Add 3° draft to a box for injection molding
@@ -4437,7 +4437,7 @@ console.log("Collisions", solved.collisionReport());
 
 #### `minClearance(partA: string, partB: string, searchLength?: number): number` — Compute the minimum gap (clearance) between two parts in this solved pose.
 
-Returns `0` if the parts are touching or overlapping. Requires the Manifold backend. `searchLength` bounds the search radius in mm — increase it for widely separated parts.
+Returns `0` if the parts are touching or overlapping. Manifold-backed parts use the exact Manifold gap query. SDF-backed parts use a mesh-derived sampled gap. `searchLength` bounds the Manifold search radius in mm — increase it for widely separated Manifold parts.
 
 ---
 

package/dist-skill/docs/API/core/concepts.md

@@ -48,4 +48,4 @@ Resolve labels with `.face(name)` or `.face(query)` — see the Shape class docs
 
 **No explanatory text inside CAD geometry.** Model the physical artifact; explain the design through names, comments, BOM entries, and docs. Use `text2d()` only when letters are part of the real object (engraving, branding, gauge ticks); use `Viewport.label()` only for temporary review/debug annotation — never to compensate for unclear geometry.
 
-**SDF shapes preview natively** when returned directly; call `.toShape()` only when mesh-backed CAD/export behavior is needed. See [SDF docs](../../generated/sdf.md).
+**SDF shapes preview natively** when returned directly — including plain object/array trees of SDF leaves; call `.toShape()` only when mesh-backed CAD/export behavior is needed. See [SDF docs](../../generated/sdf.md).

package/dist-skill/docs/CLI.md

@@ -78,7 +78,7 @@ Direct `.stl`/`.obj`/`.3mf`/`.step`/`.stp` inputs are imported automatically; ST
 
 ```bash
 forgecad run model.forge.js
-forgecad run model.forge.js --details --history
+forgecad run model.forge.js other-model.forge.js --quality live
 ```
 
 ### `forgecad ls`
@@ -104,7 +104,7 @@ Without a target, `show` renders the whole scene and behaves like a shorter, int
 
 ```bash
 forgecad show model.forge.js
-forgecad show model.forge.js Bench
+forgecad show model.forge.js --target Bench
 ```
 
 ### Object Filtering: `--focus` and `--hide`
@@ -112,7 +112,7 @@ forgecad show model.forge.js Bench
 `render 3d`, `render wireframe`, `inspect <family> <mode>`, `capture`, and `check print` can filter the visible object set without changing model code. Use `forgecad ls model.forge.js` to list exact object paths, then pass names or globs:
 
 ```bash
-forgecad render 3d model.forge.js bench.png --focus "Bench.*"
+forgecad render 3d model.forge.js --output bench.png --focus "Bench.*"
 forgecad inspect visual objects model.forge.js --hide "Bench.Slat0,Bench.Slat1" --camera iso
 ```
 
@@ -200,7 +200,7 @@ Runs the script headlessly and prints every named render view with an exact came
 
 ```bash
 forgecad render views model.forge.js
-forgecad render views model.forge.js --json
+forgecad render views model.forge.js reference.step
 ```
 
 ### `forgecad render wireframe`
@@ -224,7 +224,7 @@ Exports the scene to Blender and renders with Cycles (path tracer); requires Ble
 
 ```bash
 forgecad render hq model.forge.js
-forgecad render hq model.forge.js hero.png --preset dramatic --samples 1024
+forgecad render hq model.forge.js --output hero.png --preset dramatic --samples 1024
 ```
 
 ### `forgecad capture gif|mp4` **\[Pro\]**
@@ -235,18 +235,22 @@ Renders an animated sequence: `--capture orbit` (default) for a turntable, `--ca
 
 ```bash
 forgecad capture gif model.forge.js
-forgecad capture gif model.forge.js out/sweep.gif --capture section-sweep --sweep-plane YZ
+forgecad capture gif model.forge.js other-model.forge.js
 ```
 
 ### `forgecad render section`
 
 Render a 2D cross-section of a 3D model (cut by a plane) to SVG or PNG.
 
-Cuts all shapes with an axis-aligned plane (default XY at Z=0; `--plane XZ|YZ` reorients, `--offset` shifts the cut) and writes a 2D cross-section drawing. The file extension picks the format: `.svg` (default, vector) or `.png` (rasterized at `--size` pixels); `--edges=<off|thin|bold>` sets the outline stroke. Useful for verifying internal geometry, wall thicknesses, and fits that aren't visible in 3D renders.
+Cuts all shapes in the scene with an axis-aligned plane and produces a 2D cross-section drawing. The default plane is XY at Z=0. Use `--plane XZ` or `--plane YZ` for other orientations, and `--offset` to shift the cut position.
+
+Output defaults to `.svg`; pass `--format png` or a single-input `--output *.png` path for a rasterized PNG at `--size` pixels. Use `--edges=<off|thin|bold>` to control the outline stroke on cut shapes.
+
+Useful for verifying internal geometry, wall thicknesses, and fit checks that aren't visible in 3D renders.
 
 ```bash
 forgecad render section model.forge.js
-forgecad render section model.forge.js out/section.svg --plane XZ --offset 10
+forgecad render section model.forge.js --output out/section.svg --plane XZ --offset 10
 ```
 
 | Command | Description |
@@ -272,8 +276,8 @@ These flags work across run / render / capture / inspect commands:
 | `--camera <front\|back\|side\|right\|top\|iso\|az:el\|az:el:dist\|spec>` | Camera preset, spherical (az:el), or full spec such as `proj=perspective;pos=x,y,z;target=x,y,z;up=x,y,z;fov=45`. Repeatable. |
 | `--view <name>` | Named camera view declared by the model with scene({ views }) |
 | `--size <px>` | Image size in pixels |
+| `--backend <manifold\|occt\|truck\|sdf>` | Geometry backend (default: manifold; STEP inputs default to OCCT) |
 | `--quality <default\|live\|high>` | Mesh quality preset |
-| `--backend <manifold\|occt\|truck>` | Geometry backend (default: manifold; STEP inputs default to OCCT) |
 | `--json` | Print machine-readable JSON |
 
 Every command has more — Blender-only `render hq` flags (`--preset`, `--samples`, `--engine`, `--hdri`, `--transparent`, `--video`) and capture-only flags (`--capture`, `--animation`, `--cut-plane`, `--sweep-*`, `--fps`) among them. Run `forgecad <command> --help` for the full list.
@@ -295,6 +299,7 @@ Export to every format you need.
 | `export sdf` **\[Production\]** | SDF package | Gazebo robot simulation |
 | `export mjcf` **\[Production\]** | MJCF package | MuJoCo / MJX robot simulation |
 | `export urdf` **\[Production\]** | URDF package | ROS / PyBullet / MuJoCo |
+| `export usd` **\[Production\]** | USD package | Isaac Sim / OpenUSD simulation |
 | `export report` **\[Production\]** | PDF report | Multi-view report with BOM and dimensions |
 | `export cutting-layout` **\[Production\]** | PDF/DXF | Sheet cutting layout with cut sequence |
 | `link` | URL | Share link from a GitHub Gist URL or ID (copied to clipboard) |
@@ -303,6 +308,7 @@ Export to every format you need.
 # Sheet material
 forgecad cut-list shelf.forge.js
 forgecad export cutting-layout shelf.forge.js --sheet-width 420 --sheet-height 594 --kerf 3
+forgecad export cutting-layout shelf.forge.js --output out/layout.dxf
 
 # 3D printing
 forgecad check print bracket.forge.js
@@ -313,11 +319,12 @@ forgecad export 3mf bracket.forge.js --quality high
 forgecad export step bracket.forge.js
 
 # Technical drawings
-forgecad export report bracket.forge.js out/report.pdf
+forgecad export report bracket.forge.js --output out/report.pdf
 
 # Robot simulation
 forgecad export sdf rover.forge.js --output out/forge_scout
 forgecad export mjcf rover.forge.js --output out/forge_scout_mjcf
+forgecad export usd rover.forge.js --output out/forge_scout_usd
 ```
 
 <details>
@@ -326,12 +333,17 @@ forgecad export mjcf rover.forge.js --output out/forge_scout_mjcf
 | Option | Description |
 |--------|-------------|
 | `--joint <JointName=Value>` | Override a Motion tab joint value (JointName=Value). Repeatable. |
-| `--output <path>` | Output STEP path |
+| `--output <path>` | Output SVG path for a single input |
 | `--backend <occt\|truck>` | Exact BREP exporter: occt (default) or truck (native analytic kernel) |
 | `--quality <default\|live\|high>` | Forge quality preset |
 | `-o <path>` | Shorthand for --output |
+| `--param <Key=Value>` | Override a parameter value (Key=Value). Repeatable. |
+| `-p <Key=Value>` | Shorthand for --param |
+| `--format <json\|webgpu-brick>` | Implicit artifact format |
+| `-q <live\|default\|high>` | Shorthand for --quality |
+| `--workgroup-size <x>x<y>x<z>` | WebGPU compute workgroup size |
 | `--dim-angle-tol <deg>` | Dimension routing tolerance in degrees |
-| `--format <pdf\|dxf>` | Output format |
+| `--out <path>` | Alias for --output |
 | `--sheet-width <mm>` | Stock sheet width in mm |
 | `--sheet-height <mm>` | Stock sheet height in mm |
 | `--kerf <mm>` | Cutting clearance (saw blade width) in mm |
@@ -478,7 +490,7 @@ Checks include script `verify.*` results, exact positive-volume object collision
 
 ```bash
 forgecad check print model.forge.js
-forgecad check print model.forge.js --json
+forgecad check print model.forge.js other-model.forge.js
 ```
 
 ### `forgecad check simready`
@@ -489,7 +501,7 @@ Runs a Forge script and checks the returned `assembly(...).withSimulation(...)`
 
 ```bash
 forgecad check simready model.forge.js
-forgecad check simready robot.forge.js --json
+forgecad check simready model.forge.js other-model.forge.js
 ```
 
 ### `forgecad inspect mechanical-integrity`
@@ -529,7 +541,7 @@ The CLI is free for personal non-commercial use. Pro covers human-operated comme
 
 | Free | Production outputs | Pro | Enterprise |
 |------|--------------------|-----|------------|
-| `run`, `dev`, `studio`, `render 3d`, `export stl`, `export 3mf`, `export svg`, `compare 3d`, `check print`, `inspect fit interference`, `inspect mechanical-integrity` for personal non-commercial use | `cut-list`, `export sketch-pdf`, `export step`, `export brep`, `export gcode`, `export sdf`, `export mjcf`, `export urdf`, `export report`, `export cutting-layout` are free to run for personal non-commercial use; Pro covers human-operated commercial CAD work | `render hq`, `capture gif`, `capture mp4` plus commercial coverage for client/customer work | Backend, hosted, embedded, or application workflows that call ForgeCAD automatically |
+| `run`, `dev`, `studio`, `render 3d`, `export stl`, `export 3mf`, `export svg`, `compare 3d`, `check print`, `inspect fit interference`, `inspect mechanical-integrity` for personal non-commercial use | `cut-list`, `export sketch-pdf`, `export step`, `export brep`, `export gcode`, `export implicit`, `export sdf`, `export mjcf`, `export urdf`, `export usd`, `export report`, `export cutting-layout` are free to run for personal non-commercial use; Pro covers human-operated commercial CAD work | `render hq`, `capture gif`, `capture mp4` plus commercial coverage for client/customer work | Backend, hosted, embedded, or application workflows that call ForgeCAD automatically |
 
 ```bash
 forgecad license                    # Check local license status

package/dist-skill/docs/generated/assembly.md

@@ -567,4 +567,4 @@ console.log("Collisions", solved.collisionReport());
 
 #### `minClearance(partA: string, partB: string, searchLength?: number): number` — Compute the minimum gap (clearance) between two parts in this solved pose.
 
-Returns `0` if the parts are touching or overlapping. Requires the Manifold backend. `searchLength` bounds the search radius in mm — increase it for widely separated parts.
+Returns `0` if the parts are touching or overlapping. Manifold-backed parts use the exact Manifold gap query. SDF-backed parts use a mesh-derived sampled gap. `searchLength` bounds the Manifold search radius in mm — increase it for widely separated Manifold parts.

package/dist-skill/docs/generated/core.md

@@ -155,7 +155,7 @@ chamfer(base, 3, base.edge('vert-br'))
 
 Adds a taper angle to the vertical faces of a solid so that it can be extracted from a mold. The neutral plane is the Z position where the draft angle is zero — faces above and below are tapered symmetrically. Typical values for injection molding are 1–5°.
 
-Truck supports vertical-prism solids with Z-axis pull directions. OCCT uses its native draft operation when available. Manifold throws.
+SDF, Manifold, and Truck lower supported vertical-prism solids with Z-axis pull directions to a tapered loft. OCCT uses its native draft operation when available.
 
 ```ts
 // Add 3° draft to a box for injection molding

package/dist-skill/docs/generated/lib.md

@@ -63,7 +63,7 @@ Pre-built fasteners, gears, pipes, structural profiles, and utility shapes. Acce
 
 Pre-built parametric parts available in user scripts as `lib.*`.
 
-exposed to `.forge.js` scripts — see the member list below for the catalog. Sizes outside the supported ranges throw at runtime with a descriptive error.
+Every key in this object becomes a method or namespace on the `lib` object exposed to `.forge.js` scripts — see the member list below for the catalog. Sizes outside the supported ranges throw at runtime with a descriptive error.
 
 - `fastenerHole(opts: FastenerHoleOptions): Shape` — ISO metric fastener hole cutter with optional counterbore or countersink.
 

package/dist-skill/docs/generated/sdf.md

@@ -53,7 +53,7 @@ An immutable SDF expression. Supports SDF-specific operations (smooth booleans,
 
 #### `clone(): SdfShape` — Clone this SDF expression and its visual metadata.
 
-#### `toShape(options?: SdfToShapeOptions): Shape` — Mesh this SDF into a ForgeCAD Shape through ForgeCAD's Surface Nets pipeline. Once converted, the result is a regular Shape — booleans, transforms, export all work.
+#### `toShape(options?: SdfToShapeOptions): Shape` — Mesh this SDF into a ForgeCAD Shape. Typed SDF trees materialize through Rust Manifold Dual Contouring; dynamic trees (custom/noise/voronoi/displace/blend callbacks) mesh through the Surface Nets pipeline. Once converted, the result is a regular Shape — booleans, transforms, export all work.
 
 #### `color(value: string | undefined): SdfShape` — Set the display color for this implicit leaf.
 
@@ -230,7 +230,7 @@ return {
 - `basketWeave(options?: BasketWeaveOptions): SurfacePattern` — Basket weave surface pattern — threads with over-under crossings in UV space. Returns a SurfacePattern for use with `.surfaceDisplace()`.
 - `pattern2d(): Pattern2DBuilder` — Create typed, composable 2D surface patterns for `.surfaceDisplace()`.
 - `SurfacePattern: typeof SurfacePattern` — A 2D surface pattern — a heightmap function for use with `.surfaceDisplace()`.
-- `fromFunction(fn: SdfFunctionSource, options: SdfFunctionOptions): SdfShape` — Create a custom SDF from one expression; shader-safe expressions raymarch directly.
+- `fromFunction(fn: SdfFunctionSource, options: SdfFunctionOptions): SdfShape` — Create a custom SDF from one expression; shader-safe expressions keep shader metadata for tooling.
 - `combine(value: unknown, options?: CombineOptions): SdfShape` — Collapse a plain object/array tree of SDF leaves into one continuous implicit field. Per-leaf color/material identity is intentionally discarded — the result is one scalar field. Use plain object returns for multi-material SDF preview, and `sdf.combine(...)` only when you want one implicit body. Explicit shape lists are covered by `a.union(b, c)`; pass `{ op: 'intersection' }` to intersect instead.
 
   ```js

package/examples/api/gyroid-voronoi-blend.forge.js

@@ -1,5 +1,5 @@
 // Gyroid-diamond blend — shader-compatible TPMS fields combined in one form.
-// Return the raw SDF for fast native preview; use toShape(...) when exporting.
+// Return the SDF directly for implicit preview data; use toShape(...) for export tuning.
 
 const bounds = sdf.sphere(22);
 const gyroid = sdf.gyroid({ cellSize: 10, thickness: 1.0 });

package/examples/api/organic-noise-sculpture.forge.js

@@ -1,5 +1,5 @@
 // Organic noise sculpture — natural, coral-like form
-// Noise is still materialized because native preview does not raymarch it yet.
+// Explicit meshing keeps the noisy field on the ordinary mesh preview/export path.
 
 const shell = sdf.sphere(20).shell(4);
 const texture = sdf.noise({ scale: 0.15, amplitude: 3, octaves: 3 });

package/examples/api/sdf-circular-array-knurling.forge.js

@@ -16,4 +16,4 @@ const leftHandGroove = sdf.box(2.4, 1.2, 48)
 return body
   .subtract(rightHandGroove, leftHandGroove)
   .color('#8da2ad')
-  .material({ roughness: 0.38, metalness: 0.18 });
+  .material({ roughness: 0.38, metalness: 0.18 }).toShape({edgeLength: 0.2});

package/examples/api/{sdf-custom-raymarch.forge.js → sdf-custom-field-mesh-preview.forge.js}

@@ -1,8 +1,7 @@
-// Custom SDF native preview — one user-authored expression drives CPU sampling
-// and, when shader-safe, native raymarch preview.
+// Custom SDF implicit preview — one user-authored expression drives the field.
 //
-// This returns a raw SdfShape. Do not call .toShape() here; keeping it implicit
-// proves the custom function can preview through the raymarch shader.
+// Returning SdfShape directly keeps the field implicit. Call .toShape(...) when
+// you need explicit mesh quality for CAD operations or export.
 
 const rippledSphere = sdf.fromFunction(
   (x, y, z, radius, frequency, amplitude) =>

package/examples/api/sdf-materialize-tree.forge.js

@@ -1,4 +1,4 @@
-// Materialize a raw SDF tree when you need mesh-backed CAD/export behavior.
+// Return a plain SDF tree; scene mapping keeps SDF leaves implicit.
 
 const insert = {
   shell: sdf.sphere(18)
@@ -9,4 +9,4 @@ const insert = {
     .color('#ffcf5a'),
 };
 
-return insert;
+return insert;

package/examples/api/sdf-plain-return.forge.js

@@ -1,6 +1,7 @@
-// Plain raw SDF return: no Shape, no .toShape(), no Sculpt facade.
+// Plain SDF return: no explicit Shape, no .toShape(), no Sculpt facade.
 //
-// This should render directly in Studio and the CLI.
+// Direct returns stay as implicit SDF preview data; call .toShape() when you
+// need a mesh-backed Shape for CAD operations or export.
 
 scene(Sculpt.look('soft-studio'));
 

package/examples/api/sdf-shapes.forge.js

@@ -1,6 +1,6 @@
-// SDF native preview — raw SDF leaves render directly by raymarching.
+// SDF implicit preview — SDF leaves stay lazy until .toShape(...).
 //
-// Use .toShape() only when you need mesh-backed CAD operations or export.
+// Use .toShape(...) when you need explicit meshing controls, CAD operations, or export.
 
 const smoothBlob = sdf.smoothUnion(
   sdf.sphere(12),

package/examples/api/sdf-surface-basket-weave.forge.js

@@ -1,5 +1,5 @@
-// Native SDF surface relief — user-composed Pattern2D IR lowers to shader + CPU.
-// These raw SDF leaves raymarch directly; call .toShape() only for export.
+// Native SDF surface relief — user-composed Pattern2D IR lowers to CPU sampling.
+// Direct SDF returns stay implicit; call .toShape(...) for mesh-backed export.
 
 scene({
   background: { top: '#f6fbff', bottom: '#dfe9f3' },

package/examples/generative/twisted-lattice-tower.forge.js

@@ -1,4 +1,4 @@
-// Twisted lattice tower — gyroid field raymarched directly in the viewport.
+// Twisted lattice tower — direct SDF return materializes as a mesh-backed preview.
 
 const column = sdf.cylinder(54, 13);
 

package/examples/generative/voronoi-lampshade.forge.js

@@ -1,5 +1,5 @@
 // Voronoi lampshade — organic cell-wall dome, open at the bottom.
-// Voronoi is still materialized because native preview does not raymarch it yet.
+// Explicit meshing keeps this dense field on the ordinary mesh preview/export path.
 
 const dome = sdf.sphere(30)
   .subtract(sdf.sphere(27))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgecad",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "Code-first parametric CAD for JavaScript/TypeScript, in the browser and CLI.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://forgecad.io",
@@ -213,7 +213,7 @@
     "gifenc": "^1.0.3",
     "jsonwebtoken": "^9.0.3",
     "lz-string": "^1.5.0",
-    "manifold-3d": "^3.4.0",
+    "manifold-3d": "^3.5.1",
     "meshoptimizer": "^1.0.1",
     "mp4-muxer": "^5.2.1",
     "nanoid": "^5.1.7",