@metamesh/modeling 0.14.0 → 0.16.0

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

@@ -2,7 +2,7 @@
 
 Returns finite axis-aligned bounds for a non-empty region.
 
-**regionBounds**(`region`: [`RegionData`](RegionData.md)): [`Bounds2`](Bounds2.md)
+**regionBounds**(`region`: [`RegionData`](RegionData.md)): [`Bounds2Data`](Bounds2Data.md)
 
 
 
@@ -16,12 +16,16 @@ Returns finite axis-aligned bounds for a non-empty region.
 
 ## Returns
 
-[`Bounds2`](Bounds2.md)
+[`Bounds2Data`](Bounds2Data.md)
 
 
 ## Related APIs
 
-- [Bounds2](Bounds2.md)
+- [Bounds2Data](Bounds2Data.md)
 - [RegionData](RegionData.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Creates a centered CCW point loop with vertex or face radial sizing and an implicit seam.
 
-`const` **regularPolygonContour**: (`options`: [`RegularPolygonContourOptions`](RegularPolygonContourOptions.md)) => readonly [`Vector2Tuple`](Vector2Tuple.md)[]
+`const` **regularPolygonContour**: (`options`: [`RegularPolygonContourOptions`](RegularPolygonContourOptions.md)) => readonly [`Vector2Data`](Vector2Data.md)[]
 
 
 
@@ -34,7 +34,7 @@ regularPolygonContour({ radius: 10, sides: 6, sizing: "face" });
 
   Vertex sizing is inscribed; face sizing circumscribes the nominal radius. Defaults to vertex.
 
-- [`rotationDegrees`](RegularPolygonContourOptions.md#rotationdegrees) · `number` · Optional
+- [`rotation`](RegularPolygonContourOptions.md#rotation) · `number` · Optional
 
   Counterclockwise rotation in degrees; defaults to zero with a vertex on +X.
 
@@ -42,12 +42,16 @@ regularPolygonContour({ radius: 10, sides: 6, sizing: "face" });
 
 ## Returns
 
-readonly [`Vector2Tuple`](Vector2Tuple.md)[]
+readonly [`Vector2Data`](Vector2Data.md)[]
 
 
 ## Related APIs
 
 - [RegularPolygonContourOptions](RegularPolygonContourOptions.md)
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Resamples a planar polyline with the same point, tangent, seam and budget guarantees as 3D.
 
-**resamplePolyline2**(`path`: readonly [`Vector2Tuple`](Vector2Tuple.md)[], `options?`: [`PolylineResamplingOptions`](PolylineResamplingOptions.md)): [`SampledCurve2`](SampledCurve2.md)
+**resamplePolyline2**(`path`: readonly [`Vector2Data`](Vector2Data.md)[], `options?`: [`PolylineResamplingOptions`](PolylineResamplingOptions.md)): [`SampledCurve2`](SampledCurve2.md)
 
 
 
@@ -16,7 +16,7 @@ const loop = resamplePolyline2([[0,0],[5,0],[5,5],[0,5]], {closed: true, segment
 
 <a id="path"></a>
 
-**`path`** · readonly [`Vector2Tuple`](Vector2Tuple.md)[] · Required
+**`path`** · readonly [`Vector2Data`](Vector2Data.md)[] · Required
 
 
 
@@ -28,7 +28,7 @@ const loop = resamplePolyline2([[0,0],[5,0],[5,5],[0,5]], {closed: true, segment
 
   Millimetre sampling policy; circularSegments applies only to arcs.
 
-- [`maximumVertices`](PolylineResamplingOptions.md#maximumvertices) · `number` · Optional
+- [`maxVertices`](PolylineResamplingOptions.md#maxvertices) · `number` · Optional
 
   Output vertex ceiling of at least two; may only lower limits.maxPathPoints.
 
@@ -59,6 +59,10 @@ Only final 2D output vectors are copied and frozen. No immutable 3D intermediate
 
 - [PolylineResamplingOptions](PolylineResamplingOptions.md)
 - [SampledCurve2](SampledCurve2.md)
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Resamples a spatial polyline at equal arc lengths with directed outgoing tangents.
 
-**resamplePolyline3**(`path`: readonly [`Vector3Tuple`](Vector3Tuple.md)[], `options?`: [`PolylineResamplingOptions`](PolylineResamplingOptions.md)): [`SampledCurve3`](SampledCurve3.md)
+**resamplePolyline3**(`path`: readonly [`Vector3Data`](Vector3Data.md)[], `options?`: [`PolylineResamplingOptions`](PolylineResamplingOptions.md)): [`SampledCurve3`](SampledCurve3.md)
 
 
 
@@ -16,7 +16,7 @@ const path = resamplePolyline3([[0,0,0],[10,0,0],[10,10,0]], {segments: 8});
 
 <a id="path"></a>
 
-**`path`** · readonly [`Vector3Tuple`](Vector3Tuple.md)[] · Required
+**`path`** · readonly [`Vector3Data`](Vector3Data.md)[] · Required
 
 
 
@@ -28,7 +28,7 @@ const path = resamplePolyline3([[0,0,0],[10,0,0],[10,10,0]], {segments: 8});
 
   Millimetre sampling policy; circularSegments applies only to arcs.
 
-- [`maximumVertices`](PolylineResamplingOptions.md#maximumvertices) · `number` · Optional
+- [`maxVertices`](PolylineResamplingOptions.md#maxvertices) · `number` · Optional
 
   Output vertex ceiling of at least two; may only lower limits.maxPathPoints.
 
@@ -62,6 +62,10 @@ may bridge original corners. Sampling never silently lowers the requested detail
 
 - [PolylineResamplingOptions](PolylineResamplingOptions.md)
 - [SampledCurve3](SampledCurve3.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector3Data](Vector3Data.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -15,7 +15,7 @@ const alignedSegments = resolveAlignedCircularSegments(20, { alignTo: [4, 6] });
 `alignTo` must be non-empty and contain only positive safe integers. Its checked least common
 multiple defines the alignment grid. An exact `segments` value wins over
 `resolution.circularSegments` and adaptive sampling, but is never rounded: it must already be
-aligned and meet `minimumSegments`. Adaptive counts are rounded upward and fail with
+aligned and meet `minSegments`. Adaptive counts are rounded upward and fail with
 `COMPLEXITY_LIMIT` when the aligned result exceeds the configured safety cap.
 
 ## Parameters
@@ -47,7 +47,7 @@ Required alignment factors plus optional floor, exact count, and resolution.
 
   Explicit sampling allocation ceilings.
 
-- [`minimumSegments`](AlignedCircularSegmentsOptions.md#minimumsegments) · `number` · Optional · Default: `3`
+- [`minSegments`](AlignedCircularSegmentsOptions.md#minsegments) · `number` · Optional · Default: `3`
 
   Additional full-circle segment floor, as a safe integer of at least three.
 
@@ -56,7 +56,7 @@ Required alignment factors plus optional floor, exact count, and resolution.
   Exact full-circle segment count.
 
   This takes precedence over `resolution.circularSegments` and adaptive sampling, and must
-  already satisfy every alignment factor and `minimumSegments`.
+  already satisfy every alignment factor and `minSegments`.
 
 - [`resolution`](AlignedCircularSegmentsOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
 
@@ -80,4 +80,4 @@ An aligned full-circle segment count.
 - [AlignedCircularSegmentsOptions](AlignedCircularSegmentsOptions.md)
 - [resolveCircularSegments](resolveCircularSegments.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Resolves the number of segments needed for a circular arc.
 
-**resolveArcSegments**(`radius`: `number`, `angleDegrees`: `number`, `policy?`: [`CircularResolutionOptions`](CircularResolutionOptions.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): `number`
+**resolveArcSegments**(`radius`: `number`, `angle`: `number`, `policy?`: [`CircularResolutionOptions`](CircularResolutionOptions.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): `number`
 
 
 
@@ -25,9 +25,9 @@ Arc radius in millimetres.
 
 
 
-<a id="angledegrees"></a>
+<a id="angle"></a>
 
-**`angleDegrees`** · `number` · Required
+**`angle`** · `number` · Required
 
 Non-zero signed sweep angle no greater than 360 degrees in magnitude.
 
@@ -64,4 +64,4 @@ Segment count for the requested arc span.
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [resolveCircularSegments](resolveCircularSegments.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -59,4 +59,4 @@ Full-circle segment count.
 - [resolveAlignedCircularSegments](resolveAlignedCircularSegments.md)
 - [resolveArcSegments](resolveArcSegments.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -28,4 +28,8 @@ currently supported.
 - [CylindricalGearDimensions](CylindricalGearDimensions.md)
 - [CylindricalGearSpec](CylindricalGearSpec.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -28,4 +28,8 @@ the same hand. The function validates those conjugate pitch invariants.
 - [CylindricalGearPairDimensions](CylindricalGearPairDimensions.md)
 - [CylindricalGearPairSpec](CylindricalGearPairSpec.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -48,11 +48,11 @@ Twist, scale, exact divisions, and physical resolution controls.
 
   Operation-level physical policy over the nearest model scope.
 
-- [`scaleTop`](ExtrusionSamplingOptions.md#scaletop) · `number` \| [`Vector2Tuple`](Vector2Tuple.md) · Optional
+- [`scaleTop`](ExtrusionSamplingOptions.md#scaletop) · `number` \| [`Vector2Input`](Vector2Input.md) · Optional
 
   Finite uniform or XY scale of the top profile; defaults to one.
 
-- [`twistDegrees`](ExtrusionSamplingOptions.md#twistdegrees) · `number` · Optional
+- [`twist`](ExtrusionSamplingOptions.md#twist) · `number` · Optional
 
   Finite rotation of the top profile about +Z, in degrees; defaults to zero.
 
@@ -71,4 +71,8 @@ Number of intermediate copies, excluding the two end profiles.
 - [ExtrusionSamplingOptions](ExtrusionSamplingOptions.md)
 - [RegionData](RegionData.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -23,4 +23,8 @@ Resolves finite positive safe-integer allocation ceilings without ambient state.
 
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -56,4 +56,4 @@ A complete tolerance policy including the scale-resolved distance.
 - [GeometryToleranceOptions](GeometryToleranceOptions.md)
 - [ResolvedGeometryTolerance](ResolvedGeometryTolerance.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -0,0 +1,59 @@
+# resolveKnuckleHinge
+
+Resolves equal alternating knuckles along +X, centered at the origin, in millimetres.
+
+**resolveKnuckleHinge**(`spec`: [`KnuckleHingeSpec`](KnuckleHingeSpec.md), `options?`: [`KnuckleHingeSamplingOptions`](KnuckleHingeSamplingOptions.md)): [`KnuckleHingeDimensions`](KnuckleHingeDimensions.md)
+
+
+
+Both faces of each running pair use a common polygon count; face-sized bores contain the
+shaft's complete rotational envelope. Adaptive sampling satisfies both face and vertex error
+bounds; an insufficient ceiling rejects instead of reducing quality. Exact counts are intentional
+facets. Zero allowances describe ideal contact, not a printable running fit.
+
+Rejects nonfinite or nonpositive dimensions, invalid mode/count combinations, exhausted axial
+length, missing/excessive lift-off engagement, and nonpositive conservative faceted barrel walls.
+Manufacturing minima, strength, mounting, retention, handedness, and motion remain caller policy.
+
+## Parameters
+
+<a id="spec"></a>
+
+**`spec`** · [`KnuckleHingeSpec`](KnuckleHingeSpec.md) · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`KnuckleHingeSamplingOptions`](KnuckleHingeSamplingOptions.md) · Optional
+
+- [`segments`](KnuckleHingeSamplingOptions.md#segments) · `number` · Optional
+
+  Exact full-circle count, divisible by four and at least four; overrides adaptive sampling.
+
+- [`resolution`](KnuckleHingeSamplingOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Physical tessellation policy. Exact circular counts must also be divisible by four.
+
+- [`limits`](KnuckleHingeSamplingOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Explicit allocation ceilings; defaults to the pure geometry sampling limits.
+
+
+
+## Returns
+
+[`KnuckleHingeDimensions`](KnuckleHingeDimensions.md)
+
+
+## Related APIs
+
+- [KnuckleHingeDimensions](KnuckleHingeDimensions.md)
+- [KnuckleHingeSamplingOptions](KnuckleHingeSamplingOptions.md)
+- [KnuckleHingeSpec](KnuckleHingeSpec.md)
+
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -24,4 +24,8 @@ Resolves and validates a named or caller-defined print-fit policy.
 - [PrintableThreadFit](PrintableThreadFit.md)
 - [PrintableThreadFitPolicy](PrintableThreadFitPolicy.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -24,4 +24,8 @@ Resolves a rack segment that is conjugate with the same normal cylindrical pitch
 - [RackPitchDimensions](RackPitchDimensions.md)
 - [RackPitchSpec](RackPitchSpec.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -7,7 +7,7 @@ Resolves a role-independent, start-aligned facet count from the larger female ma
 
 
 An exact `circularSegments` value must already be divisible by `starts`; it is never silently
-raised. Adaptive policies align upward and fail if that would exceed `maximumSegments`.
+raised. Adaptive policies align upward and fail if that would exceed `maxSegments`.
 
 ## Parameters
 
@@ -19,7 +19,7 @@ raised. Adaptive policies align upward and fail if that would exceed `maximumSeg
 
   Nominal major diameter before role-specific compensation.
 
-- [`profile`](ThreadCircularSegmentsOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+- [`profile`](ThreadCircularSegmentsOptions.md#profile) · [`ThreadProfile`](ThreadProfile-type.md) · Required
 
   Validated mating profile whose pitch and flank capacities govern tessellation.
 
@@ -31,7 +31,7 @@ raised. Adaptive policies align upward and fail if that would exceed `maximumSeg
 
   Printable fit whose larger compensated female envelope governs tessellation.
 
-- [`maximumRadialOutset`](ThreadCircularSegmentsOptions.md#maximumradialoutset) · `number` · Optional
+- [`maxRadialOutset`](ThreadCircularSegmentsOptions.md#maxradialoutset) · `number` · Optional
 
   Maximum active female face outset beyond the compensated major envelope, in millimetres.
   This keeps a compensated male/female pair on one role-independent grid when an internal
@@ -56,4 +56,8 @@ raised. Adaptive policies align upward and fail if that would exceed `maximumSeg
 
 - [ThreadCircularSegmentsOptions](ThreadCircularSegmentsOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -27,4 +27,8 @@ Fresh position and index buffers; the input remains unchanged.
 
 - [TriangleMesh](TriangleMesh.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Revolves a non-duplicated closed `[radius, z]` profile around +Z.
 
-`const` **revolveMesh**: (`profile`: readonly [`Vector2Tuple`](Vector2Tuple.md)[], `options?`: [`RevolveOptions`](RevolveOptions.md)) => [`TriangleMesh`](TriangleMesh.md)
+`const` **revolveMesh**: (`input`: [`Path2Input`](Path2Input.md), `options?`: [`RevolveOptions`](RevolveOptions.md)) => [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -12,21 +12,20 @@ axis is emitted once and joined as a triangle fan, avoiding coincident seam
 vertices and zero-area quads. Profile edges that lie entirely on the axis
 collapse to the solid's interior and are intentionally omitted.
 Profile coordinates must fit finite Float32 mesh storage.
+Path2 profiles must be closed; raw point collections have an implicit closing edge.
 
 ## Example: Partial revolution with end caps
 
 ```ts
 // Each point is [radius, Z]; the profile seam is implicit.
-revolveMesh([[0, 0], [12, 0], [8, 20], [0, 20]], { revolveDegrees: 270 });
+revolveMesh([[0, 0], [12, 0], [8, 20], [0, 20]], { degrees: 270 });
 ```
 
 ## Parameters
 
-<a id="profile"></a>
+<a id="input"></a>
 
-**`profile`** · readonly [`Vector2Tuple`](Vector2Tuple.md)[] · Required
-
-Closed CCW `[radius, z]` profile without a duplicated seam point.
+**`input`** · [`Path2Input`](Path2Input.md) · Required
 
 
 
@@ -47,9 +46,10 @@ Optional physical or exact circumferential sampling controls. Defaults to `{}`.
 
   Operation-level physical tessellation policy over the active model-wide policy.
 
-- [`revolveDegrees`](RevolveOptions.md#revolvedegrees) · `number` · Optional
+- [`degrees`](RevolveOptions.md#degrees) · `number` · Optional · Default: `360`
 
-  Positive angular sweep no greater than 360 degrees; partial revolutions have end caps.
+  Positive sweep in degrees, no greater than 360. Defaults to a full revolution;
+  smaller sweeps form partial revolutions with end caps.
   Segment counts describe a complete circle and scale to this angular span. Native filled
   revolutions require at least three sweep intervals: adaptive sampling refines to that floor,
   while exact counts that imply fewer intervals reject. Pure revolveMesh supports one interval.
@@ -69,8 +69,12 @@ A closed indexed triangle mesh revolved counter-clockwise around +Z.
 
 ## Related APIs
 
+- [Path2Input](Path2Input.md)
 - [RevolveOptions](RevolveOptions.md)
 - [TriangleMesh](TriangleMesh.md)
-- [Vector2Tuple](Vector2Tuple.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Rotates a finite vector counter-clockwise in XY by `degrees` about the origin. Throws `NON_FINITE_VALUE` for nonfinite coordinates, angles, or derived coordinates.
 
-`const` **rotate2**: (`vector`: [`Vector2Tuple`](Vector2Tuple.md), `degrees`: `number`) => [`Vector2Tuple`](Vector2Tuple.md)
+`const` **rotate2**: (`vector`: [`Vector2Data`](Vector2Data.md), `degrees`: `number`) => [`Vector2Data`](Vector2Data.md)
 
 
 
@@ -10,7 +10,7 @@ Rotates a finite vector counter-clockwise in XY by `degrees` about the origin. T
 
 <a id="vector"></a>
 
-**`vector`** · [`Vector2Tuple`](Vector2Tuple.md) · Required
+**`vector`** · [`Vector2Data`](Vector2Data.md) · Required
 
 
 
@@ -22,15 +22,16 @@ Rotates a finite vector counter-clockwise in XY by `degrees` about the origin. T
 
 ## Returns
 
-[`Vector2Tuple`](Vector2Tuple.md)
+[`Vector2Data`](Vector2Data.md)
 
 
 ## Related APIs
 
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Creates a right-handed axis-angle rotation transform.
 
-**rotationTransform3**(`axis`: [`Vector3Tuple`](Vector3Tuple.md), `angle`: [`AxisAngleRotation3`](AxisAngleRotation3.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Transform3Matrix`](Transform3Matrix.md)
+**rotationTransform3**(`axis`: [`Vector3Data`](Vector3Data.md), `angle`: [`AxisAngleRotation3`](AxisAngleRotation3.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Transform3Data`](Transform3Data.md)
 
 
 
@@ -10,7 +10,7 @@ Creates a right-handed axis-angle rotation transform.
 
 <a id="axis"></a>
 
-**`axis`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`axis`** · [`Vector3Data`](Vector3Data.md) · Required
 
 Rotation axis; normalization is performed internally.
 
@@ -34,7 +34,7 @@ Optional zero-length comparison overrides.
 
 ## Returns
 
-[`Transform3Matrix`](Transform3Matrix.md)
+[`Transform3Data`](Transform3Data.md)
 
 A frozen row-major transform.
 
@@ -43,11 +43,12 @@ A frozen row-major transform.
 
 - [AxisAngleRotation3](AxisAngleRotation3.md)
 - [GeometryToleranceOptions](GeometryToleranceOptions.md)
-- [Transform3Matrix](Transform3Matrix.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Transform3Data](Transform3Data.md)
+- [Vector3Data](Vector3Data.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Replaces each vertex of a non-duplicated closed polyline with a sampled quadratic corner in the same coordinate system as the input.
 
-`const` **roundClosedPolylinePath**: (`points`: readonly [`Vector3Tuple`](Vector3Tuple.md)[], `radius`: `number`, `segmentsPerCorner`: `number`, `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>) => readonly [`Vector3Tuple`](Vector3Tuple.md)[]
+`const` **roundClosedPolylinePath**: (`input`: [`Path3Input`](Path3Input.md), `radius`: `number`, `segmentsPerCorner`: `number`, `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>) => readonly [`Vector3Data`](Vector3Data.md)[]
 
 
 
@@ -10,12 +10,13 @@ Replaces each vertex of a non-duplicated closed polyline with a sampled quadrati
 45% of adjacent segment lengths to prevent neighboring corners from crossing.
 The returned path does not duplicate its closing point.
 Coordinates and radius must be finite; input and output are each limited by maxPathPoints (default 100000).
+Requires a closed path value; raw tuples are interpreted as closed. Invalid inputs throw GeometryError.
 
 ## Parameters
 
-<a id="points"></a>
+<a id="input"></a>
 
-**`points`** · readonly [`Vector3Tuple`](Vector3Tuple.md)[] · Required
+**`input`** · [`Path3Input`](Path3Input.md) · Required
 
 
 
@@ -39,12 +40,17 @@ Coordinates and radius must be finite; input and output are each limited by maxP
 
 ## Returns
 
-readonly [`Vector3Tuple`](Vector3Tuple.md)[]
+readonly [`Vector3Data`](Vector3Data.md)[]
 
 
 ## Related APIs
 
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Path3Input](Path3Input.md)
+- [Vector3Data](Vector3Data.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,6 +1,6 @@
 # sampleContour
 
-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.
+Samples 2–32 connected line/cubic segments into a simple, nonzero-area, immutable CCW XY loop.
 
 **sampleContour**(`curve`: [`ContourCurve`](ContourCurve.md), `options?`: [`SampleContourOptions`](SampleContourOptions.md)): [`Contour`](Contour.md)
 
@@ -19,6 +19,12 @@ const section = sampleContour({
 }, { widthScale: 20, heightScale: 12 });
 ```
 
+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.
+
 ## Parameters
 
 <a id="curve"></a>
@@ -33,7 +39,7 @@ Closed contour in millimetres unless positive scales convert its coordinates.
 
 **`options`** · [`SampleContourOptions`](SampleContourOptions.md) · Optional
 
-Physical resolution and unique vertex budget; defaults to 4096 vertices.
+Physical resolution and unique vertex budget; defaults to min(4096, maxProfilePoints).
 
 - [`widthScale`](SampleContourOptions.md#widthscale) · `number` · Optional
 
@@ -47,7 +53,7 @@ Physical resolution and unique vertex budget; defaults to 4096 vertices.
 
   Physical policy evaluated after scaling, using the shared curve sampler.
 
-- [`maximumVertices`](SampleContourOptions.md#maximumvertices) · `number` · Optional
+- [`maxVertices`](SampleContourOptions.md#maxvertices) · `number` · Optional
 
   Unique output vertex ceiling, at least three, within maxProfilePoints. Defaults to min(4096, maxProfilePoints).
 
@@ -74,4 +80,8 @@ Frozen counterclockwise loop in millimetres, without a repeated seam endpoint.
 - [ContourCurve](ContourCurve.md)
 - [SampleContourOptions](SampleContourOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+
+Package: `@metamesh/modeling@0.16.0`.