@metamesh/modeling 0.14.0 → 0.15.0

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

@@ -16,7 +16,7 @@ Measurements and optional edge-connected topology from one validated mesh traver
 
 
 
-Number of referenced edge-connected components when `includeTopology` is requested.
+Number of referenced edge-connected boundary shells when `includeTopology` is requested; cavities count separately.
 
 ***
 
@@ -120,4 +120,4 @@ Number of distinct entries in the position buffer.
 
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -76,4 +76,4 @@ Number of distinct entries in the position buffer.
 
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -5,7 +5,7 @@ Dimensions, placement, and tessellation for a hollow Z-axis tube.
 ## Extends
 
 - [`CircularPrimitiveOptions`](CircularPrimitiveOptions.md)
-- [`PrimitivePlacement`](PrimitivePlacement.md)
+- [`PrimitiveAttachment`](PrimitiveAttachment.md)
 
 ## Properties
 
@@ -60,19 +60,19 @@ Operation-level physical tessellation policy over the active model-wide policy.
 
 ***
 
-### placement?
+### attachment?
 
 
 
-`readonly` `optional` **placement?**: [`PrimitivePlacementOptions`](PrimitivePlacementOptions.md)
+`readonly` `optional` **attachment?**: [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md)
 
 
 
-Applied after local construction; Section placement must preserve the XY plane.
+Applied after local construction; Section attachment must preserve the XY plane.
 
 #### Inherited from
 
-[`PrimitivePlacement`](PrimitivePlacement.md).[`placement`](PrimitivePlacement.md#placement)
+[`PrimitiveAttachment`](PrimitiveAttachment.md).[`attachment`](PrimitiveAttachment.md#attachment)
 
 ***
 
@@ -132,12 +132,12 @@ Outer radius in millimetres; greater than [TubeOptions.innerRadius](#innerradius
 - [CircularPrimitiveOptions](CircularPrimitiveOptions.md)
 - [GeometryResolution](GeometryResolution.md)
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
-- [PrimitivePlacement](PrimitivePlacement.md)
-- [PrimitivePlacementOptions](PrimitivePlacementOptions.md)
+- [PrimitiveAttachment](PrimitiveAttachment.md)
+- [PrimitiveAttachmentOptions](PrimitiveAttachmentOptions.md)
 
 ## Guides
 
 - [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -267,4 +267,4 @@ Returns this value's frozen readonly tuple for interchange; repeated calls do no
 - [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.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -17,4 +17,4 @@ An XY tuple or immutable fluent vector accepted by vector operations.
 - [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.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -12,4 +12,4 @@ A two-dimensional Cartesian vector or point.
 - [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -279,4 +279,4 @@ Returns this value's frozen readonly tuple for interchange; repeated calls do no
 - [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.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -17,4 +17,4 @@ An XYZ tuple or immutable fluent vector accepted by vector operations.
 - [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.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -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.14.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.14.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.14.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.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -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.14.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

@@ -34,4 +34,4 @@ union and intersect combine arrays of Sections or Solids; shape.subtract(cutters
 - [Choose the Boolean by the material you want](../../../guides/fundamentals.md#choose-the-boolean-by-the-material-you-want)
 - [Primitive booleans and repeated placement](../../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -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.14.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.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -27,4 +27,4 @@ Use the small shared vocabulary for authored geometry, coordinates, paths, and s
 - [Geometry vocabulary](../../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -8,7 +8,7 @@ Contour is plain point data with an implicit closing edge. Profile is an identif
 
 | 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.14.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.14.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.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -8,9 +8,8 @@ Inspection returns copied scalar facts and finite bounds. Mesh extraction is exp
 
 | API | Summary |
 | --- | --- |
-| [components](../components.md) | Observes a solid's disconnected surface shells as session-restricted solid selections. |
-| [rayCast](../rayCast.md) | Copies intersections along the finite directed origin-to-endpoint segment. |
-| [toTriangleMesh](../toTriangleMesh.md) | Copies a handle to manufacturing mesh buffers. |
+| [components](../components.md) | Observes disconnected material pieces as session-restricted solid selections. |
+| [castSegment](../castSegment.md) | Copies intersections along the finite directed origin-to-endpoint segment. |
 | [isEmpty](../isEmpty.md) | Checks whether a solid or filled section contains no geometry during host execution. |
 | [distance](../distance.md) | Measures the minimum separation between two nonempty solids in millimetres. |
 
@@ -18,6 +17,6 @@ Inspection returns copied scalar facts and finite bounds. Mesh extraction is exp
 
 | API | Summary |
 | --- | --- |
-| [SolidRayHit](../SolidRayHit.md) | Copied surface intersection from a finite directed segment. Distance is in millimetres. |
+| [SolidSegmentHit](../SolidSegmentHit.md) | Copied surface intersection from a finite directed segment. Distance is in millimetres. |
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.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 recipes in the active host execution. toTriangleMesh returns copied manufacturing arrays; final engine output also receives strict mesh analysis. Neither inspection certifies wall thickness, overhangs, printer fit or material behavior.
+inspectSection and inspectSolid copy native scalar facts and bounds 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 recipes
 
 - [Solid inspection](../../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.14.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:
 
@@ -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.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

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

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

@@ -39,9 +39,8 @@ Section is the filled XY modeling value with holes and disconnected components.
 
 | API | Summary |
 | --- | --- |
-| [Path2](../Path2.md) | An ordered, open sequence of two-dimensional points. |
-| [StrokePathCap](../StrokePathCap.md) | End-cap treatment for an open stroked path. |
-| [StrokePathJoin](../StrokePathJoin.md) | Join treatment where adjacent stroked path segments meet. |
+| [StrokeCap](../StrokeCap.md) | End-cap treatment for an open stroked path. |
+| [StrokeJoin](../StrokeJoin.md) | Join treatment where adjacent stroked path segments meet. |
 | [CircleContourOptions](../CircleContourOptions.md) | Circular profile dimensions with exactly one radius or diameter and explicit sampling. |
 | [CircleOptions](../CircleOptions.md) | Circular dimensions with exactly one nominal radius or diameter. |
 | [EllipseContourOptions](../EllipseContourOptions.md) | Ellipse dimensions with exactly one XY radii or full-size tuple and explicit sampling. |
@@ -59,4 +58,4 @@ Section is the filled XY modeling value with holes and disconnected components.
 - [SVG sections: fills and strokes are different inputs](../../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,6 +1,6 @@
 # Printable threads
 
-Construct compensated thread forms and inspect allocation-free preflight facts.
+Construct compensated thread forms and inspect bounded preflight facts.
 
 Thread pitch is adjacent axial spacing; lead equals pitch times starts. Prepare shared thread dimensions once. Constructors enforce safety automatically; optional preflight provides resource estimates or early control-specific validation. Native rods, internal cutters, and nuts share printable fit and end-treatment options. These forms do not certify a structural rating or a metrology class.
 
@@ -9,9 +9,9 @@ Thread pitch is adjacent axial spacing; lead equals pitch times starts. Prepare
 | API | Summary |
 | --- | --- |
 | [internalThreadCutter](../internalThreadCutter.md) | Compensated internal threaded cutter. |
-| [preflightInternalThreadCutter](../preflightInternalThreadCutter.md) | Allocation-free internal-thread facts. |
-| [preflightThreadedNut](../preflightThreadedNut.md) | Allocation-free nut/cutter facts. |
-| [preflightThreadedRod](../preflightThreadedRod.md) | Allocation-free external-thread facts. |
+| [preflightInternalThreadCutter](../preflightInternalThreadCutter.md) | 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. |
 | [threadedNut](../threadedNut.md) | Compensated threaded nut. |
 | [threadedRod](../threadedRod.md) | Compensated external threaded rod. |
 | [threadRidge](../threadRidge.md) | Helical ridge mesh construction. |
@@ -47,4 +47,4 @@ Thread pitch is adjacent axial spacing; lead equals pitch times starts. Prepare
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 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 placement 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.
+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.
 
 ## Functions
 
@@ -29,11 +29,10 @@ Use vector2/vector3 for immutable arithmetic and transform2/transform3 for reusa
 | [Vector2](../Vector2-type.md) | Immutable XY arithmetic; vector operations return new values and measurements return numbers. |
 | [Vector3](../Vector3-type.md) | Immutable XYZ arithmetic; vector operations return new values and measurements return numbers. |
 | [Anchor3](../Anchor3.md) | An attachment pose on a solid or assembly. |
-| [AttachOptions](../AttachOptions.md) | Degree-based anchor attachment controls for a scoped solid. |
+| [AttachOptions](../AttachOptions.md) | Options controlling how one anchor is attached to another. |
 | [PathPatternOptions](../PathPatternOptions.md) | Equal physical arc-length placements along an open or implicitly closed sampled path. |
-| [PrimitivePlacement](../PrimitivePlacement.md) | Placement shared by solid and filled-section factories. |
-| [PrimitivePlacementOptions](../PrimitivePlacementOptions.md) | Maps an explicit or named shape-local attachment anchor onto a world-space anchor. |
-| [RadialPatternOptions](../RadialPatternOptions.md) | Options for repeating one solid around an axis through a center point. |
+| [PrimitiveAttachment](../PrimitiveAttachment.md) | Anchor attachment shared by solid and filled-section factories. |
+| [PrimitiveAttachmentOptions](../PrimitiveAttachmentOptions.md) | Maps an explicit or named shape-local attachment anchor onto a world-space anchor. |
 
 ## Type aliases
 
@@ -43,9 +42,10 @@ Use vector2/vector3 for immutable arithmetic and transform2/transform3 for reusa
 | [Transform3Input](../Transform3Input.md) | An immutable XYZ transform or its canonical row-major matrix for interchange. |
 | [Vector2Input](../Vector2Input.md) | An XY tuple or immutable fluent vector accepted by vector operations. |
 | [Vector3Input](../Vector3Input.md) | An XYZ tuple or immutable fluent vector accepted by vector operations. |
-| [GridPatternOptions](../GridPatternOptions.md) | XY or XYZ grid with X varying fastest. The first item starts at the local origin. |
-| [LinearPatternOptions](../LinearPatternOptions.md) | Equal linear intervals determined by exactly two of count, spacing and total length. |
+| [GridPatternOptions](../GridPatternOptions.md) | XY or XYZ grid with X varying fastest. The first item starts at the local origin. Dimension 2 restricts counts and spacing to XY; any frame must preserve the XY plane. |
+| [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. |
 
@@ -54,4 +54,4 @@ Use vector2/vector3 for immutable arithmetic and transform2/transform3 for reusa
 - [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.14.0`.
+Package: `@metamesh/modeling@0.15.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.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,6 +1,6 @@
 # components
 
-Observes a solid's disconnected surface shells as session-restricted solid selections.
+Observes disconnected material pieces as session-restricted solid selections.
 
 ## Call Signature
 
@@ -19,11 +19,11 @@ const pieces = components(islands);
 union(pieces.map((piece, index) => piece.translate([0, 0, index * 6])));
 ```
 
-Observes a solid's disconnected surface shells as session-restricted solid selections.
+Observes disconnected material pieces as session-restricted solid selections.
 
-For solids without enclosed cavities, these shells are the disconnected material islands.
-Enclosed cavities produce separate inward shells with negative signed volume; these cannot
-be finalized alone as manufacturing parts. This does not cut connected geometry.
+Each piece retains its enclosed cavities. A sealed hollow box is one component; adding a loose
+ball inside its cavity produces two. Recombining the pieces preserves the original material.
+This does not cut connected geometry. Containment is bounded to 2,000,000 comparisons.
 Selection order and cardinality depend on evaluated topology. Results and recipes using them
 can only be evaluated in this session; composition itself requires no engine.
 
@@ -68,4 +68,4 @@ readonly [`Section`](Section.md)[]
 - [Section](Section.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.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.14.0`.
+Package: `@metamesh/modeling@0.15.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.14.0`.
+Package: `@metamesh/modeling@0.15.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.14.0`.
+Package: `@metamesh/modeling@0.15.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.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -52,11 +52,11 @@ extrude(profile!, { height: 8 });
 
   Operation-level physical policy over the nearest model scope.
 
-- [`scaleTop`](ExtrudeOptions.md#scaletop) · `number` \| [`Vector2Tuple`](Vector2Tuple.md) · Optional
+- [`scaleTop`](ExtrudeOptions.md#scaletop) · `number` \| [`Vector2Input`](Vector2Input.md) · Optional
 
   Finite uniform or XY scale of the top profile; defaults to one.
 
-- [`twistDegrees`](ExtrudeOptions.md#twistdegrees) · `number` · Optional
+- [`twist`](ExtrudeOptions.md#twist) · `number` · Optional
 
   Finite rotation of the top profile about +Z, in degrees; defaults to zero.
 
@@ -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.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -43,4 +43,4 @@ const model = generate<{ height: number }>(({ params, part, assert }) => {
 - [GenerateCallback](GenerateCallback.md)
 - [ModelProgram](ModelProgram.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -40,11 +40,11 @@ readonly [`Solid`](Solid.md)[]
 
 
 
-**gridPattern**(`source`: [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\>, `options`: [`GridPatternOptions`](GridPatternOptions.md)): readonly [`Section`](Section.md)[]
+**gridPattern**(`source`: [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\>, `options`: [`GridPatternOptions`](GridPatternOptions.md)\<`2`\>): readonly [`Section`](Section.md)[]
 
 
 
-Repeats a filled Section on a grid; placements must preserve its XY plane.
+Repeats a filled Section on an XY grid; any explicit frame must preserve the XY plane.
 
 ### Parameters
 
@@ -56,7 +56,7 @@ Repeats a filled Section on a grid; placements must preserve its XY plane.
 
 <a id="options-1"></a>
 
-**`options`** · [`GridPatternOptions`](GridPatternOptions.md) · Required
+**`options`** · [`GridPatternOptions`](GridPatternOptions.md)\<`2`\> · Required
 
 
 
@@ -77,4 +77,4 @@ 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)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -37,4 +37,4 @@ heightfield({
 - [HeightfieldOptions](HeightfieldOptions.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.