@metamesh/modeling 0.16.0 → 0.18.0

package/dist/docs/reference/model/loft.md

@@ -1,6 +1,6 @@
 # loft
 
-Lofts primitive Sections at z heights or frames; arbitrary Sections and loops require an explicit correspondence method.
+Lofts Sections and point loops at z heights or frames. Known primitive landmarks are retained; other profiles default to direct correspondence, preserving their supplied seams.
 
 ## Call Signature
 
@@ -23,7 +23,8 @@ loft([
 
 
 
-Lofts primitive Sections at z heights or frames; arbitrary Sections and loops require an explicit correspondence method.
+Lofts Sections and point loops at z heights or frames. Known primitive landmarks are retained;
+other profiles default to direct correspondence, preserving their supplied seams.
 
 ### Parameters
 
@@ -39,7 +40,7 @@ Lofts primitive Sections at z heights or frames; arbitrary Sections and loops re
 
 - [`correspondence`](LoftOptions.md#correspondence) · [`LoftCorrespondence`](LoftCorrespondence.md) \| readonly [`LoftCorrespondence`](LoftCorrespondence.md)[] · Optional
 
-  One method or one per consecutive station gap. Omitted preserves known landmarks, including circle/ellipse-to-rectangle corners, or maps other unlike primitive seams directly.
+  One method or one per consecutive station gap. Omitted preserves known primitive landmarks, including circle/ellipse-to-rectangle corners, and otherwise uses direct correspondence with the supplied seams.
 
 - [`distribution`](LoftOptions.md#distribution) · `"perimeter"` \| `"segments"` · Optional
 
@@ -91,7 +92,7 @@ Lofts explicit corresponding contours, including holes and collapsed logical slo
 
 - [`correspondence`](LoftOptions.md#correspondence) · [`LoftCorrespondence`](LoftCorrespondence.md) \| readonly [`LoftCorrespondence`](LoftCorrespondence.md)[] · Optional
 
-  One method or one per consecutive station gap. Omitted preserves known landmarks, including circle/ellipse-to-rectangle corners, or maps other unlike primitive seams directly.
+  One method or one per consecutive station gap. Omitted preserves known primitive landmarks, including circle/ellipse-to-rectangle corners, and otherwise uses direct correspondence with the supplied seams.
 
 - [`distribution`](LoftOptions.md#distribution) · `"perimeter"` \| `"segments"` · Optional
 
@@ -134,4 +135,4 @@ Lofts explicit corresponding contours, including holes and collapsed logical slo
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/matchProfiles.md

@@ -39,4 +39,4 @@ readonly [`CorrespondingProfile`](CorrespondingProfile.md)[]
 - [MatchProfilesOptions](MatchProfilesOptions.md)
 - [Profile](Profile.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/minkowskiSum.md

@@ -34,4 +34,4 @@ Three-dimensional Minkowski sum.
 - [Choose the Boolean by the material you want](../../guides/fundamentals.md#choose-the-boolean-by-the-material-you-want)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -51,4 +51,4 @@ Use `toData()` for a frozen record that restores coordinates, closure, and dimen
 
 - [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -46,4 +46,4 @@ Use `toData()` for a frozen record that restores coordinates, closure, and dimen
 
 - [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/pathPattern.md

@@ -117,4 +117,4 @@ readonly [`Section`](Section.md)[]
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 - [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/polygon.md

@@ -40,4 +40,4 @@ Explicit topology must be simple and disjoint; compound winding may resolve over
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -2,7 +2,7 @@
 
 Checks compensated cutter dimensions and conservative mesh estimates against host output limits.
 
-**preflightInternalThreadCutter**(`options`: [`InternalThreadCutterOptions`](InternalThreadCutterOptions.md)): [`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
+**preflightInternalThreadCutter**(`options`: [`InternalThreadCutterOptions`](InternalThreadCutterOptions.md)): [`ThreadSolidPreflight`](ThreadSolidPreflight.md)
 
 
 
@@ -16,6 +16,10 @@ Mesh validity, native construction, and aggregate output limits are checked late
 
 **`options`** · [`InternalThreadCutterOptions`](InternalThreadCutterOptions.md) · Required
 
+- [`nominalMajorDiameter`](InternalThreadCutterOptions.md#nominalmajordiameter) · `number` · Required
+
+  Nominal major diameter before female compensation and faceting correction.
+
 - [`length`](InternalThreadCutterOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
@@ -24,9 +28,14 @@ Mesh validity, native construction, and aggregate output limits are checked late
 
   Validated periodic profile repeated around the shaft.
 
-- [`nominalMajorDiameter`](InternalThreadCutterOptions.md#nominalmajordiameter) · `number` · Required
+- [`fit`](InternalThreadCutterOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
 
-  Nominal major diameter before female compensation and faceting correction.
+  Printable fit or caller-calibrated allowances. Default: `normal`.
+
+- [`bevel`](InternalThreadCutterOptions.md#bevel) · [`Bevel`](Bevel.md) · Optional
+
+  Bottom/top sizes in millimetres. Omitted disables both. Auto uses profile depth for standard/tapered ends,
+  or one sixth of the compensated male minor/female major radius for blunt ends.
 
 - [`ends`](InternalThreadCutterOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
 
@@ -57,34 +66,17 @@ Mesh validity, native construction, and aggregate output limits are checked late
 
   Optional numerical tolerance overrides.
 
-- [`fit`](InternalThreadCutterOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
-
-  Printable fit or caller-calibrated allowances. Default: `normal`.
-
-- [`bevelBottom`](InternalThreadCutterOptions.md#bevelbottom) · `boolean` · Optional
-
-  Apply a 45-degree bevel at Z=0.
-
-- [`bevelSize`](InternalThreadCutterOptions.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`](InternalThreadCutterOptions.md#beveltop) · `boolean` · Optional
-
-  Apply a 45-degree bevel at Z=length.
-
 
 
 ## Returns
 
-[`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
+[`ThreadSolidPreflight`](ThreadSolidPreflight.md)
 
 
 ## Related APIs
 
-- [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
 - [InternalThreadCutterOptions](InternalThreadCutterOptions.md)
+- [ThreadSolidPreflight](ThreadSolidPreflight.md)
 - [internalThreadCutter](internalThreadCutter.md)
 
 ## Guides
@@ -92,4 +84,4 @@ Mesh validity, native construction, and aggregate output limits are checked late
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 - [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -16,10 +16,6 @@ Boolean result. Mesh validity, native construction, and aggregate output limits
 
 **`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.
@@ -36,6 +32,27 @@ Boolean result. Mesh validity, native construction, and aggregate output limits
 
   Across-flats width for hex/square or diameter for round, in millimetres.
 
+- [`profile`](ThreadedNutOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+
+  Validated periodic profile repeated around the shaft.
+
+- [`fit`](ThreadedNutOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
+
+  Printable fit or caller-calibrated allowances. Default: `normal`.
+
+- [`innerBevel`](ThreadedNutOptions.md#innerbevel) · [`Bevel`](Bevel.md) · Optional
+
+  Opening bevels in [bottom, top] order. Omitted or auto uses min(profile.depth, thickness/4); zero disables.
+
+- [`outerBevel`](ThreadedNutOptions.md#outerbevel) · [`Bevel`](Bevel.md) · Optional
+
+  Body bevels in [bottom, top] order. Omitted or auto uses min(profile.depth, thickness/4).
+  Use [0, "auto"] to keep the outside bottom flat without disabling its inner opening bevel.
+
+- [`bodyResolution`](ThreadedNutOptions.md#bodyresolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Optional physical policy for a round body, independent of the thread's matched facet grid.
+
 - [`ends`](ThreadedNutOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
 
   Optional bottom/top ridge-end treatments. Standalone ridges honor the requested boundaries;
@@ -65,26 +82,6 @@ Boolean result. Mesh validity, native construction, and aggregate output limits
 
   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
@@ -103,4 +100,4 @@ Boolean result. Mesh validity, native construction, and aggregate output limits
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 - [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -2,7 +2,7 @@
 
 Checks compensated rod dimensions and conservative mesh estimates against host output limits.
 
-**preflightThreadedRod**(`options`: [`ThreadedRodOptions`](ThreadedRodOptions.md)): [`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
+**preflightThreadedRod**(`options`: [`ThreadedRodOptions`](ThreadedRodOptions.md)): [`ThreadSolidPreflight`](ThreadSolidPreflight.md)
 
 
 
@@ -16,6 +16,10 @@ Mesh validity, native construction, and aggregate output limits are checked late
 
 **`options`** · [`ThreadedRodOptions`](ThreadedRodOptions.md) · Required
 
+- [`nominalMajorDiameter`](ThreadedRodOptions.md#nominalmajordiameter) · `number` · Required
+
+  Nominal major diameter before male compensation.
+
 - [`length`](ThreadedRodOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
@@ -24,9 +28,14 @@ Mesh validity, native construction, and aggregate output limits are checked late
 
   Validated periodic profile repeated around the shaft.
 
-- [`nominalMajorDiameter`](ThreadedRodOptions.md#nominalmajordiameter) · `number` · Required
+- [`bevel`](ThreadedRodOptions.md#bevel) · [`Bevel`](Bevel.md) · Optional
 
-  Nominal major diameter before male compensation.
+  Bottom/top sizes in millimetres. Omitted disables both. Auto uses profile depth for standard/tapered ends,
+  or one sixth of the compensated male minor/female major radius for blunt ends.
+
+- [`fit`](ThreadedRodOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
+
+  Printable fit or caller-calibrated allowances. Default: `normal`.
 
 - [`ends`](ThreadedRodOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
 
@@ -57,34 +66,17 @@ Mesh validity, native construction, and aggregate output limits are checked late
 
   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)
+[`ThreadSolidPreflight`](ThreadSolidPreflight.md)
 
 
 ## Related APIs
 
-- [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
 - [ThreadedRodOptions](ThreadedRodOptions.md)
+- [ThreadSolidPreflight](ThreadSolidPreflight.md)
 - [threadedRod](threadedRod.md)
 
 ## Guides
@@ -92,4 +84,4 @@ Mesh validity, native construction, and aggregate output limits are checked late
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 - [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/radialPattern.md

@@ -79,4 +79,4 @@ readonly [`Section`](Section.md)[]
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 - [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/rectangle.md

@@ -21,7 +21,7 @@ or [rectangleProfile](../geometry/rectangleProfile.md) to retain identified loft
 
 **`options`** · [`RectangleOptions`](RectangleOptions.md) · Required
 
-- [`size`](RectangleOptions.md#size) · `number` \| [`Vector2Data`](Vector2Data.md) · Required
+- [`size`](RectangleOptions.md#size) · `number` \| [`Vector2Input`](Vector2Input.md) · Required
 
   Positive uniform size or explicit XY extents in millimetres.
 
@@ -59,4 +59,4 @@ or [rectangleProfile](../geometry/rectangleProfile.md) to retain identified loft
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/regularPolygon.md

@@ -36,4 +36,4 @@ regularPolygon({ radius: 10, sides: 6, sizing: "face" });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/revolve.md

@@ -1,8 +1,8 @@
 # revolve
 
-Revolves explicit corresponding radial/Z contours around +Z, with caps for partial sweeps. Filled Sections use `section.revolve(options)`.
+Revolves a filled Section or explicit corresponding radial/Z contours around +Z, with caps for partial sweeps. Use `section.revolve(options)` in fluent sequences, or this function for generic profile inputs.
 
-**revolve**(`shape`: [`CorrespondingProfile`](CorrespondingProfile.md), `options?`: [`RevolveOptions`](RevolveOptions.md)): [`Solid`](Solid.md)
+**revolve**(`shape`: [`Section`](Section.md) \| [`CorrespondingProfile`](CorrespondingProfile.md), `options?`: [`RevolveOptions`](RevolveOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -21,7 +21,7 @@ revolve(profile!, { degrees: 270 });
 
 <a id="shape"></a>
 
-**`shape`** · [`CorrespondingProfile`](CorrespondingProfile.md) · Required
+**`shape`** · [`Section`](Section.md) \| [`CorrespondingProfile`](CorrespondingProfile.md) · Required
 
 
 
@@ -46,7 +46,7 @@ revolve(profile!, { degrees: 270 });
   smaller sweeps form partial revolutions with end caps.
   Segment counts describe a complete circle and scale to this angular span. Native filled
   revolutions require at least three sweep intervals: adaptive sampling refines to that floor,
-  while exact counts that imply fewer intervals reject. Pure revolveMesh supports one interval.
+  while exact counts that imply fewer intervals reject. Pure mesh.revolve supports one interval.
 
 - [`limits`](RevolveOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
 
@@ -63,6 +63,7 @@ revolve(profile!, { degrees: 270 });
 
 - [CorrespondingProfile](CorrespondingProfile.md)
 - [RevolveOptions](RevolveOptions.md)
+- [Section](Section.md)
 - [Solid](Solid.md)
 
 ## Guides
@@ -72,4 +73,4 @@ revolve(profile!, { degrees: 270 });
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/solidFromMesh.md

@@ -2,7 +2,7 @@
 
 Imports a bounded closed indexed mesh.
 
-**solidFromMesh**(`mesh`: [`TriangleMesh`](TriangleMesh.md) \| [`ImmutableTriangleMesh`](ImmutableTriangleMesh.md)): [`Solid`](Solid.md)
+**solidFromMesh**(`mesh`: [`TriangleMesh`](TriangleMesh.md) \| [`ImmutableTriangleMesh`](../geometry/ImmutableTriangleMesh.md)): [`Solid`](Solid.md)
 
 
 
@@ -10,17 +10,18 @@ Imports a bounded closed indexed mesh.
 
 ```ts
 import { solidFromMesh } from "@metamesh/modeling";
-import { extrudeMesh, rectangleContour } from "@metamesh/modeling/geometry";
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+import { rectangleContour } from "@metamesh/modeling/geometry";
 
-const mesh = extrudeMesh(rectangleContour({ size: [20, 12] }), { height: 6 });
-solidFromMesh(mesh);
+const plate = mesh.extrude(rectangleContour({ size: [20, 12] }), { height: 6 });
+solidFromMesh(plate);
 ```
 
 ## Parameters
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMesh`](TriangleMesh.md) \| [`ImmutableTriangleMesh`](ImmutableTriangleMesh.md) · Required
+**`mesh`** · [`TriangleMesh`](TriangleMesh.md) \| [`ImmutableTriangleMesh`](../geometry/ImmutableTriangleMesh.md) · Required
 
 
 
@@ -39,4 +40,4 @@ solidFromMesh(mesh);
 
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/sphere.md

@@ -39,4 +39,4 @@ sphere({ diameter: 20 });
 - [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/star.md

@@ -24,23 +24,23 @@ star({ outerRadius: 12, innerRadius: 6, points: 5 });
 
 - [`innerRadius`](StarOptions.md#innerradius) · `number` · Required
 
-  Positive inner vertex radius, smaller than the outer radius.
+  Positive inner vertex radius in millimetres, smaller than the outer radius.
 
 - [`points`](StarOptions.md#points) · `number` · Required
 
-  Integer outer point count from three through 50000.
+  Integer outer point count, at least three; output contains twice as many vertices.
 
 - [`attachment`](StarOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
 
   Applied after local construction; Section attachment must preserve the XY plane.
 
-- [`limits`](StarOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+- [`rotation`](StarOptions.md#rotation) · `number` · Optional
 
-  Explicit sampling ceilings, bounded by the host policy.
+  Counterclockwise rotation in degrees; defaults to zero with an outer vertex on +X.
 
-- [`rotation`](StarOptions.md#rotation) · `number` · Optional
+- [`limits`](StarOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
-  Initial counterclockwise rotation in degrees; defaults to zero.
+  Explicit sampling ceilings, bounded by the host policy during modeling.
 
 
 
@@ -60,4 +60,4 @@ star({ outerRadius: 12, innerRadius: 6, points: 5 });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/stroke.md

@@ -71,4 +71,4 @@ closed paths omit the duplicated seam. Returns an immutable deferred recipe.
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/svgPathSection.md

@@ -62,4 +62,4 @@ svgPathSection("M0 0H20V12H0Z", { origin: "center", scale: 1 });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/svgSection.md

@@ -27,6 +27,10 @@ svgSection(
 
 **`options`** · [`SvgSectionOptions`](SvgSectionOptions.md) · Optional
 
+- [`fit`](SvgSectionOptions.md#fit) · [`Bounds2Input`](Bounds2Input.md) · Optional
+
+  Fit painted bounds uniformly inside positioned XY millimetre bounds; adaptive resolution applies at the fitted size.
+
 - [`limits`](SvgSectionOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
   Local allocation ceilings may only lower the configured engine policy.
@@ -61,4 +65,4 @@ svgSection(
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/sweep.md

@@ -1,8 +1,8 @@
 # sweep
 
-Sweeps explicit corresponding contours using the selected frame policy. Filled Sections use `section.sweep(path, options)`.
+Sweeps a filled Section or explicit corresponding contours using the selected frame policy. Use `section.sweep(path, options)` in fluent sequences, or this function for generic profile inputs.
 
-**sweep**(`shape`: [`CorrespondingProfile`](CorrespondingProfile.md), `path`: [`Path3Input`](Path3Input.md), `options?`: [`SweepOptions`](SweepOptions.md)): [`Solid`](Solid.md)
+**sweep**(`shape`: [`Section`](Section.md) \| [`CorrespondingProfile`](CorrespondingProfile.md), `path`: [`Path3Input`](Path3Input.md), `options?`: [`SweepOptions`](SweepOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -22,7 +22,7 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
 <a id="shape"></a>
 
-**`shape`** · [`CorrespondingProfile`](CorrespondingProfile.md) · Required
+**`shape`** · [`Section`](Section.md) \| [`CorrespondingProfile`](CorrespondingProfile.md) · Required
 
 
 
@@ -79,6 +79,7 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
 - [CorrespondingProfile](CorrespondingProfile.md)
 - [Path3Input](Path3Input.md)
+- [Section](Section.md)
 - [Solid](Solid.md)
 - [SweepOptions](SweepOptions.md)
 
@@ -89,4 +90,4 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/textSection.md

@@ -54,4 +54,4 @@ function labelSection(layout: VectorTextLayout) {
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/threadRidge.md

@@ -2,7 +2,7 @@
 
 Helical ridge mesh construction.
 
-**threadRidge**(`options`: [`HelicalThreadRidgeMeshOptions`](HelicalThreadRidgeMeshOptions.md)): [`Solid`](Solid.md)
+**threadRidge**(`options`: [`ThreadRidgeOptions`](ThreadRidgeOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -10,46 +10,46 @@ Helical ridge mesh construction.
 
 <a id="options"></a>
 
-**`options`** · [`HelicalThreadRidgeMeshOptions`](HelicalThreadRidgeMeshOptions.md) · Required
+**`options`** · [`ThreadRidgeOptions`](ThreadRidgeOptions.md) · Required
 
-- [`length`](HelicalThreadRidgeMeshOptions.md#length) · `number` · Required
+- [`length`](ThreadRidgeOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
 
-- [`majorDiameter`](HelicalThreadRidgeMeshOptions.md#majordiameter) · `number` · Required
+- [`majorDiameter`](ThreadRidgeOptions.md#majordiameter) · `number` · Required
 
   Nominal major diameter before any caller-owned fit compensation.
 
-- [`profile`](HelicalThreadRidgeMeshOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+- [`profile`](ThreadRidgeOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
-- [`ends`](HelicalThreadRidgeMeshOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
+- [`ends`](ThreadRidgeOptions.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`](HelicalThreadRidgeMeshOptions.md#handedness) · [`ThreadHandedness`](ThreadHandedness.md) · Optional
+- [`handedness`](ThreadRidgeOptions.md#handedness) · [`ThreadHandedness`](ThreadHandedness.md) · Optional
 
   Helix direction. Default: `right`.
 
-- [`limits`](HelicalThreadRidgeMeshOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+- [`limits`](ThreadRidgeOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
 
   Explicit output and circular allocation ceilings.
 
-- [`phase`](HelicalThreadRidgeMeshOptions.md#phase) · `number` · Optional
+- [`phase`](ThreadRidgeOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
-- [`resolution`](HelicalThreadRidgeMeshOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](ThreadRidgeOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
 
   Optional circular-resolution policy.
 
-- [`starts`](HelicalThreadRidgeMeshOptions.md#starts) · `number` · Optional
+- [`starts`](ThreadRidgeOptions.md#starts) · `number` · Optional
 
   Number of evenly phased starts. Default: `1`.
 
-- [`tolerance`](HelicalThreadRidgeMeshOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+- [`tolerance`](ThreadRidgeOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
 
   Optional numerical tolerance overrides.
 
@@ -62,12 +62,12 @@ Helical ridge mesh construction.
 
 ## Related APIs
 
-- [HelicalThreadRidgeMeshOptions](HelicalThreadRidgeMeshOptions.md)
 - [Solid](Solid.md)
+- [ThreadRidgeOptions](ThreadRidgeOptions.md)
 
 ## Guides
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 - [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.