@metamesh/modeling 0.16.0 → 0.18.0

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

@@ -22,10 +22,6 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 
 **`options`** · [`ThreadedNutOptions`](ThreadedNutOptions.md) · Required
 
-- [`profile`](ThreadedNutOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
-
-  Validated periodic profile repeated around the shaft.
-
 - [`nominalMajorDiameter`](ThreadedNutOptions.md#nominalmajordiameter) · `number` · Required
 
   Nominal major diameter before female compensation and faceting correction.
@@ -42,6 +38,27 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 
   Across-flats width for hex/square or diameter for round, in millimetres.
 
+- [`profile`](ThreadedNutOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+
+  Validated periodic profile repeated around the shaft.
+
+- [`fit`](ThreadedNutOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
+
+  Printable fit or caller-calibrated allowances. Default: `normal`.
+
+- [`innerBevel`](ThreadedNutOptions.md#innerbevel) · [`Bevel`](Bevel.md) · Optional
+
+  Opening bevels in [bottom, top] order. Omitted or auto uses min(profile.depth, thickness/4); zero disables.
+
+- [`outerBevel`](ThreadedNutOptions.md#outerbevel) · [`Bevel`](Bevel.md) · Optional
+
+  Body bevels in [bottom, top] order. Omitted or auto uses min(profile.depth, thickness/4).
+  Use [0, "auto"] to keep the outside bottom flat without disabling its inner opening bevel.
+
+- [`bodyResolution`](ThreadedNutOptions.md#bodyresolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Optional physical policy for a round body, independent of the thread's matched facet grid.
+
 - [`ends`](ThreadedNutOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
 
   Optional bottom/top ridge-end treatments. Standalone ridges honor the requested boundaries;
@@ -71,26 +88,6 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 
   Optional numerical tolerance overrides.
 
-- [`fit`](ThreadedNutOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
-
-  Printable fit or caller-calibrated allowances. Default: `normal`.
-
-- [`bevel`](ThreadedNutOptions.md#bevel) · [`ThreadedNutBevel`](ThreadedNutBevel.md) · Optional
-
-  Nut body bevel selection. Default: `automatic`.
-
-- [`bodyResolution`](ThreadedNutOptions.md#bodyresolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
-
-  Optional physical policy for a round body, independent of the thread's matched facet grid.
-
-- [`chamferSize`](ThreadedNutOptions.md#chamfersize) · `number` · Optional
-
-  45-degree body chamfer extent. Default: `min(profile.depth, thickness/4)`.
-
-- [`flushBuildPlateBottom`](ThreadedNutOptions.md#flushbuildplatebottom) · `boolean` · Optional
-
-  Leave the bottom outside edge flat for build-plate adhesion. Default: `false`.
-
 
 
 ## Returns
@@ -108,4 +105,4 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 - [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -22,6 +22,10 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 
 **`options`** · [`ThreadedRodOptions`](ThreadedRodOptions.md) · Required
 
+- [`nominalMajorDiameter`](ThreadedRodOptions.md#nominalmajordiameter) · `number` · Required
+
+  Nominal major diameter before male compensation.
+
 - [`length`](ThreadedRodOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
@@ -30,9 +34,14 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 
   Validated periodic profile repeated around the shaft.
 
-- [`nominalMajorDiameter`](ThreadedRodOptions.md#nominalmajordiameter) · `number` · Required
+- [`bevel`](ThreadedRodOptions.md#bevel) · [`Bevel`](Bevel.md) · Optional
 
-  Nominal major diameter before male compensation.
+  Bottom/top sizes in millimetres. Omitted disables both. Auto uses profile depth for standard/tapered ends,
+  or one sixth of the compensated male minor/female major radius for blunt ends.
+
+- [`fit`](ThreadedRodOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
+
+  Printable fit or caller-calibrated allowances. Default: `normal`.
 
 - [`ends`](ThreadedRodOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
 
@@ -63,23 +72,6 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 
   Optional numerical tolerance overrides.
 
-- [`bevelBottom`](ThreadedRodOptions.md#bevelbottom) · `boolean` · Optional
-
-  Apply a 45-degree bevel at Z=0.
-
-- [`bevelSize`](ThreadedRodOptions.md#bevelsize) · `number` · Optional
-
-  Axial bevel extent in millimetres. Active blunt ends default to one sixth of the compensated
-  male minor radius or female major radius; other ends default to the profile depth.
-
-- [`bevelTop`](ThreadedRodOptions.md#beveltop) · `boolean` · Optional
-
-  Apply a 45-degree bevel at Z=length.
-
-- [`fit`](ThreadedRodOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
-
-  Printable fit or caller-calibrated allowances. Default: `normal`.
-
 
 
 ## Returns
@@ -97,4 +89,4 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 - [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -67,4 +67,4 @@ torus({ majorRadius: 12, minorRadius: 3 });
 - [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -43,4 +43,4 @@ Use `toData()` for frozen matrix interchange.
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 - [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -45,4 +45,4 @@ Use `toData()` for frozen matrix interchange.
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 - [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -22,41 +22,6 @@ tube({ height: 20, outerRadius: 10, innerRadius: 6 });
 
 **`options`** · [`TubeOptions`](TubeOptions.md) · Required
 
-- [`height`](TubeOptions.md#height) · `number` · Required
-
-  Total height along Z in millimetres.
-
-- [`innerRadius`](TubeOptions.md#innerradius) · `number` · Required
-
-  Positive inner radius in millimetres.
-
-- [`outerRadius`](TubeOptions.md#outerradius) · `number` · Required
-
-  Outer radius in millimetres; greater than [TubeOptions.innerRadius](TubeOptions.md#innerradius).
-
-- [`limits`](TubeOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
-
-  Explicit sampling ceilings; bound modeling operations may only lower the host policy.
-
-- [`segments`](TubeOptions.md#segments) · `number` · Optional
-
-  Exact circumferential segment count from three through the configured safety limit.
-
-  This local topology override takes precedence over [CircularPrimitiveOptions.resolution](CircularPrimitiveOptions.md#resolution)
-  and any active model-wide resolution policy.
-
-- [`resolution`](TubeOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
-
-  Operation-level physical tessellation policy over the active model-wide policy.
-
-- [`attachment`](TubeOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
-
-  Applied after local construction; Section attachment must preserve the XY plane.
-
-- [`center`](TubeOptions.md#center) · `boolean` · Optional · Default: `true`
-
-  Centers the tube on the Z origin when `true`; otherwise its bottom is at `Z = 0`.
-
 
 
 ## Returns
@@ -74,4 +39,4 @@ tube({ height: 20, outerRadius: 10, innerRadius: 6 });
 - [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -1,6 +1,6 @@
 # union
 
-Robust union.
+Robust union of one or more shapes; empty input rejects during declaration.
 
 ## Call Signature
 
@@ -22,7 +22,7 @@ union([block, cap]);
 
 
 
-Robust union.
+Robust union of one or more shapes; empty input rejects during declaration.
 
 ### Parameters
 
@@ -69,4 +69,4 @@ Native filled section union; dimensions cannot be mixed.
 - [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)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -37,4 +37,4 @@ Use `toData()` for frozen tuple interchange, or
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 - [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -44,4 +44,4 @@ Use `toData()` for frozen tuple interchange, or
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 - [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model.md

@@ -2,46 +2,42 @@
 
 Immutable shapes, vectors and transforms with fluent operations and host-owned geometry evaluation.
 
-Import `generate`, shape constructors, vectors, transforms and collection functions from `@metamesh/modeling`. Chain shape methods to transform, subtract, and finish immutable recipes; a host session owns execution and optional computed caches.
+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.
 
 ```ts
 import { box, cylinder, generate } from "@metamesh/modeling";
 import { createModelEngine } from "@metamesh/modeling/engine";
-const model = generate<Record<never, never>>(({ part }) => [part("plate", box({ size: [30, 20, 6] }).subtract([cylinder({ radius: 3, height: 8 })]))]);
+const model = generate<Record<never, never>>(({ part }) => [part("plate", box({ size: [30, 20, 6] }).subtract(cylinder({ radius: 3, height: 8 })))]);
 const engine = await createModelEngine();
-const session = engine.createSession(model);
-const snapshot = session.run({});
-snapshot.dispose();
-session.dispose();
+const result = engine.run(model);
 ```
 
-Computed data and recipes reuse unchanged work. Part placement and color are separate from local geometry. Section recipes preserve holes through Boolean and offset chains.
+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.
 
 - **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.
-- **Observation:** synchronous host execution is required. Observed component selections stay restricted to their originating session.
-- **Ownership:** the current transaction owns temporary native allocations; sessions may retain bounded evaluated geometry privately. Copied snapshots remain valid after session disposal until you dispose them.
+- **Observation:** call `shape.inspect()`, `shape.isEmpty()`, `shape.components()`, or `shape.anchor(name)` during synchronous host execution. Solids also expose `distance`, `castSegment`, `split`, `splitByPlane`, and `toMesh` methods. Observed component selections stay restricted to their originating session.
+- **Ownership:** the current transaction owns temporary native allocations; sessions may keep evaluated geometry in bounded private caches. Both run methods return durable immutable results without disposal; sessions alone own cache and native-resource lifetimes.
 
 See [host lifecycle](engine.md) and [pure foundations](geometry.md).
 
 ## Categories
 
-- [Primitives](model/categories/primitives.md) — Create foundational solid geometry and configure its dimensions and tessellation.
+- [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) — Reusable immutable planar and spatial trajectories.
+- [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 arrange geometry with explicit placement contracts.
+- [Transforms, vectors, and placement](model/categories/transforms-placement.md) — Calculate with immutable vectors, reuse transforms, and position geometry.
 - [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 inspect stable section or solid measurements.
-- [Core values](model/categories/core-values-errors.md) — Use shared coordinate, path, polygon, and bounds data.
-- [Bounds](model/categories/bounds.md) — Measure immutable axis-aligned extents and test positioned containment.
+- [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.
-- [Solid inspection](model/categories/inspection.md) — Evaluate recipes and copy observations while the host owns native resources.
-- [Model generation](model/categories/generation.md) — Declare typed programs, optional computations, semantic parts and structured diagnostics.
-- [Model contracts](model/categories/contracts.md) — Describe opaque handles, dimensions, manufacturing parts, and completed snapshots.
+- [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -31,4 +31,4 @@ Inclusive minimum X/Y coordinates.
 
 - [Vector2Data](Vector2Data.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -1,7 +1,7 @@
 # MAX_VECTOR_FONT_BYTES
 
-Limits apply before parsing or shaping untrusted font data.
+Maximum input font size in bytes, checked before parsing or shaping untrusted font data.
 
 `const` **MAX\_VECTOR\_FONT\_BYTES**: `number`
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -4,4 +4,4 @@ A two-dimensional Cartesian vector or point.
 
 **Vector2Data** = readonly \[`x`: `number`, `y`: `number`\]
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -183,4 +183,4 @@ Serialize visible horizontal or circular outlines as bounded path-only SVG in ph
 - [VectorTextLayoutOptions](VectorTextLayoutOptions.md)
 - [VectorTextMetrics](VectorTextMetrics.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -14,4 +14,4 @@ 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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -50,4 +50,4 @@ Alignment datum in degrees counterclockwise from +X; defaults to 90.
 
 Reading direction around the circle; defaults to clockwise.
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -31,4 +31,4 @@ Exact measurements of these paths and their logical text layout.
 
 - [VectorTextMetrics](VectorTextMetrics.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -108,4 +108,4 @@ Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 - [VectorTextArcBaseline](VectorTextArcBaseline.md)
 - [VectorTextOptions](VectorTextOptions.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -91,4 +91,4 @@ Number of lines, including empty and trailing lines; empty text occupies one lin
 
 - [Bounds2Data](Bounds2Data.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -47,4 +47,4 @@ Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
 - [VectorTextLayoutOptions](VectorTextLayoutOptions.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.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.
 
@@ -35,6 +35,6 @@ Layout returns immutable paths and metrics in Y-up millimetres. Pass the prepare
 
 | 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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -43,4 +43,4 @@ async function prepareLabel(fontBytes: Uint8Array) {
 - [VectorFont](VectorFont.md)
 - [VectorFontOptions](VectorFontOptions.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.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.16.0`.
+Package: `@metamesh/modeling@0.18.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/export-3mf.js

@@ -1,116 +1,23 @@
-import { Zip, ZipDeflate } from "fflate";
-import { GeometryError } from "../geometry/errors.js";
-import { analyzeSolidMesh } from "../geometry/mesh/mesh-solid.js";
-import { analyzeTriangleMesh } from "../geometry/mesh/mesh.js";
-import { MeshViewCache } from "./mesh-view-cache.js";
-const namespace = "http://schemas.microsoft.com/3dmanufacturing/core/2015/02";
-const declaration = '<?xml version="1.0" encoding="UTF-8"?>';
-const encoder = new TextEncoder();
-const escapeXml = (value) => value.replace(/[&<>"']/g, (character) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&apos;" })[character]);
-/** Private core 3MF serializer. It preserves the selected buffers and streams bounded XML chunks. */
-export function meshesTo3mf(parts, options) {
-    if (options.meshValidation !== undefined &&
-        options.meshValidation !== "topology" &&
-        options.meshValidation !== "solid")
-        throw new GeometryError("INVALID_ARGUMENT", "Unsupported mesh validation mode.", {
-            operation: "export3mf",
-        });
-    const name = options.name ?? "MetaMesh model";
-    if (typeof name !== "string" ||
-        name.length === 0 ||
-        name.length > 1024 ||
-        // eslint-disable-next-line no-control-regex -- XML 1.0 disallows these control characters.
-        /[\u0000-\u0008\u000b\u000c\u000e-\u001f\ud800-\udfff\ufffe\uffff]/u.test(name))
-        throw new GeometryError("INVALID_ARGUMENT", "3MF names require one through 1024 valid XML characters.", { operation: "export3mf" });
-    const analyzed = new MeshViewCache();
-    for (const part of parts) {
-        let facts = analyzed.get(part);
-        if (facts !== undefined)
-            continue;
-        facts =
-            options.meshValidation === "solid"
-                ? analyzeSolidMesh(part)
-                : analyzeTriangleMesh(part, { requireClosed: true, includeTopology: true });
-        if (!(facts.signedVolume > 0) || facts.vertexCount >= 2 ** 31 || facts.triangleCount >= 2 ** 31)
-            throw new GeometryError("INVALID_TOPOLOGY", "3MF parts require positive oriented volume and valid core resource counts.", { operation: "export3mf" });
-        analyzed.set(part, facts);
-    }
-    const chunks = [];
-    let bytes = 0, complete = false;
-    const zip = new Zip((error, data, final) => {
-        if (error !== null)
-            throw error;
-        bytes += data.byteLength;
-        if (bytes >= 0xffffffff)
-            throw new GeometryError("COMPLEXITY_LIMIT", "3MF ZIP output exceeds its 32-bit container limit.", { operation: "export3mf" });
-        chunks.push(data);
-        complete = final;
-    });
-    const add = (path) => {
-        const file = new ZipDeflate(path, { level: 6 });
-        file.mtime = new Date(1980, 0, 1);
-        zip.add(file);
-        return file;
-    };
-    const addText = (path, contents) => add(path).push(encoder.encode(contents), true);
-    try {
-        addText("[Content_Types].xml", `${declaration}<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="model" ContentType="application/vnd.ms-package.3dmanufacturing-3dmodel+xml"/></Types>`);
-        addText("_rels/.rels", `${declaration}<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Target="/3D/3dmodel.model" Id="model" Type="http://schemas.microsoft.com/3dmanufacturing/2013/01/3dmodel"/></Relationships>`);
-        const model = add("3D/3dmodel.model");
-        let xml = "", xmlBytes = 0;
-        const flush = (final = false) => {
-            const data = encoder.encode(xml);
-            xmlBytes += data.byteLength;
-            if (xmlBytes >= 0xffffffff)
-                throw new GeometryError("COMPLEXITY_LIMIT", "3MF model XML exceeds its 32-bit ZIP entry limit.", { operation: "export3mf" });
-            model.push(data, final);
-            xml = "";
-        };
-        const append = (value) => {
-            xml += value;
-            if (xml.length >= 32_768)
-                flush();
-        };
-        append(`${declaration}<model unit="millimeter" xml:lang="en-US" xmlns="${namespace}"><metadata name="Application">MetaMesh Modeling</metadata><metadata name="Title">${escapeXml(name)}</metadata><resources>`);
-        const colors = new Map();
-        for (const part of parts)
-            if (part.color !== undefined && !colors.has(part.color.toLowerCase()))
-                colors.set(part.color.toLowerCase(), colors.size);
-        const materialId = parts.length + 1;
-        if (colors.size) {
-            append(`<basematerials id="${materialId}">`);
-            for (const color of colors.keys())
-                append(`<base name="Color ${color.slice(1)}" displaycolor="${color.toUpperCase()}FF"/>`);
-            append("</basematerials>");
-        }
-        parts.forEach((part, index) => {
-            const material = part.color === undefined
-                ? ""
-                : ` pid="${materialId}" pindex="${colors.get(part.color.toLowerCase())}"`;
-            append(`<object id="${index + 1}" name="${escapeXml(part.id)}" partnumber="${escapeXml(part.id)}" type="model"${material}><mesh><vertices>`);
-            for (let offset = 0; offset < part.positions.length; offset += 3)
-                append(`<vertex x="${part.positions[offset]}" y="${part.positions[offset + 1]}" z="${part.positions[offset + 2]}"/>`);
-            append("</vertices><triangles>");
-            for (let offset = 0; offset < part.indices.length; offset += 3)
-                append(`<triangle v1="${part.indices[offset]}" v2="${part.indices[offset + 1]}" v3="${part.indices[offset + 2]}"/>`);
-            append("</triangles></mesh></object>");
-        });
-        append("</resources><build>");
-        parts.forEach((_, index) => append(`<item objectid="${index + 1}"/>`));
-        append("</build></model>");
-        flush(true);
-        zip.end();
-        if (!complete)
-            throw new Error("The synchronous 3MF compressor did not complete.");
-        const result = new Uint8Array(bytes);
-        let offset = 0;
-        for (const chunk of chunks) {
-            result.set(chunk, offset);
-            offset += chunk.byteLength;
-        }
-        return result.buffer;
-    }
-    finally {
-        zip.terminate();
-    }
+import { resolveModelingLimits } from "../geometry/model-limits.js";
+import { captureExportParts } from "./finalization.js";
+/**
+ * Serializes captured manufacturing meshes as millimetre 3MF without initializing an engine.
+ * Captures input arrays and options before awaiting; later mutations, runs and session cleanup
+ * cannot change the exported geometry. Trusted limits default to the package output ceilings.
+ *
+ * @example Export a pure mesh without an engine
+ * ```ts
+ * import { export3mf } from "@metamesh/modeling/engine";
+ * import * as mesh from "@metamesh/modeling/geometry/mesh";
+ * import { rectangleContour } from "@metamesh/modeling/geometry";
+ * const plate = mesh.extrude(rectangleContour({ size: [30, 20] }), { height: 6 });
+ * const bytes = await export3mf([{ id: "plate", ...plate }], { name: "Plate" });
+ * ```
+ */
+export async function export3mf(parts, options = {}) {
+    const limits = resolveModelingLimits(options.limits);
+    const captured = captureExportParts(parts, limits);
+    const settings = { ...options };
+    const { meshesTo3mf } = await import("./serialize-3mf.js");
+    return meshesTo3mf(captured, settings);
 }