@metamesh/modeling 0.18.0 → 0.20.0

package/dist/docs/reference/model/union.md

@@ -30,6 +30,8 @@ Robust union of one or more shapes; empty input rejects during declaration.
 
 **`solids`** · readonly [`Solid`](Solid.md)[] · Required
 
+Operands in shared modeling coordinates.
+
 
 
 ### Returns
@@ -44,7 +46,7 @@ Robust union of one or more shapes; empty input rejects during declaration.
 
 
 
-Native filled section union; dimensions cannot be mixed.
+Filled Section union; dimensions cannot be mixed.
 
 ### Parameters
 
@@ -52,6 +54,8 @@ Native filled section union; dimensions cannot be mixed.
 
 **`sections`** · readonly [`Section`](Section.md)[] · Required
 
+Operands in shared XY coordinates.
+
 
 
 ### Returns
@@ -67,6 +71,13 @@ Native filled section union; dimensions cannot be mixed.
 ## Guides
 
 - [Choose the Boolean by the material you want](../../guides/fundamentals.md#choose-the-boolean-by-the-material-you-want)
-- [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+- [Primitive booleans and repeated placement](../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
+- [Join an independently modeled feature](../../guides/solid-joins.md#join-an-independently-modeled-feature)
+
+## Import
+
+```ts
+import { union } from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/model.md

@@ -1,8 +1,8 @@
 # Model API
 
-Immutable shapes, vectors and transforms with fluent operations and host-owned geometry evaluation.
+Immutable solid and section recipes with fluent operations and host-owned geometry evaluation.
 
-Build models from immutable shapes with `@metamesh/modeling`. Import `generate`, shape constructors, vectors, transforms, and collection functions, then chain shape methods to transform, combine, query, and finish recipes. A host session runs the model and manages optional computed caches.
+Build models from immutable shapes with `@metamesh/modeling`. Import `generate`, shape constructors, and collection functions, then chain shape methods to transform, combine, query, and finish recipes. A host session runs the model and manages optional memo caches.
 
 ```ts
 import { box, cylinder, generate } from "@metamesh/modeling";
@@ -12,7 +12,7 @@ const engine = await createModelEngine();
 const result = engine.run(model);
 ```
 
-Computed data and recipes let you reuse unchanged work. Keep part placement and color separate from local geometry. Section recipes preserve holes through Boolean and offset chains.
+Memoized data and recipes let you reuse unchanged work. Keep part placement and color separate from local geometry. Section recipes preserve holes through Boolean and offset chains.
 
 - **Construction:** recipes and composition require no engine. Ordinary recipes can be reused across sessions, wherever constructed.
 - **Resolution:** explicit settings are captured; unspecified settings inherit the evaluating host's defaults.
@@ -24,20 +24,20 @@ See [host lifecycle](engine.md) and [pure foundations](geometry.md).
 ## Categories
 
 - [Primitives](model/categories/primitives.md) — Create basic solids with explicit dimensions and tessellation.
-- [Local resolution](model/categories/resolution.md) — Choose physical curve sampling and explicit native tolerance.
 - [2D sections](model/categories/sections.md) — Create immutable filled XY shapes, including prepared text and bounded painted SVG.
-- [Sampled paths](model/categories/paths.md) — Reuse immutable sampled paths in 2D or 3D.
 - [Boolean operations](model/categories/boolean-operations.md) — Combine, intersect and subtract same-dimensional shapes; construct solid envelopes and sums.
-- [Transforms, vectors, and placement](model/categories/transforms-placement.md) — Calculate with immutable vectors, reuse transforms, and position geometry.
+- [Shape patterns](model/categories/transforms-placement.md) — Repeat Solid and Section recipes along lines, grids, circles, or paths.
 - [Extrude, revolve, and sweep](model/categories/extrude-revolve-sweep.md) — Turn sections and paths into extruded, lofted, revolved, or swept solids.
 - [Knuckle joints](model/categories/hinges.md) — Compose reusable knuckle joints with independent mounting attachments.
 - [Printable threads](model/categories/threads.md) — Construct compensated thread forms and inspect bounded preflight facts.
 - [Mesh and inspection](model/categories/mesh-inspection.md) — Convert validated meshes and read stable section or solid measurements.
-- [Core values and errors](model/categories/core-values-errors.md) — Use shared coordinate data and recognize structured geometry errors.
-- [Bounds](model/categories/bounds.md) — Measure immutable axis-aligned bounds and check whether positioned bounds contain one another.
-- [Explicit matching profiles](model/categories/explicit-profiles.md) — Build hollow or multicomponent lofts and sweeps using stable landmarks.
 - [Sampled surfaces](model/categories/bounded-surfaces.md) — Construct bounded heightfields and positive-inside implicit fields.
 - [Model generation](model/categories/generation.md) — Build typed models with optional cached computations, named parts, and structured warnings or errors.
-- [Model contracts](model/categories/contracts.md) — Understand opaque shape handles, dimensions, manufacturing parts, and durable model results.
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/text/MAX_VECTOR_FONT_BYTES.md

@@ -4,4 +4,10 @@ Maximum input font size in bytes, checked before parsing or shaping untrusted fo
 
 `const` **MAX\_VECTOR\_FONT\_BYTES**: `number`
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import { MAX_VECTOR_FONT_BYTES } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/text/VectorFont.md

@@ -8,11 +8,11 @@ A prepared font owns its parsed bytes; keep handles local to their Worker or inv
 
 
 
-`readonly` **layout**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md)) => [`VectorTextLayout`](VectorTextLayout.md)
+`readonly` **layout**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md)) => [`VectorTextLayout`](../geometry/VectorTextLayout.md)
 
 
 
-Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and supports blank text.
+Shape horizontal lines or one circular line, including blank text.
 
 #### Parameters
 
@@ -20,6 +20,8 @@ Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and sup
 
 **`text`** · `string` · Required
 
+Up to 512 UTF-16 code units, across at most 16 lines.
+
 
 
 <a id="options"></a>
@@ -30,7 +32,7 @@ Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and sup
 
   Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
 
-- [`align`](VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
+- [`align`](VectorTextLayoutOptions.md#align) · `"center"` \| `"left"` \| `"right"` · Optional
 
   Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
 
@@ -58,7 +60,7 @@ Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and sup
 
 #### Returns
 
-[`VectorTextLayout`](VectorTextLayout.md)
+[`VectorTextLayout`](../geometry/VectorTextLayout.md)
 
 ***
 
@@ -66,7 +68,7 @@ Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and sup
 
 
 
-`readonly` **measure**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md)) => [`VectorTextMetrics`](VectorTextMetrics.md)
+`readonly` **measure**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md)) => [`VectorTextMetrics`](../geometry/VectorTextMetrics.md)
 
 
 
@@ -78,6 +80,8 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
 
 **`text`** · `string` · Required
 
+Same limits as [VectorFont.layout](#layout).
+
 
 
 <a id="options-1"></a>
@@ -88,7 +92,7 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
 
   Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
 
-- [`align`](VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
+- [`align`](VectorTextLayoutOptions.md#align) · `"center"` \| `"left"` \| `"right"` · Optional
 
   Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
 
@@ -116,7 +120,7 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
 
 #### Returns
 
-[`VectorTextMetrics`](VectorTextMetrics.md)
+[`VectorTextMetrics`](../geometry/VectorTextMetrics.md)
 
 ***
 
@@ -128,7 +132,7 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
 
 
 
-Serialize visible horizontal or circular outlines as bounded path-only SVG in physical millimetres.
+Serialize visible horizontal or circular outlines as path-only SVG in millimetres, bounded to 256 KiB.
 
 #### Parameters
 
@@ -136,6 +140,8 @@ Serialize visible horizontal or circular outlines as bounded path-only SVG in ph
 
 **`text`** · `string` · Required
 
+Same limits as [VectorFont.layout](#layout); blank outlines are rejected.
+
 
 
 <a id="options-2"></a>
@@ -146,7 +152,7 @@ Serialize visible horizontal or circular outlines as bounded path-only SVG in ph
 
   Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
 
-- [`align`](VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
+- [`align`](VectorTextLayoutOptions.md#align) · `"center"` \| `"left"` \| `"right"` · Optional
 
   Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
 
@@ -179,8 +185,12 @@ Serialize visible horizontal or circular outlines as bounded path-only SVG in ph
 
 ## Related APIs
 
-- [VectorTextLayout](VectorTextLayout.md)
 - [VectorTextLayoutOptions](VectorTextLayoutOptions.md)
-- [VectorTextMetrics](VectorTextMetrics.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import type { VectorFont } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/text/VectorFontOptions.md

@@ -14,4 +14,10 @@ Identifies the actual weight of a static face, without synthesizing a different
 
 Actual weight of a static face, 1–1000; defaults to 400.
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import type { VectorFontOptions } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/text/VectorTextArcBaseline.md

@@ -50,4 +50,10 @@ Alignment datum in degrees counterclockwise from +X; defaults to 90.
 
 Reading direction around the circle; defaults to clockwise.
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import type { VectorTextArcBaseline } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/text/VectorTextLayoutOptions.md

@@ -12,7 +12,7 @@ Text bounded to 512 UTF-16 units: horizontal lines or one circular line without
 
 
 
-`readonly` `optional` **align?**: `"left"` \| `"right"` \| `"center"`
+`readonly` `optional` **align?**: `"center"` \| `"left"` \| `"right"`
 
 
 
@@ -108,4 +108,10 @@ Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 - [VectorTextArcBaseline](VectorTextArcBaseline.md)
 - [VectorTextOptions](VectorTextOptions.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import type { VectorTextLayoutOptions } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/text/VectorTextOptions.md

@@ -47,4 +47,10 @@ Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
 - [VectorTextLayoutOptions](VectorTextLayoutOptions.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import type { VectorTextOptions } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/text/categories/font-preparation.md

@@ -19,17 +19,8 @@ Layout returns immutable paths and metrics in Y-up millimetres. Pass the prepare
 | [VectorFont](../VectorFont.md) | A prepared font owns its parsed bytes; keep handles local to their Worker or invocation. Invalid arguments and bounded-work failures use GeometryError; unexpected dependency errors propagate. |
 | [VectorFontOptions](../VectorFontOptions.md) | Identifies the actual weight of a static face, without synthesizing a different weight. |
 | [VectorTextArcBaseline](../VectorTextArcBaseline.md) | A circular baseline centered at the XY origin, with rigid shaped glyph groups. |
-| [VectorTextLayout](../VectorTextLayout.md) | Immutable vector layout with no browser, font parser, or kernel ownership. |
 | [VectorTextLayoutOptions](../VectorTextLayoutOptions.md) | Text bounded to 512 UTF-16 units: horizontal lines or one circular line without wrapping. |
-| [VectorTextMetrics](../VectorTextMetrics.md) | Text measurements from the same immutable layout that supplies geometry and SVG outlines. |
 | [VectorTextOptions](../VectorTextOptions.md) | Shaping controls for a prepared exact font face; all lengths are in millimetres. |
-| [Bounds2Data](../Bounds2Data.md) | Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods. |
-
-## Type aliases
-
-| API | Summary |
-| --- | --- |
-| [Vector2Data](../Vector2Data.md) | A two-dimensional Cartesian vector or point. |
 
 ## Values
 
@@ -37,4 +28,10 @@ Layout returns immutable paths and metrics in Y-up millimetres. Pass the prepare
 | --- | --- |
 | [MAX_VECTOR_FONT_BYTES](../MAX_VECTOR_FONT_BYTES.md) | Maximum input font size in bytes, checked before parsing or shaping untrusted font data. |
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import * as text from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/text/prepareVectorFont.md

@@ -21,6 +21,8 @@ async function prepareLabel(fontBytes: Uint8Array) {
 
 **`bytes`** · `Uint8Array` · Required
 
+Non-empty font bytes, at most 16 MiB; copied before parsing.
+
 
 
 <a id="options"></a>
@@ -43,4 +45,10 @@ async function prepareLabel(fontBytes: Uint8Array) {
 - [VectorFont](VectorFont.md)
 - [VectorFontOptions](VectorFontOptions.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import { prepareVectorFont } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/text.md

@@ -20,4 +20,10 @@ Paths and metrics use Y-up millimetres and a baseline origin. Empty layouts can
 
 - [Font preparation](text/categories/font-preparation.md) — Prepare exact font bytes within limits and reuse vector layouts.
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import * as text from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/engine/execution.js

@@ -1,7 +1,7 @@
 import { GeometryError } from "../geometry/errors.js";
-import { analyzeTriangleMesh, } from "../geometry/mesh/mesh.js";
-import { assertMeshAllocationWithinLimits } from "../geometry/model-limits.js";
-import { assertSamplingCount } from "../geometry/sampling-limits.js";
+import { assertMeshAllocationWithinLimits } from "../geometry/limits.js";
+import { analyzeTriangleMesh, } from "../geometry/mesh/operations.js";
+import { assertSamplingCount } from "../geometry/sampling/limits.js";
 import { createSectionHandle, createSolidHandle } from "../model/shape-handles.js";
 import { ownScopedManifoldValue, scopedManifoldScope, trackScopedManifoldValue, } from "./native/context.js";
 import { copiedFloat32Array, copiedUint32Array } from "./native/copied-views.js";
@@ -309,6 +309,8 @@ export function createExecutionContext(module, scope, limits, initialResolution
         },
         restoreNative(geometry) {
             assertActive();
+            // Register the borrow for native-operation guards. The cache keeps cleanup responsibility;
+            // putting this value in the run's allocation scope would delete it while the cache retains it.
             trackScopedManifoldValue(scope, geometry.native.value);
             const shape = geometry.native.kind === "solid"
                 ? wrapSolid(geometry.native.value)

package/dist/engine/finalization.js

@@ -1,11 +1,10 @@
 import { GeometryError } from "../geometry/errors.js";
-import { immutableMeshView, isImmutableBuffer, } from "../geometry/immutable-buffer.js";
-import { optimizePlanarPatches } from "../geometry/mesh/mesh-planar.js";
-import { validateAnalyzedSolidMesh } from "../geometry/mesh/mesh-solid.js";
-import { analyzeTriangleMesh, } from "../geometry/mesh/mesh.js";
-import { MeshViewCache } from "./mesh-view-cache.js";
+import { immutableMeshView } from "../geometry/immutable-buffer.js";
+import { analyzeTriangleMesh, } from "../geometry/mesh/operations.js";
+import { optimizePlanarPatches } from "../geometry/mesh/planar.js";
+import { validateAnalyzedSolidMesh } from "../geometry/mesh/solid.js";
+import { MeshViewCache } from "../geometry/mesh/view-cache.js";
 import { copiedMeshViews, copiedUint32Array } from "./native/copied-views.js";
-const isArray = (value) => Array.isArray(value);
 function fitsGeometryLimits(mesh, limits) {
     const buffers = new Set([mesh.positions.buffer, mesh.indices.buffer]);
     let bytes = 0;
@@ -15,7 +14,7 @@ function fitsGeometryLimits(mesh, limits) {
         mesh.indices.length / 3 <= limits.maxTriangles &&
         bytes <= limits.maxBytes);
 }
-/** Copies, validates and optionally simplifies local geometry, sharing equal views within one transaction. */
+/** Copies, validates and optionally optimizes planar topology, sharing equal views within one transaction. */
 export function createGeometryFinalizer(execution, limits, options) {
     if (options.meshValidation !== undefined &&
         options.meshValidation !== "topology" &&
@@ -82,74 +81,3 @@ export function createGeometryFinalizer(execution, limits, options) {
         return result;
     };
 }
-/** Captures mutable external buffers once before an asynchronous snapshot export begins. */
-export function captureExportParts(parts, limits) {
-    if (!isArray(parts) || parts.length === 0 || parts.length > limits.maxParts)
-        throw new GeometryError("COMPLEXITY_LIMIT", `Export requires one through ${limits.maxParts} parts.`, {
-            operation: "export3mf",
-        });
-    const captured = parts.map((part) => {
-        if (typeof part !== "object" || part === null)
-            throw new GeometryError("INVALID_ARGUMENT", "Export part IDs must be unique canonical identifiers.", { operation: "export3mf" });
-        // Trusted immutable storage can outlive the asynchronous export directly. Mutable external
-        // input is captured once below, preserving shared backing buffers before the first await.
-        const { positions, indices } = part;
-        const immutable = isImmutableBuffer(positions) && isImmutableBuffer(indices);
-        const mesh = immutableMeshView({ positions, indices });
-        const id = part.id, color = part.color;
-        return {
-            id,
-            immutable,
-            positions: mesh.positions,
-            indices: mesh.indices,
-            ...(color === undefined ? {} : { color }),
-        };
-    });
-    const identifiers = new Set();
-    const buffers = new Set();
-    let vertexCount = 0, triangleCount = 0, byteCount = 0;
-    for (const part of captured) {
-        if (typeof part !== "object" ||
-            part === null ||
-            typeof part.id !== "string" ||
-            !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(part.id) ||
-            part.id.length > 64 ||
-            identifiers.has(part.id))
-            throw new GeometryError("INVALID_ARGUMENT", "Export part IDs must be unique canonical identifiers.", { operation: "export3mf" });
-        identifiers.add(part.id);
-        if (part.color !== undefined &&
-            (typeof part.color !== "string" || !/^#[\da-f]{6}$/i.test(part.color)))
-            throw new GeometryError("INVALID_ARGUMENT", "Export colors must be six-digit hex strings.", {
-                operation: "export3mf",
-            });
-        if (!(part.positions instanceof Float32Array) ||
-            !(part.indices instanceof Uint32Array) ||
-            !(part.positions.buffer instanceof ArrayBuffer) ||
-            !(part.indices.buffer instanceof ArrayBuffer))
-            throw new GeometryError("INVALID_MESH", "Export requires transferable copied mesh arrays.", {
-                operation: "export3mf",
-            });
-        vertexCount += part.positions.length / 3;
-        triangleCount += part.indices.length / 3;
-        for (const buffer of [part.positions.buffer, part.indices.buffer]) {
-            if (!buffers.has(buffer)) {
-                buffers.add(buffer);
-                byteCount += buffer.byteLength;
-            }
-        }
-        if (vertexCount > limits.maxVertices ||
-            triangleCount > limits.maxTriangles ||
-            byteCount > limits.maxBytes)
-            throw new GeometryError("COMPLEXITY_LIMIT", "Export snapshot exceeds the execution limits.", {
-                operation: "export3mf",
-            });
-    }
-    const copiedBuffers = new Map();
-    return captured.map((part) => ({
-        id: part.id,
-        ...(part.immutable
-            ? { positions: part.positions, indices: part.indices }
-            : copiedMeshViews(part, copiedBuffers)),
-        ...(part.color === undefined ? {} : { color: part.color }),
-    }));
-}

package/dist/engine/index.js

@@ -1,11 +1,10 @@
 import { GeometryError } from "../geometry/errors.js";
-import { defaultModelingLimits, resolveModelingLimits } from "../geometry/model-limits.js";
+import { defaultModelingLimits, resolveModelingLimits } from "../geometry/limits.js";
 import { createExecutionContext } from "./execution.js";
 import createManifoldModule from "./kernel/manifold.js";
 import { withManifoldScope } from "./native/context.js";
 import { createSession } from "./session/session.js";
 export { defaultModelingLimits };
-export { export3mf } from "./export-3mf.js";
 /** URL of the package's pinned WASM asset; browser bundlers may replace it with their emitted URL. */
 export const modelingWasmUrl = new URL("./kernel/manifold.wasm", import.meta.url).href;
 /**
@@ -13,6 +12,9 @@ export const modelingWasmUrl = new URL("./kernel/manifold.wasm", import.meta.url
  * Returns reached assertion errors and warnings; unexpected execution failures throw.
  * Returned geometry is not realized or validated.
  * Geometry observations require an initialized session's `check` method instead.
+ *
+ * @param program - Model declaration to check without evaluating geometry.
+ * @param args - Parameters, then session options; include any required services.
  */
 export function checkModel(program, ...args) {
     const [parameters, options] = args;
@@ -50,8 +52,8 @@ function engineFromModule(module, engineLimits) {
                 const limits = resolveModelingLimits(options.limits, engineLimits);
                 building = true;
                 try {
-                    // The trusted finalizer captures geometry outside native ownership. Publish its
-                    // immutable storage only after the native scope's structural escape check.
+                    // The trusted finalizer captures owned JavaScript data separately from native values.
+                    // Publish its closure-bearing snapshot facade only after the native scope cleans up.
                     let captured;
                     withManifoldScope(module, (scope) => {
                         let execution;
@@ -76,12 +78,15 @@ function engineFromModule(module, engineLimits) {
     }
 }
 /**
- * Initializes one host kernel and returns a lifecycle-safe engine. No generator initializes WASM.
+ * Initializes one host kernel; runs and sessions own native cleanup.
+ *
+ * @param options - WASM URL and engine resource limits.
  *
  * @example Build a box in a host application
  * ```ts
  * import { box, generate } from "@metamesh/modeling";
- * import { createModelEngine, export3mf } from "@metamesh/modeling/engine";
+ * import { createModelEngine } from "@metamesh/modeling/engine";
+ * import { export3mf } from "@metamesh/modeling/export";
  *
  * const engine = await createModelEngine();
  * const model = generate<Record<never, never>>(({ part }) => [part("body", box({ size: [30, 20, 8] }))]);

package/dist/engine/native/adapter.js

@@ -1,4 +1,4 @@
-import { validateTriangleMesh } from "../../geometry/mesh/mesh.js";
+import { validateTriangleMesh } from "../../geometry/mesh/operations.js";
 import { assertNativeSolidStatus } from "./status.js";
 /**
  * Constructs a live Manifold solid from a copied indexed triangle mesh.

package/dist/engine/native/construction-mesh.js

@@ -0,0 +1,51 @@
+import { GeometryError } from "../../geometry/errors.js";
+import { assertMeshAllocationWithinLimits } from "../../geometry/limits.js";
+import { ownScopedManifoldValue, scopedManifoldModule, } from "./context.js";
+import { assertNativeSolidStatus } from "./status.js";
+/**
+ * Builds a scope-owned solid from Float32 proxy topology and authoritative Float64 millimetre coordinates.
+ * Each proxy position must identify one native position, even when the kernel merges or reorders vertices.
+ */
+export function nativeConstructionMesh(scope, mesh, limits, operation) {
+    const vertices = mesh.positions.length / 3;
+    assertMeshAllocationWithinLimits(vertices, mesh.indices.length / 3, mesh.positions.byteLength +
+        mesh.indices.byteLength +
+        mesh.nativePositions.byteLength +
+        vertices * 144, operation, limits);
+    const fail = (message) => {
+        throw new GeometryError("DEGENERATE_GEOMETRY", message, { operation });
+    };
+    if (mesh.nativePositions.length !== mesh.positions.length)
+        fail("Native construction coordinates must cover every proxy vertex.");
+    const key = (x, y, z) => `${x},${y},${z}`;
+    const coordinates = new Map();
+    for (let index = 0; index < mesh.positions.length; index += 3) {
+        if (!Number.isFinite(mesh.nativePositions[index]) ||
+            !Number.isFinite(mesh.nativePositions[index + 1]) ||
+            !Number.isFinite(mesh.nativePositions[index + 2]))
+            fail("Native construction coordinates must be finite.");
+        const identity = key(mesh.positions[index], mesh.positions[index + 1], mesh.positions[index + 2]);
+        const prior = coordinates.get(identity);
+        if (prior !== undefined &&
+            (mesh.nativePositions[prior] !== mesh.nativePositions[index] ||
+                mesh.nativePositions[prior + 1] !== mesh.nativePositions[index + 1] ||
+                mesh.nativePositions[prior + 2] !== mesh.nativePositions[index + 2]))
+            fail("A captured construction vertex has ambiguous native coordinates.");
+        coordinates.set(identity, index);
+    }
+    const module = scopedManifoldModule(scope);
+    const proxy = ownScopedManifoldValue(scope, new module.Manifold(new module.Mesh({ numProp: 3, vertProperties: mesh.positions, triVerts: mesh.indices })));
+    assertNativeSolidStatus(proxy, operation);
+    const result = ownScopedManifoldValue(scope, proxy.warpBatch((positions, count) => {
+        for (let vertex = 0; vertex < count; vertex++) {
+            const offset = vertex * 3;
+            const source = coordinates.get(key(positions[offset], positions[offset + 1], positions[offset + 2])) ?? fail("Native construction lost a captured vertex identity.");
+            // Copy coordinates directly to avoid allocating a temporary typed-array view per vertex.
+            positions[offset] = mesh.nativePositions[source];
+            positions[offset + 1] = mesh.nativePositions[source + 1];
+            positions[offset + 2] = mesh.nativePositions[source + 2];
+        }
+    }));
+    assertNativeSolidStatus(result, operation);
+    return result;
+}

package/dist/engine/native/context.js

@@ -18,10 +18,10 @@ const stateFor = (context) => {
 export function createScopedManifoldContext(module, scope) {
     assertWasmObjectScopeActive(scope);
     const context = Object.freeze({});
-    contexts.set(context, { active: true, module, owned: new WeakSet(), scope });
+    contexts.set(context, { active: true, module, trackedValues: new WeakSet(), scope });
     return context;
 }
-/** @internal Returns the live upstream module owned by a scoped context. */
+/** @internal Returns the initialized upstream module used by this live context. */
 export function scopedManifoldModule(context) {
     return stateFor(context).module;
 }
@@ -33,12 +33,15 @@ export function scopedManifoldScope(context) {
 export function ownScopedManifoldValue(context, value) {
     const state = stateFor(context);
     const owned = state.scope.own(value);
-    state.owned.add(owned);
+    state.trackedValues.add(owned);
     return owned;
 }
-/** @internal Records a value already transferred to the context's low-level owner. */
+/**
+ * @internal Registers a borrowed or already scope-owned value without transferring cleanup.
+ * Session-cache borrows remain cache-owned; fresh allocations must use ownScopedManifoldValue.
+ */
 export function trackScopedManifoldValue(context, value) {
-    stateFor(context).owned.add(value);
+    stateFor(context).trackedValues.add(value);
     return value;
 }
 /** @internal Verifies that a context remains active without exposing its internals. */
@@ -47,7 +50,7 @@ export function assertScopedManifoldContext(context) {
 }
 /** @internal Verifies that a live WASM value belongs to this exact context. */
 export function assertScopedManifoldValue(context, value) {
-    if (!stateFor(context).owned.has(value)) {
+    if (!stateFor(context).trackedValues.has(value)) {
         throw new Error("WASM-backed values must be used with the scoped context that owns them.");
     }
 }
@@ -124,7 +127,7 @@ const assertNoScopedEscape = (value, context, seen = new WeakSet()) => {
         return;
     seen.add(objectValue);
     const state = contexts.get(context);
-    if (state?.owned.has(objectValue) === true) {
+    if (state?.trackedValues.has(objectValue) === true) {
         throw new Error("WASM-backed values must not escape a scoped Manifold callback.");
     }
     if (isProtectedCopiedView(objectValue))

package/dist/engine/native/index.js

@@ -7,7 +7,7 @@ export { createScopedManifoldContext, withManifoldScope, } from "./context.js";
 export { box, cylinder, sphere, torus, tube, } from "./scoped-primitives.js";
 export { hull, intersect, minkowskiSum, subtract, union } from "./operations.js";
 export { attach, mirror, rotate, scale, transform, translate, } from "./transforms.js";
-export { internalThreadCutter, preflightInternalThreadCutter, preflightThreadedNut, preflightThreadedRod, threadRidge, threadedNut, threadedRod, } from "./scoped-threads.js";
+export { internalThreadCutter, threadRidge, threadedNut, threadedRod, } from "./scoped-threads.js";
 export {} from "./threads.js";
 export { WasmObjectScope, withWasmObjectScope } from "./ownership.js";
 export { crossSectionToRegion, regionToCrossSection } from "./regions.js";