@metamesh/modeling 0.17.0 → 0.18.0

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

@@ -2,79 +2,11 @@
 
 Dimensions, placement, and tessellation for a hollow Z-axis tube.
 
-## Extends
+**TubeOptions** = [`CircularPrimitiveOptions`](CircularPrimitiveOptions.md) & [`PrimitiveAttachment`](PrimitiveAttachment.md) & `object` & (\{ `innerRadius`: `number`; `outerRadius`: `number`; `innerDiameter?`: `never`; `outerDiameter?`: `never`; \} \| \{ `innerDiameter`: `number`; `outerDiameter`: `number`; `innerRadius?`: `never`; `outerRadius?`: `never`; \})
 
-- [`CircularPrimitiveOptions`](CircularPrimitiveOptions.md)
-- [`PrimitiveAttachment`](PrimitiveAttachment.md)
 
-## Properties
 
-### limits?
-
-
-
-`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>
-
-
-
-Explicit sampling ceilings; bound modeling operations may only lower the host policy.
-
-#### Inherited from
-
-[`CircularPrimitiveOptions`](CircularPrimitiveOptions.md).[`limits`](CircularPrimitiveOptions.md#limits)
-
-***
-
-### segments?
-
-
-
-`readonly` `optional` **segments?**: `number`
-
-
-
-Exact circumferential segment count from three through the configured safety limit.
-
-This local topology override takes precedence over [CircularPrimitiveOptions.resolution](CircularPrimitiveOptions.md#resolution)
-and any active model-wide resolution policy.
-
-#### Inherited from
-
-[`CircularPrimitiveOptions`](CircularPrimitiveOptions.md).[`segments`](CircularPrimitiveOptions.md#segments)
-
-***
-
-### resolution?
-
-
-
-`readonly` `optional` **resolution?**: [`GeometryResolution`](GeometryResolution.md)
-
-
-
-Operation-level physical tessellation policy over the active model-wide policy.
-
-#### Inherited from
-
-[`CircularPrimitiveOptions`](CircularPrimitiveOptions.md).[`resolution`](CircularPrimitiveOptions.md#resolution)
-
-***
-
-### attachment?
-
-
-
-`readonly` `optional` **attachment?**: [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md)
-
-
-
-Applied after local construction; Section attachment must preserve the XY plane.
-
-#### Inherited from
-
-[`PrimitiveAttachment`](PrimitiveAttachment.md).[`attachment`](PrimitiveAttachment.md#attachment)
-
-***
+## Type Declaration
 
 ### center?
 
@@ -90,8 +22,6 @@ Centers the tube on the Z origin when `true`; otherwise its bottom is at `Z = 0`
 
 `true`
 
-***
-
 ### height
 
 
@@ -102,37 +32,31 @@ Centers the tube on the Z origin when `true`; otherwise its bottom is at `Z = 0`
 
 Total height along Z in millimetres.
 
-***
-
-### innerRadius
-
+### innerSizing?
 
 
-`readonly` **innerRadius**: `number`
 
+`readonly` `optional` **innerSizing?**: [`RadialSizing`](RadialSizing.md)
 
 
-Positive inner radius in millimetres.
 
-***
+Inner nominal dimension meets polygon vertices or faces; defaults to vertex.
 
-### outerRadius
+### outerSizing?
 
 
 
-`readonly` **outerRadius**: `number`
+`readonly` `optional` **outerSizing?**: [`RadialSizing`](RadialSizing.md)
 
 
 
-Outer radius in millimetres; greater than [TubeOptions.innerRadius](#innerradius).
+Outer nominal dimension meets polygon vertices or faces; defaults to vertex.
 
 
 ## Related APIs
 
 - [CircularPrimitiveOptions](CircularPrimitiveOptions.md)
-- [GeometryResolution](GeometryResolution.md)
-- [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [PrimitiveAttachment](PrimitiveAttachment.md)
-- [PrimitiveAttachmentOptions](PrimitiveAttachmentOptions.md)
+- [RadialSizing](RadialSizing.md)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -267,4 +267,4 @@ Returns this value's frozen readonly tuple for interchange; repeated calls do no
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -12,4 +12,4 @@ A two-dimensional Cartesian vector or point.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -17,4 +17,4 @@ An XY tuple or immutable fluent vector accepted by vector operations.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -279,4 +279,4 @@ Returns this value's frozen readonly tuple for interchange; repeated calls do no
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -12,4 +12,4 @@ A three-dimensional Cartesian vector or point.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -17,4 +17,4 @@ An XYZ tuple or immutable fluent vector accepted by vector operations.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -55,4 +55,4 @@ Reading direction around the circle; defaults to clockwise.
 
 - [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -40,4 +40,4 @@ Exact measurements of these paths and their logical text layout.
 
 - [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -12,7 +12,7 @@ Text bounded to 512 UTF-16 units: horizontal lines or one circular line without
 
 
 
-`readonly` `optional` **align?**: `"center"` \| `"left"` \| `"right"`
+`readonly` `optional` **align?**: `"left"` \| `"right"` \| `"center"`
 
 
 
@@ -48,7 +48,7 @@ Baseline spacing in ems, 0.5–5; omitted uses the selected face's natural verti
 
 
 
-`readonly` `optional` **verticalAlign?**: `"center"` \| `"top"` \| `"bottom"` \| `"baseline"`
+`readonly` `optional` **verticalAlign?**: `"top"` \| `"bottom"` \| `"center"` \| `"baseline"`
 
 
 
@@ -112,4 +112,4 @@ Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
 - [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -95,4 +95,4 @@ Number of lines, including empty and trailing lines; empty text occupies one lin
 
 - [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -51,4 +51,4 @@ Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
 - [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -34,4 +34,4 @@ Adds two finite XY vectors component-wise.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -40,4 +40,4 @@ add3([1, 2, 3], [4, 5, 6]); // [5, 7, 9]
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -65,4 +65,4 @@ A frozen anchor with unit, orthogonal direction and up vectors.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -41,4 +41,4 @@ A normalized right-handed frame at the anchor position.
 
 - [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -43,4 +43,4 @@ A fresh transformed direction.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -41,4 +41,4 @@ A fresh transformed point.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -75,4 +75,4 @@ A frozen affine transform for the moving object.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -2,7 +2,7 @@
 
 Constructs immutable finite XY bounds from ordered extrema or nonnegative size in millimetres.
 
-**bounds2**(`input`: [`Bounds2Options`](Bounds2Options.md)): [`Bounds2`](Bounds2-type.md)
+**bounds2**(`input`: [`Bounds2Options`](Bounds2Options.md) \| [`Bounds2`](Bounds2-type.md)): [`Bounds2`](Bounds2-type.md)
 
 
 
@@ -10,13 +10,13 @@ Zero extents are valid. Invalid dimensions, nonfinite coordinates, reversed boun
 overflowing extents throw `INVALID_ARGUMENT` GeometryError. Use `toData()` for plain records.
 Size construction centers on the origin unless `center` is false. Size and extrema are exclusive.
 Compiled Generator packages passing these values to host recipes or computed data require
-runtime 9.0.0 or newer in major 9.
+runtime 10.0.0 or newer in major 10.
 
 ## Parameters
 
 <a id="input"></a>
 
-**`input`** · [`Bounds2Options`](Bounds2Options.md) · Required
+**`input`** · [`Bounds2Options`](Bounds2Options.md) \| [`Bounds2`](Bounds2-type.md) · Required
 
 
 
@@ -36,4 +36,4 @@ runtime 9.0.0 or newer in major 9.
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -2,7 +2,7 @@
 
 Constructs immutable finite XYZ bounds from ordered extrema or nonnegative size in millimetres.
 
-**bounds3**(`input`: [`Bounds3Options`](Bounds3Options.md)): [`Bounds3`](Bounds3-type.md)
+**bounds3**(`input`: [`Bounds3Options`](Bounds3Options.md) \| [`Bounds3`](Bounds3-type.md)): [`Bounds3`](Bounds3-type.md)
 
 
 
@@ -10,13 +10,13 @@ Zero extents are valid. Invalid dimensions, nonfinite coordinates, reversed boun
 overflowing extents throw `INVALID_ARGUMENT` GeometryError. Use `toData()` for plain records.
 Size construction centers on the origin unless `center` is false. Size and extrema are exclusive.
 Compiled Generator packages passing these values to host recipes or computed data require
-runtime 9.0.0 or newer in major 9.
+runtime 10.0.0 or newer in major 10.
 
 ## Parameters
 
 <a id="input"></a>
 
-**`input`** · [`Bounds3Options`](Bounds3Options.md) · Required
+**`input`** · [`Bounds3Options`](Bounds3Options.md) \| [`Bounds3`](Bounds3-type.md) · Required
 
 
 
@@ -36,4 +36,4 @@ runtime 9.0.0 or newer in major 9.
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -60,4 +60,4 @@ Midpoint of finite XYZ bounds in millimetres.
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -60,4 +60,4 @@ Inclusive XYZ dimensions in millimetres; zero extents are retained.
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -12,7 +12,7 @@ Creates an outward face-center anchor using the same local origin convention as
 
 **`options`** · [`BoxAnchorOptions`](BoxAnchorOptions.md) · Required
 
-- [`size`](BoxAnchorOptions.md#size) · `number` \| [`Vector3Data`](Vector3Data.md) · Required
+- [`size`](BoxAnchorOptions.md#size) · `number` \| [`Vector3Input`](Vector3Input.md) · Required
 
   XYZ dimensions, or one uniform dimension, in millimetres.
 
@@ -24,7 +24,7 @@ Creates an outward face-center anchor using the same local origin convention as
 
   Centers the box around its construction origin; defaults to true, matching box().
 
-- [`origin`](BoxAnchorOptions.md#origin) · [`Vector3Data`](Vector3Data.md) · Optional
+- [`origin`](BoxAnchorOptions.md#origin) · [`Vector3Input`](Vector3Input.md) · Optional
 
   Construction origin; centered-box center or noncentered minimum corner. Defaults to zero.
 
@@ -50,4 +50,4 @@ resulting anchor frame explicitly; no anchor is inherited from a Boolean result.
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
 - [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/geometry/categories/bounds-layout.md

@@ -5,9 +5,9 @@ Measure finite bounds, test positioned containment, and fit or arrange geometry.
 Use `bounds2` and `bounds3` for immutable extents with fluent `size()`, `center()`, and `containsBounds()` queries. Zero extents are valid. Containment includes boundary contact in the same coordinate frame; it does not establish manufacturing fit.
 
 - **Interchange:** measurements and snapshots retain plain `Bounds2Data`/`Bounds3Data` min/max records. `toData()` returns a stable frozen record. Standalone helpers accept values or data.
-- **Construct:** `bounds2({ size })` and `bounds3({ size })` center on the origin unless `center` is `false`. Size and min/max construction are mutually exclusive.
+- **Construct:** `bounds2({ size })` and `bounds3({ size })` center on the origin unless `center` is `false`. Choose either size or min/max construction; they can't be combined.
 - **Fit:** `fitBounds` scales uniformly and centers in a target, returning scale, position, and resulting data bounds. `maxScale` limits enlargement.
-- **Arrange:** `layoutRow` returns translations for a +X row with minimum Y/Z at zero. Supply bounds after intended rotations, then apply positions through part options.
+- **Arrange:** `layoutRow` returns translations for a +X row with minimum Y/Z at zero. Supply bounds after intended rotations, then pass `transform3().translate(position)` through the part's `transform` option.
 
 ## Functions
 
@@ -48,4 +48,4 @@ Use `bounds2` and `bounds3` for immutable extents with fluent `size()`, `center(
 - [Text from a Font parameter](../../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/geometry/categories/curves-paths.md

@@ -1,6 +1,6 @@
 # Curves and paths
 
-Sample reusable lines, arcs, cubic curves, and path frames with explicit physical policies.
+Sample reusable lines, arcs, cubic curves, and path frames with explicit physical sampling settings.
 
 Use immutable `path2(points, { closed })` and `path3(points, { closed })` values for sampled trajectories. Closed paths omit the duplicated endpoint. Geometry accepts matching path values directly.
 
@@ -77,4 +77,4 @@ Sweep frames require explicit seam and orientation choices.
 
 - [Path queries and closure-preserving interchange](../../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/geometry/categories/mechanical.md

@@ -2,7 +2,7 @@
 
 Resolve gears, knuckle joints, fastener standards, thread profiles, fit, and predictable allocations.
 
-Pure kernels resolve dimensions and emit outlines or meshes without native state. Keep physical clearance separate from Boolean overtravel.
+Calculate dimensions and produce outlines or meshes without native state. Keep physical clearance separate from Boolean overtravel.
 
 Thread and gear results are modeling aids, not certified manufacturing or strength specifications.
 
@@ -11,8 +11,6 @@ Thread and gear results are modeling aids, not certified manufacturing or streng
 | API | Summary |
 | --- | --- |
 | [resolveKnuckleHinge](../resolveKnuckleHinge.md) | Resolves equal alternating knuckles along +X, centered at the origin, in millimetres. |
-| [helicalThreadRidgeMesh](../helicalThreadRidgeMesh.md) | Builds closed thread-ridge components with every profile locked to the shaft's radial/axial frame. The mesh is intended for union with its minor-envelope cylinder and never owns WASM objects. |
-| [helicalThreadSolidMesh](../helicalThreadSolidMesh.md) | Builds one closed threaded cylinder without a ridge/core Boolean seam. |
 | [compensateThreadDiameters](../compensateThreadDiameters.md) | Applies role-specific radial compensation while preserving thread depth. |
 | [compensateThreadProfileAxially](../compensateThreadProfileAxially.md) | Applies axial fit allowance to a validated periodic profile. |
 | [compensateThreadProfileForFaceting](../compensateThreadProfileForFaceting.md) | Applies printable axial fit plus the conservative phase allowance required by circular facets. |
@@ -21,7 +19,6 @@ Thread and gear results are modeling aids, not certified manufacturing or streng
 | [getMetricFastenerStandard](../getMetricFastenerStandard.md) | Returns the immutable standards record for one supported metric size. |
 | [measureInternalCylindricalGearPairMotion](../measureInternalCylindricalGearPairMotion.md) | Measures sampled kinematic interference over one tooth cycle of an internal gear pair. |
 | [minimumCylindricalGearToothCountWithoutUndercut](../minimumCylindricalGearToothCountWithoutUndercut.md) | Returns the smallest unshifted full-depth external tooth count that avoids rack-cutter undercut. |
-| [preflightHelicalThreadSolidMesh](../preflightHelicalThreadSolidMesh.md) | Checks thread dimensions, profile, end treatments, sampling, and conservative estimates against output limits. |
 | [preflightInternalThreadCutter](../preflightInternalThreadCutter.md) | Resolves compensated cutter dimensions and checks extended mesh estimates against output limits. |
 | [preflightThreadedNut](../preflightThreadedNut.md) | Checks nut dimensions, chamfers, end-face wall, and the extended compensated cutter's allocation plan. |
 | [preflightThreadedRod](../preflightThreadedRod.md) | Resolves compensated rod dimensions and checks conservative mesh estimates against output limits. |
@@ -55,9 +52,9 @@ Thread and gear results are modeling aids, not certified manufacturing or streng
 | [CylindricalGearPairMotionReport](../CylindricalGearPairMotionReport.md) | Maximum sampled planar overlap for an external pinion inside an internal ring. |
 | [CylindricalGearPairSpec](../CylindricalGearPairSpec.md) | Inputs for resolving a coordinated cylindrical gear pair. |
 | [CylindricalGearSpec](../CylindricalGearSpec.md) | Nominal dimensions for a standard full-depth cylindrical involute gear. |
-| [HelicalThreadRidgeMeshOptions](../HelicalThreadRidgeMeshOptions.md) | Runtime-neutral options for the dedicated helical ridge mesher. |
-| [HelicalThreadSolidMeshOptions](../HelicalThreadSolidMeshOptions.md) | Options for a complete threaded-cylinder mesh; base semantics match the ridge builder. |
-| [HelicalThreadSolidMeshPreflight](../HelicalThreadSolidMeshPreflight.md) | Selected sampling counts and conservative allocation estimates, before thread mesh construction. |
+| [ThreadRidgeOptions](../ThreadRidgeOptions.md) | Runtime-neutral options for the dedicated helical ridge mesher. |
+| [ThreadSolidOptions](../ThreadSolidOptions.md) | Options for a complete threaded-cylinder mesh; base semantics match the ridge builder. |
+| [ThreadSolidPreflight](../ThreadSolidPreflight.md) | Selected sampling counts and conservative allocation estimates, before thread mesh construction. |
 | [InternalThreadCutterOptions](../InternalThreadCutterOptions.md) | Options for a compensated internal-thread subtraction tool along +Z. |
 | [MetricFastenerStandard](../MetricFastenerStandard.md) | Small immutable metric fastener record for modeling common mating features. |
 | [MetricHexNutDimensions](../MetricHexNutDimensions.md) | Regular hex-nut envelope dimensions in millimetres. |
@@ -67,7 +64,7 @@ Thread and gear results are modeling aids, not certified manufacturing or streng
 | [RackPitchSpec](../RackPitchSpec.md) | Normal-plane inputs for a finite rack pitch segment. |
 | [SampledThreadHelices](../SampledThreadHelices.md) | Sampled paths plus conventional pitch and lead measurements. |
 | [SquareThreadProfileSpec](../SquareThreadProfileSpec.md) | Square profile with equal crest and root widths. |
-| [ThreadBevelOptions](../ThreadBevelOptions.md) | End bevel controls shared by threaded rods and cutters. |
+| [ThreadBevelOptions](../ThreadBevelOptions.md) | 45-degree end bevels for compensated rods and cutters. |
 | [ThreadCircularSegmentsOptions](../ThreadCircularSegmentsOptions.md) | Inputs for resolving one shared circular facet count for a mating thread pair. |
 | [ThreadCompensationOptions](../ThreadCompensationOptions.md) | Options for compensating nominal male or female thread diameters. |
 | [ThreadedNutOptions](../ThreadedNutOptions.md) | Options for a compensated nut with an internal thread. |
@@ -90,7 +87,8 @@ Thread and gear results are modeling aids, not certified manufacturing or streng
 | [CylindricalGearMeshKind](../CylindricalGearMeshKind.md) | Whether two cylindrical gears mesh on their outside teeth or as a pinion inside a ring. |
 | [MetricFastenerSize](../MetricFastenerSize.md) | Supported metric fastener sizes. |
 | [PrintableThreadFit](../PrintableThreadFit.md) | Named baseline fit policies for calibrated FDM-style printed threads. |
-| [ThreadedNutBevel](../ThreadedNutBevel.md) | Nut-edge bevel selection. |
+| [Bevel](../Bevel.md) | One size for both ends, or independent sizes in bottom/top order. Zero disables an end. |
+| [BevelSize](../BevelSize.md) | Nonnegative 45-degree axial/radial bevel size in millimetres, or factory automatic sizing. |
 | [ThreadedNutShape](../ThreadedNutShape.md) | Supported printable nut body shapes. |
 | [ThreadEndStyle](../ThreadEndStyle.md) | End shape of a generated helical ridge. |
 | [ThreadHandedness](../ThreadHandedness.md) | Direction in which a conventional helical thread advances around +Z. |
@@ -110,4 +108,4 @@ Thread and gear results are modeling aids, not certified manufacturing or streng
 
 - [Conservative estimates and preflight guarantees](../../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/geometry/categories/meshes.md

@@ -1,34 +1,22 @@
 # Triangle meshes and surfaces
 
-Build, transform, validate, analyze, and locally optimize copied indexed meshes.
+Data, options, and reports for triangle mesh construction and processing.
 
-Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle indices. Analysis freshly inspects caller-owned arrays; signatures add quantized topology and a regression hash. Predictable constructors reject unsafe allocations before sampling.
+Import mesh operations from `@metamesh/modeling/geometry/mesh` using `import * as mesh`. These contracts describe the inputs, limits, and reports accepted by that module.
 
-- **Construct:** `extrudeMesh`, `loftMesh`, `sweepMesh`, and `revolveMesh` return `TriangleMesh` data without a host engine. `LoftOptions`, `SweepOptions`, and `ExtrudeOptions` share the filled modeling vocabulary.
-- **Match lofts:** `loftMesh` requires a `direct`, `reindex`, `fast-distance`, or `distance` method. Stations specify exactly one `z` or `frame`, retain original vertices, and interpolate slices in world coordinates. Association and grid work are bounded without reducing fidelity.
-- **Validate:** closed oriented-edge checks do not establish freedom from self-intersections. `validateSolidMesh` adds bounded floating-point intersection and nested-shell orientation checks, including cavity boundaries. Contacts within tolerance reject conservatively; exhausted work limits fail explicitly.
-- **Measure:** `computeTriangleMeshCentroid` returns the uniform-density volume centroid of consistently oriented closed geometry, including cavities.
+Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle indices. Mesh analysis accepts raw arrays or stable immutable buffers directly; signatures add quantized topology and a regression hash. Predictable constructors reject unsafe allocations before sampling.
+
+- **Construct:** `mesh.extrude`, `mesh.loft`, `mesh.sweep`, `mesh.revolve`, `mesh.threadRidge`, and `mesh.threadSolid` return `TriangleMesh` data without a host engine. `LoftOptions`, `SweepOptions`, and `ExtrudeMeshOptions` describe pure construction. Native `ExtrudeOptions` additionally accepts end treatments.
+- **Match lofts:** `mesh.loft` defaults to `direct` correspondence; select `reindex`, `fast-distance`, or `distance` explicitly when needed. Stations specify exactly one `z` or `frame`, retain original vertices, and interpolate slices in world coordinates. Profile association and sampling-grid work have explicit limits; fidelity isn't reduced to meet them.
+- **Validate:** closed oriented-edge checks do not establish freedom from self-intersections. `mesh.validateSolid` adds bounded floating-point intersection and nested-shell orientation checks, including cavity boundaries. Contacts within tolerance reject conservatively; exhausted work limits fail explicitly.
+- **Measure:** `mesh.centroid` returns the uniform-density volume centroid of consistently oriented closed geometry, including cavities.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [analyzeTriangleMesh](../analyzeTriangleMesh.md) | Validates and measures a mesh in one position and one triangle traversal. |
-| [analyzeTriangleMeshQuality](../analyzeTriangleMeshQuality.md) | Measures triangle shape, edge topology, vertex concentration, and connected planar patches. |
-| [heightfieldMesh](../heightfieldMesh.md) | Builds a closed indexed mesh from a rectilinear top, matched boundary walls, and flat base. |
-| [computeTriangleMeshSignature](../computeTriangleMeshSignature.md) | Creates an order-independent regression signature for a manufacturing mesh. |
-| [joinTriangleMeshes](../joinTriangleMeshes.md) | Concatenates meshes into one indexed mesh without welding coincident vertices. |
-| [extrudeMesh](../extrudeMesh.md) | Linearly extrudes one simple profile along +Z with robust ear-clipped caps. Path2 profiles must be closed; raw point collections have an implicit closing edge. |
-| [loftMesh](../loftMesh.md) | Lofts simple point loops at z heights or explicit right-handed frames, in input order. |
-| [preflightHeightfield](../preflightHeightfield.md) | Checks grid options, Float32 axis precision, and output limits; returns exact mesh buffer counts. |
-| [reverseTriangleMesh](../reverseTriangleMesh.md) | Returns a copy of a mesh with every triangle winding reversed. |
-| [sweepMesh](../sweepMesh.md) | Sweeps one explicitly ordered point loop, with caps or a geometrically matching closed seam. |
-| [transformTriangleMesh](../transformTriangleMesh.md) | Applies an affine transform to a mesh and preserves outward face orientation. |
-| [validateTriangleMesh](../validateTriangleMesh.md) | Validates mesh buffers, indices, triangle area, and optionally closed topology. |
-| [optimizePlanarPatches](../optimizePlanarPatches.md) | Improves pathological planar triangulation with bounded legal diagonal flips. |
 | [resolveExtrusionDivisions](../resolveExtrusionDivisions.md) | Resolves intermediate profile copies for linear extrusion from physical curve resolution. |
-| [validateSolidMesh](../validateSolidMesh.md) | Checks closed indexed topology, triangle intersections, and alternating nested shell orientation. |
-| [computeTriangleMeshCentroid](../computeTriangleMeshCentroid.md) | Computes the uniform-density volume centroid of an oriented closed solid, including cavity shells. |
+| [immutableBuffer](../immutableBuffer.md) | Copies numeric data once into private storage. This pure helper needs no active generation. |
 
 ## Interfaces
 
@@ -39,8 +27,9 @@ Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle
 | [PlanarMeshOptimizationResult](../PlanarMeshOptimizationResult.md) | Outcome of bounded planar-patch optimization, including before/after diagnostics. |
 | [RevolveOptions](../RevolveOptions.md) | Circumferential sampling and degree sweep shared by pure and filled revolution. |
 | [SweepOptions](../SweepOptions.md) | Controls shared by pure mesh construction and filled modeling sweeps. |
-| [TriangleMesh](../TriangleMesh.md) | A topology-preserving indexed triangle mesh with XYZ vertex positions. |
+| [TriangleMesh](../TriangleMesh.md) | A topology-preserving indexed triangle mesh with mutable owned XYZ buffers. |
 | [TriangleMeshAnalysis](../TriangleMeshAnalysis.md) | Measurements and optional edge-connected topology from one validated mesh traversal. |
+| [TriangleMeshTopologyAnalysis](../TriangleMeshTopologyAnalysis.md) | Mesh measurements with the indexed surface-shell and edge counts requested by includeTopology. |
 | [TriangleMeshAnalysisOptions](../TriangleMeshAnalysisOptions.md) | Validation and optional connectivity controls for a shared mesh analysis. |
 | [TriangleMeshMeasurements](../TriangleMeshMeasurements.md) | Geometric measurements derived from a validated, non-empty triangle mesh. |
 | [TriangleMeshQualityOptions](../TriangleMeshQualityOptions.md) | Options controlling bounded triangle-mesh quality analysis. |
@@ -49,11 +38,14 @@ Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle
 | [TriangleMeshSignatureOptions](../TriangleMeshSignatureOptions.md) | Options controlling deterministic triangle-mesh regression signatures. |
 | [TriangleMeshSignatureTolerances](../TriangleMeshSignatureTolerances.md) | Absolute tolerances recorded in a triangle-mesh regression signature. |
 | [TriangleMeshValidationOptions](../TriangleMeshValidationOptions.md) | Options controlling structural and manufacturing validation of a mesh. |
-| [ExtrudeOptions](../ExtrudeOptions.md) | Dimensions and sampling shared by native and pure +Z extrusion. |
+| [ExtrudeOptions](../ExtrudeOptions.md) | Native +Z extrusion with optional inward end treatments. |
+| [ExtrudeMeshOptions](../ExtrudeMeshOptions.md) | Dimensions and sampling for pure +Z mesh extrusion, without end treatments. |
 | [ExtrusionSamplingOptions](../ExtrusionSamplingOptions.md) | Shared sampling controls for a twisted or scaled linear extrusion. |
-| [LoftOptions](../LoftOptions.md) | Shared controls for native and pure lofts. Point data and arbitrary Sections require explicit correspondence. |
+| [LoftOptions](../LoftOptions.md) | Shared controls for native and pure lofts. Point data and arbitrary Sections default to direct correspondence. |
 | [PlanarPatchQuality](../PlanarPatchQuality.md) | Quality measurements for one edge-connected coplanar triangle patch. |
 | [SolidMeshValidationOptions](../SolidMeshValidationOptions.md) | Bounded floating-point intersection and shell-orientation validation settings. |
+| [ImmutableBuffer](../ImmutableBuffer-type.md) | Owned immutable numeric data. Iterate without copying; use copy() for mutable storage. |
+| [ImmutableTriangleMesh](../ImmutableTriangleMesh.md) | Immutable local XYZ positions and triangle indices, suitable for a computed value or part. |
 
 ## Type aliases
 
@@ -66,16 +58,11 @@ Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle
 | [SweepOrientation](../SweepOrientation.md) | Explicit profile-X frame policy; all normals are directed, and selected singular policies reject. |
 | [LoftCorrespondence](../LoftCorrespondence.md) | Associates ordered loft contours without inferring component identities or repairing topology. |
 | [LoftPlacement](../LoftPlacement.md) | A horizontal XY station height, or an explicit right-handed spatial frame, never both. |
-
-## Values
-
-| API | Summary |
-| --- | --- |
-| [meshBounds](../meshBounds.md) | Computes axis-aligned bounds for a non-empty mesh. |
-| [revolveMesh](../revolveMesh.md) | Revolves a non-duplicated closed `[radius, z]` profile around +Z. |
+| [TriangleMeshInput](../TriangleMeshInput.md) | Raw construction buffers or immutable captured geometry accepted by mesh utilities. |
+| [NumericArray](../NumericArray.md) | Numeric storage supported by immutable generation buffers. |
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/geometry/categories/pattern-placement.md

@@ -2,7 +2,7 @@
 
 Calculate pure linear, radial, grid, and path transforms.
 
-Pure pattern transforms share counts, spacing, centering, and frames with root pattern operations. Use `Transform3Data` to place points, meshes, or explicit geometry without a native engine.
+Pattern helpers use the same counts, spacing, centering, and frames as pattern operations in `@metamesh/modeling`. Use `Transform3Data` to place points, meshes, or explicit geometry without a native engine.
 
 Linear and grid spacing use millimetres; radial angles use degrees. Paths use physical arc-length intervals and omit the repeated seam when closed.
 
@@ -33,4 +33,4 @@ Linear and grid spacing use millimetres; radial angles use degrees. Paths use ph
 
 - [Primitive booleans and repeated placement](../../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.