@metamesh/modeling 0.16.0 → 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.16.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.16.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`.

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

@@ -0,0 +1,90 @@
+# threadSolid
+
+Builds one closed threaded cylinder without a ridge/core Boolean seam.
+
+**threadSolid**(`options`: [`ThreadSolidOptions`](../geometry/ThreadSolidOptions.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+
+
+
+Each circular facet includes its exact phase-shifted profile breakpoints, including duplicate-Z
+samples for vertical flanks and blunt transitions. Adjacent variable grids are stitched as a
+monotone strip, with optional intermediate rows bounded by physical `maxSegmentLength`. A
+conservative pre-allocation estimate rejects excessive meshes before constructing position
+arrays.
+
+## 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
+
+[`TriangleMesh`](../geometry/TriangleMesh.md)
+
+
+## Related APIs
+
+- [ThreadSolidOptions](ThreadSolidOptions.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/transformTriangleMesh.md → mesh/transform.md}

@@ -1,8 +1,8 @@
-# transformTriangleMesh
+# transform
 
 Applies an affine transform to a mesh and preserves outward face orientation.
 
-**transformTriangleMesh**(`mesh`: [`TriangleMesh`](TriangleMesh.md), `placement`: [`Transform3Input`](Transform3Input.md)): [`TriangleMesh`](TriangleMesh.md)
+**transform**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `placement`: [`Transform3Input`](../geometry/Transform3Input.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
 
 
 
@@ -13,7 +13,7 @@ automatically reverses every triangle. Singular transforms are rejected.
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMesh`](TriangleMesh.md) · Required
+**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
 
 Mesh to transform without mutation.
 
@@ -21,7 +21,7 @@ Mesh to transform without mutation.
 
 <a id="placement"></a>
 
-**`placement`** · [`Transform3Input`](Transform3Input.md) · Required
+**`placement`** · [`Transform3Input`](../geometry/Transform3Input.md) · Required
 
 Immutable spatial placement or canonical row-major affine matrix.
 
@@ -29,7 +29,7 @@ Immutable spatial placement or canonical row-major affine matrix.
 
 ## Returns
 
-[`TriangleMesh`](TriangleMesh.md)
+[`TriangleMesh`](../geometry/TriangleMesh.md)
 
 A mesh with fresh transformed positions and copied or reversed indices.
 
@@ -38,9 +38,10 @@ A mesh with fresh transformed positions and copied or reversed indices.
 
 - [Transform3Input](Transform3Input.md)
 - [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/validateTriangleMesh.md → mesh/validate.md}

@@ -1,8 +1,8 @@
-# validateTriangleMesh
+# validate
 
 Validates mesh buffers, indices, triangle area, and optionally closed topology.
 
-**validateTriangleMesh**(`mesh`: [`TriangleMesh`](TriangleMesh.md), `options?`: [`TriangleMeshValidationOptions`](TriangleMeshValidationOptions.md)): [`TriangleMesh`](TriangleMesh.md)
+**validate**\<`T` *extends* [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)\>(`mesh`: `T`, `options?`: [`TriangleMeshValidationOptions`](../geometry/TriangleMeshValidationOptions.md)): `T`
 
 
 
@@ -10,11 +10,17 @@ Closed validation requires exactly two oppositely directed uses per edge, reject
 and non-manifold edges. It establishes edge connectivity without detecting geometric
 self-intersections between faces. The mesh is neither mutated nor copied.
 
+## Type Parameters
+
+### T
+
+`T` *extends* [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)
+
 ## Parameters
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMesh`](TriangleMesh.md) · Required
+**`mesh`** · `T` · Required
 
 Mesh to inspect.
 
@@ -22,19 +28,19 @@ Mesh to inspect.
 
 <a id="options"></a>
 
-**`options`** · [`TriangleMeshValidationOptions`](TriangleMeshValidationOptions.md) · Optional
+**`options`** · [`TriangleMeshValidationOptions`](../geometry/TriangleMeshValidationOptions.md) · Optional
 
 Empty-mesh, topology, and tolerance policy.
 
-- [`allowEmpty`](TriangleMeshValidationOptions.md#allowempty) · `boolean` · Optional
+- [`allowEmpty`](../geometry/TriangleMeshValidationOptions.md#allowempty) · `boolean` · Optional
 
   Permit an empty position and index buffer. Defaults to `false`.
 
-- [`requireClosed`](TriangleMeshValidationOptions.md#requireclosed) · `boolean` · Optional
+- [`requireClosed`](../geometry/TriangleMeshValidationOptions.md#requireclosed) · `boolean` · Optional
 
   Require two oppositely wound faces per edge; geometric self-intersections are not detected.
 
-- [`tolerance`](TriangleMeshValidationOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../geometry/TriangleMeshValidationOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Numeric comparison overrides used for zero-area triangle detection.
 
@@ -42,22 +48,22 @@ Empty-mesh, topology, and tolerance policy.
 
 ## Returns
 
-[`TriangleMesh`](TriangleMesh.md)
+`T`
 
 The original mesh after successful validation.
 
 
 ## Throws
 
-- GeometryError When any requested invariant fails.
+- `GeometryError` When any requested invariant fails.
 
 ## Related APIs
 
-- [TriangleMesh](TriangleMesh.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
 - [TriangleMeshValidationOptions](TriangleMeshValidationOptions.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/validateSolidMesh.md → mesh/validateSolid.md}

@@ -1,8 +1,8 @@
-# validateSolidMesh
+# validateSolid
 
 Checks closed indexed topology, triangle intersections, and alternating nested shell orientation.
 
-**validateSolidMesh**(`mesh`: [`TriangleMesh`](TriangleMesh.md), `options?`: [`SolidMeshValidationOptions`](SolidMeshValidationOptions.md)): [`TriangleMesh`](TriangleMesh.md)
+**validateSolid**\<`T` *extends* [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)\>(`mesh`: `T`, `options?`: [`SolidMeshValidationOptions`](../geometry/SolidMeshValidationOptions.md)): `T`
 
 
 
@@ -14,11 +14,17 @@ tolerance reject conservatively. At most 200,000 triangles and 2,000,000 spatial
 are supported; exhausting a ceiling throws COMPLEXITY_LIMIT rather than claiming validity.
 Input buffers are freshly inspected and never modified; units are millimetres.
 
+## Type Parameters
+
+### T
+
+`T` *extends* [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)
+
 ## Parameters
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMesh`](TriangleMesh.md) · Required
+**`mesh`** · `T` · Required
 
 Closed triangle mesh to inspect.
 
@@ -26,15 +32,15 @@ Closed triangle mesh to inspect.
 
 <a id="options"></a>
 
-**`options`** · [`SolidMeshValidationOptions`](SolidMeshValidationOptions.md) · Optional
+**`options`** · [`SolidMeshValidationOptions`](../geometry/SolidMeshValidationOptions.md) · Optional
 
 Optional lower work ceiling and numeric comparison policy.
 
-- [`maxTests`](SolidMeshValidationOptions.md#maxtests) · `number` · Optional
+- [`maxTests`](../geometry/SolidMeshValidationOptions.md#maxtests) · `number` · Optional
 
   Work ceiling for spatial comparisons and containment tests; defaults to 2,000,000 and may only lower it.
 
-- [`tolerance`](SolidMeshValidationOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../geometry/SolidMeshValidationOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Distance comparison policy in millimetres; near contacts reject conservatively.
 
@@ -42,7 +48,7 @@ Optional lower work ceiling and numeric comparison policy.
 
 ## Returns
 
-[`TriangleMesh`](TriangleMesh.md)
+`T`
 
 The original mesh after every requested check succeeds.
 
@@ -50,10 +56,10 @@ The original mesh after every requested check succeeds.
 ## Related APIs
 
 - [SolidMeshValidationOptions](SolidMeshValidationOptions.md)
-- [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/mesh.md

@@ -0,0 +1,21 @@
+# Triangle meshes
+
+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`.
+
+```ts
+import { rectangleContour, transform3 } from "@metamesh/modeling/geometry";
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+const plate = mesh.extrude(rectangleContour({ size: [30, 20] }), { height: 8 });
+const positioned = mesh.transform(plate, transform3().translate([10, 0, 0]));
+const facts = mesh.analyze(positioned, { requireClosed: true });
+```
+
+Operations return copied buffers or their documented measurement and processing reports. There is no builder or cleanup requirement. `mesh.join` concatenates meshes without Boolean union. Solid mesh validation includes bounded intersection and shell orientation checks; basic validation checks buffer structure and triangles.
+
+## Categories
+
+- [Mesh operations](mesh/categories/operations.md) — Construct, transform, validate, analyze, and optimize indexed meshes.
+
+Package: `@metamesh/modeling@0.18.0`.