@metamesh/modeling 0.13.0 → 0.14.0

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

@@ -2,7 +2,7 @@
 
 Adds two finite XYZ vectors component-wise.
 
-`const` **add3**: (`a`: [`Vector3`](Vector3.md), `b`: [`Vector3`](Vector3.md)) => [`Vector3`](Vector3.md)
+`const` **add3**: (`a`: [`Vector3Tuple`](Vector3Tuple.md), `b`: [`Vector3Tuple`](Vector3Tuple.md)) => [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -16,23 +16,27 @@ add3([1, 2, 3], [4, 5, 6]); // [5, 7, 9]
 
 <a id="a"></a>
 
-**`a`** · [`Vector3`](Vector3.md) · Required
+**`a`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
 
 
 
 <a id="b"></a>
 
-**`b`** · [`Vector3`](Vector3.md) · Required
+**`b`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
 
 
 
 ## Returns
 
-[`Vector3`](Vector3.md)
+[`Vector3Tuple`](Vector3Tuple.md)
 
 
 ## Related APIs
 
-- [Vector3](Vector3.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.14.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.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -49,4 +49,4 @@ A deterministic report without mutating or copying the mesh.
 - [TriangleMeshQualityOptions](TriangleMeshQualityOptions.md)
 - [TriangleMeshQualityReport](TriangleMeshQualityReport.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -37,4 +37,4 @@ A normalized right-handed frame at the anchor position.
 - [Frame3](Frame3.md)
 - [GeometryToleranceOptions](GeometryToleranceOptions.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.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`: [`Transform3`](Transform3.md), `direction`: [`Vector3`](Vector3.md)): [`Vector3`](Vector3.md)
+**applyTransformDirection3**(`transform`: [`Transform3Matrix`](Transform3Matrix.md), `direction`: [`Vector3Tuple`](Vector3Tuple.md)): [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -12,7 +12,7 @@ The result is not normalized, preserving scale information.
 
 <a id="transform"></a>
 
-**`transform`** · [`Transform3`](Transform3.md) · Required
+**`transform`** · [`Transform3Matrix`](Transform3Matrix.md) · Required
 
 Valid row-major affine transform.
 
@@ -20,7 +20,7 @@ Valid row-major affine transform.
 
 <a id="direction"></a>
 
-**`direction`** · [`Vector3`](Vector3.md) · Required
+**`direction`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
 
 Finite XYZ direction.
 
@@ -28,14 +28,18 @@ Finite XYZ direction.
 
 ## Returns
 
-[`Vector3`](Vector3.md)
+[`Vector3Tuple`](Vector3Tuple.md)
 
 A fresh transformed direction.
 
 
 ## Related APIs
 
-- [Transform3](Transform3.md)
-- [Vector3](Vector3.md)
+- [Transform3Matrix](Transform3Matrix.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -2,7 +2,7 @@
 
 Applies an affine transform to a point, including translation.
 
-**applyTransformPoint3**(`transform`: [`Transform3`](Transform3.md), `point`: [`Vector3`](Vector3.md)): [`Vector3`](Vector3.md)
+**applyTransformPoint3**(`transform`: [`Transform3Matrix`](Transform3Matrix.md), `point`: [`Vector3Tuple`](Vector3Tuple.md)): [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -10,7 +10,7 @@ Applies an affine transform to a point, including translation.
 
 <a id="transform"></a>
 
-**`transform`** · [`Transform3`](Transform3.md) · Required
+**`transform`** · [`Transform3Matrix`](Transform3Matrix.md) · Required
 
 Valid row-major affine transform.
 
@@ -18,7 +18,7 @@ Valid row-major affine transform.
 
 <a id="point"></a>
 
-**`point`** · [`Vector3`](Vector3.md) · Required
+**`point`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
 
 Finite XYZ point.
 
@@ -26,14 +26,18 @@ Finite XYZ point.
 
 ## Returns
 
-[`Vector3`](Vector3.md)
+[`Vector3Tuple`](Vector3Tuple.md)
 
 A fresh transformed point.
 
 
 ## Related APIs
 
-- [Transform3](Transform3.md)
-- [Vector3](Vector3.md)
+- [Transform3Matrix](Transform3Matrix.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -2,7 +2,7 @@
 
 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)): [`Transform3`](Transform3.md)
+**attachTransform**(`source`: [`Anchor3`](Anchor3.md), `target`: [`Anchor3`](Anchor3.md), `options?`: [`AttachTransformOptions`](AttachTransformOptions.md)): [`Transform3Matrix`](Transform3Matrix.md)
 
 
 
@@ -55,7 +55,7 @@ Alignment, gap, spin, and tolerance policy.
 
 ## Returns
 
-[`Transform3`](Transform3.md)
+[`Transform3Matrix`](Transform3Matrix.md)
 
 A frozen affine transform for the moving object.
 
@@ -68,6 +68,10 @@ A frozen affine transform for the moving object.
 
 - [Anchor3](Anchor3.md)
 - [AttachTransformOptions](AttachTransformOptions.md)
-- [Transform3](Transform3.md)
+- [Transform3Matrix](Transform3Matrix.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -6,7 +6,7 @@ Midpoint of finite XY bounds in millimetres.
 
 
 
-**boundsCenter**(`bounds`: [`Bounds2`](Bounds2.md)): [`Vector2`](Vector2.md)
+**boundsCenter**(`bounds`: [`Bounds2`](Bounds2.md)): [`Vector2Tuple`](Vector2Tuple.md)
 
 
 
@@ -22,13 +22,13 @@ Midpoint of finite XY bounds in millimetres.
 
 ### Returns
 
-[`Vector2`](Vector2.md)
+[`Vector2Tuple`](Vector2Tuple.md)
 
 ## Call Signature
 
 
 
-**boundsCenter**(`bounds`: [`Bounds3`](Bounds3.md)): [`Vector3`](Vector3.md)
+**boundsCenter**(`bounds`: [`Bounds3`](Bounds3.md)): [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -44,19 +44,19 @@ Midpoint of finite XYZ bounds in millimetres.
 
 ### Returns
 
-[`Vector3`](Vector3.md)
+[`Vector3Tuple`](Vector3Tuple.md)
 
 
 ## Related APIs
 
 - [Bounds2](Bounds2.md)
 - [Bounds3](Bounds3.md)
-- [Vector2](Vector2.md)
-- [Vector3](Vector3.md)
+- [Vector2Tuple](Vector2Tuple.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
 ## Guides
 
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -6,7 +6,7 @@ Creates immutable centered XY bounds from nonnegative dimensions in millimetres.
 
 
 
-**boundsFromSize**(`size`: [`Vector2`](Vector2.md), `options?`: [`BoundsFromSizeOptions`](BoundsFromSizeOptions.md)): [`Bounds2`](Bounds2.md)
+**boundsFromSize**(`size`: [`Vector2Tuple`](Vector2Tuple.md), `options?`: [`BoundsFromSizeOptions`](BoundsFromSizeOptions.md)): [`Bounds2`](Bounds2.md)
 
 
 
@@ -16,7 +16,7 @@ Creates immutable centered XY bounds from nonnegative dimensions in millimetres.
 
 <a id="size"></a>
 
-**`size`** · [`Vector2`](Vector2.md) · Required
+**`size`** · [`Vector2Tuple`](Vector2Tuple.md) · Required
 
 
 
@@ -38,7 +38,7 @@ Creates immutable centered XY bounds from nonnegative dimensions in millimetres.
 
 
 
-**boundsFromSize**(`size`: [`Vector3`](Vector3.md), `options?`: [`BoundsFromSizeOptions`](BoundsFromSizeOptions.md)): [`Bounds3`](Bounds3.md)
+**boundsFromSize**(`size`: [`Vector3Tuple`](Vector3Tuple.md), `options?`: [`BoundsFromSizeOptions`](BoundsFromSizeOptions.md)): [`Bounds3`](Bounds3.md)
 
 
 
@@ -48,7 +48,7 @@ Creates immutable centered XYZ bounds from nonnegative dimensions in millimetres
 
 <a id="size-1"></a>
 
-**`size`** · [`Vector3`](Vector3.md) · Required
+**`size`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
 
 
 
@@ -72,12 +72,12 @@ Creates immutable centered XYZ bounds from nonnegative dimensions in millimetres
 - [Bounds2](Bounds2.md)
 - [Bounds3](Bounds3.md)
 - [BoundsFromSizeOptions](BoundsFromSizeOptions.md)
-- [Vector2](Vector2.md)
-- [Vector3](Vector3.md)
+- [Vector2Tuple](Vector2Tuple.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
 ## Guides
 
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.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)): [`Vector2`](Vector2.md)
+**boundsSize**(`bounds`: [`Bounds2`](Bounds2.md)): [`Vector2Tuple`](Vector2Tuple.md)
 
 
 
@@ -22,13 +22,13 @@ Inclusive XY dimensions in millimetres; zero extents are retained.
 
 ### Returns
 
-[`Vector2`](Vector2.md)
+[`Vector2Tuple`](Vector2Tuple.md)
 
 ## Call Signature
 
 
 
-**boundsSize**(`bounds`: [`Bounds3`](Bounds3.md)): [`Vector3`](Vector3.md)
+**boundsSize**(`bounds`: [`Bounds3`](Bounds3.md)): [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -44,19 +44,19 @@ Inclusive XYZ dimensions in millimetres; zero extents are retained.
 
 ### Returns
 
-[`Vector3`](Vector3.md)
+[`Vector3Tuple`](Vector3Tuple.md)
 
 
 ## Related APIs
 
 - [Bounds2](Bounds2.md)
 - [Bounds3](Bounds3.md)
-- [Vector2](Vector2.md)
-- [Vector3](Vector3.md)
+- [Vector2Tuple](Vector2Tuple.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
 ## Guides
 
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.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` \| [`Vector3`](Vector3.md) · Required
+- [`size`](BoxAnchorOptions.md#size) · `number` \| [`Vector3Tuple`](Vector3Tuple.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) · [`Vector3`](Vector3.md) · Optional
+- [`origin`](BoxAnchorOptions.md#origin) · [`Vector3Tuple`](Vector3Tuple.md) · Optional
 
   Construction origin; centered-box center or noncentered minimum corner. Defaults to zero.
 
@@ -45,4 +45,8 @@ resulting anchor frame explicitly; no anchor is inherited from a Boolean result.
 - [Anchor3](Anchor3.md)
 - [BoxAnchorOptions](BoxAnchorOptions.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -65,4 +65,4 @@ Builds closed thread-ridge components with every profile locked to the shaft's r
 - [HelicalThreadRidgeMeshOptions](HelicalThreadRidgeMeshOptions.md)
 - [TriangleMesh](TriangleMesh.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -99,4 +99,4 @@ arrays.
 - [HelicalThreadSolidMeshOptions](HelicalThreadSolidMeshOptions.md)
 - [TriangleMesh](TriangleMesh.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.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.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -2,16 +2,17 @@
 
 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. Sweep frames require explicit seam and orientation choices.
+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.
 
 ## 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 an XY-plane-preserving affine transform to a 2D path. |
+| [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. |
@@ -25,6 +26,8 @@ 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. |
@@ -60,4 +63,4 @@ sampleCurve2/3 retain directed endpoints and tangents. Exact curve intervals are
 | [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. |
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -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.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -70,4 +70,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.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -2,7 +2,7 @@
 
 Calculate pure linear, radial, grid, and path transforms.
 
-Pure pattern transforms use the same counts, spacing, centering and frames as root pattern operations. Transform3 values can place points, meshes or explicit geometry without a native engine. Linear and grid spacing use millimetres; radial angles use degrees. Paths use physical arc-length intervals and omit the seam when closed.
+Pure pattern transforms use the same counts, spacing, centering and frames as root pattern operations. Transform3Matrix values can place points, meshes or explicit geometry without a native engine. Linear and grid spacing use millimetres; radial angles use degrees. Paths use physical arc-length intervals and omit the seam when closed.
 
 ## Functions
 
@@ -31,4 +31,4 @@ Pure pattern transforms use the same counts, spacing, centering and frames as ro
 
 - [Primitive booleans and repeated placement](../../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

package/dist/docs/reference/geometry/categories/primitive-options.md

@@ -33,4 +33,4 @@ Dimensional shapes share object options, millimetre units and explicit placement
 | [BoxEdgeSelection](../BoxEdgeSelection.md) | Named individual edges or top/bottom rims and all four vertical edges. |
 | [BoxEdgeTreatments](../BoxEdgeTreatments.md) | Independent treatments for disjoint named edge selections; overlapping selections fail. |
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

package/dist/docs/reference/geometry/categories/profiles-regions.md

@@ -2,7 +2,7 @@
 
 Define winding, holes, stable profile landmarks, and reusable planar boundaries.
 
-Outer contours are counterclockwise and holes clockwise in Y-up coordinates, with implicit closing edges. The Loop factories return point data; regularPolygonContour uses degree rotation and explicit vertex/face sizing. `rectangleProfile({ size, treatment, id })` returns identified spans for family matching, not sampled points. Profile families preserve component, contour and span identities; matchProfiles returns CorrespondingProfile values with stable shared landmarks. No automatic topology guessing or reordering occurs. closeToAxis closes an open upward radius/height outline into a solid-body contour; hollow walls and bores require explicit material contours.
+Outer contours are counterclockwise and holes clockwise in Y-up coordinates, with implicit closing edges. The Loop factories return point data; regularPolygonContour uses degree rotation and explicit vertex/face sizing. transformContour and transformRegionData accept Transform2 placements or canonical Transform2Matrix data and retain reflection-safe winding. Use Section.transform for ordinary filled-shape authoring; transformRegionData serves serialized data preparation. `rectangleProfile({ size, treatment, id })` returns identified spans for family matching, not sampled points. Profile families preserve component, contour and span identities; matchProfiles returns CorrespondingProfile values with stable shared landmarks. No automatic topology guessing or reordering occurs. closeToAxis closes an open upward radius/height outline into a solid-body contour; hollow walls and bores require explicit material contours.
 
 ## Functions
 
@@ -21,8 +21,8 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | [sampleSideProfile](../sampleSideProfile.md) | Samples 1–31 line/cubic segments into a deeply immutable open [radius,height] polyline. Anchors must progress strictly upward; nonnegative-radius cubic controls must have ordered heights between their endpoints. Cubics use de Casteljau subdivision with a conservative control-hull chord-error bound. Lines also obey the optional physical edge-length ceiling. Neither normalized coordinates nor editor metadata are required. Endpoints are retained once; no axis closure, winding normalization, or manufacturing repair is performed. |
 | [sampleContour](../sampleContour.md) | Samples 2–32 connected line/cubic segments into a simple, nonzero-area, immutable CCW XY loop. Physical scaling precedes adaptive curve sampling; the final end must repeat start exactly. Shared anchors and the closing seam are emitted once. Winding normalization may change the starting vertex. The sampled loop is checked for self-intersection and degeneracy by `normalizeContour`; this is a single contour without holes. No editor modes or normalized coordinate range are required. No native engine, SDK, or ambient resolution is used. |
 | [signedContourArea](../signedContourArea.md) | Returns the signed area of a non-duplicated loop; positive means CCW. |
-| [transformContour](../transformContour.md) | Transforms a closed loop and preserves its original winding convention. |
-| [transformRegion](../transformRegion.md) | Transforms an explicit outer/hole region with reflection-safe winding correction. |
+| [transformContour](../transformContour.md) | Applies a canonical affine XY transform to a closed loop and preserves its original winding. |
+| [transformRegionData](../transformRegionData.md) | Transforms serialized polygon data with reflection-safe winding, without an engine. Use Section.transform(placement) when authoring filled geometry; this utility serves pure data preparation. |
 | [triangulateContour](../triangulateContour.md) | Ear-clips one normalized simple CCW loop into stable local vertex indices. |
 | [closeToAxis](../closeToAxis.md) | Closes an open, strictly upward [radius, height] side outline to the radius-zero axis. Adds horizontal bottom/top edges at the endpoint heights, retaining axis endpoints once. Returns a counterclockwise filled-boundary contour without a repeated seam vertex. Radii must be nonnegative; the result must enclose nonzero area without touching itself. This is a solid-body closure, not a hollow-wall or mounting-bore construction. |
 
@@ -36,7 +36,7 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | [ContourCurve](../ContourCurve.md) | One explicitly closed planar contour, independent of editor metadata and parameter contracts. |
 | [ContourPoint](../ContourPoint.md) | Planar X and upward Y in millimetres, or in units converted by sampling scales. |
 | [SideProfilePoint](../SideProfilePoint.md) | Radius and upward height in millimetres, or in units converted by sampling scales. |
-| [Polygon](../Polygon.md) | One bounded two-dimensional polygon. |
+| [PolygonData](../PolygonData.md) | One bounded two-dimensional polygon. |
 | [Profile](../Profile.md) | An explicit component/contour/span topology, before shared family sampling. |
 | [ProfileComponent2](../ProfileComponent2.md) | One component and its explicitly identified holes. |
 | [ProfileContour2](../ProfileContour2.md) | Ordered, closed spans. Outer winding is CCW and hole winding is CW. |
@@ -59,7 +59,7 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | [ContourSegment](../ContourSegment.md) | Straight or cubic Bézier segment in one closed planar contour. |
 | [SideProfileSegment](../SideProfileSegment.md) | One straight or cubic segment of an open, upward-progressing radius/height outline. |
 | [ProfileSpan2](../ProfileSpan2.md) | An identified line, circular arc, or cubic Bézier between corresponding landmarks. |
-| [Region](../Region.md) | A two-dimensional region represented by disjoint filled polygons. |
+| [RegionData](../RegionData.md) | A two-dimensional region represented by disjoint filled polygons. |
 | [RectangleCornerTreatment](../RectangleCornerTreatment.md) | A rectangle corner, including an explicitly untreated corner in a treatment tuple. |
 | [RectangleCornerTreatments](../RectangleCornerTreatments.md) | Corner treatments ordered top-right, top-left, bottom-left, bottom-right. |
 
@@ -71,4 +71,4 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | [regularPolygonContour](../regularPolygonContour.md) | Creates a centered CCW point loop with vertex or face radial sizing and an implicit seam. |
 | [starContour](../starContour.md) | Creates a centered CCW alternating-radius star within the selected profile sampling ceiling. |
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

package/dist/docs/reference/geometry/categories/resolution-errors.md

@@ -2,7 +2,7 @@
 
 Resolve physical sampling, numerical tolerances, and contextual failures.
 
-Defaults are 0.05 mm maximum circular chord error and 16–512 segments per complete circle. Exact local counts win. Algorithm limits fail explicitly. GeometryError supplies structured codes and operation context; no ambient resolution state exists.
+Defaults are 0.05 mm maximum circular chord error and 16–512 segments per complete circle. Face-sized circular sampling bounds outward radial excess and actual edge lengths. Exact local counts win. Algorithm limits fail explicitly. GeometryError supplies structured codes and operation context; no ambient resolution state exists.
 
 ## Functions
 
@@ -25,6 +25,7 @@ Defaults are 0.05 mm maximum circular chord error and 16–512 segments per comp
 | API | Summary |
 | --- | --- |
 | [AlignedCircularSegmentsOptions](../AlignedCircularSegmentsOptions.md) | Controls full-circle sampling that must satisfy one or more topology alignments. |
+| [CircularResolutionOptions](../CircularResolutionOptions.md) | Circular sampling measured from the nominal inscribed or circumscribed radius. |
 | [GeometryErrorContext](../GeometryErrorContext.md) | Serializable context attached to a geometry failure. |
 | [GeometryResolution](../GeometryResolution.md) | Tessellation policy for sampled geometry measured in millimetres. |
 | [GeometryToleranceOptions](../GeometryToleranceOptions.md) | Optional overrides for MetaMesh's geometry comparison policy. |
@@ -43,4 +44,4 @@ Defaults are 0.05 mm maximum circular chord error and 16–512 segments per comp
 | --- | --- |
 | [DEFAULT_GEOMETRY_TOLERANCE](../DEFAULT_GEOMETRY_TOLERANCE.md) | Default absolute, relative, and angular tolerances for millimetre-scale models. |
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.14.0`.

package/dist/docs/reference/geometry/categories/transforms-math.md

@@ -1,13 +1,17 @@
 # Transforms and vector math
 
-Compose explicit coordinate transforms and reusable placement anchors.
+Build immutable reusable placements and calculate with fluent vectors or tuple kernels.
 
-Lengths are millimetres. Pure rotation constructors require a degrees or radians object. Transform3 is row-major, and directions exclude translation. Attachment matches source and target frames with an explicit offset; physical clearance is an application decision.
+Use immutable vector2/vector3 and transform2/transform3 values for ordinary authoring. Operations return new values; tuples remain convenient inputs. dot, length and distance return numbers; cross returns a signed scalar in 2D and a right-handed vector in 3D. Normalization rejects zero vectors; fluent values reject nonfinite inputs and results. Rotations use degrees and named optional `{ pivot }` points in world coordinates. Calls and andThen composition apply in execution order. Points include translation; directions exclude it and retain scale; normals use inverse-transpose normalization. Shape methods and path helpers accept matching transforms directly. toArray and toMatrix serve interchange using Vector2Tuple/Vector3Tuple and canonical Transform2Matrix/Transform3Matrix data. to3D/to2D convert dimensions explicitly; XY restriction requires a preserved plane. Raw tuple kernels avoid fluent object allocation in hot loops, and matrix constructors provide lower-level interoperability. rotationTransform3 requires an explicit degrees or radians object; composeTransform3(after, before) applies before first. Attachment matches source and target frames; physical clearance is an application decision.
 
 ## 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. |
 | [applyTransformDirection3](../applyTransformDirection3.md) | Applies only the linear component of an affine transform to a direction. |
 | [applyTransformPoint3](../applyTransformPoint3.md) | Applies an affine transform to a point, including translation. |
 | [attachTransform](../attachTransform.md) | Builds the transform that moves a source anchor onto a target anchor. |
@@ -28,6 +32,12 @@ Lengths are millimetres. Pure rotation constructors require a degrees or radians
 
 | API | Summary |
 | --- | --- |
+| [Transform2](../Transform2-type.md) | Immutable reusable XY placement. Methods apply in written order; angles are degrees. |
+| [Transform3](../Transform3-type.md) | Immutable reusable XYZ placement. Methods apply in written order; angles are degrees. |
+| [Pivot2Options](../Pivot2Options.md) | A fixed XY point in world coordinates; omitted pivots use the coordinate origin. |
+| [Pivot3Options](../Pivot3Options.md) | A fixed XYZ point in world coordinates; omitted pivots use the coordinate origin. |
+| [Vector2](../Vector2-type.md) | Immutable XY arithmetic; vector operations return new values and measurements return numbers. |
+| [Vector3](../Vector3-type.md) | Immutable XYZ arithmetic; vector operations return new values and measurements return numbers. |
 | [Anchor3](../Anchor3.md) | An attachment pose on a solid or assembly. |
 | [AttachTransformOptions](../AttachTransformOptions.md) | Options controlling how one anchor is attached to another. |
 | [BoxAnchorOptions](../BoxAnchorOptions.md) | Box dimensions and construction origin for one named face anchor. |
@@ -37,27 +47,46 @@ Lengths are millimetres. Pure rotation constructors require a degrees or radians
 
 | API | Summary |
 | --- | --- |
+| [Transform2Input](../Transform2Input.md) | An immutable XY transform or its canonical row-major matrix for interchange. |
+| [Transform3Input](../Transform3Input.md) | An immutable XYZ transform or its canonical row-major matrix for interchange. |
+| [Vector2Input](../Vector2Input.md) | An XY tuple or immutable fluent vector accepted by vector operations. |
+| [Vector3Input](../Vector3Input.md) | An XYZ tuple or immutable fluent vector accepted by vector operations. |
 | [AxisAngleRotation3](../AxisAngleRotation3.md) | One explicitly unit-labelled right-handed axis-angle rotation. |
 | [BoxAnchorFace](../BoxAnchorFace.md) | Named face on an axis-aligned box. |
 | [CylinderAnchorFace](../CylinderAnchorFace.md) | Named face on a cylinder parallel to +Z. |
-| [Transform3](../Transform3.md) | A row-major affine 4x4 matrix applied to column vectors. |
-| [Vector2](../Vector2.md) | A two-dimensional Cartesian vector or point. |
-| [Vector3](../Vector3.md) | A three-dimensional Cartesian vector or point. |
+| [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. |
+| [Vector2Tuple](../Vector2Tuple.md) | A two-dimensional Cartesian vector or point. |
+| [Vector3Tuple](../Vector3Tuple.md) | A three-dimensional Cartesian vector or point. |
 
 ## Values
 
 | API | Summary |
 | --- | --- |
+| [add2](../add2.md) | Adds two finite XY vectors component-wise. |
 | [add3](../add3.md) | Adds two finite XYZ vectors component-wise. |
 | [cross3](../cross3.md) | Returns the right-handed cross product. |
+| [cross2](../cross2.md) | Returns the signed scalar cross product; positive means `b` is counter-clockwise from `a`. |
+| [distance2](../distance2.md) | Returns Euclidean point distance without allocating an intermediate difference vector. |
+| [distance3](../distance3.md) | Returns Euclidean point distance without allocating an intermediate difference vector. |
 | [dot3](../dot3.md) | Returns the scalar dot product. |
+| [dot2](../dot2.md) | Returns the scalar dot product. |
 | [IDENTITY_TRANSFORM3](../IDENTITY_TRANSFORM3.md) | Identity transform, safe to share because it is frozen. |
 | [length3](../length3.md) | Returns Euclidean vector length in the vector's coordinate units. |
+| [length2](../length2.md) | Returns Euclidean vector length in the vector's coordinate units. |
 | [lerp3](../lerp3.md) | Linearly interpolates two vectors; `t` is dimensionless and may extrapolate. |
-| [normalize3](../normalize3.md) | Normalizes a finite vector and rejects nonfinite lengths or lengths at or below `epsilon`. |
+| [lerp2](../lerp2.md) | Linearly interpolates two vectors; `t` is dimensionless and may extrapolate. |
+| [normalize3](../normalize3.md) | Returns a unit vector; `epsilon` is a finite, non-negative length threshold (default `1e-12`). Rejects invalid thresholds, nonfinite lengths, and lengths at or below the threshold with `INVALID_TOLERANCE`, `NON_FINITE_VALUE`, and `DEGENERATE_GEOMETRY` respectively. |
+| [normalize2](../normalize2.md) | Returns a unit vector; `epsilon` is a finite, non-negative length threshold (default `1e-12`). Rejects invalid thresholds, nonfinite lengths, and lengths at or below the threshold with `INVALID_TOLERANCE`, `NON_FINITE_VALUE`, and `DEGENERATE_GEOMETRY` respectively. |
 | [projectOntoPlane3](../projectOntoPlane3.md) | Removes the component parallel to a normalized plane normal. |
-| [rotateAroundAxis3](../rotateAroundAxis3.md) | Rotates a vector right-handed around an axis by `angle` radians. |
+| [rotate2](../rotate2.md) | Rotates a finite vector counter-clockwise in XY by `degrees` about the origin. Throws `NON_FINITE_VALUE` for nonfinite coordinates, angles, or derived coordinates. |
 | [scale3](../scale3.md) | Multiplies a vector by a dimensionless scalar. |
+| [scale2](../scale2.md) | Multiplies a vector by a dimensionless scalar. |
 | [subtract3](../subtract3.md) | Subtracts `b` from `a`. |
+| [subtract2](../subtract2.md) | Subtracts `b` from `a` component-wise. |
 
-Package: `@metamesh/modeling@0.13.0`.
+## Guides
+
+- [Reusable transforms and vector math](../../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.14.0`.