@metamesh/modeling 0.13.0 → 0.15.0

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

@@ -2,7 +2,7 @@
 
 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.
+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
 
@@ -11,11 +11,11 @@ sampleCurve2/3 retain directed endpoints and tangents. Exact curve intervals are
 | [anchorFrame3](../anchorFrame3.md) | Converts an anchor into a right-handed frame with direction as local +Z. |
 | [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. |
-| [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
 
@@ -30,12 +30,17 @@ sampleCurve2/3 retain directed endpoints and tangents. Exact curve intervals are
 | [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
 
@@ -43,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.13.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.13.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,33 +2,33 @@
 
 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
 
 | 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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 Share one option contract for dimensional primitives and edge treatments.
 
-Dimensional shapes share object options, millimetre units and explicit placement. Boxes use scalar or XYZ size; cylinders use scalar or bottom/top radii and independent end treatments. Circular shapes share exact segments, physical resolution and vertex/face radial sizing where applicable. EdgeTreatment distinguishes circular radius from equal or unequal setbacks, smooth cubic transitions and exact custom setback profiles. PrimitivePlacementOptions maps a local anchor to a target with alignment, gap and degree spin.
+Dimensional shapes share object options, millimetre units and explicit placement. Boxes use scalar or XYZ size; cylinders use scalar or bottom/top radii and independent end treatments. Circular shapes share exact segments, physical resolution and vertex/face radial sizing where applicable. EdgeTreatment distinguishes circular radius from equal or unequal setbacks, smooth cubic transitions and exact custom setback profiles. PrimitiveAttachmentOptions maps a local anchor to a target with alignment, gap and degree spin.
 
 ## Interfaces
 
@@ -15,8 +15,8 @@ Dimensional shapes share object options, millimetre units and explicit placement
 | [TorusOptions](../TorusOptions.md) | Dimensions and independent ring/profile tessellation for a torus around the Z axis. |
 | [TubeOptions](../TubeOptions.md) | Dimensions, placement, and tessellation for a hollow Z-axis tube. |
 | [EndTreatments](../EndTreatments.md) | Independent inward finishing on primitive or straight convex extrusion ends. Zero amounts leave the end untreated, including when all ends are disabled. |
-| [PrimitivePlacement](../PrimitivePlacement.md) | Placement shared by solid and filled-section factories. |
-| [PrimitivePlacementOptions](../PrimitivePlacementOptions.md) | Maps an explicit or named shape-local attachment anchor onto a world-space anchor. |
+| [PrimitiveAttachment](../PrimitiveAttachment.md) | Anchor attachment shared by solid and filled-section factories. |
+| [PrimitiveAttachmentOptions](../PrimitiveAttachmentOptions.md) | Maps an explicit or named shape-local attachment anchor onto a world-space anchor. |
 | [RadialSizingOptions](../RadialSizingOptions.md) | Nominal radial sizing shared by circular and regular polygon construction. |
 | [SmoothEdgeTreatment](../SmoothEdgeTreatment.md) | A cubic corner transition with zero curvature at its straight tangent joins. |
 | [ProfiledEdgeTreatment](../ProfiledEdgeTreatment.md) | A deliberately sampled, inward-only corner profile with exact polyline geometry. |
@@ -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.15.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. Contour factories return point data; regularPolygonContour uses degree rotation and explicit vertex/face sizing. Path2.transform preserves traversal, while transformRegionData accepts a Transform2 placement or canonical Transform2Matrix data and retains reflection-safe filled 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,7 @@ 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. |
+| [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 +35,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 +58,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 +70,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.15.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.15.0`.

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

@@ -1,19 +1,23 @@
 # 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. |
+| [attachmentTransform3](../attachmentTransform3.md) | Builds the transform that moves a source anchor onto a target anchor. |
 | [boxAnchor3](../boxAnchor3.md) | Creates an outward face-center anchor using the same local origin convention as box(). |
 | [composeTransform3](../composeTransform3.md) | Composes two affine transforms without mutating either matrix. |
-| [createAnchor3](../createAnchor3.md) | Constructs a normalized immutable attachment anchor. |
+| [anchor3](../anchor3.md) | Constructs a normalized immutable attachment anchor. |
 | [cylinderAnchor3](../cylinderAnchor3.md) | Creates a cap-center or radial-side anchor using cylinder()'s construction origin. |
 | [eulerTransform3](../eulerTransform3.md) | Creates an immutable right-handed XYZ Euler rotation transform. |
 | [frameTransform3](../frameTransform3.md) | Converts a right-handed orthonormal frame into a local-to-world transform. |
@@ -28,8 +32,14 @@ Lengths are millimetres. Pure rotation constructors require a degrees or radians
 
 | API | Summary |
 | --- | --- |
-| [Anchor3](../Anchor3.md) | An attachment pose on a solid or assembly. |
-| [AttachTransformOptions](../AttachTransformOptions.md) | Options controlling how one anchor is attached to another. |
+| [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-type.md) | An attachment pose on a solid or assembly. |
+| [AttachOptions](../AttachOptions.md) | Options controlling how one anchor is attached to another. |
 | [BoxAnchorOptions](../BoxAnchorOptions.md) | Box dimensions and construction origin for one named face anchor. |
 | [CylinderAnchorOptions](../CylinderAnchorOptions.md) | Cylinder 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.15.0`.

package/dist/docs/reference/geometry/categories/vector-import.md

@@ -10,14 +10,14 @@ SVG input is bounded and rejects unsupported resources or content contextually.
 | --- | --- |
 | [preflightSvgRegion](../preflightSvgRegion.md) | Preflights bounded SVG geometry without browser or Manifold dependencies. |
 | [sampleTextContours](../sampleTextContours.md) | Samples a prepared text layout without shaping text again or loading a font. |
-| [strokePathRegion](../strokePathRegion.md) | Converts a sampled millimetre path into the filled region covered by a centered stroke. |
+| [strokeRegionData](../strokeRegionData.md) | Converts a sampled millimetre path into the filled region covered by a centered stroke. |
 | [fitTextLayout](../fitTextLayout.md) | Uniformly fits visible text ink inside finite XY bounds, centering it on the target. Transforms retained vector paths before sampling, so later textSection/sampleTextContours resolution remains in final millimetres. Logical advances scale without translation; line count is unchanged. The input layout is preserved. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [StrokePathRegionOptions](../StrokePathRegionOptions.md) | Physical stroke and topology controls for strokePathRegion. |
+| [StrokeOptions](../StrokeOptions.md) | Physical stroke and topology controls shared by pure regions and native Sections. |
 | [SvgImportOptions](../SvgImportOptions.md) | Sampling controls for deterministic SVG-to-region conversion. |
 | [SvgRegionPreflight](../SvgRegionPreflight.md) | Exact normalized SVG region plus bounded source, geometry, and safe-repair diagnostics. |
 | [SvgRegionPreflightRepairs](../SvgRegionPreflightRepairs.md) | Visible, appearance-preserving cleanup counters from bounded SVG import. |
@@ -34,7 +34,7 @@ SVG input is bounded and rejects unsupported resources or content contextually.
 
 | API | Summary |
 | --- | --- |
-| [StrokePathCap](../StrokePathCap.md) | End-cap treatment for an open stroked path. |
-| [StrokePathJoin](../StrokePathJoin.md) | Join treatment where adjacent stroked path segments meet. |
+| [StrokeCap](../StrokeCap.md) | End-cap treatment for an open stroked path. |
+| [StrokeJoin](../StrokeJoin.md) | Join treatment where adjacent stroked path segments meet. |
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -30,4 +30,4 @@ circleContour({ diameter: 20, segments: 32 });
 - [CircleContourOptions](CircleContourOptions.md)
 - [Contour](Contour.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 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.
 
-**closeToAxis**(`side`: readonly [`Vector2`](Vector2.md)[], `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): [`Contour`](Contour.md)
+**closeToAxis**(`side`: readonly [`Vector2Tuple`](Vector2Tuple.md)[], `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): [`Contour`](Contour.md)
 
 
 
@@ -10,7 +10,7 @@ Closes an open, strictly upward [radius, height] side outline to the radius-zero
 
 <a id="side"></a>
 
-**`side`** · readonly [`Vector2`](Vector2.md)[] · Required
+**`side`** · readonly [`Vector2Tuple`](Vector2Tuple.md)[] · Required
 
 
 
@@ -29,6 +29,6 @@ Closes an open, strictly upward [radius, height] side outline to the radius-zero
 
 - [Contour](Contour.md)
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
-- [Vector2](Vector2.md)
+- [Vector2Tuple](Vector2Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -48,4 +48,4 @@ allowances as radial mating clearance.
 - [CompensatedThreadDiameters](CompensatedThreadDiameters.md)
 - [ThreadCompensationOptions](ThreadCompensationOptions.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 Applies axial fit allowance to a validated periodic profile.
 
-**compensateThreadProfileAxially**(`profile`: [`ThreadProfile`](ThreadProfile.md), `axialBacklash`: `number`, `role`: `"female"` \| `"male"`): [`ThreadProfile`](ThreadProfile.md)
+**compensateThreadProfileAxially**(`profile`: [`ThreadProfile`](ThreadProfile-type.md), `axialBacklash`: `number`, `role`: `"female"` \| `"male"`): [`ThreadProfile`](ThreadProfile-type.md)
 
 
 
@@ -14,7 +14,7 @@ change. The returned profile is a new deeply immutable value.
 
 <a id="profile"></a>
 
-**`profile`** · [`ThreadProfile`](ThreadProfile.md) · Required
+**`profile`** · [`ThreadProfile`](ThreadProfile-type.md) · Required
 
 
 
@@ -32,11 +32,11 @@ change. The returned profile is a new deeply immutable value.
 
 ## Returns
 
-[`ThreadProfile`](ThreadProfile.md)
+[`ThreadProfile`](ThreadProfile-type.md)
 
 
 ## Related APIs
 
-- [ThreadProfile](ThreadProfile.md)
+- [ThreadProfile](ThreadProfile-type.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 Applies printable axial fit plus the conservative phase allowance required by circular facets.
 
-**compensateThreadProfileForFaceting**(`profile`: [`ThreadProfile`](ThreadProfile.md), `axialBacklash`: `number`, `role`: `"female"` \| `"male"`, `starts`: `number`, `circularSegments`: `number`): [`ThreadProfile`](ThreadProfile.md)
+**compensateThreadProfileForFaceting**(`profile`: [`ThreadProfile`](ThreadProfile-type.md), `axialBacklash`: `number`, `role`: `"female"` \| `"male"`, `starts`: `number`, `circularSegments`: `number`): [`ThreadProfile`](ThreadProfile-type.md)
 
 
 
@@ -16,7 +16,7 @@ it exactly.
 
 <a id="profile"></a>
 
-**`profile`** · [`ThreadProfile`](ThreadProfile.md) · Required
+**`profile`** · [`ThreadProfile`](ThreadProfile-type.md) · Required
 
 
 
@@ -46,11 +46,11 @@ it exactly.
 
 ## Returns
 
-[`ThreadProfile`](ThreadProfile.md)
+[`ThreadProfile`](ThreadProfile-type.md)
 
 
 ## Related APIs
 
-- [ThreadProfile](ThreadProfile.md)
+- [ThreadProfile](ThreadProfile-type.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 Composes two affine transforms without mutating either matrix.
 
-**composeTransform3**(`after`: [`Transform3`](Transform3.md), `before`: [`Transform3`](Transform3.md)): [`Transform3`](Transform3.md)
+**composeTransform3**(`after`: [`Transform3Matrix`](Transform3Matrix.md), `before`: [`Transform3Matrix`](Transform3Matrix.md)): [`Transform3Matrix`](Transform3Matrix.md)
 
 
 
@@ -12,7 +12,7 @@ Composes two affine transforms without mutating either matrix.
 
 <a id="after"></a>
 
-**`after`** · [`Transform3`](Transform3.md) · Required
+**`after`** · [`Transform3Matrix`](Transform3Matrix.md) · Required
 
 Transform applied second.
 
@@ -20,7 +20,7 @@ Transform applied second.
 
 <a id="before"></a>
 
-**`before`** · [`Transform3`](Transform3.md) · Required
+**`before`** · [`Transform3Matrix`](Transform3Matrix.md) · Required
 
 Transform applied first.
 
@@ -28,13 +28,17 @@ Transform applied first.
 
 ## Returns
 
-[`Transform3`](Transform3.md)
+[`Transform3Matrix`](Transform3Matrix.md)
 
 A new frozen transform equal to `after * before`.
 
 
 ## Related APIs
 
-- [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.15.0`.

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

@@ -2,7 +2,7 @@
 
 Builds rotation-minimizing frames for a non-duplicated closed path.
 
-`const` **computeClosedParallelTransportFrames**: (`path`: readonly [`Vector3`](Vector3.md)[], `initialNormal?`: [`Vector3`](Vector3.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>) => readonly [`PathFrame`](PathFrame.md)[]
+`const` **computeClosedParallelTransportFrames**: (`input`: [`Path3Input`](Path3Input.md), `initialNormal?`: [`Vector3Input`](Vector3Input.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>) => readonly [`PathFrame`](PathFrame.md)[]
 
 
 
@@ -10,18 +10,21 @@ Centered cyclic tangents are parallel-transported around the loop. Transporting
 normal back to the first tangent measures seam holonomy; distributing that residual rotation
 uniformly over all path intervals avoids a visible seam or accumulated frame flip.
 The maxPathPoints ceiling (default 100000) bounds path points and frames.
+Requires closed path values; raw tuples are interpreted as closed and must omit their seam point.
+Invalid paths throw GeometryError.
+Nonfinite initial normals reject; finite parallel preferences select a canonical fallback.
 
 ## Parameters
 
-<a id="path"></a>
+<a id="input"></a>
 
-**`path`** · readonly [`Vector3`](Vector3.md)[] · Required
+**`input`** · [`Path3Input`](Path3Input.md) · Required
 
 
 
 <a id="initialnormal"></a>
 
-**`initialNormal`** · [`Vector3`](Vector3.md) · Optional
+**`initialNormal`** · [`Vector3Input`](Vector3Input.md) · Optional
 
 
 
@@ -39,7 +42,8 @@ readonly [`PathFrame`](PathFrame.md)[]
 ## Related APIs
 
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
+- [Path3Input](Path3Input.md)
 - [PathFrame](PathFrame.md)
-- [Vector3](Vector3.md)
+- [Vector3Input](Vector3Input.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.