@metamesh/modeling 0.16.0 → 0.18.0

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

@@ -0,0 +1,282 @@
+# Vector3
+
+Immutable XYZ arithmetic; vector operations return new values and measurements return numbers.
+
+## Properties
+
+### x
+
+
+
+`readonly` **x**: `number`
+
+
+
+X coordinate in the vector's coordinate units.
+
+***
+
+### y
+
+
+
+`readonly` **y**: `number`
+
+
+
+Y coordinate in the vector's coordinate units.
+
+***
+
+### z
+
+
+
+`readonly` **z**: `number`
+
+
+
+Z coordinate in the vector's coordinate units.
+
+## Methods
+
+### add()
+
+
+
+**add**(`other`: [`Vector3Input`](../geometry/Vector3Input.md)): `Vector3`
+
+
+
+Adds another vector component-wise.
+
+#### Parameters
+
+<a id="other"></a>
+
+**`other`** · [`Vector3Input`](../geometry/Vector3Input.md) · Required
+
+
+
+#### Returns
+
+`Vector3`
+
+***
+
+### subtract()
+
+
+
+**subtract**(`other`: [`Vector3Input`](../geometry/Vector3Input.md)): `Vector3`
+
+
+
+Subtracts another vector component-wise.
+
+#### Parameters
+
+<a id="other-1"></a>
+
+**`other`** · [`Vector3Input`](../geometry/Vector3Input.md) · Required
+
+
+
+#### Returns
+
+`Vector3`
+
+***
+
+### scale()
+
+
+
+**scale**(`factor`: `number`): `Vector3`
+
+
+
+Multiplies by a finite dimensionless scalar.
+
+#### Parameters
+
+<a id="factor"></a>
+
+**`factor`** · `number` · Required
+
+
+
+#### Returns
+
+`Vector3`
+
+***
+
+### normalize()
+
+
+
+**normalize**(`epsilon?`: `number`): `Vector3`
+
+
+
+Returns a unit vector; rejects length at or below finite nonnegative `epsilon` (default `1e-12`).
+
+#### Parameters
+
+<a id="epsilon"></a>
+
+**`epsilon`** · `number` · Optional
+
+
+
+#### Returns
+
+`Vector3`
+
+***
+
+### lerp()
+
+
+
+**lerp**(`other`: [`Vector3Input`](../geometry/Vector3Input.md), `t`: `number`): `Vector3`
+
+
+
+Interpolates toward another vector by finite dimensionless `t`; extrapolation is allowed.
+
+#### Parameters
+
+<a id="other-2"></a>
+
+**`other`** · [`Vector3Input`](../geometry/Vector3Input.md) · Required
+
+
+
+<a id="t"></a>
+
+**`t`** · `number` · Required
+
+
+
+#### Returns
+
+`Vector3`
+
+***
+
+### dot()
+
+
+
+**dot**(`other`: [`Vector3Input`](../geometry/Vector3Input.md)): `number`
+
+
+
+Returns the scalar dot product.
+
+#### Parameters
+
+<a id="other-3"></a>
+
+**`other`** · [`Vector3Input`](../geometry/Vector3Input.md) · Required
+
+
+
+#### Returns
+
+`number`
+
+***
+
+### cross()
+
+
+
+**cross**(`other`: [`Vector3Input`](../geometry/Vector3Input.md)): `Vector3`
+
+
+
+Returns the right-handed cross product as a new vector.
+
+#### Parameters
+
+<a id="other-4"></a>
+
+**`other`** · [`Vector3Input`](../geometry/Vector3Input.md) · Required
+
+
+
+#### Returns
+
+`Vector3`
+
+***
+
+### length()
+
+
+
+**length**(): `number`
+
+
+
+Returns Euclidean length in the vector's coordinate units.
+
+#### Returns
+
+`number`
+
+***
+
+### distance()
+
+
+
+**distance**(`other`: [`Vector3Input`](../geometry/Vector3Input.md)): `number`
+
+
+
+Returns Euclidean distance to another vector in the same coordinate units.
+
+#### Parameters
+
+<a id="other-5"></a>
+
+**`other`** · [`Vector3Input`](../geometry/Vector3Input.md) · Required
+
+
+
+#### Returns
+
+`number`
+
+***
+
+### toData()
+
+
+
+**toData**(): [`Vector3Data`](../geometry/Vector3Data.md)
+
+
+
+Returns this value's frozen readonly tuple for interchange; repeated calls do not allocate.
+
+#### Returns
+
+[`Vector3Data`](../geometry/Vector3Data.md)
+
+
+## Related APIs
+
+- [Vector3](Vector3.md)
+- [Vector3Data](Vector3Data.md)
+- [Vector3Input](Vector3Input.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,14 @@
+# Vector3Data
+
+A three-dimensional Cartesian vector or point.
+
+**Vector3Data** = readonly \[`x`: `number`, `y`: `number`, `z`: `number`\]
+
+
+
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,19 @@
+# Vector3Input
+
+An XYZ tuple or immutable fluent vector accepted by vector operations.
+
+**Vector3Input** = [`Vector3Data`](../geometry/Vector3Data.md) \| [`Vector3`](../geometry/Vector3-type.md)
+
+
+
+
+## Related APIs
+
+- [Vector3](Vector3.md)
+- [Vector3Data](Vector3Data.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,96 @@
+# analyze
+
+Validates and measures a mesh with one pass over positions and one over triangles.
+
+## Call Signature
+
+
+
+**analyze**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `options`: [`TriangleMeshAnalysisOptions`](../geometry/TriangleMeshAnalysisOptions.md) & `object`): [`TriangleMeshTopologyAnalysis`](../geometry/TriangleMeshTopologyAnalysis.md)
+
+
+
+Validates and measures a mesh with one pass over positions and one over triangles.
+
+Bounds, area in square model units and signed volume in cubic model units are computed without
+copying or changing the input buffers. Volume is meaningful for consistently wound closed
+geometry; `requireClosed` checks oriented edge closure. Optional indexed topology counts require
+every position vertex to be referenced and do not establish freedom from self-intersections.
+Results and nested bounds are immutable snapshots. Caller-owned mutable meshes are freshly
+inspected on every call, never cached.
+
+### Parameters
+
+<a id="mesh"></a>
+
+**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+
+
+
+<a id="options"></a>
+
+**`options`** · [`TriangleMeshAnalysisOptions`](../geometry/TriangleMeshAnalysisOptions.md) & `object` · Required
+
+
+
+### Returns
+
+[`TriangleMeshTopologyAnalysis`](../geometry/TriangleMeshTopologyAnalysis.md)
+
+## Call Signature
+
+
+
+**analyze**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `options?`: [`TriangleMeshAnalysisOptions`](../geometry/TriangleMeshAnalysisOptions.md)): [`TriangleMeshAnalysis`](../geometry/TriangleMeshAnalysis.md)
+
+
+
+Measures a mesh; topology fields are present only when includeTopology is enabled.
+
+### Parameters
+
+<a id="mesh-1"></a>
+
+**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+
+
+
+<a id="options-1"></a>
+
+**`options`** · [`TriangleMeshAnalysisOptions`](../geometry/TriangleMeshAnalysisOptions.md) · Optional
+
+- [`includeTopology`](../geometry/TriangleMeshAnalysisOptions.md#includetopology) · `boolean` · Optional
+
+  Compute indexed edge/shell counts and reject unreferenced vertices; defaults to false.
+
+- [`allowEmpty`](../geometry/TriangleMeshAnalysisOptions.md#allowempty) · `boolean` · Optional
+
+  Permit an empty position and index buffer. Defaults to `false`.
+
+- [`requireClosed`](../geometry/TriangleMeshAnalysisOptions.md#requireclosed) · `boolean` · Optional
+
+  Require two oppositely wound faces per edge; geometric self-intersections are not detected.
+
+- [`tolerance`](../geometry/TriangleMeshAnalysisOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+
+  Numeric comparison overrides used for zero-area triangle detection.
+
+
+
+### Returns
+
+[`TriangleMeshAnalysis`](../geometry/TriangleMeshAnalysis.md)
+
+
+## Related APIs
+
+- [TriangleMeshAnalysis](TriangleMeshAnalysis.md)
+- [TriangleMeshAnalysisOptions](TriangleMeshAnalysisOptions.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
+- [TriangleMeshTopologyAnalysis](TriangleMeshTopologyAnalysis.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -1,8 +1,8 @@
-# analyzeTriangleMeshQuality
+# analyzeQuality
 
 Measures triangle shape, edge topology, vertex concentration, and connected planar patches.
 
-**analyzeTriangleMeshQuality**(`mesh`: [`TriangleMesh`](TriangleMesh.md), `options?`: [`TriangleMeshQualityOptions`](TriangleMeshQualityOptions.md)): [`TriangleMeshQualityReport`](TriangleMeshQualityReport.md)
+**analyzeQuality**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `options?`: [`TriangleMeshQualityOptions`](../geometry/TriangleMeshQualityOptions.md)): [`TriangleMeshQualityReport`](../geometry/TriangleMeshQualityReport.md)
 
 
 
@@ -14,7 +14,7 @@ positions, missing vertex references, and the configured complexity limit throw.
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMesh`](TriangleMesh.md) · Required
+**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
 
 Indexed triangle mesh in arbitrary consistent model units.
 
@@ -22,15 +22,15 @@ Indexed triangle mesh in arbitrary consistent model units.
 
 <a id="options"></a>
 
-**`options`** · [`TriangleMeshQualityOptions`](TriangleMeshQualityOptions.md) · Optional
+**`options`** · [`TriangleMeshQualityOptions`](../geometry/TriangleMeshQualityOptions.md) · Optional
 
 Scale-aware tolerance and analysis budget.
 
-- [`maxTriangles`](TriangleMeshQualityOptions.md#maxtriangles) · `number` · Optional
+- [`maxTriangles`](../geometry/TriangleMeshQualityOptions.md#maxtriangles) · `number` · Optional
 
   Maximum number of triangles inspected. Defaults to `200000`.
 
-- [`tolerance`](TriangleMeshQualityOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../geometry/TriangleMeshQualityOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Numeric comparison overrides; model coordinates are interpreted in their existing units.
 
@@ -38,14 +38,14 @@ Scale-aware tolerance and analysis budget.
 
 ## Returns
 
-[`TriangleMeshQualityReport`](TriangleMeshQualityReport.md)
+[`TriangleMeshQualityReport`](../geometry/TriangleMeshQualityReport.md)
 
 A deterministic report without mutating or copying the mesh.
 
 
 ## Related APIs
 
-- [TriangleMesh](TriangleMesh.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
 - [TriangleMeshQualityOptions](TriangleMeshQualityOptions.md)
 - [TriangleMeshQualityReport](TriangleMeshQualityReport.md)
 
@@ -53,4 +53,4 @@ A deterministic report without mutating or copying the mesh.
 
 - [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/bounds.md

@@ -0,0 +1,39 @@
+# bounds
+
+Computes axis-aligned bounds for a non-empty mesh.
+
+`const` **bounds**: (`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)) => [`Bounds3Data`](../geometry/Bounds3Data.md)
+
+
+
+## Parameters
+
+<a id="mesh"></a>
+
+**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+
+Mesh whose finite complete vertices will be measured.
+
+
+
+## Returns
+
+[`Bounds3Data`](../geometry/Bounds3Data.md)
+
+Fresh immutable minimum and maximum XYZ tuples.
+
+
+## Throws
+
+- `GeometryError` When the mesh is structurally invalid.
+
+## Related APIs
+
+- [Bounds3Data](Bounds3Data.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/mesh/categories/operations.md

@@ -0,0 +1,147 @@
+# Mesh operations
+
+Construct, transform, validate, analyze, and optimize indexed meshes.
+
+Use `import * as mesh from "@metamesh/modeling/geometry/mesh"` for static, removable operation imports. `mesh.join` concatenates buffers; overlapping geometry remains overlapping.
+
+Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle indices. Mesh analysis accepts raw arrays or stable immutable buffers directly; signatures add quantized topology and a regression hash. Predictable constructors reject unsafe allocations before sampling.
+
+- **Construct:** `mesh.extrude`, `mesh.loft`, `mesh.sweep`, `mesh.revolve`, `mesh.threadRidge`, and `mesh.threadSolid` return `TriangleMesh` data without a host engine. `LoftOptions`, `SweepOptions`, and `ExtrudeMeshOptions` describe pure construction. Native `ExtrudeOptions` additionally accepts end treatments.
+- **Match lofts:** `mesh.loft` defaults to `direct` correspondence; select `reindex`, `fast-distance`, or `distance` explicitly when needed. Stations specify exactly one `z` or `frame`, retain original vertices, and interpolate slices in world coordinates. Profile association and sampling-grid work have explicit limits; fidelity isn't reduced to meet them.
+- **Validate:** closed oriented-edge checks do not establish freedom from self-intersections. `mesh.validateSolid` adds bounded floating-point intersection and nested-shell orientation checks, including cavity boundaries. Contacts within tolerance reject conservatively; exhausted work limits fail explicitly.
+- **Measure:** `mesh.centroid` returns the uniform-density volume centroid of consistently oriented closed geometry, including cavities.
+
+## Functions
+
+| API | Summary |
+| --- | --- |
+| [extrude](../extrude.md) | 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. |
+| [loft](../loft.md) | Lofts simple point loops at z heights or explicit right-handed frames, in input order. |
+| [sweep](../sweep.md) | Sweeps one explicitly ordered point loop, with caps or a geometrically matching closed seam. |
+| [heightfield](../heightfield.md) | Builds a closed indexed mesh from a rectilinear top, matched boundary walls, and flat base. |
+| [preflightHeightfield](../preflightHeightfield.md) | Checks grid options, Float32 axis precision, and output limits; returns exact mesh buffer counts. |
+| [threadRidge](../threadRidge.md) | 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. |
+| [threadSolid](../threadSolid.md) | Builds one closed threaded cylinder without a ridge/core Boolean seam. |
+| [preflightThreadSolid](../preflightThreadSolid.md) | Checks thread dimensions, profile, end treatments, sampling, and conservative estimates against output limits. |
+| [transform](../transform.md) | Applies an affine transform to a mesh and preserves outward face orientation. |
+| [join](../join.md) | Concatenates meshes into one indexed mesh without welding coincident vertices. |
+| [reverse](../reverse.md) | Returns a copy of a mesh with every triangle winding reversed. |
+| [centroid](../centroid.md) | Computes the uniform-density volume centroid of an oriented closed solid, including cavity shells. |
+| [analyze](../analyze.md) | Validates and measures a mesh with one pass over positions and one over triangles. |
+| [analyzeQuality](../analyzeQuality.md) | Measures triangle shape, edge topology, vertex concentration, and connected planar patches. |
+| [signature](../signature.md) | Creates an order-independent regression signature for a manufacturing mesh. |
+| [validate](../validate.md) | Validates mesh buffers, indices, triangle area, and optionally closed topology. |
+| [validateSolid](../validateSolid.md) | Checks closed indexed topology, triangle intersections, and alternating nested shell orientation. |
+| [optimizePlanarPatches](../optimizePlanarPatches.md) | Improves pathological planar triangulation with bounded legal diagonal flips. |
+| [immutable](../immutable.md) | Copies mesh buffers into immutable data; geometric validation still occurs when modeling or finalizing. |
+
+## Interfaces
+
+| API | Summary |
+| --- | --- |
+| [TriangleMesh](../TriangleMesh.md) | A topology-preserving indexed triangle mesh with mutable owned XYZ buffers. |
+| [TriangleMeshMeasurements](../TriangleMeshMeasurements.md) | Geometric measurements derived from a validated, non-empty triangle mesh. |
+| [TriangleMeshAnalysis](../TriangleMeshAnalysis.md) | Measurements and optional edge-connected topology from one validated mesh traversal. |
+| [TriangleMeshTopologyAnalysis](../TriangleMeshTopologyAnalysis.md) | Mesh measurements with the indexed surface-shell and edge counts requested by includeTopology. |
+| [TriangleMeshAnalysisOptions](../TriangleMeshAnalysisOptions.md) | Validation and optional connectivity controls for a shared mesh analysis. |
+| [TriangleMeshValidationOptions](../TriangleMeshValidationOptions.md) | Options controlling structural and manufacturing validation of a mesh. |
+| [ImmutableTriangleMesh](../ImmutableTriangleMesh.md) | Immutable local XYZ positions and triangle indices, suitable for a computed value or part. |
+| [ExtrudeMeshOptions](../ExtrudeMeshOptions.md) | Dimensions and sampling for pure +Z mesh extrusion, without end treatments. |
+| [LoftOptions](../LoftOptions.md) | Shared controls for native and pure lofts. Point data and arbitrary Sections default to direct correspondence. |
+| [RevolveOptions](../RevolveOptions.md) | Circumferential sampling and degree sweep shared by pure and filled revolution. |
+| [SweepOptions](../SweepOptions.md) | Controls shared by pure mesh construction and filled modeling sweeps. |
+| [HeightfieldPreflight](../HeightfieldPreflight.md) | Exact grid and mesh buffer allocation counts resolved without evaluating the height callback. |
+| [SolidMeshValidationOptions](../SolidMeshValidationOptions.md) | Bounded floating-point intersection and shell-orientation validation settings. |
+| [TriangleMeshSignature](../TriangleMeshSignature.md) | Immutable deterministic measurements for a closed, oriented triangle mesh. |
+| [TriangleMeshSignatureOptions](../TriangleMeshSignatureOptions.md) | Options controlling deterministic triangle-mesh regression signatures. |
+| [TriangleMeshSignatureTolerances](../TriangleMeshSignatureTolerances.md) | Absolute tolerances recorded in a triangle-mesh regression signature. |
+| [PlanarPatchQuality](../PlanarPatchQuality.md) | Quality measurements for one edge-connected coplanar triangle patch. |
+| [TriangleMeshQualityOptions](../TriangleMeshQualityOptions.md) | Options controlling bounded triangle-mesh quality analysis. |
+| [TriangleMeshQualityReport](../TriangleMeshQualityReport.md) | Structural, topological, and planar-patch measurements for one indexed triangle mesh. |
+| [PlanarMeshOptimizationOptions](../PlanarMeshOptimizationOptions.md) | Options controlling bounded, connectivity-only optimization of planar triangle patches. |
+| [PlanarMeshOptimizationResult](../PlanarMeshOptimizationResult.md) | Outcome of bounded planar-patch optimization, including before/after diagnostics. |
+| [ImmutableBuffer](../ImmutableBuffer.md) | Owned immutable numeric data. Iterate without copying; use copy() for mutable storage. |
+| [ExtrusionSamplingOptions](../ExtrusionSamplingOptions.md) | Shared sampling controls for a twisted or scaled linear extrusion. |
+| [Bounds2](../Bounds2.md) | Immutable finite XY bounds in millimetres, with tuple coordinates for data interoperability. |
+| [Bounds3](../Bounds3.md) | Immutable finite XYZ bounds in millimetres, with tuple coordinates for data interoperability. |
+| [Vector2](../Vector2.md) | Immutable XY arithmetic; vector operations return new values and measurements return numbers. |
+| [Vector3](../Vector3.md) | Immutable XYZ arithmetic; vector operations return new values and measurements return numbers. |
+| [Path2](../Path2.md) | Immutable directed XY polyline. Closure is explicit and does not imply a filled Section. |
+| [Path3](../Path3.md) | Immutable directed XYZ polyline; it represents sampled edges, not an analytic curve. |
+| [PathLocation](../PathLocation.md) | Nearest location on a sampled boundary, rather than inside a filled shape or on an analytic curve. |
+| [PathResamplingOptions](../PathResamplingOptions.md) | Equal arc-length sampling; the path itself owns whether its closing edge is included. |
+| [Transform2](../Transform2.md) | Immutable reusable XY placement. Methods apply in written order; angles are degrees. |
+| [Transform3](../Transform3.md) | Immutable reusable XYZ placement. Methods apply in written order; angles are degrees. |
+| [Pivot2Options](../Pivot2Options.md) | A fixed XY point in world coordinates; omitted pivots use the coordinate origin. |
+| [Pivot3Options](../Pivot3Options.md) | A fixed XYZ point in world coordinates; omitted pivots use the coordinate origin. |
+| [Bounds2Data](../Bounds2Data.md) | Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods. |
+| [Bounds3Data](../Bounds3Data.md) | Plain axis-aligned XYZ bounds for interchange; use bounds3 for immutable measurement methods. |
+| [Frame3](../Frame3.md) | A right-handed orthonormal coordinate frame expressed in world coordinates. |
+| [Path2Data](../Path2Data.md) | Complete plain XY path representation, including topology and empty-path dimensional identity. |
+| [Path3Data](../Path3Data.md) | Complete plain XYZ path representation, including topology and empty-path dimensional identity. |
+| [CurveSamplingOptions](../CurveSamplingOptions.md) | Explicit physical sampling and allocation policy for reusable curves. |
+| [CircularPrimitiveOptions](../CircularPrimitiveOptions.md) | Tessellation controls shared by circular primitives across Geometry entry points. |
+| [GeometryResolution](../GeometryResolution.md) | Tessellation policy for sampled geometry measured in millimetres. |
+| [GeometrySamplingLimits](../GeometrySamplingLimits.md) | Explicit allocation ceilings for pure sampling and host-owned modeling operations. |
+| [GeometryToleranceOptions](../GeometryToleranceOptions.md) | Optional overrides for MetaMesh's geometry comparison policy. |
+| [ModelingLimits](../ModelingLimits.md) | Aggregate manufacturing output ceilings selected by a trusted host. |
+| [ThreadRidgeOptions](../ThreadRidgeOptions.md) | Runtime-neutral options for the dedicated helical ridge mesher. |
+| [ThreadSolidOptions](../ThreadSolidOptions.md) | Options for a complete threaded-cylinder mesh; base semantics match the ridge builder. |
+| [ThreadSolidPreflight](../ThreadSolidPreflight.md) | Selected sampling counts and conservative allocation estimates, before thread mesh construction. |
+| [ThreadEndTreatmentOptions](../ThreadEndTreatmentOptions.md) | Axial end controls for a generated ridge. |
+| [ThreadProfile](../ThreadProfile.md) | A validated immutable periodic thread profile in `[axial, radial]` millimetres. |
+| [AcmeThreadProfileSpec](../AcmeThreadProfileSpec.md) | ACME 29-degree included-angle profile. |
+| [ButtressThreadProfileSpec](../ButtressThreadProfileSpec.md) | Asymmetric printable buttress profile with 7/45-degree flanks. |
+| [CustomThreadProfileSpec](../CustomThreadProfileSpec.md) | Caller-defined periodic axial/radial profile in millimetres. |
+| [SquareThreadProfileSpec](../SquareThreadProfileSpec.md) | Square profile with equal crest and root widths. |
+| [ThreadProfileBaseSpec](../ThreadProfileBaseSpec.md) | Fields shared by all thread profile specifications. |
+| [TrapezoidalThreadProfileSpec](../TrapezoidalThreadProfileSpec.md) | Trapezoidal thread profile with a configurable included angle. |
+| [TriangularThreadProfileSpec](../TriangularThreadProfileSpec.md) | ISO/UTS-like 60-degree truncated triangular profile. |
+
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [TriangleMeshInput](../TriangleMeshInput.md) | Raw construction buffers or immutable captured geometry accepted by mesh utilities. |
+| [LoftMeshStation](../LoftMeshStation.md) | One point-data profile at a height or explicit right-handed spatial frame. |
+| [LoftPlacement](../LoftPlacement.md) | A horizontal XY station height, or an explicit right-handed spatial frame, never both. |
+| [LoftCorrespondence](../LoftCorrespondence.md) | Associates ordered loft contours without inferring component identities or repairing topology. |
+| [SweepOrientation](../SweepOrientation.md) | Explicit profile-X frame policy; all normals are directed, and selected singular policies reject. |
+| [HeightfieldOptions](../HeightfieldOptions.md) | A closed rectilinear heightfield above a flat base, with uniform or explicit XY samples in millimetres. |
+| [HeightfieldMeshLimits](../HeightfieldMeshLimits.md) | Trusted output ceilings for pure construction; omitted fields use engine defaults. |
+| [PlanarMeshOptimizationFallbackReason](../PlanarMeshOptimizationFallbackReason.md) | Stable reason why planar optimization returned the original mesh unchanged. |
+| [NumericArray](../NumericArray.md) | Numeric storage supported by immutable generation buffers. |
+| [Bounds2Input](../Bounds2Input.md) | An immutable XY bounds value or its plain min/max representation. |
+| [Bounds3Input](../Bounds3Input.md) | An immutable XYZ bounds value or its plain min/max representation. |
+| [Vector2Input](../Vector2Input.md) | An XY tuple or immutable fluent vector accepted by vector operations. |
+| [Vector3Input](../Vector3Input.md) | An XYZ tuple or immutable fluent vector accepted by vector operations. |
+| [Path2Input](../Path2Input.md) | A matching path value, complete plain path data, or a collection of vectors. |
+| [Path3Input](../Path3Input.md) | A matching path value, complete plain path data, or a collection of vectors. |
+| [PathNormalGuide](../PathNormalGuide.md) | Supplies a profile-X orientation guide for each original normalized sweep station. |
+| [Transform2Input](../Transform2Input.md) | An immutable XY transform or its canonical row-major matrix for interchange. |
+| [Transform3Input](../Transform3Input.md) | An immutable XYZ transform or its canonical row-major matrix for interchange. |
+| [Transform2Data](../Transform2Data.md) | A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`. |
+| [Transform3Data](../Transform3Data.md) | A row-major affine 4x4 matrix applied to column vectors. |
+| [Vector2Data](../Vector2Data.md) | A two-dimensional Cartesian vector or point. |
+| [Vector3Data](../Vector3Data.md) | A three-dimensional Cartesian vector or point. |
+| [ThreadEndStyle](../ThreadEndStyle.md) | End shape of a generated helical ridge. |
+| [ThreadLeadInEnvelope](../ThreadLeadInEnvelope.md) | Radial envelope toward which a blunt lead-in collapses. |
+| [ThreadLeadInShape](../ThreadLeadInShape.md) | BOSL2-compatible cross-section scaling curve for a blunt thread lead-in. |
+| [ThreadHandedness](../ThreadHandedness.md) | Direction in which a conventional helical thread advances around +Z. |
+| [Bevel](../Bevel.md) | One size for both ends, or independent sizes in bottom/top order. Zero disables an end. |
+| [BevelSize](../BevelSize.md) | Nonnegative 45-degree axial/radial bevel size in millimetres, or factory automatic sizing. |
+| [ButtressPressureFlankSide](../ButtressPressureFlankSide.md) | Axial side carrying the near-normal pressure flank of a buttress thread. |
+| [ThreadProfileSpec](../ThreadProfileSpec.md) | Supported built-in and caller-defined thread profiles. |
+
+## Values
+
+| API | Summary |
+| --- | --- |
+| [revolve](../revolve.md) | Revolves a non-duplicated closed `[radius, z]` profile around +Z. |
+| [bounds](../bounds.md) | Computes axis-aligned bounds for a non-empty mesh. |
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.