@metamesh/modeling 0.12.0 → 0.13.0

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

@@ -0,0 +1,96 @@
+# preflightThreadedNut
+
+Resolves a nut's exact body/cutter chamfer and preflights its extended thread mesh without allocating Manifold WASM objects.
+
+**preflightThreadedNut**(`options`: [`ThreadedNutOptions`](ThreadedNutOptions.md)): [`ThreadedNutPreflight`](ThreadedNutPreflight.md)
+
+
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`ThreadedNutOptions`](ThreadedNutOptions.md) · Required
+
+- [`profile`](ThreadedNutOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+
+  Validated periodic profile repeated around the shaft.
+
+- [`nominalMajorDiameter`](ThreadedNutOptions.md#nominalmajordiameter) · `number` · Required
+
+  Nominal major diameter before female compensation and faceting correction.
+
+- [`shape`](ThreadedNutOptions.md#shape) · [`ThreadedNutShape`](ThreadedNutShape.md) · Required
+
+  Nut body shape.
+
+- [`thickness`](ThreadedNutOptions.md#thickness) · `number` · Required
+
+  Nut thickness along +Z in millimetres.
+
+- [`width`](ThreadedNutOptions.md#width) · `number` · Required
+
+  Across-flats width for hex/square or diameter for round, in millimetres.
+
+- [`ends`](ThreadedNutOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
+
+  Optional bottom/top ridge-end treatments. Standalone ridges honor the requested boundaries;
+  BOSL2-style non-cut lead-in scaling is available on complete thread solids.
+
+- [`handedness`](ThreadedNutOptions.md#handedness) · [`ThreadHandedness`](ThreadHandedness.md) · Optional
+
+  Helix direction. Default: `right`.
+
+- [`limits`](ThreadedNutOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+
+  Explicit output and circular allocation ceilings.
+
+- [`phaseDegrees`](ThreadedNutOptions.md#phasedegrees) · `number` · Optional
+
+  Angular offset of the first start in degrees. Default: `0`.
+
+- [`resolution`](ThreadedNutOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Optional circular-resolution policy.
+
+- [`starts`](ThreadedNutOptions.md#starts) · `number` · Optional
+
+  Number of evenly phased starts. Default: `1`.
+
+- [`tolerance`](ThreadedNutOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+
+  Optional numerical tolerance overrides.
+
+- [`fit`](ThreadedNutOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
+
+  Printable fit or caller-calibrated allowances. Default: `normal`.
+
+- [`bevel`](ThreadedNutOptions.md#bevel) · [`ThreadedNutBevel`](ThreadedNutBevel.md) · Optional
+
+  Nut body bevel selection. Default: `automatic`.
+
+- [`bodyResolution`](ThreadedNutOptions.md#bodyresolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Optional physical policy for a round body, independent of the thread's matched facet grid.
+
+- [`chamferSize`](ThreadedNutOptions.md#chamfersize) · `number` · Optional
+
+  45-degree body chamfer extent. Default: `min(profile.depth, thickness/4)`.
+
+- [`flushBuildPlateBottom`](ThreadedNutOptions.md#flushbuildplatebottom) · `boolean` · Optional
+
+  Leave the bottom outside edge flat for build-plate adhesion. Default: `false`.
+
+
+
+## Returns
+
+[`ThreadedNutPreflight`](ThreadedNutPreflight.md)
+
+
+## Related APIs
+
+- [ThreadedNutOptions](ThreadedNutOptions.md)
+- [ThreadedNutPreflight](ThreadedNutPreflight.md)
+
+Package: `@metamesh/modeling@0.13.0`.

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

@@ -0,0 +1,85 @@
+# preflightThreadedRod
+
+Preflights the exact compensated direct mesh used by the threaded rod constructor.
+
+**preflightThreadedRod**(`options`: [`ThreadedRodOptions`](ThreadedRodOptions.md)): [`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
+
+
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`ThreadedRodOptions`](ThreadedRodOptions.md) · Required
+
+- [`length`](ThreadedRodOptions.md#length) · `number` · Required
+
+  Total threaded axial length in millimetres.
+
+- [`profile`](ThreadedRodOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+
+  Validated periodic profile repeated around the shaft.
+
+- [`nominalMajorDiameter`](ThreadedRodOptions.md#nominalmajordiameter) · `number` · Required
+
+  Nominal major diameter before male compensation.
+
+- [`ends`](ThreadedRodOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
+
+  Optional bottom/top ridge-end treatments. Standalone ridges honor the requested boundaries;
+  BOSL2-style non-cut lead-in scaling is available on complete thread solids.
+
+- [`handedness`](ThreadedRodOptions.md#handedness) · [`ThreadHandedness`](ThreadHandedness.md) · Optional
+
+  Helix direction. Default: `right`.
+
+- [`limits`](ThreadedRodOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+
+  Explicit output and circular allocation ceilings.
+
+- [`phaseDegrees`](ThreadedRodOptions.md#phasedegrees) · `number` · Optional
+
+  Angular offset of the first start in degrees. Default: `0`.
+
+- [`resolution`](ThreadedRodOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Optional circular-resolution policy.
+
+- [`starts`](ThreadedRodOptions.md#starts) · `number` · Optional
+
+  Number of evenly phased starts. Default: `1`.
+
+- [`tolerance`](ThreadedRodOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+
+  Optional numerical tolerance overrides.
+
+- [`bevelBottom`](ThreadedRodOptions.md#bevelbottom) · `boolean` · Optional
+
+  Apply a 45-degree bevel at Z=0.
+
+- [`bevelSize`](ThreadedRodOptions.md#bevelsize) · `number` · Optional
+
+  Axial bevel extent in millimetres. Active blunt ends default to one sixth of the compensated
+  male minor radius or female major radius; other ends default to the profile depth.
+
+- [`bevelTop`](ThreadedRodOptions.md#beveltop) · `boolean` · Optional
+
+  Apply a 45-degree bevel at Z=length.
+
+- [`fit`](ThreadedRodOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
+
+  Printable fit or caller-calibrated allowances. Default: `normal`.
+
+
+
+## Returns
+
+[`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
+
+
+## Related APIs
+
+- [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
+- [ThreadedRodOptions](ThreadedRodOptions.md)
+
+Package: `@metamesh/modeling@0.13.0`.

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

@@ -0,0 +1,32 @@
+# projectOntoPlane3
+
+Removes the component parallel to a normalized plane normal.
+
+`const` **projectOntoPlane3**: (`vector`: [`Vector3`](Vector3.md), `normal`: [`Vector3`](Vector3.md)) => [`Vector3`](Vector3.md)
+
+
+
+## Parameters
+
+<a id="vector"></a>
+
+**`vector`** · [`Vector3`](Vector3.md) · Required
+
+
+
+<a id="normal"></a>
+
+**`normal`** · [`Vector3`](Vector3.md) · Required
+
+
+
+## Returns
+
+[`Vector3`](Vector3.md)
+
+
+## Related APIs
+
+- [Vector3](Vector3.md)
+
+Package: `@metamesh/modeling@0.13.0`.

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

@@ -0,0 +1,47 @@
+# radialPatternTransforms
+
+Rotations about an explicit axis; angles use degrees and the first placement is identity.
+
+**radialPatternTransforms**(`options`: [`RadialPatternOptions`](RadialPatternOptions.md)): readonly [`Transform3`](Transform3.md)[]
+
+
+
+## Parameters
+
+<a id="options"></a>
+
+**`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)[]
+
+
+## Related APIs
+
+- [RadialPatternOptions](RadialPatternOptions.md)
+- [Transform3](Transform3.md)
+
+## Guides
+
+- [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+
+Package: `@metamesh/modeling@0.13.0`.

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

@@ -0,0 +1,49 @@
+# rectangleContour
+
+Creates an immutable CCW rectangle loop. Round radius zero is square; tangent saturated endpoints occur once.
+
+**rectangleContour**(`options`: [`RectangleContourOptions`](RectangleContourOptions.md)): [`Contour`](Contour.md)
+
+
+
+## Example: Rounded rectangle outline
+
+```ts
+rectangleContour({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
+```
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`RectangleContourOptions`](RectangleContourOptions.md) · Required
+
+- [`size`](RectangleContourOptions.md#size) · `number` \| [`Vector2`](Vector2.md) · Required
+
+  Positive uniform size or explicit XY extents in millimetres.
+
+- [`center`](RectangleContourOptions.md#center) · `boolean` · Optional
+
+  Center on XY; otherwise the minimum corner is the origin. Defaults to true.
+
+- [`treatment`](RectangleContourOptions.md#treatment) · [`EdgeTreatment`](EdgeTreatment.md) \| [`RectangleCornerTreatments`](RectangleCornerTreatments.md) · Optional
+
+  Uniform treatment or four corner treatments. Exact round segments describe a complete circle and must divide by four.
+
+- [`limits`](RectangleContourOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Explicit sampling ceiling for the complete output profile.
+
+
+
+## Returns
+
+[`Contour`](Contour.md)
+
+
+## Related APIs
+
+- [Contour](Contour.md)
+- [RectangleContourOptions](RectangleContourOptions.md)
+
+Package: `@metamesh/modeling@0.13.0`.

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

@@ -0,0 +1,53 @@
+# rectangleProfile
+
+Creates an identified rectangle whose edge/corner spans survive zero and saturated round radii. Outer winding is CCW.
+
+**rectangleProfile**(`options`: [`RectangleProfileOptions`](RectangleProfileOptions.md)): [`Profile`](Profile.md)
+
+
+
+## Example: Retain rectangle landmarks
+
+```ts
+rectangleProfile({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
+```
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`RectangleProfileOptions`](RectangleProfileOptions.md) · Required
+
+- [`size`](RectangleProfileOptions.md#size) · `number` \| [`Vector2`](Vector2.md) · Required
+
+  Positive uniform size or explicit XY extents in millimetres.
+
+- [`center`](RectangleProfileOptions.md#center) · `boolean` · Optional
+
+  Center on XY; otherwise the minimum corner is the origin. Defaults to true.
+
+- [`treatment`](RectangleProfileOptions.md#treatment) · [`EdgeTreatment`](EdgeTreatment.md) \| [`RectangleCornerTreatments`](RectangleCornerTreatments.md) · Optional
+
+  Uniform treatment or four corner treatments. Exact round segments describe a complete circle and must divide by four.
+
+- [`limits`](RectangleProfileOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Explicit sampling ceiling for the complete output profile.
+
+- [`id`](RectangleProfileOptions.md#id) · `string` · Optional
+
+  Canonical component identity of at most 64 characters. Defaults to body.
+
+
+
+## Returns
+
+[`Profile`](Profile.md)
+
+
+## Related APIs
+
+- [Profile](Profile.md)
+- [RectangleProfileOptions](RectangleProfileOptions.md)
+
+Package: `@metamesh/modeling@0.13.0`.

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

@@ -0,0 +1,34 @@
+# regionArea
+
+Returns the total filled area of a normalized region in square millimetres.
+
+**regionArea**(`region`: [`Region`](Region.md)): `number`
+
+
+
+Each polygon contributes its outer-loop area minus the areas of its holes. An empty region has
+zero area. Call [normalizeRegion](normalizeRegion.md) first when input winding or topology is not already
+canonical.
+
+## Parameters
+
+<a id="region"></a>
+
+**`region`** · [`Region`](Region.md) · Required
+
+Normalized disjoint polygons with CCW outers and clockwise holes.
+
+
+
+## Returns
+
+`number`
+
+Total filled area in square millimetres.
+
+
+## Related APIs
+
+- [Region](Region.md)
+
+Package: `@metamesh/modeling@0.13.0`.

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

@@ -0,0 +1,27 @@
+# regionBounds
+
+Returns finite axis-aligned bounds for a non-empty region.
+
+**regionBounds**(`region`: [`Region`](Region.md)): [`Bounds2`](Bounds2.md)
+
+
+
+## Parameters
+
+<a id="region"></a>
+
+**`region`** · [`Region`](Region.md) · Required
+
+
+
+## Returns
+
+[`Bounds2`](Bounds2.md)
+
+
+## Related APIs
+
+- [Bounds2](Bounds2.md)
+- [Region](Region.md)
+
+Package: `@metamesh/modeling@0.13.0`.

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

@@ -0,0 +1,53 @@
+# regularPolygonContour
+
+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)[]
+
+
+
+## Example: Hexagon sized to its faces
+
+```ts
+regularPolygonContour({ radius: 10, sides: 6, sizing: "face" });
+```
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`RegularPolygonContourOptions`](RegularPolygonContourOptions.md) · Required
+
+- [`radius`](RegularPolygonContourOptions.md#radius) · `number` · Required
+
+  Positive nominal radius in millimetres, interpreted according to sizing.
+
+- [`sides`](RegularPolygonContourOptions.md#sides) · `number` · Required
+
+  Exact side count from three through the selected profile sampling ceiling.
+
+- [`limits`](RegularPolygonContourOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Explicit sampling ceilings; bound modeling operations may only lower the host policy.
+
+- [`sizing`](RegularPolygonContourOptions.md#sizing) · [`RadialSizing`](RadialSizing.md) · Optional
+
+  Vertex sizing is inscribed; face sizing circumscribes the nominal radius. Defaults to vertex.
+
+- [`rotationDegrees`](RegularPolygonContourOptions.md#rotationdegrees) · `number` · Optional
+
+  Counterclockwise rotation in degrees; defaults to zero with a vertex on +X.
+
+
+
+## Returns
+
+readonly [`Vector2`](Vector2.md)[]
+
+
+## Related APIs
+
+- [RegularPolygonContourOptions](RegularPolygonContourOptions.md)
+- [Vector2](Vector2.md)
+
+Package: `@metamesh/modeling@0.13.0`.

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

@@ -0,0 +1,64 @@
+# resamplePolyline2
+
+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)
+
+
+
+## Example
+
+```ts
+const loop = resamplePolyline2([[0,0],[5,0],[5,5],[0,5]], {closed: true, segments: 20});
+```
+
+## Parameters
+
+<a id="path"></a>
+
+**`path`** · readonly [`Vector2`](Vector2.md)[] · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`PolylineResamplingOptions`](PolylineResamplingOptions.md) · Optional
+
+- [`resolution`](PolylineResamplingOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Millimetre sampling policy; circularSegments applies only to arcs.
+
+- [`maximumVertices`](PolylineResamplingOptions.md#maximumvertices) · `number` · Optional
+
+  Output vertex ceiling of at least two; may only lower limits.maxPathPoints.
+
+- [`limits`](PolylineResamplingOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Explicit sampling ceilings; omitted values use package defaults without ambient state.
+
+- [`segments`](PolylineResamplingOptions.md#segments) · `number` · Optional
+
+  Exact equal arc-length intervals; closed paths require at least three.
+
+- [`closed`](PolylineResamplingOptions.md#closed) · `boolean` · Optional
+
+  Includes the closing edge without repeating the first output point; defaults to false.
+
+
+
+## Returns
+
+[`SampledCurve2`](SampledCurve2.md)
+
+## Remarks
+
+Only final 2D output vectors are copied and frozen. No immutable 3D intermediate is built.
+
+
+## Related APIs
+
+- [PolylineResamplingOptions](PolylineResamplingOptions.md)
+- [SampledCurve2](SampledCurve2.md)
+- [Vector2](Vector2.md)
+
+Package: `@metamesh/modeling@0.13.0`.

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

@@ -0,0 +1,67 @@
+# resamplePolyline3
+
+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)
+
+
+
+## Example
+
+```ts
+const path = resamplePolyline3([[0,0,0],[10,0,0],[10,10,0]], {segments: 8});
+```
+
+## Parameters
+
+<a id="path"></a>
+
+**`path`** · readonly [`Vector3`](Vector3.md)[] · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`PolylineResamplingOptions`](PolylineResamplingOptions.md) · Optional
+
+- [`resolution`](PolylineResamplingOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Millimetre sampling policy; circularSegments applies only to arcs.
+
+- [`maximumVertices`](PolylineResamplingOptions.md#maximumvertices) · `number` · Optional
+
+  Output vertex ceiling of at least two; may only lower limits.maxPathPoints.
+
+- [`limits`](PolylineResamplingOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Explicit sampling ceilings; omitted values use package defaults without ambient state.
+
+- [`segments`](PolylineResamplingOptions.md#segments) · `number` · Optional
+
+  Exact equal arc-length intervals; closed paths require at least three.
+
+- [`closed`](PolylineResamplingOptions.md#closed) · `boolean` · Optional
+
+  Includes the closing edge without repeating the first output point; defaults to false.
+
+
+
+## Returns
+
+[`SampledCurve3`](SampledCurve3.md)
+
+## Remarks
+
+Open paths retain both endpoints; closed paths include the closing edge and omit the
+repeated seam. Repeated adjacent inputs and explicit closing duplicates are removed. Physical
+maxSegmentLength bounds arc-length intervals; exact counts override that policy. Output edges
+may bridge original corners. Sampling never silently lowers the requested detail to fit its budget.
+
+
+## Related APIs
+
+- [PolylineResamplingOptions](PolylineResamplingOptions.md)
+- [SampledCurve3](SampledCurve3.md)
+- [Vector3](Vector3.md)
+
+Package: `@metamesh/modeling@0.13.0`.

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

@@ -0,0 +1,79 @@
+# resolveAlignedCircularSegments
+
+Resolves a deterministic full-circle count aligned to reusable topology factors.
+
+**resolveAlignedCircularSegments**(`radius`: `number`, `options`: [`AlignedCircularSegmentsOptions`](AlignedCircularSegmentsOptions.md)): `number`
+
+
+
+## Example
+
+```ts
+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
+`COMPLEXITY_LIMIT` when the aligned result exceeds the configured safety cap.
+
+## Parameters
+
+<a id="radius"></a>
+
+**`radius`** · `number` · Required
+
+Positive circle radius in millimetres used for adaptive physical sampling.
+
+
+
+<a id="options"></a>
+
+**`options`** · [`AlignedCircularSegmentsOptions`](AlignedCircularSegmentsOptions.md) · Required
+
+Required alignment factors plus optional floor, exact count, and resolution.
+
+- [`alignTo`](AlignedCircularSegmentsOptions.md#alignto) · readonly `number`[] · Required
+
+  Non-empty alignment factors. Every value must be a positive safe integer; the returned count
+  is divisible by their checked least common multiple.
+
+- [`limits`](AlignedCircularSegmentsOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Explicit sampling allocation ceilings.
+
+- [`minimumSegments`](AlignedCircularSegmentsOptions.md#minimumsegments) · `number` · Optional · Default: `3`
+
+  Additional full-circle segment floor, as a safe integer of at least three.
+
+- [`segments`](AlignedCircularSegmentsOptions.md#segments) · `number` · Optional
+
+  Exact full-circle segment count.
+
+  This takes precedence over `resolution.circularSegments` and adaptive sampling, and must
+  already satisfy every alignment factor and `minimumSegments`.
+
+- [`resolution`](AlignedCircularSegmentsOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Operation-level physical tessellation policy over the active model-wide policy.
+
+
+
+## Returns
+
+`number`
+
+An aligned full-circle segment count.
+
+
+## Throws
+
+- GeometryError when radius, alignment factors, segment floors, or resolution are invalid, or alignment exceeds safe integer or configured complexity limits.
+
+## Related APIs
+
+- [AlignedCircularSegmentsOptions](AlignedCircularSegmentsOptions.md)
+- [resolveCircularSegments](resolveCircularSegments.md)
+
+Package: `@metamesh/modeling@0.13.0`.