@metamesh/modeling 0.14.0 → 0.16.0

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

@@ -2,22 +2,30 @@
 
 Build immutable reusable placements and calculate with fluent vectors or tuple kernels.
 
-Use immutable vector2/vector3 and transform2/transform3 values for ordinary authoring. Operations return new values; tuples remain convenient inputs. 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. Rotations use degrees and named optional `{ pivot }` points in world coordinates. Calls and andThen composition apply in execution order. Points include translation; directions exclude it and retain scale; normals use inverse-transpose normalization. Shape methods and path helpers accept matching transforms directly. toArray and toMatrix serve interchange using Vector2Tuple/Vector3Tuple and canonical Transform2Matrix/Transform3Matrix data. to3D/to2D convert dimensions explicitly; XY restriction requires a preserved plane. Raw tuple kernels avoid fluent object allocation in hot loops, and matrix constructors provide lower-level interoperability. rotationTransform3 requires an explicit degrees or radians object; composeTransform3(after, before) applies before first. Attachment matches source and target frames; physical clearance is an application decision.
+Use immutable `vector2`/`vector3` and `transform2`/`transform3` values for ordinary authoring. Operations return new values; tuples remain convenient inputs.
+
+- **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.
+
+Attachment matches source and target frames. You choose physical clearance.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [transform2](../transform2.md) | Creates an immutable XY transform, identity by default. Matrices are copied and validated. Pass it directly to Section.transform() and planar data helpers; to3D() explicitly crosses into XYZ. Zero scales and singular matrices throw GeometryError; negative scales reflect. |
-| [transform3](../transform3.md) | Creates an immutable XYZ transform, identity by default. Matrices are copied and validated. Calls apply in written order; rotations use degrees and pivots use current world coordinates. Zero scales, singular matrices, nonfinite inputs and zero rotation axes throw GeometryError. Use frameTransform3(frame) as the input for existing orthonormal frame placement. |
-| [vector2](../vector2.md) | Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates. Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates and overflow throw `NON_FINITE_VALUE` GeometryError. Use transform2().applyDirection(value) for rotations and nonuniform scaling. |
-| [vector3](../vector3.md) | Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates. Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates and overflow throw `NON_FINITE_VALUE` GeometryError. Use transform3().applyDirection(value) for rotations and nonuniform scaling. |
+| [transform2](../transform2.md) | Creates an immutable XY transform, identity by default. |
+| [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. |
-| [attachTransform](../attachTransform.md) | Builds the transform that moves a source anchor onto a target anchor. |
+| [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. |
-| [createAnchor3](../createAnchor3.md) | Constructs a normalized immutable attachment anchor. |
+| [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. |
@@ -38,8 +46,8 @@ Use immutable vector2/vector3 and transform2/transform3 values for ordinary auth
 | [Pivot3Options](../Pivot3Options.md) | A fixed XYZ point in world coordinates; omitted pivots use the coordinate origin. |
 | [Vector2](../Vector2-type.md) | Immutable XY arithmetic; vector operations return new values and measurements return numbers. |
 | [Vector3](../Vector3-type.md) | Immutable XYZ arithmetic; vector operations return new values and measurements return numbers. |
-| [Anchor3](../Anchor3.md) | An attachment pose on a solid or assembly. |
-| [AttachTransformOptions](../AttachTransformOptions.md) | Options controlling how one anchor is attached to another. |
+| [Anchor3](../Anchor3-type.md) | An attachment pose on a solid or assembly. |
+| [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. |
 
@@ -54,10 +62,10 @@ Use immutable vector2/vector3 and transform2/transform3 values for ordinary auth
 | [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. |
-| [Transform2Matrix](../Transform2Matrix.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]`. |
-| [Transform3Matrix](../Transform3Matrix.md) | A row-major affine 4x4 matrix applied to column vectors. |
-| [Vector2Tuple](../Vector2Tuple.md) | A two-dimensional Cartesian vector or point. |
-| [Vector3Tuple](../Vector3Tuple.md) | A three-dimensional Cartesian vector or point. |
+| [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]`. |
+| [Transform3Data](../Transform3Data.md) | A row-major affine 4x4 matrix applied to column vectors. |
+| [Vector2Data](../Vector2Data.md) | A two-dimensional Cartesian vector or point. |
+| [Vector3Data](../Vector3Data.md) | A three-dimensional Cartesian vector or point. |
 
 ## Values
 
@@ -76,8 +84,8 @@ Use immutable vector2/vector3 and transform2/transform3 values for ordinary auth
 | [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`). Rejects invalid thresholds, nonfinite lengths, and lengths at or below the threshold with `INVALID_TOLERANCE`, `NON_FINITE_VALUE`, and `DEGENERATE_GEOMETRY` respectively. |
-| [normalize2](../normalize2.md) | Returns a unit vector; `epsilon` is a finite, non-negative length threshold (default `1e-12`). Rejects invalid thresholds, nonfinite lengths, and lengths at or below the threshold with `INVALID_TOLERANCE`, `NON_FINITE_VALUE`, and `DEGENERATE_GEOMETRY` respectively. |
+| [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. |
@@ -88,5 +96,6 @@ Use immutable vector2/vector3 and transform2/transform3 values for ordinary auth
 ## 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)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,24 +2,26 @@
 
 Parse bounded painted SVG and carry explicit prepared text geometry.
 
-SVG input is bounded and rejects unsupported resources or content contextually. Transforms and physical unit conversion precede sampling; input Y-down coordinates convert to model Y-up. Font preparation belongs to the optional text entrypoint and never enters pure parsing or synchronous modeling. fitTextLayout uniformly fits and centers visible ink before sampling, preserving final millimetre tolerance. It rejects invisible layouts; maxScale: 1 prevents enlargement.
+SVG parsing bounds input and reports unsupported resources or content with context. Transforms and physical unit conversion precede sampling; Y-down input converts to model Y-up coordinates.
+
+Font preparation belongs to the optional text entry point, outside pure parsing and synchronous modeling. `fitTextLayout` uniformly fits and centers visible ink before sampling, preserving final millimetre tolerance. It rejects invisible layouts; `maxScale: 1` prevents enlargement.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [preflightSvgRegion](../preflightSvgRegion.md) | Preflights bounded SVG geometry without browser or Manifold dependencies. |
+| [preflightSvgRegion](../preflightSvgRegion.md) | Parses and validates bounded SVG input, constructing its normalized sampled region and diagnostics. |
 | [sampleTextContours](../sampleTextContours.md) | Samples a prepared text layout without shaping text again or loading a font. |
-| [strokePathRegion](../strokePathRegion.md) | Converts a sampled millimetre path into the filled region covered by a centered stroke. |
-| [fitTextLayout](../fitTextLayout.md) | Uniformly fits visible text ink inside finite XY bounds, centering it on the target. Transforms retained vector paths before sampling, so later textSection/sampleTextContours resolution remains in final millimetres. Logical advances scale without translation; line count is unchanged. The input layout is preserved. |
+| [strokeRegionData](../strokeRegionData.md) | Converts a sampled millimetre path into the filled region covered by a centered stroke. |
+| [fitTextLayout](../fitTextLayout.md) | Uniformly fits visible text ink inside finite XY bounds, centering it on the target. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [StrokePathRegionOptions](../StrokePathRegionOptions.md) | Physical stroke and topology controls shared by pure regions and native Sections. |
+| [StrokeOptions](../StrokeOptions.md) | Physical stroke and topology controls shared by pure regions and native Sections. |
 | [SvgImportOptions](../SvgImportOptions.md) | Sampling controls for deterministic SVG-to-region conversion. |
-| [SvgRegionPreflight](../SvgRegionPreflight.md) | Exact normalized SVG region plus bounded source, geometry, and safe-repair diagnostics. |
+| [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. |
@@ -34,7 +36,11 @@ SVG input is bounded and rejects unsupported resources or content contextually.
 
 | API | Summary |
 | --- | --- |
-| [StrokePathCap](../StrokePathCap.md) | End-cap treatment for an open stroked path. |
-| [StrokePathJoin](../StrokePathJoin.md) | Join treatment where adjacent stroked path segments meet. |
+| [StrokeCap](../StrokeCap.md) | End-cap treatment for an open stroked path. |
+| [StrokeJoin](../StrokeJoin.md) | Join treatment where adjacent stroked path segments meet. |
+
+## Guides
+
+- [SVG preflight work and guarantees](../../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

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

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

@@ -1,16 +1,21 @@
 # closeToAxis
 
-Closes an open, strictly upward [radius, height] side outline to the radius-zero axis. Adds horizontal bottom/top edges at the endpoint heights, retaining axis endpoints once. Returns a counterclockwise filled-boundary contour without a repeated seam vertex. Radii must be nonnegative; the result must enclose nonzero area without touching itself. This is a solid-body closure, not a hollow-wall or mounting-bore construction.
+Closes an open, strictly upward [radius, height] side outline to the radius-zero axis.
 
-**closeToAxis**(`side`: readonly [`Vector2Tuple`](Vector2Tuple.md)[], `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): [`Contour`](Contour.md)
+**closeToAxis**(`side`: readonly [`Vector2Data`](Vector2Data.md)[], `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>): [`Contour`](Contour.md)
 
 
 
+Adds horizontal bottom/top edges at the endpoint heights, retaining axis endpoints once.
+Returns a counterclockwise filled-boundary contour without a repeated seam vertex.
+Radii must be nonnegative; the result must enclose nonzero area without touching itself.
+This is a solid-body closure, not a hollow-wall or mounting-bore construction.
+
 ## Parameters
 
 <a id="side"></a>
 
-**`side`** · readonly [`Vector2Tuple`](Vector2Tuple.md)[] · Required
+**`side`** · readonly [`Vector2Data`](Vector2Data.md)[] · Required
 
 
 
@@ -29,6 +34,10 @@ Closes an open, strictly upward [radius, height] side outline to the radius-zero
 
 - [Contour](Contour.md)
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.md)
+
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

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

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

@@ -2,7 +2,7 @@
 
 Applies axial fit allowance to a validated periodic profile.
 
-**compensateThreadProfileAxially**(`profile`: [`ThreadProfile`](ThreadProfile.md), `axialBacklash`: `number`, `role`: `"female"` \| `"male"`): [`ThreadProfile`](ThreadProfile.md)
+**compensateThreadProfileAxially**(`profile`: [`ThreadProfile`](ThreadProfile-type.md), `axialBacklash`: `number`, `role`: `"female"` \| `"male"`): [`ThreadProfile`](ThreadProfile-type.md)
 
 
 
@@ -14,7 +14,7 @@ change. The returned profile is a new deeply immutable value.
 
 <a id="profile"></a>
 
-**`profile`** · [`ThreadProfile`](ThreadProfile.md) · Required
+**`profile`** · [`ThreadProfile`](ThreadProfile-type.md) · Required
 
 
 
@@ -32,11 +32,15 @@ change. The returned profile is a new deeply immutable value.
 
 ## Returns
 
-[`ThreadProfile`](ThreadProfile.md)
+[`ThreadProfile`](ThreadProfile-type.md)
 
 
 ## Related APIs
 
-- [ThreadProfile](ThreadProfile.md)
+- [ThreadProfile](ThreadProfile-type.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Applies printable axial fit plus the conservative phase allowance required by circular facets.
 
-**compensateThreadProfileForFaceting**(`profile`: [`ThreadProfile`](ThreadProfile.md), `axialBacklash`: `number`, `role`: `"female"` \| `"male"`, `starts`: `number`, `circularSegments`: `number`): [`ThreadProfile`](ThreadProfile.md)
+**compensateThreadProfileForFaceting**(`profile`: [`ThreadProfile`](ThreadProfile-type.md), `axialBacklash`: `number`, `role`: `"female"` \| `"male"`, `starts`: `number`, `circularSegments`: `number`): [`ThreadProfile`](ThreadProfile-type.md)
 
 
 
@@ -16,7 +16,7 @@ it exactly.
 
 <a id="profile"></a>
 
-**`profile`** · [`ThreadProfile`](ThreadProfile.md) · Required
+**`profile`** · [`ThreadProfile`](ThreadProfile-type.md) · Required
 
 
 
@@ -46,11 +46,15 @@ it exactly.
 
 ## Returns
 
-[`ThreadProfile`](ThreadProfile.md)
+[`ThreadProfile`](ThreadProfile-type.md)
 
 
 ## Related APIs
 
-- [ThreadProfile](ThreadProfile.md)
+- [ThreadProfile](ThreadProfile-type.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Composes two affine transforms without mutating either matrix.
 
-**composeTransform3**(`after`: [`Transform3Matrix`](Transform3Matrix.md), `before`: [`Transform3Matrix`](Transform3Matrix.md)): [`Transform3Matrix`](Transform3Matrix.md)
+**composeTransform3**(`after`: [`Transform3Data`](Transform3Data.md), `before`: [`Transform3Data`](Transform3Data.md)): [`Transform3Data`](Transform3Data.md)
 
 
 
@@ -12,7 +12,7 @@ Composes two affine transforms without mutating either matrix.
 
 <a id="after"></a>
 
-**`after`** · [`Transform3Matrix`](Transform3Matrix.md) · Required
+**`after`** · [`Transform3Data`](Transform3Data.md) · Required
 
 Transform applied second.
 
@@ -20,7 +20,7 @@ Transform applied second.
 
 <a id="before"></a>
 
-**`before`** · [`Transform3Matrix`](Transform3Matrix.md) · Required
+**`before`** · [`Transform3Data`](Transform3Data.md) · Required
 
 Transform applied first.
 
@@ -28,17 +28,18 @@ Transform applied first.
 
 ## Returns
 
-[`Transform3Matrix`](Transform3Matrix.md)
+[`Transform3Data`](Transform3Data.md)
 
 A new frozen transform equal to `after * before`.
 
 
 ## Related APIs
 
-- [Transform3Matrix](Transform3Matrix.md)
+- [Transform3Data](Transform3Data.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)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Builds rotation-minimizing frames for a non-duplicated closed path.
 
-`const` **computeClosedParallelTransportFrames**: (`path`: readonly [`Vector3Tuple`](Vector3Tuple.md)[], `initialNormal?`: [`Vector3Tuple`](Vector3Tuple.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>) => readonly [`PathFrame`](PathFrame.md)[]
+`const` **computeClosedParallelTransportFrames**: (`input`: [`Path3Input`](Path3Input.md), `initialNormal?`: [`Vector3Input`](Vector3Input.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>) => readonly [`PathFrame`](PathFrame.md)[]
 
 
 
@@ -10,18 +10,21 @@ Centered cyclic tangents are parallel-transported around the loop. Transporting
 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
 
-<a id="path"></a>
+<a id="input"></a>
 
-**`path`** · readonly [`Vector3Tuple`](Vector3Tuple.md)[] · Required
+**`input`** · [`Path3Input`](Path3Input.md) · Required
 
 
 
 <a id="initialnormal"></a>
 
-**`initialNormal`** · [`Vector3Tuple`](Vector3Tuple.md) · Optional
+**`initialNormal`** · [`Vector3Input`](Vector3Input.md) · Optional
 
 
 
@@ -39,7 +42,12 @@ readonly [`PathFrame`](PathFrame.md)[]
 ## Related APIs
 
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
+- [Path3Input](Path3Input.md)
 - [PathFrame](PathFrame.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector3Input](Vector3Input.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,22 +1,27 @@
 # computeParallelTransportFrames
 
-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.
+Builds rotation-minimizing frames by parallel-transporting the previous normal.
 
-`const` **computeParallelTransportFrames**: (`path`: readonly [`Vector3Tuple`](Vector3Tuple.md)[], `initialNormal?`: [`Vector3Tuple`](Vector3Tuple.md), `normalGuide?`: [`PathNormalGuide`](PathNormalGuide.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>) => readonly [`PathFrame`](PathFrame.md)[]
+`const` **computeParallelTransportFrames**: (`input`: [`Path3Input`](Path3Input.md), `initialNormal?`: [`Vector3Input`](Vector3Input.md), `normalGuide?`: [`PathNormalGuide`](PathNormalGuide.md), `limits?`: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>) => readonly [`PathFrame`](PathFrame.md)[]
 
 
 
+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.
+
 ## Parameters
 
-<a id="path"></a>
+<a id="input"></a>
 
-**`path`** · readonly [`Vector3Tuple`](Vector3Tuple.md)[] · Required
+**`input`** · [`Path3Input`](Path3Input.md) · Required
 
 
 
 <a id="initialnormal"></a>
 
-**`initialNormal`** · [`Vector3Tuple`](Vector3Tuple.md) · Optional
+**`initialNormal`** · [`Vector3Input`](Vector3Input.md) · Optional
 
 
 
@@ -40,8 +45,13 @@ readonly [`PathFrame`](PathFrame.md)[]
 ## Related APIs
 
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
+- [Path3Input](Path3Input.md)
 - [PathFrame](PathFrame.md)
 - [PathNormalGuide](PathNormalGuide.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector3Input](Vector3Input.md)
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,11 +1,15 @@
 # computeTriangleMeshCentroid
 
-Computes the uniform-density volume centroid of an oriented closed solid, including cavity shells. Coordinates are millimetres. Indexed closure and positive aggregate volume are required; callers may use validateSolidMesh first when geometric intersections and shell orientation are untrusted. Fresh mutable input is inspected on every call, and buffers are never changed.
+Computes the uniform-density volume centroid of an oriented closed solid, including cavity shells.
 
-**computeTriangleMeshCentroid**(`mesh`: [`TriangleMesh`](TriangleMesh.md)): [`Vector3Tuple`](Vector3Tuple.md)
+**computeTriangleMeshCentroid**(`mesh`: [`TriangleMesh`](TriangleMesh.md)): [`Vector3Data`](Vector3Data.md)
 
 
 
+Coordinates are millimetres. Indexed closure and positive aggregate volume are required; callers
+may use validateSolidMesh first when geometric intersections and shell orientation are untrusted.
+Fresh mutable input is inspected on every call, and buffers are never changed.
+
 ## Parameters
 
 <a id="mesh"></a>
@@ -18,7 +22,7 @@ Consistently oriented closed mesh with positive enclosed volume.
 
 ## Returns
 
-[`Vector3Tuple`](Vector3Tuple.md)
+[`Vector3Data`](Vector3Data.md)
 
 A fresh immutable XYZ volume centroid.
 
@@ -26,6 +30,10 @@ A fresh immutable XYZ volume centroid.
 ## Related APIs
 
 - [TriangleMesh](TriangleMesh.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector3Data](Vector3Data.md)
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/{createTriangleMeshSignature.md → computeTriangleMeshSignature.md}

@@ -1,8 +1,8 @@
-# createTriangleMeshSignature
+# computeTriangleMeshSignature
 
 Creates an order-independent regression signature for a manufacturing mesh.
 
-**createTriangleMeshSignature**(`mesh`: [`TriangleMesh`](TriangleMesh.md), `options?`: [`TriangleMeshSignatureOptions`](TriangleMeshSignatureOptions.md)): [`TriangleMeshSignature`](TriangleMeshSignature.md)
+**computeTriangleMeshSignature**(`mesh`: [`TriangleMesh`](TriangleMesh.md), `options?`: [`TriangleMeshSignatureOptions`](TriangleMeshSignatureOptions.md)): [`TriangleMeshSignature`](TriangleMeshSignature.md)
 
 
 
@@ -26,7 +26,7 @@ Closed oriented mesh to measure without mutation.
 
 Absolute quantization and complexity limits.
 
-- [`maximumTriangleCount`](TriangleMeshSignatureOptions.md#maximumtrianglecount) · `number` · Optional
+- [`maxTriangles`](TriangleMeshSignatureOptions.md#maxtriangles) · `number` · Optional
 
   Maximum accepted triangle count. Defaults to 200,000.
 
@@ -57,4 +57,8 @@ Compact counts, bounds, volume, topology, tolerances, and canonical fingerprint.
 - [TriangleMeshSignature](TriangleMeshSignature.md)
 - [TriangleMeshSignatureOptions](TriangleMeshSignatureOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -6,7 +6,7 @@ Tests actual XY containment, including touching boundaries; dimensions must matc
 
 
 
-**containsBounds**(`outer`: [`Bounds2`](Bounds2.md), `inner`: [`Bounds2`](Bounds2.md)): `boolean`
+**containsBounds**(`outer`: [`Bounds2Data`](Bounds2Data.md), `inner`: [`Bounds2Data`](Bounds2Data.md)): `boolean`
 
 
 
@@ -16,13 +16,13 @@ Tests actual XY containment, including touching boundaries; dimensions must matc
 
 <a id="outer"></a>
 
-**`outer`** · [`Bounds2`](Bounds2.md) · Required
+**`outer`** · [`Bounds2Data`](Bounds2Data.md) · Required
 
 
 
 <a id="inner"></a>
 
-**`inner`** · [`Bounds2`](Bounds2.md) · Required
+**`inner`** · [`Bounds2Data`](Bounds2Data.md) · Required
 
 
 
@@ -34,7 +34,7 @@ Tests actual XY containment, including touching boundaries; dimensions must matc
 
 
 
-**containsBounds**(`outer`: [`Bounds3`](Bounds3.md), `inner`: [`Bounds3`](Bounds3.md)): `boolean`
+**containsBounds**(`outer`: [`Bounds3Data`](Bounds3Data.md), `inner`: [`Bounds3Data`](Bounds3Data.md)): `boolean`
 
 
 
@@ -44,13 +44,13 @@ Tests actual XYZ containment, including touching boundaries; dimensions must mat
 
 <a id="outer-1"></a>
 
-**`outer`** · [`Bounds3`](Bounds3.md) · Required
+**`outer`** · [`Bounds3Data`](Bounds3Data.md) · Required
 
 
 
 <a id="inner-1"></a>
 
-**`inner`** · [`Bounds3`](Bounds3.md) · Required
+**`inner`** · [`Bounds3Data`](Bounds3Data.md) · Required
 
 
 
@@ -61,12 +61,13 @@ Tests actual XYZ containment, including touching boundaries; dimensions must mat
 
 ## Related APIs
 
-- [Bounds2](Bounds2.md)
-- [Bounds3](Bounds3.md)
+- [Bounds2Data](Bounds2Data.md)
+- [Bounds3Data](Bounds3Data.md)
 
 ## 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)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Returns true when a point lies inside or on the boundary of a loop.
 
-**contourContainsPoint**(`loop`: [`Contour`](Contour.md), `point`: [`Vector2Tuple`](Vector2Tuple.md)): `boolean`
+**contourContainsPoint**(`loop`: [`Contour`](Contour.md), `point`: [`Vector2Data`](Vector2Data.md)): `boolean`
 
 
 
@@ -16,7 +16,7 @@ Returns true when a point lies inside or on the boundary of a loop.
 
 <a id="point"></a>
 
-**`point`** · [`Vector2Tuple`](Vector2Tuple.md) · Required
+**`point`** · [`Vector2Data`](Vector2Data.md) · Required
 
 
 
@@ -28,6 +28,10 @@ Returns true when a point lies inside or on the boundary of a loop.
 ## Related APIs
 
 - [Contour](Contour.md)
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Returns the signed scalar cross product; positive means `b` is counter-clockwise from `a`.
 
-`const` **cross2**: (`a`: [`Vector2Tuple`](Vector2Tuple.md), `b`: [`Vector2Tuple`](Vector2Tuple.md)) => `number`
+`const` **cross2**: (`a`: [`Vector2Data`](Vector2Data.md), `b`: [`Vector2Data`](Vector2Data.md)) => `number`
 
 
 
@@ -10,13 +10,13 @@ Returns the signed scalar cross product; positive means `b` is counter-clockwise
 
 <a id="a"></a>
 
-**`a`** · [`Vector2Tuple`](Vector2Tuple.md) · Required
+**`a`** · [`Vector2Data`](Vector2Data.md) · Required
 
 
 
 <a id="b"></a>
 
-**`b`** · [`Vector2Tuple`](Vector2Tuple.md) · Required
+**`b`** · [`Vector2Data`](Vector2Data.md) · Required
 
 
 
@@ -27,10 +27,11 @@ Returns the signed scalar cross product; positive means `b` is counter-clockwise
 
 ## Related APIs
 
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.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)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.