@metamesh/modeling 0.14.0 → 0.16.0

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

@@ -9,7 +9,7 @@ Samples a planar curve with the same guarantees and policy as spatial sampling.
 ## Example
 
 ```ts
-const turn = sampleCurve2({kind: "arc", center: [0,0], radius: 10, sweepDegrees: 90});
+const turn = sampleCurve2({kind: "arc", center: [0,0], radius: 10, sweepAngle: 90});
 ```
 
 ## Parameters
@@ -32,7 +32,7 @@ const turn = sampleCurve2({kind: "arc", center: [0,0], radius: 10, sweepDegrees:
 
   Millimetre sampling policy; circularSegments applies only to arcs.
 
-- [`maximumVertices`](CurveSamplingOptions.md#maximumvertices) · `number` · Optional
+- [`maxVertices`](CurveSamplingOptions.md#maxvertices) · `number` · Optional
 
   Output vertex ceiling of at least two; may only lower limits.maxPathPoints.
 
@@ -48,8 +48,7 @@ const turn = sampleCurve2({kind: "arc", center: [0,0], radius: 10, sweepDegrees:
 
 ## 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.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/sampleCurve3.md

@@ -32,7 +32,7 @@ const path = sampleCurve3({kind: "cubic", start: [0,0,0], control1: [5,0,0], con
 
   Millimetre sampling policy; circularSegments applies only to arcs.
 
-- [`maximumVertices`](CurveSamplingOptions.md#maximumvertices) · `number` · Optional
+- [`maxVertices`](CurveSamplingOptions.md#maxvertices) · `number` · Optional
 
   Output vertex ceiling of at least two; may only lower limits.maxPathPoints.
 
@@ -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.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/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.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/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.
+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.14.0`.
+Package: `@metamesh/modeling@0.16.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.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/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)\>): [`Path2`](Path2.md)
+**sampleRackToothPath**(`spec`: [`RackPitchSpec`](RackPitchSpec.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): readonly [`Vector2Data`](Vector2Data.md)[]
 
 
 
@@ -27,13 +27,17 @@ the owning generator.
 
 ## Returns
 
-[`Path2`](Path2.md)
+readonly [`Vector2Data`](Vector2Data.md)[]
 
 
 ## Related APIs
 
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
-- [Path2](Path2.md)
 - [RackPitchSpec](RackPitchSpec.md)
+- [Vector2Data](Vector2Data.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/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>
@@ -29,7 +35,7 @@ Open outline in millimetres unless the positive scales convert its coordinates.
 
 **`options`** · [`SampleSideProfileOptions`](SampleSideProfileOptions.md) · Optional
 
-Physical resolution and output budget; defaults to 4096 vertices.
+Physical resolution and output budget; defaults to min(4096, maxProfilePoints).
 
 - [`radiusScale`](SampleSideProfileOptions.md#radiusscale) · `number` · Optional
 
@@ -43,7 +49,7 @@ Physical resolution and output budget; defaults to 4096 vertices.
 
   Shared physical policy, evaluated after scaling; exact circular counts do not affect curves.
 
-- [`maximumVertices`](SampleSideProfileOptions.md#maximumvertices) · `number` · Optional
+- [`maxVertices`](SampleSideProfileOptions.md#maxvertices) · `number` · Optional
 
   Maximum output vertex count within maxProfilePoints. Defaults to the smaller of 4096 and that ceiling.
 
@@ -55,7 +61,7 @@ Physical resolution and output budget; defaults to 4096 vertices.
 
 ## 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.14.0`.
+Package: `@metamesh/modeling@0.16.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.14.0`.
+## Guides
+
+- [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -32,7 +32,7 @@ Samples evenly phased thread helices with finite `lead = pitch * starts`. All st
 
   Explicit aggregate path allocation ceilings across all starts.
 
-- [`phaseDegrees`](ThreadHelixOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](ThreadHelixOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -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.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/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.14.0`.
+Package: `@metamesh/modeling@0.16.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.14.0`.
+Package: `@metamesh/modeling@0.16.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.14.0`.
+Package: `@metamesh/modeling@0.16.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.14.0`.
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+
+Package: `@metamesh/modeling@0.16.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.14.0`.
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -0,0 +1,67 @@
+# strokeRegionData
+
+Converts a sampled millimetre path into the filled region covered by a centered stroke.
+
+**strokeRegionData**(`path`: [`Path2Input`](Path2Input.md), `options`: [`StrokeOptions`](StrokeOptions.md)): [`RegionData`](RegionData.md)
+
+
+
+Closed paths omit a duplicated seam point. Zero-length sampled segments are ignored, while the
+effective path must still contain visible length. Round caps and joins use deterministic physical
+resolution. Bevels fill the outer corner triangle; miters extend the outer edges to their
+intersection, falling back to bevels above SVG's default miter limit of 4.
+
+## Parameters
+
+<a id="path"></a>
+
+**`path`** · [`Path2Input`](Path2Input.md) · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`StrokeOptions`](StrokeOptions.md) · Required
+
+- [`width`](StrokeOptions.md#width) · `number` · Required
+
+  Positive total stroke width in millimetres, centered on the sampled path.
+
+- [`limits`](StrokeOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Explicit path, circular and expanded-profile allocation ceilings.
+
+- [`closed`](StrokeOptions.md#closed) · `boolean` · Optional
+
+  Raw point closure defaults to false; a Path2 supplies its closure and rejects conflicts.
+
+- [`cap`](StrokeOptions.md#cap) · [`StrokeCap`](StrokeCap.md) · Optional
+
+  End-cap treatment for an open path. Ignored for closed paths. Default: `butt`.
+
+- [`join`](StrokeOptions.md#join) · [`StrokeJoin`](StrokeJoin.md) · Optional
+
+  Corner treatment; miters exceeding SVG's default limit of 4 become bevels. Default: `miter`.
+
+- [`resolution`](StrokeOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Physical tessellation policy for round caps and joins.
+
+
+
+## Returns
+
+[`RegionData`](RegionData.md)
+
+
+## Related APIs
+
+- [Path2Input](Path2Input.md)
+- [RegionData](RegionData.md)
+- [StrokeOptions](StrokeOptions.md)
+
+## Guides
+
+- [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Subtracts `b` from `a` component-wise.
 
-`const` **subtract2**: (`a`: [`Vector2Tuple`](Vector2Tuple.md), `b`: [`Vector2Tuple`](Vector2Tuple.md)) => [`Vector2Tuple`](Vector2Tuple.md)
+`const` **subtract2**: (`a`: [`Vector2Data`](Vector2Data.md), `b`: [`Vector2Data`](Vector2Data.md)) => [`Vector2Data`](Vector2Data.md)
 
 
 
@@ -10,27 +10,28 @@ Subtracts `b` from `a` component-wise.
 
 <a id="a"></a>
 
-**`a`** · [`Vector2Tuple`](Vector2Tuple.md) · Required
+**`a`** · [`Vector2Data`](Vector2Data.md) · Required
 
 
 
 <a id="b"></a>
 
-**`b`** · [`Vector2Tuple`](Vector2Tuple.md) · Required
+**`b`** · [`Vector2Data`](Vector2Data.md) · Required
 
 
 
 ## 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/subtract3.md

@@ -2,7 +2,7 @@
 
 Subtracts `b` from `a`.
 
-`const` **subtract3**: (`a`: [`Vector3Tuple`](Vector3Tuple.md), `b`: [`Vector3Tuple`](Vector3Tuple.md)) => [`Vector3Tuple`](Vector3Tuple.md)
+`const` **subtract3**: (`a`: [`Vector3Data`](Vector3Data.md), `b`: [`Vector3Data`](Vector3Data.md)) => [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -16,27 +16,28 @@ subtract3([4, 5, 6], [1, 2, 3]); // [3, 3, 3]
 
 <a id="a"></a>
 
-**`a`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`a`** · [`Vector3Data`](Vector3Data.md) · Required
 
 
 
 <a id="b"></a>
 
-**`b`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`b`** · [`Vector3Data`](Vector3Data.md) · Required
 
 
 
 ## 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.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Sweeps one explicitly ordered point loop, with caps or a geometrically matching closed seam.
 
-**sweepMesh**(`profile`: [`Contour`](Contour.md), `path`: readonly [`Vector3Tuple`](Vector3Tuple.md)[], `options?`: [`SweepOptions`](SweepOptions.md)): [`TriangleMesh`](TriangleMesh.md)
+**sweepMesh**(`profile`: [`Path2Input`](Path2Input.md), `path`: [`Path3Input`](Path3Input.md), `options?`: [`SweepOptions`](SweepOptions.md)): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -19,13 +19,13 @@ sweepMesh(profile, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
 <a id="profile"></a>
 
-**`profile`** · [`Contour`](Contour.md) · Required
+**`profile`** · [`Path2Input`](Path2Input.md) · Required
 
 
 
 <a id="path"></a>
 
-**`path`** · readonly [`Vector3Tuple`](Vector3Tuple.md)[] · Required
+**`path`** · [`Path3Input`](Path3Input.md) · Required
 
 
 
@@ -35,7 +35,7 @@ sweepMesh(profile, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
 - [`closed`](SweepOptions.md#closed) · `boolean` · Optional
 
-  Join the path's last station to its first. Open paths retain watertight end caps.
+  Raw point closure defaults to false; a Path3 supplies its closure and rejects conflicts.
 
 - [`limits`](SweepOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
 
@@ -49,7 +49,7 @@ sweepMesh(profile, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
   Physical sampling of nonzero twist; inserted stations retain authored station controls.
 
-- [`twistDegrees`](SweepOptions.md#twistdegrees) · `number` · Optional
+- [`twist`](SweepOptions.md#twist) · `number` · Optional
 
   Total additional profile rotation in degrees, with progression selected by twistBy.
 
@@ -57,7 +57,7 @@ sweepMesh(profile, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
   Twist advances by physical path length (default), or normalized authored station position, including a closed seam gap.
 
-- [`scale`](SweepOptions.md#scale) · `number` \| [`Vector2Tuple`](Vector2Tuple.md) \| readonly [`Vector2Tuple`](Vector2Tuple.md)[] · Optional
+- [`scale`](SweepOptions.md#scale) · `number` \| [`Vector2Input`](Vector2Input.md) \| readonly [`Vector2Input`](Vector2Input.md)[] · Optional
 
   Positive uniform/XY scale, or one XY pair per path station. Defaults to one.
 
@@ -74,9 +74,13 @@ sweepMesh(profile, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
 ## Related APIs
 
-- [Contour](Contour.md)
+- [Path2Input](Path2Input.md)
+- [Path3Input](Path3Input.md)
 - [SweepOptions](SweepOptions.md)
 - [TriangleMesh](TriangleMesh.md)
-- [Vector3Tuple](Vector3Tuple.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/{createThreadProfile.md → threadProfile.md}

@@ -1,15 +1,15 @@
-# createThreadProfile
+# threadProfile
 
 Creates a periodic thread profile for the shaft-locked helical mesher.
 
-**createThreadProfile**(`spec`: [`ThreadProfileSpec`](ThreadProfileSpec.md)): [`ThreadProfile`](ThreadProfile.md)
+**threadProfile**(`spec`: [`ThreadProfileSpec`](ThreadProfileSpec.md)): [`ThreadProfile`](ThreadProfile-type.md)
 
 
 
 ## Example: Printable triangular thread profile
 
 ```ts
-createThreadProfile({ kind: "triangular", pitch: 1.75 });
+threadProfile({ kind: "triangular", pitch: 1.75 });
 ```
 
 The open path spans one pitch. Radial zero is the major envelope; negative
@@ -26,12 +26,16 @@ non-decreasing, periodic at their endpoints, and reach radial zero.
 
 ## Returns
 
-[`ThreadProfile`](ThreadProfile.md)
+[`ThreadProfile`](ThreadProfile-type.md)
 
 
 ## Related APIs
 
-- [ThreadProfile](ThreadProfile.md)
+- [ThreadProfile](ThreadProfile-type.md)
 - [ThreadProfileSpec](ThreadProfileSpec.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`.