@metamesh/modeling 0.17.0 → 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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,68 @@
+# CurveSamplingOptions
+
+Explicit physical sampling and allocation policy for reusable curves.
+
+## Extended by
+
+- [`PathResamplingOptions`](PathResamplingOptions.md)
+
+## Properties
+
+### segments?
+
+
+
+`readonly` `optional` **segments?**: `number`
+
+
+
+Exact segment count overrides physical criteria; curve parameters are spaced uniformly.
+
+***
+
+### resolution?
+
+
+
+`readonly` `optional` **resolution?**: [`GeometryResolution`](GeometryResolution.md)
+
+
+
+Millimetre sampling policy; circularSegments applies only to arcs.
+
+***
+
+### maxVertices?
+
+
+
+`readonly` `optional` **maxVertices?**: `number`
+
+
+
+Output vertex ceiling of at least two; may only lower limits.maxPathPoints.
+
+***
+
+### limits?
+
+
+
+`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>
+
+
+
+Explicit sampling ceilings; omitted values use package defaults without ambient state.
+
+
+## Related APIs
+
+- [GeometryResolution](GeometryResolution.md)
+- [GeometrySamplingLimits](GeometrySamplingLimits.md)
+- [PathResamplingOptions](PathResamplingOptions.md)
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,78 @@
+# CustomThreadProfileSpec
+
+Caller-defined periodic axial/radial profile in millimetres.
+
+## Extends
+
+- [`ThreadProfileBaseSpec`](ThreadProfileBaseSpec.md)
+
+## Properties
+
+### kind
+
+
+
+`readonly` **kind**: `"custom"`
+
+
+
+Selects a caller-defined periodic profile.
+
+***
+
+### points
+
+
+
+`readonly` **points**: readonly [`Vector2Data`](Vector2Data.md)[]
+
+
+
+Open path spanning exactly `[-pitch/2, pitch/2]`, with both endpoints on the minor envelope,
+one connected ridge, one contiguous crest, and radial zero at the major envelope.
+
+***
+
+### 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)
+- [Vector2Data](Vector2Data.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/CylinderOptions.md

@@ -55,4 +55,4 @@ Total height along +Z in millimetres.
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -20,9 +20,23 @@ Typed parameter association for an assertion or warning.
 
 Existing top-level parameter key.
 
+***
+
+### path?
+
+
+
+`readonly` `optional` **path?**: readonly (`string` \| `number`)[]
+
+
+
+Relative field path, at most 32 nonnegative safe indices or 1–120 character field names.
+Starts within parameterId's value, or the whole input map when no parameterId is supplied.
+Omitted or empty addresses the whole value; paths do not validate field existence.
+
 
 ## Guides
 
 - [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -19,4 +19,4 @@ Uniform finishing vocabulary shared by applicable solid edges and profile corner
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -2,7 +2,7 @@
 
 Ellipse dimensions with exactly one XY radii or full-size tuple and explicit sampling.
 
-**EllipseContourOptions** = [`CircularPrimitiveOptions`](CircularPrimitiveOptions.md) & (\{ `radius`: [`Vector2Data`](Vector2Data.md); `size?`: `never`; \} \| \{ `size`: [`Vector2Data`](Vector2Data.md); `radius?`: `never`; \})
+**EllipseContourOptions** = [`CircularPrimitiveOptions`](CircularPrimitiveOptions.md) & (\{ `radius`: [`Vector2Input`](Vector2Input.md); `size?`: `never`; \} \| \{ `size`: [`Vector2Input`](Vector2Input.md); `radius?`: `never`; \})
 
 
 
@@ -10,7 +10,7 @@ Ellipse dimensions with exactly one XY radii or full-size tuple and explicit sam
 ## Related APIs
 
 - [CircularPrimitiveOptions](CircularPrimitiveOptions.md)
-- [Vector2Data](Vector2Data.md)
+- [Vector2Input](Vector2Input.md)
 
 ## Guides
 
@@ -18,4 +18,4 @@ Ellipse dimensions with exactly one XY radii or full-size tuple 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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -18,4 +18,4 @@ Ellipse dimensions in local XY, with exactly one radii or full-size tuple.
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -36,4 +36,4 @@ Top cap and adjoining side; omitted leaves the end untreated.
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,133 @@
+# ExtrudeMeshOptions
+
+Dimensions and sampling for pure +Z mesh extrusion, without end treatments.
+
+## Extends
+
+- [`ExtrusionSamplingOptions`](ExtrusionSamplingOptions.md)
+
+## Extended by
+
+- [`ExtrudeOptions`](ExtrudeOptions.md)
+
+## Properties
+
+### height
+
+
+
+`readonly` **height**: `number`
+
+
+
+Positive extrusion height in millimetres.
+
+***
+
+### center?
+
+
+
+`readonly` `optional` **center?**: `boolean`
+
+
+
+Center the extrusion on Z; otherwise its bottom is at zero. Defaults to false.
+
+***
+
+### divisions?
+
+
+
+`readonly` `optional` **divisions?**: `number`
+
+
+
+Exact number of intermediate profiles, nonnegative; overrides physical sampling.
+
+#### Inherited from
+
+[`ExtrusionSamplingOptions`](ExtrusionSamplingOptions.md).[`divisions`](ExtrusionSamplingOptions.md#divisions)
+
+***
+
+### limits?
+
+
+
+`readonly` `optional` **limits?**: `Partial`\<[`ModelingLimits`](ModelingLimits.md)\>
+
+
+
+Explicit output and sampling allocation ceilings.
+
+#### Inherited from
+
+[`ExtrusionSamplingOptions`](ExtrusionSamplingOptions.md).[`limits`](ExtrusionSamplingOptions.md#limits)
+
+***
+
+### resolution?
+
+
+
+`readonly` `optional` **resolution?**: [`GeometryResolution`](GeometryResolution.md)
+
+
+
+Operation-level physical policy over the nearest model scope.
+
+#### Inherited from
+
+[`ExtrusionSamplingOptions`](ExtrusionSamplingOptions.md).[`resolution`](ExtrusionSamplingOptions.md#resolution)
+
+***
+
+### scaleTop?
+
+
+
+`readonly` `optional` **scaleTop?**: `number` \| [`Vector2Input`](Vector2Input.md)
+
+
+
+Finite uniform or XY scale of the top profile; defaults to one.
+
+#### Inherited from
+
+[`ExtrusionSamplingOptions`](ExtrusionSamplingOptions.md).[`scaleTop`](ExtrusionSamplingOptions.md#scaletop)
+
+***
+
+### twist?
+
+
+
+`readonly` `optional` **twist?**: `number`
+
+
+
+Finite rotation of the top profile about +Z, in degrees; defaults to zero.
+
+#### Inherited from
+
+[`ExtrusionSamplingOptions`](ExtrusionSamplingOptions.md).[`twist`](ExtrusionSamplingOptions.md#twist)
+
+
+## Related APIs
+
+- [ExtrudeOptions](ExtrudeOptions.md)
+- [ExtrusionSamplingOptions](ExtrusionSamplingOptions.md)
+- [GeometryResolution](GeometryResolution.md)
+- [ModelingLimits](ModelingLimits.md)
+- [Vector2Input](Vector2Input.md)
+
+## Guides
+
+- [Revolve a radial profile](../../guides/recipes.md#revolve-a-radial-profile)
+- [Rotation-minimizing path sweep](../../guides/recipes.md#rotation-minimizing-path-sweep)
+- [Matched-section loft](../../guides/recipes.md#matched-section-loft)
+- [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
+
+Package: `@metamesh/modeling@0.18.0`.