@metamesh/modeling 0.16.0 → 0.18.0

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

@@ -0,0 +1,80 @@
+# AcmeThreadProfileSpec
+
+ACME 29-degree included-angle profile.
+
+## Extends
+
+- [`ThreadProfileBaseSpec`](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`](ThreadProfileBaseSpec.md).[`pitch`](ThreadProfileBaseSpec.md#pitch)
+
+***
+
+### tolerance?
+
+
+
+`readonly` `optional` **tolerance?**: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)
+
+
+
+Optional numerical tolerance overrides.
+
+#### Inherited from
+
+[`ThreadProfileBaseSpec`](ThreadProfileBaseSpec.md).[`tolerance`](ThreadProfileBaseSpec.md#tolerance)
+
+
+## Related APIs
+
+- [GeometryToleranceOptions](GeometryToleranceOptions.md)
+- [ThreadProfileBaseSpec](ThreadProfileBaseSpec.md)
+
+## Guides
+
+- [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -52,4 +52,4 @@ Roll guide projected into the plane perpendicular to `direction`.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -66,4 +66,4 @@ Optional numeric comparison overrides.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,19 @@
+# Bevel
+
+One size for both ends, or independent sizes in bottom/top order. Zero disables an end.
+
+**Bevel** = [`BevelSize`](BevelSize.md) \| readonly \[`bottom`: [`BevelSize`](BevelSize.md), `top`: [`BevelSize`](BevelSize.md)\]
+
+
+
+
+## Related APIs
+
+- [BevelSize](BevelSize.md)
+
+## Guides
+
+- [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/{ThreadedNutBevel.md → BevelSize.md}

@@ -1,8 +1,8 @@
-# ThreadedNutBevel
+# BevelSize
 
-Nut-edge bevel selection.
+Nonnegative 45-degree axial/radial bevel size in millimetres, or factory automatic sizing.
 
-**ThreadedNutBevel** = `"automatic"` \| `"both"` \| `"inside"` \| `"none"` \| `"outside"`
+**BevelSize** = `number` \| `"auto"`
 
 
 
@@ -12,4 +12,4 @@ Nut-edge bevel selection.
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 - [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -122,4 +122,4 @@ Returns this value's frozen plain record; repeated calls do not allocate.
 
 - [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -41,4 +41,4 @@ Inclusive minimum X/Y coordinates.
 - [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -16,4 +16,4 @@ An immutable XY bounds value or its plain min/max representation.
 
 - [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,110 @@
+# Bounds2Options
+
+XY bounds construction from existing extrema or nonnegative dimensions, never both.
+
+**Bounds2Options** = \{ `min`: [`Vector2Input`](Vector2Input.md); `max`: [`Vector2Input`](Vector2Input.md); `size?`: `never`; `center?`: `never`; \} \| \{ `size`: [`Vector2Input`](Vector2Input.md); `center?`: `boolean`; `min?`: `never`; `max?`: `never`; \}
+
+
+
+## Union Members
+
+### Type Literal
+
+\{ `min`: [`Vector2Input`](Vector2Input.md); `max`: [`Vector2Input`](Vector2Input.md); `size?`: `never`; `center?`: `never`; \}
+
+#### min
+
+
+
+`readonly` **min**: [`Vector2Input`](Vector2Input.md)
+
+
+
+Inclusive minimum XY coordinates in millimetres.
+
+#### max
+
+
+
+`readonly` **max**: [`Vector2Input`](Vector2Input.md)
+
+
+
+Inclusive maximum XY coordinates in millimetres.
+
+#### size?
+
+
+
+`readonly` `optional` **size?**: `never`
+
+
+
+Size construction cannot be combined with extrema.
+
+#### center?
+
+
+
+`readonly` `optional` **center?**: `never`
+
+
+
+Center applies only to size construction.
+
+***
+
+### Type Literal
+
+\{ `size`: [`Vector2Input`](Vector2Input.md); `center?`: `boolean`; `min?`: `never`; `max?`: `never`; \}
+
+#### size
+
+
+
+`readonly` **size**: [`Vector2Input`](Vector2Input.md)
+
+
+
+Nonnegative XY dimensions in millimetres.
+
+#### center?
+
+
+
+`readonly` `optional` **center?**: `boolean`
+
+
+
+Center on the origin; false starts at the origin. Defaults to true.
+
+#### min?
+
+
+
+`readonly` `optional` **min?**: `never`
+
+
+
+Minimum coordinates are unavailable when size is supplied.
+
+#### max?
+
+
+
+`readonly` `optional` **max?**: `never`
+
+
+
+Maximum coordinates are unavailable when size is supplied.
+
+
+## Related APIs
+
+- [Vector2Input](Vector2Input.md)
+
+## Guides
+
+- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -122,4 +122,4 @@ Returns this value's frozen plain record; repeated calls do not allocate.
 
 - [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -41,4 +41,4 @@ Inclusive minimum X/Y/Z coordinates.
 - [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -16,4 +16,4 @@ An immutable XYZ bounds value or its plain min/max representation.
 
 - [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,110 @@
+# Bounds3Options
+
+XYZ bounds construction from existing extrema or nonnegative dimensions, never both.
+
+**Bounds3Options** = \{ `min`: [`Vector3Input`](Vector3Input.md); `max`: [`Vector3Input`](Vector3Input.md); `size?`: `never`; `center?`: `never`; \} \| \{ `size`: [`Vector3Input`](Vector3Input.md); `center?`: `boolean`; `min?`: `never`; `max?`: `never`; \}
+
+
+
+## Union Members
+
+### Type Literal
+
+\{ `min`: [`Vector3Input`](Vector3Input.md); `max`: [`Vector3Input`](Vector3Input.md); `size?`: `never`; `center?`: `never`; \}
+
+#### min
+
+
+
+`readonly` **min**: [`Vector3Input`](Vector3Input.md)
+
+
+
+Inclusive minimum XYZ coordinates in millimetres.
+
+#### max
+
+
+
+`readonly` **max**: [`Vector3Input`](Vector3Input.md)
+
+
+
+Inclusive maximum XYZ coordinates in millimetres.
+
+#### size?
+
+
+
+`readonly` `optional` **size?**: `never`
+
+
+
+Size construction cannot be combined with extrema.
+
+#### center?
+
+
+
+`readonly` `optional` **center?**: `never`
+
+
+
+Center applies only to size construction.
+
+***
+
+### Type Literal
+
+\{ `size`: [`Vector3Input`](Vector3Input.md); `center?`: `boolean`; `min?`: `never`; `max?`: `never`; \}
+
+#### size
+
+
+
+`readonly` **size**: [`Vector3Input`](Vector3Input.md)
+
+
+
+Nonnegative XYZ dimensions in millimetres.
+
+#### center?
+
+
+
+`readonly` `optional` **center?**: `boolean`
+
+
+
+Center on the origin; false starts at the origin. Defaults to true.
+
+#### min?
+
+
+
+`readonly` `optional` **min?**: `never`
+
+
+
+Minimum coordinates are unavailable when size is supplied.
+
+#### max?
+
+
+
+`readonly` `optional` **max?**: `never`
+
+
+
+Maximum coordinates are unavailable when size is supplied.
+
+
+## Related APIs
+
+- [Vector3Input](Vector3Input.md)
+
+## Guides
+
+- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -12,4 +12,4 @@ Box edges use +Z top, +Y front and +X right; vertical names list front/back firs
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -16,4 +16,4 @@ Named individual edges or top/bottom rims and all four vertical edges.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -17,4 +17,4 @@ Independent treatments for disjoint named edge selections; overlapping selection
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -40,7 +40,7 @@ Centers the box on the XYZ origin when `true`; otherwise its minimum corner is a
 
 
 
-`readonly` **size**: `number` \| [`Vector3Data`](Vector3Data.md)
+`readonly` **size**: `number` \| [`Vector3Input`](Vector3Input.md)
 
 
 
@@ -82,11 +82,11 @@ Applied after local construction; Section attachment must preserve the XY plane.
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [PrimitiveAttachment](PrimitiveAttachment.md)
 - [PrimitiveAttachmentOptions](PrimitiveAttachmentOptions.md)
-- [Vector3Data](Vector3Data.md)
+- [Vector3Input](Vector3Input.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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,15 @@
+# ButtressPressureFlankSide
+
+Axial side carrying the near-normal pressure flank of a buttress thread.
+
+**ButtressPressureFlankSide** = `"negative"` \| `"positive"`
+
+
+
+
+## Guides
+
+- [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,98 @@
+# ButtressThreadProfileSpec
+
+Asymmetric printable buttress profile with 7/45-degree flanks.
+
+## Extends
+
+- [`ThreadProfileBaseSpec`](ThreadProfileBaseSpec.md)
+
+## Properties
+
+### kind
+
+
+
+`readonly` **kind**: `"buttress"`
+
+
+
+Selects the asymmetric printable buttress profile family.
+
+***
+
+### depth?
+
+
+
+`readonly` `optional` **depth?**: `number`
+
+
+
+Radial depth in millimetres.
+
+#### Default Value
+
+`0.66271 * pitch`
+
+***
+
+### pressureFlankSide?
+
+
+
+`readonly` `optional` **pressureFlankSide?**: [`ButtressPressureFlankSide`](ButtressPressureFlankSide.md)
+
+
+
+Axial side of each tooth carrying the 7-degree pressure flank. The opposite side uses the
+45-degree clearance flank.
+
+#### Default Value
+
+`"positive"`
+
+***
+
+### pitch
+
+
+
+`readonly` **pitch**: `number`
+
+
+
+Adjacent axial thread spacing in millimetres.
+
+#### Inherited from
+
+[`ThreadProfileBaseSpec`](ThreadProfileBaseSpec.md).[`pitch`](ThreadProfileBaseSpec.md#pitch)
+
+***
+
+### tolerance?
+
+
+
+`readonly` `optional` **tolerance?**: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)
+
+
+
+Optional numerical tolerance overrides.
+
+#### Inherited from
+
+[`ThreadProfileBaseSpec`](ThreadProfileBaseSpec.md).[`tolerance`](ThreadProfileBaseSpec.md#tolerance)
+
+
+## Related APIs
+
+- [ButtressPressureFlankSide](ButtressPressureFlankSide.md)
+- [GeometryToleranceOptions](GeometryToleranceOptions.md)
+- [ThreadProfileBaseSpec](ThreadProfileBaseSpec.md)
+
+## Guides
+
+- [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -32,4 +32,4 @@ Millimetre setbacks, equal or [first surface, second surface]. Zero or [0, 0] le
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -18,4 +18,4 @@ Circular profile dimensions with exactly one radius or diameter and explicit sam
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -18,4 +18,4 @@ Circular dimensions with exactly one nominal radius or diameter.
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -6,7 +6,6 @@ Tessellation controls shared by circular primitives across Geometry entry points
 
 - [`RevolveOptions`](RevolveOptions.md)
 - [`RoundedEdgeTreatment`](RoundedEdgeTreatment.md)
-- [`TubeOptions`](TubeOptions.md)
 
 ## Properties
 
@@ -54,11 +53,10 @@ Operation-level physical tessellation policy over the active model-wide policy.
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [RevolveOptions](RevolveOptions.md)
 - [RoundedEdgeTreatment](RoundedEdgeTreatment.md)
-- [TubeOptions](TubeOptions.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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -12,13 +12,13 @@ A lazy session-owned reader. Calling it tracks its output in the current computa
 
 
 
-**Computed**(): `T`
+**Computed**(): [`ImmutableValue`](ImmutableValue.md)\<`T`\>
 
 
 
 ## Returns
 
-`T`
+[`ImmutableValue`](ImmutableValue.md)\<`T`\>
 
 ## Properties
 
@@ -33,8 +33,12 @@ A lazy session-owned reader. Calling it tracks its output in the current computa
 Compile-time ownership brand; readers are created by the engine's context helper.
 
 
+## Related APIs
+
+- [ImmutableValue](ImmutableValue.md)
+
 ## Guides
 
 - [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -21,4 +21,4 @@ A value supplied immediately or by a lazy computed reader.
 
 - [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -21,4 +21,4 @@ Use PolygonData to assign an exterior and its holes, or ProfileContour2 for iden
 - [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -43,4 +43,4 @@ Clockwise hole contours belonging to this component.
 
 - [CorrespondingContour](CorrespondingContour.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -43,4 +43,4 @@ One span identity per point; indices correspond between every matched family mem
 
 - [Contour](Contour.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -19,4 +19,4 @@ Ordered components with explicit contour identities.
 
 - [CorrespondingComponent](CorrespondingComponent.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -24,4 +24,4 @@ Already corresponding filled contours with authoritative landmark slots.
 - [CorrespondingProfile](CorrespondingProfile.md)
 - [LoftPlacement](LoftPlacement.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.