@metamesh/modeling 0.15.0 → 0.16.0

package/dist/docs/reference/geometry/applyTransformDirection3.md

@@ -2,7 +2,7 @@
 
 Applies only the linear component of an affine transform to a direction.
 
-**applyTransformDirection3**(`transform`: [`Transform3Matrix`](Transform3Matrix.md), `direction`: [`Vector3Tuple`](Vector3Tuple.md)): [`Vector3Tuple`](Vector3Tuple.md)
+**applyTransformDirection3**(`transform`: [`Transform3Data`](Transform3Data.md), `direction`: [`Vector3Data`](Vector3Data.md)): [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -12,7 +12,7 @@ The result is not normalized, preserving scale information.
 
 <a id="transform"></a>
 
-**`transform`** · [`Transform3Matrix`](Transform3Matrix.md) · Required
+**`transform`** · [`Transform3Data`](Transform3Data.md) · Required
 
 Valid row-major affine transform.
 
@@ -20,7 +20,7 @@ Valid row-major affine transform.
 
 <a id="direction"></a>
 
-**`direction`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`direction`** · [`Vector3Data`](Vector3Data.md) · Required
 
 Finite XYZ direction.
 
@@ -28,18 +28,19 @@ Finite XYZ direction.
 
 ## Returns
 
-[`Vector3Tuple`](Vector3Tuple.md)
+[`Vector3Data`](Vector3Data.md)
 
 A fresh transformed direction.
 
 
 ## Related APIs
 
-- [Transform3Matrix](Transform3Matrix.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Transform3Data](Transform3Data.md)
+- [Vector3Data](Vector3Data.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/applyTransformPoint3.md

@@ -2,7 +2,7 @@
 
 Applies an affine transform to a point, including translation.
 
-**applyTransformPoint3**(`transform`: [`Transform3Matrix`](Transform3Matrix.md), `point`: [`Vector3Tuple`](Vector3Tuple.md)): [`Vector3Tuple`](Vector3Tuple.md)
+**applyTransformPoint3**(`transform`: [`Transform3Data`](Transform3Data.md), `point`: [`Vector3Data`](Vector3Data.md)): [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -10,7 +10,7 @@ Applies an affine transform to a point, including translation.
 
 <a id="transform"></a>
 
-**`transform`** · [`Transform3Matrix`](Transform3Matrix.md) · Required
+**`transform`** · [`Transform3Data`](Transform3Data.md) · Required
 
 Valid row-major affine transform.
 
@@ -18,7 +18,7 @@ Valid row-major affine transform.
 
 <a id="point"></a>
 
-**`point`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`point`** · [`Vector3Data`](Vector3Data.md) · Required
 
 Finite XYZ point.
 
@@ -26,18 +26,19 @@ Finite XYZ point.
 
 ## Returns
 
-[`Vector3Tuple`](Vector3Tuple.md)
+[`Vector3Data`](Vector3Data.md)
 
 A fresh transformed point.
 
 
 ## Related APIs
 
-- [Transform3Matrix](Transform3Matrix.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Transform3Data](Transform3Data.md)
+- [Vector3Data](Vector3Data.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/attachmentTransform3.md

@@ -2,7 +2,7 @@
 
 Builds the transform that moves a source anchor onto a target anchor.
 
-**attachmentTransform3**(`source`: [`Anchor3`](Anchor3-type.md), `target`: [`Anchor3`](Anchor3-type.md), `options?`: [`AttachOptions`](AttachOptions.md)): [`Transform3Matrix`](Transform3Matrix.md)
+**attachmentTransform3**(`source`: [`Anchor3`](Anchor3-type.md), `target`: [`Anchor3`](Anchor3-type.md), `options?`: [`AttachOptions`](AttachOptions.md)): [`Transform3Data`](Transform3Data.md)
 
 
 
@@ -55,7 +55,7 @@ Alignment, gap, spin, and tolerance policy.
 
 ## Returns
 
-[`Transform3Matrix`](Transform3Matrix.md)
+[`Transform3Data`](Transform3Data.md)
 
 A frozen affine transform for the moving object.
 
@@ -68,10 +68,11 @@ A frozen affine transform for the moving object.
 
 - [Anchor3](Anchor3-type.md)
 - [AttachOptions](AttachOptions.md)
-- [Transform3Matrix](Transform3Matrix.md)
+- [Transform3Data](Transform3Data.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/bounds2.md

@@ -0,0 +1,38 @@
+# bounds2
+
+Snapshots finite ordered XY bounds in millimetres as an immutable fluent value.
+
+**bounds2**(`input`: [`Bounds2Input`](Bounds2Input.md)): [`Bounds2`](Bounds2-type.md)
+
+
+
+Zero extents are valid. Invalid dimensions, nonfinite coordinates, reversed bounds and
+overflowing extents throw `INVALID_ARGUMENT` GeometryError. Use `toData()` for plain records.
+Compiled Generator packages passing these values to host recipes or computed data require
+runtime 8.0.0 or newer in major 8.
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Bounds2Input`](Bounds2Input.md) · Required
+
+
+
+## Returns
+
+[`Bounds2`](Bounds2-type.md)
+
+
+## Related APIs
+
+- [Bounds2](Bounds2-type.md)
+- [Bounds2Input](Bounds2Input.md)
+
+## Guides
+
+- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
+- [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
+- [Solid inspection](../../guides/recipes.md#solid-inspection)
+
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/bounds3.md

@@ -0,0 +1,38 @@
+# bounds3
+
+Snapshots finite ordered XYZ bounds in millimetres as an immutable fluent value.
+
+**bounds3**(`input`: [`Bounds3Input`](Bounds3Input.md)): [`Bounds3`](Bounds3-type.md)
+
+
+
+Zero extents are valid. Invalid dimensions, nonfinite coordinates, reversed bounds and
+overflowing extents throw `INVALID_ARGUMENT` GeometryError. Use `toData()` for plain records.
+Compiled Generator packages passing these values to host recipes or computed data require
+runtime 8.0.0 or newer in major 8.
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Bounds3Input`](Bounds3Input.md) · Required
+
+
+
+## Returns
+
+[`Bounds3`](Bounds3-type.md)
+
+
+## Related APIs
+
+- [Bounds3](Bounds3-type.md)
+- [Bounds3Input](Bounds3Input.md)
+
+## Guides
+
+- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
+- [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
+- [Solid inspection](../../guides/recipes.md#solid-inspection)
+
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/boundsCenter.md

@@ -6,7 +6,7 @@ Midpoint of finite XY bounds in millimetres.
 
 
 
-**boundsCenter**(`bounds`: [`Bounds2`](Bounds2.md)): [`Vector2Tuple`](Vector2Tuple.md)
+**boundsCenter**(`bounds`: [`Bounds2Data`](Bounds2Data.md)): [`Vector2Data`](Vector2Data.md)
 
 
 
@@ -16,19 +16,19 @@ Midpoint of finite XY bounds in millimetres.
 
 <a id="bounds"></a>
 
-**`bounds`** · [`Bounds2`](Bounds2.md) · Required
+**`bounds`** · [`Bounds2Data`](Bounds2Data.md) · Required
 
 
 
 ### Returns
 
-[`Vector2Tuple`](Vector2Tuple.md)
+[`Vector2Data`](Vector2Data.md)
 
 ## Call Signature
 
 
 
-**boundsCenter**(`bounds`: [`Bounds3`](Bounds3.md)): [`Vector3Tuple`](Vector3Tuple.md)
+**boundsCenter**(`bounds`: [`Bounds3Data`](Bounds3Data.md)): [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -38,25 +38,26 @@ Midpoint of finite XYZ bounds in millimetres.
 
 <a id="bounds-1"></a>
 
-**`bounds`** · [`Bounds3`](Bounds3.md) · Required
+**`bounds`** · [`Bounds3Data`](Bounds3Data.md) · Required
 
 
 
 ### Returns
 
-[`Vector3Tuple`](Vector3Tuple.md)
+[`Vector3Data`](Vector3Data.md)
 
 
 ## Related APIs
 
-- [Bounds2](Bounds2.md)
-- [Bounds3](Bounds3.md)
-- [Vector2Tuple](Vector2Tuple.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Bounds2Data](Bounds2Data.md)
+- [Bounds3Data](Bounds3Data.md)
+- [Vector2Data](Vector2Data.md)
+- [Vector3Data](Vector3Data.md)
 
 ## Guides
 
+- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/boundsFromSize.md

@@ -6,7 +6,7 @@ Creates immutable centered XY bounds from nonnegative dimensions in millimetres.
 
 
 
-**boundsFromSize**(`size`: [`Vector2Tuple`](Vector2Tuple.md), `options?`: [`BoundsFromSizeOptions`](BoundsFromSizeOptions.md)): [`Bounds2`](Bounds2.md)
+**boundsFromSize**(`size`: [`Vector2Data`](Vector2Data.md), `options?`: [`BoundsFromSizeOptions`](BoundsFromSizeOptions.md)): [`Bounds2Data`](Bounds2Data.md)
 
 
 
@@ -16,7 +16,7 @@ Creates immutable centered XY bounds from nonnegative dimensions in millimetres.
 
 <a id="size"></a>
 
-**`size`** · [`Vector2Tuple`](Vector2Tuple.md) · Required
+**`size`** · [`Vector2Data`](Vector2Data.md) · Required
 
 
 
@@ -32,13 +32,13 @@ Creates immutable centered XY bounds from nonnegative dimensions in millimetres.
 
 ### Returns
 
-[`Bounds2`](Bounds2.md)
+[`Bounds2Data`](Bounds2Data.md)
 
 ## Call Signature
 
 
 
-**boundsFromSize**(`size`: [`Vector3Tuple`](Vector3Tuple.md), `options?`: [`BoundsFromSizeOptions`](BoundsFromSizeOptions.md)): [`Bounds3`](Bounds3.md)
+**boundsFromSize**(`size`: [`Vector3Data`](Vector3Data.md), `options?`: [`BoundsFromSizeOptions`](BoundsFromSizeOptions.md)): [`Bounds3Data`](Bounds3Data.md)
 
 
 
@@ -48,7 +48,7 @@ Creates immutable centered XYZ bounds from nonnegative dimensions in millimetres
 
 <a id="size-1"></a>
 
-**`size`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`size`** · [`Vector3Data`](Vector3Data.md) · Required
 
 
 
@@ -64,20 +64,21 @@ Creates immutable centered XYZ bounds from nonnegative dimensions in millimetres
 
 ### Returns
 
-[`Bounds3`](Bounds3.md)
+[`Bounds3Data`](Bounds3Data.md)
 
 
 ## Related APIs
 
-- [Bounds2](Bounds2.md)
-- [Bounds3](Bounds3.md)
+- [Bounds2Data](Bounds2Data.md)
+- [Bounds3Data](Bounds3Data.md)
 - [BoundsFromSizeOptions](BoundsFromSizeOptions.md)
-- [Vector2Tuple](Vector2Tuple.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector2Data](Vector2Data.md)
+- [Vector3Data](Vector3Data.md)
 
 ## Guides
 
+- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/boundsSize.md

@@ -6,7 +6,7 @@ Inclusive XY dimensions in millimetres; zero extents are retained.
 
 
 
-**boundsSize**(`bounds`: [`Bounds2`](Bounds2.md)): [`Vector2Tuple`](Vector2Tuple.md)
+**boundsSize**(`bounds`: [`Bounds2Data`](Bounds2Data.md)): [`Vector2Data`](Vector2Data.md)
 
 
 
@@ -16,19 +16,19 @@ Inclusive XY dimensions in millimetres; zero extents are retained.
 
 <a id="bounds"></a>
 
-**`bounds`** · [`Bounds2`](Bounds2.md) · Required
+**`bounds`** · [`Bounds2Data`](Bounds2Data.md) · Required
 
 
 
 ### Returns
 
-[`Vector2Tuple`](Vector2Tuple.md)
+[`Vector2Data`](Vector2Data.md)
 
 ## Call Signature
 
 
 
-**boundsSize**(`bounds`: [`Bounds3`](Bounds3.md)): [`Vector3Tuple`](Vector3Tuple.md)
+**boundsSize**(`bounds`: [`Bounds3Data`](Bounds3Data.md)): [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -38,25 +38,26 @@ Inclusive XYZ dimensions in millimetres; zero extents are retained.
 
 <a id="bounds-1"></a>
 
-**`bounds`** · [`Bounds3`](Bounds3.md) · Required
+**`bounds`** · [`Bounds3Data`](Bounds3Data.md) · Required
 
 
 
 ### Returns
 
-[`Vector3Tuple`](Vector3Tuple.md)
+[`Vector3Data`](Vector3Data.md)
 
 
 ## Related APIs
 
-- [Bounds2](Bounds2.md)
-- [Bounds3](Bounds3.md)
-- [Vector2Tuple](Vector2Tuple.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Bounds2Data](Bounds2Data.md)
+- [Bounds3Data](Bounds3Data.md)
+- [Vector2Data](Vector2Data.md)
+- [Vector3Data](Vector3Data.md)
 
 ## Guides
 
+- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/boxAnchor3.md

@@ -12,7 +12,7 @@ Creates an outward face-center anchor using the same local origin convention as
 
 **`options`** · [`BoxAnchorOptions`](BoxAnchorOptions.md) · Required
 
-- [`size`](BoxAnchorOptions.md#size) · `number` \| [`Vector3Tuple`](Vector3Tuple.md) · Required
+- [`size`](BoxAnchorOptions.md#size) · `number` \| [`Vector3Data`](Vector3Data.md) · Required
 
   XYZ dimensions, or one uniform dimension, in millimetres.
 
@@ -24,7 +24,7 @@ Creates an outward face-center anchor using the same local origin convention as
 
   Centers the box around its construction origin; defaults to true, matching box().
 
-- [`origin`](BoxAnchorOptions.md#origin) · [`Vector3Tuple`](Vector3Tuple.md) · Optional
+- [`origin`](BoxAnchorOptions.md#origin) · [`Vector3Data`](Vector3Data.md) · Optional
 
   Construction origin; centered-box center or noncentered minimum corner. Defaults to zero.
 
@@ -48,5 +48,6 @@ resulting anchor frame explicitly; no anchor is inherited from a Boolean result.
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/categories/bounds-layout.md

@@ -1,35 +1,52 @@
-# Bounds & Layout
+# Bounds and layout
 
 Measure finite bounds, test positioned containment, and fit or arrange geometry.
 
-Bounds2 and Bounds3 are shared min/max data for text, mesh measurements, and placement. boundsFromSize creates centered bounds unless center is false. containsBounds tests actual positioned containment, including boundary contact. fitBounds uniformly scales and centers into a target, returning scale, position and resulting bounds; maxScale limits enlargement. layoutRow returns translations for a +X row with minimum Y/Z grounded at zero; supply bounds after intended rotations and apply positions through part options.
+Use `bounds2` and `bounds3` for immutable extents with fluent `size()`, `center()`, and `containsBounds()` queries. Zero extents are valid. Containment includes boundary contact in the same coordinate frame; it does not establish manufacturing fit.
+
+- **Interchange:** measurements, snapshots, and `boundsFromSize` retain plain `Bounds2Data`/`Bounds3Data` min/max records. `toData()` returns a stable frozen record. Standalone helpers accept values or data.
+- **Construct:** `boundsFromSize` centers on the origin unless `center` is `false`.
+- **Fit:** `fitBounds` scales uniformly and centers in a target, returning scale, position, and resulting data bounds. `maxScale` limits enlargement.
+- **Arrange:** `layoutRow` returns translations for a +X row with minimum Y/Z at zero. Supply bounds after intended rotations, then apply positions through part options.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
+| [bounds2](../bounds2.md) | Snapshots finite ordered XY bounds in millimetres as an immutable fluent value. |
+| [bounds3](../bounds3.md) | Snapshots finite ordered XYZ bounds in millimetres as an immutable fluent value. |
 | [boundsFromSize](../boundsFromSize.md) | Creates immutable centered XY bounds from nonnegative dimensions in millimetres. |
 | [boundsSize](../boundsSize.md) | Inclusive XY dimensions in millimetres; zero extents are retained. |
 | [boundsCenter](../boundsCenter.md) | Midpoint of finite XY bounds in millimetres. |
 | [containsBounds](../containsBounds.md) | Tests actual XY containment, including touching boundaries; dimensions must match. |
 | [fitBounds](../fitBounds.md) | Fits XY bounds uniformly and centers them in the target; zero source axes do not constrain scale. |
-| [layoutRow](../layoutRow.md) | Returns immutable translations for a +X row of finite XYZ bounds with a nonnegative gap. Each minimum Y/Z becomes zero, and the first minimum X becomes zero. Supply bounds after any intended part rotation; translations apply to those bounds. An empty input returns []. |
+| [layoutRow](../layoutRow.md) | Returns immutable translations for a +X row of finite XYZ bounds with a nonnegative gap. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [Bounds2](../Bounds2.md) | Axis-aligned bounds in two-dimensional model space. |
-| [Bounds3](../Bounds3.md) | Axis-aligned bounds in three-dimensional model space. |
+| [Bounds2](../Bounds2-type.md) | Immutable finite XY bounds in millimetres, with tuple coordinates for data interoperability. |
+| [Bounds3](../Bounds3-type.md) | Immutable finite XYZ bounds in millimetres, with tuple coordinates for data interoperability. |
+| [Bounds2Data](../Bounds2Data.md) | Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods. |
+| [Bounds3Data](../Bounds3Data.md) | Plain axis-aligned XYZ bounds for interchange; use bounds3 for immutable measurement methods. |
 | [BoundsFromSizeOptions](../BoundsFromSizeOptions.md) | Placement of bounds constructed from nonnegative millimetre dimensions. |
 | [BoundsFitOptions](../BoundsFitOptions.md) | Uniform fitting controls; fitting centers the source inside the target. |
 | [BoundsFit2](../BoundsFit2.md) | A uniform XY scale followed by translation, and the resulting bounds. |
 | [BoundsFit3](../BoundsFit3.md) | A uniform XYZ scale followed by translation, and the resulting bounds. |
 | [RowLayoutOptions](../RowLayoutOptions.md) | Simple +X row placement with every minimum Y and Z grounded at zero. |
 
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [Bounds2Input](../Bounds2Input.md) | An immutable XY bounds value or its plain min/max representation. |
+| [Bounds3Input](../Bounds3Input.md) | An immutable XYZ bounds value or its plain min/max representation. |
+
 ## Guides
 
+- [Measure and compare bounds](../../../guides/concepts.md#measure-and-compare-bounds)
 - [Text from a Font parameter](../../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/categories/curves-paths.md

@@ -2,7 +2,15 @@
 
 Sample reusable lines, arcs, cubic curves, and path frames with explicit physical policies.
 
-Use immutable `path2(points, { closed })` and `path3(points, { closed })` values for sampled trajectories. Closure belongs to the value; closed paths omit the duplicated endpoint. Chain transform, reverse and resample without mutating reusable paths. length includes the closing edge, bounds returns undefined for empty paths, and closestPoint returns a fluent point, distance, edge index and fraction within that edge. Reflections preserve traversal; polygon construction handles filled-shape winding. Geometry accepts matching path values directly. Path2Data and Path3Data are tuple collections for interchange; toArray omits closure metadata. Analytic Curve definitions remain distinct: sampleCurve2/3 retain directed endpoints and tangents; exact curve intervals are uniform in the curve parameter. Low-level resamplePolyline2/3 return tuple points plus tangents at equal arc length. Sampling uses physical policies and checked vertex ceilings. Sweep frames require explicit seam and orientation choices.
+Use immutable `path2(points, { closed })` and `path3(points, { closed })` values for sampled trajectories. Closed paths omit the duplicated endpoint. Geometry accepts matching path values directly.
+
+- **Transform:** `transform()`, `reverse()`, and `resample()` return new paths. Reflections preserve traversal; polygon construction handles filled-shape winding.
+- **Query:** `length()` includes the closing edge. `bounds()` returns fluent bounds or `undefined` for empty paths. `closestPoint()` returns a fluent point, distance, edge index, and fraction within that edge.
+- **Interchange:** `toData()` returns `Path2Data` or `Path3Data` with dimension, closure, and point tuples.
+- **Sample curves:** analytic `Curve` definitions are separate. `sampleCurve2`/`sampleCurve3` retain directed endpoints and tangents; exact intervals are uniform in the curve parameter.
+- **Resample:** `resamplePolyline2`/`resamplePolyline3` return tuple points and tangents at equal arc lengths. Sampling uses physical policies and checked vertex ceilings.
+
+Sweep frames require explicit seam and orientation choices.
 
 ## Functions
 
@@ -14,7 +22,7 @@ Use immutable `path2(points, { closed })` and `path3(points, { closed })` values
 | [resolveGeometrySamplingLimits](../resolveGeometrySamplingLimits.md) | Resolves finite positive safe-integer allocation ceilings without ambient state. |
 | [resamplePolyline2](../resamplePolyline2.md) | Resamples a planar polyline with the same point, tangent, seam and budget guarantees as 3D. |
 | [resamplePolyline3](../resamplePolyline3.md) | Resamples a spatial polyline at equal arc lengths with directed outgoing tangents. |
-| [path2](../path2.md) | Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization. Open paths may be empty or have one point; closed paths need three vertices and omit a duplicated seam. Repeated adjacent vertices are retained. No winding normalization or filling is performed. Malformed dimensions or topology throw INVALID_ARGUMENT; nonfinite coordinates or measurement overflow throw NON_FINITE_VALUE; exhausted allocation ceilings throw COMPLEXITY_LIMIT GeometryError. A path input retains its closure. Limits bound construction only; resampling takes its own limits. |
+| [path2](../path2.md) | Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization. |
 | [path3](../path3.md) | Snapshots finite XYZ coordinates as an immutable sampled path with the same closure, seam, allocation and error rules as path2. Analytic curves must be sampled explicitly first. |
 
 ## Interfaces
@@ -41,6 +49,8 @@ Use immutable `path2(points, { closed })` and `path3(points, { closed })` values
 | [PathOptions](../PathOptions.md) | Topology and allocation ceiling for an immutable sampled path. |
 | [PathLocation](../PathLocation.md) | Nearest location on a sampled boundary, rather than inside a filled shape or on an analytic curve. |
 | [PathResamplingOptions](../PathResamplingOptions.md) | Equal arc-length sampling; the path itself owns whether its closing edge is included. |
+| [Path2Data](../Path2Data.md) | Complete plain XY path representation, including topology and empty-path dimensional identity. |
+| [Path3Data](../Path3Data.md) | Complete plain XYZ path representation, including topology and empty-path dimensional identity. |
 
 ## Type aliases
 
@@ -49,20 +59,22 @@ Use immutable `path2(points, { closed })` and `path3(points, { closed })` values
 | [Curve2](../Curve2.md) | Reusable planar curve definition. |
 | [Curve3](../Curve3.md) | Reusable spatial curve definition. |
 | [PathNormalGuide](../PathNormalGuide.md) | Supplies a profile-X orientation guide for each original normalized sweep station. |
-| [Path2Input](../Path2Input.md) | An immutable XY sampled path or a collection of XY tuples and fluent vectors. |
-| [Path3Input](../Path3Input.md) | An immutable XYZ sampled path or a collection of XYZ tuples and fluent vectors. |
-| [Path2Data](../Path2Data.md) | XY point tuples for interchange; closure is supplied by the consuming operation or Path2 value. |
-| [Path3Data](../Path3Data.md) | XYZ point tuples for interchange; closure is supplied by the consuming operation or Path3 value. |
+| [Path2Input](../Path2Input.md) | A matching path value, complete plain path data, or a collection of vectors. |
+| [Path3Input](../Path3Input.md) | A matching path value, complete plain path data, or a collection of vectors. |
 
 ## Values
 
 | API | Summary |
 | --- | --- |
 | [computeClosedParallelTransportFrames](../computeClosedParallelTransportFrames.md) | Builds rotation-minimizing frames for a non-duplicated closed path. |
-| [computeParallelTransportFrames](../computeParallelTransportFrames.md) | Builds rotation-minimizing frames by parallel-transporting the previous normal. This avoids the sudden profile flips produced by picking a fresh up-vector per ring. Paths exceeding maxPathPoints (default 100000) reject before frame allocation or guide evaluation. Requires open path values; raw tuples are interpreted as an open path. Invalid paths throw GeometryError. Nonfinite normals and guide results reject. A finite initial guide parallel to the tangent selects a canonical fallback. |
+| [computeParallelTransportFrames](../computeParallelTransportFrames.md) | Builds rotation-minimizing frames by parallel-transporting the previous normal. |
 | [defaultGeometrySamplingLimits](../defaultGeometrySamplingLimits.md) | Conservative defaults; trusted callers can supply larger explicit ceilings. |
 | [distributeAlongPath](../distributeAlongPath.md) | Places an exact item count at equal arc-length intervals along a sampled path. |
 | [roundClosedPolylinePath](../roundClosedPolylinePath.md) | Replaces each vertex of a non-duplicated closed polyline with a sampled quadratic corner in the same coordinate system as the input. |
-| [sampleHelix](../sampleHelix.md) | Creates `segments + 1` points including exact helix endpoints from finite positive dimensions. Integrated weights must remain finite. The maxPathPoints ceiling defaults to 100000; excessive exact counts reject before evaluating axial weights or allocating sample arrays. Invalid inputs use GeometryError; exceptions thrown by axialWeight propagate unchanged. |
+| [sampleHelix](../sampleHelix.md) | Creates `segments + 1` points including exact helix endpoints from finite positive dimensions. |
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.