@metamesh/modeling 0.19.0 → 0.20.0

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

@@ -10,24 +10,12 @@ A two-dimensional Cartesian vector or point.
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
-- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-## Supported imports
-
-```ts
-import type { Vector2Data } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { Vector2Data } from "@metamesh/modeling/geometry";
 ```
 
-```ts
-import * as mesh from "@metamesh/modeling/geometry/mesh";
-```
-
-```ts
-import type { Vector2Data } from "@metamesh/modeling/text";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -15,20 +15,12 @@ An XY tuple or immutable fluent vector accepted by vector operations.
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
-- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-## Supported imports
-
-```ts
-import type { Vector2Input } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { Vector2Input } from "@metamesh/modeling/geometry";
 ```
 
-```ts
-import * as mesh from "@metamesh/modeling/geometry/mesh";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -208,6 +208,30 @@ Returns the right-handed cross product as a new vector.
 
 
 
+#### Returns
+
+`Vector3`
+
+***
+
+### projectOntoPlane()
+
+
+
+**projectOntoPlane**(`normal`: [`Vector3Input`](Vector3Input.md)): `Vector3`
+
+
+
+Projects onto the plane through the origin; finite nonzero normals are normalized first.
+
+#### Parameters
+
+<a id="normal"></a>
+
+**`normal`** · [`Vector3Input`](Vector3Input.md) · Required
+
+
+
 #### Returns
 
 `Vector3`
@@ -277,20 +301,12 @@ Returns this value's frozen readonly tuple for interchange; repeated calls do no
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
-- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-## Supported imports
-
-```ts
-import type { Vector3 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { Vector3 } from "@metamesh/modeling/geometry";
 ```
 
-```ts
-import * as mesh from "@metamesh/modeling/geometry/mesh";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -10,20 +10,12 @@ A three-dimensional Cartesian vector or point.
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
-- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-## Supported imports
-
-```ts
-import type { Vector3Data } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { Vector3Data } from "@metamesh/modeling/geometry";
 ```
 
-```ts
-import * as mesh from "@metamesh/modeling/geometry/mesh";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -15,20 +15,12 @@ An XYZ tuple or immutable fluent vector accepted by vector operations.
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
-- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-## Supported imports
-
-```ts
-import type { Vector3Input } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { Vector3Input } from "@metamesh/modeling/geometry";
 ```
 
-```ts
-import * as mesh from "@metamesh/modeling/geometry/mesh";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -40,18 +40,10 @@ Exact measurements of these paths and their logical text layout.
 
 - [SVG preflight work and guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
-
-```ts
-import type { VectorTextLayout } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { VectorTextLayout } from "@metamesh/modeling/geometry";
 ```
 
-```ts
-import type { VectorTextLayout } from "@metamesh/modeling/text";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -60,7 +60,7 @@ Selected font's ascender distance above a baseline in millimetres, independent o
 
 
 
-Selected font's descender distance below a baseline in millimetres, a non-negative value.
+Selected font's descender distance below a baseline in millimetres, a nonnegative value.
 
 ***
 
@@ -95,18 +95,10 @@ Number of lines, including empty and trailing lines; empty text occupies one lin
 
 - [SVG preflight work and guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
-
-```ts
-import type { VectorTextMetrics } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { VectorTextMetrics } from "@metamesh/modeling/geometry";
 ```
 
-```ts
-import type { VectorTextMetrics } from "@metamesh/modeling/text";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,7 +2,7 @@
 
 Constructs a normalized immutable attachment anchor.
 
-**anchor3**(`position`: [`Vector3Input`](Vector3Input.md), `direction`: [`Vector3Input`](Vector3Input.md), `up?`: [`Vector3Input`](Vector3Input.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Anchor3`](Anchor3-type.md)
+**anchor3**(`options`: [`Anchor3Options`](Anchor3Options.md)): [`Anchor3`](Anchor3-type.md)
 
 
 
@@ -11,35 +11,27 @@ input drift while preserving its roll intent.
 
 ## Parameters
 
-<a id="position"></a>
+<a id="options"></a>
 
-**`position`** · [`Vector3Input`](Vector3Input.md) · Required
+**`options`** · [`Anchor3Options`](Anchor3Options.md) · Required
 
-Finite anchor point in model coordinates.
+Finite position, orientation guides, and optional comparison overrides.
 
+- [`position`](Anchor3Options.md#position) · [`Vector3Input`](Vector3Input.md) · Required
 
+  Finite attachment position in millimetres.
 
-<a id="direction"></a>
+- [`direction`](Anchor3Options.md#direction) · [`Vector3Input`](Vector3Input.md) · Required
 
-**`direction`** · [`Vector3Input`](Vector3Input.md) · Required
+  Nonzero outward normal; its magnitude is ignored.
 
-Non-zero outward attachment normal.
+- [`up`](Anchor3Options.md#up) · [`Vector3Input`](Vector3Input.md) · Optional
 
+  Nonparallel roll reference projected onto the attachment plane; defaults to +Y.
 
+- [`tolerance`](Anchor3Options.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
 
-<a id="up"></a>
-
-**`up`** · [`Vector3Input`](Vector3Input.md) · Optional
-
-Non-parallel roll reference; defaults to +Y.
-
-
-
-<a id="tolerance"></a>
-
-**`tolerance`** · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
-
-Optional comparison overrides.
+  Optional numeric comparison overrides.
 
 
 
@@ -52,23 +44,22 @@ A frozen anchor with unit, orthogonal direction and up vectors.
 
 ## Throws
 
-- GeometryError For non-finite or degenerate inputs.
+- GeometryError For nonfinite or degenerate inputs.
 
 ## Related APIs
 
 - [Anchor3](Anchor3-type.md)
-- [GeometryToleranceOptions](GeometryToleranceOptions.md)
-- [Vector3Input](Vector3Input.md)
+- [Anchor3Options](Anchor3Options.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
-- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-## Supported imports
+## Import
 
 ```ts
 import { anchor3 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,7 +2,7 @@
 
 Converts an anchor into a right-handed frame with direction as local +Z.
 
-**anchorFrame3**(`anchor`: [`Anchor3`](Anchor3-type.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Frame3`](Frame3.md)
+**anchorFrame3**(`anchor`: [`Anchor3`](Anchor3-type.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Frame3`](Frame3-type.md)
 
 
 
@@ -26,7 +26,7 @@ Optional comparison overrides.
 
 ## Returns
 
-[`Frame3`](Frame3.md)
+[`Frame3`](Frame3-type.md)
 
 A normalized right-handed frame at the anchor position.
 
@@ -34,17 +34,17 @@ A normalized right-handed frame at the anchor position.
 ## Related APIs
 
 - [Anchor3](Anchor3-type.md)
-- [Frame3](Frame3.md)
+- [Frame3](Frame3-type.md)
 - [GeometryToleranceOptions](GeometryToleranceOptions.md)
 
 ## Guides
 
-- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#query-paths-and-preserve-closure)
+- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#keep-path-closure-and-traversal)
 
-## Supported imports
+## Import
 
 ```ts
 import { anchorFrame3 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.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)): [`Transform3Data`](Transform3Data.md)
+**attachmentTransform3**(`source`: [`Anchor3`](Anchor3-type.md), `target`: [`Anchor3`](Anchor3-type.md), `options?`: [`AttachOptions`](AttachOptions.md)): [`Transform3`](Transform3-type.md)
 
 
 
@@ -55,30 +55,30 @@ Alignment, gap, spin, and tolerance policy.
 
 ## Returns
 
-[`Transform3Data`](Transform3Data.md)
+[`Transform3`](Transform3-type.md)
 
-A frozen affine transform for the moving object.
+An immutable affine transform for the moving object.
 
 
 ## Throws
 
-- GeometryError For invalid anchors or non-finite options.
+- GeometryError For invalid anchors or nonfinite options.
 
 ## Related APIs
 
 - [Anchor3](Anchor3-type.md)
 - [AttachOptions](AttachOptions.md)
-- [Transform3Data](Transform3Data.md)
+- [Transform3](Transform3-type.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
-- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-## Supported imports
+## Import
 
 ```ts
 import { attachmentTransform3 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,7 +2,7 @@
 
 Constructs immutable finite XY bounds from ordered extrema or nonnegative size in millimetres.
 
-**bounds2**(`input`: [`Bounds2Options`](Bounds2Options.md) \| [`Bounds2`](Bounds2-type.md)): [`Bounds2`](Bounds2-type.md)
+**bounds2**(`input`: [`Bounds2`](Bounds2-type.md) \| [`Bounds2Options`](Bounds2Options.md)): [`Bounds2`](Bounds2-type.md)
 
 
 
@@ -16,7 +16,9 @@ the current Modeling runtime.
 
 <a id="input"></a>
 
-**`input`** · [`Bounds2Options`](Bounds2Options.md) \| [`Bounds2`](Bounds2-type.md) · Required
+**`input`** · [`Bounds2`](Bounds2-type.md) \| [`Bounds2Options`](Bounds2Options.md) · Required
+
+Ordered extrema, nonnegative size, or an existing XY bounds value to snapshot.
 
 
 
@@ -36,14 +38,10 @@ the current Modeling runtime.
 - [Text from a Font parameter](../../guides/svg-and-text.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/resolution-and-inspection.md#solid-inspection)
 
-## Supported imports
-
-```ts
-import { bounds2 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import { bounds2 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -18,6 +18,8 @@ the current Modeling runtime.
 
 **`input`** · [`Bounds3Options`](Bounds3Options.md) \| [`Bounds3`](Bounds3-type.md) · Required
 
+Ordered extrema, nonnegative size, or an existing XYZ bounds value to snapshot.
+
 
 
 ## Returns
@@ -36,14 +38,10 @@ the current Modeling runtime.
 - [Text from a Font parameter](../../guides/svg-and-text.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/resolution-and-inspection.md#solid-inspection)
 
-## Supported imports
-
-```ts
-import { bounds3 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import { bounds3 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -60,10 +60,10 @@ Midpoint of finite XYZ bounds in millimetres.
 - [Text from a Font parameter](../../guides/svg-and-text.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/resolution-and-inspection.md#solid-inspection)
 
-## Supported imports
+## Import
 
 ```ts
 import { boundsCenter } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -60,10 +60,10 @@ Inclusive XYZ dimensions in millimetres; zero extents are retained.
 - [Text from a Font parameter](../../guides/svg-and-text.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/resolution-and-inspection.md#solid-inspection)
 
-## Supported imports
+## Import
 
 ```ts
 import { boundsSize } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -48,12 +48,12 @@ resulting anchor frame explicitly; no anchor is inherited from a Boolean result.
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
-- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-## Supported imports
+## Import
 
 ```ts
 import { boxAnchor3 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -24,8 +24,8 @@ Use `bounds2` and `bounds3` for immutable extents with fluent `size()`, `center(
 
 | API | Summary |
 | --- | --- |
-| [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. |
+| [Bounds2](../Bounds2-type.md) | Immutable finite XY bounds in millimetres, with fluent extrema and measurements. |
+| [Bounds3](../Bounds3-type.md) | Immutable finite XYZ bounds in millimetres, with fluent extrema and measurements. |
 | [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. |
 | [BoundsFitOptions](../BoundsFitOptions.md) | Uniform fitting controls; fitting centers the source inside the target. |
@@ -48,4 +48,10 @@ Use `bounds2` and `bounds3` for immutable extents with fluent `size()`, `center(
 - [Text from a Font parameter](../../../guides/svg-and-text.md#text-from-a-font-parameter)
 - [Solid inspection](../../../guides/resolution-and-inspection.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -1,22 +1,24 @@
 # Curves and paths
 
-Sample reusable lines, arcs, cubic curves, and path frames with explicit physical sampling settings.
+Query, edit, refine, and interpolate paths with explicit closure and physical sampling settings.
 
-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.
+Use immutable `path2` and `path3` values for sampled trajectories; closed paths omit the repeated seam.
 
-- **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.
+- **Query:** `length()` includes the closing edge. `bounds()` is undefined for an empty path. `closestPoint()` measures nearest-boundary distance. `atDistance()` and `atFraction()` return a `PathStation` with point, tangent, arc-length offset, original edge index, and local edge fraction. Zero-length edges are skipped; exact vertices use the outgoing edge, except an open final endpoint.
+- **Edit:** `splitAt()` returns two open paths; `trim()` extracts an increasing distance range. Original interior vertices survive, and closed traversal starts at its authored seam.
+- **Refine:** `subdivide({ maxSegmentLength })` retains original corners. Equal-distance `resample()` can bridge corners and rejects a repeated closed seam. Both preserve closure and enforce output ceilings.
+- **Interpolate:** `spline2` and `spline3` sample centripetal Catmull–Rom spans through every waypoint. Physical policies bound cubic control hulls; `segmentsPerSpan` overrides them with exact intervals.
+- **Sample curves:** `sampleCurve2` and `sampleCurve3` retain directed endpoints and tangents; exact intervals are uniform in the analytic curve parameter.
+- **Interchange:** `toData()` returns a frozen record with dimension, closure, and points.
 
-Sweep frames require explicit seam and orientation choices.
+Path distribution and tangent patterns share the outgoing-edge convention. Sweep frames have their own centered-tangent orientation contract.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
 | [anchorFrame3](../anchorFrame3.md) | Converts an anchor into a right-handed frame with direction as local +Z. |
+| [distributeAlongPath](../distributeAlongPath.md) | Places an exact item count at equal arc-length intervals along a sampled XYZ path. |
 | [sampleCurve2](../sampleCurve2.md) | Samples a planar curve with the same guarantees and policy as spatial sampling. |
 | [sampleCurve3](../sampleCurve3.md) | Samples a spatial curve, preserving endpoints and directed unit tangents. |
 | [resolveGeometrySamplingLimits](../resolveGeometrySamplingLimits.md) | Resolves finite positive safe-integer allocation ceilings without ambient state. |
@@ -24,6 +26,8 @@ Sweep frames require explicit seam and orientation choices.
 | [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. |
 | [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. |
+| [spline2](../spline2.md) | Samples an immutable XY centripetal Catmull–Rom path through every waypoint in traversal order. Open endpoints use one-sided secants; closed paths are periodic and omit their repeated seam. Adjacent duplicate waypoints reject. The default physical policy bounds each cubic control hull; segmentsPerSpan instead selects exact uniform parameters per span. Sampling never coarsens to fit maxPathPoints. Invalid topology, nonfinite arithmetic, and exhausted budgets throw GeometryError. |
+| [spline3](../spline3.md) | Samples an immutable XYZ centripetal Catmull–Rom path with the same interpolation, seam, sampling, and ceiling rules as spline2. |
 
 ## Interfaces
 
@@ -34,14 +38,13 @@ Sweep frames require explicit seam and orientation choices.
 | [CubicBezierCurve2](../CubicBezierCurve2.md) | Planar cubic Bézier with explicit endpoint and control coordinates. |
 | [CubicBezierCurve3](../CubicBezierCurve3.md) | Spatial cubic Bézier with explicit endpoint and control coordinates. |
 | [CurveSamplingOptions](../CurveSamplingOptions.md) | Explicit physical sampling and allocation policy for reusable curves. |
-| [Frame3](../Frame3.md) | A right-handed orthonormal coordinate frame expressed in world coordinates. |
 | [GeometrySamplingLimits](../GeometrySamplingLimits.md) | Explicit allocation ceilings for pure sampling and host-owned modeling operations. |
 | [LineCurve2](../LineCurve2.md) | Straight planar curve in millimetres. |
 | [LineCurve3](../LineCurve3.md) | Straight spatial curve in millimetres. |
 | [Path2](../Path2-type.md) | Immutable directed XY polyline. Closure is explicit and does not imply a filled Section. |
 | [Path3](../Path3-type.md) | Immutable directed XYZ polyline; it represents sampled edges, not an analytic curve. |
 | [PathFrame](../PathFrame.md) | Orthonormal right-handed frame sampled along a path. |
-| [PathPlacement](../PathPlacement.md) | Position and unit tangent for one path-distributed item. |
+| [PathPlacement](../PathPlacement.md) | Position and directed unit edge tangent for one path-distributed item. |
 | [SampledCurve2](../SampledCurve2.md) | Immutable planar points and corresponding directed unit tangents. |
 | [SampledCurve3](../SampledCurve3.md) | Immutable spatial points and corresponding directed unit tangents. |
 | [SampleHelixOptions](../SampleHelixOptions.md) | Options for a sampled +Z helix with millimetre dimensions. |
@@ -51,6 +54,9 @@ Sweep frames require explicit seam and orientation choices.
 | [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. |
+| [PathStation](../PathStation.md) | Directed location at an arc-length offset along a sampled path. |
+| [PathSubdivisionOptions](../PathSubdivisionOptions.md) | Corner-preserving edge refinement; the original vertices remain in traversal order. |
+| [SplineOptions](../SplineOptions.md) | Physical or exact sampling of a centripetal Catmull–Rom spline through authored waypoints. |
 
 ## Type aliases
 
@@ -69,12 +75,17 @@ Sweep frames require explicit seam and orientation choices.
 | [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. |
 | [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. |
 
 ## Guides
 
-- [Path queries and closure-preserving interchange](../../../guides/geometry-values.md#query-paths-and-preserve-closure)
+- [Path queries and closure-preserving interchange](../../../guides/geometry-values.md#keep-path-closure-and-traversal)
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/geometry/categories/immutable-data.md

@@ -0,0 +1,40 @@
+# Immutable geometry data
+
+Capture reusable numeric data and construction placement contracts.
+
+Use immutableBuffer to capture numeric data for memoized preparation. Captured buffers expose indexed reads and iteration; copy() creates owned mutable storage. Bounds, vector, path, and transform values expose frozen toData() snapshots.
+
+Use /geometry/mesh for mesh construction, buffers, analysis, and validation contracts. LoftPlacement retains explicit z-or-transform station placement; ExtrusionSamplingOptions controls longitudinal sampling.
+
+## Functions
+
+| API | Summary |
+| --- | --- |
+| [resolveExtrusionSlices](../resolveExtrusionSlices.md) | Resolves longitudinal intervals for ordinary linear extrusion from physical curve resolution. |
+| [immutableBuffer](../immutableBuffer.md) | Copies numeric data once into private storage. This pure helper needs no active generation. |
+
+## Interfaces
+
+| API | Summary |
+| --- | --- |
+| [ExtrusionSamplingOptions](../ExtrusionSamplingOptions.md) | Shared sampling controls for a twisted or scaled linear extrusion. |
+| [ImmutableBuffer](../ImmutableBuffer-type.md) | Owned immutable numeric data. Iterate without copying; use copy() for mutable storage. |
+
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [LoftPlacement](../LoftPlacement.md) | A horizontal XY station height, or an explicit affine transform, never both. |
+| [NumericArray](../NumericArray.md) | Numeric storage supported by immutable generation buffers. |
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.