@metamesh/modeling 0.13.0 → 0.15.0

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

@@ -40,11 +40,11 @@ Local geometry or a lazy reader; native objects never cross a revision.
 
 
 
-`readonly` `optional` **position?**: [`ComputedValue`](ComputedValue.md)\<[`Vector3`](Vector3.md)\>
+`readonly` `optional` **position?**: [`ComputedValue`](ComputedValue.md)\<[`Vector3Input`](Vector3Input.md)\>
 
 
 
-XYZ translation in millimetres, applied after rotation; defaults to zero.
+XYZ vector or tuple translation in millimetres, applied after rotation; defaults to zero.
 
 #### Inherited from
 
@@ -56,11 +56,11 @@ XYZ translation in millimetres, applied after rotation; defaults to zero.
 
 
 
-`readonly` `optional` **rotation?**: [`ComputedValue`](ComputedValue.md)\<[`Vector3`](Vector3.md)\>
+`readonly` `optional` **rotation?**: [`ComputedValue`](ComputedValue.md)\<[`Vector3Input`](Vector3Input.md)\>
 
 
 
-Fixed global X, Y, Z rotations in degrees; defaults to zero.
+XYZ vector or tuple of fixed global X, Y, Z rotations in degrees; defaults to zero.
 
 #### Inherited from
 
@@ -88,6 +88,6 @@ Optional six-digit hexadecimal semantic part color.
 - [ComputedValue](ComputedValue.md)
 - [PartGeometry](PartGeometry.md)
 - [PartOptions](PartOptions.md)
-- [Vector3](Vector3.md)
+- [Vector3Input](Vector3Input.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -38,4 +38,4 @@ Human-readable corrective guidance.
 
 Optional control identity, validated against the supplied parameters.
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -51,4 +51,4 @@ Issues reached in normal JavaScript order, ending with the first failed assertio
 
 - [GenerationDiagnostic](GenerationDiagnostic.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -40,11 +40,11 @@ Optional maximum sampled edge length in millimetres.
 
 ***
 
-### maximumSegments?
+### maxSegments?
 
 
 
-`readonly` `optional` **maximumSegments?**: `number`
+`readonly` `optional` **maxSegments?**: `number`
 
 
 
@@ -52,11 +52,11 @@ Upper safety bound for a full circle; defaults to the selected maxCircularSegmen
 
 ***
 
-### minimumSegments?
+### minSegments?
 
 
 
-`readonly` `optional` **minimumSegments?**: `number`
+`readonly` `optional` **minSegments?**: `number`
 
 
 
@@ -67,4 +67,4 @@ Lower full-circle segment count; defaults to 16 or a lower selected circular cei
 
 - [Coordinates, units, and resolution](../../guides/concepts.md#coordinates-units-and-resolution)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -59,4 +59,4 @@ Maximum segments around one complete circle.
 
 - [ModelingLimits](ModelingLimits.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -43,4 +43,4 @@ Dimensionless scale multiplier. Must be finite and non-negative.
 
 - [Coordinates, units, and resolution](../../guides/concepts.md#coordinates-units-and-resolution)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,11 +1,17 @@
 # GridPatternOptions
 
-XY or XYZ grid with X varying fastest. The first item starts at the local origin.
+XY or XYZ grid with X varying fastest. The first item starts at the local origin. Dimension 2 restricts counts and spacing to XY; any frame must preserve the XY plane.
 
-**GridPatternOptions** = `object` & (\{ `count`: [`Vector2`](Vector2.md); `spacing`: [`Vector2`](Vector2.md); \} \| \{ `count`: [`Vector3`](Vector3.md); `spacing`: [`Vector3`](Vector3.md); \})
+**GridPatternOptions**\<`Dimension` *extends* `2` \| `3` = `3`\> = `object` & (\{ `count`: [`Vector2Tuple`](Vector2Tuple.md); `spacing`: [`Vector2Tuple`](Vector2Tuple.md); \} \| `Dimension` *extends* `3` ? `object` : `never`)
 
 
 
+## Type Parameters
+
+### Dimension
+
+`Dimension` *extends* `2` \| `3` = `3`
+
 ## Type Declaration
 
 ### center?
@@ -32,12 +38,12 @@ Optional right-handed local axes and origin for the grid.
 ## Related APIs
 
 - [Frame3](Frame3.md)
-- [Vector2](Vector2.md)
-- [Vector3](Vector3.md)
+- [Vector2Tuple](Vector2Tuple.md)
+- [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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 A closed rectilinear heightfield above a flat base, with uniform or explicit XY samples in millimetres.
 
-**HeightfieldOptions** = `object` & (\{ `size`: [`Vector2`](Vector2.md); `segments`: readonly \[`x`: `number`, `y`: `number`\]; `origin?`: [`Vector2`](Vector2.md); `coordinates?`: `never`; \} \| \{ `coordinates`: \{ `x`: readonly `number`[]; `y`: readonly `number`[]; \}; `size?`: `never`; `segments?`: `never`; `origin?`: `never`; \})
+**HeightfieldOptions** = `object` & (\{ `size`: [`Vector2Tuple`](Vector2Tuple.md); `segments`: readonly \[`x`: `number`, `y`: `number`\]; `origin?`: [`Vector2Tuple`](Vector2Tuple.md); `coordinates?`: `never`; \} \| \{ `coordinates`: \{ `x`: readonly `number`[]; `y`: readonly `number`[]; \}; `size?`: `never`; `segments?`: `never`; `origin?`: `never`; \})
 
 
 
@@ -18,7 +18,7 @@ absolute samples per axis, distinct in Float32. This infers the footprint and in
 
 
 
-`readonly` **height**: (`point`: [`Vector2`](Vector2.md)) => `number`
+`readonly` **height**: (`point`: [`Vector2Tuple`](Vector2Tuple.md)) => `number`
 
 
 
@@ -28,7 +28,7 @@ Absolute top Z at the supplied XY point. Every sample must be above baseZ.
 
 <a id="point"></a>
 
-**`point`** · [`Vector2`](Vector2.md) · Required
+**`point`** · [`Vector2Tuple`](Vector2Tuple.md) · Required
 
 
 
@@ -62,6 +62,6 @@ All policies retain two triangles per cell; neither estimates error elsewhere in
 
 ## Related APIs
 
-- [Vector2](Vector2.md)
+- [Vector2Tuple](Vector2Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -65,11 +65,11 @@ Nominal major diameter before any caller-owned fit compensation.
 
 ***
 
-### phaseDegrees?
+### phase?
 
 
 
-`readonly` `optional` **phaseDegrees?**: `number`
+`readonly` `optional` **phase?**: `number`
 
 
 
@@ -137,4 +137,4 @@ Optional numerical tolerance overrides.
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -55,4 +55,4 @@ Conservative triangle count used by the selected output allocation policy.
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,8 +1,8 @@
 # HullOptions
 
-Hull inputs are either finite points or same-session solids.
+Hull inputs are either finite points or solid recipes.
 
-**HullOptions** = \{ `points`: readonly [`Vector3`](Vector3.md)[]; `solids?`: `never`; \} \| \{ `solids`: readonly [`Solid`](Solid.md)[]; `points?`: `never`; \}
+**HullOptions** = \{ `points`: readonly [`Vector3Input`](Vector3Input.md)[]; `solids?`: `never`; \} \| \{ `solids`: readonly [`Solid`](Solid.md)[]; `points?`: `never`; \}
 
 
 
@@ -10,13 +10,13 @@ Hull inputs are either finite points or same-session solids.
 
 ### Type Literal
 
-\{ `points`: readonly [`Vector3`](Vector3.md)[]; `solids?`: `never`; \}
+\{ `points`: readonly [`Vector3Input`](Vector3Input.md)[]; `solids?`: `never`; \}
 
 #### points
 
 
 
-`readonly` **points**: readonly [`Vector3`](Vector3.md)[]
+`readonly` **points**: readonly [`Vector3Input`](Vector3Input.md)[]
 
 
 
@@ -46,7 +46,7 @@ Point input excludes solid input.
 
 
 
-Same-build solids to include in the convex hull.
+Solid recipes to include in the convex hull.
 
 #### points?
 
@@ -62,11 +62,11 @@ Solid input excludes point input.
 ## Related APIs
 
 - [Solid](Solid.md)
-- [Vector3](Vector3.md)
+- [Vector3Input](Vector3Input.md)
 
 ## Guides
 
 - [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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -77,4 +77,4 @@ Returns a fresh mutable array of the original numeric type; never exposes cached
 
 - [NumericArray](NumericArray.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -31,4 +31,4 @@ Zero-based vertex indices, three per triangle.
 
 - [ImmutableBuffer](ImmutableBuffer-type.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -8,7 +8,7 @@ Positive-inside sampling, bounded to 4M native BCC grid slots and 8M field calls
 
 
 
-`readonly` **field**: (`point`: [`Vector3`](Vector3.md)) => `number`
+`readonly` **field**: (`point`: [`Vector3Tuple`](Vector3Tuple.md)) => `number`
 
 
 
@@ -18,7 +18,7 @@ Positive-inside scalar field evaluated at finite XYZ points.
 
 <a id="point"></a>
 
-**`point`** · [`Vector3`](Vector3.md) · Required
+**`point`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
 
 
 
@@ -78,6 +78,6 @@ Positive native geometric tolerance in millimetres; omitted uses interpolated gr
 ## Related APIs
 
 - [Bounds3](Bounds3.md)
-- [Vector3](Vector3.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/model/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)
 
 ***
 
@@ -242,4 +242,4 @@ Apply a 45-degree bevel at Z=length.
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/model/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?**: [`Vector3`](Vector3.md)
+`readonly` `optional` **direction?**: `Dimension` *extends* `2` ? [`Vector2Input`](Vector2Input.md) : [`Vector3Input`](Vector3Input.md)
 
 
 
@@ -21,11 +27,12 @@ Direction of repetition; magnitude is ignored. Defaults to +X.
 
 ## Related APIs
 
-- [Vector3](Vector3.md)
+- [Vector2Input](Vector2Input.md)
+- [Vector3Input](Vector3Input.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -12,17 +12,17 @@ A Section or point loop at an explicit height or frame.
 
 
 
-`readonly` **profile**: [`Section`](Section.md) \| [`Contour`](Contour.md)
+`readonly` **profile**: [`Section`](Section.md) \| [`Path2Input`](Path2Input.md)
 
 
 
-Same-build filled Section or ordered XY boundary point data.
+Filled Section recipe or ordered XY boundary point data.
 
 
 ## Related APIs
 
-- [Contour](Contour.md)
 - [LoftPlacement](LoftPlacement.md)
+- [Path2Input](Path2Input.md)
 - [Section](Section.md)
 
 ## Guides
@@ -32,4 +32,4 @@ Same-build filled Section 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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -41,4 +41,4 @@ Typed synchronous declaration callback.
 
 - [GenerateCallback](GenerateCallback.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -4,4 +4,4 @@ Numeric storage supported by immutable generation buffers.
 
 **NumericArray** = `Float32Array` \| `Float64Array` \| `Uint32Array` \| `Uint8Array` \| `Int32Array`
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -13,4 +13,4 @@ Manufacturing geometry; filled sections are intermediate construction values.
 - [Solid](Solid.md)
 - [TriangleMesh](TriangleMesh.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -24,11 +24,11 @@ Local geometry or a lazy reader; native objects never cross a revision.
 
 
 
-`readonly` `optional` **position?**: [`ComputedValue`](ComputedValue.md)\<[`Vector3`](Vector3.md)\>
+`readonly` `optional` **position?**: [`ComputedValue`](ComputedValue.md)\<[`Vector3Input`](Vector3Input.md)\>
 
 
 
-XYZ translation in millimetres, applied after rotation; defaults to zero.
+XYZ vector or tuple translation in millimetres, applied after rotation; defaults to zero.
 
 ***
 
@@ -36,11 +36,11 @@ XYZ translation in millimetres, applied after rotation; defaults to zero.
 
 
 
-`readonly` `optional` **rotation?**: [`ComputedValue`](ComputedValue.md)\<[`Vector3`](Vector3.md)\>
+`readonly` `optional` **rotation?**: [`ComputedValue`](ComputedValue.md)\<[`Vector3Input`](Vector3Input.md)\>
 
 
 
-Fixed global X, Y, Z rotations in degrees; defaults to zero.
+XYZ vector or tuple of fixed global X, Y, Z rotations in degrees; defaults to zero.
 
 ***
 
@@ -60,6 +60,6 @@ Optional six-digit hexadecimal semantic part color.
 - [ComputedValue](ComputedValue.md)
 - [GeneratedPart](GeneratedPart.md)
 - [PartGeometry](PartGeometry.md)
-- [Vector3](Vector3.md)
+- [Vector3Input](Vector3Input.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.