@metamesh/modeling 0.17.0 → 0.19.0

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

@@ -8,7 +8,7 @@ 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`](../geometry/VectorTextLayoutOptions.md)) => [`VectorTextLayout`](../geometry/VectorTextLayout.md)
 
 
 
@@ -24,33 +24,33 @@ Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and sup
 
 <a id="options"></a>
 
-**`options`** · [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md) · Required
+**`options`** · [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md) · Required
 
-- [`fontSize`](VectorTextLayoutOptions.md#fontsize) · `number` · Required
+- [`fontSize`](../geometry/VectorTextLayoutOptions.md#fontsize) · `number` · Required
 
   Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
 
-- [`align`](VectorTextLayoutOptions.md#align) · `"center"` \| `"left"` \| `"right"` · Optional
+- [`align`](../geometry/VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
 
   Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
 
-- [`baseline`](VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](VectorTextArcBaseline.md) · Optional
+- [`baseline`](../geometry/VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](../geometry/VectorTextArcBaseline.md) · Optional
 
   Omitted uses horizontal lines. Arcs require one line and baseline vertical alignment.
 
-- [`lineHeight`](VectorTextLayoutOptions.md#lineheight) · `number` · Optional
+- [`lineHeight`](../geometry/VectorTextLayoutOptions.md#lineheight) · `number` · Optional
 
   Baseline spacing in ems, 0.5–5; omitted uses the selected face's natural vertical metrics.
 
-- [`verticalAlign`](VectorTextLayoutOptions.md#verticalalign) · `"center"` \| `"top"` \| `"bottom"` \| `"baseline"` · Optional
+- [`verticalAlign`](../geometry/VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
 
   Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
 
-- [`fontWeight`](VectorTextLayoutOptions.md#fontweight) · `number` · Optional
+- [`fontWeight`](../geometry/VectorTextLayoutOptions.md#fontweight) · `number` · Optional
 
   Actual static or variable weight, 1–1000; defaults to the prepared face's static weight.
 
-- [`letterSpacing`](VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
+- [`letterSpacing`](../geometry/VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
 
   Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
@@ -58,7 +58,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 +66,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`](../geometry/VectorTextLayoutOptions.md)) => [`VectorTextMetrics`](../geometry/VectorTextMetrics.md)
 
 
 
@@ -82,33 +82,33 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
 
 <a id="options-1"></a>
 
-**`options`** · [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md) · Required
+**`options`** · [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md) · Required
 
-- [`fontSize`](VectorTextLayoutOptions.md#fontsize) · `number` · Required
+- [`fontSize`](../geometry/VectorTextLayoutOptions.md#fontsize) · `number` · Required
 
   Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
 
-- [`align`](VectorTextLayoutOptions.md#align) · `"center"` \| `"left"` \| `"right"` · Optional
+- [`align`](../geometry/VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
 
   Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
 
-- [`baseline`](VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](VectorTextArcBaseline.md) · Optional
+- [`baseline`](../geometry/VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](../geometry/VectorTextArcBaseline.md) · Optional
 
   Omitted uses horizontal lines. Arcs require one line and baseline vertical alignment.
 
-- [`lineHeight`](VectorTextLayoutOptions.md#lineheight) · `number` · Optional
+- [`lineHeight`](../geometry/VectorTextLayoutOptions.md#lineheight) · `number` · Optional
 
   Baseline spacing in ems, 0.5–5; omitted uses the selected face's natural vertical metrics.
 
-- [`verticalAlign`](VectorTextLayoutOptions.md#verticalalign) · `"center"` \| `"top"` \| `"bottom"` \| `"baseline"` · Optional
+- [`verticalAlign`](../geometry/VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
 
   Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
 
-- [`fontWeight`](VectorTextLayoutOptions.md#fontweight) · `number` · Optional
+- [`fontWeight`](../geometry/VectorTextLayoutOptions.md#fontweight) · `number` · Optional
 
   Actual static or variable weight, 1–1000; defaults to the prepared face's static weight.
 
-- [`letterSpacing`](VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
+- [`letterSpacing`](../geometry/VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
 
   Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
@@ -116,7 +116,7 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
 
 #### Returns
 
-[`VectorTextMetrics`](VectorTextMetrics.md)
+[`VectorTextMetrics`](../geometry/VectorTextMetrics.md)
 
 ***
 
@@ -124,7 +124,7 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
 
 
 
-`readonly` **toSvg**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md)) => `string`
+`readonly` **toSvg**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md)) => `string`
 
 
 
@@ -140,33 +140,33 @@ Serialize visible horizontal or circular outlines as bounded path-only SVG in ph
 
 <a id="options-2"></a>
 
-**`options`** · [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md) · Required
+**`options`** · [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md) · Required
 
-- [`fontSize`](VectorTextLayoutOptions.md#fontsize) · `number` · Required
+- [`fontSize`](../geometry/VectorTextLayoutOptions.md#fontsize) · `number` · Required
 
   Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
 
-- [`align`](VectorTextLayoutOptions.md#align) · `"center"` \| `"left"` \| `"right"` · Optional
+- [`align`](../geometry/VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
 
   Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
 
-- [`baseline`](VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](VectorTextArcBaseline.md) · Optional
+- [`baseline`](../geometry/VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](../geometry/VectorTextArcBaseline.md) · Optional
 
   Omitted uses horizontal lines. Arcs require one line and baseline vertical alignment.
 
-- [`lineHeight`](VectorTextLayoutOptions.md#lineheight) · `number` · Optional
+- [`lineHeight`](../geometry/VectorTextLayoutOptions.md#lineheight) · `number` · Optional
 
   Baseline spacing in ems, 0.5–5; omitted uses the selected face's natural vertical metrics.
 
-- [`verticalAlign`](VectorTextLayoutOptions.md#verticalalign) · `"center"` \| `"top"` \| `"bottom"` \| `"baseline"` · Optional
+- [`verticalAlign`](../geometry/VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
 
   Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
 
-- [`fontWeight`](VectorTextLayoutOptions.md#fontweight) · `number` · Optional
+- [`fontWeight`](../geometry/VectorTextLayoutOptions.md#fontweight) · `number` · Optional
 
   Actual static or variable weight, 1–1000; defaults to the prepared face's static weight.
 
-- [`letterSpacing`](VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
+- [`letterSpacing`](../geometry/VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
 
   Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
@@ -179,8 +179,14 @@ Serialize visible horizontal or circular outlines as bounded path-only SVG in ph
 
 ## Related APIs
 
-- [VectorTextLayout](VectorTextLayout.md)
-- [VectorTextLayoutOptions](VectorTextLayoutOptions.md)
-- [VectorTextMetrics](VectorTextMetrics.md)
+- [VectorTextLayout](../geometry/VectorTextLayout.md)
+- [VectorTextLayoutOptions](../geometry/VectorTextLayoutOptions.md)
+- [VectorTextMetrics](../geometry/VectorTextMetrics.md)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import type { VectorFont } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.19.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.17.0`.
+## Supported imports
+
+```ts
+import type { VectorFontOptions } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -1,6 +1,6 @@
 # Font preparation
 
-Prepare bounded exact font bytes and reusable vector layouts.
+Prepare exact font bytes within limits and reuse vector layouts.
 
 Prepare fonts before modeling. TTF, OTF, and WOFF are parsed directly; WOFF2 decoding loads lazily. Supply font bytes yourself; this library never fetches fonts.
 
@@ -18,23 +18,11 @@ 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
 
 | API | Summary |
 | --- | --- |
-| [MAX_VECTOR_FONT_BYTES](../MAX_VECTOR_FONT_BYTES.md) | Limits apply before parsing or shaping untrusted font data. |
+| [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.17.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -43,4 +43,10 @@ async function prepareLabel(fontBytes: Uint8Array) {
 - [VectorFont](VectorFont.md)
 - [VectorFontOptions](VectorFontOptions.md)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { prepareVectorFont } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/text.md

@@ -2,9 +2,9 @@
 
 Prepare exact font bytes and shape reusable vector layouts before entering synchronous modeling.
 
-Install `fontkit` for font preparation and `woff2-encoder` for WOFF2 decoding. Import optional exact-font preparation from `@metamesh/modeling/text`.
+Use the optional `@metamesh/modeling/text` entry point to prepare exact font bytes and reusable vector layouts. Install `fontkit` for font preparation and `woff2-encoder` for WOFF2 decoding.
 
-Supply font bytes yourself; this entry point never fetches fonts. Shape once during preparation and pass the immutable layout to modeling.
+Supply font bytes yourself; this entry point never fetches fonts. Shape text once during preparation, then pass the immutable layout to modeling.
 
 ```ts
 import { prepareVectorFont } from "@metamesh/modeling/text";
@@ -18,6 +18,6 @@ Paths and metrics use Y-up millimetres and a baseline origin. Empty layouts can
 
 ## Categories
 
-- [Font preparation](text/categories/font-preparation.md) — Prepare bounded exact font bytes and reusable vector layouts.
+- [Font preparation](text/categories/font-preparation.md) — Prepare exact font bytes within limits and reuse vector layouts.
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.0`.

package/dist/engine/execution.js

@@ -3,12 +3,12 @@ import { analyzeTriangleMesh, } from "../geometry/mesh/mesh.js";
 import { assertMeshAllocationWithinLimits } from "../geometry/model-limits.js";
 import { assertSamplingCount } from "../geometry/sampling-limits.js";
 import { createSectionHandle, createSolidHandle } from "../model/shape-handles.js";
-import { createModelingContext } from "./modeling-context.js";
 import { ownScopedManifoldValue, scopedManifoldScope, trackScopedManifoldValue, } from "./native/context.js";
 import { copiedFloat32Array, copiedUint32Array } from "./native/copied-views.js";
 import * as kernel from "./native/index.js";
 import { solidMaterialComponents } from "./native/material-components.js";
 import { assertNativeSolidStatus } from "./native/status.js";
+import { createModelingContext } from "./operations/context.js";
 import { createShapeAnchorOwner } from "./shape-anchors.js";
 /** Internal execution owner; no native value or constructor crosses the public facade. */
 export function createExecutionContext(module, scope, limits, initialResolution = {}) {
@@ -101,8 +101,10 @@ export function createExecutionContext(module, scope, limits, initialResolution
         const bounds = native.boundingBox();
         const components = solidComponentsFor(handle);
         const facts = Object.freeze({
-            min: Object.freeze([...bounds.min]),
-            max: Object.freeze([...bounds.max]),
+            bounds: Object.freeze({
+                min: Object.freeze([...bounds.min]),
+                max: Object.freeze([...bounds.max]),
+            }),
             isEmpty: native.isEmpty(),
             componentCount: components.length,
             volume: native.volume(),
@@ -121,8 +123,10 @@ export function createExecutionContext(module, scope, limits, initialResolution
         const empty = native.isEmpty();
         const components = sectionComponentsFor(handle);
         const facts = Object.freeze({
-            min: Object.freeze([...bounds.min]),
-            max: Object.freeze([...bounds.max]),
+            bounds: Object.freeze({
+                min: Object.freeze([...bounds.min]),
+                max: Object.freeze([...bounds.max]),
+            }),
             isEmpty: empty,
             area: native.area(),
             contourCount: native.numContour(),
@@ -166,7 +170,7 @@ export function createExecutionContext(module, scope, limits, initialResolution
         assertMeshAllocationWithinLimits(vertices, triangles, bytes, operation, limits);
     };
     const copyNativeMesh = (native) => {
-        assertNativeSolidStatus(native, "toTriangleMesh");
+        assertNativeSolidStatus(native, "toMesh");
         const raw = native.getMesh();
         assertMeshAllocation(raw.numVert, raw.numTri, (raw.numVert + raw.numTri) * 12, "copyMesh");
         const positions = copiedFloat32Array(raw.numVert * 3);

package/dist/engine/finalization.js

@@ -1,16 +1,10 @@
 import { GeometryError } from "../geometry/errors.js";
+import { immutableMeshView } from "../geometry/immutable-buffer.js";
 import { optimizePlanarPatches } from "../geometry/mesh/mesh-planar.js";
 import { validateAnalyzedSolidMesh } from "../geometry/mesh/mesh-solid.js";
+import { MeshViewCache } from "../geometry/mesh/mesh-view-cache.js";
 import { analyzeTriangleMesh, } from "../geometry/mesh/mesh.js";
-import { immutableMeshView } from "../model/immutable-buffer.js";
-import { MeshViewCache } from "./mesh-view-cache.js";
 import { copiedMeshViews, copiedUint32Array } from "./native/copied-views.js";
-const isArray = (value) => Array.isArray(value);
-const snapshotMeshes = new WeakMap();
-/** Registers trusted snapshot storage without exposing its shared backing arrays publicly. */
-export function rememberSnapshotPart(part, mesh) {
-    snapshotMeshes.set(part, mesh);
-}
 function fitsGeometryLimits(mesh, limits) {
     const buffers = new Set([mesh.positions.buffer, mesh.indices.buffer]);
     let bytes = 0;
@@ -87,69 +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" });
-        // Access public owned-copy getters exactly once, or retain trusted private sharing for a
-        // snapshot created by this engine. Capture still copies before the asynchronous boundary.
-        const mesh = snapshotMeshes.get(part) ?? { positions: part.positions, indices: part.indices };
-        const id = part.id, color = part.color;
-        return {
-            id,
-            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,
-        ...copiedMeshViews(part, copiedBuffers),
-        ...(part.color === undefined ? {} : { color: part.color }),
-    }));
-}

package/dist/engine/index.js

@@ -1,23 +1,25 @@
 import { GeometryError } from "../geometry/errors.js";
 import { defaultModelingLimits, resolveModelingLimits } from "../geometry/model-limits.js";
 import { createExecutionContext } from "./execution.js";
-import { captureExportParts } from "./finalization.js";
 import createManifoldModule from "./kernel/manifold.js";
 import { withManifoldScope } from "./native/context.js";
-import { createSession } from "./session.js";
+import { createSession } from "./session/session.js";
 export { defaultModelingLimits };
 /** 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;
 /**
  * Runs declaration and immediate assertions without initializing a kernel or finalizing parts.
- * Geometry observations require an initialized session's `validate` method instead.
+ * 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.
  */
-export function validateModel(program, params, ...settings) {
-    const session = createSession(program, settings[0] ?? {}, defaultModelingLimits, (_options, callback) => callback(() => {
-        throw new GeometryError("INVALID_ARGUMENT", "Geometry observations require an initialized model session.", { operation: "validateModel", details: { requiresKernel: true } });
+export function checkModel(program, ...args) {
+    const [parameters, options] = args;
+    const session = createSession(program, options ?? {}, defaultModelingLimits, (_options, callback) => callback(() => {
+        throw new GeometryError("INVALID_ARGUMENT", "Geometry observations require an initialized model session.", { operation: "checkModel", details: { requiresKernel: true } });
     }));
     try {
-        return session.validate(params);
+        return session.check(...[parameters]);
     }
     finally {
         session.dispose();
@@ -26,20 +28,16 @@ export function validateModel(program, params, ...settings) {
 /** Serializes operations over one initialized kernel; sessions own their caches. */
 function engineFromModule(module, engineLimits) {
     let building = false;
-    return Object.freeze({
+    const engine = Object.freeze({
         limits: engineLimits,
-        async export3mf(parts, options = {}) {
-            if (building)
-                throw new GeometryError("INVALID_ARGUMENT", "An engine cannot export during another operation.", { operation: "export3mf" });
-            const snapshot = captureExportParts(parts, engineLimits);
-            const snapshotOptions = { ...options };
-            building = true;
+        run(program, ...args) {
+            const [parameters, options] = args;
+            const session = createSessionForRun(program, { ...options, cache: false });
             try {
-                const { meshesTo3mf } = await import("./export-3mf.js");
-                return meshesTo3mf(snapshot, snapshotOptions);
+                return session.run(...[parameters]);
             }
             finally {
-                building = false;
+                session.dispose();
             }
         },
         createSession(program, ...settings) {
@@ -51,8 +49,8 @@ function engineFromModule(module, engineLimits) {
                 const limits = resolveModelingLimits(options.limits, engineLimits);
                 building = true;
                 try {
-                    // The trusted finalizer captures only copied manufacturing buffers. Its snapshot has
-                    // owned-copy accessors, so publish it after the native scope's structural escape check.
+                    // The trusted finalizer captures geometry outside native ownership. Publish its
+                    // immutable storage only after the native scope's structural escape check.
                     let captured;
                     withManifoldScope(module, (scope) => {
                         let execution;
@@ -71,6 +69,10 @@ function engineFromModule(module, engineLimits) {
             });
         },
     });
+    return engine;
+    function createSessionForRun(program, options) {
+        return engine.createSession(program, ...[options]);
+    }
 }
 /**
  * Initializes one host kernel and returns a lifecycle-safe engine. No generator initializes WASM.
@@ -79,20 +81,12 @@ function engineFromModule(module, engineLimits) {
  * ```ts
  * import { box, generate } from "@metamesh/modeling";
  * 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] }))]);
- * const session = engine.createSession(model);
- * try {
- *   const snapshot = session.run({});
- *   try {
- *     await engine.export3mf(snapshot.parts);
- *   } finally {
- *     snapshot.dispose();
- *   }
- * } finally {
- *   session.dispose();
- * }
+ * const result = engine.run(model);
+ * await export3mf(result.parts);
  * ```
  */
 export async function createModelEngine(options = {}) {

package/dist/engine/model-parts.js

@@ -0,0 +1,8 @@
+import { GeometryError } from "../geometry/errors.js";
+/** Resolves an exact semantic ID without changing output order or retaining another index. */
+export function requireModelPart(parts, id) {
+    const part = parts.find((part) => part.id === id);
+    if (part !== undefined)
+        return part;
+    throw new GeometryError("INVALID_ARGUMENT", `Model has no part ${JSON.stringify(id)}. Available parts: ${parts.map((part) => part.id).join(", ")}.`, { operation: "part", details: { partId: id } });
+}

package/dist/engine/model-summary.js

@@ -1,7 +1,7 @@
 import { GeometryError } from "../geometry/errors.js";
 /** Counts manufacturing instances while charging shared backing storage only once. */
 export function createModelSummary(limits) {
-    let vertices = 0, triangles = 0, bytes = 0, partCount = 0, volumeMm3 = 0;
+    let vertices = 0, triangles = 0, bytes = 0, partCount = 0, signedVolume = 0;
     const storage = new Set();
     const min = [Infinity, Infinity, Infinity], max = [-Infinity, -Infinity, -Infinity];
     return {
@@ -10,7 +10,7 @@ export function createModelSummary(limits) {
             const measurements = geometry.measurements;
             vertices += measurements.vertexCount;
             triangles += measurements.triangleCount;
-            volumeMm3 += measurements.signedVolume;
+            signedVolume += measurements.signedVolume;
             for (const buffer of [geometry.positions.buffer, geometry.indices.buffer])
                 if (!storage.has(buffer)) {
                     storage.add(buffer);
@@ -35,10 +35,10 @@ export function createModelSummary(limits) {
                     vertexCount: vertices,
                     triangleCount: triangles,
                     byteCount: bytes,
-                    volumeMm3,
+                    signedVolume,
                     buildMs: builtAt - startedAt,
-                    finalizationMs: endedAt - builtAt,
-                    generationMs: endedAt - startedAt,
+                    finalizeMs: endedAt - builtAt,
+                    generateMs: endedAt - startedAt,
                 }),
             };
         },

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

@@ -0,0 +1,41 @@
+import { GeometryError } from "../../geometry/errors.js";
+import { assertMeshAllocationWithinLimits, } from "../../geometry/model-limits.js";
+import { ownScopedManifoldValue, scopedManifoldModule, } from "./context.js";
+import { assertNativeSolidStatus } from "./status.js";
+/** Builds new native geometry with retained Double construction coordinates and proxy topology. */
+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 (![0, 1, 2].every((axis) => Number.isFinite(mesh.nativePositions[index + axis])))
+            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 &&
+            [0, 1, 2].some((axis) => mesh.nativePositions[prior + axis] !== mesh.nativePositions[index + axis]))
+            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.");
+            positions.set(mesh.nativePositions.subarray(source, source + 3), offset);
+        }
+    }));
+    assertNativeSolidStatus(result, operation);
+    return result;
+}

package/dist/engine/native/index.js

@@ -5,7 +5,7 @@
  */
 export { createScopedManifoldContext, withManifoldScope, } from "./context.js";
 export { box, cylinder, sphere, torus, tube, } from "./scoped-primitives.js";
-export { compose, hull, intersect, minkowskiSum, subtract, union, } from "./operations.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 {} from "./threads.js";