@metamesh/modeling 0.18.0 → 0.20.0

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

@@ -2,7 +2,7 @@
 
 Converts an anchor into a right-handed frame with direction as local +Z.
 
-**anchorFrame3**(`anchor`: [`Anchor3`](Anchor3-type.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Frame3`](Frame3.md)
+**anchorFrame3**(`anchor`: [`Anchor3`](Anchor3-type.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Frame3`](Frame3-type.md)
 
 
 
@@ -26,7 +26,7 @@ Optional comparison overrides.
 
 ## Returns
 
-[`Frame3`](Frame3.md)
+[`Frame3`](Frame3-type.md)
 
 A normalized right-handed frame at the anchor position.
 
@@ -34,11 +34,17 @@ A normalized right-handed frame at the anchor position.
 ## Related APIs
 
 - [Anchor3](Anchor3-type.md)
-- [Frame3](Frame3.md)
+- [Frame3](Frame3-type.md)
 - [GeometryToleranceOptions](GeometryToleranceOptions.md)
 
 ## 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#keep-path-closure-and-traversal)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import { anchorFrame3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,7 +2,7 @@
 
 Builds the transform that moves a source anchor onto a target anchor.
 
-**attachmentTransform3**(`source`: [`Anchor3`](Anchor3-type.md), `target`: [`Anchor3`](Anchor3-type.md), `options?`: [`AttachOptions`](AttachOptions.md)): [`Transform3Data`](Transform3Data.md)
+**attachmentTransform3**(`source`: [`Anchor3`](Anchor3-type.md), `target`: [`Anchor3`](Anchor3-type.md), `options?`: [`AttachOptions`](AttachOptions.md)): [`Transform3`](Transform3-type.md)
 
 
 
@@ -55,24 +55,30 @@ Alignment, gap, spin, and tolerance policy.
 
 ## Returns
 
-[`Transform3Data`](Transform3Data.md)
+[`Transform3`](Transform3-type.md)
 
-A frozen affine transform for the moving object.
+An immutable affine transform for the moving object.
 
 
 ## Throws
 
-- GeometryError For invalid anchors or non-finite options.
+- GeometryError For invalid anchors or nonfinite options.
 
 ## Related APIs
 
 - [Anchor3](Anchor3-type.md)
 - [AttachOptions](AttachOptions.md)
-- [Transform3Data](Transform3Data.md)
+- [Transform3](Transform3-type.md)
 
 ## 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#fluent-values-plain-data-and-descriptors)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import { attachmentTransform3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,21 +2,23 @@
 
 Constructs immutable finite XY bounds from ordered extrema or nonnegative size in millimetres.
 
-**bounds2**(`input`: [`Bounds2Options`](Bounds2Options.md) \| [`Bounds2`](Bounds2-type.md)): [`Bounds2`](Bounds2-type.md)
+**bounds2**(`input`: [`Bounds2`](Bounds2-type.md) \| [`Bounds2Options`](Bounds2Options.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 10.0.0 or newer in major 10.
+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) \| [`Bounds2`](Bounds2-type.md) · Required
+**`input`** · [`Bounds2`](Bounds2-type.md) \| [`Bounds2Options`](Bounds2Options.md) · Required
+
+Ordered extrema, nonnegative size, or an existing XY bounds value to snapshot.
 
 
 
@@ -32,8 +34,14 @@ runtime 10.0.0 or newer in major 10.
 
 ## 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)
+
+## Import
+
+```ts
+import { bounds2 } from "@metamesh/modeling/geometry";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -9,8 +9,8 @@ Constructs immutable finite XYZ bounds from ordered extrema or nonnegative size
 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 10.0.0 or newer in major 10.
+Compiled Generator packages passing these values to host recipes or memo data require
+the current Modeling runtime.
 
 ## Parameters
 
@@ -18,6 +18,8 @@ runtime 10.0.0 or newer in major 10.
 
 **`input`** · [`Bounds3Options`](Bounds3Options.md) \| [`Bounds3`](Bounds3-type.md) · Required
 
+Ordered extrema, nonnegative size, or an existing XYZ bounds value to snapshot.
+
 
 
 ## Returns
@@ -32,8 +34,14 @@ runtime 10.0.0 or newer in major 10.
 
 ## 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)
+
+## Import
+
+```ts
+import { bounds3 } from "@metamesh/modeling/geometry";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.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.18.0`.
+## Import
+
+```ts
+import { boundsCenter } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.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.18.0`.
+## Import
+
+```ts
+import { boundsSize } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -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#fluent-values-plain-data-and-descriptors)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import { boxAnchor3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -24,8 +24,8 @@ Use `bounds2` and `bounds3` for immutable extents with fluent `size()`, `center(
 
 | API | Summary |
 | --- | --- |
-| [Bounds2](../Bounds2-type.md) | Immutable finite XY bounds in millimetres, with tuple coordinates for data interoperability. |
-| [Bounds3](../Bounds3-type.md) | Immutable finite XYZ bounds in millimetres, with tuple coordinates for data interoperability. |
+| [Bounds2](../Bounds2-type.md) | Immutable finite XY bounds in millimetres, with fluent extrema and measurements. |
+| [Bounds3](../Bounds3-type.md) | Immutable finite XYZ bounds in millimetres, with fluent extrema and measurements. |
 | [Bounds2Data](../Bounds2Data.md) | Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods. |
 | [Bounds3Data](../Bounds3Data.md) | Plain axis-aligned XYZ bounds for interchange; use bounds3 for immutable measurement methods. |
 | [BoundsFitOptions](../BoundsFitOptions.md) | Uniform fitting controls; fitting centers the source inside the target. |
@@ -44,8 +44,14 @@ 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.18.0`.
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -1,22 +1,24 @@
 # Curves and paths
 
-Sample reusable lines, arcs, cubic curves, and path frames with explicit physical sampling settings.
+Query, edit, refine, and interpolate paths with explicit closure and 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.
+Use immutable `path2` and `path3` values for sampled trajectories; closed paths omit the repeated seam.
 
-- **Transform:** `transform()`, `reverse()`, and `resample()` return new paths. Reflections preserve traversal; polygon construction handles filled-shape winding.
-- **Query:** `length()` includes the closing edge. `bounds()` returns fluent bounds or `undefined` for empty paths. `closestPoint()` returns a fluent point, distance, edge index, and fraction within that edge.
-- **Interchange:** `toData()` returns `Path2Data` or `Path3Data` with dimension, closure, and point tuples.
-- **Sample curves:** analytic `Curve` definitions are separate. `sampleCurve2`/`sampleCurve3` retain directed endpoints and tangents; exact intervals are uniform in the curve parameter.
-- **Resample:** `resamplePolyline2`/`resamplePolyline3` return tuple points and tangents at equal arc lengths. Sampling uses physical policies and checked vertex ceilings.
+- **Query:** `length()` includes the closing edge. `bounds()` is undefined for an empty path. `closestPoint()` measures nearest-boundary distance. `atDistance()` and `atFraction()` return a `PathStation` with point, tangent, arc-length offset, original edge index, and local edge fraction. Zero-length edges are skipped; exact vertices use the outgoing edge, except an open final endpoint.
+- **Edit:** `splitAt()` returns two open paths; `trim()` extracts an increasing distance range. Original interior vertices survive, and closed traversal starts at its authored seam.
+- **Refine:** `subdivide({ maxSegmentLength })` retains original corners. Equal-distance `resample()` can bridge corners and rejects a repeated closed seam. Both preserve closure and enforce output ceilings.
+- **Interpolate:** `spline2` and `spline3` sample centripetal Catmull–Rom spans through every waypoint. Physical policies bound cubic control hulls; `segmentsPerSpan` overrides them with exact intervals.
+- **Sample curves:** `sampleCurve2` and `sampleCurve3` retain directed endpoints and tangents; exact intervals are uniform in the analytic curve parameter.
+- **Interchange:** `toData()` returns a frozen record with dimension, closure, and points.
 
-Sweep frames require explicit seam and orientation choices.
+Path distribution and tangent patterns share the outgoing-edge convention. Sweep frames have their own centered-tangent orientation contract.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
 | [anchorFrame3](../anchorFrame3.md) | Converts an anchor into a right-handed frame with direction as local +Z. |
+| [distributeAlongPath](../distributeAlongPath.md) | Places an exact item count at equal arc-length intervals along a sampled XYZ path. |
 | [sampleCurve2](../sampleCurve2.md) | Samples a planar curve with the same guarantees and policy as spatial sampling. |
 | [sampleCurve3](../sampleCurve3.md) | Samples a spatial curve, preserving endpoints and directed unit tangents. |
 | [resolveGeometrySamplingLimits](../resolveGeometrySamplingLimits.md) | Resolves finite positive safe-integer allocation ceilings without ambient state. |
@@ -24,6 +26,8 @@ Sweep frames require explicit seam and orientation choices.
 | [resamplePolyline3](../resamplePolyline3.md) | Resamples a spatial polyline at equal arc lengths with directed outgoing tangents. |
 | [path2](../path2.md) | Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization. |
 | [path3](../path3.md) | Snapshots finite XYZ coordinates as an immutable sampled path with the same closure, seam, allocation and error rules as path2. Analytic curves must be sampled explicitly first. |
+| [spline2](../spline2.md) | Samples an immutable XY centripetal Catmull–Rom path through every waypoint in traversal order. Open endpoints use one-sided secants; closed paths are periodic and omit their repeated seam. Adjacent duplicate waypoints reject. The default physical policy bounds each cubic control hull; segmentsPerSpan instead selects exact uniform parameters per span. Sampling never coarsens to fit maxPathPoints. Invalid topology, nonfinite arithmetic, and exhausted budgets throw GeometryError. |
+| [spline3](../spline3.md) | Samples an immutable XYZ centripetal Catmull–Rom path with the same interpolation, seam, sampling, and ceiling rules as spline2. |
 
 ## Interfaces
 
@@ -34,14 +38,13 @@ Sweep frames require explicit seam and orientation choices.
 | [CubicBezierCurve2](../CubicBezierCurve2.md) | Planar cubic Bézier with explicit endpoint and control coordinates. |
 | [CubicBezierCurve3](../CubicBezierCurve3.md) | Spatial cubic Bézier with explicit endpoint and control coordinates. |
 | [CurveSamplingOptions](../CurveSamplingOptions.md) | Explicit physical sampling and allocation policy for reusable curves. |
-| [Frame3](../Frame3.md) | A right-handed orthonormal coordinate frame expressed in world coordinates. |
 | [GeometrySamplingLimits](../GeometrySamplingLimits.md) | Explicit allocation ceilings for pure sampling and host-owned modeling operations. |
 | [LineCurve2](../LineCurve2.md) | Straight planar curve in millimetres. |
 | [LineCurve3](../LineCurve3.md) | Straight spatial curve in millimetres. |
 | [Path2](../Path2-type.md) | Immutable directed XY polyline. Closure is explicit and does not imply a filled Section. |
 | [Path3](../Path3-type.md) | Immutable directed XYZ polyline; it represents sampled edges, not an analytic curve. |
 | [PathFrame](../PathFrame.md) | Orthonormal right-handed frame sampled along a path. |
-| [PathPlacement](../PathPlacement.md) | Position and unit tangent for one path-distributed item. |
+| [PathPlacement](../PathPlacement.md) | Position and directed unit edge tangent for one path-distributed item. |
 | [SampledCurve2](../SampledCurve2.md) | Immutable planar points and corresponding directed unit tangents. |
 | [SampledCurve3](../SampledCurve3.md) | Immutable spatial points and corresponding directed unit tangents. |
 | [SampleHelixOptions](../SampleHelixOptions.md) | Options for a sampled +Z helix with millimetre dimensions. |
@@ -51,6 +54,9 @@ Sweep frames require explicit seam and orientation choices.
 | [PathResamplingOptions](../PathResamplingOptions.md) | Equal arc-length sampling; the path itself owns whether its closing edge is included. |
 | [Path2Data](../Path2Data.md) | Complete plain XY path representation, including topology and empty-path dimensional identity. |
 | [Path3Data](../Path3Data.md) | Complete plain XYZ path representation, including topology and empty-path dimensional identity. |
+| [PathStation](../PathStation.md) | Directed location at an arc-length offset along a sampled path. |
+| [PathSubdivisionOptions](../PathSubdivisionOptions.md) | Corner-preserving edge refinement; the original vertices remain in traversal order. |
+| [SplineOptions](../SplineOptions.md) | Physical or exact sampling of a centripetal Catmull–Rom spline through authored waypoints. |
 
 ## Type aliases
 
@@ -69,12 +75,17 @@ Sweep frames require explicit seam and orientation choices.
 | [computeClosedParallelTransportFrames](../computeClosedParallelTransportFrames.md) | Builds rotation-minimizing frames for a non-duplicated closed path. |
 | [computeParallelTransportFrames](../computeParallelTransportFrames.md) | Builds rotation-minimizing frames by parallel-transporting the previous normal. |
 | [defaultGeometrySamplingLimits](../defaultGeometrySamplingLimits.md) | Conservative defaults; trusted callers can supply larger explicit ceilings. |
-| [distributeAlongPath](../distributeAlongPath.md) | Places an exact item count at equal arc-length intervals along a sampled path. |
 | [roundClosedPolylinePath](../roundClosedPolylinePath.md) | Replaces each vertex of a non-duplicated closed polyline with a sampled quadratic corner in the same coordinate system as the input. |
 | [sampleHelix](../sampleHelix.md) | Creates `segments + 1` points including exact helix endpoints from finite positive dimensions. |
 
 ## 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#keep-path-closure-and-traversal)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/geometry/categories/immutable-data.md

@@ -0,0 +1,40 @@
+# Immutable geometry data
+
+Capture reusable numeric data and construction placement contracts.
+
+Use immutableBuffer to capture numeric data for memoized preparation. Captured buffers expose indexed reads and iteration; copy() creates owned mutable storage. Bounds, vector, path, and transform values expose frozen toData() snapshots.
+
+Use /geometry/mesh for mesh construction, buffers, analysis, and validation contracts. LoftPlacement retains explicit z-or-transform station placement; ExtrusionSamplingOptions controls longitudinal sampling.
+
+## Functions
+
+| API | Summary |
+| --- | --- |
+| [resolveExtrusionSlices](../resolveExtrusionSlices.md) | Resolves longitudinal intervals for ordinary linear extrusion from physical curve resolution. |
+| [immutableBuffer](../immutableBuffer.md) | Copies numeric data once into private storage. This pure helper needs no active generation. |
+
+## Interfaces
+
+| API | Summary |
+| --- | --- |
+| [ExtrusionSamplingOptions](../ExtrusionSamplingOptions.md) | Shared sampling controls for a twisted or scaled linear extrusion. |
+| [ImmutableBuffer](../ImmutableBuffer-type.md) | Owned immutable numeric data. Iterate without copying; use copy() for mutable storage. |
+
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [LoftPlacement](../LoftPlacement.md) | A horizontal XY station height, or an explicit affine transform, never both. |
+| [NumericArray](../NumericArray.md) | Numeric storage supported by immutable generation buffers. |
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,7 +2,7 @@
 
 Calculate pure linear, radial, grid, and path transforms.
 
-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.
+Pattern helpers use the same counts, spacing, centering, and frames as pattern operations in `@metamesh/modeling`. They return immutable `Transform3` placements. Pass them directly to part transforms or `mesh.transform`, use `applyPoint` for coordinates, and call `toData()` for matrix interchange.
 
 Linear and grid spacing use millimetres; radial angles use degrees. Paths use physical arc-length intervals and omit the repeated seam when closed.
 
@@ -10,9 +10,9 @@ Linear and grid spacing use millimetres; radial angles use degrees. Paths use ph
 
 | API | Summary |
 | --- | --- |
-| [linearPatternTransforms](../linearPatternTransforms.md) | Spatial XYZ matrix placements in millimetres, including the original at the origin. |
+| [linearPatternTransforms](../linearPatternTransforms.md) | Immutable XYZ placements in millimetres, including the original at the origin. |
 | [radialPatternTransforms](../radialPatternTransforms.md) | Rotations about an explicit axis; angles use degrees and the first placement is identity. |
-| [gridPatternTransforms](../gridPatternTransforms.md) | Spatial XYZ matrices for an XY or XYZ grid, in X-fastest order. |
+| [gridPatternTransforms](../gridPatternTransforms.md) | Immutable XYZ placements for an XY or XYZ grid, in X-fastest order. |
 | [pathPatternTransforms](../pathPatternTransforms.md) | Equal physical arc-length placements along a sampled XYZ path. |
 
 ## Interfaces
@@ -31,6 +31,12 @@ 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.18.0`.
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -14,14 +14,9 @@ Dimensional shapes share object options, millimetre units, and explicit placemen
 
 | API | Summary |
 | --- | --- |
-| [BoxOptions](../BoxOptions.md) | Dimensions, placement, and uniform or independently selected finishing for an axis-aligned box. |
-| [ChamferedEdgeTreatment](../ChamferedEdgeTreatment.md) | A planar edge or corner chamfer with equal or independent surface setbacks. |
+| [ChamferedEdgeTreatment](../ChamferedEdgeTreatment.md) | A straight transverse edge or corner bevel with equal or independent surface setbacks. |
 | [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. |
-| [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. |
 | [RadialSizingOptions](../RadialSizingOptions.md) | Nominal radial sizing shared by circular and regular polygon construction. |
 | [SmoothEdgeTreatment](../SmoothEdgeTreatment.md) | A cubic corner transition with zero curvature at its straight tangent joins. |
 | [ProfiledEdgeTreatment](../ProfiledEdgeTreatment.md) | A deliberately sampled, inward-only corner profile with exact polyline geometry. |
@@ -31,12 +26,12 @@ Dimensional shapes share object options, millimetre units, and explicit placemen
 | API | Summary |
 | --- | --- |
 | [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.18.0`.
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -21,13 +21,13 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | [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. |
 | [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. |
+| [regionBounds](../regionBounds.md) | Returns finite axis-aligned bounds for a nonempty region. |
 | [rectangleProfile](../rectangleProfile.md) | Creates an identified rectangle whose edge/corner spans survive zero and saturated round radii. Outer winding is CCW. |
 | [sampleSideProfile](../sampleSideProfile.md) | Samples 1–31 line/cubic segments into a deeply immutable open [radius,height] polyline. |
 | [sampleContour](../sampleContour.md) | Samples 2–32 connected line/cubic segments into a simple, nonzero-area, immutable CCW XY loop. |
 | [signedContourArea](../signedContourArea.md) | Returns the signed area of a non-duplicated loop; positive means CCW. |
 | [transformRegionData](../transformRegionData.md) | Transforms serialized polygon data with reflection-safe winding, without an engine. Use Section.transform(placement) when authoring filled geometry; this utility serves pure data preparation. |
-| [triangulateContour](../triangulateContour.md) | Ear-clips one normalized simple CCW loop into stable local vertex indices. |
+| [triangulateContour](../triangulateContour.md) | Triangulates one simple loop into indices of its normalized CCW vertex order. |
 | [closeToAxis](../closeToAxis.md) | Closes an open, strictly upward [radius, height] side outline to the radius-zero axis. |
 
 ## Interfaces
@@ -60,7 +60,7 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | [CircleContourOptions](../CircleContourOptions.md) | Circular profile dimensions with exactly one radius or diameter and explicit sampling. |
 | [EllipseContourOptions](../EllipseContourOptions.md) | Ellipse dimensions with exactly one XY radii or full-size tuple and explicit sampling. |
 | [Contour](../Contour.md) | A sampled closed two-dimensional boundary whose first point is not repeated at the end. |
-| [CorrespondingProfileStation](../CorrespondingProfileStation.md) | One already matched profile at an explicit height or right-handed spatial frame. |
+| [CorrespondingProfileStation](../CorrespondingProfileStation.md) | One already matched profile at a horizontal height or explicit affine transform. |
 | [ContourSegment](../ContourSegment.md) | Straight or cubic Bézier segment in one closed planar contour. |
 | [SideProfileSegment](../SideProfileSegment.md) | One straight or cubic segment of an open, upward-progressing radius/height outline. |
 | [ProfileSpan2](../ProfileSpan2.md) | An identified line, circular arc, or cubic Bézier between corresponding landmarks. |
@@ -78,6 +78,12 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 
 ## Guides
 
-- [Choose a geometry representation](../../../guides/concepts.md#geometry-vocabulary)
+- [Choose a geometry representation](../../../guides/geometry-values.md#material-boundaries-and-matching-profiles)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -35,6 +35,7 @@ Algorithms report limit failures explicitly. `GeometryError` provides structured
 | [GeometryToleranceOptions](../GeometryToleranceOptions.md) | Optional overrides for MetaMesh's geometry comparison policy. |
 | [ModelingLimits](../ModelingLimits.md) | Aggregate manufacturing output ceilings selected by a trusted host. |
 | [ResolvedGeometryTolerance](../ResolvedGeometryTolerance.md) | Fully resolved tolerances for one operation and model scale. |
+| [ResolvedGeometryResolution](../ResolvedGeometryResolution.md) | Fully populated physical tessellation policy used by adaptive samplers. |
 
 ## Type aliases
 
@@ -49,4 +50,10 @@ Algorithms report limit failures explicitly. `GeometryError` provides structured
 | --- | --- |
 | [DEFAULT_GEOMETRY_TOLERANCE](../DEFAULT_GEOMETRY_TOLERANCE.md) | Default absolute, relative, and angular tolerances for millimetre-scale models. |
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.