@metamesh/modeling 0.16.0 → 0.18.0

package/dist/docs/reference/geometry/helicalThreadRidgeMesh.md

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

package/dist/docs/reference/geometry/helicalThreadSolidMesh.md

@@ -1,106 +0,0 @@
-# helicalThreadSolidMesh
-
-Builds one closed threaded cylinder without a ridge/core Boolean seam.
-
-**helicalThreadSolidMesh**(`options`: [`HelicalThreadSolidMeshOptions`](HelicalThreadSolidMeshOptions.md)): [`TriangleMesh`](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`** · [`HelicalThreadSolidMeshOptions`](HelicalThreadSolidMeshOptions.md) · Required
-
-- [`length`](HelicalThreadSolidMeshOptions.md#length) · `number` · Required
-
-  Total threaded axial length in millimetres.
-
-- [`majorDiameter`](HelicalThreadSolidMeshOptions.md#majordiameter) · `number` · Required
-
-  Nominal major diameter before any caller-owned fit compensation.
-
-- [`profile`](HelicalThreadSolidMeshOptions.md#profile) · [`ThreadProfile`](ThreadProfile-type.md) · Required
-
-  Validated periodic profile repeated around the shaft.
-
-- [`ends`](HelicalThreadSolidMeshOptions.md#ends) · [`ThreadEndTreatmentOptions`](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`](HelicalThreadSolidMeshOptions.md#handedness) · [`ThreadHandedness`](ThreadHandedness.md) · Optional
-
-  Helix direction. Default: `right`.
-
-- [`limits`](HelicalThreadSolidMeshOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
-
-  Explicit output and circular allocation ceilings.
-
-- [`phase`](HelicalThreadSolidMeshOptions.md#phase) · `number` · Optional
-
-  Angular offset of the first start in degrees. Default: `0`.
-
-- [`resolution`](HelicalThreadSolidMeshOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
-
-  Optional circular-resolution policy.
-
-- [`starts`](HelicalThreadSolidMeshOptions.md#starts) · `number` · Optional
-
-  Number of evenly phased starts. Default: `1`.
-
-- [`tolerance`](HelicalThreadSolidMeshOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
-
-  Optional numerical tolerance overrides.
-
-- [`bevelBottom`](HelicalThreadSolidMeshOptions.md#bevelbottom) · `boolean` · Optional
-
-  Apply a 45-degree radial bevel at the lower target face.
-
-- [`bevelBottomSize`](HelicalThreadSolidMeshOptions.md#bevelbottomsize) · `number` · Optional
-
-  Lower bevel size override. Takes precedence over `bevelSize`.
-
-- [`bevelOffset`](HelicalThreadSolidMeshOptions.md#beveloffset) · `number` · Optional
-
-  Distance of each bevel target face inward from the corresponding mesh end.
-
-- [`bevelMode`](HelicalThreadSolidMeshOptions.md#bevelmode) · `"inset"` \| `"outset"` · Optional
-
-  `inset` trims an external rod; `outset` expands an internal cutter.
-
-- [`bevelSize`](HelicalThreadSolidMeshOptions.md#bevelsize) · `number` · Optional
-
-  Axial and radial bevel size. Defaults to the profile depth.
-
-- [`bevelTop`](HelicalThreadSolidMeshOptions.md#beveltop) · `boolean` · Optional
-
-  Apply a 45-degree radial bevel at the upper target face.
-
-- [`bevelTopSize`](HelicalThreadSolidMeshOptions.md#beveltopsize) · `number` · Optional
-
-  Upper bevel size override. Takes precedence over `bevelSize`.
-
-
-
-## Returns
-
-[`TriangleMesh`](TriangleMesh.md)
-
-
-## Related APIs
-
-- [HelicalThreadSolidMeshOptions](HelicalThreadSolidMeshOptions.md)
-- [TriangleMesh](TriangleMesh.md)
-
-## Guides
-
-- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
-
-Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/meshBounds.md

@@ -1,39 +0,0 @@
-# meshBounds
-
-Computes axis-aligned bounds for a non-empty mesh.
-
-`const` **meshBounds**: (`mesh`: [`TriangleMesh`](TriangleMesh.md)) => [`Bounds3Data`](Bounds3Data.md)
-
-
-
-## Parameters
-
-<a id="mesh"></a>
-
-**`mesh`** · [`TriangleMesh`](TriangleMesh.md) · Required
-
-Mesh whose finite complete vertices will be measured.
-
-
-
-## Returns
-
-[`Bounds3Data`](Bounds3Data.md)
-
-Fresh immutable minimum and maximum XYZ tuples.
-
-
-## Throws
-
-- GeometryError When the mesh is structurally invalid.
-
-## Related APIs
-
-- [Bounds3Data](Bounds3Data.md)
-- [TriangleMesh](TriangleMesh.md)
-
-## Guides
-
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
-
-Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,95 +0,0 @@
-# optimizePlanarPatches
-
-Improves pathological planar triangulation with bounded legal diagonal flips.
-
-**optimizePlanarPatches**(`mesh`: [`TriangleMesh`](TriangleMesh.md), `options?`: [`PlanarMeshOptimizationOptions`](PlanarMeshOptimizationOptions.md)): [`PlanarMeshOptimizationResult`](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 returns the
-exact original mesh object. Malformed buffers and the configured analysis complexity limit throw.
-
-## Parameters
-
-<a id="mesh"></a>
-
-**`mesh`** · [`TriangleMesh`](TriangleMesh.md) · Required
-
-Closed, consistently wound indexed triangle mesh in arbitrary consistent units.
-
-
-
-<a id="options"></a>
-
-**`options`** · [`PlanarMeshOptimizationOptions`](PlanarMeshOptimizationOptions.md) · Optional
-
-Patch eligibility, numeric tolerance, and deterministic work bounds.
-
-- [`maxFlipAttempts`](PlanarMeshOptimizationOptions.md#maxflipattempts) · `number` · Optional
-
-  Maximum attempted edge evaluations. By default this is twenty times the initial candidate
-  edge count, capped at `1000000`.
-
-- [`maxEdgeRevisits`](PlanarMeshOptimizationOptions.md#maxedgerevisits) · `number` · Optional
-
-  Maximum times one edge may be reconsidered after neighbouring flips. Defaults to `12`.
-
-- [`maxPatchTriangles`](PlanarMeshOptimizationOptions.md#maxpatchtriangles) · `number` · Optional
-
-  Maximum triangles allowed in one selected patch. Defaults to `50000`.
-
-- [`maxProcessedTriangles`](PlanarMeshOptimizationOptions.md#maxprocessedtriangles) · `number` · Optional
-
-  Maximum cumulative triangles across selected patches. Defaults to `200000`.
-
-- [`minPatchTriangles`](PlanarMeshOptimizationOptions.md#minpatchtriangles) · `number` · Optional
-
-  Minimum triangles required before a planar patch is eligible. Defaults to `8`.
-
-- [`triggerMaxAspectRatio`](PlanarMeshOptimizationOptions.md#triggermaxaspectratio) · `number` · Optional
-
-  Select patches whose worst normalized aspect ratio exceeds this value. Defaults to `12`.
-
-- [`triggerMaxFanRatio`](PlanarMeshOptimizationOptions.md#triggermaxfanratio) · `number` · Optional
-
-  Select patches whose largest per-vertex triangle share exceeds this ratio. Defaults to `0.2`.
-
-- [`triggerMaxVertexTriangleIncidence`](PlanarMeshOptimizationOptions.md#triggermaxvertextriangleincidence) · `number` · Optional
-
-  Select patches whose largest vertex triangle incidence exceeds this value. Defaults to `16`.
-
-- [`triggerMinAngleDegrees`](PlanarMeshOptimizationOptions.md#triggerminangledegrees) · `number` · Optional
-
-  Select patches whose smallest interior angle is below this many degrees. Defaults to `8`.
-
-- [`maxTriangles`](PlanarMeshOptimizationOptions.md#maxtriangles) · `number` · Optional
-
-  Maximum number of triangles inspected. Defaults to `200000`.
-
-- [`tolerance`](PlanarMeshOptimizationOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
-
-  Numeric comparison overrides; model coordinates are interpreted in their existing units.
-
-
-
-## Returns
-
-[`PlanarMeshOptimizationResult`](PlanarMeshOptimizationResult.md)
-
-Optimized connectivity and before/after diagnostics, or an unchanged safe fallback.
-
-
-## Related APIs
-
-- [PlanarMeshOptimizationOptions](PlanarMeshOptimizationOptions.md)
-- [PlanarMeshOptimizationResult](PlanarMeshOptimizationResult.md)
-- [TriangleMesh](TriangleMesh.md)
-
-## Guides
-
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
-
-Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/preflightHelicalThreadSolidMesh.md

@@ -1,105 +0,0 @@
-# preflightHelicalThreadSolidMesh
-
-Checks thread dimensions, profile, end treatments, sampling, and conservative estimates against output limits.
-
-**preflightHelicalThreadSolidMesh**(`options`: [`HelicalThreadSolidMeshOptions`](HelicalThreadSolidMeshOptions.md)): [`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.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.
-
-## Parameters
-
-<a id="options"></a>
-
-**`options`** · [`HelicalThreadSolidMeshOptions`](HelicalThreadSolidMeshOptions.md) · Required
-
-- [`length`](HelicalThreadSolidMeshOptions.md#length) · `number` · Required
-
-  Total threaded axial length in millimetres.
-
-- [`majorDiameter`](HelicalThreadSolidMeshOptions.md#majordiameter) · `number` · Required
-
-  Nominal major diameter before any caller-owned fit compensation.
-
-- [`profile`](HelicalThreadSolidMeshOptions.md#profile) · [`ThreadProfile`](ThreadProfile-type.md) · Required
-
-  Validated periodic profile repeated around the shaft.
-
-- [`ends`](HelicalThreadSolidMeshOptions.md#ends) · [`ThreadEndTreatmentOptions`](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`](HelicalThreadSolidMeshOptions.md#handedness) · [`ThreadHandedness`](ThreadHandedness.md) · Optional
-
-  Helix direction. Default: `right`.
-
-- [`limits`](HelicalThreadSolidMeshOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
-
-  Explicit output and circular allocation ceilings.
-
-- [`phase`](HelicalThreadSolidMeshOptions.md#phase) · `number` · Optional
-
-  Angular offset of the first start in degrees. Default: `0`.
-
-- [`resolution`](HelicalThreadSolidMeshOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
-
-  Optional circular-resolution policy.
-
-- [`starts`](HelicalThreadSolidMeshOptions.md#starts) · `number` · Optional
-
-  Number of evenly phased starts. Default: `1`.
-
-- [`tolerance`](HelicalThreadSolidMeshOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
-
-  Optional numerical tolerance overrides.
-
-- [`bevelBottom`](HelicalThreadSolidMeshOptions.md#bevelbottom) · `boolean` · Optional
-
-  Apply a 45-degree radial bevel at the lower target face.
-
-- [`bevelBottomSize`](HelicalThreadSolidMeshOptions.md#bevelbottomsize) · `number` · Optional
-
-  Lower bevel size override. Takes precedence over `bevelSize`.
-
-- [`bevelOffset`](HelicalThreadSolidMeshOptions.md#beveloffset) · `number` · Optional
-
-  Distance of each bevel target face inward from the corresponding mesh end.
-
-- [`bevelMode`](HelicalThreadSolidMeshOptions.md#bevelmode) · `"inset"` \| `"outset"` · Optional
-
-  `inset` trims an external rod; `outset` expands an internal cutter.
-
-- [`bevelSize`](HelicalThreadSolidMeshOptions.md#bevelsize) · `number` · Optional
-
-  Axial and radial bevel size. Defaults to the profile depth.
-
-- [`bevelTop`](HelicalThreadSolidMeshOptions.md#beveltop) · `boolean` · Optional
-
-  Apply a 45-degree radial bevel at the upper target face.
-
-- [`bevelTopSize`](HelicalThreadSolidMeshOptions.md#beveltopsize) · `number` · Optional
-
-  Upper bevel size override. Takes precedence over `bevelSize`.
-
-
-
-## Returns
-
-[`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
-
-
-## Related APIs
-
-- [HelicalThreadSolidMeshOptions](HelicalThreadSolidMeshOptions.md)
-- [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
-- [helicalThreadSolidMesh](helicalThreadSolidMesh.md)
-
-## Guides
-
-- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
-
-Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/sweepMesh.md

@@ -1,86 +0,0 @@
-# sweepMesh
-
-Sweeps one explicitly ordered point loop, with caps or a geometrically matching closed seam.
-
-**sweepMesh**(`profile`: [`Path2Input`](Path2Input.md), `path`: [`Path3Input`](Path3Input.md), `options?`: [`SweepOptions`](SweepOptions.md)): [`TriangleMesh`](TriangleMesh.md)
-
-
-
-## Example: Sweep point data along a bent path
-
-```ts
-const profile = rectangleContour({ size: [6, 3] });
-sweepMesh(profile, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
-  orientation: { kind: "transport", initialNormal: [0, 1, 0] },
-});
-```
-
-## Parameters
-
-<a id="profile"></a>
-
-**`profile`** · [`Path2Input`](Path2Input.md) · Required
-
-
-
-<a id="path"></a>
-
-**`path`** · [`Path3Input`](Path3Input.md) · Required
-
-
-
-<a id="options"></a>
-
-**`options`** · [`SweepOptions`](SweepOptions.md) · Optional
-
-- [`closed`](SweepOptions.md#closed) · `boolean` · Optional
-
-  Raw point closure defaults to false; a Path3 supplies its closure and rejects conflicts.
-
-- [`limits`](SweepOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
-
-  Explicit output and sampling allocation ceilings.
-
-- [`orientation`](SweepOptions.md#orientation) · [`SweepOrientation`](SweepOrientation.md) · Optional
-
-  Explicit frame policy; default transport minimizes rotations, initially projecting +X then +Y then +Z.
-
-- [`resolution`](SweepOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
-
-  Physical sampling of nonzero twist; inserted stations retain authored station controls.
-
-- [`twist`](SweepOptions.md#twist) · `number` · Optional
-
-  Total additional profile rotation in degrees, with progression selected by twistBy.
-
-- [`twistBy`](SweepOptions.md#twistby) · `"length"` \| `"stations"` · Optional
-
-  Twist advances by physical path length (default), or normalized authored station position, including a closed seam gap.
-
-- [`scale`](SweepOptions.md#scale) · `number` \| [`Vector2Input`](Vector2Input.md) \| readonly [`Vector2Input`](Vector2Input.md)[] · Optional
-
-  Positive uniform/XY scale, or one XY pair per path station. Defaults to one.
-
-- [`seamProfileOffset`](SweepOptions.md#seamprofileoffset) · `number` · Optional
-
-  Corresponding point-index advance at a rotationally equivalent closed seam.
-
-
-
-## Returns
-
-[`TriangleMesh`](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.16.0`.

package/dist/docs/reference/model/FinalizedModel.md

@@ -1,131 +0,0 @@
-# FinalizedModel
-
-Finalized manufacturing snapshot. Its arrays are independent of all native values.
-
-## Extended by
-
-- [`ModelSnapshot`](../engine/ModelSnapshot.md)
-
-## Properties
-
-### parts
-
-
-
-`readonly` **parts**: readonly [`FinalizedPart`](FinalizedPart.md)[]
-
-
-
-Ordered finalized manufacturing parts with copied transferable arrays.
-
-***
-
-### bounds
-
-
-
-`readonly` **bounds**: [`Bounds3Data`](Bounds3Data.md)
-
-
-
-Axis-aligned XYZ bounds in millimetres.
-
-***
-
-### stats
-
-
-
-`readonly` **stats**: `object`
-
-
-
-Aggregate counts, unique backing storage, volume, and execution timings.
-
-#### partCount
-
-
-
-`readonly` **partCount**: `number`
-
-
-
-Number of declared output parts, including repeated geometry instances.
-
-#### vertexCount
-
-
-
-`readonly` **vertexCount**: `number`
-
-
-
-Aggregate position-buffer vertex count.
-
-#### triangleCount
-
-
-
-`readonly` **triangleCount**: `number`
-
-
-
-Aggregate indexed triangle count.
-
-#### volumeMm3
-
-
-
-`readonly` **volumeMm3**: `number`
-
-
-
-Signed enclosed volume of all selected parts in cubic millimetres.
-
-#### byteCount
-
-
-
-`readonly` **byteCount**: `number`
-
-
-
-Unique transferable backing-buffer bytes, counted once across all parts.
-
-#### buildMs
-
-
-
-`readonly` **buildMs**: `number`
-
-
-
-Synchronous callback duration in milliseconds.
-
-#### finalizationMs
-
-
-
-`readonly` **finalizationMs**: `number`
-
-
-
-Manufacturing validation and buffer finalization duration in milliseconds.
-
-#### generationMs
-
-
-
-`readonly` **generationMs**: `number`
-
-
-
-Total generation duration, including cache retention and native cleanup, in milliseconds.
-
-
-## Related APIs
-
-- [Bounds3Data](Bounds3Data.md)
-- [FinalizedPart](FinalizedPart.md)
-
-Package: `@metamesh/modeling@0.16.0`.