@metamesh/modeling 0.14.0 → 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.14.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.14.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. Opaque recipe handles belong to their 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.14.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.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,13 +2,15 @@
 
 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
 
 | API | Summary |
 | --- | --- |
-| [matchProfiles](../matchProfiles.md) | Explicit family matching on a shared physical span grid using session or operation resolution. |
+| [matchProfiles](../matchProfiles.md) | Matches a profile family using operation settings over host resolution and limits. Requires active synchronous model execution. Use Geometry's matchProfiles for standalone preparation. |
 
 ## Interfaces
 
@@ -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.14.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, twistDegrees, scaleTop })` adds +Z depth; center defaults to false. `section.revolve({ revolveDegrees })` 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.14.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.14.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,15 +2,21 @@
 
 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
 
 | API | Summary |
 | --- | --- |
-| [components](../components.md) | Observes a solid's disconnected surface shells as session-restricted solid selections. |
-| [rayCast](../rayCast.md) | Copies intersections along the finite directed origin-to-endpoint segment. |
-| [toTriangleMesh](../toTriangleMesh.md) | Copies a handle to manufacturing mesh buffers. |
+| [components](../components.md) | Observes disconnected material pieces as session-restricted solid selections. |
+| [castSegment](../castSegment.md) | Copies intersections along the finite directed origin-to-endpoint segment. |
 | [isEmpty](../isEmpty.md) | Checks whether a solid or filled section contains no geometry during host execution. |
 | [distance](../distance.md) | Measures the minimum separation between two nonempty solids in millimetres. |
 
@@ -18,6 +24,6 @@ Inspection returns copied scalar facts and finite bounds. Mesh extraction is exp
 
 | API | Summary |
 | --- | --- |
-| [SolidRayHit](../SolidRayHit.md) | Copied surface intersection from a finite directed segment. Distance is in millimetres. |
+| [SolidSegmentHit](../SolidSegmentHit.md) | Copied surface intersection from a finite directed segment. Distance is in millimetres. |
 
-Package: `@metamesh/modeling@0.14.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. 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.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -0,0 +1,41 @@
+# Sampled paths
+
+Reusable immutable planar and spatial trajectories.
+
+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. |
+| [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
+
+| API | Summary |
+| --- | --- |
+| [Path2](../Path2-type.md) | Immutable directed XY polyline. Closure is explicit and does not imply a filled Section. |
+| [Path3](../Path3-type.md) | Immutable directed XYZ polyline; it represents sampled edges, not an analytic curve. |
+| [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) | 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.16.0`.

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

@@ -2,7 +2,11 @@
 
 Create foundational solid geometry and configure its dimensions and tessellation.
 
-All primitives use millimetres and one options object. `box` accepts scalar or XYZ size; `cylinder` accepts exactly one radius or diameter, uniformly or as a bottom/top tuple along +Z. Radial sizing explicitly selects polygon vertices or compensated faces. Treatments share `{kind: "round", radius}`, `{kind: "chamfer", distance}`, `{kind: "smooth", distance}` and `{kind: "profile", profile}`; boxes may select named edges; cylinder and straight convex extrusion ends select independent bottom/top treatments. Boxes, cylinders and tubes are centered by default. `placement` maps a named or explicit local anchor onto a world anchor after shape construction.
+All primitives use millimetres and one options object. Boxes, cylinders, and tubes are centered by default.
+
+- **Dimensions:** `box` accepts a scalar or XYZ size. `cylinder` accepts exactly one radius or diameter, uniform or a bottom/top tuple along +Z. Radial sizing selects polygon vertices or compensated faces.
+- **Treatments:** choose `{ kind: "round", radius }`, `{ kind: "chamfer", distance }`, `{ kind: "smooth", distance }`, or `{ kind: "profile", profile }`. Boxes support named edges; cylinders and straight convex extrusions support independent bottom/top treatments.
+- **Placement:** `attachment` maps a named or explicit local anchor onto a world anchor after construction.
 
 Use imported primitives inside generation:
 
@@ -13,7 +17,9 @@ export default generate(({ part }) => {
   const bore = cylinder({ radius: 3, height: 8, sizing: "face" });
   return [part("plate", plate.subtract([bore]))];
 });
-``` Zero round radius or zero chamfer/smooth setbacks leave a feature untreated; setback tuples are either all zero or both positive.
+```
+
+A zero round radius or zero chamfer/smooth setback leaves a feature untreated. Setback tuples must be all zero or both positive.
 
 ## Functions
 
@@ -29,7 +35,7 @@ export default generate(({ part }) => {
 
 | API | Summary |
 | --- | --- |
-| [Solid](../Solid.md) | Immutable deferred solid recipe. Construction and composition require no engine. Ordinary recipes may be reused across sessions regardless of where constructed. Explicit resolution settings are captured; unspecified settings inherit the evaluating host's defaults. Observed components and recipes using them can only be evaluated in their originating session. Methods leave the source unchanged and use millimetres and degrees. A no-op may reuse the receiver; final part placement belongs in `part` options. |
+| [Solid](../Solid.md) | Immutable deferred solid recipe. |
 | [BoxOptions](../BoxOptions.md) | Dimensions, placement, and uniform or independently selected finishing for an axis-aligned box. |
 | [ChamferedEdgeTreatment](../ChamferedEdgeTreatment.md) | A planar edge or corner chamfer with equal or independent surface setbacks. |
 | [CircularPrimitiveOptions](../CircularPrimitiveOptions.md) | Tessellation controls shared by circular primitives across Geometry entry points. |
@@ -58,4 +64,4 @@ export default generate(({ part }) => {
 - [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.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,9 @@
 
 Choose physical curve sampling and explicit native tolerance.
 
-Exact operation counts take precedence over the operation’s resolution policy, followed by host session defaults. Pass resolution explicitly to each affected constructor or Section operation. Solid.setTolerance changes native geometric tolerance on an immutable copy; it does not select curve sampling.
+Exact operation counts override the operation's resolution policy, which overrides host session defaults. Pass resolution to each affected constructor or `Section` operation.
+
+`Solid.withTolerance()` changes native geometric tolerance on an immutable copy; it does not select curve sampling.
 
 ## Interfaces
 
@@ -15,4 +17,4 @@ Exact operation counts take precedence over the operation’s resolution policy,
 
 - [Coordinates, units, and resolution](../../../guides/concepts.md#coordinates-units-and-resolution)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,8 +1,13 @@
-# 2D Sections
+# 2D sections
 
 Create immutable filled XY shapes, including prepared text and bounded painted SVG.
 
-Section is the filled XY modeling value with holes and disconnected components. RegionData is its serialized polygon data. Construct with `polygon(points)`, `polygon({ outer, holes })`, `polygon({ contours, fillRule })`, or `polygon({ polygons: data })`. Explicit topology validates boundaries and winding; compound contours use nonzero fill by default or evenodd fill. Observe evaluated coordinates with section.toRegionData() during synchronous host execution. Construction and composition are engine-independent; native evaluation is host-owned. textSection consumes prepared VectorTextLayout without shaping again. Extrusion, revolution and sweeps preserve filled topology. Compatible primitive Sections retain authored landmarks for lofting; arbitrary Sections need explicit correspondence.
+`Section` is an immutable filled XY shape with holes and disconnected components. `RegionData` is its serialized polygon data. Construction and composition require no engine; native evaluation belongs to the host.
+
+- **Construct:** use `polygon(points)`, `polygon({ outer, holes })`, `polygon({ contours, fillRule })`, or `polygon({ polygons: data })`. Explicit topology validates boundaries and winding. Compound contours default to `nonzero` fill; select `evenodd` when needed.
+- **Inspect:** call `section.toRegionData()` during synchronous host execution.
+- **Build solids:** extrusion, revolution, and sweeps preserve filled topology. Compatible primitive Sections retain loft landmarks; arbitrary Sections need explicit correspondence.
+- **Add text:** `textSection` consumes a prepared `VectorTextLayout` without shaping again.
 
 ## Functions
 
@@ -13,7 +18,7 @@ Section is the filled XY modeling value with holes and disconnected components.
 | [ellipse](../ellipse.md) | Centered elliptical section. |
 | [rectangle](../rectangle.md) | Filled rectangular section with uniform or independently treated corners. |
 | [regularPolygon](../regularPolygon.md) | Regular polygon with a vertex on +X. |
-| [polygon](../polygon.md) | Fills one closed millimetre XY outline, explicit outer/hole topology, or compound contours. Closing edges are implicit. Compound contours use nonzero fill unless selected otherwise. Explicit topology must be simple and disjoint; compound winding may resolve overlaps. |
+| [polygon](../polygon.md) | Fills one closed millimetre XY outline, explicit outer/hole topology, or compound contours. |
 | [star](../star.md) | Alternating outer/inner star vertices. |
 | [svgPathSection](../svgPathSection.md) | Imports bounded filled SVG path data. |
 | [svgSection](../svgSection.md) | Imports bounded painted SVG document geometry. |
@@ -23,7 +28,7 @@ Section is the filled XY modeling value with holes and disconnected components.
 
 | API | Summary |
 | --- | --- |
-| [Section](../Section.md) | Immutable deferred filled XY section recipe. Construction and composition require no engine. Ordinary recipes may be reused across sessions regardless of where constructed. Observed components and recipes using them can only be evaluated in their originating session. Methods leave the source unchanged; observations require a synchronous model execution. Distances use millimetres; rotations use counterclockwise degrees. Explicit resolution settings are captured; unspecified settings inherit the evaluating host's defaults. |
+| [Section](../Section.md) | Immutable deferred filled XY section recipe. |
 | [StrokeOptions](../StrokeOptions.md) | Physical stroke and topology controls shared by pure regions and native Sections. |
 | [RectangleContourOptions](../RectangleContourOptions.md) | Shared rectangle dimensions, origin and uniform or per-corner treatment. |
 | [RectangleOptions](../RectangleOptions.md) | Rectangle dimensions, placement and uniform or per-corner treatment. |
@@ -39,9 +44,8 @@ Section is the filled XY modeling value with holes and disconnected components.
 
 | API | Summary |
 | --- | --- |
-| [Path2](../Path2.md) | An ordered, open sequence of two-dimensional points. |
-| [StrokePathCap](../StrokePathCap.md) | End-cap treatment for an open stroked path. |
-| [StrokePathJoin](../StrokePathJoin.md) | Join treatment where adjacent stroked path segments meet. |
+| [StrokeCap](../StrokeCap.md) | End-cap treatment for an open stroked path. |
+| [StrokeJoin](../StrokeJoin.md) | Join treatment where adjacent stroked path segments meet. |
 | [CircleContourOptions](../CircleContourOptions.md) | Circular profile dimensions with exactly one radius or diameter and explicit sampling. |
 | [CircleOptions](../CircleOptions.md) | Circular dimensions with exactly one nominal radius or diameter. |
 | [EllipseContourOptions](../EllipseContourOptions.md) | Ellipse dimensions with exactly one XY radii or full-size tuple and explicit sampling. |
@@ -59,4 +63,4 @@ Section is the filled XY modeling value with holes and disconnected components.
 - [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.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,17 +1,19 @@
 # Printable threads
 
-Construct compensated thread forms and inspect allocation-free preflight facts.
+Construct compensated thread forms and inspect bounded preflight facts.
 
-Thread pitch is adjacent axial spacing; lead equals pitch times starts. Prepare shared thread dimensions once. Constructors enforce safety automatically; optional preflight provides resource estimates or early control-specific validation. Native rods, internal cutters, and nuts share printable fit and end-treatment options. These forms do not certify a structural rating or a metrology class.
+Thread pitch is adjacent axial spacing; lead is `pitch × starts`. Prepare shared dimensions once. Native rods, internal cutters, and nuts share printable fit and end-treatment options.
+
+Constructors enforce safety automatically. Optional preflight provides resource estimates or early validation for individual controls. These forms do not certify a structural rating or metrology class.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
 | [internalThreadCutter](../internalThreadCutter.md) | Compensated internal threaded cutter. |
-| [preflightInternalThreadCutter](../preflightInternalThreadCutter.md) | Allocation-free internal-thread facts. |
-| [preflightThreadedNut](../preflightThreadedNut.md) | Allocation-free nut/cutter facts. |
-| [preflightThreadedRod](../preflightThreadedRod.md) | Allocation-free external-thread facts. |
+| [preflightInternalThreadCutter](../preflightInternalThreadCutter.md) | Checks compensated cutter dimensions and conservative mesh estimates against host output limits. |
+| [preflightThreadedNut](../preflightThreadedNut.md) | Checks nut dimensions, chamfers, end-face wall, and the extended compensated cutter's allocation plan. |
+| [preflightThreadedRod](../preflightThreadedRod.md) | Checks compensated rod dimensions and conservative mesh estimates against host output limits. |
 | [threadedNut](../threadedNut.md) | Compensated threaded nut. |
 | [threadedRod](../threadedRod.md) | Compensated external threaded rod. |
 | [threadRidge](../threadRidge.md) | Helical ridge mesh construction. |
@@ -21,11 +23,11 @@ Thread pitch is adjacent axial spacing; lead equals pitch times starts. Prepare
 | API | Summary |
 | --- | --- |
 | [HelicalThreadRidgeMeshOptions](../HelicalThreadRidgeMeshOptions.md) | Runtime-neutral options for the dedicated helical ridge mesher. |
-| [HelicalThreadSolidMeshPreflight](../HelicalThreadSolidMeshPreflight.md) | Conservative allocation facts resolved before constructing a direct thread solid mesh. |
+| [HelicalThreadSolidMeshPreflight](../HelicalThreadSolidMeshPreflight.md) | Selected sampling counts and conservative allocation estimates, before thread mesh construction. |
 | [InternalThreadCutterOptions](../InternalThreadCutterOptions.md) | Options for a compensated internal-thread subtraction tool along +Z. |
 | [PrintableThreadFitPolicy](../PrintableThreadFitPolicy.md) | Explicit radial and axial allowances for a mating printed thread pair. |
 | [ThreadedNutOptions](../ThreadedNutOptions.md) | Options for a compensated nut with an internal thread. |
-| [ThreadedNutPreflight](../ThreadedNutPreflight.md) | Allocation-free body, cutter, and end-face facts resolved for a threaded nut. |
+| [ThreadedNutPreflight](../ThreadedNutPreflight.md) | Resolved body and end-face dimensions plus conservative allocation estimates for the thread cutter. |
 | [ThreadedRodOptions](../ThreadedRodOptions.md) | Options for a compensated external threaded rod along +Z. |
 | [ThreadEndTreatmentOptions](../ThreadEndTreatmentOptions.md) | Axial end controls for a generated ridge. |
 | [ThreadProfile](../ThreadProfile.md) | A validated immutable periodic thread profile in `[axial, radial]` millimetres. |
@@ -46,5 +48,6 @@ Thread pitch is adjacent axial spacing; lead equals pitch times starts. Prepare
 ## 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.14.0`.
+Package: `@metamesh/modeling@0.16.0`.