@metamesh/modeling 0.15.0 → 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. `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
 
@@ -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.15.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.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.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. |
@@ -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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.0`.

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

@@ -1,6 +1,6 @@
 # heightfield
 
-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.
+Closed rectilinear top above a flat base, with uniform or explicit XY coordinates.
 
 **heightfield**(`options`: [`HeightfieldOptions`](HeightfieldOptions.md)): [`Solid`](Solid.md)
 
@@ -19,6 +19,9 @@ heightfield({
 
 
 
+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.
+
 ## Parameters
 
 <a id="options"></a>
@@ -37,4 +40,4 @@ heightfield({
 - [HeightfieldOptions](HeightfieldOptions.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -71,4 +71,4 @@ Convex filled XY hull of finite points or filled section recipes.
 - [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/immutableBuffer.md

@@ -41,4 +41,8 @@ editable[0] = 8; // heights still contains 2, 4, 6.
 - [ImmutableBuffer](ImmutableBuffer-type.md)
 - [NumericArray](NumericArray.md)
 
-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/immutableMesh.md

@@ -37,4 +37,8 @@ const model = generate(({ computed, part }) => {
 - [ImmutableTriangleMesh](ImmutableTriangleMesh.md)
 - [TriangleMesh](TriangleMesh.md)
 
-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/implicit.md

@@ -12,11 +12,11 @@ Bounded positive-inside implicit field constructor. The retained callback must c
 
 **`options`** · [`ImplicitOptions`](ImplicitOptions.md) · Required
 
-- [`field`](ImplicitOptions.md#field) · (`point`: [`Vector3Tuple`](Vector3Tuple.md)) => `number` · Required
+- [`field`](ImplicitOptions.md#field) · (`point`: [`Vector3Data`](Vector3Data.md)) => `number` · Required
 
   Positive-inside scalar field evaluated at finite XYZ points.
 
-- [`bounds`](ImplicitOptions.md#bounds) · [`Bounds3`](Bounds3.md) · Required
+- [`bounds`](ImplicitOptions.md#bounds) · [`Bounds3Data`](Bounds3Data.md) · Required
 
   Axis-aligned XYZ bounds in millimetres.
 
@@ -44,4 +44,4 @@ Bounded positive-inside implicit field constructor. The retained callback must c
 - [ImplicitOptions](ImplicitOptions.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -35,4 +35,4 @@ facts.area; // 200 mm²
 
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -35,4 +35,4 @@ facts.volume; // 3600 mm³
 
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -96,5 +96,6 @@ body.subtract([cutter]);
 ## Guides
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -67,4 +67,4 @@ Native filled section intersection; dimensions cannot be mixed.
 - [Choose the Boolean by the material you want](../../guides/fundamentals.md#choose-the-boolean-by-the-material-you-want)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -36,4 +36,4 @@ Useful after a Boolean operation whose inputs may not overlap; no mesh is extrac
 - [Section](Section.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -0,0 +1,47 @@
+# knuckleHinge
+
+Declares separate knuckle-joint halves along the centered +X pin axis, in millimetres.
+
+**knuckleHinge**(`options`: [`KnuckleHingeOptions`](KnuckleHingeOptions.md)): [`KnuckleHinge`](KnuckleHinge-type.md)
+
+
+
+## Example: Integral-pin hinge with two mounting webs
+
+```ts
+const joint = knuckleHinge({
+  mode: "print-in-place", length: 30, knuckleCount: 3,
+  barrelDiameter: 10, pinDiameter: 3, radialClearance: 0.3, axialGap: 0.4,
+  halfA: { web: { direction: "positive-y", reach: 8, zMin: -5, thickness: 2 } },
+  halfB: { web: { direction: "negative-y", reach: 8, zMin: -5, thickness: 2 } },
+});
+```
+
+A starts at negative X. Attach independent webs or use barrels only; caller geometry connects
+otherwise disconnected intervals. Returns portable recipes without initializing the engine.
+Unspecified resolution inherits the evaluating session. Axis direction is +X with +Z up.
+
+Barrel end chamfers affect outer rims only; webs have square edges. Consumers own plates, screw holes,
+pin retention, fit policy, and part placement. Added mounting material must preserve the bores.
+No opening range or collision freedom is implied for arbitrary caller attachments.
+Compiled Generator packages using this operation require runtime 8.0.0 or newer in major 8.
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`KnuckleHingeOptions`](KnuckleHingeOptions.md) · Required
+
+
+
+## Returns
+
+[`KnuckleHinge`](KnuckleHinge-type.md)
+
+
+## Related APIs
+
+- [KnuckleHinge](KnuckleHinge-type.md)
+- [KnuckleHingeOptions](KnuckleHingeOptions.md)
+
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/linearPattern.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.16.0`.

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

@@ -134,4 +134,4 @@ Lofts explicit corresponding contours, including holes and collapsed logical slo
 - [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/matchProfiles.md

@@ -39,4 +39,4 @@ readonly [`CorrespondingProfile`](CorrespondingProfile.md)[]
 - [MatchProfilesOptions](MatchProfilesOptions.md)
 - [Profile](Profile.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -34,4 +34,4 @@ Three-dimensional Minkowski sum.
 - [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/path2.md

@@ -1,11 +1,19 @@
 # path2
 
-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.
+Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization.
 
 **path2**(`input`: [`Path2Input`](Path2Input.md), `options?`: [`PathOptions`](PathOptions.md)): [`Path2`](Path2-type.md)
 
 
 
+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.
+
+Use `toData()` for a frozen record that restores coordinates, closure, and dimension together.
+
 ## Parameters
 
 <a id="input"></a>
@@ -39,4 +47,8 @@ Snapshots finite XY coordinates as an immutable sampled path, independent of eng
 - [Path2Input](Path2Input.md)
 - [PathOptions](PathOptions.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## 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/path3.md

@@ -6,6 +6,8 @@ Snapshots finite XYZ coordinates as an immutable sampled path with the same clos
 
 
 
+Use `toData()` for a frozen record that restores coordinates, closure, and dimension together.
+
 ## Parameters
 
 <a id="input"></a>
@@ -38,5 +40,10 @@ Snapshots finite XYZ coordinates as an immutable sampled path with the same clos
 - [Path3](Path3-type.md)
 - [Path3Input](Path3Input.md)
 - [PathOptions](PathOptions.md)
+- [path2](path2.md)
+
+## 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`.

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

@@ -115,5 +115,6 @@ readonly [`Section`](Section.md)[]
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,6 +1,6 @@
 # polygon
 
-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.
+Fills one closed millimetre XY outline, explicit outer/hole topology, or compound contours.
 
 **polygon**(`input`: [`Path2Input`](Path2Input.md) \| [`PolygonOptions`](PolygonOptions.md)): [`Section`](Section.md)
 
@@ -12,6 +12,9 @@ Fills one closed millimetre XY outline, explicit outer/hole topology, or compoun
 polygon([[0, 0], [20, 0], [10, 12]]).extrude({ height: 3 });
 ```
 
+Closing edges are implicit. Compound contours use nonzero fill unless selected otherwise.
+Explicit topology must be simple and disjoint; compound winding may resolve overlaps.
+
 ## Parameters
 
 <a id="input"></a>
@@ -37,4 +40,4 @@ polygon([[0, 0], [20, 0], [10, 12]]).extrude({ height: 3 });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,11 +1,15 @@
 # preflightInternalThreadCutter
 
-Internal-thread facts using host resolution and limits; requires active synchronous model execution.
+Checks compensated cutter dimensions and conservative mesh estimates against host output limits.
 
 **preflightInternalThreadCutter**(`options`: [`InternalThreadCutterOptions`](InternalThreadCutterOptions.md)): [`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
 
 
 
+Requires active synchronous model execution and uses its resolution and limits. Estimates include
+the one-pitch extension beyond each requested face, without mesh buffers or native objects.
+Mesh validity, native construction, and aggregate output limits are checked later.
+
 ## Parameters
 
 <a id="options"></a>
@@ -81,9 +85,11 @@ Internal-thread facts using host resolution and limits; requires active synchron
 
 - [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
 - [InternalThreadCutterOptions](InternalThreadCutterOptions.md)
+- [internalThreadCutter](internalThreadCutter.md)
 
 ## Guides
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,11 +1,15 @@
 # preflightThreadedNut
 
-Nut/cutter facts using host resolution and limits; requires active synchronous model execution.
+Checks nut dimensions, chamfers, end-face wall, and the extended compensated cutter's allocation plan.
 
 **preflightThreadedNut**(`options`: [`ThreadedNutOptions`](ThreadedNutOptions.md)): [`ThreadedNutPreflight`](ThreadedNutPreflight.md)
 
 
 
+Requires active synchronous model execution and uses its resolution and limits, without mesh
+buffers or native objects. Returned thread estimates cover the cutter, excluding the body and
+Boolean result. Mesh validity, native construction, and aggregate output limits are checked later.
+
 ## Parameters
 
 <a id="options"></a>
@@ -92,9 +96,11 @@ Nut/cutter facts using host resolution and limits; requires active synchronous m
 
 - [ThreadedNutOptions](ThreadedNutOptions.md)
 - [ThreadedNutPreflight](ThreadedNutPreflight.md)
+- [threadedNut](threadedNut.md)
 
 ## Guides
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.