@metamesh/modeling 0.17.0 → 0.18.0

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

@@ -2,7 +2,7 @@
 
 Helical ridge mesh construction.
 
-**threadRidge**(`options`: [`HelicalThreadRidgeMeshOptions`](HelicalThreadRidgeMeshOptions.md)): [`Solid`](Solid.md)
+**threadRidge**(`options`: [`ThreadRidgeOptions`](ThreadRidgeOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -10,46 +10,46 @@ Helical ridge mesh construction.
 
 <a id="options"></a>
 
-**`options`** · [`HelicalThreadRidgeMeshOptions`](HelicalThreadRidgeMeshOptions.md) · Required
+**`options`** · [`ThreadRidgeOptions`](ThreadRidgeOptions.md) · Required
 
-- [`length`](HelicalThreadRidgeMeshOptions.md#length) · `number` · Required
+- [`length`](ThreadRidgeOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
 
-- [`majorDiameter`](HelicalThreadRidgeMeshOptions.md#majordiameter) · `number` · Required
+- [`majorDiameter`](ThreadRidgeOptions.md#majordiameter) · `number` · Required
 
   Nominal major diameter before any caller-owned fit compensation.
 
-- [`profile`](HelicalThreadRidgeMeshOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+- [`profile`](ThreadRidgeOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
-- [`ends`](HelicalThreadRidgeMeshOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
+- [`ends`](ThreadRidgeOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
 
   Optional bottom/top ridge-end treatments. Standalone ridges honor the requested boundaries;
   BOSL2-style non-cut lead-in scaling is available on complete thread solids.
 
-- [`handedness`](HelicalThreadRidgeMeshOptions.md#handedness) · [`ThreadHandedness`](ThreadHandedness.md) · Optional
+- [`handedness`](ThreadRidgeOptions.md#handedness) · [`ThreadHandedness`](ThreadHandedness.md) · Optional
 
   Helix direction. Default: `right`.
 
-- [`limits`](HelicalThreadRidgeMeshOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+- [`limits`](ThreadRidgeOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
 
   Explicit output and circular allocation ceilings.
 
-- [`phase`](HelicalThreadRidgeMeshOptions.md#phase) · `number` · Optional
+- [`phase`](ThreadRidgeOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
-- [`resolution`](HelicalThreadRidgeMeshOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](ThreadRidgeOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
 
   Optional circular-resolution policy.
 
-- [`starts`](HelicalThreadRidgeMeshOptions.md#starts) · `number` · Optional
+- [`starts`](ThreadRidgeOptions.md#starts) · `number` · Optional
 
   Number of evenly phased starts. Default: `1`.
 
-- [`tolerance`](HelicalThreadRidgeMeshOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+- [`tolerance`](ThreadRidgeOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
 
   Optional numerical tolerance overrides.
 
@@ -62,12 +62,12 @@ Helical ridge mesh construction.
 
 ## Related APIs
 
-- [HelicalThreadRidgeMeshOptions](HelicalThreadRidgeMeshOptions.md)
 - [Solid](Solid.md)
+- [ThreadRidgeOptions](ThreadRidgeOptions.md)
 
 ## Guides
 
 - [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.17.0`.
+Package: `@metamesh/modeling@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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -30,7 +30,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) · `"center"` \| `"left"` \| `"right"` · Optional
+- [`align`](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.
 
@@ -42,7 +42,7 @@ Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and sup
 
   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`](VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
 
   Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
 
@@ -88,7 +88,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) · `"center"` \| `"left"` \| `"right"` · Optional
+- [`align`](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.
 
@@ -100,7 +100,7 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
 
   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`](VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
 
   Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
 
@@ -146,7 +146,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) · `"center"` \| `"left"` \| `"right"` · Optional
+- [`align`](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.
 
@@ -158,7 +158,7 @@ Serialize visible horizontal or circular outlines as bounded path-only SVG in ph
 
   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`](VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
 
   Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
 
@@ -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.17.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.17.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.17.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.17.0`.
+Package: `@metamesh/modeling@0.18.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?**: `"center"` \| `"left"` \| `"right"`
+`readonly` `optional` **align?**: `"left"` \| `"right"` \| `"center"`
 
 
 
@@ -48,7 +48,7 @@ Baseline spacing in ems, 0.5–5; omitted uses the selected face's natural verti
 
 
 
-`readonly` `optional` **verticalAlign?**: `"center"` \| `"top"` \| `"bottom"` \| `"baseline"`
+`readonly` `optional` **verticalAlign?**: `"top"` \| `"bottom"` \| `"center"` \| `"baseline"`
 
 
 
@@ -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.17.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.17.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.17.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.17.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.17.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.17.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);