@metamesh/modeling 0.19.0 → 0.20.0

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

@@ -1,8 +1,12 @@
 # sweep
 
-Sweeps one explicitly ordered point loop, with caps or a geometrically matching closed seam.
+Sweeps one ordered point loop along a path or explicit affine placements. Path mode computes orientation and deformation, automatically matching compatible closed seams. Transform mode connects only the supplied stations, preserving profile indices without refinement.
 
-**sweep**(`profile`: [`Path2Input`](../geometry/Path2Input.md), `path`: [`Path3Input`](../geometry/Path3Input.md), `options?`: [`SweepOptions`](../geometry/SweepOptions.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+## Call Signature
+
+
+
+**sweep**(`profile`: [`Path2Input`](../geometry/Path2Input.md), `path`: [`Path3Input`](../geometry/Path3Input.md), `options?`: [`SweepOptions`](../model/SweepOptions.md)): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -15,78 +19,145 @@ mesh.sweep(profile, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 });
 ```
 
-## Parameters
+Sweeps one ordered point loop along a path or explicit affine placements.
+Path mode computes orientation and deformation, automatically matching compatible closed seams.
+Transform mode connects only the supplied stations, preserving profile indices without refinement.
+
+### Parameters
 
 <a id="profile"></a>
 
 **`profile`** · [`Path2Input`](../geometry/Path2Input.md) · Required
 
+Closed XY path or simple contour, in millimetres.
+
 
 
 <a id="path"></a>
 
 **`path`** · [`Path3Input`](../geometry/Path3Input.md) · Required
 
+Ordered XYZ path in millimetres; a Path3 supplies its closure.
+
 
 
 <a id="options"></a>
 
-**`options`** · [`SweepOptions`](../geometry/SweepOptions.md) · Optional
+**`options`** · [`SweepOptions`](../model/SweepOptions.md) · Optional
 
-- [`closed`](../geometry/SweepOptions.md#closed) · `boolean` · Optional
+- [`closed`](../model/SweepOptions.md#closed) · `boolean` · Optional
 
   Raw point closure defaults to false; a Path3 supplies its closure and rejects conflicts.
 
-- [`limits`](../geometry/SweepOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`limits`](../model/SweepOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and sampling allocation ceilings.
 
-- [`orientation`](../geometry/SweepOptions.md#orientation) · [`SweepOrientation`](../geometry/SweepOrientation.md) · Optional
+- [`orientation`](../model/SweepOptions.md#orientation) · [`SweepOrientation`](../model/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`](../geometry/SweepOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](../model/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`](../geometry/SweepOptions.md#twist) · `number` · Optional
+- [`twist`](../model/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`](../geometry/SweepOptions.md#twistby) · `"length"` \| `"stations"` · Optional
+- [`twistBy`](../model/SweepOptions.md#twistby) · `"length"` \| `"stations"` · Optional
 
   Twist advances by physical path length (default), or normalized authored station position, including a closed seam gap.
 
-- [`scale`](../geometry/SweepOptions.md#scale) · `number` \| [`Vector2Input`](../geometry/Vector2Input.md) \| readonly [`Vector2Input`](../geometry/Vector2Input.md)[] · Optional
+- [`scale`](../model/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
+
+[`TriangleMesh`](TriangleMesh.md)
+
+## Call Signature
+
+
+
+**sweep**(`profile`: [`Path2Input`](../geometry/Path2Input.md), `transforms`: readonly [`Transform3Input`](../geometry/Transform3Input.md)[], `options?`: [`SweepTransformOptions`](../model/SweepTransformOptions.md)): [`TriangleMesh`](TriangleMesh.md)
+
+
+
+Connects one point loop through exactly the supplied affine placements.
+
+### Parameters
+
+<a id="profile-1"></a>
+
+**`profile`** · [`Path2Input`](../geometry/Path2Input.md) · Required
+
+Closed XY path or simple contour, in millimetres.
+
+
+
+<a id="transforms"></a>
+
+**`transforms`** · readonly [`Transform3Input`](../geometry/Transform3Input.md)[] · Required
+
+Affine placements in connection order; at least two when open, three when closed.
+
+
+
+<a id="options-1"></a>
+
+**`options`** · [`SweepTransformOptions`](../model/SweepTransformOptions.md) · Optional
+
+- [`closed`](../model/SweepTransformOptions.md#closed) · `boolean` · Optional
+
+  Connect the last supplied station to the first without caps. Defaults to false.
+
+- [`limits`](../model/SweepTransformOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+
+  Explicit output and station allocation ceilings.
+
+- [`orientation`](../model/SweepTransformOptions.md#orientation) · `undefined` · Optional
+
+  Encoded by the explicit transforms.
+
+- [`resolution`](../model/SweepTransformOptions.md#resolution) · `undefined` · Optional
+
+  Explicit stations are never refined.
+
+- [`twist`](../model/SweepTransformOptions.md#twist) · `undefined` · Optional
+
+  Encoded by the explicit transforms.
+
+- [`twistBy`](../model/SweepTransformOptions.md#twistby) · `undefined` · Optional
 
-  Positive uniform/XY scale, or one XY pair per path station. Defaults to one.
+  Encoded by the explicit transforms.
 
-- [`seamProfileOffset`](../geometry/SweepOptions.md#seamprofileoffset) · `number` · Optional
+- [`scale`](../model/SweepTransformOptions.md#scale) · `undefined` · Optional
 
-  Corresponding point-index advance at a rotationally equivalent closed seam.
+  Encoded by the explicit transforms.
 
 
 
-## Returns
+### Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 
 ## Related APIs
 
-- [Path2Input](../geometry/Path2Input.md)
-- [Path3Input](../geometry/Path3Input.md)
-- [SweepOptions](../geometry/SweepOptions.md)
-- [TriangleMesh](../geometry/TriangleMesh.md)
+- [TriangleMesh](TriangleMesh.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,7 +2,7 @@
 
 Builds closed thread-ridge components with every profile locked to the shaft's radial/axial frame. The mesh is intended for union with its minor-envelope cylinder and never owns WASM objects.
 
-**threadRidge**(`options`: [`ThreadRidgeOptions`](../geometry/ThreadRidgeOptions.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+**threadRidge**(`options`: [`ThreadRidgeOptions`](../mechanical/ThreadRidgeOptions.md)): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -10,46 +10,48 @@ Builds closed thread-ridge components with every profile locked to the shaft's r
 
 <a id="options"></a>
 
-**`options`** · [`ThreadRidgeOptions`](../geometry/ThreadRidgeOptions.md) · Required
+**`options`** · [`ThreadRidgeOptions`](../mechanical/ThreadRidgeOptions.md) · Required
 
-- [`length`](../geometry/ThreadRidgeOptions.md#length) · `number` · Required
+Dimensions in millimetres and a validated profile; apply any fit compensation first.
+
+- [`length`](../mechanical/ThreadRidgeOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
 
-- [`majorDiameter`](../geometry/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`](../geometry/ThreadRidgeOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
+- [`profile`](../mechanical/ThreadRidgeOptions.md#profile) · [`ThreadProfile`](../mechanical/ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
-- [`ends`](../geometry/ThreadRidgeOptions.md#ends) · [`ThreadEndTreatmentOptions`](../geometry/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`](../geometry/ThreadRidgeOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
+- [`handedness`](../mechanical/ThreadRidgeOptions.md#handedness) · [`ThreadHandedness`](../mechanical/ThreadHandedness.md) · Optional
 
   Helix direction. Default: `right`.
 
-- [`limits`](../geometry/ThreadRidgeOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`limits`](../mechanical/ThreadRidgeOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and circular allocation ceilings.
 
-- [`phase`](../geometry/ThreadRidgeOptions.md#phase) · `number` · Optional
+- [`phase`](../mechanical/ThreadRidgeOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
-- [`resolution`](../geometry/ThreadRidgeOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](../mechanical/ThreadRidgeOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Optional circular-resolution policy.
 
-- [`starts`](../geometry/ThreadRidgeOptions.md#starts) · `number` · Optional
+- [`starts`](../mechanical/ThreadRidgeOptions.md#starts) · `number` · Optional
 
   Number of evenly phased starts. Default: `1`.
 
-- [`tolerance`](../geometry/ThreadRidgeOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../mechanical/ThreadRidgeOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Optional numerical tolerance overrides.
 
@@ -57,22 +59,21 @@ Builds closed thread-ridge components with every profile locked to the shaft's r
 
 ## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 
 ## Related APIs
 
-- [ThreadRidgeOptions](../geometry/ThreadRidgeOptions.md)
-- [TriangleMesh](../geometry/TriangleMesh.md)
+- [TriangleMesh](TriangleMesh.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/threadSolid.md

@@ -2,7 +2,7 @@
 
 Builds one closed threaded cylinder without a ridge/core Boolean seam.
 
-**threadSolid**(`options`: [`ThreadSolidOptions`](../geometry/ThreadSolidOptions.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+**threadSolid**(`options`: [`ThreadSolidOptions`](../mechanical/ThreadSolidOptions.md)): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -16,58 +16,60 @@ arrays.
 
 <a id="options"></a>
 
-**`options`** · [`ThreadSolidOptions`](../geometry/ThreadSolidOptions.md) · Required
+**`options`** · [`ThreadSolidOptions`](../mechanical/ThreadSolidOptions.md) · Required
 
-- [`length`](../geometry/ThreadSolidOptions.md#length) · `number` · Required
+Dimensions in millimetres and a validated profile; apply any fit compensation first.
+
+- [`length`](../mechanical/ThreadSolidOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
 
-- [`majorDiameter`](../geometry/ThreadSolidOptions.md#majordiameter) · `number` · Required
+- [`majorDiameter`](../mechanical/ThreadSolidOptions.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`](../geometry/ThreadSolidOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
+- [`profile`](../mechanical/ThreadSolidOptions.md#profile) · [`ThreadProfile`](../mechanical/ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
-- [`ends`](../geometry/ThreadSolidOptions.md#ends) · [`ThreadEndTreatmentOptions`](../geometry/ThreadEndTreatmentOptions.md) · Optional
+- [`ends`](../mechanical/ThreadSolidOptions.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/ThreadSolidOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
+- [`handedness`](../mechanical/ThreadSolidOptions.md#handedness) · [`ThreadHandedness`](../mechanical/ThreadHandedness.md) · Optional
 
   Helix direction. Default: `right`.
 
-- [`limits`](../geometry/ThreadSolidOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`limits`](../mechanical/ThreadSolidOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and circular allocation ceilings.
 
-- [`phase`](../geometry/ThreadSolidOptions.md#phase) · `number` · Optional
+- [`phase`](../mechanical/ThreadSolidOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
-- [`resolution`](../geometry/ThreadSolidOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](../mechanical/ThreadSolidOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Optional circular-resolution policy.
 
-- [`starts`](../geometry/ThreadSolidOptions.md#starts) · `number` · Optional
+- [`starts`](../mechanical/ThreadSolidOptions.md#starts) · `number` · Optional
 
   Number of evenly phased starts. Default: `1`.
 
-- [`tolerance`](../geometry/ThreadSolidOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../mechanical/ThreadSolidOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Optional numerical tolerance overrides.
 
-- [`bevel`](../geometry/ThreadSolidOptions.md#bevel) · [`Bevel`](../geometry/Bevel.md) · Optional
+- [`bevel`](../mechanical/ThreadSolidOptions.md#bevel) · [`Bevel`](../mechanical/Bevel.md) · Optional
 
   Independent 45-degree bottom/top bevels; omitted disables both. Auto uses profile depth.
 
-- [`bevelOffset`](../geometry/ThreadSolidOptions.md#beveloffset) · `number` · Optional
+- [`bevelOffset`](../mechanical/ThreadSolidOptions.md#beveloffset) · `number` · Optional
 
-  Distance of each bevel target face inward from the corresponding mesh end.
+  Distance in millimetres of each bevel target face inward from the corresponding mesh end.
 
-- [`bevelMode`](../geometry/ThreadSolidOptions.md#bevelmode) · `"inset"` \| `"outset"` · Optional
+- [`bevelMode`](../mechanical/ThreadSolidOptions.md#bevelmode) · `"inset"` \| `"outset"` · Optional
 
   `inset` trims an external rod; `outset` expands an internal cutter.
 
@@ -75,22 +77,21 @@ arrays.
 
 ## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 
 ## Related APIs
 
-- [ThreadSolidOptions](../geometry/ThreadSolidOptions.md)
-- [TriangleMesh](../geometry/TriangleMesh.md)
+- [TriangleMesh](TriangleMesh.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/transform.md

@@ -2,7 +2,7 @@
 
 Applies an affine transform to a mesh and preserves outward face orientation.
 
-**transform**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `placement`: [`Transform3Input`](../geometry/Transform3Input.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+**transform**(`mesh`: [`TriangleMeshInput`](TriangleMeshInput.md), `placement`: [`Transform3Input`](../geometry/Transform3Input.md)): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -13,7 +13,7 @@ automatically reverses every triangle. Singular transforms are rejected.
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+**`mesh`** · [`TriangleMeshInput`](TriangleMeshInput.md) · Required
 
 Mesh to transform without mutation.
 
@@ -23,31 +23,30 @@ Mesh to transform without mutation.
 
 **`placement`** · [`Transform3Input`](../geometry/Transform3Input.md) · Required
 
-Immutable spatial placement or canonical row-major affine matrix.
+Frame, fluent transform, or row-major affine matrix.
 
 
 
 ## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 A mesh with fresh transformed positions and copied or reversed indices.
 
 
 ## Related APIs
 
-- [Transform3Input](../geometry/Transform3Input.md)
-- [TriangleMesh](../geometry/TriangleMesh.md)
-- [TriangleMeshInput](../geometry/TriangleMeshInput.md)
+- [TriangleMesh](TriangleMesh.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/validate.md

@@ -2,7 +2,7 @@
 
 Validates mesh buffers, indices, triangle area, and optionally closed topology.
 
-**validate**\<`T` *extends* [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)\>(`mesh`: `T`, `options?`: [`TriangleMeshValidationOptions`](../geometry/TriangleMeshValidationOptions.md)): `T`
+**validate**\<`T` *extends* [`TriangleMeshInput`](TriangleMeshInput.md)\>(`mesh`: `T`, `options?`: [`TriangleMeshValidationOptions`](TriangleMeshValidationOptions.md)): `T`
 
 
 
@@ -14,7 +14,7 @@ self-intersections between faces. The mesh is neither mutated nor copied.
 
 ### T
 
-`T` *extends* [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)
+`T` *extends* [`TriangleMeshInput`](TriangleMeshInput.md)
 
 ## Parameters
 
@@ -22,25 +22,25 @@ self-intersections between faces. The mesh is neither mutated nor copied.
 
 **`mesh`** · `T` · Required
 
-Mesh to inspect.
+Raw or captured indexed buffers with complete finite XYZ vertices.
 
 
 
 <a id="options"></a>
 
-**`options`** · [`TriangleMeshValidationOptions`](../geometry/TriangleMeshValidationOptions.md) · Optional
+**`options`** · [`TriangleMeshValidationOptions`](TriangleMeshValidationOptions.md) · Optional
 
 Empty-mesh, topology, and tolerance policy.
 
-- [`allowEmpty`](../geometry/TriangleMeshValidationOptions.md#allowempty) · `boolean` · Optional
+- [`allowEmpty`](TriangleMeshValidationOptions.md#allowempty) · `boolean` · Optional
 
   Permit an empty position and index buffer. Defaults to `false`.
 
-- [`requireClosed`](../geometry/TriangleMeshValidationOptions.md#requireclosed) · `boolean` · Optional
+- [`requireClosed`](TriangleMeshValidationOptions.md#requireclosed) · `boolean` · Optional
 
   Require two oppositely wound faces per edge; geometric self-intersections are not detected.
 
-- [`tolerance`](../geometry/TriangleMeshValidationOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+- [`tolerance`](TriangleMeshValidationOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Numeric comparison overrides used for zero-area triangle detection.
 
@@ -59,17 +59,17 @@ The original mesh after successful validation.
 
 ## Related APIs
 
-- [TriangleMeshInput](../geometry/TriangleMeshInput.md)
-- [TriangleMeshValidationOptions](../geometry/TriangleMeshValidationOptions.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
+- [TriangleMeshValidationOptions](TriangleMeshValidationOptions.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/validateSolid.md

@@ -2,7 +2,7 @@
 
 Checks closed indexed topology, triangle intersections, and alternating nested shell orientation.
 
-**validateSolid**\<`T` *extends* [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)\>(`mesh`: `T`, `options?`: [`SolidMeshValidationOptions`](../geometry/SolidMeshValidationOptions.md)): `T`
+**validateSolid**\<`T` *extends* [`TriangleMeshInput`](TriangleMeshInput.md)\>(`mesh`: `T`, `options?`: [`SolidMeshValidationOptions`](SolidMeshValidationOptions.md)): `T`
 
 
 
@@ -18,7 +18,7 @@ Input buffers are freshly inspected and never modified; units are millimetres.
 
 ### T
 
-`T` *extends* [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)
+`T` *extends* [`TriangleMeshInput`](TriangleMeshInput.md)
 
 ## Parameters
 
@@ -32,15 +32,15 @@ Closed triangle mesh to inspect.
 
 <a id="options"></a>
 
-**`options`** · [`SolidMeshValidationOptions`](../geometry/SolidMeshValidationOptions.md) · Optional
+**`options`** · [`SolidMeshValidationOptions`](SolidMeshValidationOptions.md) · Optional
 
-Optional lower work ceiling and numeric comparison policy.
+Lower work limit and tolerance for numeric comparisons.
 
-- [`maxTests`](../geometry/SolidMeshValidationOptions.md#maxtests) · `number` · Optional
+- [`maxTests`](SolidMeshValidationOptions.md#maxtests) · `number` · Optional
 
   Work ceiling for spatial comparisons and containment tests; defaults to 2,000,000 and may only lower it.
 
-- [`tolerance`](../geometry/SolidMeshValidationOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+- [`tolerance`](SolidMeshValidationOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Distance comparison policy in millimetres; near contacts reject conservatively.
 
@@ -55,17 +55,17 @@ The original mesh after every requested check succeeds.
 
 ## Related APIs
 
-- [SolidMeshValidationOptions](../geometry/SolidMeshValidationOptions.md)
-- [TriangleMeshInput](../geometry/TriangleMeshInput.md)
+- [SolidMeshValidationOptions](SolidMeshValidationOptions.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh.md

@@ -2,7 +2,7 @@
 
 Construct, transform, inspect, and process triangle buffers without a native engine.
 
-Use `@metamesh/modeling/geometry/mesh` to construct and process ordinary `TriangleMesh` values. Import the module directly so bundlers can remove unused operations and their dependencies. Mesh option and result types are exported beside their operations; profile helpers and transforms live in `/geometry`.
+Use `@metamesh/modeling/geometry/mesh` to construct and process ordinary `TriangleMesh` values. Import the module directly so bundlers can remove unused operations and their dependencies. Mesh-specific option and result types live in this entry. Shared construction options keep their owning import: `LoftOptions` comes from `@metamesh/modeling`, while `ThreadSolidOptions` comes from `/geometry/mechanical`. Profile helpers and transforms live in `/geometry`.
 
 ```ts
 import { rectangleContour, transform3 } from "@metamesh/modeling/geometry";
@@ -18,4 +18,10 @@ Operations return copied buffers or their documented measurement and processing
 
 - [Mesh operations](mesh/categories/operations.md) — Construct, transform, validate, analyze, and optimize indexed meshes.
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -0,0 +1,23 @@
+# BoxEdge
+
+Box edges use +Z top, +Y front and +X right; vertical names list front/back first.
+
+**BoxEdge** = `"top-front"` \| `"top-back"` \| `"top-left"` \| `"top-right"` \| `"bottom-front"` \| `"bottom-back"` \| `"bottom-left"` \| `"bottom-right"` \| `"front-left"` \| `"front-right"` \| `"back-left"` \| `"back-right"`
+
+
+
+
+## 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 type { BoxEdge } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -0,0 +1,27 @@
+# BoxEdgeSelection
+
+Named individual edges or top/bottom rims and all four vertical edges.
+
+**BoxEdgeSelection** = [`BoxEdge`](BoxEdge.md) \| `"top"` \| `"bottom"` \| `"vertical"`
+
+
+
+
+## Related APIs
+
+- [BoxEdge](BoxEdge.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 type { BoxEdgeSelection } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.