@metamesh/modeling 0.13.0 → 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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,16 +1,16 @@
 # 2D Sections
 
-Create native filled XY sections, including prepared text and bounded painted SVG.
+Create immutable filled XY shapes, including prepared text and bounded painted SVG.
 
-A Section is a filled native XY shape with holes and disconnected components. rectangle, circle, ellipse, regularPolygon and star take object options. Boolean and offset chains stay native until an explicit toRegion conversion. textSection consumes prepared VectorTextLayout without shaping again. Extrusion and revolution preserve filled topology; sweeps retain all contours. Compatible primitive Sections retain their authored landmarks for direct lofting; arbitrary Sections require explicit vertex correspondence. `polygon(points)` fills a single implicit closed contour. `polygon({ outer, holes })` validates explicit topology; `polygon({ contours, fillRule })` resolves compound winding with nonzero fill by default or evenodd fill. All forms return a Section.
+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.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
+| [stroke](../stroke.md) | Creates a centered-width native Section along a sampled XY path. |
 | [circle](../circle.md) | Centered circular section. |
 | [ellipse](../ellipse.md) | Centered elliptical section. |
-| [fromRegion](../fromRegion.md) | Imports explicit region topology once. |
 | [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. |
@@ -18,16 +18,16 @@ A Section is a filled native XY shape with holes and disconnected components. re
 | [svgPathSection](../svgPathSection.md) | Imports bounded filled SVG path data. |
 | [svgSection](../svgSection.md) | Imports bounded painted SVG document geometry. |
 | [textSection](../textSection.md) | Consumes a previously prepared layout; never shapes or fetches a font. |
-| [toRegion](../toRegion.md) | Explicit copied topology inspection; not needed for section operations. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [Section](../Section.md) | Immutable deferred filled XY section recipe belonging to exactly one model session. Methods run during synchronous generation and preserve their receiver. Distances use millimetres; rotations are counterclockwise degrees about the origin. Construction uses the session resolution unless the operation supplies explicit options. |
+| [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. |
+| [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. |
-| [RegionOffsetOptions](../RegionOffsetOptions.md) | Options controlling robust Clipper2 region offsets. |
+| [SectionOffsetOptions](../SectionOffsetOptions.md) | Options controlling robust Clipper2 region offsets. |
 | [StarOptions](../StarOptions.md) | Alternating outer and inner vertices, centered on the XY origin. |
 | [SvgPathSectionOptions](../SvgPathSectionOptions.md) | Bounded filled SVG path sampling. Path scale converts user units to millimetres. |
 | [SvgSectionOptions](../SvgSectionOptions.md) | Bounded SVG document sampling. Center origin uses the final painted bounds. |
@@ -39,6 +39,8 @@ A Section is a filled native XY shape with holes and disconnected components. re
 
 | API | Summary |
 | --- | --- |
+| [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. |
@@ -46,7 +48,7 @@ A Section is a filled native XY shape with holes and disconnected components. re
 | [RectangleCornerTreatment](../RectangleCornerTreatment.md) | A rectangle corner, including an explicitly untreated corner in a treatment tuple. |
 | [RectangleCornerTreatments](../RectangleCornerTreatments.md) | Corner treatments ordered top-right, top-left, bottom-left, bottom-right. |
 | [RegularPolygonOptions](../RegularPolygonOptions.md) | Regular polygon dimensions, radial convention and degree rotation. |
-| [RegionOffsetJoin](../RegionOffsetJoin.md) | Clipper2 join styles accepted by robust region offsets. |
+| [SectionOffsetJoin](../SectionOffsetJoin.md) | Clipper2 join styles accepted by robust region offsets. |
 | [PolygonOptions](../PolygonOptions.md) | Explicit polygon topology or compound contours; all closing edges are implicit. |
 | [SvgOrigin](../SvgOrigin.md) | Placement of painted SVG geometry after SVG Y-axis inversion. |
 
@@ -56,4 +58,4 @@ A Section is a filled native XY shape with holes and disconnected components. re
 - [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/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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,13 +1,17 @@
-# Transforms & Placement
+# Transforms, Vectors & Placement
 
-Transform 2D sections and 3D solids; arrange and attach solids with explicit placement contracts.
+Calculate with immutable vectors, reuse transforms, and arrange geometry with explicit placement contracts.
 
-Solid and Section methods translate, rotate, scale, mirror and transform return immutable same-dimensional recipes. Sections use XY vectors and counterclockwise degree rotations; solids use XYZ vectors and degree Euler angles. Calls apply in written order about the origin: translating then rotating also rotates the translated position. Transform2 and Transform3 are row-major affine matrices. Solid.attach and primitive placement share source/target anchors, alignment, millimetre gap and degree spin. withAnchors adds explicit datums to either shape. Patterns return same-session Solid or Section arrays; Section placements must preserve XY. Pure *PatternTransforms expose matching placements from /geometry. Place completed parts through part options so placement can reuse 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
 
 | 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. |
 | [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. |
@@ -18,26 +22,36 @@ Solid and Section methods translate, rotate, scale, mirror and transform return
 
 | API | Summary |
 | --- | --- |
+| [Transform2](../Transform2-type.md) | Immutable reusable XY placement. Methods apply in written order; angles are degrees. |
+| [Transform3](../Transform3-type.md) | Immutable reusable XYZ placement. Methods apply in written order; angles are degrees. |
+| [Pivot2Options](../Pivot2Options.md) | A fixed XY point in world coordinates; omitted pivots use the coordinate origin. |
+| [Pivot3Options](../Pivot3Options.md) | A fixed XYZ point in world coordinates; omitted pivots use the coordinate origin. |
+| [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
 
 | API | Summary |
 | --- | --- |
-| [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. |
-| [PatternSource](../PatternSource.md) | One same-session shape, or a synchronous factory called once per copy in index order. |
-| [Transform2](../Transform2.md) | Row-major affine XY matrix. Translation occupies m02/m12; final row is [0, 0, 1]. |
-| [Transform3](../Transform3.md) | A row-major affine 4x4 matrix applied to column vectors. |
+| [Transform2Input](../Transform2Input.md) | An immutable XY transform or its canonical row-major matrix for interchange. |
+| [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. 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. |
 
 ## 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.13.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,6 +1,6 @@
 # components
 
-Separates a solid's disconnected surface shells into same-session solid handles.
+Observes disconnected material pieces as session-restricted solid selections.
 
 ## Call Signature
 
@@ -19,11 +19,13 @@ const pieces = components(islands);
 union(pieces.map((piece, index) => piece.translate([0, 0, index * 6])));
 ```
 
-Separates a solid's disconnected surface shells into same-session solid handles.
+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.
 
 ### Parameters
 
@@ -45,7 +47,8 @@ readonly [`Solid`](Solid.md)[]
 
 
 
-Separates filled 2D islands into sections, retaining each island's holes; empty gives [].
+Observes filled 2D islands, retaining each island's holes; empty gives [].
+Selections and recipes using them can only be evaluated in this session.
 
 ### Parameters
 
@@ -65,4 +68,4 @@ readonly [`Section`](Section.md)[]
 - [Section](Section.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.13.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.13.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -17,7 +17,7 @@ const gap = distance(left, right); // 3 mm
 Uses actual geometry, not bounding-box separation or distance between object origins.
 Contact or overlapping material returns zero, including one solid inside another.
 The kernel's search range is managed internally; the result is not capped at a caller limit.
-Empty, expired or foreign-build handles reject. Results follow native numeric precision.
+Empty geometry and component selections from another session reject. Results follow native numeric precision.
 
 ## Parameters
 
@@ -42,4 +42,4 @@ Empty, expired or foreign-build handles reject. Results follow native numeric pr
 
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.13.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.13.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` \| [`Vector2`](Vector2.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.13.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.13.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.
+Closed rectilinear top above a flat base, with uniform or explicit XY coordinates. Samples each grid height once; center-error triangulation also samples each cell centre. The retained callback must capture independent immutable inputs, not live session readers or parameters.
 
 **heightfield**(`options`: [`HeightfieldOptions`](HeightfieldOptions.md)): [`Solid`](Solid.md)
 
@@ -37,4 +37,4 @@ heightfield({
 - [HeightfieldOptions](HeightfieldOptions.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

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

@@ -41,4 +41,4 @@ editable[0] = 8; // heights still contains 2, 4, 6.
 - [ImmutableBuffer](ImmutableBuffer-type.md)
 - [NumericArray](NumericArray.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -37,4 +37,4 @@ const model = generate(({ computed, part }) => {
 - [ImmutableTriangleMesh](ImmutableTriangleMesh.md)
 - [TriangleMesh](TriangleMesh.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,6 +1,6 @@
 # implicit
 
-Bounded positive-inside implicit field constructor.
+Bounded positive-inside implicit field constructor. The retained callback must capture independent immutable inputs, not live session readers or parameters.
 
 **implicit**(`options`: [`ImplicitOptions`](ImplicitOptions.md)): [`Solid`](Solid.md)
 
@@ -12,7 +12,7 @@ Bounded positive-inside implicit field constructor.
 
 **`options`** · [`ImplicitOptions`](ImplicitOptions.md) · Required
 
-- [`field`](ImplicitOptions.md#field) · (`point`: [`Vector3`](Vector3.md)) => `number` · Required
+- [`field`](ImplicitOptions.md#field) · (`point`: [`Vector3Tuple`](Vector3Tuple.md)) => `number` · Required
 
   Positive-inside scalar field evaluated at finite XYZ points.
 
@@ -44,4 +44,4 @@ Bounded positive-inside implicit field constructor.
 - [ImplicitOptions](ImplicitOptions.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -10,8 +10,8 @@ Compensated internal threaded cutter.
 
 ```ts
 import { cylinder, internalThreadCutter } from "@metamesh/modeling";
-import { createThreadProfile } from "@metamesh/modeling/geometry";
-const profile = createThreadProfile({ kind: "triangular", pitch: 1.75 });
+import { threadProfile } from "@metamesh/modeling/geometry";
+const profile = threadProfile({ kind: "triangular", pitch: 1.75 });
 const body = cylinder({ diameter: 20, height: 12, center: false });
 const cutter = internalThreadCutter({ nominalMajorDiameter: 12, length: 12, profile });
 body.subtract([cutter]);
@@ -48,7 +48,7 @@ body.subtract([cutter]);
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](InternalThreadCutterOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](InternalThreadCutterOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -97,4 +97,4 @@ body.subtract([cutter]);
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,6 +1,6 @@
 # isEmpty
 
-Checks whether a same-session solid or filled section contains no geometry.
+Checks whether a solid or filled section contains no geometry during host execution.
 
 **isEmpty**(`shape`: [`Solid`](Solid.md) \| [`Section`](Section.md)): `boolean`
 
@@ -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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -40,11 +40,11 @@ readonly [`Solid`](Solid.md)[]
 
 
 
-**linearPattern**(`source`: [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\>, `options`: [`LinearPatternOptions`](LinearPatternOptions.md)): readonly [`Section`](Section.md)[]
+**linearPattern**(`source`: [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\>, `options`: [`LinearPatternOptions`](LinearPatternOptions.md)\<`2`\>): readonly [`Section`](Section.md)[]
 
 
 
-Repeats a filled Section; every placement must preserve its XY plane.
+Repeats a filled Section along an XY direction, defaulting to +X.
 
 ### Parameters
 
@@ -56,7 +56,7 @@ Repeats a filled Section; every placement must preserve its XY plane.
 
 <a id="options-1"></a>
 
-**`options`** · [`LinearPatternOptions`](LinearPatternOptions.md) · Required
+**`options`** · [`LinearPatternOptions`](LinearPatternOptions.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,6 +1,6 @@
 # matchProfiles
 
-Explicit family matching on a shared physical span grid using session or operation resolution.
+Matches a profile family using operation settings over host resolution and limits. Requires active synchronous model execution. Use Geometry's matchProfiles for standalone preparation.
 
 **matchProfiles**(`profiles`: readonly [`Profile`](Profile.md)[], `options?`: [`MatchProfilesOptions`](MatchProfilesOptions.md)): readonly [`CorrespondingProfile`](CorrespondingProfile.md)[]
 
@@ -39,4 +39,4 @@ readonly [`CorrespondingProfile`](CorrespondingProfile.md)[]
 - [MatchProfilesOptions](MatchProfilesOptions.md)
 - [Profile](Profile.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -0,0 +1,42 @@
+# 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.
+
+**path2**(`input`: [`Path2Input`](Path2Input.md), `options?`: [`PathOptions`](PathOptions.md)): [`Path2`](Path2-type.md)
+
+
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Path2Input`](Path2Input.md) · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`PathOptions`](PathOptions.md) · Optional
+
+- [`closed`](PathOptions.md#closed) · `boolean` · Optional
+
+  Connects the last vertex to the first; closed paths omit the repeated seam. Defaults to false.
+
+- [`limits`](PathOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Construction point ceiling; defaults to package sampling limits. Later sampling has its own options.
+
+
+
+## Returns
+
+[`Path2`](Path2-type.md)
+
+
+## Related APIs
+
+- [Path2](Path2-type.md)
+- [Path2Input](Path2Input.md)
+- [PathOptions](PathOptions.md)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -0,0 +1,42 @@
+# path3
+
+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.
+
+**path3**(`input`: [`Path3Input`](Path3Input.md), `options?`: [`PathOptions`](PathOptions.md)): [`Path3`](Path3-type.md)
+
+
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Path3Input`](Path3Input.md) · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`PathOptions`](PathOptions.md) · Optional
+
+- [`closed`](PathOptions.md#closed) · `boolean` · Optional
+
+  Connects the last vertex to the first; closed paths omit the repeated seam. Defaults to false.
+
+- [`limits`](PathOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Construction point ceiling; defaults to package sampling limits. Later sampling has its own options.
+
+
+
+## Returns
+
+[`Path3`](Path3-type.md)
+
+
+## Related APIs
+
+- [Path3](Path3-type.md)
+- [Path3Input](Path3Input.md)
+- [PathOptions](PathOptions.md)
+
+Package: `@metamesh/modeling@0.15.0`.