@metamesh/modeling 0.17.0 → 0.19.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"`
 
 
 
@@ -110,6 +110,16 @@ Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
 ## Guides
 
-- [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
+- [SVG preflight work and guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import type { VectorTextLayoutOptions } from "@metamesh/modeling/geometry";
+```
+
+```ts
+import type { VectorTextLayoutOptions } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -93,6 +93,20 @@ Number of lines, including empty and trailing lines; empty text occupies one lin
 
 ## Guides
 
-- [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
+- [SVG preflight work and guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import type { VectorTextMetrics } from "@metamesh/modeling";
+```
+
+```ts
+import type { VectorTextMetrics } from "@metamesh/modeling/geometry";
+```
+
+```ts
+import type { VectorTextMetrics } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -49,6 +49,16 @@ Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
 ## Guides
 
-- [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
+- [SVG preflight work and guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import type { VectorTextOptions } from "@metamesh/modeling/geometry";
+```
+
+```ts
+import type { VectorTextOptions } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -31,7 +31,13 @@ Adds two finite XY vectors component-wise.
 
 ## Guides
 
-- [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)
+- [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { add2 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -37,7 +37,13 @@ add3([1, 2, 3], [4, 5, 6]); // [5, 7, 9]
 
 ## Guides
 
-- [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)
+- [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { add3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -62,7 +62,13 @@ A frozen anchor with unit, orthogonal direction and up vectors.
 
 ## Guides
 
-- [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)
+- [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { anchor3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -39,6 +39,12 @@ A normalized right-handed frame at the anchor position.
 
 ## Guides
 
-- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { anchorFrame3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -40,7 +40,13 @@ A fresh transformed direction.
 
 ## Guides
 
-- [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)
+- [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { applyTransformDirection3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -38,7 +38,13 @@ A fresh transformed point.
 
 ## Guides
 
-- [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)
+- [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { applyTransformPoint3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -72,7 +72,13 @@ A frozen affine transform for the moving object.
 
 ## Guides
 
-- [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)
+- [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { attachmentTransform3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -2,21 +2,21 @@
 
 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)
 
 
 
 Zero extents are valid. Invalid dimensions, nonfinite coordinates, reversed bounds and
 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.
+Compiled Generator packages passing these values to host recipes or memo data require
+the current Modeling runtime.
 
 ## Parameters
 
 <a id="input"></a>
 
-**`input`** · [`Bounds2Options`](Bounds2Options.md) · Required
+**`input`** · [`Bounds2Options`](Bounds2Options.md) \| [`Bounds2`](Bounds2-type.md) · Required
 
 
 
@@ -32,8 +32,18 @@ runtime 9.0.0 or newer in major 9.
 
 ## Guides
 
-- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
-- [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
-- [Solid inspection](../../guides/recipes.md#solid-inspection)
+- [Measure and compare bounds](../../guides/transforms-and-placement.md#measure-and-compare-bounds)
+- [Text from a Font parameter](../../guides/svg-and-text.md#text-from-a-font-parameter)
+- [Solid inspection](../../guides/resolution-and-inspection.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { bounds2 } from "@metamesh/modeling";
+```
+
+```ts
+import { bounds2 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -2,21 +2,21 @@
 
 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)
 
 
 
 Zero extents are valid. Invalid dimensions, nonfinite coordinates, reversed bounds and
 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.
+Compiled Generator packages passing these values to host recipes or memo data require
+the current Modeling runtime.
 
 ## Parameters
 
 <a id="input"></a>
 
-**`input`** · [`Bounds3Options`](Bounds3Options.md) · Required
+**`input`** · [`Bounds3Options`](Bounds3Options.md) \| [`Bounds3`](Bounds3-type.md) · Required
 
 
 
@@ -32,8 +32,18 @@ runtime 9.0.0 or newer in major 9.
 
 ## Guides
 
-- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
-- [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
-- [Solid inspection](../../guides/recipes.md#solid-inspection)
+- [Measure and compare bounds](../../guides/transforms-and-placement.md#measure-and-compare-bounds)
+- [Text from a Font parameter](../../guides/svg-and-text.md#text-from-a-font-parameter)
+- [Solid inspection](../../guides/resolution-and-inspection.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { bounds3 } from "@metamesh/modeling";
+```
+
+```ts
+import { bounds3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -56,8 +56,14 @@ Midpoint of finite XYZ bounds in millimetres.
 
 ## Guides
 
-- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
-- [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
-- [Solid inspection](../../guides/recipes.md#solid-inspection)
+- [Measure and compare bounds](../../guides/transforms-and-placement.md#measure-and-compare-bounds)
+- [Text from a Font parameter](../../guides/svg-and-text.md#text-from-a-font-parameter)
+- [Solid inspection](../../guides/resolution-and-inspection.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { boundsCenter } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -56,8 +56,14 @@ Inclusive XYZ dimensions in millimetres; zero extents are retained.
 
 ## Guides
 
-- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
-- [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
-- [Solid inspection](../../guides/recipes.md#solid-inspection)
+- [Measure and compare bounds](../../guides/transforms-and-placement.md#measure-and-compare-bounds)
+- [Text from a Font parameter](../../guides/svg-and-text.md#text-from-a-font-parameter)
+- [Solid inspection](../../guides/resolution-and-inspection.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { boundsSize } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.19.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.
 
@@ -47,7 +47,13 @@ resulting anchor frame explicitly; no anchor is inherited from a Boolean result.
 
 ## Guides
 
-- [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)
+- [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { boxAnchor3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.19.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
 
@@ -44,8 +44,8 @@ Use `bounds2` and `bounds3` for immutable extents with fluent `size()`, `center(
 
 ## Guides
 
-- [Measure and compare bounds](../../../guides/concepts.md#measure-and-compare-bounds)
-- [Text from a Font parameter](../../../guides/recipes.md#text-from-a-font-parameter)
-- [Solid inspection](../../../guides/recipes.md#solid-inspection)
+- [Measure and compare bounds](../../../guides/transforms-and-placement.md#measure-and-compare-bounds)
+- [Text from a Font parameter](../../../guides/svg-and-text.md#text-from-a-font-parameter)
+- [Solid inspection](../../../guides/resolution-and-inspection.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.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.
 
@@ -75,6 +75,6 @@ Sweep frames require explicit seam and orientation choices.
 
 ## Guides
 
-- [Path queries and closure-preserving interchange](../../../guides/concepts.md#query-paths-and-preserve-closure)
+- [Path queries and closure-preserving interchange](../../../guides/geometry-values.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.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. |
@@ -108,6 +106,6 @@ Thread and gear results are modeling aids, not certified manufacturing or streng
 
 ## Guides
 
-- [Conservative estimates and preflight guarantees](../../../guides/concepts.md#check-preflight-guarantees)
+- [Conservative estimates and preflight guarantees](../../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.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 memo result 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)
+- [Exact counts and preflight guarantees](../../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.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.
 
@@ -31,6 +31,6 @@ Linear and grid spacing use millimetres; radial angles use degrees. Paths use ph
 
 ## Guides
 
-- [Primitive booleans and repeated placement](../../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+- [Primitive booleans and repeated placement](../../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.0`.