@metamesh/modeling 0.15.0 → 0.16.0

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

@@ -1,11 +1,15 @@
 # preflightThreadedRod
 
-External-thread facts using host resolution and limits; requires active synchronous model execution.
+Checks compensated rod dimensions and conservative mesh estimates against host output limits.
 
 **preflightThreadedRod**(`options`: [`ThreadedRodOptions`](ThreadedRodOptions.md)): [`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
 
 
 
+Requires active synchronous model execution and uses its resolution and limits. Returns selected
+sampling and conservative row/triangle estimates without mesh buffers or native objects.
+Mesh validity, native construction, and aggregate output limits are checked later.
+
 ## Parameters
 
 <a id="options"></a>
@@ -81,9 +85,11 @@ External-thread facts using host resolution and limits; requires active synchron
 
 - [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
 - [ThreadedRodOptions](ThreadedRodOptions.md)
+- [threadedRod](threadedRod.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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -77,5 +77,6 @@ readonly [`Section`](Section.md)[]
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -12,13 +12,16 @@ Filled rectangular section with uniform or independently treated corners.
 rectangle({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 ```
 
+Use [rectangleContour](../geometry/rectangleContour.md) for sampled boundary coordinates,
+or [rectangleProfile](../geometry/rectangleProfile.md) to retain identified loft landmarks.
+
 ## Parameters
 
 <a id="options"></a>
 
 **`options`** · [`RectangleOptions`](RectangleOptions.md) · Required
 
-- [`size`](RectangleOptions.md#size) · `number` \| [`Vector2Tuple`](Vector2Tuple.md) · Required
+- [`size`](RectangleOptions.md#size) · `number` \| [`Vector2Data`](Vector2Data.md) · Required
 
   Positive uniform size or explicit XY extents in millimetres.
 
@@ -56,4 +59,4 @@ rectangle({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -36,4 +36,4 @@ regularPolygon({ radius: 10, sides: 6, sizing: "face" });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -72,4 +72,4 @@ revolve(profile!, { degrees: 270 });
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -39,4 +39,4 @@ solidFromMesh(mesh);
 
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -39,4 +39,4 @@ sphere({ diameter: 20 });
 - [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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -51,4 +51,4 @@ readonly \[[`Solid`](Solid.md), [`Solid`](Solid.md)\]
 - [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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -63,4 +63,4 @@ readonly \[[`Solid`](Solid.md), [`Solid`](Solid.md)\]
 - [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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -60,4 +60,4 @@ star({ outerRadius: 12, innerRadius: 6, points: 5 });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -71,4 +71,4 @@ closed paths omit the duplicated seam. Returns an immutable deferred recipe.
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -62,4 +62,4 @@ svgPathSection("M0 0H20V12H0Z", { origin: "center", scale: 1 });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -61,4 +61,4 @@ svgSection(
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -89,4 +89,4 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -54,4 +54,4 @@ function labelSection(layout: VectorTextLayout) {
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -68,5 +68,6 @@ Helical ridge mesh construction.
 ## 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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -106,5 +106,6 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 ## 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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -95,5 +95,6 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 ## 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.15.0`.
+Package: `@metamesh/modeling@0.16.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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,8 +1,8 @@
 # transform2
 
-Creates an immutable XY transform, identity by default. Matrices are copied and validated. Pass it directly to Section.transform() and planar data helpers; to3D() explicitly crosses into XYZ. Zero scales and singular matrices throw GeometryError; negative scales reflect.
+Creates an immutable XY transform, identity by default.
 
-**transform2**(`matrix?`: [`Transform2Matrix`](Transform2Matrix.md)): [`Transform2`](Transform2-type.md)
+**transform2**(`input?`: [`Transform2Input`](Transform2Input.md)): [`Transform2`](Transform2-type.md)
 
 
 
@@ -10,14 +10,20 @@ Creates an immutable XY transform, identity by default. Matrices are copied and
 
 ```ts
 const placement = transform2().rotate(90).translate([10, 0]);
-placement.applyPoint([1, 0]).toArray(); // approximately [10, 1]
+placement.applyPoint([1, 0]).toData(); // approximately [10, 1]
 ```
 
+Values and data are copied and validated.
+Pass it directly to Section.transform() and planar data helpers; to3D() explicitly crosses into XYZ.
+Zero scales and singular matrices throw GeometryError; negative scales reflect.
+
+Use `toData()` for frozen matrix interchange.
+
 ## Parameters
 
-<a id="matrix"></a>
+<a id="input"></a>
 
-**`matrix`** · [`Transform2Matrix`](Transform2Matrix.md) · Optional
+**`input`** · [`Transform2Input`](Transform2Input.md) · Optional
 
 
 
@@ -29,11 +35,12 @@ placement.applyPoint([1, 0]).toArray(); // approximately [10, 1]
 ## Related APIs
 
 - [Transform2](Transform2-type.md)
-- [Transform2Matrix](Transform2Matrix.md)
+- [Transform2Input](Transform2Input.md)
 
 ## Guides
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,8 +1,8 @@
 # transform3
 
-Creates an immutable XYZ transform, identity by default. Matrices are copied and validated. Calls apply in written order; rotations use degrees and pivots use current world coordinates. Zero scales, singular matrices, nonfinite inputs and zero rotation axes throw GeometryError. Use frameTransform3(frame) as the input for existing orthonormal frame placement.
+Creates an immutable XYZ transform, identity by default.
 
-**transform3**(`matrix?`: [`Transform3Matrix`](Transform3Matrix.md)): [`Transform3`](Transform3-type.md)
+**transform3**(`input?`: [`Transform3Input`](Transform3Input.md)): [`Transform3`](Transform3-type.md)
 
 
 
@@ -10,14 +10,22 @@ Creates an immutable XYZ transform, identity by default. Matrices are copied and
 
 ```ts
 const placement = transform3().rotate([0, 0, 90]).translate([10, 0, 0]);
-placement.applyPoint([1, 0, 0]).toArray(); // approximately [10, 1, 0]
+placement.applyPoint([1, 0, 0]).toData(); // approximately [10, 1, 0]
 ```
 
+Values and data are copied and validated.
+Calls apply in written order; rotations use degrees and pivots use current world coordinates.
+Zero scales, singular matrices, nonfinite inputs and zero rotation axes throw GeometryError.
+Use frameTransform3(frame) as the input for existing orthonormal frame placement.
+
+Use `toData()` for frozen matrix interchange.
+[composeTransform3](../geometry/composeTransform3.md) takes matrices in after, before order.
+
 ## Parameters
 
-<a id="matrix"></a>
+<a id="input"></a>
 
-**`matrix`** · [`Transform3Matrix`](Transform3Matrix.md) · Optional
+**`input`** · [`Transform3Input`](Transform3Input.md) · Optional
 
 
 
@@ -29,11 +37,12 @@ placement.applyPoint([1, 0, 0]).toArray(); // approximately [10, 1, 0]
 ## Related APIs
 
 - [Transform3](Transform3-type.md)
-- [Transform3Matrix](Transform3Matrix.md)
+- [Transform3Input](Transform3Input.md)
 
 ## Guides
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -74,4 +74,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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,11 +1,18 @@
 # vector2
 
-Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates. Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates and overflow throw `NON_FINITE_VALUE` GeometryError. Use transform2().applyDirection(value) for rotations and nonuniform scaling.
+Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates.
 
 **vector2**(`input`: [`Vector2Input`](Vector2Input.md)): [`Vector2`](Vector2-type.md)
 
 
 
+Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates
+and overflow throw `NON_FINITE_VALUE` GeometryError.
+Use transform2().applyDirection(value) for rotations and nonuniform scaling.
+
+Use `toData()` for frozen tuple interchange, or
+[normalize2](../geometry/normalize2.md) for tuple-based normalization in numerical loops.
+
 ## Parameters
 
 <a id="input"></a>
@@ -28,5 +35,6 @@ Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,6 +1,6 @@
 # vector3
 
-Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates. Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates and overflow throw `NON_FINITE_VALUE` GeometryError. Use transform3().applyDirection(value) for rotations and nonuniform scaling.
+Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates.
 
 **vector3**(`input`: [`Vector3Input`](Vector3Input.md)): [`Vector3`](Vector3-type.md)
 
@@ -13,6 +13,13 @@ const direction = vector3([1, 2, 3]).add([4, 0, 0]).normalize().scale(10);
 const alignment = direction.dot([0, 0, 1]);
 ```
 
+Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates
+and overflow throw `NON_FINITE_VALUE` GeometryError.
+Use transform3().applyDirection(value) for rotations and nonuniform scaling.
+
+Use `toData()` for frozen tuple interchange, or
+[normalize3](../geometry/normalize3.md) for tuple-based normalization in numerical loops.
+
 ## Parameters
 
 <a id="input"></a>
@@ -35,5 +42,6 @@ const alignment = direction.dot([0, 0, 1]);
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model.md

@@ -15,7 +15,12 @@ snapshot.dispose();
 session.dispose();
 ```
 
-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. Construction and composition work without an engine. Ordinary recipes may be reused across sessions regardless of where constructed. Explicit resolution settings are captured; unspecified settings inherit the evaluating host defaults. Observed component selections remain restricted to their originating session. Observations require synchronous host execution. Temporary native allocations belong to the current transaction; sessions may retain bounded evaluated geometry privately. Copied snapshots remain valid after session disposal until they are disposed.
+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.
+
+- **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.
 
 See [host lifecycle](engine.md) and [pure foundations](geometry.md).
 
@@ -23,18 +28,20 @@ See [host lifecycle](engine.md) and [pure foundations](geometry.md).
 
 - [Primitives](model/categories/primitives.md) — Create foundational solid geometry and configure its 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.
+- [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.
-- [Boolean Operations](model/categories/boolean-operations.md) — Combine, intersect and subtract same-dimensional shapes; construct solid envelopes and sums.
-- [Transforms, Vectors & Placement](model/categories/transforms-placement.md) — Calculate with immutable vectors, reuse transforms, and arrange geometry with explicit placement contracts.
-- [Extrude, Revolve & Sweep](model/categories/extrude-revolve-sweep.md) — Turn sections and paths into extruded, lofted, revolved, or swept solids.
+- [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.
+- [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 & Inspection](model/categories/mesh-inspection.md) — Convert validated meshes and inspect stable section or solid measurements.
-- [Core Values & Errors](model/categories/core-values-errors.md) — Use the small shared vocabulary for authored geometry, coordinates, paths, and stable failures.
+- [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.
 - [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.
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -0,0 +1,34 @@
+# Bounds2Data
+
+Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods.
+
+## Properties
+
+### max
+
+
+
+`readonly` **max**: [`Vector2Data`](Vector2Data.md)
+
+
+
+Inclusive maximum X/Y coordinates.
+
+***
+
+### min
+
+
+
+`readonly` **min**: [`Vector2Data`](Vector2Data.md)
+
+
+
+Inclusive minimum X/Y coordinates.
+
+
+## Related APIs
+
+- [Vector2Data](Vector2Data.md)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -4,4 +4,4 @@ Limits apply before parsing or shaping untrusted font data.
 
 `const` **MAX\_VECTOR\_FONT\_BYTES**: `number`
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -0,0 +1,7 @@
+# Vector2Data
+
+A two-dimensional Cartesian vector or point.
+
+**Vector2Data** = readonly \[`x`: `number`, `y`: `number`\]
+
+Package: `@metamesh/modeling@0.16.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.15.0`.
+Package: `@metamesh/modeling@0.16.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.15.0`.
+Package: `@metamesh/modeling@0.16.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.15.0`.
+Package: `@metamesh/modeling@0.16.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.15.0`.
+Package: `@metamesh/modeling@0.16.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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -8,7 +8,7 @@ Text measurements from the same immutable layout that supplies geometry and SVG
 
 
 
-`readonly` **bounds**: [`Bounds2`](Bounds2.md) \| `null`
+`readonly` **bounds**: [`Bounds2Data`](Bounds2Data.md) \| `null`
 
 
 
@@ -89,6 +89,6 @@ Number of lines, including empty and trailing lines; empty text occupies one lin
 
 ## Related APIs
 
-- [Bounds2](Bounds2.md)
+- [Bounds2Data](Bounds2Data.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,9 @@
 
 Prepare bounded exact font bytes and reusable vector layouts.
 
-Prepare fonts before modeling. TTF, OTF, and WOFF are parsed directly; WOFF2 decoding loads lazily. No fetching occurs in this library. Font layout returns immutable paths and metrics in Y-up millimetres. Pass that prepared layout to textSection inside a build; do not shape it again.
+Prepare fonts before modeling. TTF, OTF, and WOFF are parsed directly; WOFF2 decoding loads lazily. Supply font bytes yourself; this library never fetches fonts.
+
+Layout returns immutable paths and metrics in Y-up millimetres. Pass the prepared layout to `textSection` inside a build without shaping again.
 
 ## Functions
 
@@ -21,13 +23,13 @@ Prepare fonts before modeling. TTF, OTF, and WOFF are parsed directly; WOFF2 dec
 | [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. |
-| [Bounds2](../Bounds2.md) | Axis-aligned bounds in two-dimensional model space. |
+| [Bounds2Data](../Bounds2Data.md) | Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [Vector2Tuple](../Vector2Tuple.md) | A two-dimensional Cartesian vector or point. |
+| [Vector2Data](../Vector2Data.md) | A two-dimensional Cartesian vector or point. |
 
 ## Values
 
@@ -35,4 +37,4 @@ Prepare fonts before modeling. TTF, OTF, and WOFF are parsed directly; WOFF2 dec
 | --- | --- |
 | [MAX_VECTOR_FONT_BYTES](../MAX_VECTOR_FONT_BYTES.md) | Limits apply before parsing or shaping untrusted font data. |
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text.md

@@ -2,7 +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`. Supply already acquired font bytes; this entrypoint never fetches a font. Shape once during preparation and pass the immutable layout to modeling.
+Install `fontkit` for font preparation and `woff2-encoder` for WOFF2 decoding. Import optional exact-font preparation from `@metamesh/modeling/text`.
+
+Supply font bytes yourself; this entry point never fetches fonts. Shape once during preparation and pass the immutable layout to modeling.
 
 ```ts
 import { prepareVectorFont } from "@metamesh/modeling/text";
@@ -18,4 +20,4 @@ Paths and metrics use Y-up millimetres and a baseline origin. Empty layouts can
 
 - [Font preparation](text/categories/font-preparation.md) — Prepare bounded exact font bytes and reusable vector layouts.
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/engine/construction-operations.js

@@ -141,7 +141,7 @@ export function createConstructionOperations(environment, sections) {
                 assertSamplingCount(value.points.length, "hull", 100_000);
             }
             const first = value.points?.[0];
-            const coordinates = typeof first === "object" && first !== null && "toArray" in first ? first.toArray() : first;
+            const coordinates = typeof first === "object" && first !== null && "toData" in first ? first.toData() : first;
             if (value.points !== undefined && coordinates?.length === 2) {
                 const points = value.points;
                 if (!Array.isArray(points) || points.length < 3)