@metamesh/modeling 0.18.0 → 0.20.0

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

@@ -1,16 +1,22 @@
 # sweep
 
-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.
+Sweeps a filled Section or corresponding contours along a path or explicit affine placements. Use `section.sweep(path, options)` in fluent sequences, or this function for generic profile inputs.
 
-**sweep**(`shape`: [`Section`](Section.md) \| [`CorrespondingProfile`](CorrespondingProfile.md), `path`: [`Path3Input`](Path3Input.md), `options?`: [`SweepOptions`](SweepOptions.md)): [`Solid`](Solid.md)
+## Call Signature
+
+
+
+**sweep**(`shape`: [`Section`](Section.md) \| [`CorrespondingProfile`](../geometry/CorrespondingProfile.md), `path`: [`Path3Input`](../geometry/Path3Input.md), `options?`: [`SweepOptions`](SweepOptions.md)): [`Solid`](Solid.md)
 
 
 
 ## Example: Sweep
 
+
+
 ```ts
-import { matchProfiles, sweep } from "@metamesh/modeling";
-import { rectangleProfile } from "@metamesh/modeling/geometry";
+import { sweep } from "@metamesh/modeling";
+import { matchProfiles, rectangleProfile } from "@metamesh/modeling/geometry";
 
 const [profile] = matchProfiles([rectangleProfile({ size: [6, 3] })]);
 sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
@@ -18,17 +24,26 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 });
 ```
 
-## Parameters
+
+
+Sweeps a filled Section or corresponding contours along a path or explicit affine placements.
+Use `section.sweep(path, options)` in fluent sequences, or this function for generic profile inputs.
+
+### Parameters
 
 <a id="shape"></a>
 
-**`shape`** · [`Section`](Section.md) \| [`CorrespondingProfile`](CorrespondingProfile.md) · Required
+**`shape`** · [`Section`](Section.md) \| [`CorrespondingProfile`](../geometry/CorrespondingProfile.md) · Required
+
+Profile in local XY millimetres.
 
 
 
 <a id="path"></a>
 
-**`path`** · [`Path3Input`](Path3Input.md) · Required
+**`path`** · [`Path3Input`](../geometry/Path3Input.md) · Required
+
+XYZ path in millimetres.
 
 
 
@@ -40,54 +55,123 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
   Raw point closure defaults to false; a Path3 supplies its closure and rejects conflicts.
 
-- [`limits`](SweepOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+- [`limits`](SweepOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and sampling allocation ceilings.
 
 - [`orientation`](SweepOptions.md#orientation) · [`SweepOrientation`](SweepOrientation.md) · Optional
 
-  Explicit frame policy; default transport minimizes rotations, initially projecting +X then +Y then +Z.
+  Default transport minimizes rotations, initially projecting +X then +Y then +Z.
 
-- [`resolution`](SweepOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](SweepOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
-  Physical sampling of nonzero twist; inserted stations retain authored station controls.
+  Physical sampling of twist and varying scale, plus optional segment-length limits. Inserted stations retain authored controls.
 
 - [`twist`](SweepOptions.md#twist) · `number` · Optional
 
-  Total additional profile rotation in degrees, with progression selected by twistBy.
+  Total additional profile rotation in degrees; compatible closed boundaries are aligned automatically.
 
 - [`twistBy`](SweepOptions.md#twistby) · `"length"` \| `"stations"` · Optional
 
   Twist advances by physical path length (default), or normalized authored station position, including a closed seam gap.
 
-- [`scale`](SweepOptions.md#scale) · `number` \| [`Vector2Input`](Vector2Input.md) \| readonly [`Vector2Input`](Vector2Input.md)[] · Optional
+- [`scale`](SweepOptions.md#scale) · `number` \| [`Vector2Input`](../geometry/Vector2Input.md) \| readonly [`Vector2Input`](../geometry/Vector2Input.md)[] · Optional
+
+  Positive final uniform/XY scale on open paths, interpolated from one by path length. Closed paths use a uniform scale. Explicit XY pairs set each original station; omitted is one.
+
+
+
+### Returns
+
+[`Solid`](Solid.md)
+
+## Call Signature
+
+
+
+**sweep**(`shape`: [`Section`](Section.md) \| [`CorrespondingProfile`](../geometry/CorrespondingProfile.md), `transforms`: readonly [`Transform3Input`](../geometry/Transform3Input.md)[], `options?`: [`SweepTransformOptions`](SweepTransformOptions.md)): [`Solid`](Solid.md)
+
+
+
+Connects one profile through exactly the supplied affine placements.
+
+### Parameters
+
+<a id="shape-1"></a>
+
+**`shape`** · [`Section`](Section.md) \| [`CorrespondingProfile`](../geometry/CorrespondingProfile.md) · Required
 
-  Positive uniform/XY scale, or one XY pair per path station. Defaults to one.
+Profile in local XY millimetres.
 
-- [`seamProfileOffset`](SweepOptions.md#seamprofileoffset) · `number` · Optional
 
-  Corresponding point-index advance at a rotationally equivalent closed seam.
 
+<a id="transforms"></a>
 
+**`transforms`** · readonly [`Transform3Input`](../geometry/Transform3Input.md)[] · Required
 
-## Returns
+Ordered local-to-model placements.
+
+
+
+<a id="options-1"></a>
+
+**`options`** · [`SweepTransformOptions`](SweepTransformOptions.md) · Optional
+
+- [`closed`](SweepTransformOptions.md#closed) · `boolean` · Optional
+
+  Connect the last supplied station to the first without caps. Defaults to false.
+
+- [`limits`](SweepTransformOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+
+  Explicit output and station allocation ceilings.
+
+- [`orientation`](SweepTransformOptions.md#orientation) · `undefined` · Optional
+
+  Encoded by the explicit transforms.
+
+- [`resolution`](SweepTransformOptions.md#resolution) · `undefined` · Optional
+
+  Explicit stations are never refined.
+
+- [`twist`](SweepTransformOptions.md#twist) · `undefined` · Optional
+
+  Encoded by the explicit transforms.
+
+- [`twistBy`](SweepTransformOptions.md#twistby) · `undefined` · Optional
+
+  Encoded by the explicit transforms.
+
+- [`scale`](SweepTransformOptions.md#scale) · `undefined` · Optional
+
+  Encoded by the explicit transforms.
+
+
+
+### Returns
 
 [`Solid`](Solid.md)
 
 
 ## Related APIs
 
-- [CorrespondingProfile](CorrespondingProfile.md)
-- [Path3Input](Path3Input.md)
 - [Section](Section.md)
 - [Solid](Solid.md)
 - [SweepOptions](SweepOptions.md)
+- [SweepTransformOptions](SweepTransformOptions.md)
 
 ## Guides
 
-- [Revolve a radial profile](../../guides/recipes.md#revolve-a-radial-profile)
-- [Rotation-minimizing path sweep](../../guides/recipes.md#rotation-minimizing-path-sweep)
-- [Matched-section loft](../../guides/recipes.md#matched-section-loft)
-- [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
+- [Finish a profile with a hole](../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
+- [Chamfer a twisted extrusion](../../guides/profiles-and-extrusion.md#chamfer-a-twisted-extrusion)
+- [Revolve a radial profile](../../guides/profiles-and-extrusion.md#revolve-a-radial-profile)
+- [Rotation-minimizing path sweep](../../guides/sweeps-and-lofts.md#rotation-minimizing-path-sweep)
+- [Matched-section loft](../../guides/sweeps-and-lofts.md#matched-section-loft)
+- [Choose a modeling path](../../guides/recipes.md#choose-a-technique)
+
+## Import
+
+```ts
+import { sweep } from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,13 +2,16 @@
 
 Consumes a previously prepared layout; never shapes or fetches a font.
 
-**textSection**(`layout`: [`VectorTextLayout`](VectorTextLayout.md), `options?`: [`TextSectionOptions`](TextSectionOptions.md)): [`Section`](Section.md)
+**textSection**(`layout`: [`VectorTextLayout`](../geometry/VectorTextLayout.md), `options?`: [`TextSectionOptions`](TextSectionOptions.md)): [`Section`](Section.md)
 
 
 
 ## Example: Use a prepared text layout
 
 ```ts
+import { textSection } from "@metamesh/modeling";
+import type { VectorTextLayout } from "@metamesh/modeling/geometry";
+
 // Prepare the exact font and layout before entering build.
 function labelSection(layout: VectorTextLayout) {
   return textSection(layout);
@@ -19,7 +22,9 @@ function labelSection(layout: VectorTextLayout) {
 
 <a id="layout"></a>
 
-**`layout`** · [`VectorTextLayout`](VectorTextLayout.md) · Required
+**`layout`** · [`VectorTextLayout`](../geometry/VectorTextLayout.md) · Required
+
+Prepared millimetre outlines; create the layout before generation.
 
 
 
@@ -27,11 +32,11 @@ function labelSection(layout: VectorTextLayout) {
 
 **`options`** · [`TextSectionOptions`](TextSectionOptions.md) · Optional
 
-- [`limits`](TextSectionOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+- [`limits`](TextSectionOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](../geometry/GeometrySamplingLimits.md)\> · Optional
 
   Local allocation ceilings may only lower the configured engine policy.
 
-- [`resolution`](TextSectionOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](TextSectionOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Local physical sampling policy; exact interval counts take precedence.
 
@@ -46,12 +51,17 @@ function labelSection(layout: VectorTextLayout) {
 
 - [Section](Section.md)
 - [TextSectionOptions](TextSectionOptions.md)
-- [VectorTextLayout](VectorTextLayout.md)
 
 ## Guides
 
-- [Section, hole, offset, and extrusion](../../guides/recipes.md#section-hole-offset-and-extrusion)
-- [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)
+- [Section, hole, offset, and extrusion](../../guides/profiles-and-extrusion.md#section-hole-offset-and-extrusion)
+- [SVG sections: fills and strokes are different inputs](../../guides/svg-and-text.md#svg-sections-fills-and-strokes-are-different-inputs)
+- [Text and font variability](../../guides/svg-and-text.md#text-and-font-variability)
+
+## Import
+
+```ts
+import { textSection } from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -1,8 +1,8 @@
 # threadRidge
 
-Helical ridge mesh construction.
+Declares a helical ridge Solid recipe along +Z, with lengths in millimetres.
 
-**threadRidge**(`options`: [`ThreadRidgeOptions`](ThreadRidgeOptions.md)): [`Solid`](Solid.md)
+**threadRidge**(`options`: [`ThreadRidgeOptions`](../mechanical/ThreadRidgeOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -10,46 +10,46 @@ Helical ridge mesh construction.
 
 <a id="options"></a>
 
-**`options`** · [`ThreadRidgeOptions`](ThreadRidgeOptions.md) · Required
+**`options`** · [`ThreadRidgeOptions`](../mechanical/ThreadRidgeOptions.md) · Required
 
-- [`length`](ThreadRidgeOptions.md#length) · `number` · Required
+- [`length`](../mechanical/ThreadRidgeOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
 
-- [`majorDiameter`](ThreadRidgeOptions.md#majordiameter) · `number` · Required
+- [`majorDiameter`](../mechanical/ThreadRidgeOptions.md#majordiameter) · `number` · Required
 
-  Nominal major diameter before any caller-owned fit compensation.
+  Major diameter in millimetres; apply any caller-owned fit compensation before construction.
 
-- [`profile`](ThreadRidgeOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+- [`profile`](../mechanical/ThreadRidgeOptions.md#profile) · [`ThreadProfile`](../mechanical/ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
-- [`ends`](ThreadRidgeOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
+- [`ends`](../mechanical/ThreadRidgeOptions.md#ends) · [`ThreadEndTreatmentOptions`](../mechanical/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`](ThreadRidgeOptions.md#handedness) · [`ThreadHandedness`](ThreadHandedness.md) · Optional
+- [`handedness`](../mechanical/ThreadRidgeOptions.md#handedness) · [`ThreadHandedness`](../mechanical/ThreadHandedness.md) · Optional
 
   Helix direction. Default: `right`.
 
-- [`limits`](ThreadRidgeOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+- [`limits`](../mechanical/ThreadRidgeOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and circular allocation ceilings.
 
-- [`phase`](ThreadRidgeOptions.md#phase) · `number` · Optional
+- [`phase`](../mechanical/ThreadRidgeOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
-- [`resolution`](ThreadRidgeOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](../mechanical/ThreadRidgeOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Optional circular-resolution policy.
 
-- [`starts`](ThreadRidgeOptions.md#starts) · `number` · Optional
+- [`starts`](../mechanical/ThreadRidgeOptions.md#starts) · `number` · Optional
 
   Number of evenly phased starts. Default: `1`.
 
-- [`tolerance`](ThreadRidgeOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../mechanical/ThreadRidgeOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Optional numerical tolerance overrides.
 
@@ -63,11 +63,16 @@ Helical ridge mesh construction.
 ## Related APIs
 
 - [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)
+- [Preflight guarantees and host settings](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import { threadRidge } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,89 +2,93 @@
 
 Compensated threaded nut.
 
-**threadedNut**(`options`: [`ThreadedNutOptions`](ThreadedNutOptions.md)): [`Solid`](Solid.md)
+**threadedNut**(`options`: [`ThreadedNutOptions`](../mechanical/ThreadedNutOptions.md)): [`Solid`](Solid.md)
 
 
 
 ## Example: Threaded nut
 
+
+
 ```ts
 import { threadedNut } from "@metamesh/modeling";
-import { threadProfile } from "@metamesh/modeling/geometry";
+import { threadProfile } from "@metamesh/modeling/geometry/mechanical";
 
 const profile = threadProfile({ kind: "triangular", pitch: 1.75 });
 threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", profile, fit: "normal" });
 ```
 
+
+
 ## Parameters
 
 <a id="options"></a>
 
-**`options`** · [`ThreadedNutOptions`](ThreadedNutOptions.md) · Required
+**`options`** · [`ThreadedNutOptions`](../mechanical/ThreadedNutOptions.md) · Required
 
-- [`nominalMajorDiameter`](ThreadedNutOptions.md#nominalmajordiameter) · `number` · Required
+- [`nominalMajorDiameter`](../mechanical/ThreadedNutOptions.md#nominalmajordiameter) · `number` · Required
 
   Nominal major diameter before female compensation and faceting correction.
 
-- [`shape`](ThreadedNutOptions.md#shape) · [`ThreadedNutShape`](ThreadedNutShape.md) · Required
+- [`shape`](../mechanical/ThreadedNutOptions.md#shape) · [`ThreadedNutShape`](../mechanical/ThreadedNutShape.md) · Required
 
   Nut body shape.
 
-- [`thickness`](ThreadedNutOptions.md#thickness) · `number` · Required
+- [`thickness`](../mechanical/ThreadedNutOptions.md#thickness) · `number` · Required
 
   Nut thickness along +Z in millimetres.
 
-- [`width`](ThreadedNutOptions.md#width) · `number` · Required
+- [`width`](../mechanical/ThreadedNutOptions.md#width) · `number` · Required
 
   Across-flats width for hex/square or diameter for round, in millimetres.
 
-- [`profile`](ThreadedNutOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+- [`profile`](../mechanical/ThreadedNutOptions.md#profile) · [`ThreadProfile`](../mechanical/ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
-- [`fit`](ThreadedNutOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
+- [`fit`](../mechanical/ThreadedNutOptions.md#fit) · [`PrintableThreadFit`](../mechanical/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../mechanical/PrintableThreadFitPolicy.md) · Optional
 
   Printable fit or caller-calibrated allowances. Default: `normal`.
 
-- [`innerBevel`](ThreadedNutOptions.md#innerbevel) · [`Bevel`](Bevel.md) · Optional
+- [`innerBevel`](../mechanical/ThreadedNutOptions.md#innerbevel) · [`Bevel`](../mechanical/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
+- [`outerBevel`](../mechanical/ThreadedNutOptions.md#outerbevel) · [`Bevel`](../mechanical/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
+- [`bodyResolution`](../mechanical/ThreadedNutOptions.md#bodyresolution) · [`GeometryResolution`](../geometry/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
+- [`ends`](../mechanical/ThreadedNutOptions.md#ends) · [`ThreadEndTreatmentOptions`](../mechanical/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
+- [`handedness`](../mechanical/ThreadedNutOptions.md#handedness) · [`ThreadHandedness`](../mechanical/ThreadHandedness.md) · Optional
 
   Helix direction. Default: `right`.
 
-- [`limits`](ThreadedNutOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+- [`limits`](../mechanical/ThreadedNutOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and circular allocation ceilings.
 
-- [`phase`](ThreadedNutOptions.md#phase) · `number` · Optional
+- [`phase`](../mechanical/ThreadedNutOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
-- [`resolution`](ThreadedNutOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](../mechanical/ThreadedNutOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Optional circular-resolution policy.
 
-- [`starts`](ThreadedNutOptions.md#starts) · `number` · Optional
+- [`starts`](../mechanical/ThreadedNutOptions.md#starts) · `number` · Optional
 
   Number of evenly phased starts. Default: `1`.
 
-- [`tolerance`](ThreadedNutOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../mechanical/ThreadedNutOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Optional numerical tolerance overrides.
 
@@ -98,11 +102,16 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 ## Related APIs
 
 - [Solid](Solid.md)
-- [ThreadedNutOptions](ThreadedNutOptions.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)
+- [Preflight guarantees and host settings](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Import
+
+```ts
+import { threadedNut } from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,73 +2,77 @@
 
 Compensated external threaded rod.
 
-**threadedRod**(`options`: [`ThreadedRodOptions`](ThreadedRodOptions.md)): [`Solid`](Solid.md)
+**threadedRod**(`options`: [`ThreadedRodOptions`](../mechanical/ThreadedRodOptions.md)): [`Solid`](Solid.md)
 
 
 
 ## Example: Threaded rod
 
+
+
 ```ts
 import { threadedRod } from "@metamesh/modeling";
-import { threadProfile } from "@metamesh/modeling/geometry";
+import { threadProfile } from "@metamesh/modeling/geometry/mechanical";
 
 const profile = threadProfile({ kind: "triangular", pitch: 1.75 });
 threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 ```
 
+
+
 ## Parameters
 
 <a id="options"></a>
 
-**`options`** · [`ThreadedRodOptions`](ThreadedRodOptions.md) · Required
+**`options`** · [`ThreadedRodOptions`](../mechanical/ThreadedRodOptions.md) · Required
 
-- [`nominalMajorDiameter`](ThreadedRodOptions.md#nominalmajordiameter) · `number` · Required
+- [`nominalMajorDiameter`](../mechanical/ThreadedRodOptions.md#nominalmajordiameter) · `number` · Required
 
   Nominal major diameter before male compensation.
 
-- [`length`](ThreadedRodOptions.md#length) · `number` · Required
+- [`length`](../mechanical/ThreadedRodOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
 
-- [`profile`](ThreadedRodOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+- [`profile`](../mechanical/ThreadedRodOptions.md#profile) · [`ThreadProfile`](../mechanical/ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
-- [`bevel`](ThreadedRodOptions.md#bevel) · [`Bevel`](Bevel.md) · Optional
+- [`bevel`](../mechanical/ThreadedRodOptions.md#bevel) · [`Bevel`](../mechanical/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.
 
-- [`fit`](ThreadedRodOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
+- [`fit`](../mechanical/ThreadedRodOptions.md#fit) · [`PrintableThreadFit`](../mechanical/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../mechanical/PrintableThreadFitPolicy.md) · Optional
 
   Printable fit or caller-calibrated allowances. Default: `normal`.
 
-- [`ends`](ThreadedRodOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
+- [`ends`](../mechanical/ThreadedRodOptions.md#ends) · [`ThreadEndTreatmentOptions`](../mechanical/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
+- [`handedness`](../mechanical/ThreadedRodOptions.md#handedness) · [`ThreadHandedness`](../mechanical/ThreadHandedness.md) · Optional
 
   Helix direction. Default: `right`.
 
-- [`limits`](ThreadedRodOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+- [`limits`](../mechanical/ThreadedRodOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and circular allocation ceilings.
 
-- [`phase`](ThreadedRodOptions.md#phase) · `number` · Optional
+- [`phase`](../mechanical/ThreadedRodOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
-- [`resolution`](ThreadedRodOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](../mechanical/ThreadedRodOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Optional circular-resolution policy.
 
-- [`starts`](ThreadedRodOptions.md#starts) · `number` · Optional
+- [`starts`](../mechanical/ThreadedRodOptions.md#starts) · `number` · Optional
 
   Number of evenly phased starts. Default: `1`.
 
-- [`tolerance`](ThreadedRodOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../mechanical/ThreadedRodOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Optional numerical tolerance overrides.
 
@@ -82,11 +86,16 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 ## Related APIs
 
 - [Solid](Solid.md)
-- [ThreadedRodOptions](ThreadedRodOptions.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)
+- [Preflight guarantees and host settings](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Import
+
+```ts
+import { threadedRod } from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -34,7 +34,7 @@ torus({ majorRadius: 12, minorRadius: 3 });
 
   Applied after local construction; Section attachment must preserve the XY plane.
 
-- [`limits`](TorusOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+- [`limits`](TorusOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](../geometry/GeometrySamplingLimits.md)\> · Optional
 
   Explicit sampling ceilings, bounded by the host policy.
 
@@ -46,7 +46,7 @@ torus({ majorRadius: 12, minorRadius: 3 });
 
   Exact segment count around the swept profile; omitted uses adaptive resolution.
 
-- [`resolution`](TorusOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](TorusOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Operation-level physical tessellation policy over the active model-wide policy.
 
@@ -64,7 +64,15 @@ torus({ majorRadius: 12, minorRadius: 3 });
 
 ## Guides
 
-- [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
-- [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
+- [Choose a primitive](../../guides/profiles-and-extrusion.md#choose-a-primitive)
+- [Treated boxes, frustums, and mirrored arrays](../../guides/profiles-and-extrusion.md#treated-boxes-frustums-and-mirrored-arrays)
+- [Finish a profile with a hole](../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
+- [Shape openings and local edges](../../guides/profiles-and-extrusion.md#shape-openings-and-local-edges)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import { torus } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -36,7 +36,15 @@ tube({ height: 20, outerRadius: 10, innerRadius: 6 });
 
 ## Guides
 
-- [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
-- [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
+- [Choose a primitive](../../guides/profiles-and-extrusion.md#choose-a-primitive)
+- [Treated boxes, frustums, and mirrored arrays](../../guides/profiles-and-extrusion.md#treated-boxes-frustums-and-mirrored-arrays)
+- [Finish a profile with a hole](../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
+- [Shape openings and local edges](../../guides/profiles-and-extrusion.md#shape-openings-and-local-edges)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import { tube } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.