@metamesh/modeling 0.17.0 → 0.18.0

package/dist/docs/reference/{geometry/loftMesh.md → mesh/loft.md}

@@ -1,8 +1,8 @@
-# loftMesh
+# loft
 
 Lofts simple point loops at z heights or explicit right-handed frames, in input order.
 
-**loftMesh**(`stations`: readonly [`LoftMeshStation`](LoftMeshStation.md)[], `options`: [`LoftOptions`](LoftOptions.md)): [`TriangleMesh`](TriangleMesh.md)
+**loft**(`stations`: readonly [`LoftMeshStation`](../geometry/LoftMeshStation.md)[], `options?`: [`LoftOptions`](../geometry/LoftOptions.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
 
 
 
@@ -11,10 +11,10 @@ Lofts simple point loops at z heights or explicit right-handed frames, in input
 ```ts
 const bottom = rectangleContour({ size: [20, 12] });
 const top = rectangleContour({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
-loftMesh([{ profile: bottom, z: 0 }, { profile: top, z: 30 }], { correspondence: "reindex" });
+mesh.loft([{ profile: bottom, z: 0 }, { profile: top, z: 30 }], { correspondence: "reindex" });
 ```
 
-An explicit correspondence method is required. CCW-normalized loops retain their
+Correspondence defaults to direct. CCW-normalized loops retain their
 seam and original vertices; unequal counts gain subdivisions or repeated fan slots.
 Both ends use ear-clipped caps, supporting concave profiles without center fans.
 Intermediate slices interpolate placed world vertices, never frame axes.
@@ -25,35 +25,35 @@ Path2 profiles must be closed; raw point collections are interpreted as closed.
 
 <a id="stations"></a>
 
-**`stations`** · readonly [`LoftMeshStation`](LoftMeshStation.md)[] · Required
+**`stations`** · readonly [`LoftMeshStation`](../geometry/LoftMeshStation.md)[] · Required
 
 
 
 <a id="options"></a>
 
-**`options`** · [`LoftOptions`](LoftOptions.md) · Required
+**`options`** · [`LoftOptions`](../geometry/LoftOptions.md) · Optional
 
-- [`correspondence`](LoftOptions.md#correspondence) · [`LoftCorrespondence`](LoftCorrespondence.md) \| readonly [`LoftCorrespondence`](LoftCorrespondence.md)[] · Optional
+- [`correspondence`](../geometry/LoftOptions.md#correspondence) · [`LoftCorrespondence`](../geometry/LoftCorrespondence.md) \| readonly [`LoftCorrespondence`](../geometry/LoftCorrespondence.md)[] · Optional
 
-  One method or one per consecutive station gap. Omitted preserves known landmarks, including circle/ellipse-to-rectangle corners, or maps other unlike primitive seams directly.
+  One method or one per consecutive station gap. Omitted preserves known primitive landmarks, including circle/ellipse-to-rectangle corners, and otherwise uses direct correspondence with the supplied seams.
 
-- [`distribution`](LoftOptions.md#distribution) · `"perimeter"` \| `"segments"` · Optional
+- [`distribution`](../geometry/LoftOptions.md#distribution) · `"perimeter"` \| `"segments"` · Optional
 
   Extra points follow edge length or distribute equally across existing segments. Defaults to perimeter for direct/reindex, or segments when any distance method is selected; distance methods require segments.
 
-- [`refine`](LoftOptions.md#refine) · `number` \| readonly `number`[] · Optional
+- [`refine`](../geometry/LoftOptions.md#refine) · `number` \| readonly `number`[] · Optional
 
   Positive integer point-density multiplier, uniformly or per input profile. Original vertices are retained. Defaults to one.
 
-- [`slices`](LoftOptions.md#slices) · `number` \| readonly `number`[] · Optional
+- [`slices`](../geometry/LoftOptions.md#slices) · `number` \| readonly `number`[] · Optional
 
   Nonnegative count of world-linearly interpolated profiles, uniformly or per gap. Defaults to zero.
 
-- [`resolution`](LoftOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](../geometry/LoftOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Physical curve policy for retained primitives, and maximum edge length for point data. Exact primitive curve counts take precedence.
 
-- [`limits`](LoftOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+- [`limits`](../geometry/LoftOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and sampling budgets; native operations may only lower host ceilings.
 
@@ -61,7 +61,7 @@ Path2 profiles must be closed; raw point collections are interpreted as closed.
 
 ## Returns
 
-[`TriangleMesh`](TriangleMesh.md)
+[`TriangleMesh`](../geometry/TriangleMesh.md)
 
 
 ## Related APIs
@@ -74,4 +74,4 @@ Path2 profiles must be closed; raw point collections are interpreted as closed.
 
 - [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,96 @@
+# optimizePlanarPatches
+
+Improves pathological planar triangulation with bounded legal diagonal flips.
+
+**optimizePlanarPatches**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `options?`: [`PlanarMeshOptimizationOptions`](../geometry/PlanarMeshOptimizationOptions.md)): [`PlanarMeshOptimizationResult`](../geometry/PlanarMeshOptimizationResult.md)
+
+
+
+The operation changes indices only: it never moves, adds, welds, or removes vertices; never
+crosses a coplanar-patch boundary; and never changes the face count. Each accepted flip improves
+a deterministic ordering of triangle angles, aspect ratio, diagonal locality, and local
+incidence/valence concentration. Unsupported input or a failed final integrity check preserves the
+original raw mesh object. Immutable inputs produce owned raw output buffers, including unchanged
+results. Malformed buffers and the configured analysis complexity limit throw.
+
+## Parameters
+
+<a id="mesh"></a>
+
+**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+
+Closed, consistently wound indexed triangle mesh in arbitrary consistent units.
+
+
+
+<a id="options"></a>
+
+**`options`** · [`PlanarMeshOptimizationOptions`](../geometry/PlanarMeshOptimizationOptions.md) · Optional
+
+Patch eligibility, numeric tolerance, and deterministic work bounds.
+
+- [`maxFlipAttempts`](../geometry/PlanarMeshOptimizationOptions.md#maxflipattempts) · `number` · Optional
+
+  Maximum attempted edge evaluations. By default this is twenty times the initial candidate
+  edge count, capped at `1000000`.
+
+- [`maxEdgeRevisits`](../geometry/PlanarMeshOptimizationOptions.md#maxedgerevisits) · `number` · Optional
+
+  Maximum times one edge may be reconsidered after neighbouring flips. Defaults to `12`.
+
+- [`maxPatchTriangles`](../geometry/PlanarMeshOptimizationOptions.md#maxpatchtriangles) · `number` · Optional
+
+  Maximum triangles allowed in one selected patch. Defaults to `50000`.
+
+- [`maxProcessedTriangles`](../geometry/PlanarMeshOptimizationOptions.md#maxprocessedtriangles) · `number` · Optional
+
+  Maximum cumulative triangles across selected patches. Defaults to `200000`.
+
+- [`minPatchTriangles`](../geometry/PlanarMeshOptimizationOptions.md#minpatchtriangles) · `number` · Optional
+
+  Minimum triangles required before a planar patch is eligible. Defaults to `8`.
+
+- [`triggerMaxAspectRatio`](../geometry/PlanarMeshOptimizationOptions.md#triggermaxaspectratio) · `number` · Optional
+
+  Select patches whose worst normalized aspect ratio exceeds this value. Defaults to `12`.
+
+- [`triggerMaxFanRatio`](../geometry/PlanarMeshOptimizationOptions.md#triggermaxfanratio) · `number` · Optional
+
+  Select patches whose largest per-vertex triangle share exceeds this ratio. Defaults to `0.2`.
+
+- [`triggerMaxVertexTriangleIncidence`](../geometry/PlanarMeshOptimizationOptions.md#triggermaxvertextriangleincidence) · `number` · Optional
+
+  Select patches whose largest vertex triangle incidence exceeds this value. Defaults to `16`.
+
+- [`triggerMinAngleDegrees`](../geometry/PlanarMeshOptimizationOptions.md#triggerminangledegrees) · `number` · Optional
+
+  Select patches whose smallest interior angle is below this many degrees. Defaults to `8`.
+
+- [`maxTriangles`](../geometry/PlanarMeshOptimizationOptions.md#maxtriangles) · `number` · Optional
+
+  Maximum number of triangles inspected. Defaults to `200000`.
+
+- [`tolerance`](../geometry/PlanarMeshOptimizationOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+
+  Numeric comparison overrides; model coordinates are interpreted in their existing units.
+
+
+
+## Returns
+
+[`PlanarMeshOptimizationResult`](../geometry/PlanarMeshOptimizationResult.md)
+
+Optimized connectivity and before/after diagnostics, or an unchanged safe fallback.
+
+
+## Related APIs
+
+- [PlanarMeshOptimizationOptions](PlanarMeshOptimizationOptions.md)
+- [PlanarMeshOptimizationResult](PlanarMeshOptimizationResult.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/{geometry → mesh}/preflightHeightfield.md

@@ -2,7 +2,7 @@
 
 Checks grid options, Float32 axis precision, and output limits; returns exact mesh buffer counts.
 
-**preflightHeightfield**(`options`: [`HeightfieldOptions`](HeightfieldOptions.md), `limits?`: `Partial`\<`Pick`\<[`ModelingLimits`](ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\>): [`HeightfieldPreflight`](HeightfieldPreflight.md)
+**preflightHeightfield**(`options`: [`HeightfieldOptions`](../geometry/HeightfieldOptions.md), `limits?`: `Partial`\<`Pick`\<[`ModelingLimits`](../geometry/ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\>): [`HeightfieldPreflight`](../geometry/HeightfieldPreflight.md)
 
 
 
@@ -14,19 +14,19 @@ construction. `byteCount` covers position and index buffers, not total working m
 
 <a id="options"></a>
 
-**`options`** · [`HeightfieldOptions`](HeightfieldOptions.md) · Required
+**`options`** · [`HeightfieldOptions`](../geometry/HeightfieldOptions.md) · Required
 
 
 
 <a id="limits"></a>
 
-**`limits`** · `Partial`\<`Pick`\<[`ModelingLimits`](ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\> · Optional
+**`limits`** · `Partial`\<`Pick`\<[`ModelingLimits`](../geometry/ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\> · Optional
 
 
 
 ## Returns
 
-[`HeightfieldPreflight`](HeightfieldPreflight.md)
+[`HeightfieldPreflight`](../geometry/HeightfieldPreflight.md)
 
 
 ## Related APIs
@@ -34,10 +34,9 @@ construction. `byteCount` covers position and index buffers, not total working m
 - [HeightfieldOptions](HeightfieldOptions.md)
 - [HeightfieldPreflight](HeightfieldPreflight.md)
 - [ModelingLimits](ModelingLimits.md)
-- [heightfieldMesh](heightfieldMesh.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,90 @@
+# preflightThreadSolid
+
+Checks thread dimensions, profile, end treatments, sampling, and conservative estimates against output limits.
+
+**preflightThreadSolid**(`options`: [`ThreadSolidOptions`](../geometry/ThreadSolidOptions.md)): [`ThreadSolidPreflight`](../geometry/ThreadSolidPreflight.md)
+
+
+
+This pure operation needs no engine and constructs planning data without vertex or index buffers.
+`circularSegments` is the selected count; row and triangle counts are conservative estimates.
+Successful preflight leaves generated coordinate and topology checks to mesh construction.
+
+See `mesh.threadSolid` for standalone mesh construction.
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`ThreadSolidOptions`](../geometry/ThreadSolidOptions.md) · Required
+
+- [`length`](../geometry/ThreadSolidOptions.md#length) · `number` · Required
+
+  Total threaded axial length in millimetres.
+
+- [`majorDiameter`](../geometry/ThreadSolidOptions.md#majordiameter) · `number` · Required
+
+  Nominal major diameter before any caller-owned fit compensation.
+
+- [`profile`](../geometry/ThreadSolidOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
+
+  Validated periodic profile repeated around the shaft.
+
+- [`ends`](../geometry/ThreadSolidOptions.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`](../geometry/ThreadSolidOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
+
+  Helix direction. Default: `right`.
+
+- [`limits`](../geometry/ThreadSolidOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+
+  Explicit output and circular allocation ceilings.
+
+- [`phase`](../geometry/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
+
+  Optional circular-resolution policy.
+
+- [`starts`](../geometry/ThreadSolidOptions.md#starts) · `number` · Optional
+
+  Number of evenly phased starts. Default: `1`.
+
+- [`tolerance`](../geometry/ThreadSolidOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+
+  Optional numerical tolerance overrides.
+
+- [`bevel`](../geometry/ThreadSolidOptions.md#bevel) · [`Bevel`](../geometry/Bevel.md) · Optional
+
+  Independent 45-degree bottom/top bevels; omitted disables both. Auto uses profile depth.
+
+- [`bevelOffset`](../geometry/ThreadSolidOptions.md#beveloffset) · `number` · Optional
+
+  Distance of each bevel target face inward from the corresponding mesh end.
+
+- [`bevelMode`](../geometry/ThreadSolidOptions.md#bevelmode) · `"inset"` \| `"outset"` · Optional
+
+  `inset` trims an external rod; `outset` expands an internal cutter.
+
+
+
+## Returns
+
+[`ThreadSolidPreflight`](../geometry/ThreadSolidPreflight.md)
+
+
+## Related APIs
+
+- [ThreadSolidOptions](ThreadSolidOptions.md)
+- [ThreadSolidPreflight](ThreadSolidPreflight.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/{geometry/reverseTriangleMesh.md → mesh/reverse.md}

@@ -1,8 +1,8 @@
-# reverseTriangleMesh
+# reverse
 
 Returns a copy of a mesh with every triangle winding reversed.
 
-**reverseTriangleMesh**(`mesh`: [`TriangleMesh`](TriangleMesh.md)): [`TriangleMesh`](TriangleMesh.md)
+**reverse**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
 
 
 
@@ -10,7 +10,7 @@ Returns a copy of a mesh with every triangle winding reversed.
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMesh`](TriangleMesh.md) · Required
+**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
 
 Mesh to copy and reverse.
 
@@ -18,7 +18,7 @@ Mesh to copy and reverse.
 
 ## Returns
 
-[`TriangleMesh`](TriangleMesh.md)
+[`TriangleMesh`](../geometry/TriangleMesh.md)
 
 Fresh position and index buffers; the input remains unchanged.
 
@@ -26,9 +26,10 @@ Fresh position and index buffers; the input remains unchanged.
 ## Related APIs
 
 - [TriangleMesh](TriangleMesh.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/{geometry/revolveMesh.md → mesh/revolve.md}

@@ -1,8 +1,8 @@
-# revolveMesh
+# revolve
 
 Revolves a non-duplicated closed `[radius, z]` profile around +Z.
 
-`const` **revolveMesh**: (`input`: [`Path2Input`](Path2Input.md), `options?`: [`RevolveOptions`](RevolveOptions.md)) => [`TriangleMesh`](TriangleMesh.md)
+`const` **revolve**: (`input`: [`Path2Input`](../geometry/Path2Input.md), `options?`: [`RevolveOptions`](../geometry/RevolveOptions.md)) => [`TriangleMesh`](../geometry/TriangleMesh.md)
 
 
 
@@ -18,43 +18,43 @@ Path2 profiles must be closed; raw point collections have an implicit closing ed
 
 ```ts
 // Each point is [radius, Z]; the profile seam is implicit.
-revolveMesh([[0, 0], [12, 0], [8, 20], [0, 20]], { degrees: 270 });
+mesh.revolve([[0, 0], [12, 0], [8, 20], [0, 20]], { degrees: 270 });
 ```
 
 ## Parameters
 
 <a id="input"></a>
 
-**`input`** · [`Path2Input`](Path2Input.md) · Required
+**`input`** · [`Path2Input`](../geometry/Path2Input.md) · Required
 
 
 
 <a id="options"></a>
 
-**`options`** · [`RevolveOptions`](RevolveOptions.md) · Optional
+**`options`** · [`RevolveOptions`](../geometry/RevolveOptions.md) · Optional
 
 Optional physical or exact circumferential sampling controls. Defaults to `{}`.
 
-- [`segments`](RevolveOptions.md#segments) · `number` · Optional
+- [`segments`](../geometry/RevolveOptions.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)
+  This local topology override takes precedence over [CircularPrimitiveOptions.resolution](../geometry/CircularPrimitiveOptions.md#resolution)
   and any active model-wide resolution policy.
 
-- [`resolution`](RevolveOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](../geometry/RevolveOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Operation-level physical tessellation policy over the active model-wide policy.
 
-- [`degrees`](RevolveOptions.md#degrees) · `number` · Optional · Default: `360`
+- [`degrees`](../geometry/RevolveOptions.md#degrees) · `number` · Optional · Default: `360`
 
   Positive sweep in degrees, no greater than 360. Defaults to a full revolution;
   smaller sweeps form partial revolutions with end caps.
   Segment counts describe a complete circle and scale to this angular span. Native filled
   revolutions require at least three sweep intervals: adaptive sampling refines to that floor,
-  while exact counts that imply fewer intervals reject. Pure revolveMesh supports one interval.
+  while exact counts that imply fewer intervals reject. Pure mesh.revolve supports one interval.
 
-- [`limits`](RevolveOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+- [`limits`](../geometry/RevolveOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and sampling allocation ceilings.
 
@@ -62,7 +62,7 @@ Optional physical or exact circumferential sampling controls. Defaults to `{}`.
 
 ## Returns
 
-[`TriangleMesh`](TriangleMesh.md)
+[`TriangleMesh`](../geometry/TriangleMesh.md)
 
 A closed indexed triangle mesh revolved counter-clockwise around +Z.
 
@@ -77,4 +77,4 @@ A closed indexed triangle mesh revolved counter-clockwise around +Z.
 
 - [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/{geometry/computeTriangleMeshSignature.md → mesh/signature.md}

@@ -1,8 +1,8 @@
-# computeTriangleMeshSignature
+# signature
 
 Creates an order-independent regression signature for a manufacturing mesh.
 
-**computeTriangleMeshSignature**(`mesh`: [`TriangleMesh`](TriangleMesh.md), `options?`: [`TriangleMeshSignatureOptions`](TriangleMeshSignatureOptions.md)): [`TriangleMeshSignature`](TriangleMeshSignature.md)
+**signature**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `options?`: [`TriangleMeshSignatureOptions`](../geometry/TriangleMeshSignatureOptions.md)): [`TriangleMeshSignature`](../geometry/TriangleMeshSignature.md)
 
 
 
@@ -14,7 +14,7 @@ connectivity metrics do. The fingerprint is a regression aid, not a cryptographi
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMesh`](TriangleMesh.md) · Required
+**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
 
 Closed oriented mesh to measure without mutation.
 
@@ -22,19 +22,19 @@ Closed oriented mesh to measure without mutation.
 
 <a id="options"></a>
 
-**`options`** · [`TriangleMeshSignatureOptions`](TriangleMeshSignatureOptions.md) · Optional
+**`options`** · [`TriangleMeshSignatureOptions`](../geometry/TriangleMeshSignatureOptions.md) · Optional
 
 Absolute quantization and complexity limits.
 
-- [`maxTriangles`](TriangleMeshSignatureOptions.md#maxtriangles) · `number` · Optional
+- [`maxTriangles`](../geometry/TriangleMeshSignatureOptions.md#maxtriangles) · `number` · Optional
 
   Maximum accepted triangle count. Defaults to 200,000.
 
-- [`positionTolerance`](TriangleMeshSignatureOptions.md#positiontolerance) · `number` · Optional
+- [`positionTolerance`](../geometry/TriangleMeshSignatureOptions.md#positiontolerance) · `number` · Optional
 
   Position and bounds quantization in model units. Defaults to `1e-5`.
 
-- [`volumeTolerance`](TriangleMeshSignatureOptions.md#volumetolerance) · `number` · Optional
+- [`volumeTolerance`](../geometry/TriangleMeshSignatureOptions.md#volumetolerance) · `number` · Optional
 
   Signed-volume quantization in cubic model units. Defaults to `1e-4`.
 
@@ -42,18 +42,18 @@ Absolute quantization and complexity limits.
 
 ## Returns
 
-[`TriangleMeshSignature`](TriangleMeshSignature.md)
+[`TriangleMeshSignature`](../geometry/TriangleMeshSignature.md)
 
 Compact counts, bounds, volume, topology, tolerances, and canonical fingerprint.
 
 
 ## Throws
 
-- GeometryError When validation, topology, tolerance, or complexity checks fail.
+- `GeometryError` When validation, topology, tolerance, or complexity checks fail.
 
 ## Related APIs
 
-- [TriangleMesh](TriangleMesh.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
 - [TriangleMeshSignature](TriangleMeshSignature.md)
 - [TriangleMeshSignatureOptions](TriangleMeshSignatureOptions.md)
 
@@ -61,4 +61,4 @@ Compact counts, bounds, volume, topology, tolerances, and canonical fingerprint.
 
 - [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,86 @@
+# sweep
+
+Sweeps one explicitly ordered point loop, with caps or a geometrically matching closed seam.
+
+**sweep**(`profile`: [`Path2Input`](../geometry/Path2Input.md), `path`: [`Path3Input`](../geometry/Path3Input.md), `options?`: [`SweepOptions`](../geometry/SweepOptions.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+
+
+
+## Example: Sweep point data along a bent path
+
+```ts
+const profile = rectangleContour({ size: [6, 3] });
+mesh.sweep(profile, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
+  orientation: { kind: "transport", initialNormal: [0, 1, 0] },
+});
+```
+
+## Parameters
+
+<a id="profile"></a>
+
+**`profile`** · [`Path2Input`](../geometry/Path2Input.md) · Required
+
+
+
+<a id="path"></a>
+
+**`path`** · [`Path3Input`](../geometry/Path3Input.md) · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`SweepOptions`](../geometry/SweepOptions.md) · Optional
+
+- [`closed`](../geometry/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
+
+  Explicit output and sampling allocation ceilings.
+
+- [`orientation`](../geometry/SweepOptions.md#orientation) · [`SweepOrientation`](../geometry/SweepOrientation.md) · Optional
+
+  Explicit frame policy; default transport minimizes rotations, initially projecting +X then +Y then +Z.
+
+- [`resolution`](../geometry/SweepOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+
+  Physical sampling of nonzero twist; inserted stations retain authored station controls.
+
+- [`twist`](../geometry/SweepOptions.md#twist) · `number` · Optional
+
+  Total additional profile rotation in degrees, with progression selected by twistBy.
+
+- [`twistBy`](../geometry/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
+
+  Positive uniform/XY scale, or one XY pair per path station. Defaults to one.
+
+- [`seamProfileOffset`](../geometry/SweepOptions.md#seamprofileoffset) · `number` · Optional
+
+  Corresponding point-index advance at a rotationally equivalent closed seam.
+
+
+
+## Returns
+
+[`TriangleMesh`](../geometry/TriangleMesh.md)
+
+
+## Related APIs
+
+- [Path2Input](Path2Input.md)
+- [Path3Input](Path3Input.md)
+- [SweepOptions](SweepOptions.md)
+- [TriangleMesh](TriangleMesh.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,72 @@
+# threadRidge
+
+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)
+
+
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`ThreadRidgeOptions`](../geometry/ThreadRidgeOptions.md) · Required
+
+- [`length`](../geometry/ThreadRidgeOptions.md#length) · `number` · Required
+
+  Total threaded axial length in millimetres.
+
+- [`majorDiameter`](../geometry/ThreadRidgeOptions.md#majordiameter) · `number` · Required
+
+  Nominal major diameter before any caller-owned fit compensation.
+
+- [`profile`](../geometry/ThreadRidgeOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
+
+  Validated periodic profile repeated around the shaft.
+
+- [`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`](../geometry/ThreadRidgeOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
+
+  Helix direction. Default: `right`.
+
+- [`limits`](../geometry/ThreadRidgeOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+
+  Explicit output and circular allocation ceilings.
+
+- [`phase`](../geometry/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
+
+  Optional circular-resolution policy.
+
+- [`starts`](../geometry/ThreadRidgeOptions.md#starts) · `number` · Optional
+
+  Number of evenly phased starts. Default: `1`.
+
+- [`tolerance`](../geometry/ThreadRidgeOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+
+  Optional numerical tolerance overrides.
+
+
+
+## Returns
+
+[`TriangleMesh`](../geometry/TriangleMesh.md)
+
+
+## Related APIs
+
+- [ThreadRidgeOptions](ThreadRidgeOptions.md)
+- [TriangleMesh](TriangleMesh.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.