@metamesh/modeling 0.19.0 → 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
@@ -33,4 +33,10 @@ Linear and grid spacing use millimetres; radial angles use degrees. Paths use ph
 
 - [Primitive booleans and repeated placement](../../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.19.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 source-corresponding straight 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.19.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/geometry-values.md#geometry-vocabulary)
+- [Choose a geometry representation](../../../guides/geometry-values.md#material-boundaries-and-matching-profiles)
 
-Package: `@metamesh/modeling@0.19.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.19.0`.
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -1,16 +1,14 @@
-# Transforms and vector math
+# Vectors, transforms, and attachment
 
-Build reusable placements and calculate with immutable fluent vectors or tuple math.
+Calculate with immutable values and place geometry using frames and anchors.
 
-Use immutable `vector2`/`vector3` and `transform2`/`transform3` values for ordinary authoring. Operations return new values; tuples remain convenient inputs.
+Use vector2/vector3 and transform2/transform3 for immutable authoring. Vector operands accept values or coordinate tuples; calculations return values and measurements return numbers. Bounds extrema and placement algorithms also return fluent values.
 
-- **Arithmetic:** `dot()`, `length()`, and `distance()` return numbers. `cross()` returns a signed scalar in 2D and a right-handed vector in 3D. Normalization rejects zero vectors; fluent values reject nonfinite inputs and results.
-- **Order and units:** rotations use degrees and optional `{ pivot }` points in world coordinates. Calls and `andThen()` composition apply in execution order.
-- **Transformed values:** points include translation; directions exclude it and retain scale; normals use inverse-transpose normalization. Shape methods and path helpers accept matching transforms.
-- **Interchange:** `toData()` returns `Vector2Data`/`Vector3Data` tuples or `Transform2Data`/`Transform3Data` matrices. `to3D()`/`to2D()` convert dimensions explicitly; XY restriction requires a preserved plane.
-- **Low-level work:** tuple kernels avoid fluent object allocation in hot loops. Matrix constructors support interoperability. `rotationTransform3` requires an explicit degrees or radians object; `composeTransform3(after, before)` applies `before` first.
+Calls and andThen composition apply in written order. Angles use degrees; optional pivot points use world coordinates. applyPoint includes translation, applyDirection excludes it and retains scale, and applyNormal applies inverse-transpose normalization.
 
-Attachment matches source and target frames. You choose physical clearance.
+frame3 and anchor3 create validated frozen plain descriptors. Pass a Frame3 directly wherever Transform3Input is accepted, or call transform3(frame) for affine methods. attachmentTransform3 returns a reusable Transform3.
+
+Use /geometry/math for tuple arithmetic and matrix kernels.
 
 ## Functions
 
@@ -20,22 +18,11 @@ Attachment matches source and target frames. You choose physical clearance.
 | [transform3](../transform3.md) | Creates an immutable XYZ transform, identity by default. |
 | [vector2](../vector2.md) | Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates. |
 | [vector3](../vector3.md) | Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates. |
-| [applyTransformDirection3](../applyTransformDirection3.md) | Applies only the linear component of an affine transform to a direction. |
-| [applyTransformPoint3](../applyTransformPoint3.md) | Applies an affine transform to a point, including translation. |
 | [attachmentTransform3](../attachmentTransform3.md) | Builds the transform that moves a source anchor onto a target anchor. |
 | [boxAnchor3](../boxAnchor3.md) | Creates an outward face-center anchor using the same local origin convention as box(). |
-| [composeTransform3](../composeTransform3.md) | Composes two affine transforms without mutating either matrix. |
 | [anchor3](../anchor3.md) | Constructs a normalized immutable attachment anchor. |
 | [cylinderAnchor3](../cylinderAnchor3.md) | Creates a cap-center or radial-side anchor using cylinder()'s construction origin. |
-| [eulerTransform3](../eulerTransform3.md) | Creates an immutable right-handed XYZ Euler rotation transform. |
-| [frameTransform3](../frameTransform3.md) | Converts a right-handed orthonormal frame into a local-to-world transform. |
-| [inverseTransform3](../inverseTransform3.md) | Inverts a finite, non-singular affine transform. |
-| [rotationTransform3](../rotationTransform3.md) | Creates a right-handed axis-angle rotation transform. |
-| [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. |
+| [frame3](../frame3.md) | Creates a copied, deeply frozen plain coordinate frame in world space. Axes must be right-handed, unit length, and mutually orthogonal. Only accepted numerical roundoff is normalized; scale, shear, reflection, and materially invalid bases reject. Frames are placement inputs; use transform3(frame) when affine methods are needed. |
 
 ## Interfaces
 
@@ -51,16 +38,18 @@ Attachment matches source and target frames. You choose physical clearance.
 | [AttachOptions](../AttachOptions.md) | Options controlling how one anchor is attached to another. |
 | [BoxAnchorOptions](../BoxAnchorOptions.md) | Box dimensions and construction origin for one named face anchor. |
 | [CylinderAnchorOptions](../CylinderAnchorOptions.md) | Cylinder dimensions and construction origin for one named face anchor. |
+| [Frame3](../Frame3-type.md) | A right-handed orthonormal coordinate frame expressed in world coordinates. |
+| [Frame3Options](../Frame3Options.md) | An origin in millimetres and a right-handed orthonormal basis in world coordinates. |
+| [Anchor3Options](../Anchor3Options.md) | Attachment position in millimetres and orientation guides in local coordinates. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
 | [Transform2Input](../Transform2Input.md) | An immutable XY transform or its canonical row-major matrix for interchange. |
-| [Transform3Input](../Transform3Input.md) | An immutable XYZ transform or its canonical row-major matrix for interchange. |
+| [Transform3Input](../Transform3Input.md) | An immutable XYZ transform, canonical row-major matrix, or right-handed orthonormal frame. |
 | [Vector2Input](../Vector2Input.md) | An XY tuple or immutable fluent vector accepted by vector operations. |
 | [Vector3Input](../Vector3Input.md) | An XYZ tuple or immutable fluent vector accepted by vector operations. |
-| [AxisAngleRotation3](../AxisAngleRotation3.md) | One explicitly unit-labelled right-handed axis-angle rotation. |
 | [BoxAnchorFace](../BoxAnchorFace.md) | Named face on an axis-aligned box. |
 | [CylinderAnchorFace](../CylinderAnchorFace.md) | Named face on a cylinder parallel to +Z. |
 | [Transform2Data](../Transform2Data.md) | A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`. |
@@ -68,35 +57,15 @@ Attachment matches source and target frames. You choose physical clearance.
 | [Vector2Data](../Vector2Data.md) | A two-dimensional Cartesian vector or point. |
 | [Vector3Data](../Vector3Data.md) | A three-dimensional Cartesian vector or point. |
 
-## Values
-
-| API | Summary |
-| --- | --- |
-| [add2](../add2.md) | Adds two finite XY vectors component-wise. |
-| [add3](../add3.md) | Adds two finite XYZ vectors component-wise. |
-| [cross3](../cross3.md) | Returns the right-handed cross product. |
-| [cross2](../cross2.md) | Returns the signed scalar cross product; positive means `b` is counter-clockwise from `a`. |
-| [distance2](../distance2.md) | Returns Euclidean point distance without allocating an intermediate difference vector. |
-| [distance3](../distance3.md) | Returns Euclidean point distance without allocating an intermediate difference vector. |
-| [dot3](../dot3.md) | Returns the scalar dot product. |
-| [dot2](../dot2.md) | Returns the scalar dot product. |
-| [IDENTITY_TRANSFORM3](../IDENTITY_TRANSFORM3.md) | Identity transform, safe to share because it is frozen. |
-| [length3](../length3.md) | Returns Euclidean vector length in the vector's coordinate units. |
-| [length2](../length2.md) | Returns Euclidean vector length in the vector's coordinate units. |
-| [lerp3](../lerp3.md) | Linearly interpolates two vectors; `t` is dimensionless and may extrapolate. |
-| [lerp2](../lerp2.md) | Linearly interpolates two vectors; `t` is dimensionless and may extrapolate. |
-| [normalize3](../normalize3.md) | Returns a unit vector; `epsilon` is a finite, non-negative length threshold (default `1e-12`). |
-| [normalize2](../normalize2.md) | Returns a unit vector; `epsilon` is a finite, non-negative length threshold (default `1e-12`). |
-| [projectOntoPlane3](../projectOntoPlane3.md) | Removes the component parallel to a normalized plane normal. |
-| [rotate2](../rotate2.md) | Rotates a finite vector counter-clockwise in XY by `degrees` about the origin. Throws `NON_FINITE_VALUE` for nonfinite coordinates, angles, or derived coordinates. |
-| [scale3](../scale3.md) | Multiplies a vector by a dimensionless scalar. |
-| [scale2](../scale2.md) | Multiplies a vector by a dimensionless scalar. |
-| [subtract3](../subtract3.md) | Subtracts `b` from `a`. |
-| [subtract2](../subtract2.md) | Subtracts `b` from `a` component-wise. |
-
 ## Guides
 
 - [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)
+- [Fluent values and tuple kernels](../../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
+
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -23,10 +23,7 @@ Font preparation belongs to the optional text entry point, outside pure parsing
 | [SvgImportOptions](../SvgImportOptions.md) | Sampling controls for deterministic SVG-to-region conversion. |
 | [SvgRegionPreflight](../SvgRegionPreflight.md) | Normalized sampled SVG region plus bounded source, geometry, and safe-repair diagnostics. |
 | [SvgRegionPreflightRepairs](../SvgRegionPreflightRepairs.md) | Visible, appearance-preserving cleanup counters from bounded SVG import. |
-| [VectorTextArcBaseline](../VectorTextArcBaseline.md) | A circular baseline centered at the XY origin, with rigid shaped glyph groups. |
 | [VectorTextLayout](../VectorTextLayout.md) | Immutable vector layout with no browser, font parser, or kernel ownership. |
-| [VectorTextLayoutOptions](../VectorTextLayoutOptions.md) | Text bounded to 512 UTF-16 units: horizontal lines or one circular line without wrapping. |
-| [VectorTextOptions](../VectorTextOptions.md) | Shaping controls for a prepared exact font face; all lengths are in millimetres. |
 | [SvgRegionPreflightGeometryMetrics](../SvgRegionPreflightGeometryMetrics.md) | Physical and final-topology facts for a normalized imported SVG region. |
 | [SvgRegionPreflightSourceMetrics](../SvgRegionPreflightSourceMetrics.md) | Bounded source-complexity facts collected while parsing one SVG document. |
 | [VectorTextMetrics](../VectorTextMetrics.md) | Text measurements from the same immutable layout that supplies geometry and SVG outlines. |
@@ -43,4 +40,10 @@ Font preparation belongs to the optional text entry point, outside pure parsing
 
 - [SVG preflight work and guarantees](../../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -32,12 +32,12 @@ circleContour({ diameter: 20, segments: 32 });
 
 ## Guides
 
-- [Choose a geometry representation](../../guides/geometry-values.md#geometry-vocabulary)
+- [Choose a geometry representation](../../guides/geometry-values.md#material-boundaries-and-matching-profiles)
 
-## Supported imports
+## Import
 
 ```ts
 import { circleContour } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -17,12 +17,16 @@ This is a solid-body closure, not a hollow-wall or mounting-bore construction.
 
 **`side`** · readonly [`Vector2Data`](Vector2Data.md)[] · Required
 
+[radius, height] points in millimetres, with increasing heights.
+
 
 
 <a id="limits"></a>
 
 **`limits`** · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
+Point limits, including any added axis endpoints.
+
 
 
 ## Returns
@@ -38,12 +42,12 @@ This is a solid-body closure, not a hollow-wall or mounting-bore construction.
 
 ## Guides
 
-- [Choose a geometry representation](../../guides/geometry-values.md#geometry-vocabulary)
+- [Choose a geometry representation](../../guides/geometry-values.md#material-boundaries-and-matching-profiles)
 
-## Supported imports
+## Import
 
 ```ts
 import { closeToAxis } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -9,9 +9,6 @@ Builds rotation-minimizing frames for a non-duplicated closed path.
 Centered cyclic tangents are parallel-transported around the loop. Transporting the last
 normal back to the first tangent measures seam holonomy; distributing that residual rotation
 uniformly over all path intervals avoids a visible seam or accumulated frame flip.
-The maxPathPoints ceiling (default 100000) bounds path points and frames.
-Requires closed path values; raw tuples are interpreted as closed and must omit their seam point.
-Invalid paths throw GeometryError.
 Nonfinite initial normals reject; finite parallel preferences select a canonical fallback.
 
 ## Parameters
@@ -20,18 +17,24 @@ Nonfinite initial normals reject; finite parallel preferences select a canonical
 
 **`input`** · [`Path3Input`](Path3Input.md) · Required
 
+Closed XYZ path or points in millimetres, with no repeated seam.
+
 
 
 <a id="initialnormal"></a>
 
 **`initialNormal`** · [`Vector3Input`](Vector3Input.md) · Optional
 
+Preferred profile X direction at the seam.
+
 
 
 <a id="limits"></a>
 
 **`limits`** · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
+Limits on input points and output frames.
+
 
 
 ## Returns
@@ -48,12 +51,12 @@ readonly [`PathFrame`](PathFrame.md)[]
 
 ## Guides
 
-- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#query-paths-and-preserve-closure)
+- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#keep-path-closure-and-traversal)
 
-## Supported imports
+## Import
 
 ```ts
 import { computeClosedParallelTransportFrames } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -7,9 +7,8 @@ Builds rotation-minimizing frames by parallel-transporting the previous normal.
 
 
 This avoids the sudden profile flips produced by picking a fresh up-vector per ring.
-Paths exceeding maxPathPoints (default 100000) reject before frame allocation or guide evaluation.
-Requires open path values; raw tuples are interpreted as an open path. Invalid paths throw GeometryError.
-Nonfinite normals and guide results reject. A finite initial guide parallel to the tangent selects a canonical fallback.
+Nonfinite guides and unusable path tangents throw GeometryError. A finite initial guide
+parallel to the tangent selects a canonical fallback.
 
 ## Parameters
 
@@ -17,24 +16,32 @@ Nonfinite normals and guide results reject. A finite initial guide parallel to t
 
 **`input`** · [`Path3Input`](Path3Input.md) · Required
 
+Open XYZ path or points in millimetres; at least two points.
+
 
 
 <a id="initialnormal"></a>
 
 **`initialNormal`** · [`Vector3Input`](Vector3Input.md) · Optional
 
+Preferred starting X direction; the first normalGuide result wins.
+
 
 
 <a id="normalguide"></a>
 
 **`normalGuide`** · [`PathNormalGuide`](PathNormalGuide.md) · Optional
 
+Profile X guide at each point; its sign follows the transported normal.
+
 
 
 <a id="limits"></a>
 
 **`limits`** · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
+Point limits, checked before creating frames or calling guides.
+
 
 
 ## Returns
@@ -52,12 +59,12 @@ readonly [`PathFrame`](PathFrame.md)[]
 
 ## Guides
 
-- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#query-paths-and-preserve-closure)
+- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#keep-path-closure-and-traversal)
 
-## Supported imports
+## Import
 
 ```ts
 import { computeParallelTransportFrames } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -12,12 +12,16 @@ Returns true when a point lies inside or on the boundary of a loop.
 
 **`loop`** · [`Contour`](Contour.md) · Required
 
+Simple XY loop with either winding.
+
 
 
 <a id="point"></a>
 
 **`point`** · [`Vector2Data`](Vector2Data.md) · Required
 
+Query in the loop's coordinate system.
+
 
 
 ## Returns
@@ -32,12 +36,12 @@ Returns true when a point lies inside or on the boundary of a loop.
 
 ## Guides
 
-- [Choose a geometry representation](../../guides/geometry-values.md#geometry-vocabulary)
+- [Choose a geometry representation](../../guides/geometry-values.md#material-boundaries-and-matching-profiles)
 
-## Supported imports
+## Import
 
 ```ts
 import { contourContainsPoint } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -26,7 +26,7 @@ Creates a cap-center or radial-side anchor using cylinder()'s construction origi
 
 - [`angle`](CylinderAnchorOptions.md#angle) · `number` · Optional
 
-  Side angle counter-clockwise from +X, in degrees; defaults to zero.
+  Side angle counterclockwise from +X, in degrees; defaults to zero.
 
 - [`center`](CylinderAnchorOptions.md#center) · `boolean` · Optional
 
@@ -44,7 +44,7 @@ Creates a cap-center or radial-side anchor using cylinder()'s construction origi
 
 ## Remarks
 
-Both centered and noncentered cylinders extend along +Z. Side angle uses degrees;
+Cylinders use the local Z axis. Side angle uses degrees;
 origin applies an explicit translation, and arbitrary component transforms remain explicit.
 
 
@@ -56,12 +56,12 @@ origin applies an explicit translation, and arbitrary component transforms remai
 ## Guides
 
 - [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)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-## Supported imports
+## Import
 
 ```ts
 import { cylinderAnchor3 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -13,12 +13,12 @@ Conservative defaults; trusted callers can supply larger explicit ceilings.
 
 ## Guides
 
-- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#query-paths-and-preserve-closure)
+- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#keep-path-closure-and-traversal)
 
-## Supported imports
+## Import
 
 ```ts
 import { defaultGeometrySamplingLimits } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -1,17 +1,14 @@
 # distributeAlongPath
 
-Places an exact item count at equal arc-length intervals along a sampled path.
+Places an exact item count at equal arc-length intervals along a sampled XYZ path.
 
-`const` **distributeAlongPath**: (`input`: [`Path3Input`](Path3Input.md), `count`: `number`, `closed?`: `boolean`, `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>) => readonly [`PathPlacement`](PathPlacement.md)[]
+**distributeAlongPath**(`input`: [`Path3Input`](Path3Input.md), `count`: `number`, `closed?`: `boolean`, `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): readonly [`PathPlacement`](PathPlacement.md)[]
 
 
 
-Coordinates are unit-agnostic. Closed paths must omit their duplicated seam;
-open paths include both endpoints when `count` is greater than one.
-Coordinates and total length must be finite. Input points and output placements are each
-limited by maxPathPoints (default 100000); exact counts exceeding that ceiling reject before length calculation.
-Closure defaults to the path value's metadata, or false for tuples. An explicit conflicting closure rejects.
-Invalid arguments and degenerate paths throw GeometryError.
+Open paths retain both endpoints when count exceeds one; closed paths omit the seam endpoint.
+Zero-length edges are skipped. Invalid counts, repeated closed seams, nonfinite lengths,
+zero-length paths, and exhausted budgets throw GeometryError.
 
 ## Parameters
 
@@ -19,24 +16,32 @@ Invalid arguments and degenerate paths throw GeometryError.
 
 **`input`** · [`Path3Input`](Path3Input.md) · Required
 
+XYZ path or points in millimetres.
+
 
 
 <a id="count"></a>
 
 **`count`** · `number` · Required
 
+Positive placement count; one selects the path start.
+
 
 
 <a id="closed"></a>
 
 **`closed`** · `boolean` · Optional
 
+Raw-point closure, false by default; must match a path value.
+
 
 
 <a id="limits"></a>
 
 **`limits`** · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
+Limits on input points and output placements.
+
 
 
 ## Returns
@@ -52,12 +57,12 @@ readonly [`PathPlacement`](PathPlacement.md)[]
 
 ## Guides
 
-- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#query-paths-and-preserve-closure)
+- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#keep-path-closure-and-traversal)
 
-## Supported imports
+## Import
 
 ```ts
 import { distributeAlongPath } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -32,12 +32,12 @@ ellipseContour({ size: [30, 20] });
 
 ## Guides
 
-- [Choose a geometry representation](../../guides/geometry-values.md#geometry-vocabulary)
+- [Choose a geometry representation](../../guides/geometry-values.md#material-boundaries-and-matching-profiles)
 
-## Supported imports
+## Import
 
 ```ts
 import { ellipseContour } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.