@metamesh/modeling 0.13.0 → 0.15.0

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

@@ -0,0 +1,42 @@
+# 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.
+
+**path2**(`input`: [`Path2Input`](Path2Input.md), `options?`: [`PathOptions`](PathOptions.md)): [`Path2`](Path2-type.md)
+
+
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Path2Input`](Path2Input.md) · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`PathOptions`](PathOptions.md) · Optional
+
+- [`closed`](PathOptions.md#closed) · `boolean` · Optional
+
+  Connects the last vertex to the first; closed paths omit the repeated seam. Defaults to false.
+
+- [`limits`](PathOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Construction point ceiling; defaults to package sampling limits. Later sampling has its own options.
+
+
+
+## Returns
+
+[`Path2`](Path2-type.md)
+
+
+## Related APIs
+
+- [Path2](Path2-type.md)
+- [Path2Input](Path2Input.md)
+- [PathOptions](PathOptions.md)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -0,0 +1,42 @@
+# path3
+
+Snapshots finite XYZ coordinates as an immutable sampled path with the same closure, seam, allocation and error rules as path2. Analytic curves must be sampled explicitly first.
+
+**path3**(`input`: [`Path3Input`](Path3Input.md), `options?`: [`PathOptions`](PathOptions.md)): [`Path3`](Path3-type.md)
+
+
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Path3Input`](Path3Input.md) · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`PathOptions`](PathOptions.md) · Optional
+
+- [`closed`](PathOptions.md#closed) · `boolean` · Optional
+
+  Connects the last vertex to the first; closed paths omit the repeated seam. Defaults to false.
+
+- [`limits`](PathOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Construction point ceiling; defaults to package sampling limits. Later sampling has its own options.
+
+
+
+## Returns
+
+[`Path3`](Path3-type.md)
+
+
+## Related APIs
+
+- [Path3](Path3-type.md)
+- [Path3Input](Path3Input.md)
+- [PathOptions](PathOptions.md)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 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.
 
-**pathPatternTransforms**(`path`: readonly [`Vector3`](Vector3.md)[], `options`: [`PathPatternOptions`](PathPatternOptions.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): readonly [`Transform3`](Transform3.md)[]
+**pathPatternTransforms**(`path`: [`Path3Input`](Path3Input.md), `options`: [`PathPatternOptions`](PathPatternOptions.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): readonly [`Transform3Matrix`](Transform3Matrix.md)[]
 
 
 
@@ -10,7 +10,7 @@ Equal physical arc-length placements along a sampled XYZ path. Tangent orientati
 
 <a id="path"></a>
 
-**`path`** · readonly [`Vector3`](Vector3.md)[] · Required
+**`path`** · [`Path3Input`](Path3Input.md) · Required
 
 
 
@@ -24,11 +24,11 @@ Equal physical arc-length placements along a sampled XYZ path. Tangent orientati
 
 - [`closed`](PathPatternOptions.md#closed) · `boolean` · Optional
 
-  Include the closing edge without duplicating the seam; defaults to false.
+  Raw point closure defaults to false; a path value supplies closure and rejects conflicts.
 
 - [`orientation`](PathPatternOptions.md#orientation) · `"fixed"` \| `"tangent"` · Optional
 
-  Preserve the source orientation, or align its +Z to the path tangent; defaults to fixed.
+  Preserve orientation, or align local +X for Sections / +Z for Solids to the tangent. Defaults to fixed.
 
 
 
@@ -40,18 +40,18 @@ Equal physical arc-length placements along a sampled XYZ path. Tangent orientati
 
 ## Returns
 
-readonly [`Transform3`](Transform3.md)[]
+readonly [`Transform3Matrix`](Transform3Matrix.md)[]
 
 
 ## Related APIs
 
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
+- [Path3Input](Path3Input.md)
 - [PathPatternOptions](PathPatternOptions.md)
-- [Transform3](Transform3.md)
-- [Vector3](Vector3.md)
+- [Transform3Matrix](Transform3Matrix.md)
 
 ## Guides
 
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -31,4 +31,4 @@ Checks grid dimensions, coordinate precision, and allocation bounds before evalu
 - [HeightfieldPreflight](HeightfieldPreflight.md)
 - [ModelingLimits](ModelingLimits.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -20,7 +20,7 @@ Validates a direct thread solid and returns its conservative allocation estimate
 
   Nominal major diameter before any caller-owned fit compensation.
 
-- [`profile`](HelicalThreadSolidMeshOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+- [`profile`](HelicalThreadSolidMeshOptions.md#profile) · [`ThreadProfile`](ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
@@ -37,7 +37,7 @@ Validates a direct thread solid and returns its conservative allocation estimate
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](HelicalThreadSolidMeshOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](HelicalThreadSolidMeshOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -93,4 +93,4 @@ Validates a direct thread solid and returns its conservative allocation estimate
 - [HelicalThreadSolidMeshOptions](HelicalThreadSolidMeshOptions.md)
 - [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -16,7 +16,7 @@ Preflights the exact extended mesh used by the internal thread cutter constructo
 
   Total threaded axial length in millimetres.
 
-- [`profile`](InternalThreadCutterOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+- [`profile`](InternalThreadCutterOptions.md#profile) · [`ThreadProfile`](ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
@@ -37,7 +37,7 @@ Preflights the exact extended mesh used by the internal thread cutter constructo
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](InternalThreadCutterOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](InternalThreadCutterOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -82,4 +82,4 @@ Preflights the exact extended mesh used by the internal thread cutter constructo
 - [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
 - [InternalThreadCutterOptions](InternalThreadCutterOptions.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -53,4 +53,4 @@ The canonical normalized region plus bounded source, topology, and safe-repair f
 - [SvgImportOptions](SvgImportOptions.md)
 - [SvgRegionPreflight](SvgRegionPreflight.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -12,7 +12,7 @@ Resolves a nut's exact body/cutter chamfer and preflights its extended thread me
 
 **`options`** · [`ThreadedNutOptions`](ThreadedNutOptions.md) · Required
 
-- [`profile`](ThreadedNutOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+- [`profile`](ThreadedNutOptions.md#profile) · [`ThreadProfile`](ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
@@ -45,7 +45,7 @@ Resolves a nut's exact body/cutter chamfer and preflights its extended thread me
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](ThreadedNutOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](ThreadedNutOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -93,4 +93,4 @@ Resolves a nut's exact body/cutter chamfer and preflights its extended thread me
 - [ThreadedNutOptions](ThreadedNutOptions.md)
 - [ThreadedNutPreflight](ThreadedNutPreflight.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -16,7 +16,7 @@ Preflights the exact compensated direct mesh used by the threaded rod constructo
 
   Total threaded axial length in millimetres.
 
-- [`profile`](ThreadedRodOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+- [`profile`](ThreadedRodOptions.md#profile) · [`ThreadProfile`](ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
@@ -37,7 +37,7 @@ Preflights the exact compensated direct mesh used by the threaded rod constructo
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](ThreadedRodOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](ThreadedRodOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -82,4 +82,4 @@ Preflights the exact compensated direct mesh used by the threaded rod constructo
 - [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
 - [ThreadedRodOptions](ThreadedRodOptions.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 Removes the component parallel to a normalized plane normal.
 
-`const` **projectOntoPlane3**: (`vector`: [`Vector3`](Vector3.md), `normal`: [`Vector3`](Vector3.md)) => [`Vector3`](Vector3.md)
+`const` **projectOntoPlane3**: (`vector`: [`Vector3Tuple`](Vector3Tuple.md), `normal`: [`Vector3Tuple`](Vector3Tuple.md)) => [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -10,23 +10,27 @@ Removes the component parallel to a normalized plane normal.
 
 <a id="vector"></a>
 
-**`vector`** · [`Vector3`](Vector3.md) · Required
+**`vector`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
 
 
 
 <a id="normal"></a>
 
-**`normal`** · [`Vector3`](Vector3.md) · Required
+**`normal`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
 
 
 
 ## Returns
 
-[`Vector3`](Vector3.md)
+[`Vector3Tuple`](Vector3Tuple.md)
 
 
 ## Related APIs
 
-- [Vector3](Vector3.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/geometry/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 [`Transform3`](Transform3.md)[]
+**radialPatternTransforms**(`options`: [`RadialPatternOptions`](RadialPatternOptions.md)): readonly [`Transform3Matrix`](Transform3Matrix.md)[]
 
 
 
@@ -12,36 +12,20 @@ Rotations about an explicit axis; angles use degrees and the first placement is
 
 **`options`** · [`RadialPatternOptions`](RadialPatternOptions.md) · Required
 
-- [`count`](RadialPatternOptions.md#count) · `number` · Required
-
-  Number of solids to return, including the original.
-
-- [`axis`](RadialPatternOptions.md#axis) · [`Vector3`](Vector3.md) · Required
-
-  Axis of the right-handed rotation. Its magnitude is ignored.
-
-- [`angleDegrees`](RadialPatternOptions.md#angledegrees) · `number` · Required
-
-  Signed rotation from one copy to the next, in degrees.
-
-- [`center`](RadialPatternOptions.md#center) · [`Vector3`](Vector3.md) · Optional
-
-  Rotation center in world coordinates. Defaults to the origin.
-
 
 
 ## Returns
 
-readonly [`Transform3`](Transform3.md)[]
+readonly [`Transform3Matrix`](Transform3Matrix.md)[]
 
 
 ## Related APIs
 
 - [RadialPatternOptions](RadialPatternOptions.md)
-- [Transform3](Transform3.md)
+- [Transform3Matrix](Transform3Matrix.md)
 
 ## Guides
 
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -18,7 +18,7 @@ rectangleContour({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 
 **`options`** · [`RectangleContourOptions`](RectangleContourOptions.md) · Required
 
-- [`size`](RectangleContourOptions.md#size) · `number` \| [`Vector2`](Vector2.md) · Required
+- [`size`](RectangleContourOptions.md#size) · `number` \| [`Vector2Tuple`](Vector2Tuple.md) · Required
 
   Positive uniform size or explicit XY extents in millimetres.
 
@@ -46,4 +46,4 @@ rectangleContour({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 - [Contour](Contour.md)
 - [RectangleContourOptions](RectangleContourOptions.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -18,7 +18,7 @@ rectangleProfile({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 
 **`options`** · [`RectangleProfileOptions`](RectangleProfileOptions.md) · Required
 
-- [`size`](RectangleProfileOptions.md#size) · `number` \| [`Vector2`](Vector2.md) · Required
+- [`size`](RectangleProfileOptions.md#size) · `number` \| [`Vector2Tuple`](Vector2Tuple.md) · Required
 
   Positive uniform size or explicit XY extents in millimetres.
 
@@ -50,4 +50,4 @@ rectangleProfile({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 - [Profile](Profile.md)
 - [RectangleProfileOptions](RectangleProfileOptions.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 Returns the total filled area of a normalized region in square millimetres.
 
-**regionArea**(`region`: [`Region`](Region.md)): `number`
+**regionArea**(`region`: [`RegionData`](RegionData.md)): `number`
 
 
 
@@ -14,7 +14,7 @@ canonical.
 
 <a id="region"></a>
 
-**`region`** · [`Region`](Region.md) · Required
+**`region`** · [`RegionData`](RegionData.md) · Required
 
 Normalized disjoint polygons with CCW outers and clockwise holes.
 
@@ -29,6 +29,6 @@ Total filled area in square millimetres.
 
 ## Related APIs
 
-- [Region](Region.md)
+- [RegionData](RegionData.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 Returns finite axis-aligned bounds for a non-empty region.
 
-**regionBounds**(`region`: [`Region`](Region.md)): [`Bounds2`](Bounds2.md)
+**regionBounds**(`region`: [`RegionData`](RegionData.md)): [`Bounds2`](Bounds2.md)
 
 
 
@@ -10,7 +10,7 @@ Returns finite axis-aligned bounds for a non-empty region.
 
 <a id="region"></a>
 
-**`region`** · [`Region`](Region.md) · Required
+**`region`** · [`RegionData`](RegionData.md) · Required
 
 
 
@@ -22,6 +22,6 @@ Returns finite axis-aligned bounds for a non-empty region.
 ## Related APIs
 
 - [Bounds2](Bounds2.md)
-- [Region](Region.md)
+- [RegionData](RegionData.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.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 [`Vector2`](Vector2.md)[]
+`const` **regularPolygonContour**: (`options`: [`RegularPolygonContourOptions`](RegularPolygonContourOptions.md)) => readonly [`Vector2Tuple`](Vector2Tuple.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,12 @@ regularPolygonContour({ radius: 10, sides: 6, sizing: "face" });
 
 ## Returns
 
-readonly [`Vector2`](Vector2.md)[]
+readonly [`Vector2Tuple`](Vector2Tuple.md)[]
 
 
 ## Related APIs
 
 - [RegularPolygonContourOptions](RegularPolygonContourOptions.md)
-- [Vector2](Vector2.md)
+- [Vector2Tuple](Vector2Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.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 [`Vector2`](Vector2.md)[], `options?`: [`PolylineResamplingOptions`](PolylineResamplingOptions.md)): [`SampledCurve2`](SampledCurve2.md)
+**resamplePolyline2**(`path`: readonly [`Vector2Tuple`](Vector2Tuple.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 [`Vector2`](Vector2.md)[] · Required
+**`path`** · readonly [`Vector2Tuple`](Vector2Tuple.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,6 @@ Only final 2D output vectors are copied and frozen. No immutable 3D intermediate
 
 - [PolylineResamplingOptions](PolylineResamplingOptions.md)
 - [SampledCurve2](SampledCurve2.md)
-- [Vector2](Vector2.md)
+- [Vector2Tuple](Vector2Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.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 [`Vector3`](Vector3.md)[], `options?`: [`PolylineResamplingOptions`](PolylineResamplingOptions.md)): [`SampledCurve3`](SampledCurve3.md)
+**resamplePolyline3**(`path`: readonly [`Vector3Tuple`](Vector3Tuple.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 [`Vector3`](Vector3.md)[] · Required
+**`path`** · readonly [`Vector3Tuple`](Vector3Tuple.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,6 @@ may bridge original corners. Sampling never silently lowers the requested detail
 
 - [PolylineResamplingOptions](PolylineResamplingOptions.md)
 - [SampledCurve3](SampledCurve3.md)
-- [Vector3](Vector3.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.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
@@ -39,11 +39,15 @@ Required alignment factors plus optional floor, exact count, and resolution.
   Non-empty alignment factors. Every value must be a positive safe integer; the returned count
   is divisible by their checked least common multiple.
 
+- [`sizing`](AlignedCircularSegmentsOptions.md#sizing) · [`RadialSizing`](RadialSizing.md) · Optional
+
+  Radial sizing used by adaptive error and edge-length checks. Defaults to vertex.
+
 - [`limits`](AlignedCircularSegmentsOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
   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.
 
@@ -52,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
 
@@ -76,4 +80,4 @@ An aligned full-circle segment count.
 - [AlignedCircularSegmentsOptions](AlignedCircularSegmentsOptions.md)
 - [resolveCircularSegments](resolveCircularSegments.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.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?`: [`GeometryResolution`](GeometryResolution.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.
 
@@ -35,7 +35,7 @@ Non-zero signed sweep angle no greater than 360 degrees in magnitude.
 
 <a id="policy"></a>
 
-**`policy`** · [`GeometryResolution`](GeometryResolution.md) · Optional
+**`policy`** · [`CircularResolutionOptions`](CircularResolutionOptions.md) · Optional
 
 Optional operation-level policy over the active model scope.
 
@@ -60,8 +60,8 @@ Segment count for the requested arc span.
 
 ## Related APIs
 
-- [GeometryResolution](GeometryResolution.md)
+- [CircularResolutionOptions](CircularResolutionOptions.md)
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [resolveCircularSegments](resolveCircularSegments.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 Resolves a deterministic full-circle segment count for one radius.
 
-**resolveCircularSegments**(`radius`: `number`, `policy?`: [`GeometryResolution`](GeometryResolution.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): `number`
+**resolveCircularSegments**(`radius`: `number`, `policy?`: [`CircularResolutionOptions`](CircularResolutionOptions.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): `number`
 
 
 
@@ -13,7 +13,8 @@ const circleSegments = resolveCircularSegments(25, { maxChordError: 0.05 });
 ```
 
 An exact `circularSegments` value wins. Otherwise the smallest regular polygon satisfying both
-physical error criteria is used. A safety cap that would violate either criterion raises
+physical error criteria is used. Face sizing bounds the circumscribed polygon's outward
+excess and actual edge length. A safety cap that would violate either criterion raises
 `COMPLEXITY_LIMIT` rather than silently reducing quality.
 
 ## Parameters
@@ -28,7 +29,7 @@ Circle radius in millimetres.
 
 <a id="policy"></a>
 
-**`policy`** · [`GeometryResolution`](GeometryResolution.md) · Optional
+**`policy`** · [`CircularResolutionOptions`](CircularResolutionOptions.md) · Optional
 
 Optional operation-level policy under explicit sampling ceilings.
 
@@ -53,9 +54,9 @@ Full-circle segment count.
 
 ## Related APIs
 
-- [GeometryResolution](GeometryResolution.md)
+- [CircularResolutionOptions](CircularResolutionOptions.md)
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [resolveAlignedCircularSegments](resolveAlignedCircularSegments.md)
 - [resolveArcSegments](resolveArcSegments.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.