@metamesh/modeling 0.19.0 → 0.20.0

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

@@ -0,0 +1,91 @@
+# edgeCutter
+
+Creates a cutter for one straight convex edge along +Z, with its sharp reference at XY=0. Position it explicitly before subtraction; the included material angle defaults to 90 degrees.
+
+**edgeCutter**(`options`: [`EdgeCutterOptions`](EdgeCutterOptions.md)): [`Solid`](Solid.md)
+
+
+
+## Example: Amber cutter · Blue rounded edge
+
+
+
+```ts
+import { box, edgeCutter, generate } from "@metamesh/modeling";
+import { transform3 } from "@metamesh/modeling/geometry";
+
+const cutter = edgeCutter({ length: 18, treatment: { kind: "round", radius: 6 }, excess: 0 });
+const result = box({ size: 18, center: false }).subtract(cutter);
+// Turn the concave mask and convex result toward the viewer independently.
+export default generate(({ part }) => [
+  part("cutter", { geometry: cutter.translate([-3, -3, 0]).rotate([0, 0, -90]), color: "#f6ad55", transform: transform3().translate([-11, -11, 0]) }),
+  part("result", { geometry: result.translate([-9, -9, 0]).rotate([0, 0, 90]), color: "#4f83a6", transform: transform3().translate([11, 11, 0]) }),
+]);
+```
+
+
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`EdgeCutterOptions`](EdgeCutterOptions.md) · Required
+
+- [`length`](EdgeCutterOptions.md#length) · `number` · Required
+
+  Positive nominal edge length along +Z from Z=0, in millimetres.
+
+- [`treatment`](EdgeCutterOptions.md#treatment) · [`EdgeTreatment`](../geometry/EdgeTreatment.md) · Required
+
+  Profile from the first material face to the second; uses the shared surface-setback vocabulary.
+
+- [`angle`](EdgeCutterOptions.md#angle) · `number` · Optional
+
+  Material angle counterclockwise from +X toward +Y, strictly between 0° and 180°; defaults to 90°.
+
+- [`excess`](EdgeCutterOptions.md#excess) · `number` · Optional
+
+  Numerical extension outside the two material faces, in millimetres; defaults to 0.05. Does not change the treatment.
+
+- [`overrun`](EdgeCutterOptions.md#overrun) · [`CutterOverrun`](CutterOverrun.md) · Optional
+
+  Numerical longitudinal extension; both ends default to zero.
+
+- [`resolution`](EdgeCutterOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+
+  Physical curve sampling; explicit treatment sampling overrides these defaults.
+
+- [`limits`](EdgeCutterOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+
+  Local allocation ceilings may only lower the evaluating host's limits.
+
+- [`attachment`](EdgeCutterOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
+
+  Applied after local construction; Section attachment must preserve the XY plane.
+
+
+
+## Returns
+
+[`Solid`](Solid.md)
+
+
+## Related APIs
+
+- [EdgeCutterOptions](EdgeCutterOptions.md)
+- [Solid](Solid.md)
+
+## Guides
+
+- [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)
+
+## Import
+
+```ts
+import { edgeCutter } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -8,10 +8,14 @@ Centered elliptical section.
 
 ## Example: Ellipse by full dimensions
 
+
+
 ```ts
-ellipse({ size: [30, 20] });
+ellipse({ size: [30, 20] }).extrude({ height: 3 });
 ```
 
+
+
 ## Parameters
 
 <a id="options"></a>
@@ -36,10 +40,10 @@ ellipse({ size: [30, 20] });
 - [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)
 
-## Supported imports
+## Import
 
 ```ts
 import { ellipse } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,63 +2,69 @@
 
 Extrudes a filled Section or explicit corresponding contours along +Z with degree twist and top scaling. Use `section.extrude(options)` in fluent sequences, or this function for generic profile inputs.
 
-**extrude**(`shape`: [`Section`](Section.md) \| [`CorrespondingProfile`](../geometry/CorrespondingProfile.md), `options`: [`ExtrudeOptions`](../geometry/ExtrudeOptions.md)): [`Solid`](Solid.md)
+**extrude**(`shape`: [`Section`](Section.md) \| [`CorrespondingProfile`](../geometry/CorrespondingProfile.md), `options`: [`ExtrudeOptions`](ExtrudeOptions.md)): [`Solid`](Solid.md)
 
 
 
 ## Example: Extrude
 
+
+
 ```ts
-import { extrude, matchProfiles } from "@metamesh/modeling";
-import { rectangleProfile } from "@metamesh/modeling/geometry";
+import { extrude } from "@metamesh/modeling";
+import { matchProfiles, rectangleProfile } from "@metamesh/modeling/geometry";
 
 const [profile] = matchProfiles([rectangleProfile({ size: [30, 20] })]);
 extrude(profile!, { height: 8 });
 ```
 
+
+
 ## Parameters
 
 <a id="shape"></a>
 
 **`shape`** · [`Section`](Section.md) \| [`CorrespondingProfile`](../geometry/CorrespondingProfile.md) · Required
 
+Filled XY profile in millimetres.
+
 
 
 <a id="options"></a>
 
-**`options`** · [`ExtrudeOptions`](../geometry/ExtrudeOptions.md) · Required
+**`options`** · [`ExtrudeOptions`](ExtrudeOptions.md) · Required
 
-- [`height`](../geometry/ExtrudeOptions.md#height) · `number` · Required
+- [`height`](ExtrudeOptions.md#height) · `number` · Required
 
   Positive extrusion height in millimetres.
 
-- [`center`](../geometry/ExtrudeOptions.md#center) · `boolean` · Optional
+- [`slices`](ExtrudeOptions.md#slices) · `number` · Optional
 
-  Center the extrusion on Z; otherwise its bottom is at zero. Defaults to false.
+  Positive longitudinal interval count; n slices create n + 1 profile layers. Overrides ordinary extrusion's physical sampling.
 
-- [`ends`](../geometry/ExtrudeOptions.md#ends) · [`EndTreatments`](../geometry/EndTreatments.md) · Optional
+- [`limits`](ExtrudeOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
-  Independent inward treatments on every material rim of a straight, topology-preserving extrusion.
+  Explicit output and sampling allocation ceilings.
 
-- [`divisions`](../geometry/ExtrudeOptions.md#divisions) · `number` · Optional
+- [`resolution`](ExtrudeOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
-  Exact number of intermediate profiles, nonnegative; overrides physical sampling.
+  Operation-level physical policy over the nearest model scope.
 
-- [`limits`](../geometry/ExtrudeOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`scale`](ExtrudeOptions.md#scale) · `number` \| [`Vector2Input`](../geometry/Vector2Input.md) · Optional
 
-  Explicit output and sampling allocation ceilings.
+  Final profile-local uniform or XY scale, interpolated from one before twisting. Both components must be positive or both zero for an apex of one simple boundary. Defaults to one.
 
-- [`resolution`](../geometry/ExtrudeOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`twist`](ExtrudeOptions.md#twist) · `number` · Optional
 
-  Operation-level physical policy over the nearest model scope.
+  Finite rotation of the top profile about +Z, in degrees; defaults to zero.
 
-- [`scaleTop`](../geometry/ExtrudeOptions.md#scaletop) · `number` \| [`Vector2Input`](../geometry/Vector2Input.md) · Optional
+- [`ends`](ExtrudeOptions.md#ends) · [`EndTreatments`](EndTreatments.md) · Optional
 
-  Finite uniform or XY scale of the top profile; defaults to one.
+  Independent inward treatments on every material rim. Twisted extrusions admit chamfers with cap and normal-section wall setbacks; other treatments require zero twist. Enabled treatments require unit scale and preserve boundary topology. The base slices grid is retained, with additional treatment/refinement rings where necessary.
 
-- [`twist`](../geometry/ExtrudeOptions.md#twist) · `number` · Optional
+- [`center`](ExtrudeOptions.md#center) · `boolean` · Optional
 
-  Finite rotation of the top profile about +Z, in degrees; defaults to zero.
+  Center the extrusion on Z; otherwise its bottom is at zero. Defaults to false.
 
 
 
@@ -69,23 +75,23 @@ extrude(profile!, { height: 8 });
 
 ## Related APIs
 
-- [CorrespondingProfile](../geometry/CorrespondingProfile.md)
-- [ExtrudeOptions](../geometry/ExtrudeOptions.md)
+- [ExtrudeOptions](ExtrudeOptions.md)
 - [Section](Section.md)
 - [Solid](Solid.md)
 
 ## Guides
 
 - [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)
 
-## Supported imports
+## Import
 
 ```ts
 import { extrude } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -31,6 +31,8 @@ const model = generate<{ height: number }>(({ params, part, assert }) => {
 
 **`callback`** · [`GenerateCallback`](GenerateCallback.md)\<`P`, `S`\> · Required
 
+Synchronous callback returning one part or a readonly part array.
+
 
 
 ## Returns
@@ -47,10 +49,10 @@ const model = generate<{ height: number }>(({ params, part, assert }) => {
 
 - [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
 
-## Supported imports
+## Import
 
 ```ts
 import { generate } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -12,10 +12,14 @@ XY or XYZ copies, optionally centered or placed in an explicit frame.
 
 ## Example: Centered XY grid
 
+
+
 ```ts
 gridPattern(box({ size: 4 }), { count: [3, 2], spacing: [10, 10], center: true });
 ```
 
+
+
 XY or XYZ copies, optionally centered or placed in an explicit frame.
 
 ### Parameters
@@ -24,6 +28,8 @@ XY or XYZ copies, optionally centered or placed in an explicit frame.
 
 **`source`** · [`PatternSource`](PatternSource.md) · Required
 
+Recipe or factory called once per copy, in zero-based order.
+
 
 
 <a id="options"></a>
@@ -52,6 +58,8 @@ Repeats a filled Section on an XY grid; any explicit frame must preserve the XY
 
 **`source`** · [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\> · Required
 
+Recipe or factory called once per copy, in zero-based order.
+
 
 
 <a id="options-1"></a>
@@ -67,7 +75,6 @@ readonly [`Section`](Section.md)[]
 
 ## Related APIs
 
-- [GridPatternOptions](../geometry/GridPatternOptions.md)
 - [PatternSource](PatternSource.md)
 - [Section](Section.md)
 - [Solid](Solid.md)
@@ -76,12 +83,12 @@ readonly [`Section`](Section.md)[]
 
 - [Named anchors and custom frames](../../guides/transforms-and-placement.md#named-anchors-and-custom-frames)
 - [Primitive booleans and repeated placement](../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
-- [Fluent values and standalone algorithms](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
+- [Fluent values and standalone algorithms](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-## Supported imports
+## Import
 
 ```ts
 import { gridPattern } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,7 +2,7 @@
 
 Closed rectilinear top above a flat base, with uniform or explicit XY coordinates.
 
-**heightfield**(`options`: [`HeightfieldOptions`](../geometry/HeightfieldOptions.md)): [`Solid`](Solid.md)
+**heightfield**(`options`: [`HeightfieldOptions`](HeightfieldOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -26,7 +26,7 @@ The retained callback must capture independent immutable inputs, not live sessio
 
 <a id="options"></a>
 
-**`options`** · [`HeightfieldOptions`](../geometry/HeightfieldOptions.md) · Required
+**`options`** · [`HeightfieldOptions`](HeightfieldOptions.md) · Required
 
 
 
@@ -37,13 +37,13 @@ The retained callback must capture independent immutable inputs, not live sessio
 
 ## Related APIs
 
-- [HeightfieldOptions](../geometry/HeightfieldOptions.md)
+- [HeightfieldOptions](HeightfieldOptions.md)
 - [Solid](Solid.md)
 
-## Supported imports
+## Import
 
 ```ts
 import { heightfield } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -1,20 +1,32 @@
 # holeCutter
 
-Declares a +Z hole or blind-pocket cutter with explicit end overrun in millimetres.
+Declares a +Z hole or blind-pocket cutter with independent opening treatments.
 
 **holeCutter**(`options`: [`HoleCutterOptions`](HoleCutterOptions.md)): [`Solid`](Solid.md)
 
 
 
-## Example: A blind hex pocket with an open top
+## Example: Amber cutter · Blue blind hex pocket
 
 
 
 ```ts
-holeCutter({
-  profile: regularPolygon({ sides: 6, radius: 3.5, sizing: "face", rotation: 30 }),
-  height: 12, entryChamfer: 0.5, overrun: { top: 0.05 },
+import { box, generate, holeCutter, regularPolygon } from "@metamesh/modeling";
+import { transform3 } from "@metamesh/modeling/geometry";
+
+const cutter = holeCutter({
+  profile: regularPolygon({ sides: 6, radius: 5, sizing: "face", rotation: 30 }),
+  height: 5,
+  openings: { top: { kind: "chamfer", distance: 1.5 } },
+  overrun: { top: 0.05 },
 });
+// A 3 mm floor remains beneath the pocket. Display the cutter separately on the left.
+const stock = box({ size: [22, 20, 8] }).translate([0, 0, 4]);
+const result = stock.subtract(cutter.translate([0, 0, 3]));
+export default generate(({ part }) => [
+  part("cutter", { geometry: cutter, color: "#f6ad55", transform: transform3().translate([-12, -12, 0]) }),
+  part("result", { geometry: result, color: "#4f83a6", transform: transform3().translate([12, 12, 0]) }),
+]);
 ```
 
 
@@ -33,11 +45,12 @@ holeCutter({
 
 ## Remarks
 
-Choose exactly one circular diameter or existing Section. A 45-degree entry chamfer
-supports one strictly convex contour without holes; plain profiles may have any topology.
-Circular entries retain nominal frustum radii; profile entries offset the supplied polygon edges.
-Circular head recesses are mutually exclusive with entryChamfer. Both overrun ends default
-to zero, so the nominal bottom remains at Z=0 and blind pocket floors are preserved.
+Choose exactly one circular diameter or existing Section. Finished profiles require one
+strictly convex contour without holes; plain profiles may have any topology. Opening treatments
+widen the mouth while retaining a positive nominal throat. Circular openings also admit
+counterbores and countersinks. An omitted opening leaves that end unchanged.
+Overrun extends each terminal cross section outside Z=0..height; both ends default to zero,
+preserving blind-pocket floors. It is independent of manufacturing clearance.
 Existing Section samples are authoritative; limits and unspecified circular sampling belong
 to the evaluating host.
 
@@ -52,11 +65,12 @@ to the evaluating host.
 - [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)
 
-## Supported imports
+## Import
 
 ```ts
 import { holeCutter } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -72,10 +72,10 @@ Convex filled XY hull of finite points or filled section recipes.
 - [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)
 
-## Supported imports
+## Import
 
 ```ts
 import { hull } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -14,7 +14,7 @@ Bounded positive-inside implicit field constructor. The retained callback must c
 
 - [`field`](ImplicitOptions.md#field) · (`point`: [`Vector3Data`](../geometry/Vector3Data.md)) => `number` · Required
 
-  Positive-inside scalar field evaluated at finite XYZ points.
+  Positive-inside scalar field evaluated at finite XYZ points in millimetres.
 
 - [`bounds`](ImplicitOptions.md#bounds) · [`Bounds3Data`](../geometry/Bounds3Data.md) · Required
 
@@ -44,10 +44,10 @@ Bounded positive-inside implicit field constructor. The retained callback must c
 - [ImplicitOptions](ImplicitOptions.md)
 - [Solid](Solid.md)
 
-## Supported imports
+## Import
 
 ```ts
 import { implicit } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,74 +2,86 @@
 
 Compensated internal threaded cutter.
 
-**internalThreadCutter**(`options`: [`InternalThreadCutterOptions`](../geometry/InternalThreadCutterOptions.md)): [`Solid`](Solid.md)
+**internalThreadCutter**(`options`: [`InternalThreadCutterOptions`](../mechanical/InternalThreadCutterOptions.md)): [`Solid`](Solid.md)
 
 
 
-## Example: Internal thread
+## Example: Amber thread cutter · Blue cutaway result
+
+
 
 ```ts
-import { cylinder, internalThreadCutter } from "@metamesh/modeling";
-import { threadProfile } from "@metamesh/modeling/geometry";
+import { box, cylinder, generate, internalThreadCutter } from "@metamesh/modeling";
+import { transform3 } from "@metamesh/modeling/geometry";
+import { threadProfile } from "@metamesh/modeling/geometry/mechanical";
+
 const profile = threadProfile({ kind: "triangular", pitch: 1.75 });
 const body = cylinder({ diameter: 20, height: 12, center: false });
 const cutter = internalThreadCutter({ nominalMajorDiameter: 12, length: 12, profile });
-body.subtract([cutter]);
+// Remove the front quarter of the stock to expose the actual internal thread.
+const cutaway = box({ size: [11, 11, 14], center: false }).translate([0, -11, -1]);
+const result = body.subtract([cutter, cutaway]);
+export default generate(({ part }) => [
+  part("cutter", { geometry: cutter, color: "#f6ad55", transform: transform3().translate([-12, -12, 0]) }),
+  part("result", { geometry: result, color: "#4f83a6", transform: transform3().translate([12, 12, 0]) }),
+]);
 ```
 
+
+
 ## Parameters
 
 <a id="options"></a>
 
-**`options`** · [`InternalThreadCutterOptions`](../geometry/InternalThreadCutterOptions.md) · Required
+**`options`** · [`InternalThreadCutterOptions`](../mechanical/InternalThreadCutterOptions.md) · Required
 
-- [`nominalMajorDiameter`](../geometry/InternalThreadCutterOptions.md#nominalmajordiameter) · `number` · Required
+- [`nominalMajorDiameter`](../mechanical/InternalThreadCutterOptions.md#nominalmajordiameter) · `number` · Required
 
   Nominal major diameter before female compensation and faceting correction.
 
-- [`length`](../geometry/InternalThreadCutterOptions.md#length) · `number` · Required
+- [`length`](../mechanical/InternalThreadCutterOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
 
-- [`profile`](../geometry/InternalThreadCutterOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
+- [`profile`](../mechanical/InternalThreadCutterOptions.md#profile) · [`ThreadProfile`](../mechanical/ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
-- [`fit`](../geometry/InternalThreadCutterOptions.md#fit) · [`PrintableThreadFit`](../geometry/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../geometry/PrintableThreadFitPolicy.md) · Optional
+- [`fit`](../mechanical/InternalThreadCutterOptions.md#fit) · [`PrintableThreadFit`](../mechanical/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../mechanical/PrintableThreadFitPolicy.md) · Optional
 
   Printable fit or caller-calibrated allowances. Default: `normal`.
 
-- [`bevel`](../geometry/InternalThreadCutterOptions.md#bevel) · [`Bevel`](../geometry/Bevel.md) · Optional
+- [`bevel`](../mechanical/InternalThreadCutterOptions.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.
 
-- [`ends`](../geometry/InternalThreadCutterOptions.md#ends) · [`ThreadEndTreatmentOptions`](../geometry/ThreadEndTreatmentOptions.md) · Optional
+- [`ends`](../mechanical/InternalThreadCutterOptions.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`](../geometry/InternalThreadCutterOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
+- [`handedness`](../mechanical/InternalThreadCutterOptions.md#handedness) · [`ThreadHandedness`](../mechanical/ThreadHandedness.md) · Optional
 
   Helix direction. Default: `right`.
 
-- [`limits`](../geometry/InternalThreadCutterOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`limits`](../mechanical/InternalThreadCutterOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and circular allocation ceilings.
 
-- [`phase`](../geometry/InternalThreadCutterOptions.md#phase) · `number` · Optional
+- [`phase`](../mechanical/InternalThreadCutterOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
-- [`resolution`](../geometry/InternalThreadCutterOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](../mechanical/InternalThreadCutterOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Optional circular-resolution policy.
 
-- [`starts`](../geometry/InternalThreadCutterOptions.md#starts) · `number` · Optional
+- [`starts`](../mechanical/InternalThreadCutterOptions.md#starts) · `number` · Optional
 
   Number of evenly phased starts. Default: `1`.
 
-- [`tolerance`](../geometry/InternalThreadCutterOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../mechanical/InternalThreadCutterOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Optional numerical tolerance overrides.
 
@@ -82,7 +94,6 @@ body.subtract([cutter]);
 
 ## Related APIs
 
-- [InternalThreadCutterOptions](../geometry/InternalThreadCutterOptions.md)
 - [Solid](Solid.md)
 
 ## Guides
@@ -90,10 +101,10 @@ body.subtract([cutter]);
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 - [Preflight guarantees and host settings](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import { internalThreadCutter } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -28,6 +28,8 @@ Robust intersection of one or more shapes; empty input rejects during declaratio
 
 **`solids`** · readonly [`Solid`](Solid.md)[] · Required
 
+Operands in shared modeling coordinates.
+
 
 
 ### Returns
@@ -42,7 +44,7 @@ Robust intersection of one or more shapes; empty input rejects during declaratio
 
 
 
-Native filled section intersection; dimensions cannot be mixed.
+Filled Section intersection; dimensions cannot be mixed.
 
 ### Parameters
 
@@ -50,6 +52,8 @@ Native filled section intersection; dimensions cannot be mixed.
 
 **`sections`** · readonly [`Section`](Section.md)[] · Required
 
+Operands in shared XY coordinates.
+
 
 
 ### Returns
@@ -68,10 +72,10 @@ Native filled section intersection; dimensions cannot be mixed.
 - [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)
 
-## Supported imports
+## Import
 
 ```ts
 import { intersect } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -31,12 +31,16 @@ This operation promises neither a circular radius, a constant bevel angle, nor g
 
 **`base`** · [`Solid`](Solid.md) · Required
 
+Support solid in shared modeling coordinates.
+
 
 
 <a id="feature"></a>
 
 **`feature`** · [`Solid`](Solid.md) · Required
 
+Positioned feature that owns the source datum.
+
 
 
 <a id="options"></a>
@@ -80,10 +84,10 @@ This operation promises neither a circular radius, a constant bevel angle, nor g
 - [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)
 
-## Supported imports
+## Import
 
 ```ts
 import { join } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.