@metamesh/modeling 0.17.0 → 0.19.0

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

@@ -0,0 +1,96 @@
+# 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](../geometry/ThreadSolidOptions.md)
+- [ThreadSolidPreflight](../geometry/ThreadSolidPreflight.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Supported imports
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -0,0 +1,57 @@
+# render
+
+Builds crease-aware render buffers without moving or merging distinct positions. Face normals are averaged only at exactly coincident positions within the crease angle. Returns owned buffers; every triangle retains its coordinates, order and winding. Pathological vertex fans exceeding 50 million normal comparisons reject with a complexity error.
+
+**render**(`input`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `options?`: [`MeshRenderOptions`](MeshRenderOptions.md)): [`RenderMesh`](RenderMesh.md)
+
+
+
+## Example
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+const surface = mesh.heightfield({ size: [10, 10], segments: [2, 2], height: () => 0 });
+const rendered = mesh.render(surface);
+// rendered.positions and rendered.normals can be passed to a renderer or GLB writer.
+```
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`MeshRenderOptions`](MeshRenderOptions.md) · Optional
+
+- [`creaseAngle`](MeshRenderOptions.md#creaseangle) · `number` · Optional
+
+  Maximum angle between averaged face normals, in degrees. Defaults to `20`; `0` is flat.
+
+
+
+## Returns
+
+[`RenderMesh`](RenderMesh.md)
+
+
+## Related APIs
+
+- [MeshRenderOptions](MeshRenderOptions.md)
+- [RenderMesh](RenderMesh.md)
+- [TriangleMeshInput](../geometry/TriangleMeshInput.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Supported imports
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -0,0 +1,41 @@
+# reverse
+
+Returns a copy of a mesh with every triangle winding reversed.
+
+**reverse**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+
+
+
+## Parameters
+
+<a id="mesh"></a>
+
+**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+
+Mesh to copy and reverse.
+
+
+
+## Returns
+
+[`TriangleMesh`](../geometry/TriangleMesh.md)
+
+Fresh position and index buffers; the input remains unchanged.
+
+
+## Related APIs
+
+- [TriangleMesh](../geometry/TriangleMesh.md)
+- [TriangleMeshInput](../geometry/TriangleMeshInput.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Supported imports
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.19.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,19 +62,25 @@ 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.
 
 
 ## Related APIs
 
-- [Path2Input](Path2Input.md)
-- [RevolveOptions](RevolveOptions.md)
-- [TriangleMesh](TriangleMesh.md)
+- [Path2Input](../geometry/Path2Input.md)
+- [RevolveOptions](../geometry/RevolveOptions.md)
+- [TriangleMesh](../geometry/TriangleMesh.md)
 
 ## Guides
 
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -0,0 +1,70 @@
+# signature
+
+Creates an order-independent regression signature for a manufacturing mesh.
+
+**signature**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `options?`: [`TriangleMeshSignatureOptions`](../geometry/TriangleMeshSignatureOptions.md)): [`TriangleMeshSignature`](../geometry/TriangleMeshSignature.md)
+
+
+
+The input must be non-empty, closed, consistently wound, and have no unreferenced vertices.
+Vertex and triangle order do not affect the fingerprint; winding, quantized geometry, and
+connectivity metrics do. The fingerprint is a regression aid, not a cryptographic digest.
+
+## Parameters
+
+<a id="mesh"></a>
+
+**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+
+Closed oriented mesh to measure without mutation.
+
+
+
+<a id="options"></a>
+
+**`options`** · [`TriangleMeshSignatureOptions`](../geometry/TriangleMeshSignatureOptions.md) · Optional
+
+Absolute quantization and complexity limits.
+
+- [`maxTriangles`](../geometry/TriangleMeshSignatureOptions.md#maxtriangles) · `number` · Optional
+
+  Maximum accepted triangle count. Defaults to 200,000.
+
+- [`positionTolerance`](../geometry/TriangleMeshSignatureOptions.md#positiontolerance) · `number` · Optional
+
+  Position and bounds quantization in model units. Defaults to `1e-5`.
+
+- [`volumeTolerance`](../geometry/TriangleMeshSignatureOptions.md#volumetolerance) · `number` · Optional
+
+  Signed-volume quantization in cubic model units. Defaults to `1e-4`.
+
+
+
+## Returns
+
+[`TriangleMeshSignature`](../geometry/TriangleMeshSignature.md)
+
+Compact counts, bounds, volume, topology, tolerances, and canonical fingerprint.
+
+
+## Throws
+
+- `GeometryError` When validation, topology, tolerance, or complexity checks fail.
+
+## Related APIs
+
+- [TriangleMeshInput](../geometry/TriangleMeshInput.md)
+- [TriangleMeshSignature](../geometry/TriangleMeshSignature.md)
+- [TriangleMeshSignatureOptions](../geometry/TriangleMeshSignatureOptions.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Supported imports
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -0,0 +1,92 @@
+# 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](../geometry/Path2Input.md)
+- [Path3Input](../geometry/Path3Input.md)
+- [SweepOptions](../geometry/SweepOptions.md)
+- [TriangleMesh](../geometry/TriangleMesh.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Supported imports
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -0,0 +1,78 @@
+# 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](../geometry/ThreadRidgeOptions.md)
+- [TriangleMesh](../geometry/TriangleMesh.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Supported imports
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -0,0 +1,96 @@
+# 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](../geometry/ThreadSolidOptions.md)
+- [TriangleMesh](../geometry/TriangleMesh.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Supported imports
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -0,0 +1,53 @@
+# transform
+
+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)
+
+
+
+A transform with a negative linear determinant reflects space, so this helper
+automatically reverses every triangle. Singular transforms are rejected.
+
+## Parameters
+
+<a id="mesh"></a>
+
+**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+
+Mesh to transform without mutation.
+
+
+
+<a id="placement"></a>
+
+**`placement`** · [`Transform3Input`](../geometry/Transform3Input.md) · Required
+
+Immutable spatial placement or canonical row-major affine matrix.
+
+
+
+## Returns
+
+[`TriangleMesh`](../geometry/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)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Supported imports
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.19.0`.