@metamesh/modeling 0.15.0 → 0.17.0

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

@@ -0,0 +1,38 @@
+# KnuckleHingeOptions
+
+Joint declaration with independent attachments; unspecified sampling inherits the evaluating host.
+
+**KnuckleHingeOptions** = [`KnuckleHingeSpec`](KnuckleHingeSpec.md) & [`KnuckleHingeSamplingOptions`](KnuckleHingeSamplingOptions.md) & `object`
+
+
+
+## Type Declaration
+
+### halfA?
+
+
+
+`readonly` `optional` **halfA?**: [`KnuckleHingeHalfOptions`](KnuckleHingeHalfOptions.md)
+
+
+
+Optional attachment and edge treatment for A, which owns an integral pin when present.
+
+### halfB?
+
+
+
+`readonly` `optional` **halfB?**: [`KnuckleHingeHalfOptions`](KnuckleHingeHalfOptions.md)
+
+
+
+Optional attachment and edge treatment for B, which always carries a running bore.
+
+
+## Related APIs
+
+- [KnuckleHingeHalfOptions](KnuckleHingeHalfOptions.md)
+- [KnuckleHingeSamplingOptions](KnuckleHingeSamplingOptions.md)
+- [KnuckleHingeSpec](KnuckleHingeSpec.md)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -0,0 +1,47 @@
+# KnuckleHingeSamplingOptions
+
+Shared circular sampling for barrels, shafts, and bores.
+
+## Properties
+
+### segments?
+
+
+
+`readonly` `optional` **segments?**: `number`
+
+
+
+Exact full-circle count, divisible by four and at least four; overrides adaptive sampling.
+
+***
+
+### resolution?
+
+
+
+`readonly` `optional` **resolution?**: [`GeometryResolution`](GeometryResolution.md)
+
+
+
+Physical tessellation policy. Exact circular counts must also be divisible by four.
+
+***
+
+### limits?
+
+
+
+`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>
+
+
+
+Explicit allocation ceilings; defaults to the pure geometry sampling limits.
+
+
+## Related APIs
+
+- [GeometryResolution](GeometryResolution.md)
+- [GeometrySamplingLimits](GeometrySamplingLimits.md)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -0,0 +1,18 @@
+# KnuckleHingeSpec
+
+Knuckle-joint construction modes and interval ownership.
+
+**KnuckleHingeSpec** = [`KnuckleHingeBaseSpec`](KnuckleHingeBaseSpec.md) & (\{ `mode`: `"print-in-place"` \| `"inserted-pin"`; `pinEngagement?`: `never`; \} \| \{ `mode`: `"lift-off"`; `knuckleCount`: `2`; `pinEngagement`: `number`; \})
+
+
+
+Print-in-place requires an odd count of at least three: A owns both
+end anchors and the entire shaft. Inserted-pin bores both halves and supplies no shaft.
+Lift-off requires exactly two intervals; A's integral pin enters B without a far anchor.
+
+
+## Related APIs
+
+- [KnuckleHingeBaseSpec](KnuckleHingeBaseSpec.md)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -0,0 +1,53 @@
+# KnuckleHingeWeb
+
+Rectangular connection from the axis into a caller-owned mounting body, in millimetres.
+
+## Properties
+
+### direction
+
+
+
+`readonly` **direction**: `"positive-y"` \| `"negative-y"`
+
+
+
+Direction from the pin axis; independently chosen for each half.
+
+***
+
+### reach
+
+
+
+`readonly` **reach**: `number`
+
+
+
+Positive distance from the axis to the web's far edge. Overlap into the mounting body.
+
+***
+
+### zMin
+
+
+
+`readonly` **zMin**: `number`
+
+
+
+Lower-face Z coordinate in the pin-centered frame, in millimetres. Must overlap the barrel's interior.
+
+***
+
+### thickness
+
+
+
+`readonly` **thickness**: `number`
+
+
+
+Positive thickness along +Z. Each web spans its own barrel interval.
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -34,5 +34,6 @@ Direction of repetition; magnitude is ignored. Defaults to +X.
 
 - [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)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -24,4 +24,4 @@ correspondence must remain authoritative.
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -88,4 +88,4 @@ Explicit output and sampling budgets; native operations may only lower host ceil
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -70,4 +70,4 @@ Excluded when an explicit spatial frame is supplied.
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -32,4 +32,4 @@ Filled Section recipe or ordered XY boundary point data.
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -32,4 +32,4 @@ Explicit per-profile and circular ceilings; the family also has a one-million-sl
 - [GeometryResolution](GeometryResolution.md)
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -41,4 +41,8 @@ Typed synchronous declaration callback.
 
 - [GenerateCallback](GenerateCallback.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -123,4 +123,4 @@ Maximum unique transferable output backing-buffer bytes.
 
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -4,4 +4,11 @@ Numeric storage supported by immutable generation buffers.
 
 **NumericArray** = `Float32Array` \| `Float64Array` \| `Uint32Array` \| `Uint8Array` \| `Int32Array`
 
-Package: `@metamesh/modeling@0.15.0`.
+
+
+
+## Guides
+
+- [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -13,4 +13,8 @@ Manufacturing geometry; filled sections are intermediate construction values.
 - [Solid](Solid.md)
 - [TriangleMesh](TriangleMesh.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -62,4 +62,8 @@ Optional six-digit hexadecimal semantic part color.
 - [PartGeometry](PartGeometry.md)
 - [Vector3Input](Vector3Input.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
+
+Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/model/Path2-type.md

@@ -28,15 +28,15 @@ Whether traversal includes the last-to-first edge.
 
 ## Methods
 
-### toArray()
+### toData()
 
 
 
-**toArray**(): [`Path2Data`](Path2Data.md)
+**toData**(): [`Path2Data`](Path2Data.md)
 
 
 
-Returns frozen tuple coordinates; closure remains separate metadata. Repeated calls do not allocate.
+Returns complete deeply frozen path data, including dimension and closure. Repeated calls do not allocate.
 
 #### Returns
 
@@ -64,15 +64,15 @@ Total sampled edge length in model units, including the closing edge when closed
 
 
 
-**bounds**(): [`Bounds2`](Bounds2.md) \| `undefined`
+**bounds**(): [`Bounds2`](Bounds2-type.md) \| `undefined`
 
 
 
-Axis-aligned bounds, or undefined for an empty path.
+Immutable axis-aligned bounds, or undefined for an empty path.
 
 #### Returns
 
-[`Bounds2`](Bounds2.md) \| `undefined`
+[`Bounds2`](Bounds2-type.md) \| `undefined`
 
 ***
 
@@ -181,7 +181,7 @@ Returns a path sampled at equal arc lengths. Corners may be bridged; closure is
 
 ## Related APIs
 
-- [Bounds2](Bounds2.md)
+- [Bounds2](Bounds2-type.md)
 - [Path2Data](Path2Data.md)
 - [PathLocation](PathLocation.md)
 - [PathResamplingOptions](PathResamplingOptions.md)
@@ -189,4 +189,8 @@ Returns a path sampled at equal arc lengths. Corners may be bridged; closure is
 - [Vector2](Vector2-type.md)
 - [Vector2Input](Vector2Input.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,14 +1,50 @@
 # Path2Data
 
-XY point tuples for interchange; closure is supplied by the consuming operation or Path2 value.
+Complete plain XY path representation, including topology and empty-path dimensional identity.
 
-**Path2Data** = readonly [`Vector2Tuple`](Vector2Tuple.md)[]
+## Properties
 
+### dimension
 
 
 
+`readonly` **dimension**: `2`
+
+
+
+Coordinate dimension, retained even when points is empty.
+
+***
+
+### points
+
+
+
+`readonly` **points**: readonly [`Vector2Data`](Vector2Data.md)[]
+
+
+
+Frozen or caller-owned XY coordinates; closed paths omit a duplicated seam.
+
+***
+
+### closed
+
+
+
+`readonly` **closed**: `boolean`
+
+
+
+Whether traversal includes the last-to-first edge.
+
+
 ## Related APIs
 
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.md)
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,8 +1,8 @@
 # Path2Input
 
-An immutable XY sampled path or a collection of XY tuples and fluent vectors.
+A matching path value, complete plain path data, or a collection of vectors.
 
-**Path2Input** = [`Path2`](Path2-type.md) \| readonly [`Vector2Input`](Vector2Input.md)[]
+**Path2Input** = [`Path2`](Path2-type.md) \| [`Path2Data`](Path2Data.md) \| readonly [`Vector2Input`](Vector2Input.md)[]
 
 
 
@@ -10,6 +10,11 @@ An immutable XY sampled path or a collection of XY tuples and fluent vectors.
 ## Related APIs
 
 - [Path2](Path2-type.md)
+- [Path2Data](Path2Data.md)
 - [Vector2Input](Vector2Input.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/model/Path3-type.md

@@ -28,15 +28,15 @@ Whether traversal includes the last-to-first edge.
 
 ## Methods
 
-### toArray()
+### toData()
 
 
 
-**toArray**(): [`Path3Data`](Path3Data.md)
+**toData**(): [`Path3Data`](Path3Data.md)
 
 
 
-Returns frozen tuple coordinates; closure remains separate metadata. Repeated calls do not allocate.
+Returns complete deeply frozen path data, including dimension and closure. Repeated calls do not allocate.
 
 #### Returns
 
@@ -64,15 +64,15 @@ Total sampled edge length in model units, including the closing edge when closed
 
 
 
-**bounds**(): [`Bounds3`](Bounds3.md) \| `undefined`
+**bounds**(): [`Bounds3`](Bounds3-type.md) \| `undefined`
 
 
 
-Axis-aligned bounds, or undefined for an empty path.
+Immutable axis-aligned bounds, or undefined for an empty path.
 
 #### Returns
 
-[`Bounds3`](Bounds3.md) \| `undefined`
+[`Bounds3`](Bounds3-type.md) \| `undefined`
 
 ***
 
@@ -181,7 +181,7 @@ Returns a path sampled at equal arc lengths. Corners may be bridged; closure is
 
 ## Related APIs
 
-- [Bounds3](Bounds3.md)
+- [Bounds3](Bounds3-type.md)
 - [Path3Data](Path3Data.md)
 - [PathLocation](PathLocation.md)
 - [PathResamplingOptions](PathResamplingOptions.md)
@@ -189,4 +189,8 @@ Returns a path sampled at equal arc lengths. Corners may be bridged; closure is
 - [Vector3](Vector3-type.md)
 - [Vector3Input](Vector3Input.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,14 +1,50 @@
 # Path3Data
 
-XYZ point tuples for interchange; closure is supplied by the consuming operation or Path3 value.
+Complete plain XYZ path representation, including topology and empty-path dimensional identity.
 
-**Path3Data** = readonly [`Vector3Tuple`](Vector3Tuple.md)[]
+## Properties
 
+### dimension
 
 
 
+`readonly` **dimension**: `3`
+
+
+
+Coordinate dimension, retained even when points is empty.
+
+***
+
+### points
+
+
+
+`readonly` **points**: readonly [`Vector3Data`](Vector3Data.md)[]
+
+
+
+Frozen or caller-owned XYZ coordinates; closed paths omit a duplicated seam.
+
+***
+
+### closed
+
+
+
+`readonly` **closed**: `boolean`
+
+
+
+Whether traversal includes the last-to-first edge.
+
+
 ## Related APIs
 
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector3Data](Vector3Data.md)
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,8 +1,8 @@
 # Path3Input
 
-An immutable XYZ sampled path or a collection of XYZ tuples and fluent vectors.
+A matching path value, complete plain path data, or a collection of vectors.
 
-**Path3Input** = [`Path3`](Path3-type.md) \| readonly [`Vector3Input`](Vector3Input.md)[]
+**Path3Input** = [`Path3`](Path3-type.md) \| [`Path3Data`](Path3Data.md) \| readonly [`Vector3Input`](Vector3Input.md)[]
 
 
 
@@ -10,6 +10,11 @@ An immutable XYZ sampled path or a collection of XYZ tuples and fluent vectors.
 ## Related APIs
 
 - [Path3](Path3-type.md)
+- [Path3Data](Path3Data.md)
 - [Vector3Input](Vector3Input.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -62,4 +62,8 @@ Clamped fraction along that edge, not the whole path's normalized arc length.
 - [Vector2](Vector2-type.md)
 - [Vector3](Vector3-type.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -2,7 +2,7 @@
 
 Supplies a profile-X orientation guide for each original normalized sweep station.
 
-**PathNormalGuide** = (`point`: [`Vector3Tuple`](Vector3Tuple.md), `index`: `number`) => [`Vector3Input`](Vector3Input.md)
+**PathNormalGuide** = (`point`: [`Vector3Data`](Vector3Data.md), `index`: `number`) => [`Vector3Input`](Vector3Input.md)
 
 
 
@@ -10,7 +10,7 @@ Supplies a profile-X orientation guide for each original normalized sweep statio
 
 <a id="point"></a>
 
-**`point`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
+**`point`** · [`Vector3Data`](Vector3Data.md) · Required
 
 Current XYZ path point in model units.
 
@@ -33,8 +33,8 @@ A finite guide vector that is not parallel to the local path tangent.
 
 ## Related APIs
 
+- [Vector3Data](Vector3Data.md)
 - [Vector3Input](Vector3Input.md)
-- [Vector3Tuple](Vector3Tuple.md)
 
 ## Guides
 
@@ -43,4 +43,4 @@ A finite guide vector that is not parallel to the local path tangent.
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -31,4 +31,8 @@ Construction point ceiling; defaults to package sampling limits. Later sampling
 
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -43,5 +43,6 @@ Preserve orientation, or align local +X for Sections / +Z for Solids to the tang
 
 - [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)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -76,4 +76,8 @@ Exact arc-length intervals; closed paths need at least three. Otherwise physical
 - [GeometryResolution](GeometryResolution.md)
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -22,5 +22,6 @@ One immutable shape, or a synchronous factory called once per copy in index orde
 
 - [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)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -23,5 +23,6 @@ World-space point left fixed by rotation or scaling.
 
 - [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)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -23,5 +23,6 @@ World-space point left fixed by rotation or scaling.
 
 - [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)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -36,4 +36,4 @@ Signed millimetre distance from the origin along the unit normal. Defaults to ze
 - [Choose the Boolean by the material you want](../../guides/fundamentals.md#choose-the-boolean-by-the-material-you-want)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,6 +1,6 @@
 # PolygonData
 
-One bounded two-dimensional polygon.
+One filled two-dimensional polygon with an exterior and optional holes.
 
 `outer` is counter-clockwise and each hole is clockwise. Boundary arrays omit
 their duplicated closing point. Holes must lie inside `outer` and must not
@@ -34,10 +34,11 @@ Counter-clockwise exterior boundary, omitting its duplicated closing point.
 ## Related APIs
 
 - [Contour](Contour.md)
+- [RegionData](RegionData.md)
 
 ## Guides
 
 - [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.