@metamesh/modeling 0.16.0 → 0.18.0

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

@@ -1,20 +1,20 @@
-# computeTriangleMeshCentroid
+# centroid
 
 Computes the uniform-density volume centroid of an oriented closed solid, including cavity shells.
 
-**computeTriangleMeshCentroid**(`mesh`: [`TriangleMesh`](TriangleMesh.md)): [`Vector3Data`](Vector3Data.md)
+**centroid**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)): [`Vector3Data`](../geometry/Vector3Data.md)
 
 
 
 Coordinates are millimetres. Indexed closure and positive aggregate volume are required; callers
-may use validateSolidMesh first when geometric intersections and shell orientation are untrusted.
+may use mesh.validateSolid first when geometric intersections and shell orientation are untrusted.
 Fresh mutable input is inspected on every call, and buffers are never changed.
 
 ## Parameters
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMesh`](TriangleMesh.md) · Required
+**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
 
 Consistently oriented closed mesh with positive enclosed volume.
 
@@ -22,18 +22,18 @@ Consistently oriented closed mesh with positive enclosed volume.
 
 ## Returns
 
-[`Vector3Data`](Vector3Data.md)
+[`Vector3Data`](../geometry/Vector3Data.md)
 
 A fresh immutable XYZ volume centroid.
 
 
 ## Related APIs
 
-- [TriangleMesh](TriangleMesh.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
 - [Vector3Data](Vector3Data.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,73 @@
+# extrude
+
+Linearly extrudes one simple profile along +Z with robust ear-clipped caps. Path2 profiles must be closed; raw point collections have an implicit closing edge. End treatments are unsupported and reject at runtime. Use Section.extrude for finished ends.
+
+**extrude**(`input`: [`Path2Input`](../geometry/Path2Input.md), `options`: [`ExtrudeMeshOptions`](../geometry/ExtrudeMeshOptions.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+
+
+
+## Example: Extrude point data without an engine
+
+```ts
+const outline = rectangleContour({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
+mesh.extrude(outline, { height: 8 });
+```
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Path2Input`](../geometry/Path2Input.md) · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`ExtrudeMeshOptions`](../geometry/ExtrudeMeshOptions.md) · Required
+
+- [`height`](../geometry/ExtrudeMeshOptions.md#height) · `number` · Required
+
+  Positive extrusion height in millimetres.
+
+- [`center`](../geometry/ExtrudeMeshOptions.md#center) · `boolean` · Optional
+
+  Center the extrusion on Z; otherwise its bottom is at zero. Defaults to false.
+
+- [`divisions`](../geometry/ExtrudeMeshOptions.md#divisions) · `number` · Optional
+
+  Exact number of intermediate profiles, nonnegative; overrides physical sampling.
+
+- [`limits`](../geometry/ExtrudeMeshOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+
+  Explicit output and sampling allocation ceilings.
+
+- [`resolution`](../geometry/ExtrudeMeshOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+
+  Operation-level physical policy over the nearest model scope.
+
+- [`scaleTop`](../geometry/ExtrudeMeshOptions.md#scaletop) · `number` \| [`Vector2Input`](../geometry/Vector2Input.md) · Optional
+
+  Finite uniform or XY scale of the top profile; defaults to one.
+
+- [`twist`](../geometry/ExtrudeMeshOptions.md#twist) · `number` · Optional
+
+  Finite rotation of the top profile about +Z, in degrees; defaults to zero.
+
+
+
+## Returns
+
+[`TriangleMesh`](../geometry/TriangleMesh.md)
+
+
+## Related APIs
+
+- [ExtrudeMeshOptions](ExtrudeMeshOptions.md)
+- [Path2Input](Path2Input.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/{geometry/heightfieldMesh.md → mesh/heightfield.md}

@@ -1,15 +1,15 @@
-# heightfieldMesh
+# heightfield
 
 Builds a closed indexed mesh from a rectilinear top, matched boundary walls, and flat base.
 
-**heightfieldMesh**(`options`: [`HeightfieldOptions`](HeightfieldOptions.md), `limits?`: `Partial`\<`Pick`\<[`ModelingLimits`](ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\>): [`TriangleMesh`](TriangleMesh.md)
+**heightfield**(`options`: [`HeightfieldOptions`](../geometry/HeightfieldOptions.md), `limits?`: `Partial`\<`Pick`\<[`ModelingLimits`](../geometry/ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\>): [`TriangleMesh`](../geometry/TriangleMesh.md)
 
 
 
 ## Example: Sample a closed wavy mesh
 
 ```ts
-heightfieldMesh({
+mesh.heightfield({
   size: [30, 20], segments: [24, 16],
   height: ([x, y]) => 3 + Math.cos(x / 5) * Math.cos(y / 5),
 });
@@ -23,19 +23,19 @@ Float32 storage. Explicit axes are captured before sampling; shared wall vertice
 
 <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
 
-[`TriangleMesh`](TriangleMesh.md)
+[`TriangleMesh`](../geometry/TriangleMesh.md)
 
 
 ## Related APIs
@@ -43,10 +43,9 @@ Float32 storage. Explicit axes are captured before sampling; shared wall vertice
 - [HeightfieldOptions](HeightfieldOptions.md)
 - [ModelingLimits](ModelingLimits.md)
 - [TriangleMesh](TriangleMesh.md)
-- [preflightHeightfield](preflightHeightfield.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,47 @@
+# immutable
+
+Copies mesh buffers into immutable data; geometric validation still occurs when modeling or finalizing.
+
+**immutable**(`mesh`: `object`): [`ImmutableTriangleMesh`](../geometry/ImmutableTriangleMesh.md)
+
+
+
+## Example
+
+```ts
+import { generate } from "@metamesh/modeling";
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+const model = generate(({ computed, part }) => {
+  const surface = computed("surface", () => mesh.immutable(mesh.heightfield({
+    size: [10, 10], segments: [8, 8], height: () => 2,
+  })));
+  return [part("surface", surface)];
+});
+```
+
+## Parameters
+
+### mesh
+
+#### positions
+
+`Float32Array`
+
+#### indices
+
+`Uint32Array`
+
+## Returns
+
+[`ImmutableTriangleMesh`](../geometry/ImmutableTriangleMesh.md)
+
+
+## Related APIs
+
+- [ImmutableTriangleMesh](ImmutableTriangleMesh.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -1,8 +1,8 @@
-# joinTriangleMeshes
+# join
 
 Concatenates meshes into one indexed mesh without welding coincident vertices.
 
-**joinTriangleMeshes**(`meshes`: readonly [`TriangleMesh`](TriangleMesh.md)[]): [`TriangleMesh`](TriangleMesh.md)
+**join**(`meshes`: readonly [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)[]): [`TriangleMesh`](../geometry/TriangleMesh.md)
 
 
 
@@ -12,7 +12,7 @@ Inputs are validated and never mutated. Face order and winding remain stable.
 
 <a id="meshes"></a>
 
-**`meshes`** · readonly [`TriangleMesh`](TriangleMesh.md)[] · Required
+**`meshes`** · readonly [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)[] · Required
 
 One or more meshes to concatenate.
 
@@ -20,21 +20,22 @@ One or more meshes to concatenate.
 
 ## Returns
 
-[`TriangleMesh`](TriangleMesh.md)
+[`TriangleMesh`](../geometry/TriangleMesh.md)
 
 Fresh typed arrays with indices offset to their source vertex ranges.
 
 
 ## Throws
 
-- GeometryError When no mesh is supplied or an input is invalid.
+- `GeometryError` When no mesh is supplied or an input is invalid.
 
 ## Related APIs
 
 - [TriangleMesh](TriangleMesh.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@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.16.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.16.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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.