@metamesh/modeling 0.14.0 → 0.15.0

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

@@ -74,11 +74,11 @@ Explicit output and circular allocation ceilings.
 
 ***
 
-### phaseDegrees?
+### phase?
 
 
 
-`readonly` `optional` **phaseDegrees?**: `number`
+`readonly` `optional` **phase?**: `number`
 
 
 
@@ -86,7 +86,7 @@ Angular offset of the first start in degrees. Default: `0`.
 
 #### Inherited from
 
-[`HelicalThreadRidgeMeshOptions`](HelicalThreadRidgeMeshOptions.md).[`phaseDegrees`](HelicalThreadRidgeMeshOptions.md#phasedegrees)
+[`HelicalThreadRidgeMeshOptions`](HelicalThreadRidgeMeshOptions.md).[`phase`](HelicalThreadRidgeMeshOptions.md#phase)
 
 ***
 
@@ -94,7 +94,7 @@ Angular offset of the first start in degrees. Default: `0`.
 
 
 
-`readonly` **profile**: [`ThreadProfile`](ThreadProfile.md)
+`readonly` **profile**: [`ThreadProfile`](ThreadProfile-type.md)
 
 
 
@@ -237,6 +237,6 @@ Apply a 45-degree bevel at Z=length.
 - [ThreadBevelOptions](ThreadBevelOptions.md)
 - [ThreadEndTreatmentOptions](ThreadEndTreatmentOptions.md)
 - [ThreadHandedness](ThreadHandedness.md)
-- [ThreadProfile](ThreadProfile.md)
+- [ThreadProfile](ThreadProfile-type.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -43,4 +43,4 @@ Final XY point in millimetres.
 
 - [Vector2Tuple](Vector2Tuple.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -43,4 +43,4 @@ Final XYZ point in millimetres.
 
 - [Vector3Tuple](Vector3Tuple.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,18 +1,24 @@
 # LinearPatternOptions
 
-Equal linear intervals determined by exactly two of count, spacing and total length.
+Equal linear intervals determined by exactly two of count, spacing and total length. Dimension defaults to 3; Section patterns use 2 and accept XY vector directions.
 
-**LinearPatternOptions** = `object` & (\{ `count`: `number`; `spacing`: `number`; `length?`: `never`; \} \| \{ `count`: `number`; `length`: `number`; `spacing?`: `never`; \} \| \{ `spacing`: `number`; `length`: `number`; `count?`: `never`; \})
+**LinearPatternOptions**\<`Dimension` *extends* `2` \| `3` = `3`\> = `object` & (\{ `count`: `number`; `spacing`: `number`; `length?`: `never`; \} \| \{ `count`: `number`; `length`: `number`; `spacing?`: `never`; \} \| \{ `spacing`: `number`; `length`: `number`; `count?`: `never`; \})
 
 
 
+## Type Parameters
+
+### Dimension
+
+`Dimension` *extends* `2` \| `3` = `3`
+
 ## Type Declaration
 
 ### direction?
 
 
 
-`readonly` `optional` **direction?**: [`Vector3Tuple`](Vector3Tuple.md)
+`readonly` `optional` **direction?**: `Dimension` *extends* `2` ? [`Vector2Input`](Vector2Input.md) : [`Vector3Input`](Vector3Input.md)
 
 
 
@@ -21,10 +27,11 @@ Direction of repetition; magnitude is ignored. Defaults to +X.
 
 ## Related APIs
 
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector2Input](Vector2Input.md)
+- [Vector3Input](Vector3Input.md)
 
 ## Guides
 
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -16,4 +16,4 @@ Associates ordered loft contours without inferring component identities or repai
 Components and holes are paired by their existing order. Use identified profiles when semantic
 correspondence must remain authoritative.
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -12,16 +12,16 @@ One point-data profile at a height or explicit right-handed spatial frame.
 
 
 
-`readonly` **profile**: [`Contour`](Contour.md)
+`readonly` **profile**: [`Path2Input`](Path2Input.md)
 
 
 
-Ordered finite XY boundary points with an implicit closing edge.
+Closed Path2 or ordered finite XY boundary points with an implicit closing edge.
 
 
 ## Related APIs
 
-- [Contour](Contour.md)
 - [LoftPlacement](LoftPlacement.md)
+- [Path2Input](Path2Input.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -81,4 +81,4 @@ Explicit output and sampling budgets; native operations may only lower host ceil
 - [LoftCorrespondence](LoftCorrespondence.md)
 - [ModelingLimits](ModelingLimits.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -63,4 +63,4 @@ Excluded when an explicit spatial frame is supplied.
 
 - [Frame3](Frame3.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -15,4 +15,4 @@ responsibilities.
 
 - [MetricFastenerStandard](MetricFastenerStandard.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/geometry/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.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -4,4 +4,4 @@ Metric fastener sizes included in the first mechanical standards table.
 
 **MetricFastenerSize** = `"M2"` \| `"M2.5"` \| `"M3"` \| `"M4"` \| `"M5"` \| `"M6"` \| `"M8"` \| `"M10"` \| `"M12"`
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -69,4 +69,4 @@ Socket-head cap screw envelope and drive size.
 - [MetricHexNutDimensions](MetricHexNutDimensions.md)
 - [MetricSocketCapHeadDimensions](MetricSocketCapHeadDimensions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -26,4 +26,4 @@ Nominal wrench size across flats.
 
 Nominal full-nut thickness.
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -38,4 +38,4 @@ Nominal head height.
 
 Nominal internal hex key size across flats.
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

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

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

@@ -14,4 +14,4 @@ calibrate them for its printer, material, layer height, and thread scale.
 
 - [PrintableThreadFitPolicy](PrintableThreadFitPolicy.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -0,0 +1,192 @@
+# Path2
+
+Immutable directed XY polyline. Closure is explicit and does not imply a filled Section.
+
+## Properties
+
+### dimension
+
+
+
+`readonly` **dimension**: `2`
+
+
+
+Coordinate dimension; identifies planar paths even when empty.
+
+***
+
+### closed
+
+
+
+`readonly` **closed**: `boolean`
+
+
+
+Whether traversal includes the last-to-first edge.
+
+## Methods
+
+### toArray()
+
+
+
+**toArray**(): [`Path2Data`](Path2Data.md)
+
+
+
+Returns frozen tuple coordinates; closure remains separate metadata. Repeated calls do not allocate.
+
+#### Returns
+
+[`Path2Data`](Path2Data.md)
+
+***
+
+### length()
+
+
+
+**length**(): `number`
+
+
+
+Total sampled edge length in model units, including the closing edge when closed.
+
+#### Returns
+
+`number`
+
+***
+
+### bounds()
+
+
+
+**bounds**(): [`Bounds2`](Bounds2.md) \| `undefined`
+
+
+
+Axis-aligned bounds, or undefined for an empty path.
+
+#### Returns
+
+[`Bounds2`](Bounds2.md) \| `undefined`
+
+***
+
+### closestPoint()
+
+
+
+**closestPoint**(`point`: [`Vector2Input`](Vector2Input.md)): [`PathLocation`](PathLocation.md)\<[`Vector2`](Vector2-type.md)\>
+
+
+
+Finds the nearest edge location; requires at least two vertices.
+
+#### Parameters
+
+<a id="point"></a>
+
+**`point`** · [`Vector2Input`](Vector2Input.md) · Required
+
+
+
+#### Returns
+
+[`PathLocation`](PathLocation.md)\<[`Vector2`](Vector2-type.md)\>
+
+***
+
+### transform()
+
+
+
+**transform**(`placement`: [`Transform2Input`](Transform2Input.md)): `Path2`
+
+
+
+Applies an XY placement without reordering traversal, including after reflection.
+
+#### Parameters
+
+<a id="placement"></a>
+
+**`placement`** · [`Transform2Input`](Transform2Input.md) · Required
+
+
+
+#### Returns
+
+`Path2`
+
+***
+
+### reverse()
+
+
+
+**reverse**(): `Path2`
+
+
+
+Reverses vertex order and traversal; neither the source nor its coordinates are mutated.
+
+#### Returns
+
+`Path2`
+
+***
+
+### resample()
+
+
+
+**resample**(`options?`: [`PathResamplingOptions`](PathResamplingOptions.md)): `Path2`
+
+
+
+Returns a path sampled at equal arc lengths. Corners may be bridged; closure is preserved.
+
+#### Parameters
+
+<a id="options"></a>
+
+**`options`** · [`PathResamplingOptions`](PathResamplingOptions.md) · Optional
+
+- [`resolution`](PathResamplingOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Millimetre sampling policy; circularSegments applies only to arcs.
+
+- [`maxVertices`](PathResamplingOptions.md#maxvertices) · `number` · Optional
+
+  Output vertex ceiling of at least two; may only lower limits.maxPathPoints.
+
+- [`limits`](PathResamplingOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Explicit sampling ceilings; omitted values use package defaults without ambient state.
+
+- [`segments`](PathResamplingOptions.md#segments) · `number` · Optional
+
+  Exact arc-length intervals; closed paths need at least three. Otherwise physical resolution or the effective source edge count controls sampling.
+
+
+
+#### Returns
+
+`Path2`
+
+
+## Related APIs
+
+- [Bounds2](Bounds2.md)
+- [Path2Data](Path2Data.md)
+- [PathLocation](PathLocation.md)
+- [PathResamplingOptions](PathResamplingOptions.md)
+- [Transform2Input](Transform2Input.md)
+- [Vector2](Vector2-type.md)
+- [Vector2Input](Vector2Input.md)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -0,0 +1,14 @@
+# Path2Data
+
+XY point tuples for interchange; closure is supplied by the consuming operation or Path2 value.
+
+**Path2Data** = readonly [`Vector2Tuple`](Vector2Tuple.md)[]
+
+
+
+
+## Related APIs
+
+- [Vector2Tuple](Vector2Tuple.md)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -0,0 +1,15 @@
+# Path2Input
+
+An immutable XY sampled path or a collection of XY tuples and fluent vectors.
+
+**Path2Input** = [`Path2`](Path2-type.md) \| readonly [`Vector2Input`](Vector2Input.md)[]
+
+
+
+
+## Related APIs
+
+- [Path2](Path2-type.md)
+- [Vector2Input](Vector2Input.md)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -0,0 +1,192 @@
+# Path3
+
+Immutable directed XYZ polyline; it represents sampled edges, not an analytic curve.
+
+## Properties
+
+### dimension
+
+
+
+`readonly` **dimension**: `3`
+
+
+
+Coordinate dimension; identifies spatial paths even when empty.
+
+***
+
+### closed
+
+
+
+`readonly` **closed**: `boolean`
+
+
+
+Whether traversal includes the last-to-first edge.
+
+## Methods
+
+### toArray()
+
+
+
+**toArray**(): [`Path3Data`](Path3Data.md)
+
+
+
+Returns frozen tuple coordinates; closure remains separate metadata. Repeated calls do not allocate.
+
+#### Returns
+
+[`Path3Data`](Path3Data.md)
+
+***
+
+### length()
+
+
+
+**length**(): `number`
+
+
+
+Total sampled edge length in model units, including the closing edge when closed.
+
+#### Returns
+
+`number`
+
+***
+
+### bounds()
+
+
+
+**bounds**(): [`Bounds3`](Bounds3.md) \| `undefined`
+
+
+
+Axis-aligned bounds, or undefined for an empty path.
+
+#### Returns
+
+[`Bounds3`](Bounds3.md) \| `undefined`
+
+***
+
+### closestPoint()
+
+
+
+**closestPoint**(`point`: [`Vector3Input`](Vector3Input.md)): [`PathLocation`](PathLocation.md)\<[`Vector3`](Vector3-type.md)\>
+
+
+
+Finds the nearest edge location; requires at least two vertices.
+
+#### Parameters
+
+<a id="point"></a>
+
+**`point`** · [`Vector3Input`](Vector3Input.md) · Required
+
+
+
+#### Returns
+
+[`PathLocation`](PathLocation.md)\<[`Vector3`](Vector3-type.md)\>
+
+***
+
+### transform()
+
+
+
+**transform**(`placement`: [`Transform3Input`](Transform3Input.md)): `Path3`
+
+
+
+Applies an XYZ placement without changing traversal order or closure.
+
+#### Parameters
+
+<a id="placement"></a>
+
+**`placement`** · [`Transform3Input`](Transform3Input.md) · Required
+
+
+
+#### Returns
+
+`Path3`
+
+***
+
+### reverse()
+
+
+
+**reverse**(): `Path3`
+
+
+
+Reverses vertex order and traversal without mutating the source.
+
+#### Returns
+
+`Path3`
+
+***
+
+### resample()
+
+
+
+**resample**(`options?`: [`PathResamplingOptions`](PathResamplingOptions.md)): `Path3`
+
+
+
+Returns a path sampled at equal arc lengths. Corners may be bridged; closure is preserved.
+
+#### Parameters
+
+<a id="options"></a>
+
+**`options`** · [`PathResamplingOptions`](PathResamplingOptions.md) · Optional
+
+- [`resolution`](PathResamplingOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Millimetre sampling policy; circularSegments applies only to arcs.
+
+- [`maxVertices`](PathResamplingOptions.md#maxvertices) · `number` · Optional
+
+  Output vertex ceiling of at least two; may only lower limits.maxPathPoints.
+
+- [`limits`](PathResamplingOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Explicit sampling ceilings; omitted values use package defaults without ambient state.
+
+- [`segments`](PathResamplingOptions.md#segments) · `number` · Optional
+
+  Exact arc-length intervals; closed paths need at least three. Otherwise physical resolution or the effective source edge count controls sampling.
+
+
+
+#### Returns
+
+`Path3`
+
+
+## Related APIs
+
+- [Bounds3](Bounds3.md)
+- [Path3Data](Path3Data.md)
+- [PathLocation](PathLocation.md)
+- [PathResamplingOptions](PathResamplingOptions.md)
+- [Transform3Input](Transform3Input.md)
+- [Vector3](Vector3-type.md)
+- [Vector3Input](Vector3Input.md)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -0,0 +1,14 @@
+# Path3Data
+
+XYZ point tuples for interchange; closure is supplied by the consuming operation or Path3 value.
+
+**Path3Data** = readonly [`Vector3Tuple`](Vector3Tuple.md)[]
+
+
+
+
+## Related APIs
+
+- [Vector3Tuple](Vector3Tuple.md)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -0,0 +1,15 @@
+# Path3Input
+
+An immutable XYZ sampled path or a collection of XYZ tuples and fluent vectors.
+
+**Path3Input** = [`Path3`](Path3-type.md) \| readonly [`Vector3Input`](Vector3Input.md)[]
+
+
+
+
+## Related APIs
+
+- [Path3](Path3-type.md)
+- [Vector3Input](Vector3Input.md)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -43,4 +43,4 @@ Unit profile Y axis equal to tangent × normal.
 
 - [Vector3Tuple](Vector3Tuple.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.