@metamesh/modeling 0.13.0 → 0.14.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 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.
 
 ## 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,6 +22,12 @@ 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. |
 | [PathPatternOptions](../PathPatternOptions.md) | Equal physical arc-length placements along an open or implicitly closed sampled path. |
@@ -29,15 +39,19 @@ Solid and Section methods translate, rotate, scale, mirror and transform return
 
 | API | Summary |
 | --- | --- |
+| [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. |
 | [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. |
+| [PatternSource](../PatternSource.md) | One immutable shape, or a synchronous factory called once per copy in index order. |
+| [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.14.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.14.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 a solid's disconnected surface shells 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 a solid's disconnected surface shells 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.
+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.14.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.14.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.14.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.14.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.14.0`.

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

@@ -52,7 +52,7 @@ 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` \| [`Vector2Tuple`](Vector2Tuple.md) · Optional
 
   Finite uniform or XY scale of the top profile; defaults to one.
 
@@ -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.14.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.14.0`.

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

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

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

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

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

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

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

@@ -39,4 +39,4 @@ readonly [`CorrespondingProfile`](CorrespondingProfile.md)[]
 - [MatchProfilesOptions](MatchProfilesOptions.md)
 - [Profile](Profile.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.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.14.0`.

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

@@ -6,7 +6,7 @@ Physical arc-length copies along a sampled path, with optional tangent orientati
 
 
 
-**pathPattern**(`source`: [`PatternSource`](PatternSource.md), `path`: readonly [`Vector3`](Vector3.md)[], `options`: [`PathPatternOptions`](PathPatternOptions.md)): readonly [`Solid`](Solid.md)[]
+**pathPattern**(`source`: [`PatternSource`](PatternSource.md), `path`: readonly [`Vector3Tuple`](Vector3Tuple.md)[], `options`: [`PathPatternOptions`](PathPatternOptions.md)): readonly [`Solid`](Solid.md)[]
 
 
 
@@ -28,7 +28,7 @@ Physical arc-length copies along a sampled path, with optional tangent orientati
 
 <a id="path"></a>
 
-**`path`** · readonly [`Vector3`](Vector3.md)[] · Required
+**`path`** · readonly [`Vector3Tuple`](Vector3Tuple.md)[] · Required
 
 
 
@@ -58,7 +58,7 @@ readonly [`Solid`](Solid.md)[]
 
 
 
-**pathPattern**(`source`: [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\>, `path`: readonly [`Vector3`](Vector3.md)[], `options`: [`PathPatternOptions`](PathPatternOptions.md)): readonly [`Section`](Section.md)[]
+**pathPattern**(`source`: [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\>, `path`: readonly [`Vector3Tuple`](Vector3Tuple.md)[], `options`: [`PathPatternOptions`](PathPatternOptions.md)): readonly [`Section`](Section.md)[]
 
 
 
@@ -75,7 +75,7 @@ tangent orientation maps +Z to the tangent and rejects when that leaves the plan
 
 <a id="path-1"></a>
 
-**`path`** · readonly [`Vector3`](Vector3.md)[] · Required
+**`path`** · readonly [`Vector3Tuple`](Vector3Tuple.md)[] · Required
 
 
 
@@ -108,11 +108,11 @@ readonly [`Section`](Section.md)[]
 - [PatternSource](PatternSource.md)
 - [Section](Section.md)
 - [Solid](Solid.md)
-- [Vector3](Vector3.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.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -37,4 +37,4 @@ polygon([[0, 0], [20, 0], [10, 12]]).extrude({ height: 3 });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -86,4 +86,4 @@ Allocation-free internal-thread facts.
 
 - [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.14.0`.

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

@@ -97,4 +97,4 @@ Allocation-free nut/cutter facts.
 
 - [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.14.0`.

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

@@ -86,4 +86,4 @@ Allocation-free external-thread facts.
 
 - [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.14.0`.

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

@@ -35,7 +35,7 @@ Repeats one solid about an axis.
 
   Number of solids to return, including the original.
 
-- [`axis`](RadialPatternOptions.md#axis) · [`Vector3`](Vector3.md) · Required
+- [`axis`](RadialPatternOptions.md#axis) · [`Vector3Tuple`](Vector3Tuple.md) · Required
 
   Axis of the right-handed rotation. Its magnitude is ignored.
 
@@ -43,7 +43,7 @@ Repeats one solid about an axis.
 
   Signed rotation from one copy to the next, in degrees.
 
-- [`center`](RadialPatternOptions.md#center) · [`Vector3`](Vector3.md) · Optional
+- [`center`](RadialPatternOptions.md#center) · [`Vector3Tuple`](Vector3Tuple.md) · Optional
 
   Rotation center in world coordinates. Defaults to the origin.
 
@@ -79,7 +79,7 @@ Repeats a filled Section about an axis; placements must preserve its XY plane.
 
   Number of solids to return, including the original.
 
-- [`axis`](RadialPatternOptions.md#axis) · [`Vector3`](Vector3.md) · Required
+- [`axis`](RadialPatternOptions.md#axis) · [`Vector3Tuple`](Vector3Tuple.md) · Required
 
   Axis of the right-handed rotation. Its magnitude is ignored.
 
@@ -87,7 +87,7 @@ Repeats a filled Section about an axis; placements must preserve its XY plane.
 
   Signed rotation from one copy to the next, in degrees.
 
-- [`center`](RadialPatternOptions.md#center) · [`Vector3`](Vector3.md) · Optional
+- [`center`](RadialPatternOptions.md#center) · [`Vector3Tuple`](Vector3Tuple.md) · Optional
 
   Rotation center in world coordinates. Defaults to the origin.
 
@@ -110,4 +110,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.14.0`.

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

@@ -2,7 +2,7 @@
 
 Copies intersections along the finite directed origin-to-endpoint segment.
 
-**rayCast**(`solid`: [`Solid`](Solid.md), `origin`: [`Vector3`](Vector3.md), `endpoint`: [`Vector3`](Vector3.md)): readonly [`SolidRayHit`](SolidRayHit.md)[]
+**rayCast**(`solid`: [`Solid`](Solid.md), `origin`: [`Vector3Tuple`](Vector3Tuple.md), `endpoint`: [`Vector3Tuple`](Vector3Tuple.md)): readonly [`SolidRayHit`](SolidRayHit.md)[]
 
 
 
@@ -16,13 +16,13 @@ Copies intersections along the finite directed origin-to-endpoint segment.
 
 <a id="origin"></a>
 
-**`origin`** · [`Vector3`](Vector3.md) · Required
+**`origin`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
 
 
 
 <a id="endpoint"></a>
 
-**`endpoint`** · [`Vector3`](Vector3.md) · Required
+**`endpoint`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
 
 
 
@@ -35,6 +35,6 @@ readonly [`SolidRayHit`](SolidRayHit.md)[]
 
 - [Solid](Solid.md)
 - [SolidRayHit](SolidRayHit.md)
-- [Vector3](Vector3.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -18,7 +18,7 @@ rectangle({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 
 **`options`** · [`RectangleOptions`](RectangleOptions.md) · Required
 
-- [`size`](RectangleOptions.md#size) · `number` \| [`Vector2`](Vector2.md) · Required
+- [`size`](RectangleOptions.md#size) · `number` \| [`Vector2Tuple`](Vector2Tuple.md) · Required
 
   Positive uniform size or explicit XY extents in millimetres.
 
@@ -56,4 +56,4 @@ rectangle({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -36,4 +36,4 @@ regularPolygon({ radius: 10, sides: 6, 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.14.0`.

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

@@ -71,4 +71,4 @@ revolve(profile!, { revolveDegrees: 270 });
 - [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.14.0`.

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

@@ -39,4 +39,4 @@ solidFromMesh(mesh);
 
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -39,4 +39,4 @@ sphere({ diameter: 20 });
 - [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.14.0`.

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

@@ -51,4 +51,4 @@ readonly \[[`Solid`](Solid.md), [`Solid`](Solid.md)\]
 - [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.14.0`.

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

@@ -63,4 +63,4 @@ readonly \[[`Solid`](Solid.md), [`Solid`](Solid.md)\]
 - [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.14.0`.

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

@@ -60,4 +60,4 @@ star({ outerRadius: 12, innerRadius: 6, points: 5 });
 - [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.14.0`.

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

@@ -0,0 +1,74 @@
+# stroke
+
+Creates a centered-width native Section along a sampled XY path.
+
+**stroke**(`path`: [`Path2`](Path2.md), `options`: [`StrokeOptions`](StrokeOptions.md)): [`Section`](Section.md)
+
+
+
+## Example: Extrude a rounded track
+
+```ts
+stroke([[0, 0], [20, 0], [20, 10]], { width: 3, join: "round", cap: "round" }).extrude({ height: 2 });
+```
+
+Shares caps, joins and physical sampling with Geometry's strokePathRegion. Native union
+resolves overlapping stroke primitives. Session resolution and resource ceilings apply;
+closed paths omit the duplicated seam. Returns an immutable deferred recipe.
+
+## Parameters
+
+<a id="path"></a>
+
+**`path`** · [`Path2`](Path2.md) · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`StrokeOptions`](StrokeOptions.md) · Required
+
+- [`width`](StrokeOptions.md#width) · `number` · Required
+
+  Positive total stroke width in millimetres, centered on the sampled path.
+
+- [`limits`](StrokeOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Explicit path, circular and expanded-profile allocation ceilings.
+
+- [`closed`](StrokeOptions.md#closed) · `boolean` · Optional
+
+  Treat the path as a closed non-duplicated loop. Default: `false`.
+
+- [`cap`](StrokeOptions.md#cap) · [`StrokePathCap`](StrokePathCap.md) · Optional
+
+  End-cap treatment for an open path. Ignored for closed paths. Default: `butt`.
+
+- [`join`](StrokeOptions.md#join) · [`StrokePathJoin`](StrokePathJoin.md) · Optional
+
+  Corner treatment; miters exceeding SVG's default limit of 4 become bevels. Default: `miter`.
+
+- [`resolution`](StrokeOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Physical tessellation policy for round caps and joins.
+
+
+
+## Returns
+
+[`Section`](Section.md)
+
+
+## Related APIs
+
+- [Path2](Path2.md)
+- [Section](Section.md)
+- [StrokeOptions](StrokeOptions.md)
+
+## Guides
+
+- [Section, hole, offset, and extrusion](../../guides/recipes.md#section-hole-offset-and-extrusion)
+- [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/dist/docs/reference/model/svgPathSection.md

@@ -62,4 +62,4 @@ svgPathSection("M0 0H20V12H0Z", { origin: "center", scale: 1 });
 - [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.14.0`.

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

@@ -61,4 +61,4 @@ svgSection(
 - [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.14.0`.