@metamesh/modeling 0.16.0 → 0.18.0

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

@@ -34,4 +34,4 @@ Multiplies a vector by a dimensionless scalar.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -40,4 +40,4 @@ scale3([1, 2, 3], 2); // [2, 4, 6]
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -36,4 +36,4 @@ A frozen row-major transform.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -27,4 +27,4 @@ Returns the signed area of a non-duplicated loop; positive means CCW.
 
 - [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -1,40 +1,42 @@
 # starContour
 
-Creates a centered CCW alternating-radius star within the selected profile sampling ceiling.
+Creates an immutable centered CCW alternating-radius star within the selected profile sampling ceiling.
 
-`const` **starContour**: (`outerRadius`: `number`, `points`: `number`, `innerRadius?`: `number`, `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>) => readonly [`Vector2Data`](Vector2Data.md)[]
+`const` **starContour**: (`options`: [`StarContourOptions`](StarContourOptions.md)) => readonly [`Vector2Data`](Vector2Data.md)[]
 
 
 
 ## Example: Five-point outline
 
 ```ts
-starContour(12, 5, 6);
+starContour({ outerRadius: 12, innerRadius: 6, points: 5 });
 ```
 
 ## Parameters
 
-<a id="outerradius"></a>
+<a id="options"></a>
 
-**`outerRadius`** · `number` · Required
+**`options`** · [`StarContourOptions`](StarContourOptions.md) · Required
 
+- [`outerRadius`](StarContourOptions.md#outerradius) · `number` · Required
 
+  Positive outer vertex radius in millimetres.
 
-<a id="points"></a>
+- [`innerRadius`](StarContourOptions.md#innerradius) · `number` · Required
 
-**`points`** · `number` · Required
+  Positive inner vertex radius in millimetres, smaller than the outer radius.
 
+- [`points`](StarContourOptions.md#points) · `number` · Required
 
+  Integer outer point count, at least three; output contains twice as many vertices.
 
-<a id="innerradius"></a>
+- [`rotation`](StarContourOptions.md#rotation) · `number` · Optional
 
-**`innerRadius`** · `number` · Optional
+  Counterclockwise rotation in degrees; defaults to zero with an outer vertex on +X.
 
+- [`limits`](StarContourOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
-
-<a id="limits"></a>
-
-**`limits`** · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+  Explicit sampling ceilings, bounded by the host policy during modeling.
 
 
 
@@ -45,11 +47,11 @@ readonly [`Vector2Data`](Vector2Data.md)[]
 
 ## Related APIs
 
-- [GeometrySamplingLimits](GeometrySamplingLimits.md)
+- [StarContourOptions](StarContourOptions.md)
 - [Vector2Data](Vector2Data.md)
 
 ## Guides
 
 - [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -64,4 +64,4 @@ intersection, falling back to bevels above SVG's default miter limit of 4.
 
 - [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -34,4 +34,4 @@ Subtracts `b` from `a` component-wise.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -40,4 +40,4 @@ subtract3([4, 5, 6], [1, 2, 3]); // [3, 3, 3]
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -38,4 +38,4 @@ non-decreasing, periodic at their endpoints, and reach radial zero.
 
 - [Conservative estimates 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/transform2.md

@@ -42,4 +42,4 @@ Use `toData()` for frozen matrix interchange.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -44,4 +44,4 @@ Use `toData()` for frozen matrix interchange.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -34,4 +34,4 @@ Signed linear determinant.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -41,4 +41,4 @@ Transforms serialized polygon data with reflection-safe winding, without an engi
 
 - [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -33,4 +33,4 @@ A frozen row-major transform.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -27,4 +27,4 @@ Ear-clips one normalized simple CCW loop into stable local vertex indices.
 
 - [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,35 @@
+# validateRigidTransform3
+
+Validates a proper rigid transform: finite translation and a right-handed orthonormal rotation. Scale, shear, reflection, and perspective are rejected within the default angular tolerance. Returns the original row-major 4x4 matrix without copying or normalizing it.
+
+**validateRigidTransform3**(`transform`: [`Transform3Data`](Transform3Data.md)): [`Transform3Data`](Transform3Data.md)
+
+
+
+## Parameters
+
+<a id="transform"></a>
+
+**`transform`** · [`Transform3Data`](Transform3Data.md) · Required
+
+
+
+## Returns
+
+[`Transform3Data`](Transform3Data.md)
+
+
+## Throws
+
+- GeometryError For a malformed, non-finite, or non-rigid matrix.
+
+## Related APIs
+
+- [Transform3Data](Transform3Data.md)
+
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -45,4 +45,4 @@ The original transform after successful validation.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -36,4 +36,4 @@ Use `toData()` for frozen tuple interchange, or
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -43,4 +43,4 @@ Use `toData()` for frozen tuple interchange, or
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/geometry.md

@@ -2,7 +2,7 @@
 
 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.
+Use `@metamesh/modeling/geometry` for runtime-neutral calculations with curves, profiles, transforms, regions, meshes, SVG, and mechanical geometry. These helpers work without an SDK or native engine.
 
 ```ts
 import { sampleCurve2, rectangleContour } from "@metamesh/modeling/geometry";
@@ -10,7 +10,7 @@ const arc = sampleCurve2({ kind: "arc", center: [0, 0], radius: 10, sweepAngle:
 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.
+Lengths use millimetres. Winding and closing conventions are explicit. The [mesh module](mesh.md) constructs and processes ordinary triangle buffers; `mesh.join` concatenates without Boolean union. Mesh inspection reads mutable external arrays afresh. Predictable allocations are checked against limits before sampling.
 
 Use `bounds2`/`bounds3` for immutable measurement queries and `Bounds2Data`/`Bounds3Data` for min/max records. Standalone bounds helpers fit and arrange parts from either form. Fit text vector paths before sampling to retain physical tolerance.
 
@@ -19,14 +19,14 @@ Choose [fluent values or standalone algorithms](../guides/concepts.md#choose-flu
 ## Categories
 
 - [Mechanical foundations](geometry/categories/mechanical.md) — Resolve gears, knuckle joints, 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.
+- [Triangle meshes and surfaces](geometry/categories/meshes.md) — Data, options, and reports for triangle mesh construction and processing.
+- [SVG and vector layouts](geometry/categories/vector-import.md) — Parse painted SVG within limits and work with explicitly 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.
+- [Curves and paths](geometry/categories/curves-paths.md) — Sample reusable lines, arcs, cubic curves, and path frames with explicit physical sampling settings.
 - [Bounds and 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.
+- [Transforms and vector math](geometry/categories/transforms-math.md) — Build reusable placements and calculate with immutable fluent vectors or tuple math.
+- [Resolution and errors](geometry/categories/resolution-errors.md) — Set physical sampling and numerical tolerances, and understand errors in context.
+- [Primitive options](geometry/categories/primitive-options.md) — Configure dimensional primitives and edge treatments with shared options.
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,79 @@
+# AcmeThreadProfileSpec
+
+ACME 29-degree included-angle profile.
+
+## Extends
+
+- [`ThreadProfileBaseSpec`](../geometry/ThreadProfileBaseSpec.md)
+
+## Properties
+
+### kind
+
+
+
+`readonly` **kind**: `"acme"`
+
+
+
+Selects the 29-degree ACME profile family.
+
+***
+
+### depth?
+
+
+
+`readonly` `optional` **depth?**: `number`
+
+
+
+Radial depth in millimetres.
+
+#### Default Value
+
+`pitch / 2`
+
+***
+
+### pitch
+
+
+
+`readonly` **pitch**: `number`
+
+
+
+Adjacent axial thread spacing in millimetres.
+
+#### Inherited from
+
+[`ThreadProfileBaseSpec`](../geometry/ThreadProfileBaseSpec.md).[`pitch`](../geometry/ThreadProfileBaseSpec.md#pitch)
+
+***
+
+### tolerance?
+
+
+
+`readonly` `optional` **tolerance?**: [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md)
+
+
+
+Optional numerical tolerance overrides.
+
+#### Inherited from
+
+[`ThreadProfileBaseSpec`](../geometry/ThreadProfileBaseSpec.md).[`tolerance`](../geometry/ThreadProfileBaseSpec.md#tolerance)
+
+
+## Related APIs
+
+- [GeometryToleranceOptions](GeometryToleranceOptions.md)
+- [ThreadProfileBaseSpec](ThreadProfileBaseSpec.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,18 @@
+# Bevel
+
+One size for both ends, or independent sizes in bottom/top order. Zero disables an end.
+
+**Bevel** = [`BevelSize`](../geometry/BevelSize.md) \| readonly \[`bottom`: [`BevelSize`](../geometry/BevelSize.md), `top`: [`BevelSize`](../geometry/BevelSize.md)\]
+
+
+
+
+## Related APIs
+
+- [BevelSize](BevelSize.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,14 @@
+# BevelSize
+
+Nonnegative 45-degree axial/radial bevel size in millimetres, or factory automatic sizing.
+
+**BevelSize** = `number` \| `"auto"`
+
+
+
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,125 @@
+# Bounds2
+
+Immutable finite XY bounds in millimetres, with tuple coordinates for data interoperability.
+
+## Extends
+
+- [`Bounds2Data`](../geometry/Bounds2Data.md)
+
+## Properties
+
+### max
+
+
+
+`readonly` **max**: [`Vector2Data`](../geometry/Vector2Data.md)
+
+
+
+Inclusive maximum X/Y coordinates.
+
+#### Inherited from
+
+[`Bounds2Data`](../geometry/Bounds2Data.md).[`max`](../geometry/Bounds2Data.md#max)
+
+***
+
+### min
+
+
+
+`readonly` **min**: [`Vector2Data`](../geometry/Vector2Data.md)
+
+
+
+Inclusive minimum X/Y coordinates.
+
+#### Inherited from
+
+[`Bounds2Data`](../geometry/Bounds2Data.md).[`min`](../geometry/Bounds2Data.md#min)
+
+## Methods
+
+### size()
+
+
+
+**size**(): [`Vector2`](../geometry/Vector2-type.md)
+
+
+
+Returns nonnegative X/Y dimensions in millimetres, including zero extents.
+
+#### Returns
+
+[`Vector2`](../geometry/Vector2-type.md)
+
+***
+
+### center()
+
+
+
+**center**(): [`Vector2`](../geometry/Vector2-type.md)
+
+
+
+Returns the midpoint in millimetres.
+
+#### Returns
+
+[`Vector2`](../geometry/Vector2-type.md)
+
+***
+
+### containsBounds()
+
+
+
+**containsBounds**(`other`: [`Bounds2Input`](../geometry/Bounds2Input.md)): `boolean`
+
+
+
+Tests positioned XY containment, including touching boundaries.
+
+#### Parameters
+
+<a id="other"></a>
+
+**`other`** · [`Bounds2Input`](../geometry/Bounds2Input.md) · Required
+
+
+
+#### Returns
+
+`boolean`
+
+***
+
+### toData()
+
+
+
+**toData**(): [`Bounds2Data`](../geometry/Bounds2Data.md)
+
+
+
+Returns this value's frozen plain record; repeated calls do not allocate.
+
+#### Returns
+
+[`Bounds2Data`](../geometry/Bounds2Data.md)
+
+
+## Related APIs
+
+- [Bounds2Data](Bounds2Data.md)
+- [Bounds2Input](Bounds2Input.md)
+- [Vector2](Vector2.md)
+- [Vector2Data](Vector2Data.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,43 @@
+# Bounds2Data
+
+Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods.
+
+## Extended by
+
+- [`Bounds2`](../geometry/Bounds2-type.md)
+
+## Properties
+
+### max
+
+
+
+`readonly` **max**: [`Vector2Data`](../geometry/Vector2Data.md)
+
+
+
+Inclusive maximum X/Y coordinates.
+
+***
+
+### min
+
+
+
+`readonly` **min**: [`Vector2Data`](../geometry/Vector2Data.md)
+
+
+
+Inclusive minimum X/Y coordinates.
+
+
+## Related APIs
+
+- [Bounds2](Bounds2.md)
+- [Vector2Data](Vector2Data.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,19 @@
+# Bounds2Input
+
+An immutable XY bounds value or its plain min/max representation.
+
+**Bounds2Input** = [`Bounds2`](../geometry/Bounds2-type.md) \| [`Bounds2Data`](../geometry/Bounds2Data.md)
+
+
+
+
+## Related APIs
+
+- [Bounds2](Bounds2.md)
+- [Bounds2Data](Bounds2Data.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.