@metamesh/modeling 0.12.0 → 0.14.0

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

@@ -0,0 +1,33 @@
+# transformPath3
+
+Applies an affine transform to a 3D path without mutating its points.
+
+**transformPath3**(`path`: [`Path3`](Path3.md), `placement`: [`Transform3Input`](Transform3Input.md)): [`Path3`](Path3.md)
+
+
+
+## Parameters
+
+<a id="path"></a>
+
+**`path`** · [`Path3`](Path3.md) · Required
+
+
+
+<a id="placement"></a>
+
+**`placement`** · [`Transform3Input`](Transform3Input.md) · Required
+
+
+
+## Returns
+
+[`Path3`](Path3.md)
+
+
+## Related APIs
+
+- [Path3](Path3.md)
+- [Transform3Input](Transform3Input.md)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,40 @@
+# transformRegionData
+
+Transforms serialized polygon data with reflection-safe winding, without an engine. Use Section.transform(placement) when authoring filled geometry; this utility serves pure data preparation.
+
+**transformRegionData**(`region`: [`RegionData`](RegionData.md), `transform`: [`Transform2Input`](Transform2Input.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`RegionData`](RegionData.md)
+
+
+
+## Parameters
+
+<a id="region"></a>
+
+**`region`** · [`RegionData`](RegionData.md) · Required
+
+
+
+<a id="transform"></a>
+
+**`transform`** · [`Transform2Input`](Transform2Input.md) · Required
+
+
+
+<a id="tolerance"></a>
+
+**`tolerance`** · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+
+
+
+## Returns
+
+[`RegionData`](RegionData.md)
+
+
+## Related APIs
+
+- [GeometryToleranceOptions](GeometryToleranceOptions.md)
+- [RegionData](RegionData.md)
+- [Transform2Input](Transform2Input.md)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,42 @@
+# transformTriangleMesh
+
+Applies an affine transform to a mesh and preserves outward face orientation.
+
+**transformTriangleMesh**(`mesh`: [`TriangleMesh`](TriangleMesh.md), `transform`: [`Transform3Matrix`](Transform3Matrix.md)): [`TriangleMesh`](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`** · [`TriangleMesh`](TriangleMesh.md) · Required
+
+Mesh to transform without mutation.
+
+
+
+<a id="transform"></a>
+
+**`transform`** · [`Transform3Matrix`](Transform3Matrix.md) · Required
+
+Row-major affine transform.
+
+
+
+## Returns
+
+[`TriangleMesh`](TriangleMesh.md)
+
+A mesh with fresh transformed positions and copied or reversed indices.
+
+
+## Related APIs
+
+- [Transform3Matrix](Transform3Matrix.md)
+- [TriangleMesh](TriangleMesh.md)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,35 @@
+# translationTransform3
+
+Creates an immutable translation transform.
+
+**translationTransform3**(`offset`: [`Vector3Tuple`](Vector3Tuple.md)): [`Transform3Matrix`](Transform3Matrix.md)
+
+
+
+## Parameters
+
+<a id="offset"></a>
+
+**`offset`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+
+Finite XYZ translation in model units.
+
+
+
+## Returns
+
+[`Transform3Matrix`](Transform3Matrix.md)
+
+A frozen row-major transform.
+
+
+## Related APIs
+
+- [Transform3Matrix](Transform3Matrix.md)
+- [Vector3Tuple](Vector3Tuple.md)
+
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,26 @@
+# triangulateContour
+
+Ear-clips one normalized simple CCW loop into stable local vertex indices.
+
+**triangulateContour**(`loop`: [`Contour`](Contour.md)): `Uint32Array`
+
+
+
+## Parameters
+
+<a id="loop"></a>
+
+**`loop`** · [`Contour`](Contour.md) · Required
+
+
+
+## Returns
+
+`Uint32Array`
+
+
+## Related APIs
+
+- [Contour](Contour.md)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,52 @@
+# validateSolidMesh
+
+Checks closed indexed topology, triangle intersections, and alternating nested shell orientation. Outward exterior shells and inward cavity shells are accepted. Separate shells must not touch, intersect, or overlap as material. Indexed neighbours may share their own vertex or edge.
+
+**validateSolidMesh**(`mesh`: [`TriangleMesh`](TriangleMesh.md), `options?`: [`SolidMeshValidationOptions`](SolidMeshValidationOptions.md)): [`TriangleMesh`](TriangleMesh.md)
+
+
+
+Uses bounded floating-point tests, not exact predicates or repair. Contacts within the selected
+tolerance reject conservatively. At most 200,000 triangles and 2,000,000 spatial/containment tests
+are supported; exhausting a ceiling throws COMPLEXITY_LIMIT rather than claiming validity.
+Input buffers are freshly inspected and never modified; units are millimetres.
+
+## Parameters
+
+<a id="mesh"></a>
+
+**`mesh`** · [`TriangleMesh`](TriangleMesh.md) · Required
+
+Closed triangle mesh to inspect.
+
+
+
+<a id="options"></a>
+
+**`options`** · [`SolidMeshValidationOptions`](SolidMeshValidationOptions.md) · Optional
+
+Optional lower work ceiling and numeric comparison policy.
+
+- [`maximumTests`](SolidMeshValidationOptions.md#maximumtests) · `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
+
+  Distance comparison policy in millimetres; near contacts reject conservatively.
+
+
+
+## Returns
+
+[`TriangleMesh`](TriangleMesh.md)
+
+The original mesh after every requested check succeeds.
+
+
+## Related APIs
+
+- [SolidMeshValidationOptions](SolidMeshValidationOptions.md)
+- [TriangleMesh](TriangleMesh.md)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,47 @@
+# validateTransform3
+
+Validates that a transform is finite, affine, and non-singular.
+
+**validateTransform3**(`transform`: [`Transform3Matrix`](Transform3Matrix.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Transform3Matrix`](Transform3Matrix.md)
+
+
+
+## Parameters
+
+<a id="transform"></a>
+
+**`transform`** · [`Transform3Matrix`](Transform3Matrix.md) · Required
+
+Row-major matrix to validate.
+
+
+
+<a id="tolerance"></a>
+
+**`tolerance`** · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+
+Optional comparison overrides.
+
+
+
+## Returns
+
+[`Transform3Matrix`](Transform3Matrix.md)
+
+The original transform after successful validation.
+
+
+## Throws
+
+- GeometryError For non-finite, non-affine, or singular matrices.
+
+## Related APIs
+
+- [GeometryToleranceOptions](GeometryToleranceOptions.md)
+- [Transform3Matrix](Transform3Matrix.md)
+
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,59 @@
+# validateTriangleMesh
+
+Validates mesh buffers, indices, triangle area, and optionally closed topology.
+
+**validateTriangleMesh**(`mesh`: [`TriangleMesh`](TriangleMesh.md), `options?`: [`TriangleMeshValidationOptions`](TriangleMeshValidationOptions.md)): [`TriangleMesh`](TriangleMesh.md)
+
+
+
+Closed validation requires exactly two oppositely directed uses per edge, rejecting boundary
+and non-manifold edges. It establishes edge connectivity without detecting geometric
+self-intersections between faces. The mesh is neither mutated nor copied.
+
+## Parameters
+
+<a id="mesh"></a>
+
+**`mesh`** · [`TriangleMesh`](TriangleMesh.md) · Required
+
+Mesh to inspect.
+
+
+
+<a id="options"></a>
+
+**`options`** · [`TriangleMeshValidationOptions`](TriangleMeshValidationOptions.md) · Optional
+
+Empty-mesh, topology, and tolerance policy.
+
+- [`allowEmpty`](TriangleMeshValidationOptions.md#allowempty) · `boolean` · Optional
+
+  Permit an empty position and index buffer. Defaults to `false`.
+
+- [`requireClosed`](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
+
+  Numeric comparison overrides used for zero-area triangle detection.
+
+
+
+## Returns
+
+[`TriangleMesh`](TriangleMesh.md)
+
+The original mesh after successful validation.
+
+
+## Throws
+
+- GeometryError When any requested invariant fails.
+
+## Related APIs
+
+- [TriangleMesh](TriangleMesh.md)
+- [TriangleMeshValidationOptions](TriangleMeshValidationOptions.md)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,31 @@
+# vector2
+
+Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates. Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates and overflow throw `NON_FINITE_VALUE` GeometryError. Use transform2().applyDirection(value) for rotations and nonuniform scaling.
+
+**vector2**(`input`: [`Vector2Input`](Vector2Input.md)): [`Vector2`](Vector2-type.md)
+
+
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Vector2Input`](Vector2Input.md) · Required
+
+
+
+## Returns
+
+[`Vector2`](Vector2-type.md)
+
+
+## Related APIs
+
+- [Vector2](Vector2-type.md)
+- [Vector2Input](Vector2Input.md)
+
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,38 @@
+# vector3
+
+Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates. Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates and overflow throw `NON_FINITE_VALUE` GeometryError. Use transform3().applyDirection(value) for rotations and nonuniform scaling.
+
+**vector3**(`input`: [`Vector3Input`](Vector3Input.md)): [`Vector3`](Vector3-type.md)
+
+
+
+## Example
+
+```ts
+const direction = vector3([1, 2, 3]).add([4, 0, 0]).normalize().scale(10);
+const alignment = direction.dot([0, 0, 1]);
+```
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Vector3Input`](Vector3Input.md) · Required
+
+
+
+## Returns
+
+[`Vector3`](Vector3-type.md)
+
+
+## Related APIs
+
+- [Vector3](Vector3-type.md)
+- [Vector3Input](Vector3Input.md)
+
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.14.0`.

package/dist/docs/reference/geometry.md

@@ -0,0 +1,30 @@
+# Geometry foundations
+
+Pure curves, profiles, regions, meshes, transforms, and mechanical construction without initializing a native engine.
+
+Import runtime-neutral geometry from `@metamesh/modeling/geometry`. Curves, profiles, transforms, regions, meshes, SVG parsing, and mechanical kernels work without an SDK or native engine.
+
+```ts
+import { sampleCurve2, rectangleContour } from "@metamesh/modeling/geometry";
+const arc = sampleCurve2({ kind: "arc", center: [0, 0], radius: 10, sweepDegrees: 90 });
+const contour = rectangleContour({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
+```
+
+Lengths use millimetres. Winding and closing conventions are explicit. Mutable external meshes are inspected freshly, and predictable allocations are bounded before sampling.
+
+Use shared Bounds2/Bounds3 and bounds helpers for measurements, positioned containment, fitting, and part layout. Fit text vector paths before sampling to retain physical tolerance.
+
+## Categories
+
+- [Mechanical foundations](geometry/categories/mechanical.md) — Resolve gears, fastener standards, thread profiles, fit, and predictable allocations.
+- [Triangle meshes and surfaces](geometry/categories/meshes.md) — Build, transform, validate, analyze, and locally optimize copied indexed meshes.
+- [SVG and vector layouts](geometry/categories/vector-import.md) — Parse bounded painted SVG and carry explicit prepared text geometry.
+- [Profiles and regions](geometry/categories/profiles-regions.md) — Define winding, holes, stable profile landmarks, and reusable planar boundaries.
+- [Curves and paths](geometry/categories/curves-paths.md) — Sample reusable lines, arcs, cubic curves, and path frames with explicit physical policies.
+- [Bounds & Layout](geometry/categories/bounds-layout.md) — Measure finite bounds, test positioned containment, and fit or arrange geometry.
+- [Pattern Placement](geometry/categories/pattern-placement.md) — Calculate pure linear, radial, grid, and path transforms.
+- [Transforms and vector math](geometry/categories/transforms-math.md) — Build immutable reusable placements and calculate with fluent vectors or tuple kernels.
+- [Resolution and errors](geometry/categories/resolution-errors.md) — Resolve physical sampling, numerical tolerances, and contextual failures.
+- [Primitive options](geometry/categories/primitive-options.md) — Share one option contract for dimensional primitives and edge treatments.
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,54 @@
+# Anchor3
+
+An attachment pose on a solid or assembly.
+
+`direction` is the outward attachment normal. `up` controls roll and must not
+be parallel to `direction`; anchor construction projects and normalizes it.
+
+## Properties
+
+### direction
+
+
+
+`readonly` **direction**: [`Vector3Tuple`](Vector3Tuple.md)
+
+
+
+Unit outward normal used as the anchor's local +Z direction.
+
+***
+
+### position
+
+
+
+`readonly` **position**: [`Vector3Tuple`](Vector3Tuple.md)
+
+
+
+World-space attachment position.
+
+***
+
+### up
+
+
+
+`readonly` **up**: [`Vector3Tuple`](Vector3Tuple.md)
+
+
+
+Roll guide projected into the plane perpendicular to `direction`.
+
+
+## Related APIs
+
+- [Vector3Tuple](Vector3Tuple.md)
+
+## Guides
+
+- [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
+- [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,63 @@
+# AttachOptions
+
+Degree-based anchor attachment controls for a scoped solid.
+
+## Properties
+
+### alignment?
+
+
+
+`readonly` `optional` **alignment?**: `"opposed"` \| `"same"`
+
+
+
+Align outward directions face-to-face (`opposed`) or in parallel (`same`).
+
+***
+
+### gap?
+
+
+
+`readonly` `optional` **gap?**: `number`
+
+
+
+Separation along the target anchor's outward direction in millimetres.
+
+***
+
+### spinDegrees?
+
+
+
+`readonly` `optional` **spinDegrees?**: `number`
+
+
+
+Additional right-handed roll about the attached direction, in degrees.
+
+***
+
+### tolerance?
+
+
+
+`readonly` `optional` **tolerance?**: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)
+
+
+
+Optional numeric comparison overrides.
+
+
+## Related APIs
+
+- [GeometryToleranceOptions](GeometryToleranceOptions.md)
+
+## Guides
+
+- [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
+- [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,39 @@
+# Bounds2
+
+Axis-aligned bounds in two-dimensional model space.
+
+## Properties
+
+### max
+
+
+
+`readonly` **max**: [`Vector2Tuple`](Vector2Tuple.md)
+
+
+
+Inclusive maximum X/Y coordinates.
+
+***
+
+### min
+
+
+
+`readonly` **min**: [`Vector2Tuple`](Vector2Tuple.md)
+
+
+
+Inclusive minimum X/Y coordinates.
+
+
+## Related APIs
+
+- [Vector2Tuple](Vector2Tuple.md)
+
+## Guides
+
+- [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
+- [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,39 @@
+# Bounds3
+
+Axis-aligned bounds in three-dimensional model space.
+
+## Properties
+
+### max
+
+
+
+`readonly` **max**: [`Vector3Tuple`](Vector3Tuple.md)
+
+
+
+Inclusive maximum X/Y/Z coordinates.
+
+***
+
+### min
+
+
+
+`readonly` **min**: [`Vector3Tuple`](Vector3Tuple.md)
+
+
+
+Inclusive minimum X/Y/Z coordinates.
+
+
+## Related APIs
+
+- [Vector3Tuple](Vector3Tuple.md)
+
+## Guides
+
+- [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
+- [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,15 @@
+# BoxEdge
+
+Box edges use +Z top, +Y front and +X right; vertical names list front/back first.
+
+**BoxEdge** = `"top-front"` \| `"top-back"` \| `"top-left"` \| `"top-right"` \| `"bottom-front"` \| `"bottom-back"` \| `"bottom-left"` \| `"bottom-right"` \| `"front-left"` \| `"front-right"` \| `"back-left"` \| `"back-right"`
+
+
+
+
+## Guides
+
+- [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
+- [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
+
+Package: `@metamesh/modeling@0.14.0`.

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

@@ -0,0 +1,19 @@
+# BoxEdgeSelection
+
+Named individual edges or top/bottom rims and all four vertical edges.
+
+**BoxEdgeSelection** = [`BoxEdge`](BoxEdge.md) \| `"top"` \| `"bottom"` \| `"vertical"`
+
+
+
+
+## Related APIs
+
+- [BoxEdge](BoxEdge.md)
+
+## Guides
+
+- [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
+- [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
+
+Package: `@metamesh/modeling@0.14.0`.