@metamesh/modeling 0.14.0 → 0.16.0

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

@@ -1,17 +1,24 @@
-# Transforms, Vectors & Placement
+# Transforms, vectors, and placement
 
 Calculate with immutable vectors, reuse transforms, and arrange geometry with explicit placement contracts.
 
-Use vector2/vector3 for immutable arithmetic and transform2/transform3 for reusable placements. Tuples are accepted as operands; scalar dot, length and distance return numbers. Shape.transform accepts a matching transform directly. Operations apply in written order, rotations use degrees, and optional `{ pivot }` points use world coordinates, defaulting to the origin. andThen composes placements in execution order. applyPoint includes translation, applyDirection retains scale without translation, and applyNormal uses the inverse transpose and returns a unit vector. toArray and toMatrix expose canonical data for interchange. Solid.attach and primitive 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; `dot()`, `length()`, and `distance()` return numbers. Shape `transform()` methods accept matching transforms directly.
+
+- **Order and units:** operations and `andThen()` composition apply in written order. Rotations use degrees. Optional `{ pivot }` points use world coordinates and default to the origin.
+- **Transformed values:** `applyPoint()` includes translation; `applyDirection()` retains scale without translation; `applyNormal()` uses the inverse transpose and returns a unit vector.
+- **Interchange:** `toData()` returns canonical data. `to3D()` embeds XY placements explicitly; `to2D()` rejects plane changes.
+- **Attachment:** `Solid.attach()` and primitive attachment share source/target anchors, alignment, millimetre gap, and degree spin. Part placement can reuse finished geometry.
+- **Section patterns:** use XY directions and `Path2` trajectories. Tangent orientation aligns local +X in the XY plane; radial patterns use an XY pivot and implicit +Z axis.
+- **Solid patterns:** use XYZ inputs and explicit radial axes. Path tangent orientation aligns local +Z.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [transform2](../transform2.md) | Creates an immutable XY transform, identity by default. Matrices are copied and validated. Pass it directly to Section.transform() and planar data helpers; to3D() explicitly crosses into XYZ. Zero scales and singular matrices throw GeometryError; negative scales reflect. |
-| [transform3](../transform3.md) | Creates an immutable XYZ transform, identity by default. Matrices are copied and validated. Calls apply in written order; rotations use degrees and pivots use current world coordinates. Zero scales, singular matrices, nonfinite inputs and zero rotation axes throw GeometryError. Use frameTransform3(frame) as the input for existing orthonormal frame placement. |
-| [vector2](../vector2.md) | Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates. Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates and overflow throw `NON_FINITE_VALUE` GeometryError. Use transform2().applyDirection(value) for rotations and nonuniform scaling. |
-| [vector3](../vector3.md) | Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates. Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates and overflow throw `NON_FINITE_VALUE` GeometryError. Use transform3().applyDirection(value) for rotations and nonuniform scaling. |
+| [transform2](../transform2.md) | Creates an immutable XY transform, identity by default. |
+| [transform3](../transform3.md) | Creates an immutable XYZ transform, identity by default. |
+| [vector2](../vector2.md) | Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates. |
+| [vector3](../vector3.md) | Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates. |
 | [anchor](../anchor.md) | Reads a copied, immutable named anchor from this exact active generation. |
 | [gridPattern](../gridPattern.md) | XY or XYZ copies, optionally centered or placed in an explicit frame. |
 | [linearPattern](../linearPattern.md) | Repeats one solid along a normalized direction. |
@@ -29,11 +36,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,15 +49,17 @@ 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. |
-| [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. |
+| [RadialPatternOptions](../RadialPatternOptions.md) | Degree rotations about a fixed world-space pivot; XY patterns use the implicit +Z axis. |
+| [Transform2Data](../Transform2Data.md) | A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`. |
+| [Transform3Data](../Transform3Data.md) | A row-major affine 4x4 matrix applied to column vectors. |
 
 ## Guides
 
 - [Named anchors and custom frames](../../../guides/recipes.md#named-anchors-and-custom-frames)
 - [Primitive booleans and repeated placement](../../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+- [Fluent values and standalone algorithms](../../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -36,4 +36,4 @@ circle({ diameter: 12, sizing: "face" });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.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.16.0`.

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

@@ -28,4 +28,4 @@ Combines disjoint components without resolving overlap.
 - [Choose the Boolean by the material you want](../../guides/fundamentals.md#choose-the-boolean-by-the-material-you-want)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -49,4 +49,4 @@ cylinder({ height: 20, radius: [10, 0] });
 - [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -42,4 +42,4 @@ Empty geometry and component selections from another session reject. Results fol
 
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -36,4 +36,4 @@ ellipse({ size: [30, 20] });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.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.16.0`.

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

@@ -43,4 +43,8 @@ const model = generate<{ height: number }>(({ params, part, assert }) => {
 - [GenerateCallback](GenerateCallback.md)
 - [ModelProgram](ModelProgram.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -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
 
 
 
@@ -76,5 +76,6 @@ readonly [`Section`](Section.md)[]
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,6 +1,6 @@
 # heightfield
 
-Closed rectilinear top above a flat base, with uniform or explicit XY coordinates. Samples each grid height once; center-error triangulation also samples each cell centre. The retained callback must capture independent immutable inputs, not live session readers or parameters.
+Closed rectilinear top above a flat base, with uniform or explicit XY coordinates.
 
 **heightfield**(`options`: [`HeightfieldOptions`](HeightfieldOptions.md)): [`Solid`](Solid.md)
 
@@ -19,6 +19,9 @@ heightfield({
 
 
 
+Samples each grid height once; center-error triangulation also samples each cell centre.
+The retained callback must capture independent immutable inputs, not live session readers or parameters.
+
 ## Parameters
 
 <a id="options"></a>
@@ -37,4 +40,4 @@ heightfield({
 - [HeightfieldOptions](HeightfieldOptions.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -71,4 +71,4 @@ Convex filled XY hull of finite points or filled section recipes.
 - [Choose the Boolean by the material you want](../../guides/fundamentals.md#choose-the-boolean-by-the-material-you-want)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -41,4 +41,8 @@ editable[0] = 8; // heights still contains 2, 4, 6.
 - [ImmutableBuffer](ImmutableBuffer-type.md)
 - [NumericArray](NumericArray.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -37,4 +37,8 @@ const model = generate(({ computed, part }) => {
 - [ImmutableTriangleMesh](ImmutableTriangleMesh.md)
 - [TriangleMesh](TriangleMesh.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
+
+Package: `@metamesh/modeling@0.16.0`.

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

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

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

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

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

@@ -35,4 +35,4 @@ facts.volume; // 3600 mm³
 
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.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`.
 
@@ -96,5 +96,6 @@ body.subtract([cutter]);
 ## Guides
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

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

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

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

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

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

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

@@ -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
 
 
 
@@ -76,5 +76,6 @@ readonly [`Section`](Section.md)[]
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -134,4 +134,4 @@ Lofts explicit corresponding contours, including holes and collapsed logical slo
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.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.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -34,4 +34,4 @@ Three-dimensional Minkowski sum.
 - [Choose the Boolean by the material you want](../../guides/fundamentals.md#choose-the-boolean-by-the-material-you-want)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -0,0 +1,54 @@
+# path2
+
+Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization.
+
+**path2**(`input`: [`Path2Input`](Path2Input.md), `options?`: [`PathOptions`](PathOptions.md)): [`Path2`](Path2-type.md)
+
+
+
+Open paths may be empty or have one point; closed paths need three vertices and omit a duplicated
+seam. Repeated adjacent vertices are retained. No winding normalization or filling is performed.
+Malformed dimensions or topology throw INVALID_ARGUMENT; nonfinite coordinates or measurement
+overflow throw NON_FINITE_VALUE; exhausted allocation ceilings throw COMPLEXITY_LIMIT GeometryError.
+A path input retains its closure. Limits bound construction only; resampling takes its own limits.
+
+Use `toData()` for a frozen record that restores coordinates, closure, and dimension together.
+
+## Parameters
+
+<a id="input"></a>
+
+**`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)
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -0,0 +1,49 @@
+# 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)
+
+
+
+Use `toData()` for a frozen record that restores coordinates, closure, and dimension together.
+
+## 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)
+- [path2](path2.md)
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/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 [`Vector3Tuple`](Vector3Tuple.md)[], `options`: [`PathPatternOptions`](PathPatternOptions.md)): readonly [`Solid`](Solid.md)[]
+**pathPattern**(`source`: [`PatternSource`](PatternSource.md), `path`: [`Path3Input`](Path3Input.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 [`Vector3Tuple`](Vector3Tuple.md)[] · Required
+**`path`** · [`Path3Input`](Path3Input.md) · Required
 
 
 
@@ -42,11 +42,11 @@ Physical arc-length copies along a sampled path, with optional tangent orientati
 
 - [`closed`](PathPatternOptions.md#closed) · `boolean` · Optional
 
-  Include the closing edge without duplicating the seam; defaults to false.
+  Raw point closure defaults to false; a path value supplies closure and rejects conflicts.
 
 - [`orientation`](PathPatternOptions.md#orientation) · `"fixed"` \| `"tangent"` · Optional
 
-  Preserve the source orientation, or align its +Z to the path tangent; defaults to fixed.
+  Preserve orientation, or align local +X for Sections / +Z for Solids to the tangent. Defaults to fixed.
 
 
 
@@ -58,12 +58,12 @@ readonly [`Solid`](Solid.md)[]
 
 
 
-**pathPattern**(`source`: [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\>, `path`: readonly [`Vector3Tuple`](Vector3Tuple.md)[], `options`: [`PathPatternOptions`](PathPatternOptions.md)): readonly [`Section`](Section.md)[]
+**pathPattern**(`source`: [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\>, `path`: [`Path2Input`](Path2Input.md), `options`: [`PathPatternOptions`](PathPatternOptions.md)): readonly [`Section`](Section.md)[]
 
 
 
-Repeats a filled Section along a sampled XY path at Z=0. Fixed orientation preserves XY;
-tangent orientation maps +Z to the tangent and rejects when that leaves the plane.
+Repeats a filled Section along a sampled XY path. Tangent orientation maps local +X
+to the path tangent counterclockwise, preserving the XY plane.
 
 ### Parameters
 
@@ -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 [`Vector3Tuple`](Vector3Tuple.md)[] · Required
+**`path`** · [`Path2Input`](Path2Input.md) · Required
 
 
 
@@ -89,11 +89,11 @@ tangent orientation maps +Z to the tangent and rejects when that leaves the plan
 
 - [`closed`](PathPatternOptions.md#closed) · `boolean` · Optional
 
-  Include the closing edge without duplicating the seam; defaults to false.
+  Raw point closure defaults to false; a path value supplies closure and rejects conflicts.
 
 - [`orientation`](PathPatternOptions.md#orientation) · `"fixed"` \| `"tangent"` · Optional
 
-  Preserve the source orientation, or align its +Z to the path tangent; defaults to fixed.
+  Preserve orientation, or align local +X for Sections / +Z for Solids to the tangent. Defaults to fixed.
 
 
 
@@ -104,15 +104,17 @@ readonly [`Section`](Section.md)[]
 
 ## Related APIs
 
+- [Path2Input](Path2Input.md)
+- [Path3Input](Path3Input.md)
 - [PathPatternOptions](PathPatternOptions.md)
 - [PatternSource](PatternSource.md)
 - [Section](Section.md)
 - [Solid](Solid.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)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.