@metamesh/modeling 0.16.0 → 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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/geometry/categories/primitive-options.md

@@ -1,6 +1,6 @@
 # Primitive options
 
-Share one option contract for dimensional primitives and edge treatments.
+Configure dimensional primitives and edge treatments with shared options.
 
 Dimensional shapes share object options, millimetre units, and explicit placement:
 
@@ -19,7 +19,6 @@ Dimensional shapes share object options, millimetre units, and explicit placemen
 | [CircularPrimitiveOptions](../CircularPrimitiveOptions.md) | Tessellation controls shared by circular primitives across Geometry entry points. |
 | [RoundedEdgeTreatment](../RoundedEdgeTreatment.md) | A circular edge or corner roundover with explicit physical sampling. |
 | [TorusOptions](../TorusOptions.md) | Dimensions and independent ring/profile tessellation for a torus around the Z axis. |
-| [TubeOptions](../TubeOptions.md) | Dimensions, placement, and tessellation for a hollow Z-axis tube. |
 | [EndTreatments](../EndTreatments.md) | Independent inward finishing on primitive or straight convex extrusion ends. Zero amounts leave the end untreated, including when all ends are disabled. |
 | [PrimitiveAttachment](../PrimitiveAttachment.md) | Anchor attachment shared by solid and filled-section factories. |
 | [PrimitiveAttachmentOptions](../PrimitiveAttachmentOptions.md) | Maps an explicit or named shape-local attachment anchor onto a world-space anchor. |
@@ -34,9 +33,10 @@ Dimensional shapes share object options, millimetre units, and explicit placemen
 | [EdgeTreatment](../EdgeTreatment.md) | Uniform finishing vocabulary shared by applicable solid edges and profile corners. |
 | [CylinderOptions](../CylinderOptions.md) | Dimensions, placement, independent end finishing, and tessellation for a Z-axis cylinder or frustum. |
 | [SphereOptions](../SphereOptions.md) | Exactly one radius or diameter, placement, and tessellation for an origin-centered sphere. |
+| [TubeOptions](../TubeOptions.md) | Dimensions, placement, and tessellation for a hollow Z-axis tube. |
 | [RadialSizing](../RadialSizing.md) | Radial dimensions refer to polygon vertices or compensate faceting to meet polygon faces. |
 | [BoxEdge](../BoxEdge.md) | Box edges use +Z top, +Y front and +X right; vertical names list front/back first. |
 | [BoxEdgeSelection](../BoxEdgeSelection.md) | Named individual edges or top/bottom rims and all four vertical edges. |
 | [BoxEdgeTreatments](../BoxEdgeTreatments.md) | Independent treatments for disjoint named edge selections; overlapping selections fail. |
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/geometry/categories/profiles-regions.md

@@ -19,7 +19,7 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | [normalizeContour](../normalizeContour.md) | Cleans and validates one closed loop. |
 | [normalizePolygon](../normalizePolygon.md) | Validates explicit polygon topology and normalizes its winding. |
 | [normalizeRegion](../normalizeRegion.md) | Validates a disjoint explicit region and returns immutable normalized data. Previously validated immutable results may be returned unchanged under the same tolerance policy. |
-| [rectangleContour](../rectangleContour.md) | Creates an immutable sampled CCW rectangle boundary. Round radius zero is square; tangent saturated endpoints occur once. |
+| [rectangleContour](../rectangleContour.md) | Creates an immutable sampled CCW rectangle boundary. |
 | [regionArea](../regionArea.md) | Returns the total filled area of a normalized region in square millimetres. |
 | [regionBounds](../regionBounds.md) | Returns finite axis-aligned bounds for a non-empty region. |
 | [rectangleProfile](../rectangleProfile.md) | Creates an identified rectangle whose edge/corner spans survive zero and saturated round radii. Outer winding is CCW. |
@@ -48,6 +48,7 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | [RectangleProfileOptions](../RectangleProfileOptions.md) | Shared rectangle options with an identified component for explicit profile families. |
 | [SampleSideProfileOptions](../SampleSideProfileOptions.md) | Physical scaling and bounded adaptive subdivision for an open profile. |
 | [SampleContourOptions](../SampleContourOptions.md) | Physical scaling, subdivision policy, and output ceilings for one closed contour. |
+| [StarContourOptions](../StarContourOptions.md) | Alternating vertex radii and exact point count for a centered XY star. |
 | [CorrespondingComponent](../CorrespondingComponent.md) | One sampled component retaining contour identities and logical point correspondence. |
 | [CorrespondingContour](../CorrespondingContour.md) | A sampled contour retaining logical slots, including intentionally collapsed spans. |
 | [RegularPolygonContourOptions](../RegularPolygonContourOptions.md) | Exact regular polygon dimensions and counterclockwise degree rotation. |
@@ -72,11 +73,11 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | API | Summary |
 | --- | --- |
 | [circleContour](../circleContour.md) | Creates an immutable centered CCW circle with +X seam and vertex or face radial sizing. |
-| [regularPolygonContour](../regularPolygonContour.md) | Creates a centered CCW point loop with vertex or face radial sizing and an implicit seam. |
-| [starContour](../starContour.md) | Creates a centered CCW alternating-radius star within the selected profile sampling ceiling. |
+| [regularPolygonContour](../regularPolygonContour.md) | Creates an immutable centered CCW point loop with vertex or face radial sizing and an implicit seam. |
+| [starContour](../starContour.md) | Creates an immutable centered CCW alternating-radius star within the selected profile sampling ceiling. |
 
 ## Guides
 
 - [Choose a geometry representation](../../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/geometry/categories/resolution-errors.md

@@ -1,10 +1,10 @@
 # Resolution and errors
 
-Resolve physical sampling, numerical tolerances, and contextual failures.
+Set physical sampling and numerical tolerances, and understand errors in context.
 
-Defaults are 0.05 mm maximum circular chord error and 16–512 segments per complete circle. Face-sized circular sampling bounds outward radial excess and actual edge lengths. Exact local counts take precedence.
+Defaults are 0.05 mm maximum circular chord error and 16–512 segments per complete circle. Face-sized circular sampling bounds outward radial excess and actual edge lengths. `resolveCircularSampling` returns the full-circle count and sampled vertex/face radii without constructing boundary points; `circleContour` uses the same calculation. Exact local counts take precedence.
 
-Algorithm limits fail explicitly. `GeometryError` provides structured codes and operation context; resolution has no ambient state.
+Algorithms report limit failures explicitly. `GeometryError` provides structured codes and operation context; resolution settings aren't stored in ambient state.
 
 ## Functions
 
@@ -14,6 +14,7 @@ Algorithm limits fail explicitly. `GeometryError` provides structured codes and
 | [resolveAlignedCircularSegments](../resolveAlignedCircularSegments.md) | Resolves a deterministic full-circle count aligned to reusable topology factors. |
 | [resolveArcSegments](../resolveArcSegments.md) | Resolves the number of segments needed for a circular arc. |
 | [resolveCircularSegments](../resolveCircularSegments.md) | Resolves a deterministic full-circle segment count for one radius. |
+| [resolveCircularSampling](../resolveCircularSampling.md) | Resolves circular sampling and its actual radial envelopes without allocating boundary points. |
 | [resolveGeometryTolerance](../resolveGeometryTolerance.md) | Resolves comparison tolerances for a characteristic model scale. |
 
 ## Classes
@@ -28,6 +29,7 @@ Algorithm limits fail explicitly. `GeometryError` provides structured codes and
 | --- | --- |
 | [AlignedCircularSegmentsOptions](../AlignedCircularSegmentsOptions.md) | Controls full-circle sampling that must satisfy one or more topology alignments. |
 | [CircularResolutionOptions](../CircularResolutionOptions.md) | Circular sampling measured from the nominal inscribed or circumscribed radius. |
+| [CircularSampling](../CircularSampling.md) | Full-circle count and radial envelopes of its regular sampled polygon, in millimetres. |
 | [GeometryErrorContext](../GeometryErrorContext.md) | Serializable context attached to a geometry failure. |
 | [GeometryResolution](../GeometryResolution.md) | Tessellation policy for sampled geometry measured in millimetres. |
 | [GeometryToleranceOptions](../GeometryToleranceOptions.md) | Optional overrides for MetaMesh's geometry comparison policy. |
@@ -38,6 +40,7 @@ Algorithm limits fail explicitly. `GeometryError` provides structured codes and
 
 | API | Summary |
 | --- | --- |
+| [CircularSamplingOptions](../CircularSamplingOptions.md) | Nominal circle size and explicit physical sampling; supply exactly one radius or diameter. |
 | [GeometryErrorCode](../GeometryErrorCode.md) | Stable categories for invalid inputs, topology, allocation, and runtime failures. |
 
 ## Values
@@ -46,4 +49,4 @@ Algorithm limits fail explicitly. `GeometryError` provides structured codes and
 | --- | --- |
 | [DEFAULT_GEOMETRY_TOLERANCE](../DEFAULT_GEOMETRY_TOLERANCE.md) | Default absolute, relative, and angular tolerances for millimetre-scale models. |
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/geometry/categories/transforms-math.md

@@ -1,6 +1,6 @@
 # Transforms and vector math
 
-Build immutable reusable placements and calculate with fluent vectors or tuple kernels.
+Build reusable placements and calculate with immutable fluent vectors or tuple math.
 
 Use immutable `vector2`/`vector3` and `transform2`/`transform3` values for ordinary authoring. Operations return new values; tuples remain convenient inputs.
 
@@ -34,6 +34,7 @@ Attachment matches source and target frames. You choose physical clearance.
 | [scaleTransform3](../scaleTransform3.md) | Creates an immutable axis-aligned scale transform. |
 | [transformDeterminant3](../transformDeterminant3.md) | Returns the determinant of a transform's linear 3x3 component. |
 | [translationTransform3](../translationTransform3.md) | Creates an immutable translation transform. |
+| [validateRigidTransform3](../validateRigidTransform3.md) | Validates a proper rigid transform: finite translation and a right-handed orthonormal rotation. Scale, shear, reflection, and perspective are rejected within the default angular tolerance. Returns the original row-major 4x4 matrix without copying or normalizing it. |
 | [validateTransform3](../validateTransform3.md) | Validates that a transform is finite, affine, and non-singular. |
 
 ## Interfaces
@@ -98,4 +99,4 @@ Attachment matches source and target frames. You choose physical clearance.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/geometry/categories/vector-import.md

@@ -1,8 +1,8 @@
 # SVG and vector layouts
 
-Parse bounded painted SVG and carry explicit prepared text geometry.
+Parse painted SVG within limits and work with explicitly prepared text geometry.
 
-SVG parsing bounds input and reports unsupported resources or content with context. Transforms and physical unit conversion precede sampling; Y-down input converts to model Y-up coordinates.
+SVG parsing checks input limits and reports unsupported resources or content with context. Transforms and physical unit conversion precede sampling; Y-down input converts to model Y-up coordinates.
 
 Font preparation belongs to the optional text entry point, outside pure parsing and synchronous modeling. `fitTextLayout` uniformly fits and centers visible ink before sampling, preserving final millimetre tolerance. It rejects invisible layouts; `maxScale: 1` prevents enlargement.
 
@@ -43,4 +43,4 @@ Font preparation belongs to the optional text entry point, outside pure parsing
 
 - [SVG preflight work and guarantees](../../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -34,4 +34,4 @@ circleContour({ diameter: 20, segments: 32 });
 
 - [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -40,4 +40,4 @@ This is a solid-body closure, not a hollow-wall or mounting-bore construction.
 
 - [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -52,4 +52,4 @@ allowances as radial mating clearance.
 
 - [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -43,4 +43,4 @@ change. The returned profile is a new deeply immutable value.
 
 - [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -57,4 +57,4 @@ it exactly.
 
 - [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -42,4 +42,4 @@ A new frozen transform equal to `after * before`.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -50,4 +50,4 @@ readonly [`PathFrame`](PathFrame.md)[]
 
 - [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -54,4 +54,4 @@ readonly [`PathFrame`](PathFrame.md)[]
 
 - [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -34,4 +34,4 @@ Returns true when a point lies inside or on the boundary of a loop.
 
 - [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -34,4 +34,4 @@ Returns the signed scalar cross product; positive means `b` is counter-clockwise
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -40,4 +40,4 @@ cross3([1, 0, 0], [0, 1, 0]); // [0, 0, 1]
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -32,7 +32,7 @@ Creates a cap-center or radial-side anchor using cylinder()'s construction origi
 
   Centers the cylinder along Z; defaults to true, matching cylinder().
 
-- [`origin`](CylinderAnchorOptions.md#origin) · [`Vector3Data`](Vector3Data.md) · Optional
+- [`origin`](CylinderAnchorOptions.md#origin) · [`Vector3Input`](Vector3Input.md) · Optional
 
   Construction origin; centered-axis midpoint or noncentered bottom axis. Defaults to zero.
 
@@ -58,4 +58,4 @@ origin applies an explicit translation, and arbitrary component transforms remai
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -15,4 +15,4 @@ Conservative defaults; trusted callers can supply larger explicit ceilings.
 
 - [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -34,4 +34,4 @@ Returns Euclidean point distance without allocating an intermediate difference v
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -34,4 +34,4 @@ Returns Euclidean point distance without allocating an intermediate difference v
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -54,4 +54,4 @@ readonly [`PathPlacement`](PathPlacement.md)[]
 
 - [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -34,4 +34,4 @@ Returns the scalar dot product.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -40,4 +40,4 @@ dot3([1, 0, 0], [0, 1, 0]); // 0
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -34,4 +34,4 @@ ellipseContour({ size: [30, 20] });
 
 - [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -40,4 +40,4 @@ A frozen row-major transform.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -93,4 +93,4 @@ Fits XYZ bounds uniformly and centers them in the target; zero source axes do no
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -62,4 +62,4 @@ A deeply immutable layout with transformed paths, ink bounds, and physical metri
 
 - [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -46,4 +46,4 @@ A frozen rigid transform.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -34,4 +34,4 @@ Returns one recommended metric clearance-hole diameter in millimetres.
 
 - [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -28,4 +28,4 @@ Returns the immutable standards record for one supported metric size.
 
 - [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -28,4 +28,4 @@ readonly [`Transform3Data`](Transform3Data.md)[]
 
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,49 @@
+# immutableBuffer
+
+Copies numeric data once into private storage. This pure helper needs no active generation.
+
+**immutableBuffer**\<`T` *extends* [`NumericArray`](NumericArray.md)\>(`source`: `T`): [`ImmutableBuffer`](ImmutableBuffer-type.md)\<`T`\>
+
+
+
+## Example
+
+```ts
+import { immutableBuffer } from "@metamesh/modeling";
+const heights = immutableBuffer(new Float32Array([2, 4, 6]));
+const count = heights.length;
+const first = heights.at(0);
+const doubled = Array.from(heights, (height) => height * 2);
+const editable = heights.copy();
+editable[0] = 8; // heights still contains 2, 4, 6.
+```
+
+## Type Parameters
+
+### T
+
+`T` *extends* [`NumericArray`](NumericArray.md)
+
+## Parameters
+
+<a id="source"></a>
+
+**`source`** · `T` · Required
+
+
+
+## Returns
+
+[`ImmutableBuffer`](ImmutableBuffer-type.md)\<`T`\>
+
+
+## Related APIs
+
+- [ImmutableBuffer](ImmutableBuffer-type.md)
+- [NumericArray](NumericArray.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -32,4 +32,4 @@ A new frozen transform whose composition with the input is identity.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -26,4 +26,4 @@ does not survive structured cloning; worker protocols carry their own serialized
 
 - [GeometryError](GeometryError.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -44,4 +44,4 @@ readonly [`Vector3Data`](Vector3Data.md)[]
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -28,4 +28,4 @@ Returns Euclidean vector length in the vector's coordinate units.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -28,4 +28,4 @@ Returns Euclidean vector length in the vector's coordinate units.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -40,4 +40,4 @@ Linearly interpolates two vectors; `t` is dimensionless and may extrapolate.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -40,4 +40,4 @@ Linearly interpolates two vectors; `t` is dimensionless and may extrapolate.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -28,4 +28,4 @@ readonly [`Transform3Data`](Transform3Data.md)[]
 
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -57,4 +57,4 @@ readonly [`CorrespondingProfile`](CorrespondingProfile.md)[]
 
 - [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -49,4 +49,4 @@ misses. It is a deterministic model check, not a certified gear-rating calculati
 
 - [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -30,4 +30,4 @@ count `z_v = z / cos³(beta)`, so increasing helix angle can reduce the physical
 
 - [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -37,4 +37,4 @@ Rejects invalid thresholds, nonfinite lengths, and lengths at or below the thres
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -37,4 +37,4 @@ Rejects invalid thresholds, nonfinite lengths, and lengths at or below the thres
 - [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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -46,4 +46,4 @@ returned unchanged when their winding and tolerance policy match.
 
 - [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -38,4 +38,4 @@ may be returned unchanged under the same tolerance policy.
 
 - [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -34,4 +34,4 @@ Validates a disjoint explicit region and returns immutable normalized data. Prev
 
 - [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -51,4 +51,4 @@ Use `toData()` for a frozen record that restores coordinates, closure, and dimen
 
 - [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -46,4 +46,4 @@ Use `toData()` for a frozen record that restores coordinates, closure, and dimen
 
 - [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -58,4 +58,4 @@ readonly [`Transform3Data`](Transform3Data.md)[]
 
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.