@metamesh/modeling 0.14.0 → 0.15.0

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

@@ -5,7 +5,7 @@ Dimensions, placement, and tessellation for a hollow Z-axis tube.
 ## Extends
 
 - [`CircularPrimitiveOptions`](CircularPrimitiveOptions.md)
-- [`PrimitivePlacement`](PrimitivePlacement.md)
+- [`PrimitiveAttachment`](PrimitiveAttachment.md)
 
 ## Properties
 
@@ -60,19 +60,19 @@ Operation-level physical tessellation policy over the active model-wide policy.
 
 ***
 
-### placement?
+### attachment?
 
 
 
-`readonly` `optional` **placement?**: [`PrimitivePlacementOptions`](PrimitivePlacementOptions.md)
+`readonly` `optional` **attachment?**: [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md)
 
 
 
-Applied after local construction; Section placement must preserve the XY plane.
+Applied after local construction; Section attachment must preserve the XY plane.
 
 #### Inherited from
 
-[`PrimitivePlacement`](PrimitivePlacement.md).[`placement`](PrimitivePlacement.md#placement)
+[`PrimitiveAttachment`](PrimitiveAttachment.md).[`attachment`](PrimitiveAttachment.md#attachment)
 
 ***
 
@@ -132,7 +132,7 @@ Outer radius in millimetres; greater than [TubeOptions.innerRadius](#innerradius
 - [CircularPrimitiveOptions](CircularPrimitiveOptions.md)
 - [GeometryResolution](GeometryResolution.md)
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
-- [PrimitivePlacement](PrimitivePlacement.md)
-- [PrimitivePlacementOptions](PrimitivePlacementOptions.md)
+- [PrimitiveAttachment](PrimitiveAttachment.md)
+- [PrimitiveAttachmentOptions](PrimitiveAttachmentOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -266,4 +266,4 @@ Returns this value's frozen readonly tuple for interchange; repeated calls do no
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -16,4 +16,4 @@ An XY tuple or immutable fluent vector accepted by vector operations.
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -11,4 +11,4 @@ A two-dimensional Cartesian vector or point.
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -278,4 +278,4 @@ Returns this value's frozen readonly tuple for interchange; repeated calls do no
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -16,4 +16,4 @@ An XYZ tuple or immutable fluent vector accepted by vector operations.
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -11,4 +11,4 @@ A three-dimensional Cartesian vector or point.
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -28,11 +28,11 @@ Baseline radius in millimetres, greater than zero and at most 10000.
 
 ***
 
-### centerAngleDegrees?
+### centerAngle?
 
 
 
-`readonly` `optional` **centerAngleDegrees?**: `number`
+`readonly` `optional` **centerAngle?**: `number`
 
 
 
@@ -50,4 +50,4 @@ Alignment datum in degrees counterclockwise from +X; defaults to 90.
 
 Reading direction around the circle; defaults to clockwise.
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -36,4 +36,4 @@ Exact measurements of these paths and their logical text layout.
 - [FittedTextLayout](FittedTextLayout.md)
 - [VectorTextMetrics](VectorTextMetrics.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -108,4 +108,4 @@ Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 - [VectorTextArcBaseline](VectorTextArcBaseline.md)
 - [VectorTextOptions](VectorTextOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -91,4 +91,4 @@ Number of lines, including empty and trailing lines; empty text occupies one lin
 
 - [Bounds2](Bounds2.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -47,4 +47,4 @@ Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
 - [VectorTextLayoutOptions](VectorTextLayoutOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -33,4 +33,4 @@ Adds two finite XY vectors component-wise.
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -39,4 +39,4 @@ add3([1, 2, 3], [4, 5, 6]); // [5, 7, 9]
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -54,4 +54,4 @@ inspected on every call, never cached.
 - [TriangleMeshAnalysis](TriangleMeshAnalysis.md)
 - [TriangleMeshAnalysisOptions](TriangleMeshAnalysisOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -26,7 +26,7 @@ Indexed triangle mesh in arbitrary consistent model units.
 
 Scale-aware tolerance and analysis budget.
 
-- [`maximumTriangleCount`](TriangleMeshQualityOptions.md#maximumtrianglecount) · `number` · Optional
+- [`maxTriangles`](TriangleMeshQualityOptions.md#maxtriangles) · `number` · Optional
 
   Maximum number of triangles inspected. Defaults to `200000`.
 
@@ -49,4 +49,4 @@ A deterministic report without mutating or copying the mesh.
 - [TriangleMeshQualityOptions](TriangleMeshQualityOptions.md)
 - [TriangleMeshQualityReport](TriangleMeshQualityReport.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/geometry/{createAnchor3.md → anchor3.md}

@@ -1,8 +1,8 @@
-# createAnchor3
+# anchor3
 
 Constructs a normalized immutable attachment anchor.
 
-**createAnchor3**(`position`: [`Vector3Tuple`](Vector3Tuple.md), `direction`: [`Vector3Tuple`](Vector3Tuple.md), `up?`: [`Vector3Tuple`](Vector3Tuple.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Anchor3`](Anchor3.md)
+**anchor3**(`position`: [`Vector3Input`](Vector3Input.md), `direction`: [`Vector3Input`](Vector3Input.md), `up?`: [`Vector3Input`](Vector3Input.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Anchor3`](Anchor3-type.md)
 
 
 
@@ -13,7 +13,7 @@ input drift while preserving its roll intent.
 
 <a id="position"></a>
 
-**`position`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`position`** · [`Vector3Input`](Vector3Input.md) · Required
 
 Finite anchor point in model coordinates.
 
@@ -21,7 +21,7 @@ Finite anchor point in model coordinates.
 
 <a id="direction"></a>
 
-**`direction`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`direction`** · [`Vector3Input`](Vector3Input.md) · Required
 
 Non-zero outward attachment normal.
 
@@ -29,7 +29,7 @@ Non-zero outward attachment normal.
 
 <a id="up"></a>
 
-**`up`** · [`Vector3Tuple`](Vector3Tuple.md) · Optional
+**`up`** · [`Vector3Input`](Vector3Input.md) · Optional
 
 Non-parallel roll reference; defaults to +Y.
 
@@ -45,7 +45,7 @@ Optional comparison overrides.
 
 ## Returns
 
-[`Anchor3`](Anchor3.md)
+[`Anchor3`](Anchor3-type.md)
 
 A frozen anchor with unit, orthogonal direction and up vectors.
 
@@ -56,12 +56,12 @@ A frozen anchor with unit, orthogonal direction and up vectors.
 
 ## Related APIs
 
-- [Anchor3](Anchor3.md)
+- [Anchor3](Anchor3-type.md)
 - [GeometryToleranceOptions](GeometryToleranceOptions.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector3Input](Vector3Input.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.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.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Frame3`](Frame3.md)
+**anchorFrame3**(`anchor`: [`Anchor3`](Anchor3-type.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Frame3`](Frame3.md)
 
 
 
@@ -10,9 +10,9 @@ Converts an anchor into a right-handed frame with direction as local +Z.
 
 <a id="anchor"></a>
 
-**`anchor`** · [`Anchor3`](Anchor3.md) · Required
+**`anchor`** · [`Anchor3`](Anchor3-type.md) · Required
 
-Anchor created by [createAnchor3](createAnchor3.md) or equivalent valid data.
+Anchor created by [anchor3](anchor3.md) or equivalent valid data.
 
 
 
@@ -33,8 +33,8 @@ A normalized right-handed frame at the anchor position.
 
 ## Related APIs
 
-- [Anchor3](Anchor3.md)
+- [Anchor3](Anchor3-type.md)
 - [Frame3](Frame3.md)
 - [GeometryToleranceOptions](GeometryToleranceOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -42,4 +42,4 @@ A fresh transformed direction.
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -40,4 +40,4 @@ A fresh transformed point.
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/geometry/{attachTransform.md → attachmentTransform3.md}

@@ -1,8 +1,8 @@
-# attachTransform
+# attachmentTransform3
 
 Builds the transform that moves a source anchor onto a target anchor.
 
-**attachTransform**(`source`: [`Anchor3`](Anchor3.md), `target`: [`Anchor3`](Anchor3.md), `options?`: [`AttachTransformOptions`](AttachTransformOptions.md)): [`Transform3Matrix`](Transform3Matrix.md)
+**attachmentTransform3**(`source`: [`Anchor3`](Anchor3-type.md), `target`: [`Anchor3`](Anchor3-type.md), `options?`: [`AttachOptions`](AttachOptions.md)): [`Transform3Matrix`](Transform3Matrix.md)
 
 
 
@@ -15,7 +15,7 @@ alignment around the final source direction.
 
 <a id="source"></a>
 
-**`source`** · [`Anchor3`](Anchor3.md) · Required
+**`source`** · [`Anchor3`](Anchor3-type.md) · Required
 
 Anchor expressed in the moving object's local coordinates.
 
@@ -23,7 +23,7 @@ Anchor expressed in the moving object's local coordinates.
 
 <a id="target"></a>
 
-**`target`** · [`Anchor3`](Anchor3.md) · Required
+**`target`** · [`Anchor3`](Anchor3-type.md) · Required
 
 Desired anchor pose in destination coordinates.
 
@@ -31,23 +31,23 @@ Desired anchor pose in destination coordinates.
 
 <a id="options"></a>
 
-**`options`** · [`AttachTransformOptions`](AttachTransformOptions.md) · Optional
+**`options`** · [`AttachOptions`](AttachOptions.md) · Optional
 
 Alignment, gap, spin, and tolerance policy.
 
-- [`alignment`](AttachTransformOptions.md#alignment) · `"opposed"` \| `"same"` · Optional
+- [`alignment`](AttachOptions.md#alignment) · `"opposed"` \| `"same"` · Optional
 
   Align outward directions face-to-face (`opposed`) or in parallel (`same`).
 
-- [`gap`](AttachTransformOptions.md#gap) · `number` · Optional
+- [`gap`](AttachOptions.md#gap) · `number` · Optional
 
   Separation along the target anchor's outward direction in model units.
 
-- [`spinRadians`](AttachTransformOptions.md#spinradians) · `number` · Optional
+- [`spin`](AttachOptions.md#spin) · `number` · Optional
 
-  Additional right-handed roll about the attached direction, in radians.
+  Additional right-handed roll about the attached direction, in degrees.
 
-- [`tolerance`](AttachTransformOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+- [`tolerance`](AttachOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
 
   Optional numeric comparison overrides.
 
@@ -66,12 +66,12 @@ A frozen affine transform for the moving object.
 
 ## Related APIs
 
-- [Anchor3](Anchor3.md)
-- [AttachTransformOptions](AttachTransformOptions.md)
+- [Anchor3](Anchor3-type.md)
+- [AttachOptions](AttachOptions.md)
 - [Transform3Matrix](Transform3Matrix.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -59,4 +59,4 @@ Midpoint of finite XYZ bounds in millimetres.
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -80,4 +80,4 @@ Creates immutable centered XYZ bounds from nonnegative dimensions in millimetres
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -59,4 +59,4 @@ Inclusive XYZ dimensions in millimetres; zero extents are retained.
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 Creates an outward face-center anchor using the same local origin convention as box().
 
-**boxAnchor3**(`options`: [`BoxAnchorOptions`](BoxAnchorOptions.md)): [`Anchor3`](Anchor3.md)
+**boxAnchor3**(`options`: [`BoxAnchorOptions`](BoxAnchorOptions.md)): [`Anchor3`](Anchor3-type.md)
 
 
 
@@ -32,7 +32,7 @@ Creates an outward face-center anchor using the same local origin convention as
 
 ## Returns
 
-[`Anchor3`](Anchor3.md)
+[`Anchor3`](Anchor3-type.md)
 
 ## Remarks
 
@@ -42,11 +42,11 @@ resulting anchor frame explicitly; no anchor is inherited from a Boolean result.
 
 ## Related APIs
 
-- [Anchor3](Anchor3.md)
+- [Anchor3](Anchor3-type.md)
 - [BoxAnchorOptions](BoxAnchorOptions.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -32,4 +32,4 @@ Bounds2 and Bounds3 are shared min/max data for text, mesh measurements, and pla
 - [Text from a Font parameter](../../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,21 +2,20 @@
 
 Sample reusable lines, arcs, cubic curves, and path frames with explicit physical policies.
 
-sampleCurve2/3 retain directed endpoints and tangents. Exact curve intervals are uniform in the curve parameter; resamplePolyline2/3 use equal arc length. Both resampling dimensions accept the same closed option and return points plus tangents; closed outputs include the closing edge without repeating the first point. Adaptive policies use millimetre deviation and edge length, with checked vertex ceilings. transformPath2 accepts Transform2 placements or Transform2Matrix data; transformPath3 accepts Transform3 placements or Transform3Matrix data. Paths retain point order after reflection. closestPointOnPath returns a point, distance, edge index and interpolation fraction on an open path or explicitly closed boundary. Sweep frames require explicit seam and orientation choices.
+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.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
 | [anchorFrame3](../anchorFrame3.md) | Converts an anchor into a right-handed frame with direction as local +Z. |
-| [closestPointOnPath](../closestPointOnPath.md) | Finds the closest position anywhere on an open XY path or closed contour. |
 | [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. |
-| [transformPath2](../transformPath2.md) | Applies a canonical affine XY transform to a 2D path without changing point order. |
-| [transformPath3](../transformPath3.md) | Applies an affine transform to a 3D path without mutating its points. |
 | [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. |
+| [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
 
@@ -26,19 +25,22 @@ sampleCurve2/3 retain directed endpoints and tangents. Exact curve intervals are
 | [ArcCurve3](../ArcCurve3.md) | Spatial circular arc in the plane of two orthogonal unit directions. |
 | [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. |
-| [ClosestPointOnPathOptions](../ClosestPointOnPathOptions.md) | Topology and work ceiling for a closest-point query on a sampled path. |
-| [ClosestPointOnPathResult](../ClosestPointOnPathResult.md) | Closest position on a sampled path, measured in millimetres. |
 | [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. |
 | [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. |
 | [PolylineResamplingOptions](../PolylineResamplingOptions.md) | Equal arc-length sampling of an open path or an implicitly closed loop. |
+| [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. |
 
 ## Type aliases
 
@@ -46,21 +48,21 @@ sampleCurve2/3 retain directed endpoints and tangents. Exact curve intervals are
 | --- | --- |
 | [Curve2](../Curve2.md) | Reusable planar curve definition. |
 | [Curve3](../Curve3.md) | Reusable spatial curve definition. |
-| [Path2](../Path2.md) | An ordered, open sequence of two-dimensional points. |
-| [Path3](../Path3.md) | An ordered, open sequence of three-dimensional points. |
 | [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. |
 
 ## 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. |
-| [cumulativePathLengths](../cumulativePathLengths.md) | Returns cumulative arc length for finite points under maxPathPoints (default 100000); rejects overflowing length. |
+| [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. |
 | [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. |
-| [pathLength](../pathLength.md) | Returns total sampled 3D path length, or zero for an empty 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. |
+| [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. |
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/geometry/categories/mechanical.md

@@ -8,13 +8,13 @@ Pure kernels resolve dimensions and emit outlines or meshes without native state
 
 | API | Summary |
 | --- | --- |
-| [buildHelicalThreadRidgeMesh](../buildHelicalThreadRidgeMesh.md) | Builds closed thread-ridge components with every profile locked to the shaft's radial/axial frame. The mesh is intended for union with its minor-envelope cylinder and never owns WASM objects. |
-| [buildHelicalThreadSolidMesh](../buildHelicalThreadSolidMesh.md) | Builds one closed threaded cylinder without a ridge/core Boolean seam. |
+| [helicalThreadRidgeMesh](../helicalThreadRidgeMesh.md) | Builds closed thread-ridge components with every profile locked to the shaft's radial/axial frame. The mesh is intended for union with its minor-envelope cylinder and never owns WASM objects. |
+| [helicalThreadSolidMesh](../helicalThreadSolidMesh.md) | Builds one closed threaded cylinder without a ridge/core Boolean seam. |
 | [compensateThreadDiameters](../compensateThreadDiameters.md) | Applies role-specific radial compensation while preserving thread depth. |
 | [compensateThreadProfileAxially](../compensateThreadProfileAxially.md) | Applies axial fit allowance to a validated periodic profile. |
 | [compensateThreadProfileForFaceting](../compensateThreadProfileForFaceting.md) | Applies printable axial fit plus the conservative phase allowance required by circular facets. |
-| [createThreadProfile](../createThreadProfile.md) | Creates a periodic thread profile for the shaft-locked helical mesher. |
-| [getMetricClearanceHole](../getMetricClearanceHole.md) | Returns one recommended metric clearance-hole diameter in millimetres. |
+| [threadProfile](../threadProfile.md) | Creates a periodic thread profile for the shaft-locked helical mesher. |
+| [getMetricClearanceHoleDiameter](../getMetricClearanceHoleDiameter.md) | Returns one recommended metric clearance-hole diameter in millimetres. |
 | [getMetricFastenerStandard](../getMetricFastenerStandard.md) | Returns the immutable standards record for one supported metric size. |
 | [measureInternalCylindricalGearPairMotion](../measureInternalCylindricalGearPairMotion.md) | Measures sampled kinematic interference over one tooth cycle of an internal gear pair. |
 | [minimumCylindricalGearToothCountWithoutUndercut](../minimumCylindricalGearToothCountWithoutUndercut.md) | Returns the smallest unshifted full-depth external tooth count that avoids rack-cutter undercut. |
@@ -68,7 +68,7 @@ Pure kernels resolve dimensions and emit outlines or meshes without native state
 | [ThreadedRodOptions](../ThreadedRodOptions.md) | Options for a compensated external threaded rod along +Z. |
 | [ThreadEndTreatmentOptions](../ThreadEndTreatmentOptions.md) | Axial end controls for a generated ridge. |
 | [ThreadHelixOptions](../ThreadHelixOptions.md) | Conventional helix options: `pitch` is adjacent spacing and lead is `pitch * starts`. |
-| [ThreadProfile](../ThreadProfile.md) | A validated immutable periodic thread profile in `[axial, radial]` millimetres. |
+| [ThreadProfile](../ThreadProfile-type.md) | A validated immutable periodic thread profile in `[axial, radial]` millimetres. |
 | [ThreadProfileBaseSpec](../ThreadProfileBaseSpec.md) | Fields shared by all thread profile specifications. |
 | [TrapezoidalThreadProfileSpec](../TrapezoidalThreadProfileSpec.md) | Trapezoidal thread profile with a configurable included angle. |
 | [TriangularThreadProfileSpec](../TriangularThreadProfileSpec.md) | ISO/UTS-like 60-degree truncated triangular profile. |
@@ -98,4 +98,4 @@ Pure kernels resolve dimensions and emit outlines or meshes without native state
 | [METRIC_FASTENER_STANDARDS](../METRIC_FASTENER_STANDARDS.md) | Curated metric modeling dimensions for clearance holes, regular hex nuts, and socket-head cap screws. |
 | [PRINTABLE_THREAD_FIT_POLICIES](../PRINTABLE_THREAD_FIT_POLICIES.md) | Conservative baseline print-fit policies in millimetres. |
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/geometry/categories/meshes.md

@@ -11,11 +11,10 @@ Manufacturing meshes use Float32 XYZ positions and Uint32 triangle indices. Clos
 | [analyzeTriangleMesh](../analyzeTriangleMesh.md) | Validates and measures a mesh in one position and one triangle traversal. |
 | [analyzeTriangleMeshQuality](../analyzeTriangleMeshQuality.md) | Measures triangle shape, edge topology, vertex concentration, and connected planar patches. |
 | [heightfieldMesh](../heightfieldMesh.md) | Builds a closed indexed mesh from a rectilinear top, matched boundary walls, and flat base. Heights run once per grid point after preflight; center-error adds one evaluation per cell. Top winding is +Z, the base is -Z, and sides face outward. Coordinates and heights must fit Float32 storage. Explicit axes are captured before sampling; shared wall vertices prevent cracks. |
-| [createTriangleMeshSignature](../createTriangleMeshSignature.md) | Creates an order-independent regression signature for a manufacturing mesh. |
+| [computeTriangleMeshSignature](../computeTriangleMeshSignature.md) | Creates an order-independent regression signature for a manufacturing mesh. |
 | [joinTriangleMeshes](../joinTriangleMeshes.md) | Concatenates meshes into one indexed mesh without welding coincident vertices. |
-| [extrudeMesh](../extrudeMesh.md) | Linearly extrudes one simple profile along +Z with robust ear-clipped caps. |
+| [extrudeMesh](../extrudeMesh.md) | Linearly extrudes one simple profile along +Z with robust ear-clipped caps. Path2 profiles must be closed; raw point collections have an implicit closing edge. |
 | [loftMesh](../loftMesh.md) | Lofts simple point loops at z heights or explicit right-handed frames, in input order. |
-| [measureTriangleMesh](../measureTriangleMesh.md) | Measures bounds, surface area, and signed volume without changing the mesh. |
 | [preflightHeightfield](../preflightHeightfield.md) | Checks grid dimensions, coordinate precision, and allocation bounds before evaluating heights. |
 | [reverseTriangleMesh](../reverseTriangleMesh.md) | Returns a copy of a mesh with every triangle winding reversed. |
 | [sweepMesh](../sweepMesh.md) | Sweeps one explicitly ordered point loop, with caps or a geometrically matching closed seam. |
@@ -70,4 +69,4 @@ Manufacturing meshes use Float32 XYZ positions and Uint32 triangle indices. Clos
 | [meshBounds](../meshBounds.md) | Computes axis-aligned bounds for a non-empty mesh. |
 | [revolveMesh](../revolveMesh.md) | Revolves a non-duplicated closed `[radius, z]` profile around +Z. |
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/geometry/categories/pattern-placement.md

@@ -8,27 +8,27 @@ Pure pattern transforms use the same counts, spacing, centering and frames as ro
 
 | API | Summary |
 | --- | --- |
-| [linearPatternTransforms](../linearPatternTransforms.md) | Equal linear placements in millimetres, including the original at the origin. |
+| [linearPatternTransforms](../linearPatternTransforms.md) | Spatial XYZ matrix placements in millimetres, including the original at the origin. |
 | [radialPatternTransforms](../radialPatternTransforms.md) | Rotations about an explicit axis; angles use degrees and the first placement is identity. |
-| [gridPatternTransforms](../gridPatternTransforms.md) | XY or XYZ grid placements in millimetres, in X-fastest order. |
+| [gridPatternTransforms](../gridPatternTransforms.md) | Spatial XYZ matrices for an XY or XYZ grid, in X-fastest order. |
 | [pathPatternTransforms](../pathPatternTransforms.md) | Equal physical arc-length placements along a sampled XYZ path. Tangent orientation maps +Z onto the local path tangent; fixed orientation only translates. Closed paths omit a repeated seam. Explicit sampling ceilings bound both input points and output placements. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [RadialPatternOptions](../RadialPatternOptions.md) | Options for repeating one solid around an axis through a center point. |
 | [PathPatternOptions](../PathPatternOptions.md) | Equal physical arc-length placements along an open or implicitly closed sampled path. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [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. |
+| [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. |
+| [RadialPatternOptions](../RadialPatternOptions.md) | Degree rotations about a fixed world-space pivot; XY patterns use the implicit +Z axis. |
+| [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. |
 
 ## Guides
 
 - [Primitive booleans and repeated placement](../../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.