@metamesh/modeling 0.15.0 → 0.17.0

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

@@ -1,11 +1,19 @@
 # path2
 
-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.
+Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization.
 
 **path2**(`input`: [`Path2Input`](Path2Input.md), `options?`: [`PathOptions`](PathOptions.md)): [`Path2`](Path2-type.md)
 
 
 
+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.
+
+Use `toData()` for a frozen record that restores coordinates, closure, and dimension together.
+
 ## Parameters
 
 <a id="input"></a>
@@ -39,4 +47,8 @@ Snapshots finite XY coordinates as an immutable sampled path, independent of eng
 - [Path2Input](Path2Input.md)
 - [PathOptions](PathOptions.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/path3.md

@@ -6,6 +6,8 @@ Snapshots finite XYZ coordinates as an immutable sampled path with the same clos
 
 
 
+Use `toData()` for a frozen record that restores coordinates, closure, and dimension together.
+
 ## Parameters
 
 <a id="input"></a>
@@ -38,5 +40,10 @@ Snapshots finite XYZ coordinates as an immutable sampled path with the same clos
 - [Path3](Path3-type.md)
 - [Path3Input](Path3Input.md)
 - [PathOptions](PathOptions.md)
+- [path2](path2.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/pathPatternTransforms.md

@@ -1,11 +1,15 @@
 # pathPatternTransforms
 
-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.
+Equal physical arc-length placements along a sampled XYZ path.
 
-**pathPatternTransforms**(`path`: [`Path3Input`](Path3Input.md), `options`: [`PathPatternOptions`](PathPatternOptions.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): readonly [`Transform3Matrix`](Transform3Matrix.md)[]
+**pathPatternTransforms**(`path`: [`Path3Input`](Path3Input.md), `options`: [`PathPatternOptions`](PathPatternOptions.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): readonly [`Transform3Data`](Transform3Data.md)[]
 
 
 
+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.
+
 ## Parameters
 
 <a id="path"></a>
@@ -40,7 +44,7 @@ Equal physical arc-length placements along a sampled XYZ path. Tangent orientati
 
 ## Returns
 
-readonly [`Transform3Matrix`](Transform3Matrix.md)[]
+readonly [`Transform3Data`](Transform3Data.md)[]
 
 
 ## Related APIs
@@ -48,10 +52,10 @@ readonly [`Transform3Matrix`](Transform3Matrix.md)[]
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [Path3Input](Path3Input.md)
 - [PathPatternOptions](PathPatternOptions.md)
-- [Transform3Matrix](Transform3Matrix.md)
+- [Transform3Data](Transform3Data.md)
 
 ## Guides
 
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,11 +1,15 @@
 # preflightHeightfield
 
-Checks grid dimensions, coordinate precision, and allocation bounds before evaluating heights.
+Checks grid options, Float32 axis precision, and output limits; returns exact mesh buffer counts.
 
 **preflightHeightfield**(`options`: [`HeightfieldOptions`](HeightfieldOptions.md), `limits?`: `Partial`\<`Pick`\<[`ModelingLimits`](ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\>): [`HeightfieldPreflight`](HeightfieldPreflight.md)
 
 
 
+This pure operation needs no engine and neither evaluates `height` nor allocates mesh buffers.
+Successful preflight leaves height values, Float32 base storage, and generated mesh validity to
+construction. `byteCount` covers position and index buffers, not total working memory.
+
 ## Parameters
 
 <a id="options"></a>
@@ -30,5 +34,10 @@ Checks grid dimensions, coordinate precision, and allocation bounds before evalu
 - [HeightfieldOptions](HeightfieldOptions.md)
 - [HeightfieldPreflight](HeightfieldPreflight.md)
 - [ModelingLimits](ModelingLimits.md)
+- [heightfieldMesh](heightfieldMesh.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,11 +1,15 @@
 # preflightHelicalThreadSolidMesh
 
-Validates a direct thread solid and returns its conservative allocation estimate without constructing vertex or index buffers.
+Checks thread dimensions, profile, end treatments, sampling, and conservative estimates against output limits.
 
 **preflightHelicalThreadSolidMesh**(`options`: [`HelicalThreadSolidMeshOptions`](HelicalThreadSolidMeshOptions.md)): [`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
 
 
 
+This pure operation needs no engine and constructs planning data without vertex or index buffers.
+`circularSegments` is the selected count; row and triangle counts are conservative estimates.
+Successful preflight leaves generated coordinate and topology checks to mesh construction.
+
 ## Parameters
 
 <a id="options"></a>
@@ -92,5 +96,10 @@ Validates a direct thread solid and returns its conservative allocation estimate
 
 - [HelicalThreadSolidMeshOptions](HelicalThreadSolidMeshOptions.md)
 - [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
+- [helicalThreadSolidMesh](helicalThreadSolidMesh.md)
+
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,11 +1,16 @@
 # preflightInternalThreadCutter
 
-Preflights the exact extended mesh used by the internal thread cutter constructor.
+Resolves compensated cutter dimensions and checks extended mesh estimates against output limits.
 
 **preflightInternalThreadCutter**(`options`: [`InternalThreadCutterOptions`](InternalThreadCutterOptions.md)): [`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
 
 
 
+This pure operation uses explicit resolution and limits or package defaults, without an active
+host execution. It includes the cutter's one-pitch extension beyond each requested face and
+creates planning data without mesh buffers or native objects. Row and triangle counts are
+estimates; mesh validity and native construction are checked later.
+
 ## Parameters
 
 <a id="options"></a>
@@ -81,5 +86,11 @@ Preflights the exact extended mesh used by the internal thread cutter constructo
 
 - [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
 - [InternalThreadCutterOptions](InternalThreadCutterOptions.md)
+- [helicalThreadSolidMesh](helicalThreadSolidMesh.md)
+- [preflightHelicalThreadSolidMesh](preflightHelicalThreadSolidMesh.md)
+
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,11 +1,19 @@
 # preflightSvgRegion
 
-Preflights bounded SVG geometry without browser or Manifold dependencies.
+Parses and validates bounded SVG input, constructing its normalized sampled region and diagnostics.
 
 **preflightSvgRegion**(`svg`: `string`, `options?`: [`SvgImportOptions`](SvgImportOptions.md)): [`SvgRegionPreflight`](SvgRegionPreflight.md)
 
 
 
+This pure operation performs curve flattening, fill and stroke construction, and polygon union;
+it needs no browser or engine. Geometry counts measure the returned region at the selected
+resolution, rather than predicting later mesh allocation. With `fit`, painted bounds are
+uniformly centered inside the target and adaptive sampling remains in final millimetres.
+Refinement runs at most eight bounded import passes; exact circular counts retain precedence.
+Without `fit` the region may be empty. Tiny-island and short-edge indicators do not establish
+manufacturability or later solid validity.
+
 ## Parameters
 
 <a id="svg"></a>
@@ -22,6 +30,12 @@ Complete SVG XML source, limited to 256 KiB of UTF-8.
 
 Physical flattening and viewport-origin controls.
 
+- [`fit`](SvgImportOptions.md#fit) · [`Bounds2Input`](Bounds2Input.md) · Optional
+
+  Uniformly fit painted bounds inside this positioned XY target in millimetres.
+  Adaptive resolution describes the fitted size; exact circular counts retain precedence.
+  Empty painted geometry cannot be fitted. Omitted preserves the document's physical size.
+
 - [`limits`](SvgImportOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
   Explicit profile and circular allocation ceilings; bounded SVG source/work limits remain fixed.
@@ -48,9 +62,17 @@ Physical flattening and viewport-origin controls.
 The canonical normalized region plus bounded source, topology, and safe-repair facts.
 
 
+## Throws
+
+- GeometryError When XML, supported-feature, geometry, or complexity checks fail.
+
 ## Related APIs
 
 - [SvgImportOptions](SvgImportOptions.md)
 - [SvgRegionPreflight](SvgRegionPreflight.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/preflightThreadedNut.md

@@ -1,11 +1,16 @@
 # preflightThreadedNut
 
-Resolves a nut's exact body/cutter chamfer and preflights its extended thread mesh without allocating Manifold WASM objects.
+Checks nut dimensions, chamfers, end-face wall, and the extended compensated cutter's allocation plan.
 
 **preflightThreadedNut**(`options`: [`ThreadedNutOptions`](ThreadedNutOptions.md)): [`ThreadedNutPreflight`](ThreadedNutPreflight.md)
 
 
 
+This pure operation uses explicit resolution and limits or package defaults, without an active
+host execution. It resolves body/cutter dimensions without mesh buffers or native objects.
+`thread` contains conservative cutter estimates, excluding the body and Boolean result.
+Successful preflight leaves mesh validity, native construction, and manufacturing fit to later checks.
+
 ## Parameters
 
 <a id="options"></a>
@@ -92,5 +97,10 @@ Resolves a nut's exact body/cutter chamfer and preflights its extended thread me
 
 - [ThreadedNutOptions](ThreadedNutOptions.md)
 - [ThreadedNutPreflight](ThreadedNutPreflight.md)
+- [preflightHelicalThreadSolidMesh](preflightHelicalThreadSolidMesh.md)
+
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,11 +1,15 @@
 # preflightThreadedRod
 
-Preflights the exact compensated direct mesh used by the threaded rod constructor.
+Resolves compensated rod dimensions and checks conservative mesh estimates against output limits.
 
 **preflightThreadedRod**(`options`: [`ThreadedRodOptions`](ThreadedRodOptions.md)): [`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
 
 
 
+This pure operation uses explicit resolution and limits or package defaults, without an active
+host execution. It creates planning data without mesh buffers or native objects; returned row
+and triangle counts are estimates. Mesh validity and native construction are checked later.
+
 ## Parameters
 
 <a id="options"></a>
@@ -81,5 +85,11 @@ Preflights the exact compensated direct mesh used by the threaded rod constructo
 
 - [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
 - [ThreadedRodOptions](ThreadedRodOptions.md)
+- [helicalThreadSolidMesh](helicalThreadSolidMesh.md)
+- [preflightHelicalThreadSolidMesh](preflightHelicalThreadSolidMesh.md)
+
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -2,7 +2,7 @@
 
 Removes the component parallel to a normalized plane normal.
 
-`const` **projectOntoPlane3**: (`vector`: [`Vector3Tuple`](Vector3Tuple.md), `normal`: [`Vector3Tuple`](Vector3Tuple.md)) => [`Vector3Tuple`](Vector3Tuple.md)
+`const` **projectOntoPlane3**: (`vector`: [`Vector3Data`](Vector3Data.md), `normal`: [`Vector3Data`](Vector3Data.md)) => [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -10,27 +10,28 @@ Removes the component parallel to a normalized plane normal.
 
 <a id="vector"></a>
 
-**`vector`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`vector`** · [`Vector3Data`](Vector3Data.md) · Required
 
 
 
 <a id="normal"></a>
 
-**`normal`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`normal`** · [`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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -2,7 +2,7 @@
 
 Rotations about an explicit axis; angles use degrees and the first placement is identity.
 
-**radialPatternTransforms**(`options`: [`RadialPatternOptions`](RadialPatternOptions.md)): readonly [`Transform3Matrix`](Transform3Matrix.md)[]
+**radialPatternTransforms**(`options`: [`RadialPatternOptions`](RadialPatternOptions.md)): readonly [`Transform3Data`](Transform3Data.md)[]
 
 
 
@@ -16,16 +16,16 @@ Rotations about an explicit axis; angles use degrees and the first placement is
 
 ## Returns
 
-readonly [`Transform3Matrix`](Transform3Matrix.md)[]
+readonly [`Transform3Data`](Transform3Data.md)[]
 
 
 ## Related APIs
 
 - [RadialPatternOptions](RadialPatternOptions.md)
-- [Transform3Matrix](Transform3Matrix.md)
+- [Transform3Data](Transform3Data.md)
 
 ## Guides
 
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,6 +1,6 @@
 # rectangleContour
 
-Creates an immutable CCW rectangle loop. Round radius zero is square; tangent saturated endpoints occur once.
+Creates an immutable sampled CCW rectangle boundary. Round radius zero is square; tangent saturated endpoints occur once.
 
 **rectangleContour**(`options`: [`RectangleContourOptions`](RectangleContourOptions.md)): [`Contour`](Contour.md)
 
@@ -12,13 +12,15 @@ Creates an immutable CCW rectangle loop. Round radius zero is square; tangent sa
 rectangleContour({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 ```
 
+Use [rectangle](../model/rectangle.md) for a filled Section.
+
 ## Parameters
 
 <a id="options"></a>
 
 **`options`** · [`RectangleContourOptions`](RectangleContourOptions.md) · Required
 
-- [`size`](RectangleContourOptions.md#size) · `number` \| [`Vector2Tuple`](Vector2Tuple.md) · Required
+- [`size`](RectangleContourOptions.md#size) · `number` \| [`Vector2Data`](Vector2Data.md) · Required
 
   Positive uniform size or explicit XY extents in millimetres.
 
@@ -45,5 +47,10 @@ rectangleContour({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 
 - [Contour](Contour.md)
 - [RectangleContourOptions](RectangleContourOptions.md)
+- [rectangleProfile](rectangleProfile.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/rectangleProfile.md

@@ -12,13 +12,15 @@ Creates an identified rectangle whose edge/corner spans survive zero and saturat
 rectangleProfile({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 ```
 
+Use [rectangle](../model/rectangle.md) for a filled Section.
+
 ## Parameters
 
 <a id="options"></a>
 
 **`options`** · [`RectangleProfileOptions`](RectangleProfileOptions.md) · Required
 
-- [`size`](RectangleProfileOptions.md#size) · `number` \| [`Vector2Tuple`](Vector2Tuple.md) · Required
+- [`size`](RectangleProfileOptions.md#size) · `number` \| [`Vector2Data`](Vector2Data.md) · Required
 
   Positive uniform size or explicit XY extents in millimetres.
 
@@ -49,5 +51,11 @@ rectangleProfile({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 
 - [Profile](Profile.md)
 - [RectangleProfileOptions](RectangleProfileOptions.md)
+- [matchProfiles](matchProfiles.md)
+- [rectangleContour](rectangleContour.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/regionArea.md

@@ -31,4 +31,8 @@ Total filled area in square millimetres.
 
 - [RegionData](RegionData.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/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.15.0`.
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+
+Package: `@metamesh/modeling@0.17.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)[]
 
 
 
@@ -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.15.0`.
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+
+Package: `@metamesh/modeling@0.17.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
 
 
 
@@ -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.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/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
 
 
 
@@ -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.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/resolveAlignedCircularSegments.md

@@ -80,4 +80,4 @@ An aligned full-circle segment count.
 - [AlignedCircularSegmentsOptions](AlignedCircularSegmentsOptions.md)
 - [resolveCircularSegments](resolveCircularSegments.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -64,4 +64,4 @@ Segment count for the requested arc span.
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [resolveCircularSegments](resolveCircularSegments.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -0,0 +1,40 @@
+# resolveCircularSampling
+
+Resolves circular sampling and its actual radial envelopes without allocating boundary points.
+
+**resolveCircularSampling**(`options`: [`CircleContourOptions`](CircleContourOptions.md)): [`CircularSampling`](CircularSampling.md)
+
+
+
+## Example: Check a nominal 8 mm face-sized bore
+
+```ts
+const bore = resolveCircularSampling({ diameter: 8, segments: 64, sizing: "face" });
+bore.faceRadius; // 4 mm
+bore.vertexRadius; // slightly larger than 4 mm
+```
+
+Vertex sizing retains the nominal vertex radius; face sizing retains the nominal face radius.
+Exact `segments` override resolution, while allocation ceilings still apply. Adaptive sampling
+uses the same count calculation as `resolveCircularSegments` and `circleContour` and rejects
+exhausted limits rather than coarsening. The returned record is immutable and needs no engine.
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`CircleContourOptions`](CircleContourOptions.md) · Required
+
+
+
+## Returns
+
+[`CircularSampling`](CircularSampling.md)
+
+
+## Related APIs
+
+- [CircleContourOptions](CircleContourOptions.md)
+- [CircularSampling](CircularSampling.md)
+
+Package: `@metamesh/modeling@0.17.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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -28,4 +28,8 @@ currently supported.
 - [CylindricalGearDimensions](CylindricalGearDimensions.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/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.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.17.0`.