@metamesh/modeling 0.15.0 → 0.17.0

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

@@ -0,0 +1,38 @@
+# 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) | Constructs immutable finite XY bounds from ordered extrema or nonnegative size in millimetres. |
+| [bounds3](../bounds3.md) | Constructs immutable finite XYZ bounds from ordered extrema or nonnegative size in millimetres. |
+
+## 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. |
+| [Bounds2Options](../Bounds2Options.md) | XY bounds construction from existing extrema or nonnegative dimensions, never both. |
+| [Bounds3Options](../Bounds3Options.md) | XYZ bounds construction from existing extrema or nonnegative dimensions, never both. |
+
+## Guides
+
+- [Measure and compare bounds](../../../guides/concepts.md#measure-and-compare-bounds)
+
+Package: `@metamesh/modeling@0.17.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.17.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.17.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.17.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.17.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.17.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 edge 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.17.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.17.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.17.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.17.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. `attachment` 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
 
@@ -21,6 +27,7 @@ export default generate(({ part }) => {
 | --- | --- |
 | [box](../box.md) | Axis-aligned box with uniform or disjoint named edge/group treatments. |
 | [cylinder](../cylinder.md) | +Z cylinder or frustum. Face sizing compensates polygon faceting. |
+| [holeCutter](../holeCutter.md) | Declares a +Z hole or blind-pocket cutter with explicit end overrun in millimetres. Choose exactly one circular diameter or existing Section. A 45-degree entry chamfer supports one strictly convex contour without holes; plain profiles may have any topology. Circular entries retain nominal frustum radii; profile entries offset the supplied polygon edges. Circular head recesses are mutually exclusive with entryChamfer. Both overrun ends default to zero, so the nominal bottom remains at Z=0 and blind pocket floors are preserved. Existing Section samples are authoritative; limits and unspecified circular sampling belong to the evaluating host. Compiled packages require runtime major 9. |
 | [sphere](../sphere.md) | Origin-centered sphere. |
 | [torus](../torus.md) | Torus around +Z. |
 | [tube](../tube.md) | Hollow +Z tube. |
@@ -29,10 +36,11 @@ 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. |
+| [HoleCutterOverrun](../HoleCutterOverrun.md) | Explicit extra cutter length outside the nominal Z=0..height interval, in millimetres. |
 | [EndTreatments](../EndTreatments.md) | Independent inward finishing on primitive or straight convex extrusion ends. Zero amounts leave the end untreated, including when all ends are disabled. |
 | [RadialSizingOptions](../RadialSizingOptions.md) | Nominal radial sizing shared by circular and regular polygon construction. |
 | [RoundedEdgeTreatment](../RoundedEdgeTreatment.md) | A circular edge or corner roundover with explicit physical sampling. |
@@ -45,6 +53,8 @@ export default generate(({ part }) => {
 
 | API | Summary |
 | --- | --- |
+| [HoleCutterOptions](../HoleCutterOptions.md) | A deferred +Z hole or pocket cutter, with exactly one circular diameter or existing Section. Profile entry chamfers expand one strictly convex contour without holes by parallel-edge offsets; the supplied sampled boundary remains authoritative. Plain profile cutters accept any Section. Circular entry chamfers retain nominal circular/frustum radii under the selected radial sizing. |
+| [HoleCutterRecess](../HoleCutterRecess.md) | Circular screw seating dimensions in millimetres; allowances belong to the caller. |
 | [CylinderOptions](../CylinderOptions.md) | Dimensions, placement, independent end finishing, and tessellation for a Z-axis cylinder or frustum. |
 | [EdgeTreatment](../EdgeTreatment.md) | Uniform finishing vocabulary shared by applicable solid edges and profile corners. |
 | [RadialSizing](../RadialSizing.md) | Radial dimensions refer to polygon vertices or compensate faceting to meet polygon faces. |
@@ -58,4 +68,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.15.0`.
+Package: `@metamesh/modeling@0.17.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.withTolerance 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.15.0`.
+Package: `@metamesh/modeling@0.17.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. |
@@ -58,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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -2,16 +2,18 @@
 
 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) | Internal-thread facts using host resolution and limits; requires active synchronous model execution. |
-| [preflightThreadedNut](../preflightThreadedNut.md) | Nut/cutter facts using host resolution and limits; requires active synchronous model execution. |
-| [preflightThreadedRod](../preflightThreadedRod.md) | External-thread facts using host resolution and limits; requires active synchronous model execution. |
+| [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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/model/categories/transforms-placement.md

@@ -1,17 +1,24 @@
-# Transforms, Vectors & Placement
+# Transforms, vectors, and placement
 
 Calculate with immutable vectors, reuse transforms, and arrange geometry with explicit placement contracts.
 
-Use vector2/vector3 for immutable arithmetic and transform2/transform3 for reusable placements. Tuples are accepted as operands; scalar dot, length and distance return numbers. Shape.transform accepts a matching transform directly. Operations apply in written order, rotations use degrees, and optional `{ pivot }` points use world coordinates, defaulting to the origin. andThen composes placements in execution order. applyPoint includes translation, applyDirection retains scale without translation, and applyNormal uses the inverse transpose and returns a unit vector. toArray and toMatrix expose canonical data for interchange. Solid.attach and primitive attachment share source/target anchors, alignment, millimetre gap and degree spin. XY placements can be explicitly embedded with to3D; to2D rejects plane changes. Part placement can reuse finished geometry. Section patterns use XY directions and Path2 trajectories; tangent orientation aligns local +X in the XY plane. Radial Section patterns use an XY pivot and implicit +Z axis. Solid patterns use XYZ inputs and explicit radial axes; path tangent orientation aligns local +Z.
+Use `vector2`/`vector3` for immutable arithmetic and `transform2`/`transform3` for reusable placements. Tuples are accepted as operands; `dot()`, `length()`, and `distance()` return numbers. Shape `transform()` methods accept matching transforms directly.
+
+- **Order and units:** operations and `andThen()` composition apply in written order. Rotations use degrees. Optional `{ pivot }` points use world coordinates and default to the origin.
+- **Transformed values:** `applyPoint()` includes translation; `applyDirection()` retains scale without translation; `applyNormal()` uses the inverse transpose and returns a unit vector.
+- **Interchange:** `toData()` returns canonical data. `to3D()` embeds XY placements explicitly; `to2D()` rejects plane changes.
+- **Attachment:** `Solid.attach()` and primitive attachment share source/target anchors, alignment, millimetre gap, and degree spin. Part placement can reuse finished geometry.
+- **Section patterns:** use XY directions and `Path2` trajectories. Tangent orientation aligns local +X in the XY plane; radial patterns use an XY pivot and implicit +Z axis.
+- **Solid patterns:** use XYZ inputs and explicit radial axes. Path tangent orientation aligns local +Z.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [transform2](../transform2.md) | 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. |
-| [transform3](../transform3.md) | 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. |
-| [vector2](../vector2.md) | 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. |
-| [vector3](../vector3.md) | 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. |
+| [transform2](../transform2.md) | Creates an immutable XY transform, identity by default. |
+| [transform3](../transform3.md) | Creates an immutable XYZ transform, identity by default. |
+| [vector2](../vector2.md) | Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates. |
+| [vector3](../vector3.md) | Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates. |
 | [anchor](../anchor.md) | Reads a copied, immutable named anchor from this exact active generation. |
 | [gridPattern](../gridPattern.md) | XY or XYZ copies, optionally centered or placed in an explicit frame. |
 | [linearPattern](../linearPattern.md) | Repeats one solid along a normalized direction. |
@@ -46,12 +53,13 @@ Use vector2/vector3 for immutable arithmetic and transform2/transform3 for reusa
 | [LinearPatternOptions](../LinearPatternOptions.md) | Equal linear intervals determined by exactly two of count, spacing and total length. Dimension defaults to 3; Section patterns use 2 and accept XY vector directions. |
 | [PatternSource](../PatternSource.md) | One immutable shape, or a synchronous factory called once per copy in index order. |
 | [RadialPatternOptions](../RadialPatternOptions.md) | Degree rotations about a fixed world-space pivot; XY patterns use the implicit +Z axis. |
-| [Transform2Matrix](../Transform2Matrix.md) | A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`. |
-| [Transform3Matrix](../Transform3Matrix.md) | A row-major affine 4x4 matrix applied to column vectors. |
+| [Transform2Data](../Transform2Data.md) | A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`. |
+| [Transform3Data](../Transform3Data.md) | A row-major affine 4x4 matrix applied to column vectors. |
 
 ## 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.17.0`.

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

@@ -36,4 +36,4 @@ circle({ diameter: 12, 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.17.0`.

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

@@ -68,4 +68,4 @@ readonly [`Section`](Section.md)[]
 - [Section](Section.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -28,4 +28,4 @@ Combines disjoint components without resolving overlap.
 - [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.17.0`.

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

@@ -49,4 +49,4 @@ cylinder({ height: 20, radius: [10, 0] });
 - [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.17.0`.

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

@@ -42,4 +42,4 @@ Empty geometry and component selections from another session reject. Results fol
 
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -36,4 +36,4 @@ ellipse({ size: [30, 20] });
 - [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.17.0`.

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

@@ -80,4 +80,4 @@ extrude(profile!, { height: 8 });
 - [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.17.0`.

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

@@ -43,4 +43,8 @@ const model = generate<{ height: number }>(({ params, part, assert }) => {
 - [GenerateCallback](GenerateCallback.md)
 - [ModelProgram](ModelProgram.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -76,5 +76,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.17.0`.