@metamesh/modeling 0.15.0 → 0.16.0

package/dist/docs/reference/model/{Vector2Tuple.md → Vector2Data.md}

@@ -1,8 +1,8 @@
-# Vector2Tuple
+# Vector2Data
 
 A two-dimensional Cartesian vector or point.
 
-**Vector2Tuple** = readonly \[`x`: `number`, `y`: `number`\]
+**Vector2Data** = readonly \[`x`: `number`, `y`: `number`\]
 
 
 
@@ -12,4 +12,4 @@ A two-dimensional Cartesian vector or point.
 - [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 An XY tuple or immutable fluent vector accepted by vector operations.
 
-**Vector2Input** = [`Vector2Tuple`](Vector2Tuple.md) \| [`Vector2`](Vector2-type.md)
+**Vector2Input** = [`Vector2Data`](Vector2Data.md) \| [`Vector2`](Vector2-type.md)
 
 
 
@@ -10,11 +10,12 @@ An XY tuple or immutable fluent vector accepted by vector operations.
 ## Related APIs
 
 - [Vector2](Vector2-type.md)
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.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/Vector3-type.md

@@ -254,11 +254,11 @@ Returns Euclidean distance to another vector in the same coordinate units.
 
 ***
 
-### toArray()
+### toData()
 
 
 
-**toArray**(): [`Vector3Tuple`](Vector3Tuple.md)
+**toData**(): [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -266,17 +266,18 @@ Returns this value's frozen readonly tuple for interchange; repeated calls do no
 
 #### Returns
 
-[`Vector3Tuple`](Vector3Tuple.md)
+[`Vector3Data`](Vector3Data.md)
 
 
 ## Related APIs
 
+- [Vector3Data](Vector3Data.md)
 - [Vector3Input](Vector3Input.md)
-- [Vector3Tuple](Vector3Tuple.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/{Vector3Tuple.md → Vector3Data.md}

@@ -1,8 +1,8 @@
-# Vector3Tuple
+# Vector3Data
 
 A three-dimensional Cartesian vector or point.
 
-**Vector3Tuple** = readonly \[`x`: `number`, `y`: `number`, `z`: `number`\]
+**Vector3Data** = readonly \[`x`: `number`, `y`: `number`, `z`: `number`\]
 
 
 
@@ -12,4 +12,4 @@ A three-dimensional Cartesian vector or point.
 - [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 An XYZ tuple or immutable fluent vector accepted by vector operations.
 
-**Vector3Input** = [`Vector3Tuple`](Vector3Tuple.md) \| [`Vector3`](Vector3-type.md)
+**Vector3Input** = [`Vector3Data`](Vector3Data.md) \| [`Vector3`](Vector3-type.md)
 
 
 
@@ -10,11 +10,12 @@ An XYZ tuple or immutable fluent vector accepted by vector operations.
 ## Related APIs
 
 - [Vector3](Vector3-type.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector3Data](Vector3Data.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/VectorTextLayout.md

@@ -37,4 +37,4 @@ Exact measurements of these paths and their logical text layout.
 - [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/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,7 +89,7 @@ Number of lines, including empty and trailing lines; empty text occupies one lin
 
 ## Related APIs
 
-- [Bounds2](Bounds2.md)
+- [Bounds2Data](Bounds2Data.md)
 
 ## Guides
 
@@ -97,4 +97,4 @@ Number of lines, including empty and trailing lines; empty text occupies one lin
 - [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/anchor.md

@@ -42,5 +42,6 @@ anchor(plate, "top"); // position [0, 0, 3], direction [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/bounds2.md

@@ -0,0 +1,36 @@
+# bounds2
+
+Snapshots finite ordered XY bounds in millimetres as an immutable fluent value.
+
+**bounds2**(`input`: [`Bounds2Input`](Bounds2Input.md)): [`Bounds2`](Bounds2-type.md)
+
+
+
+Zero extents are valid. Invalid dimensions, nonfinite coordinates, reversed bounds and
+overflowing extents throw `INVALID_ARGUMENT` GeometryError. Use `toData()` for plain records.
+Compiled Generator packages passing these values to host recipes or computed data require
+runtime 8.0.0 or newer in major 8.
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Bounds2Input`](Bounds2Input.md) · Required
+
+
+
+## Returns
+
+[`Bounds2`](Bounds2-type.md)
+
+
+## Related APIs
+
+- [Bounds2](Bounds2-type.md)
+- [Bounds2Input](Bounds2Input.md)
+
+## Guides
+
+- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -0,0 +1,36 @@
+# bounds3
+
+Snapshots finite ordered XYZ bounds in millimetres as an immutable fluent value.
+
+**bounds3**(`input`: [`Bounds3Input`](Bounds3Input.md)): [`Bounds3`](Bounds3-type.md)
+
+
+
+Zero extents are valid. Invalid dimensions, nonfinite coordinates, reversed bounds and
+overflowing extents throw `INVALID_ARGUMENT` GeometryError. Use `toData()` for plain records.
+Compiled Generator packages passing these values to host recipes or computed data require
+runtime 8.0.0 or newer in major 8.
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Bounds3Input`](Bounds3Input.md) · Required
+
+
+
+## Returns
+
+[`Bounds3`](Bounds3-type.md)
+
+
+## Related APIs
+
+- [Bounds3](Bounds3-type.md)
+- [Bounds3Input](Bounds3Input.md)
+
+## Guides
+
+- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -22,7 +22,7 @@ box({ size: [30, 20, 8], treatment: { kind: "round", radius: 2 } });
 
 **`options`** · [`BoxOptions`](BoxOptions.md) · Required
 
-- [`size`](BoxOptions.md#size) · `number` \| [`Vector3Tuple`](Vector3Tuple.md) · Required
+- [`size`](BoxOptions.md#size) · `number` \| [`Vector3Data`](Vector3Data.md) · Required
 
   Positive uniform size or explicit `[X, Y, Z]` extents in millimetres.
 
@@ -59,4 +59,4 @@ box({ size: [30, 20, 8], treatment: { kind: "round", radius: 2 } });
 - [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/castSegment.md

@@ -37,4 +37,4 @@ readonly [`SolidSegmentHit`](SolidSegmentHit.md)[]
 - [SolidSegmentHit](SolidSegmentHit.md)
 - [Vector3Input](Vector3Input.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/categories/boolean-operations.md

@@ -1,8 +1,15 @@
-# Boolean Operations
+# Boolean operations
 
 Combine, intersect and subtract same-dimensional shapes; construct solid envelopes and sums.
 
-union and intersect combine arrays of Sections or Solids; shape.subtract(cutters) cuts an array from one base. Every operand must have the same dimension. Section operations preserve filled holes and disconnected components. compose combines solid components without a Boolean union; hull and minkowskiSum construct envelopes. Keep Boolean overtravel separate from physical fit clearance. hull accepts compatible solid and section recipes, or finite points. split returns intersection then subtraction without repeating the cutter setup. Plane operations use a nonzero normal and a signed millimetre offset along its normalized direction; empty results remain queryable handles.
+Use `union` and `intersect` with arrays of Sections or Solids, or `shape.subtract(cutters)` to cut one base. All operands must have the same dimension. Section operations preserve holes and disconnected components.
+
+- `compose` combines solid components without a Boolean union.
+- `hull` accepts compatible Solid or Section recipes, or finite points. `minkowskiSum` constructs solid sums.
+- `split` returns intersection followed by subtraction, reusing the cutter setup.
+- Plane operations use a nonzero normal and a signed millimetre offset along its normalized direction. Empty results remain queryable handles.
+
+Keep Boolean overtravel separate from physical fit clearance.
 
 ## Functions
 
@@ -34,4 +41,4 @@ union and intersect combine arrays of Sections or Solids; shape.subtract(cutters
 - [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/categories/bounded-surfaces.md

@@ -2,13 +2,15 @@
 
 Construct bounded heightfields and positive-inside implicit fields.
 
-Heightfields accept uniform or explicit uneven XY coordinates and close absolute heights against a flat base. Fixed or shorter-edge triangulation samples each grid point once; centre-error selection also samples each cell centre without adding triangles. Implicit sampling uses finite bounds, positive grid spacing, and fixed algorithm limits before the engine checks actual extracted output. Neither operation silently reduces fidelity.
+Heightfields accept uniform or explicit uneven XY coordinates and close absolute heights against a flat base. Fixed or shorter-edge triangulation samples each grid point once. Center-error selection also samples each cell centre without adding triangles.
+
+Implicit sampling requires finite bounds, positive grid spacing, and fixed algorithm limits. The engine then checks the extracted output. Neither operation silently reduces fidelity.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [heightfield](../heightfield.md) | Closed rectilinear top above a flat base, with uniform or explicit XY coordinates. Samples each grid height once; center-error triangulation also samples each cell centre. The retained callback must capture independent immutable inputs, not live session readers or parameters. |
+| [heightfield](../heightfield.md) | Closed rectilinear top above a flat base, with uniform or explicit XY coordinates. |
 | [implicit](../implicit.md) | Bounded positive-inside implicit field constructor. The retained callback must capture independent immutable inputs, not live session readers or parameters. |
 
 ## Interfaces
@@ -23,4 +25,4 @@ Heightfields accept uniform or explicit uneven XY coordinates and close absolute
 | --- | --- |
 | [HeightfieldOptions](../HeightfieldOptions.md) | A closed rectilinear heightfield above a flat base, with uniform or explicit XY samples in millimetres. |
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/categories/bounds.md

@@ -0,0 +1,36 @@
+# Bounds
+
+Measure immutable axis-aligned extents and test positioned containment.
+
+Use `bounds2` and `bounds3` for immutable axis-aligned bounds. `size()` and `center()` return fluent vectors. `containsBounds()` includes boundary contact in the same coordinate frame; zero extents are valid.
+
+Path bounds queries return values or `undefined` for empty paths. Measurements and snapshots retain `Bounds2Data`/`Bounds3Data` records: wrap them once for fluent queries, or use `toData()` for stable frozen interchange.
+
+Containment alone does not establish a manufacturing fit.
+
+## Functions
+
+| API | Summary |
+| --- | --- |
+| [bounds2](../bounds2.md) | Snapshots finite ordered XY bounds in millimetres as an immutable fluent value. |
+| [bounds3](../bounds3.md) | Snapshots finite ordered XYZ bounds in millimetres as an immutable fluent value. |
+
+## Interfaces
+
+| API | Summary |
+| --- | --- |
+| [Bounds2](../Bounds2-type.md) | Immutable finite XY bounds in millimetres, with tuple coordinates for data interoperability. |
+| [Bounds3](../Bounds3-type.md) | Immutable finite XYZ bounds in millimetres, with tuple coordinates for data interoperability. |
+
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [Bounds2Input](../Bounds2Input.md) | An immutable XY bounds value or its plain min/max representation. |
+| [Bounds3Input](../Bounds3Input.md) | An immutable XYZ bounds value or its plain min/max representation. |
+
+## Guides
+
+- [Measure and compare bounds](../../../guides/concepts.md#measure-and-compare-bounds)
+
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/categories/contracts.md

@@ -2,7 +2,9 @@
 
 Describe opaque handles, dimensions, manufacturing parts, and completed snapshots.
 
-Generation returns semantic parts from part(id, geometry) or placement/color options. Ordinary immutable recipes are portable across sessions; observed component selections retain their originating session. Finalized snapshots carry copied manufacturing arrays and exact facts.
+Generation returns semantic parts through `part(id, geometry)` with optional placement and color. Ordinary immutable recipes are portable across sessions; observed component selections retain their originating session.
+
+Finalized snapshots contain copied manufacturing arrays and exact facts. Resource ceilings bound sampling and aggregate output.
 
 ## Interfaces
 
@@ -13,4 +15,4 @@ Generation returns semantic parts from part(id, geometry) or placement/color opt
 | [GeometrySamplingLimits](../GeometrySamplingLimits.md) | Explicit allocation ceilings for pure sampling and host-owned modeling operations. |
 | [ModelingLimits](../ModelingLimits.md) | Aggregate manufacturing output ceilings selected by a trusted host. |
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/categories/core-values-errors.md

@@ -1,30 +1,30 @@
-# Core Values & Errors
+# Core values
 
-Use the small shared vocabulary for authored geometry, coordinates, paths, and stable failures.
+Use shared coordinate, path, polygon, and bounds data.
 
-Use the small shared vocabulary for authored geometry, coordinates, paths, and stable failures.
+Use coordinate tuples, frames, contours, polygons, regions, and bounds records for plain-data interchange. `Contour` omits the duplicated closing point; `PolygonData` associates an exterior with its holes.
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
 | [Frame3](../Frame3.md) | A right-handed orthonormal coordinate frame expressed in world coordinates. |
-| [PolygonData](../PolygonData.md) | One bounded two-dimensional polygon. |
-| [Bounds2](../Bounds2.md) | Axis-aligned bounds in two-dimensional model space. |
-| [Bounds3](../Bounds3.md) | Axis-aligned bounds in three-dimensional model space. |
+| [PolygonData](../PolygonData.md) | One filled two-dimensional polygon with an exterior and optional holes. |
+| [Bounds2Data](../Bounds2Data.md) | Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods. |
+| [Bounds3Data](../Bounds3Data.md) | Plain axis-aligned XYZ bounds for interchange; use bounds3 for immutable measurement methods. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [Contour](../Contour.md) | A closed two-dimensional boundary whose first point is not repeated at the end. |
-| [RegionData](../RegionData.md) | A two-dimensional region represented by disjoint filled polygons. |
-| [Vector2Tuple](../Vector2Tuple.md) | A two-dimensional Cartesian vector or point. |
-| [Vector3Tuple](../Vector3Tuple.md) | A three-dimensional Cartesian vector or point. |
+| [Contour](../Contour.md) | A sampled closed two-dimensional boundary whose first point is not repeated at the end. |
+| [RegionData](../RegionData.md) | A two-dimensional region represented by disjoint filled polygons. Each PolygonData owns one exterior and its holes; an empty region contains no material. |
+| [Vector2Data](../Vector2Data.md) | A two-dimensional Cartesian vector or point. |
+| [Vector3Data](../Vector3Data.md) | A three-dimensional Cartesian vector or point. |
 
 ## Guides
 
 - [Geometry vocabulary](../../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/categories/explicit-profiles.md

@@ -2,7 +2,9 @@
 
 Build hollow or multicomponent lofts and sweeps using stable landmarks.
 
-Contour is plain point data with an implicit closing edge. Profile is an identified family specification with stable component, contour and span IDs; it is distinct from a filled Section. Prepare matchProfiles over the complete family once to produce CorrespondingProfile values. All paired spans share a physical sampling grid, including logical slots for collapsed corners. loft and sweep consume this correspondence without guessing topology or rematching.
+`Contour` is point data with an implicit closing edge. `Profile` specifies stable component, contour, and span IDs for a family; it is distinct from a filled `Section`.
+
+Call `matchProfiles` once over the complete family to produce `CorrespondingProfile` values. Paired spans share a physical sampling grid, including logical slots for collapsed corners. `loft` and `sweep` use that correspondence without guessing topology or rematching.
 
 ## Functions
 
@@ -18,9 +20,9 @@ Contour is plain point data with an implicit closing edge. Profile is an identif
 | [CorrespondingComponent](../CorrespondingComponent.md) | One sampled component retaining contour identities and logical point correspondence. |
 | [CorrespondingContour](../CorrespondingContour.md) | A sampled contour retaining logical slots, including intentionally collapsed spans. |
 | [MatchProfilesOptions](../MatchProfilesOptions.md) | Explicit family sampling settings; omitted values use physical package defaults. |
-| [Profile](../Profile.md) | An explicit component/contour/span topology, before shared family sampling. |
+| [Profile](../Profile.md) | An explicit component/contour/span topology, before shared family sampling with matchProfiles. Component, contour and span identities establish correspondence across a loft or sweep family. |
 | [ProfileComponent2](../ProfileComponent2.md) | One component and its explicitly identified holes. |
-| [ProfileContour2](../ProfileContour2.md) | Ordered, closed spans. Outer winding is CCW and hole winding is CW. |
+| [ProfileContour2](../ProfileContour2.md) | An identified closed boundary of curve spans, before shared family sampling. Outer winding is CCW and hole winding is CW. matchProfiles retains span identities in sampled contours. |
 
 ## Type aliases
 
@@ -29,4 +31,4 @@ Contour is plain point data with an implicit closing edge. Profile is an identif
 | [CorrespondingProfileStation](../CorrespondingProfileStation.md) | One already matched profile at an explicit height or right-handed spatial frame. |
 | [ProfileSpan2](../ProfileSpan2.md) | An identified line, circular arc, or cubic Bézier between corresponding landmarks. |
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/categories/extrude-revolve-sweep.md

@@ -1,8 +1,17 @@
-# Extrude, Revolve & Sweep
+# Extrude, revolve, and sweep
 
 Turn sections and paths into extruded, lofted, revolved, or swept solids.
 
-`section.extrude({ height, twist, scaleTop })` adds +Z depth; center defaults to false. `section.revolve({ degrees })` rotates radial/Z geometry around +Z and caps partial turns. loft(stations, options) places each profile at exactly one z or frame in input order. Compatible primitive landmarks match directly, including circle/ellipse quadrants to rectangle corners. Other unlike primitive families use direct perimeter association from construction-local +X seams. Arbitrary Sections and loops require an explicit direct, reindex, fast-distance or distance method. refine controls density and slices interpolate world vertices. Identified CorrespondingProfile landmarks reject geometric remapping. section.sweep(path, options) supports implicit closed paths, transport/fixed-normal/guide/Frenet orientation, physical-length or station twist progression, uniform/XY/per-station scales and an explicit rotationally equivalent seamProfileOffset. Open sweeps have watertight end caps; closed sweeps require compatible orientation and scale at the seam. Standalone extrude, revolve and sweep accept CorrespondingProfile data only; Section construction uses its methods.
+Turn filled Sections or explicitly matched profiles into solids:
+
+- **Extrude:** `section.extrude({ height, twist, scaleTop })` adds +Z depth. `center` defaults to `false`.
+- **Revolve:** `section.revolve({ degrees })` rotates radial/Z geometry around +Z and caps partial turns.
+- **Loft:** `loft(stations, options)` places profiles at exactly one `z` or `frame` per station, in input order. `refine` controls density; slices interpolate world vertices.
+- **Sweep:** `section.sweep(path, options)` supports implicitly closed paths, transport/fixed-normal/guide/Frenet orientation, physical-length or station twist progression, uniform/XY/per-station scales, and an explicit rotationally equivalent `seamProfileOffset`. Open sweeps have watertight end caps. Closed sweeps require compatible seam orientation and scale.
+
+Lofts match compatible primitive landmarks directly, including circle/ellipse quadrants to rectangle corners. Other unlike primitive families use direct perimeter association from construction-local +X seams. Arbitrary Sections and loops require an explicit `direct`, `reindex`, `fast-distance`, or `distance` method. Identified `CorrespondingProfile` landmarks reject geometric remapping.
+
+Standalone `extrude`, `revolve`, and `sweep` accept only `CorrespondingProfile` data. Use Section methods for filled Sections.
 
 ## Functions
 
@@ -39,4 +48,4 @@ Turn sections and paths into extruded, lofted, revolved, or swept solids.
 - [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/categories/generation.md

@@ -2,7 +2,12 @@
 
 Declare typed programs, optional computations, semantic parts and structured diagnostics.
 
-Start with `generate(({ params, part, assert }) => ...)` and return one `part(...)` or a readonly array of parts. Parameter values are ordinary readonly data. `computed(id, callback)` optionally caches pure data or geometry and tracks synchronous reads. List changing outer captures with `computed(id, () => ..., [value])`; dependency arrays supplement automatic tracking. Assertions stop immediately; warnings continue and must be emitted in the outer callback. Place finished parts with `position` in millimetres and fixed global XYZ `rotation` in degrees. Capture cached numeric arrays with `immutableBuffer` and indexed meshes with `immutableMesh`. Buffers expose only length, at(index), and copy(); snapshots still contain ordinary typed arrays.
+Start with `generate(({ params, part, assert }) => ...)` and return one `part(...)` or a readonly array of parts. Parameter values are ordinary readonly data.
+
+- **Cache:** `computed(id, callback)` optionally caches pure data or geometry and tracks synchronous reads. List changing outer captures with `computed(id, () => ..., [value])`; dependency arrays supplement automatic tracking.
+- **Report issues:** assertions stop immediately. Warnings continue and must be emitted in the outer callback.
+- **Place parts:** `position` uses millimetres; `rotation` uses fixed global XYZ degrees.
+- **Keep cached data immutable:** use `immutableBuffer` for numeric arrays and `immutableMesh` for indexed meshes. Buffers expose only `length`, `at(index)`, and `copy()`. Snapshots still contain ordinary typed arrays.
 
 ## Functions
 
@@ -41,4 +46,8 @@ Start with `generate(({ params, part, assert }) => ...)` and return one `part(..
 | [GenerateCallback](../GenerateCallback.md) | Pure synchronous callback returning one declared part or an array; caches are optional. |
 | [PartGeometry](../PartGeometry.md) | Manufacturing geometry; filled sections are intermediate construction values. |
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Complete standalone model example](../../../guides/standalone-model.md#minimal-model-entry)
+
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/categories/hinges.md

@@ -0,0 +1,38 @@
+# Knuckle joints
+
+Compose reusable knuckle joints with independent mounting attachments.
+
+Joint halves share a centered +X pin axis and +Z roll guide:
+
+- **Captive:** A anchors the integral shaft.
+- **Inserted pin:** neither half supplies a shaft.
+- **Lift-off:** finite engagement with no far anchor.
+
+Each half can have a square-edged rectangular web or remain barrels only. Outer rim chamfers preserve a positive faceted barrel wall. You supply mounting bodies, holes, retention, part placement, and attachment collision checks.
+
+Radial clearance is per side; axial gap is the total gap between adjacent intervals. Zero allowances describe ideal contact, not printable fit.
+
+## Functions
+
+| API | Summary |
+| --- | --- |
+| [knuckleHinge](../knuckleHinge.md) | Declares separate knuckle-joint halves along the centered +X pin axis, in millimetres. |
+
+## Interfaces
+
+| API | Summary |
+| --- | --- |
+| [KnuckleHinge](../KnuckleHinge-type.md) | Portable local geometry; consumers own plates, holes, part declarations, and final placement. |
+| [KnuckleHingeBaseSpec](../KnuckleHingeBaseSpec.md) | Shared knuckle-joint dimensions in millimetres, independent of mounting geometry. |
+| [KnuckleHingeSamplingOptions](../KnuckleHingeSamplingOptions.md) | Shared circular sampling for barrels, shafts, and bores. |
+| [KnuckleHingeHalfOptions](../KnuckleHingeHalfOptions.md) | Optional mounting and outer-rim treatment for one knuckle owner. |
+| [KnuckleHingeWeb](../KnuckleHingeWeb.md) | Rectangular connection from the axis into a caller-owned mounting body, in millimetres. |
+
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [KnuckleHingeOptions](../KnuckleHingeOptions.md) | Joint declaration with independent attachments; unspecified sampling inherits the evaluating host. |
+| [KnuckleHingeSpec](../KnuckleHingeSpec.md) | Knuckle-joint construction modes and interval ownership. |
+
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/categories/inspection.md

@@ -2,7 +2,14 @@
 
 Evaluate recipes and copy observations while the host owns native resources.
 
-Inspection returns copied scalar facts and finite bounds. Mesh extraction is explicit; finalized engine output is already copied and validated. Ordinary recipes remain reusable after session disposal. Observed component selections and recipes using them can only be evaluated in their originating session. Recipe handles cannot cross a Worker boundary. components accepts either dimension; simplify is an immutable shape method. Solid.projectSection and Solid.sliceSection return Sections. isEmpty distinguishes empty Boolean/split results; distance measures the minimum separation between nonempty solids and returns zero for contact or overlapping material.
+Inspection returns copied scalar facts and finite bounds. Mesh extraction is explicit; finalized engine output is already copied and validated.
+
+- `components` accepts either dimension. Observed selections and recipes using them can only be evaluated in their originating session; ordinary recipes remain reusable after session disposal.
+- `simplify()` returns a new shape. `Solid.projectSection()` and `Solid.sliceSection()` return Sections.
+- `isEmpty` distinguishes empty Boolean or split results.
+- `distance` measures minimum separation between nonempty solids, returning zero for contact or overlapping material.
+
+Recipe handles cannot cross a Worker boundary.
 
 ## Functions
 
@@ -19,4 +26,4 @@ Inspection returns copied scalar facts and finite bounds. Mesh extraction is exp
 | --- | --- |
 | [SolidSegmentHit](../SolidSegmentHit.md) | Copied surface intersection from a finite directed segment. Distance is in millimetres. |
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/categories/mesh-inspection.md

@@ -1,8 +1,10 @@
-# Mesh & Inspection
+# Mesh and inspection
 
 Convert validated meshes and inspect stable section or solid measurements.
 
-inspectSection and inspectSolid copy native scalar facts and bounds from recipes in the active host execution. Solid.toTriangleMesh() returns copied manufacturing arrays; final engine output also receives strict mesh analysis. Neither inspection certifies wall thickness, overhangs, printer fit or material behavior.
+`inspectSection` and `inspectSolid` copy native scalar facts and bounds during active host execution. `Solid.toTriangleMesh()` returns copied manufacturing arrays; finalized engine output also receives strict mesh analysis.
+
+Inspection does not certify wall thickness, overhangs, printer fit, or material behavior.
 
 ## Functions
 
@@ -26,4 +28,4 @@ inspectSection and inspectSolid copy native scalar facts and bounds from recipes
 
 - [Solid inspection](../../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/categories/paths.md

@@ -2,13 +2,17 @@
 
 Reusable immutable planar and spatial trajectories.
 
-Use path2 and path3 to own sampled point data and closure. Geometry consumes the values directly; transform, reverse and resample return new values. closestPoint reports a boundary position and edge-local fraction, not a filled interior or analytic-curve solution. Tuples remain available through toArray for interchange. Closed paths omit the duplicated endpoint; polygon fills a closed planar path and establishes winding.
+Use `path2` and `path3` for immutable sampled trajectories. `transform()`, `reverse()`, and `resample()` return new values; Geometry accepts the path values directly.
+
+`closestPoint()` reports a boundary position and fraction within an edge, rather than a filled interior or analytic-curve solution. `bounds()` returns fluent bounds, or `undefined` for an empty path. `toData()` returns points with dimension and closure metadata.
+
+Closed paths omit the duplicated endpoint. `polygon` fills a closed planar path and establishes winding.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [path2](../path2.md) | Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization. Open paths may be empty or have one point; closed paths need three vertices and omit a duplicated seam. Repeated adjacent vertices are retained. No winding normalization or filling is performed. Malformed dimensions or topology throw INVALID_ARGUMENT; nonfinite coordinates or measurement overflow throw NON_FINITE_VALUE; exhausted allocation ceilings throw COMPLEXITY_LIMIT GeometryError. A path input retains its closure. Limits bound construction only; resampling takes its own limits. |
+| [path2](../path2.md) | Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization. |
 | [path3](../path3.md) | Snapshots finite XYZ coordinates as an immutable sampled path with the same closure, seam, allocation and error rules as path2. Analytic curves must be sampled explicitly first. |
 
 ## Interfaces
@@ -20,14 +24,18 @@ Use path2 and path3 to own sampled point data and closure. Geometry consumes the
 | [PathOptions](../PathOptions.md) | Topology and allocation ceiling for an immutable sampled path. |
 | [PathLocation](../PathLocation.md) | Nearest location on a sampled boundary, rather than inside a filled shape or on an analytic curve. |
 | [PathResamplingOptions](../PathResamplingOptions.md) | Equal arc-length sampling; the path itself owns whether its closing edge is included. |
+| [Path2Data](../Path2Data.md) | Complete plain XY path representation, including topology and empty-path dimensional identity. |
+| [Path3Data](../Path3Data.md) | Complete plain XYZ path representation, including topology and empty-path dimensional identity. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [Path2Input](../Path2Input.md) | An immutable XY sampled path or a collection of XY tuples and fluent vectors. |
-| [Path3Input](../Path3Input.md) | An immutable XYZ sampled path or a collection of XYZ tuples and fluent vectors. |
-| [Path2Data](../Path2Data.md) | XY point tuples for interchange; closure is supplied by the consuming operation or Path2 value. |
-| [Path3Data](../Path3Data.md) | XYZ point tuples for interchange; closure is supplied by the consuming operation or Path3 value. |
+| [Path2Input](../Path2Input.md) | A matching path value, complete plain path data, or a collection of vectors. |
+| [Path3Input](../Path3Input.md) | A matching path value, complete plain path data, or a collection of vectors. |
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.