@metamesh/modeling 0.13.0 → 0.15.0

package/dist/docs/reference/model/Vector3-type.md

@@ -0,0 +1,282 @@
+# Vector3
+
+Immutable XYZ arithmetic; vector operations return new values and measurements return numbers.
+
+## Properties
+
+### x
+
+
+
+`readonly` **x**: `number`
+
+
+
+X coordinate in the vector's coordinate units.
+
+***
+
+### y
+
+
+
+`readonly` **y**: `number`
+
+
+
+Y coordinate in the vector's coordinate units.
+
+***
+
+### z
+
+
+
+`readonly` **z**: `number`
+
+
+
+Z coordinate in the vector's coordinate units.
+
+## Methods
+
+### add()
+
+
+
+**add**(`other`: [`Vector3Input`](Vector3Input.md)): `Vector3`
+
+
+
+Adds another vector component-wise.
+
+#### Parameters
+
+<a id="other"></a>
+
+**`other`** · [`Vector3Input`](Vector3Input.md) · Required
+
+
+
+#### Returns
+
+`Vector3`
+
+***
+
+### subtract()
+
+
+
+**subtract**(`other`: [`Vector3Input`](Vector3Input.md)): `Vector3`
+
+
+
+Subtracts another vector component-wise.
+
+#### Parameters
+
+<a id="other-1"></a>
+
+**`other`** · [`Vector3Input`](Vector3Input.md) · Required
+
+
+
+#### Returns
+
+`Vector3`
+
+***
+
+### scale()
+
+
+
+**scale**(`factor`: `number`): `Vector3`
+
+
+
+Multiplies by a finite dimensionless scalar.
+
+#### Parameters
+
+<a id="factor"></a>
+
+**`factor`** · `number` · Required
+
+
+
+#### Returns
+
+`Vector3`
+
+***
+
+### normalize()
+
+
+
+**normalize**(`epsilon?`: `number`): `Vector3`
+
+
+
+Returns a unit vector; rejects length at or below finite nonnegative `epsilon` (default `1e-12`).
+
+#### Parameters
+
+<a id="epsilon"></a>
+
+**`epsilon`** · `number` · Optional
+
+
+
+#### Returns
+
+`Vector3`
+
+***
+
+### lerp()
+
+
+
+**lerp**(`other`: [`Vector3Input`](Vector3Input.md), `t`: `number`): `Vector3`
+
+
+
+Interpolates toward another vector by finite dimensionless `t`; extrapolation is allowed.
+
+#### Parameters
+
+<a id="other-2"></a>
+
+**`other`** · [`Vector3Input`](Vector3Input.md) · Required
+
+
+
+<a id="t"></a>
+
+**`t`** · `number` · Required
+
+
+
+#### Returns
+
+`Vector3`
+
+***
+
+### dot()
+
+
+
+**dot**(`other`: [`Vector3Input`](Vector3Input.md)): `number`
+
+
+
+Returns the scalar dot product.
+
+#### Parameters
+
+<a id="other-3"></a>
+
+**`other`** · [`Vector3Input`](Vector3Input.md) · Required
+
+
+
+#### Returns
+
+`number`
+
+***
+
+### cross()
+
+
+
+**cross**(`other`: [`Vector3Input`](Vector3Input.md)): `Vector3`
+
+
+
+Returns the right-handed cross product as a new vector.
+
+#### Parameters
+
+<a id="other-4"></a>
+
+**`other`** · [`Vector3Input`](Vector3Input.md) · Required
+
+
+
+#### Returns
+
+`Vector3`
+
+***
+
+### length()
+
+
+
+**length**(): `number`
+
+
+
+Returns Euclidean length in the vector's coordinate units.
+
+#### Returns
+
+`number`
+
+***
+
+### distance()
+
+
+
+**distance**(`other`: [`Vector3Input`](Vector3Input.md)): `number`
+
+
+
+Returns Euclidean distance to another vector in the same coordinate units.
+
+#### Parameters
+
+<a id="other-5"></a>
+
+**`other`** · [`Vector3Input`](Vector3Input.md) · Required
+
+
+
+#### Returns
+
+`number`
+
+***
+
+### toArray()
+
+
+
+**toArray**(): [`Vector3Tuple`](Vector3Tuple.md)
+
+
+
+Returns this value's frozen readonly tuple for interchange; repeated calls do not allocate.
+
+#### Returns
+
+[`Vector3Tuple`](Vector3Tuple.md)
+
+
+## Related APIs
+
+- [Vector3Input](Vector3Input.md)
+- [Vector3Tuple](Vector3Tuple.md)
+
+## Guides
+
+- [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
+- [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -0,0 +1,20 @@
+# Vector3Input
+
+An XYZ tuple or immutable fluent vector accepted by vector operations.
+
+**Vector3Input** = [`Vector3Tuple`](Vector3Tuple.md) \| [`Vector3`](Vector3-type.md)
+
+
+
+
+## Related APIs
+
+- [Vector3](Vector3-type.md)
+- [Vector3Tuple](Vector3Tuple.md)
+
+## Guides
+
+- [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
+- [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/model/{Vector3.md → Vector3Tuple.md}

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

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

@@ -37,4 +37,4 @@ Exact measurements of these paths and their logical text layout.
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -97,4 +97,4 @@ Number of lines, including empty and trailing lines; empty text occupies one lin
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -43,4 +43,4 @@ anchor(plate, "top"); // position [0, 0, 3], direction [0, 0, 1]
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -22,7 +22,7 @@ box({ size: [30, 20, 8], treatment: { kind: "round", radius: 2 } });
 
 **`options`** · [`BoxOptions`](BoxOptions.md) · Required
 
-- [`size`](BoxOptions.md#size) · `number` \| [`Vector3`](Vector3.md) · Required
+- [`size`](BoxOptions.md#size) · `number` \| [`Vector3Tuple`](Vector3Tuple.md) · Required
 
   Positive uniform size or explicit `[X, Y, Z]` extents in millimetres.
 
@@ -38,9 +38,9 @@ box({ size: [30, 20, 8], treatment: { kind: "round", radius: 2 } });
 
   Uniform treatment or independent disjoint nominal edge/group treatments.
 
-- [`placement`](BoxOptions.md#placement) · [`PrimitivePlacementOptions`](PrimitivePlacementOptions.md) · Optional
+- [`attachment`](BoxOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
 
-  Applied after local construction; Section placement must preserve the XY plane.
+  Applied after local construction; Section attachment must preserve the XY plane.
 
 
 
@@ -59,4 +59,4 @@ box({ size: [30, 20, 8], treatment: { kind: "round", radius: 2 } });
 - [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -0,0 +1,40 @@
+# castSegment
+
+Copies intersections along the finite directed origin-to-endpoint segment.
+
+**castSegment**(`solid`: [`Solid`](Solid.md), `origin`: [`Vector3Input`](Vector3Input.md), `endpoint`: [`Vector3Input`](Vector3Input.md)): readonly [`SolidSegmentHit`](SolidSegmentHit.md)[]
+
+
+
+## Parameters
+
+<a id="solid"></a>
+
+**`solid`** · [`Solid`](Solid.md) · Required
+
+
+
+<a id="origin"></a>
+
+**`origin`** · [`Vector3Input`](Vector3Input.md) · Required
+
+
+
+<a id="endpoint"></a>
+
+**`endpoint`** · [`Vector3Input`](Vector3Input.md) · Required
+
+
+
+## Returns
+
+readonly [`SolidSegmentHit`](SolidSegmentHit.md)[]
+
+
+## Related APIs
+
+- [Solid](Solid.md)
+- [SolidSegmentHit](SolidSegmentHit.md)
+- [Vector3Input](Vector3Input.md)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 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 same-session solids, sections, 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.
+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.
 
 ## Functions
 
@@ -26,12 +26,12 @@ union and intersect combine arrays of Sections or Solids; shape.subtract(cutters
 
 | API | Summary |
 | --- | --- |
-| [HullOptions](../HullOptions.md) | Hull inputs are either finite points or same-session solids. |
-| [SectionHullOptions](../SectionHullOptions.md) | Planar convex hull inputs are finite XY points or same-session filled sections. |
+| [HullOptions](../HullOptions.md) | Hull inputs are either finite points or solid recipes. |
+| [SectionHullOptions](../SectionHullOptions.md) | Planar convex hull inputs are finite XY points or filled section recipes. |
 
 ## Guides
 
 - [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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/model/categories/bounded-surfaces.md

@@ -8,8 +8,8 @@ Heightfields accept uniform or explicit uneven XY coordinates and close absolute
 
 | 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. |
-| [implicit](../implicit.md) | Bounded positive-inside implicit field constructor. |
+| [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. |
+| [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 +23,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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 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 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.
 
 ## Interfaces
 
@@ -13,4 +13,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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -9,7 +9,7 @@ Use the small shared vocabulary for authored geometry, coordinates, paths, and s
 | API | Summary |
 | --- | --- |
 | [Frame3](../Frame3.md) | A right-handed orthonormal coordinate frame expressed in world coordinates. |
-| [Polygon](../Polygon-type.md) | One bounded two-dimensional polygon. |
+| [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. |
 
@@ -18,13 +18,13 @@ Use the small shared vocabulary for authored geometry, coordinates, paths, and s
 | API | Summary |
 | --- | --- |
 | [Contour](../Contour.md) | A closed two-dimensional boundary whose first point is not repeated at the end. |
-| [Region](../Region.md) | A two-dimensional region represented by disjoint filled polygons. |
-| [Vector2](../Vector2.md) | A two-dimensional Cartesian vector or point. |
-| [Vector3](../Vector3.md) | A three-dimensional Cartesian vector or point. |
+| [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. |
 
 ## Guides
 
 - [Geometry vocabulary](../../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,13 +2,13 @@
 
 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 native 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 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.
 
 ## 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
 
@@ -29,4 +29,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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 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.
+`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.
 
 ## Functions
 
@@ -39,4 +39,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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -41,4 +41,4 @@ 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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,23 +1,22 @@
 # Solid inspection
 
-Inspect and convert session-owned recipes while retaining host ownership.
+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. A handle belongs to one session and cannot cross a worker or be used after session disposal. 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. 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.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [components](../components.md) | Separates a solid's disconnected surface shells into same-session solid handles. |
-| [rayCast](../rayCast.md) | Copies intersections along the finite directed origin-to-endpoint segment. |
-| [toTriangleMesh](../toTriangleMesh.md) | Copies a handle to manufacturing mesh buffers. |
-| [isEmpty](../isEmpty.md) | Checks whether a same-session solid or filled section contains no geometry. |
+| [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. |
 
 ## Interfaces
 
 | 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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 Convert validated meshes and inspect stable section or solid measurements.
 
-inspectSection and inspectSolid copy native scalar facts and bounds from same-build handles. 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 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.
 
 ## Functions
 
@@ -26,4 +26,4 @@ inspectSection and inspectSolid copy native scalar facts and bounds from same-bu
 
 - [Solid inspection](../../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -0,0 +1,33 @@
+# Sampled paths
+
+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.
+
+## 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. |
+| [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. |
+
+## 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. |
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 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. `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.
 
 Use imported primitives inside generation:
 
@@ -29,7 +29,7 @@ export default generate(({ part }) => {
 
 | API | Summary |
 | --- | --- |
-| [Solid](../Solid.md) | Immutable deferred solid recipe belonging to exactly one model session. Methods run during synchronous generation, preserve their receiver, 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. 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. |
 | [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 +58,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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.