@metamesh/modeling 0.18.0 → 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
+## Guides
 
-| 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. |
+- [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)
 
-## Guides
+## Import
 
-- [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)
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
 
-Package: `@metamesh/modeling@0.18.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. |
@@ -41,6 +38,12 @@ Font preparation belongs to the optional text entry point, outside pure parsing
 
 ## Guides
 
-- [SVG preflight work and guarantees](../../../guides/concepts.md#check-preflight-guarantees)
+- [SVG preflight work and guarantees](../../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import * as geometry from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -32,6 +32,12 @@ circleContour({ diameter: 20, segments: 32 });
 
 ## 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 { circleContour } from "@metamesh/modeling/geometry";
+```
+
+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,6 +42,12 @@ This is a solid-body closure, not a hollow-wall or mounting-bore construction.
 
 ## Guides
 
-- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+- [Choose a geometry representation](../../guides/geometry-values.md#material-boundaries-and-matching-profiles)
+
+## Import
+
+```ts
+import { closeToAxis } from "@metamesh/modeling/geometry";
+```
 
-Package: `@metamesh/modeling@0.18.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,6 +51,12 @@ readonly [`PathFrame`](PathFrame.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)
+
+## Import
+
+```ts
+import { computeClosedParallelTransportFrames } from "@metamesh/modeling/geometry";
+```
 
-Package: `@metamesh/modeling@0.18.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,6 +59,12 @@ readonly [`PathFrame`](PathFrame.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)
+
+## Import
+
+```ts
+import { computeParallelTransportFrames } from "@metamesh/modeling/geometry";
+```
 
-Package: `@metamesh/modeling@0.18.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,6 +36,12 @@ Returns true when a point lies inside or on the boundary of a loop.
 
 ## Guides
 
-- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+- [Choose a geometry representation](../../guides/geometry-values.md#material-boundaries-and-matching-profiles)
+
+## Import
+
+```ts
+import { contourContainsPoint } from "@metamesh/modeling/geometry";
+```
 
-Package: `@metamesh/modeling@0.18.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.
 
 
@@ -55,7 +55,13 @@ origin applies an explicit translation, and arbitrary component transforms remai
 
 ## 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 { cylinderAnchor3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -13,6 +13,12 @@ Conservative defaults; trusted callers can supply larger explicit ceilings.
 
 ## 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 { defaultGeometrySamplingLimits } from "@metamesh/modeling/geometry";
+```
+
+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,6 +57,12 @@ readonly [`PathPlacement`](PathPlacement.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)
+
+## Import
+
+```ts
+import { distributeAlongPath } from "@metamesh/modeling/geometry";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -32,6 +32,12 @@ ellipseContour({ size: [30, 20] });
 
 ## 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 { ellipseContour } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -18,12 +18,16 @@ Fits XY bounds uniformly and centers them in the target; zero source axes do not
 
 **`source`** · [`Bounds2Data`](Bounds2Data.md) · Required
 
+Source bounds in millimetres, with at least one positive extent.
+
 
 
 <a id="target"></a>
 
 **`target`** · [`Bounds2Data`](Bounds2Data.md) · Required
 
+Target bounds in the same dimension and coordinate system.
+
 
 
 <a id="options"></a>
@@ -56,12 +60,16 @@ Fits XYZ bounds uniformly and centers them in the target; zero source axes do no
 
 **`source`** · [`Bounds3Data`](Bounds3Data.md) · Required
 
+Source bounds in millimetres, with at least one positive extent.
+
 
 
 <a id="target-1"></a>
 
 **`target`** · [`Bounds3Data`](Bounds3Data.md) · Required
 
+Target bounds in the same dimension and coordinate system.
+
 
 
 <a id="options-1"></a>
@@ -89,8 +97,14 @@ Fits XYZ bounds uniformly and centers them in the target; zero source axes do no
 
 ## 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 { fitBounds } from "@metamesh/modeling/geometry";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,7 +2,7 @@
 
 Uniformly fits visible text ink inside finite XY bounds, centering it on the target.
 
-**fitTextLayout**(`layout`: [`VectorTextLayout`](VectorTextLayout.md), `target`: [`Bounds2Data`](Bounds2Data.md), `options?`: [`BoundsFitOptions`](BoundsFitOptions.md)): [`FittedTextLayout`](FittedTextLayout.md)
+**fitTextLayout**(`layout`: [`VectorTextLayout`](VectorTextLayout.md), `target`: [`Bounds2Input`](Bounds2Input.md), `options?`: [`BoundsFitOptions`](BoundsFitOptions.md)): [`FittedTextLayout`](FittedTextLayout.md)
 
 
 
@@ -22,7 +22,7 @@ Prepared nonempty vector text with positive visible width and height.
 
 <a id="target"></a>
 
-**`target`** · [`Bounds2Data`](Bounds2Data.md) · Required
+**`target`** · [`Bounds2Input`](Bounds2Input.md) · Required
 
 Positioned available bounds in millimetres; both extents must be positive.
 
@@ -53,13 +53,19 @@ A deeply immutable layout with transformed paths, ink bounds, and physical metri
 
 ## Related APIs
 
-- [Bounds2Data](Bounds2Data.md)
+- [Bounds2Input](Bounds2Input.md)
 - [BoundsFitOptions](BoundsFitOptions.md)
 - [FittedTextLayout](FittedTextLayout.md)
 - [VectorTextLayout](VectorTextLayout.md)
 
 ## Guides
 
-- [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
+- [SVG preflight work and guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import { fitTextLayout } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -0,0 +1,66 @@
+# frame3
+
+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.
+
+**frame3**(`options`: [`Frame3Options`](Frame3Options.md)): [`Frame3`](Frame3-type.md)
+
+
+
+## Example: Place an XY profile using an analytic radial frame
+
+```ts
+const radial = frame3({
+  origin: [20, 0, 5],
+  xAxis: [0, 1, 0],
+  yAxis: [0, 0, 1],
+  zAxis: [1, 0, 0],
+});
+const placed = transform3(radial).applyPoint([2, 3, 0]).toData(); // [20, 2, 8]
+```
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`Frame3Options`](Frame3Options.md) · Required
+
+- [`origin`](Frame3Options.md#origin) · [`Vector3Input`](Vector3Input.md) · Required
+
+  World-space origin of the local coordinate system, in millimetres.
+
+- [`xAxis`](Frame3Options.md#xaxis) · [`Vector3Input`](Vector3Input.md) · Required
+
+  Unit vector defining local +X.
+
+- [`yAxis`](Frame3Options.md#yaxis) · [`Vector3Input`](Vector3Input.md) · Required
+
+  Unit vector defining local +Y.
+
+- [`zAxis`](Frame3Options.md#zaxis) · [`Vector3Input`](Vector3Input.md) · Required
+
+  Unit vector defining local +Z.
+
+
+
+## Returns
+
+[`Frame3`](Frame3-type.md)
+
+
+## Related APIs
+
+- [Frame3](Frame3-type.md)
+- [Frame3Options](Frame3Options.md)
+
+## 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#fluent-values-plain-data-and-descriptors)
+
+## Import
+
+```ts
+import { frame3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.