@metamesh/modeling 0.15.0 → 0.17.0

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

@@ -71,4 +71,8 @@ Number of intermediate copies, excluding the two end profiles.
 - [ExtrusionSamplingOptions](ExtrusionSamplingOptions.md)
 - [RegionData](RegionData.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.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.15.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.17.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.15.0`.
+Package: `@metamesh/modeling@0.17.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.17.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.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.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.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -56,4 +56,8 @@ raised. Adaptive policies align upward and fail if that would exceed `maxSegment
 
 - [ThreadCircularSegmentsOptions](ThreadCircularSegmentsOptions.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.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.15.0`.
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -73,4 +73,8 @@ A closed indexed triangle mesh revolved counter-clockwise around +Z.
 - [RevolveOptions](RevolveOptions.md)
 - [TriangleMesh](TriangleMesh.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.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.15.0`.
+Package: `@metamesh/modeling@0.17.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.15.0`.
+Package: `@metamesh/modeling@0.17.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**: (`input`: [`Path3Input`](Path3Input.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)[]
 
 
 
@@ -40,13 +40,17 @@ Requires a closed path value; raw tuples are interpreted as closed. Invalid inpu
 
 ## Returns
 
-readonly [`Vector3Tuple`](Vector3Tuple.md)[]
+readonly [`Vector3Data`](Vector3Data.md)[]
 
 
 ## Related APIs
 
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [Path3Input](Path3Input.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector3Data](Vector3Data.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.17.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>
@@ -74,4 +80,8 @@ Frozen counterclockwise loop in millimetres, without a repeated seam endpoint.
 - [ContourCurve](ContourCurve.md)
 - [SampleContourOptions](SampleContourOptions.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -48,8 +48,7 @@ const turn = sampleCurve2({kind: "arc", center: [0,0], radius: 10, sweepAngle: 9
 
 ## Remarks
 
-Private spatial scratch math is shared, while only final planar vectors are copied and
-frozen. At stationary tangents, outgoing secants are preferred and endpoints use a backward fallback.
+Returned planar points and tangents are copied and frozen. At stationary tangents, outgoing secants are preferred and endpoints use a backward fallback.
 
 
 ## Related APIs
@@ -58,4 +57,8 @@ frozen. At stationary tangents, outgoing secants are preferred and endpoints use
 - [CurveSamplingOptions](CurveSamplingOptions.md)
 - [SampledCurve2](SampledCurve2.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -58,4 +58,8 @@ bound the full control hull. Full-circle arcs repeat their endpoint; closed poly
 - [CurveSamplingOptions](CurveSamplingOptions.md)
 - [SampledCurve3](SampledCurve3.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -55,4 +55,8 @@ seam point, and contains no holes. Its center is the origin and its axis is
 - [CylindricalGearOutlineOptions](CylindricalGearOutlineOptions.md)
 - [CylindricalGearSpec](CylindricalGearSpec.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,6 +1,6 @@
 # sampleHelix
 
-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.
+Creates `segments + 1` points including exact helix endpoints from finite positive dimensions.
 
 `const` **sampleHelix**: (`{
   turns,
@@ -9,10 +9,14 @@ Creates `segments + 1` points including exact helix endpoints from finite positi
   segments,
   limits,
   axialWeight,
-}`: [`SampleHelixOptions`](SampleHelixOptions.md)) => readonly [`Vector3Tuple`](Vector3Tuple.md)[]
+}`: [`SampleHelixOptions`](SampleHelixOptions.md)) => readonly [`Vector3Data`](Vector3Data.md)[]
 
 
 
+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.
+
 ## Parameters
 
 
@@ -30,12 +34,16 @@ Creates `segments + 1` points including exact helix endpoints from finite positi
 
 ## Returns
 
-readonly [`Vector3Tuple`](Vector3Tuple.md)[]
+readonly [`Vector3Data`](Vector3Data.md)[]
 
 
 ## Related APIs
 
 - [SampleHelixOptions](SampleHelixOptions.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector3Data](Vector3Data.md)
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -56,4 +56,8 @@ when used as a region hole.
 - [CylindricalGearOutlineOptions](CylindricalGearOutlineOptions.md)
 - [CylindricalGearSpec](CylindricalGearSpec.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -2,7 +2,7 @@
 
 Samples the open top boundary of a finite rack in its XY pitch plane.
 
-**sampleRackToothPath**(`spec`: [`RackPitchSpec`](RackPitchSpec.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): [`Path2Data`](Path2Data.md)
+**sampleRackToothPath**(`spec`: [`RackPitchSpec`](RackPitchSpec.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): readonly [`Vector2Data`](Vector2Data.md)[]
 
 
 
@@ -27,13 +27,17 @@ the owning generator.
 
 ## Returns
 
-[`Path2Data`](Path2Data.md)
+readonly [`Vector2Data`](Vector2Data.md)[]
 
 
 ## Related APIs
 
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
-- [Path2Data](Path2Data.md)
 - [RackPitchSpec](RackPitchSpec.md)
+- [Vector2Data](Vector2Data.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,8 +1,8 @@
 # sampleSideProfile
 
-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.
+Samples 1–31 line/cubic segments into a deeply immutable open [radius,height] polyline.
 
-**sampleSideProfile**(`curve`: [`SideProfileCurve`](SideProfileCurve.md), `options?`: [`SampleSideProfileOptions`](SampleSideProfileOptions.md)): readonly [`Vector2Tuple`](Vector2Tuple.md)[]
+**sampleSideProfile**(`curve`: [`SideProfileCurve`](SideProfileCurve.md), `options?`: [`SampleSideProfileOptions`](SampleSideProfileOptions.md)): readonly [`Vector2Data`](Vector2Data.md)[]
 
 
 
@@ -15,6 +15,12 @@ const side = sampleSideProfile({
 }, { radiusScale: 12, heightScale: 30 });
 ```
 
+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.
+
 ## Parameters
 
 <a id="curve"></a>
@@ -55,7 +61,7 @@ Physical resolution and output budget; defaults to min(4096, maxProfilePoints).
 
 ## Returns
 
-readonly [`Vector2Tuple`](Vector2Tuple.md)[]
+readonly [`Vector2Data`](Vector2Data.md)[]
 
 Frozen open polyline in millimetres, ordered from lowest to highest anchor.
 
@@ -68,6 +74,10 @@ Frozen open polyline in millimetres, ordered from lowest to highest anchor.
 
 - [SampleSideProfileOptions](SampleSideProfileOptions.md)
 - [SideProfileCurve](SideProfileCurve.md)
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.md)
+
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -50,4 +50,8 @@ Frozen contours with original glyph winding and no repeated closing vertex.
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [VectorTextLayout](VectorTextLayout.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -60,4 +60,8 @@ Samples evenly phased thread helices with finite `lead = pitch * starts`. All st
 - [SampledThreadHelices](SampledThreadHelices.md)
 - [ThreadHelixOptions](ThreadHelixOptions.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -2,7 +2,7 @@
 
 Multiplies a vector by a dimensionless scalar.
 
-`const` **scale2**: (`vector`: [`Vector2Tuple`](Vector2Tuple.md), `scale`: `number`) => [`Vector2Tuple`](Vector2Tuple.md)
+`const` **scale2**: (`vector`: [`Vector2Data`](Vector2Data.md), `scale`: `number`) => [`Vector2Data`](Vector2Data.md)
 
 
 
@@ -10,7 +10,7 @@ Multiplies a vector by a dimensionless scalar.
 
 <a id="vector"></a>
 
-**`vector`** · [`Vector2Tuple`](Vector2Tuple.md) · Required
+**`vector`** · [`Vector2Data`](Vector2Data.md) · Required
 
 
 
@@ -22,15 +22,16 @@ Multiplies a vector by a dimensionless scalar.
 
 ## 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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -2,7 +2,7 @@
 
 Multiplies a vector by a dimensionless scalar.
 
-`const` **scale3**: (`vector`: [`Vector3Tuple`](Vector3Tuple.md), `scale`: `number`) => [`Vector3Tuple`](Vector3Tuple.md)
+`const` **scale3**: (`vector`: [`Vector3Data`](Vector3Data.md), `scale`: `number`) => [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -16,7 +16,7 @@ scale3([1, 2, 3], 2); // [2, 4, 6]
 
 <a id="vector"></a>
 
-**`vector`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`vector`** · [`Vector3Data`](Vector3Data.md) · Required
 
 
 
@@ -28,15 +28,16 @@ scale3([1, 2, 3], 2); // [2, 4, 6]
 
 ## Returns
 
-[`Vector3Tuple`](Vector3Tuple.md)
+[`Vector3Data`](Vector3Data.md)
 
 
 ## Related APIs
 
-- [Vector3Tuple](Vector3Tuple.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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -2,7 +2,7 @@
 
 Creates an immutable axis-aligned scale transform.
 
-**scaleTransform3**(`factors`: [`Vector3Tuple`](Vector3Tuple.md)): [`Transform3Matrix`](Transform3Matrix.md)
+**scaleTransform3**(`factors`: [`Vector3Data`](Vector3Data.md)): [`Transform3Data`](Transform3Data.md)
 
 
 
@@ -13,7 +13,7 @@ they collapse volume and cannot be inverted.
 
 <a id="factors"></a>
 
-**`factors`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`factors`** · [`Vector3Data`](Vector3Data.md) · Required
 
 Finite, non-zero XYZ scale factors.
 
@@ -21,18 +21,19 @@ Finite, non-zero XYZ scale factors.
 
 ## Returns
 
-[`Transform3Matrix`](Transform3Matrix.md)
+[`Transform3Data`](Transform3Data.md)
 
 A frozen row-major transform.
 
 
 ## Related APIs
 
-- [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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -23,4 +23,8 @@ Returns the signed area of a non-duplicated loop; positive means CCW.
 
 - [Contour](Contour.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -2,7 +2,7 @@
 
 Creates a centered CCW alternating-radius star within the selected profile sampling ceiling.
 
-`const` **starContour**: (`outerRadius`: `number`, `points`: `number`, `innerRadius?`: `number`, `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>) => readonly [`Vector2Tuple`](Vector2Tuple.md)[]
+`const` **starContour**: (`outerRadius`: `number`, `points`: `number`, `innerRadius?`: `number`, `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>) => readonly [`Vector2Data`](Vector2Data.md)[]
 
 
 
@@ -40,12 +40,16 @@ starContour(12, 5, 6);
 
 ## Returns
 
-readonly [`Vector2Tuple`](Vector2Tuple.md)[]
+readonly [`Vector2Data`](Vector2Data.md)[]
 
 
 ## Related APIs
 
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -60,4 +60,8 @@ intersection, falling back to bevels above SVG's default miter limit of 4.
 - [RegionData](RegionData.md)
 - [StrokeOptions](StrokeOptions.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.0`.