@metamesh/modeling 0.17.0 → 0.19.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`](../geometry/ThreadRidgeOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -10,46 +10,46 @@ Helical ridge mesh construction.
 
 <a id="options"></a>
 
-**`options`** · [`HelicalThreadRidgeMeshOptions`](HelicalThreadRidgeMeshOptions.md) · Required
+**`options`** · [`ThreadRidgeOptions`](../geometry/ThreadRidgeOptions.md) · Required
 
-- [`length`](HelicalThreadRidgeMeshOptions.md#length) · `number` · Required
+- [`length`](../geometry/ThreadRidgeOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
 
-- [`majorDiameter`](HelicalThreadRidgeMeshOptions.md#majordiameter) · `number` · Required
+- [`majorDiameter`](../geometry/ThreadRidgeOptions.md#majordiameter) · `number` · Required
 
   Nominal major diameter before any caller-owned fit compensation.
 
-- [`profile`](HelicalThreadRidgeMeshOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+- [`profile`](../geometry/ThreadRidgeOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
-- [`ends`](HelicalThreadRidgeMeshOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
+- [`ends`](../geometry/ThreadRidgeOptions.md#ends) · [`ThreadEndTreatmentOptions`](../geometry/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`](../geometry/ThreadRidgeOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
 
   Helix direction. Default: `right`.
 
-- [`limits`](HelicalThreadRidgeMeshOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+- [`limits`](../geometry/ThreadRidgeOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and circular allocation ceilings.
 
-- [`phase`](HelicalThreadRidgeMeshOptions.md#phase) · `number` · Optional
+- [`phase`](../geometry/ThreadRidgeOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
-- [`resolution`](HelicalThreadRidgeMeshOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](../geometry/ThreadRidgeOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Optional circular-resolution policy.
 
-- [`starts`](HelicalThreadRidgeMeshOptions.md#starts) · `number` · Optional
+- [`starts`](../geometry/ThreadRidgeOptions.md#starts) · `number` · Optional
 
   Number of evenly phased starts. Default: `1`.
 
-- [`tolerance`](HelicalThreadRidgeMeshOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../geometry/ThreadRidgeOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Optional numerical tolerance overrides.
 
@@ -62,12 +62,18 @@ Helical ridge mesh construction.
 
 ## Related APIs
 
-- [HelicalThreadRidgeMeshOptions](HelicalThreadRidgeMeshOptions.md)
 - [Solid](Solid.md)
+- [ThreadRidgeOptions](../geometry/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.17.0`.
+## Supported imports
+
+```ts
+import { threadRidge } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -2,7 +2,7 @@
 
 Compensated threaded nut.
 
-**threadedNut**(`options`: [`ThreadedNutOptions`](ThreadedNutOptions.md)): [`Solid`](Solid.md)
+**threadedNut**(`options`: [`ThreadedNutOptions`](../geometry/ThreadedNutOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -20,76 +20,73 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 
 <a id="options"></a>
 
-**`options`** · [`ThreadedNutOptions`](ThreadedNutOptions.md) · Required
+**`options`** · [`ThreadedNutOptions`](../geometry/ThreadedNutOptions.md) · Required
 
-- [`profile`](ThreadedNutOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
-
-  Validated periodic profile repeated around the shaft.
-
-- [`nominalMajorDiameter`](ThreadedNutOptions.md#nominalmajordiameter) · `number` · Required
+- [`nominalMajorDiameter`](../geometry/ThreadedNutOptions.md#nominalmajordiameter) · `number` · Required
 
   Nominal major diameter before female compensation and faceting correction.
 
-- [`shape`](ThreadedNutOptions.md#shape) · [`ThreadedNutShape`](ThreadedNutShape.md) · Required
+- [`shape`](../geometry/ThreadedNutOptions.md#shape) · [`ThreadedNutShape`](../geometry/ThreadedNutShape.md) · Required
 
   Nut body shape.
 
-- [`thickness`](ThreadedNutOptions.md#thickness) · `number` · Required
+- [`thickness`](../geometry/ThreadedNutOptions.md#thickness) · `number` · Required
 
   Nut thickness along +Z in millimetres.
 
-- [`width`](ThreadedNutOptions.md#width) · `number` · Required
+- [`width`](../geometry/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
+- [`profile`](../geometry/ThreadedNutOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
 
-  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.
+  Validated periodic profile repeated around the shaft.
 
-- [`handedness`](ThreadedNutOptions.md#handedness) · [`ThreadHandedness`](ThreadHandedness.md) · Optional
+- [`fit`](../geometry/ThreadedNutOptions.md#fit) · [`PrintableThreadFit`](../geometry/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../geometry/PrintableThreadFitPolicy.md) · Optional
 
-  Helix direction. Default: `right`.
+  Printable fit or caller-calibrated allowances. Default: `normal`.
 
-- [`limits`](ThreadedNutOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+- [`innerBevel`](../geometry/ThreadedNutOptions.md#innerbevel) · [`Bevel`](../geometry/Bevel.md) · Optional
 
-  Explicit output and circular allocation ceilings.
+  Opening bevels in [bottom, top] order. Omitted or auto uses min(profile.depth, thickness/4); zero disables.
 
-- [`phase`](ThreadedNutOptions.md#phase) · `number` · Optional
+- [`outerBevel`](../geometry/ThreadedNutOptions.md#outerbevel) · [`Bevel`](../geometry/Bevel.md) · Optional
 
-  Angular offset of the first start in degrees. Default: `0`.
+  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.
 
-- [`resolution`](ThreadedNutOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`bodyResolution`](../geometry/ThreadedNutOptions.md#bodyresolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
-  Optional circular-resolution policy.
+  Optional physical policy for a round body, independent of the thread's matched facet grid.
 
-- [`starts`](ThreadedNutOptions.md#starts) · `number` · Optional
+- [`ends`](../geometry/ThreadedNutOptions.md#ends) · [`ThreadEndTreatmentOptions`](../geometry/ThreadEndTreatmentOptions.md) · Optional
 
-  Number of evenly phased starts. Default: `1`.
+  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.
 
-- [`tolerance`](ThreadedNutOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+- [`handedness`](../geometry/ThreadedNutOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
 
-  Optional numerical tolerance overrides.
+  Helix direction. Default: `right`.
 
-- [`fit`](ThreadedNutOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
+- [`limits`](../geometry/ThreadedNutOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
-  Printable fit or caller-calibrated allowances. Default: `normal`.
+  Explicit output and circular allocation ceilings.
 
-- [`bevel`](ThreadedNutOptions.md#bevel) · [`ThreadedNutBevel`](ThreadedNutBevel.md) · Optional
+- [`phase`](../geometry/ThreadedNutOptions.md#phase) · `number` · Optional
 
-  Nut body bevel selection. Default: `automatic`.
+  Angular offset of the first start in degrees. Default: `0`.
 
-- [`bodyResolution`](ThreadedNutOptions.md#bodyresolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](../geometry/ThreadedNutOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
-  Optional physical policy for a round body, independent of the thread's matched facet grid.
+  Optional circular-resolution policy.
 
-- [`chamferSize`](ThreadedNutOptions.md#chamfersize) · `number` · Optional
+- [`starts`](../geometry/ThreadedNutOptions.md#starts) · `number` · Optional
 
-  45-degree body chamfer extent. Default: `min(profile.depth, thickness/4)`.
+  Number of evenly phased starts. Default: `1`.
 
-- [`flushBuildPlateBottom`](ThreadedNutOptions.md#flushbuildplatebottom) · `boolean` · Optional
+- [`tolerance`](../geometry/ThreadedNutOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
-  Leave the bottom outside edge flat for build-plate adhesion. Default: `false`.
+  Optional numerical tolerance overrides.
 
 
 
@@ -101,11 +98,17 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 ## Related APIs
 
 - [Solid](Solid.md)
-- [ThreadedNutOptions](ThreadedNutOptions.md)
+- [ThreadedNutOptions](../geometry/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)
+
+## Supported imports
+
+```ts
+import { threadedNut } from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -2,7 +2,7 @@
 
 Compensated external threaded rod.
 
-**threadedRod**(`options`: [`ThreadedRodOptions`](ThreadedRodOptions.md)): [`Solid`](Solid.md)
+**threadedRod**(`options`: [`ThreadedRodOptions`](../geometry/ThreadedRodOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -20,66 +20,58 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 
 <a id="options"></a>
 
-**`options`** · [`ThreadedRodOptions`](ThreadedRodOptions.md) · Required
+**`options`** · [`ThreadedRodOptions`](../geometry/ThreadedRodOptions.md) · Required
 
-- [`length`](ThreadedRodOptions.md#length) · `number` · Required
+- [`nominalMajorDiameter`](../geometry/ThreadedRodOptions.md#nominalmajordiameter) · `number` · Required
+
+  Nominal major diameter before male compensation.
+
+- [`length`](../geometry/ThreadedRodOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
 
-- [`profile`](ThreadedRodOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+- [`profile`](../geometry/ThreadedRodOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
-- [`nominalMajorDiameter`](ThreadedRodOptions.md#nominalmajordiameter) · `number` · Required
+- [`bevel`](../geometry/ThreadedRodOptions.md#bevel) · [`Bevel`](../geometry/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`](../geometry/ThreadedRodOptions.md#fit) · [`PrintableThreadFit`](../geometry/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../geometry/PrintableThreadFitPolicy.md) · Optional
 
-- [`ends`](ThreadedRodOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
+  Printable fit or caller-calibrated allowances. Default: `normal`.
+
+- [`ends`](../geometry/ThreadedRodOptions.md#ends) · [`ThreadEndTreatmentOptions`](../geometry/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`](../geometry/ThreadedRodOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
 
   Helix direction. Default: `right`.
 
-- [`limits`](ThreadedRodOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+- [`limits`](../geometry/ThreadedRodOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and circular allocation ceilings.
 
-- [`phase`](ThreadedRodOptions.md#phase) · `number` · Optional
+- [`phase`](../geometry/ThreadedRodOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
-- [`resolution`](ThreadedRodOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](../geometry/ThreadedRodOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Optional circular-resolution policy.
 
-- [`starts`](ThreadedRodOptions.md#starts) · `number` · Optional
+- [`starts`](../geometry/ThreadedRodOptions.md#starts) · `number` · Optional
 
   Number of evenly phased starts. Default: `1`.
 
-- [`tolerance`](ThreadedRodOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../geometry/ThreadedRodOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/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
@@ -90,11 +82,17 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 ## Related APIs
 
 - [Solid](Solid.md)
-- [ThreadedRodOptions](ThreadedRodOptions.md)
+- [ThreadedRodOptions](../geometry/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)
+
+## Supported imports
+
+```ts
+import { threadedRod } from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -2,7 +2,7 @@
 
 Torus around +Z.
 
-**torus**(`options`: [`TorusOptions`](TorusOptions.md)): [`Solid`](Solid.md)
+**torus**(`options`: [`TorusOptions`](../geometry/TorusOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -20,33 +20,33 @@ torus({ majorRadius: 12, minorRadius: 3 });
 
 <a id="options"></a>
 
-**`options`** · [`TorusOptions`](TorusOptions.md) · Required
+**`options`** · [`TorusOptions`](../geometry/TorusOptions.md) · Required
 
-- [`majorRadius`](TorusOptions.md#majorradius) · `number` · Required
+- [`majorRadius`](../geometry/TorusOptions.md#majorradius) · `number` · Required
 
   Radius from the Z axis to the profile center, in millimetres; greater than `minorRadius`.
 
-- [`minorRadius`](TorusOptions.md#minorradius) · `number` · Required
+- [`minorRadius`](../geometry/TorusOptions.md#minorradius) · `number` · Required
 
   Radius of the swept circular profile in millimetres.
 
-- [`attachment`](TorusOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
+- [`attachment`](../geometry/TorusOptions.md#attachment) · [`PrimitiveAttachmentOptions`](../geometry/PrimitiveAttachmentOptions.md) · Optional
 
   Applied after local construction; Section attachment must preserve the XY plane.
 
-- [`limits`](TorusOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+- [`limits`](../geometry/TorusOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](../geometry/GeometrySamplingLimits.md)\> · Optional
 
   Explicit sampling ceilings, bounded by the host policy.
 
-- [`majorSegments`](TorusOptions.md#majorsegments) · `number` · Optional
+- [`majorSegments`](../geometry/TorusOptions.md#majorsegments) · `number` · Optional
 
   Exact segment count around the Z axis; omitted uses adaptive resolution.
 
-- [`minorSegments`](TorusOptions.md#minorsegments) · `number` · Optional
+- [`minorSegments`](../geometry/TorusOptions.md#minorsegments) · `number` · Optional
 
   Exact segment count around the swept profile; omitted uses adaptive resolution.
 
-- [`resolution`](TorusOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](../geometry/TorusOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Operation-level physical tessellation policy over the active model-wide policy.
 
@@ -60,11 +60,18 @@ torus({ majorRadius: 12, minorRadius: 3 });
 ## Related APIs
 
 - [Solid](Solid.md)
-- [TorusOptions](TorusOptions.md)
+- [TorusOptions](../geometry/TorusOptions.md)
 
 ## 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)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { torus } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -2,7 +2,7 @@
 
 Hollow +Z tube.
 
-**tube**(`options`: [`TubeOptions`](TubeOptions.md)): [`Solid`](Solid.md)
+**tube**(`options`: [`TubeOptions`](../geometry/TubeOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -20,42 +20,7 @@ tube({ height: 20, outerRadius: 10, innerRadius: 6 });
 
 <a id="options"></a>
 
-**`options`** · [`TubeOptions`](TubeOptions.md) · Required
-
-- [`height`](TubeOptions.md#height) · `number` · Required
-
-  Total height along Z in millimetres.
-
-- [`innerRadius`](TubeOptions.md#innerradius) · `number` · Required
-
-  Positive inner radius in millimetres.
-
-- [`outerRadius`](TubeOptions.md#outerradius) · `number` · Required
-
-  Outer radius in millimetres; greater than [TubeOptions.innerRadius](TubeOptions.md#innerradius).
-
-- [`limits`](TubeOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
-
-  Explicit sampling ceilings; bound modeling operations may only lower the host policy.
-
-- [`segments`](TubeOptions.md#segments) · `number` · Optional
-
-  Exact circumferential segment count from three through the configured safety limit.
-
-  This local topology override takes precedence over [CircularPrimitiveOptions.resolution](CircularPrimitiveOptions.md#resolution)
-  and any active model-wide resolution policy.
-
-- [`resolution`](TubeOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
-
-  Operation-level physical tessellation policy over the active model-wide policy.
-
-- [`attachment`](TubeOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
-
-  Applied after local construction; Section attachment must preserve the XY plane.
-
-- [`center`](TubeOptions.md#center) · `boolean` · Optional · Default: `true`
-
-  Centers the tube on the Z origin when `true`; otherwise its bottom is at `Z = 0`.
+**`options`** · [`TubeOptions`](../geometry/TubeOptions.md) · Required
 
 
 
@@ -67,11 +32,18 @@ tube({ height: 20, outerRadius: 10, innerRadius: 6 });
 ## Related APIs
 
 - [Solid](Solid.md)
-- [TubeOptions](TubeOptions.md)
+- [TubeOptions](../geometry/TubeOptions.md)
 
 ## 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)
+
+## Supported imports
+
+```ts
+import { tube } from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -1,6 +1,6 @@
 # union
 
-Robust union.
+Robust union of one or more shapes; empty input rejects during declaration.
 
 ## Call Signature
 
@@ -22,7 +22,7 @@ union([block, cap]);
 
 
 
-Robust union.
+Robust union of one or more shapes; empty input rejects during declaration.
 
 ### Parameters
 
@@ -67,6 +67,13 @@ Native filled section union; dimensions cannot be mixed.
 ## Guides
 
 - [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)
+- [Primitive booleans and repeated placement](../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
+- [Join an independently modeled feature](../../guides/solid-joins.md#join-an-independently-modeled-feature)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { union } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/model.md

@@ -2,46 +2,37 @@
 
 Immutable shapes, vectors and transforms with fluent operations and host-owned geometry evaluation.
 
-Import `generate`, shape constructors, vectors, transforms and collection functions from `@metamesh/modeling`. Chain shape methods to transform, subtract, and finish immutable recipes; a host session owns execution and optional computed caches.
+Build models from immutable shapes with `@metamesh/modeling`. Import `generate`, shape constructors, vectors, transforms, and collection functions, then chain shape methods to transform, combine, query, and finish recipes. A host session runs the model and manages optional memo caches.
 
 ```ts
 import { box, cylinder, generate } from "@metamesh/modeling";
 import { createModelEngine } from "@metamesh/modeling/engine";
-const model = generate<Record<never, never>>(({ part }) => [part("plate", box({ size: [30, 20, 6] }).subtract([cylinder({ radius: 3, height: 8 })]))]);
+const model = generate<Record<never, never>>(({ part }) => [part("plate", box({ size: [30, 20, 6] }).subtract(cylinder({ radius: 3, height: 8 })))]);
 const engine = await createModelEngine();
-const session = engine.createSession(model);
-const snapshot = session.run({});
-snapshot.dispose();
-session.dispose();
+const result = engine.run(model);
 ```
 
-Computed data and recipes reuse unchanged work. Part placement and color are separate from local geometry. Section recipes preserve holes through Boolean and offset chains.
+Memoized data and recipes let you reuse unchanged work. Keep part placement and color separate from local geometry. Section recipes preserve holes through Boolean and offset chains.
 
 - **Construction:** recipes and composition require no engine. Ordinary recipes can be reused across sessions, wherever constructed.
 - **Resolution:** explicit settings are captured; unspecified settings inherit the evaluating host's defaults.
-- **Observation:** synchronous host execution is required. Observed component selections stay restricted to their originating session.
-- **Ownership:** the current transaction owns temporary native allocations; sessions may retain bounded evaluated geometry privately. Copied snapshots remain valid after session disposal until you dispose them.
+- **Observation:** call `shape.inspect()`, `shape.isEmpty()`, `shape.components()`, or `shape.anchor(name)` during synchronous host execution. Solids also expose `distance`, `castSegment`, `split`, `splitByPlane`, and `toMesh` methods. Observed component selections stay restricted to their originating session.
+- **Ownership:** the current transaction owns temporary native allocations; sessions may keep evaluated geometry in bounded private caches. Both run methods return durable immutable results without disposal; sessions alone own cache and native-resource lifetimes.
 
 See [host lifecycle](engine.md) and [pure foundations](geometry.md).
 
 ## Categories
 
-- [Primitives](model/categories/primitives.md) — Create foundational solid geometry and configure its dimensions and tessellation.
-- [Local resolution](model/categories/resolution.md) — Choose physical curve sampling and explicit native tolerance.
+- [Primitives](model/categories/primitives.md) — Create basic solids with explicit dimensions and tessellation.
 - [2D sections](model/categories/sections.md) — Create immutable filled XY shapes, including prepared text and bounded painted SVG.
-- [Sampled paths](model/categories/paths.md) — Reusable immutable planar and spatial trajectories.
 - [Boolean operations](model/categories/boolean-operations.md) — Combine, intersect and subtract same-dimensional shapes; construct solid envelopes and sums.
-- [Transforms, vectors, and placement](model/categories/transforms-placement.md) — Calculate with immutable vectors, reuse transforms, and arrange geometry with explicit placement contracts.
+- [Transforms, vectors, and placement](model/categories/transforms-placement.md) — Calculate with immutable vectors, reuse transforms, and position geometry.
 - [Extrude, revolve, and sweep](model/categories/extrude-revolve-sweep.md) — Turn sections and paths into extruded, lofted, revolved, or swept solids.
 - [Knuckle joints](model/categories/hinges.md) — Compose reusable knuckle joints with independent mounting attachments.
 - [Printable threads](model/categories/threads.md) — Construct compensated thread forms and inspect bounded preflight facts.
-- [Mesh and inspection](model/categories/mesh-inspection.md) — Convert validated meshes and inspect stable section or solid measurements.
-- [Core values](model/categories/core-values-errors.md) — Use shared coordinate, path, polygon, and bounds data.
-- [Bounds](model/categories/bounds.md) — Measure immutable axis-aligned extents and test positioned containment.
+- [Mesh and inspection](model/categories/mesh-inspection.md) — Convert validated meshes and read stable section or solid measurements.
 - [Explicit matching profiles](model/categories/explicit-profiles.md) — Build hollow or multicomponent lofts and sweeps using stable landmarks.
 - [Sampled surfaces](model/categories/bounded-surfaces.md) — Construct bounded heightfields and positive-inside implicit fields.
-- [Solid inspection](model/categories/inspection.md) — Evaluate recipes and copy observations while the host owns native resources.
-- [Model generation](model/categories/generation.md) — Declare typed programs, optional computations, semantic parts and structured diagnostics.
-- [Model contracts](model/categories/contracts.md) — Describe opaque handles, dimensions, manufacturing parts, and completed snapshots.
+- [Model generation](model/categories/generation.md) — Build typed models with optional cached computations, named parts, and structured warnings or errors.
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/text/MAX_VECTOR_FONT_BYTES.md

@@ -1,7 +1,13 @@
 # MAX_VECTOR_FONT_BYTES
 
-Limits apply before parsing or shaping untrusted font data.
+Maximum input font size in bytes, checked before parsing or shaping untrusted font data.
 
 `const` **MAX\_VECTOR\_FONT\_BYTES**: `number`
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { MAX_VECTOR_FONT_BYTES } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.19.0`.