@metamesh/modeling 0.19.0 → 0.20.0

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

@@ -12,6 +12,8 @@ Returns the signed area of a non-duplicated loop; positive means CCW.
 
 **`loop`** · [`Contour`](Contour.md) · Required
 
+XY loop in millimetres, with implicit closure; not validated.
+
 
 
 ## Returns
@@ -25,12 +27,12 @@ Returns the signed area of a non-duplicated loop; positive means CCW.
 
 ## 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 { signedContourArea } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -0,0 +1,68 @@
+# spline2
+
+Samples an immutable XY centripetal Catmull–Rom path through every waypoint in traversal order. Open endpoints use one-sided secants; closed paths are periodic and omit their repeated seam. Adjacent duplicate waypoints reject. The default physical policy bounds each cubic control hull; segmentsPerSpan instead selects exact uniform parameters per span. Sampling never coarsens to fit maxPathPoints. Invalid topology, nonfinite arithmetic, and exhausted budgets throw GeometryError.
+
+**spline2**(`input`: [`Path2Input`](Path2Input.md), `options?`: [`SplineOptions`](SplineOptions.md)): [`Path2`](Path2-type.md)
+
+
+
+## Example
+
+```ts
+const route = spline2([[0, 0], [10, 8], [25, 0]], { resolution: { maxChordError: 0.02 } });
+```
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Path2Input`](Path2Input.md) · Required
+
+XY waypoints in millimetres; path values retain closure.
+
+
+
+<a id="options"></a>
+
+**`options`** · [`SplineOptions`](SplineOptions.md) · Optional
+
+- [`closed`](SplineOptions.md#closed) · `boolean` · Optional
+
+  Closure defaults to path metadata or false for tuples. Closed inputs omit the repeated seam.
+
+- [`segmentsPerSpan`](SplineOptions.md#segmentsperspan) · `number` · Optional
+
+  Exact parameter intervals per waypoint span; overrides physical sampling. Must be a positive safe integer.
+
+- [`resolution`](SplineOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Millimetre chord-error and maximum-segment-length policy, applied to every cubic control hull.
+
+- [`limits`](SplineOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Input and aggregate output ceilings; maxPathPoints defaults to 100000.
+
+
+
+## Returns
+
+[`Path2`](Path2-type.md)
+
+
+## Related APIs
+
+- [Path2](Path2-type.md)
+- [Path2Input](Path2Input.md)
+- [SplineOptions](SplineOptions.md)
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#keep-path-closure-and-traversal)
+
+## Import
+
+```ts
+import { spline2 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -0,0 +1,62 @@
+# spline3
+
+Samples an immutable XYZ centripetal Catmull–Rom path with the same interpolation, seam, sampling, and ceiling rules as spline2.
+
+**spline3**(`input`: [`Path3Input`](Path3Input.md), `options?`: [`SplineOptions`](SplineOptions.md)): [`Path3`](Path3-type.md)
+
+
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`Path3Input`](Path3Input.md) · Required
+
+XYZ waypoints in millimetres; path values retain closure.
+
+
+
+<a id="options"></a>
+
+**`options`** · [`SplineOptions`](SplineOptions.md) · Optional
+
+- [`closed`](SplineOptions.md#closed) · `boolean` · Optional
+
+  Closure defaults to path metadata or false for tuples. Closed inputs omit the repeated seam.
+
+- [`segmentsPerSpan`](SplineOptions.md#segmentsperspan) · `number` · Optional
+
+  Exact parameter intervals per waypoint span; overrides physical sampling. Must be a positive safe integer.
+
+- [`resolution`](SplineOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Millimetre chord-error and maximum-segment-length policy, applied to every cubic control hull.
+
+- [`limits`](SplineOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+
+  Input and aggregate output ceilings; maxPathPoints defaults to 100000.
+
+
+
+## Returns
+
+[`Path3`](Path3-type.md)
+
+
+## Related APIs
+
+- [Path3](Path3-type.md)
+- [Path3Input](Path3Input.md)
+- [SplineOptions](SplineOptions.md)
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#keep-path-closure-and-traversal)
+
+## Import
+
+```ts
+import { spline3 } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -52,12 +52,12 @@ readonly [`Vector2Data`](Vector2Data.md)[]
 
 ## 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 { starContour } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -8,8 +8,9 @@ Converts a sampled millimetre path into the filled region covered by a centered
 
 Closed paths omit a duplicated seam point. Zero-length sampled segments are ignored, while the
 effective path must still contain visible length. Round caps and joins use deterministic physical
-resolution. Bevels fill the outer corner triangle; miters extend the outer edges to their
-intersection, falling back to bevels above SVG's default miter limit of 4.
+resolution. Caps are tangent-aligned semicircles with `ceil(circularSegments / 2)` intervals,
+following [resolveArcSegments](resolveArcSegments.md). Bevels fill the outer corner triangle; miters extend the
+outer edges to their intersection, falling back to bevels above SVG's default miter limit of 4.
 
 ## Parameters
 
@@ -17,6 +18,8 @@ intersection, falling back to bevels above SVG's default miter limit of 4.
 
 **`path`** · [`Path2Input`](Path2Input.md) · Required
 
+Sampled XY path in millimetres; path values supply closure.
+
 
 
 <a id="options"></a>
@@ -45,7 +48,7 @@ intersection, falling back to bevels above SVG's default miter limit of 4.
 
 - [`resolution`](StrokeOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
 
-  Physical tessellation policy for round caps and joins.
+  Physical tessellation for round features; caps use tangent-aligned 180-degree arcs.
 
 
 
@@ -64,10 +67,10 @@ intersection, falling back to bevels above SVG's default miter limit of 4.
 
 - [SVG preflight work and guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import { strokeRegionData } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -25,6 +25,8 @@ Use `toData()` for frozen matrix interchange.
 
 **`input`** · [`Transform2Input`](Transform2Input.md) · Optional
 
+XY affine value or row-major 3x3 matrix; copied. Defaults to identity.
+
 
 
 ## Returns
@@ -40,16 +42,12 @@ Use `toData()` for frozen matrix interchange.
 ## 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)
-
-## Supported imports
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-```ts
-import { transform2 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import { transform2 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -13,13 +13,28 @@ const placement = transform3().rotate([0, 0, 90]).translate([10, 0, 0]);
 placement.applyPoint([1, 0, 0]).toData(); // approximately [10, 1, 0]
 ```
 
-Values and data are copied and validated.
+## Example: Convert a coordinate frame to an affine value
+
+```ts
+const local = frame3({
+  origin: [10, 0, 0],
+  xAxis: [0, 1, 0],
+  yAxis: [-1, 0, 0],
+  zAxis: [0, 0, 1],
+});
+const placement = transform3(local);
+placement.applyPoint([2, 0, 0]).toData(); // [10, 2, 0]
+```
+
+Values, matrices, and frames 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.
+A frame supplies its origin in millimetres and right-handed orthonormal axes as local-to-world
+columns. Invalid axes reject; unit-length roundoff is normalized within geometry tolerance.
 
 Use `toData()` for frozen matrix interchange.
-[composeTransform3](composeTransform3.md) takes matrices in after, before order.
+[multiplyTransform3](../math/multiplyTransform3.md) multiplies left and right matrices;
+the right factor acts first on column vectors.
 
 ## Parameters
 
@@ -27,6 +42,8 @@ Use `toData()` for frozen matrix interchange.
 
 **`input`** · [`Transform3Input`](Transform3Input.md) · Optional
 
+XYZ affine value, row-major 4x4 matrix, or frame; copied. Defaults to identity.
+
 
 
 ## Returns
@@ -42,16 +59,12 @@ Use `toData()` for frozen matrix interchange.
 ## 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)
-
-## Supported imports
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-```ts
-import { transform3 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import { transform3 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -12,12 +12,16 @@ Transforms serialized polygon data with reflection-safe winding, without an engi
 
 **`region`** · [`RegionData`](RegionData.md) · Required
 
+Millimetre polygons whose boundaries are normalized before placement.
+
 
 
 <a id="transform"></a>
 
 **`transform`** · [`Transform2Input`](Transform2Input.md) · Required
 
+Planar affine placement; reflections preserve winding.
+
 
 
 <a id="tolerance"></a>
@@ -39,12 +43,12 @@ Transforms serialized polygon data with reflection-safe winding, without an engi
 
 ## 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 { transformRegionData } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -1,6 +1,6 @@
 # triangulateContour
 
-Ear-clips one normalized simple CCW loop into stable local vertex indices.
+Triangulates one simple loop into indices of its normalized CCW vertex order.
 
 **triangulateContour**(`loop`: [`Contour`](Contour.md)): `Uint32Array`
 
@@ -12,6 +12,8 @@ Ear-clips one normalized simple CCW loop into stable local vertex indices.
 
 **`loop`** · [`Contour`](Contour.md) · Required
 
+Boundary to normalize; indices address its cleaned CCW order.
+
 
 
 ## Returns
@@ -25,12 +27,12 @@ Ear-clips one normalized simple CCW loop into stable local vertex indices.
 
 ## 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 { triangulateContour } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -11,7 +11,7 @@ and overflow throw `NON_FINITE_VALUE` GeometryError.
 Use transform2().applyDirection(value) for rotations and nonuniform scaling.
 
 Use `toData()` for frozen tuple interchange, or
-[normalize2](normalize2.md) for tuple-based normalization in numerical loops.
+[normalize2](../math/normalize2.md) for tuple-based normalization in numerical loops.
 
 ## Parameters
 
@@ -19,6 +19,8 @@ Use `toData()` for frozen tuple interchange, or
 
 **`input`** · [`Vector2Input`](Vector2Input.md) · Required
 
+Finite XY tuple or vector; coordinates are copied without changing their units.
+
 
 
 ## Returns
@@ -34,16 +36,12 @@ Use `toData()` for frozen tuple interchange, or
 ## 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)
-
-## Supported imports
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-```ts
-import { vector2 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import { vector2 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -9,6 +9,8 @@ Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the
 ## Example
 
 ```ts
+import { vector3 } from "@metamesh/modeling/geometry";
+
 const direction = vector3([1, 2, 3]).add([4, 0, 0]).normalize().scale(10);
 const alignment = direction.dot([0, 0, 1]);
 ```
@@ -18,7 +20,7 @@ and overflow throw `NON_FINITE_VALUE` GeometryError.
 Use transform3().applyDirection(value) for rotations and nonuniform scaling.
 
 Use `toData()` for frozen tuple interchange, or
-[normalize3](normalize3.md) for tuple-based normalization in numerical loops.
+[normalize3](../math/normalize3.md) for tuple-based normalization in numerical loops.
 
 ## Parameters
 
@@ -26,6 +28,8 @@ Use `toData()` for frozen tuple interchange, or
 
 **`input`** · [`Vector3Input`](Vector3Input.md) · Required
 
+Finite XYZ tuple or vector; coordinates are copied without changing their units.
+
 
 
 ## Returns
@@ -41,16 +45,12 @@ Use `toData()` for frozen tuple interchange, or
 ## 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
-
-```ts
-import { vector3 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import { vector3 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/geometry.md

@@ -1,32 +1,27 @@
 # Geometry foundations
 
-Pure curves, profiles, regions, meshes, transforms, and mechanical construction without initializing a native engine.
+Pure geometry values, curves, profiles, regions, and placement algorithms without initializing a native engine.
 
-Use `@metamesh/modeling/geometry` for runtime-neutral calculations with curves, profiles, transforms, regions, meshes, SVG, and mechanical geometry. These helpers work without an SDK or native engine.
+Use @metamesh/modeling/geometry for immutable vectors, transforms, bounds, paths, plain geometry descriptors, contours, identified profiles, regions, placement, sampling, and diagnostics. Pure calculations require no engine. Values accept matching data and expose toData() for frozen interchange. Descriptors remain plain readonly records.
 
-```ts
-import { sampleCurve2, rectangleContour } from "@metamesh/modeling/geometry";
-const arc = sampleCurve2({ kind: "arc", center: [0, 0], radius: 10, sweepAngle: 90 });
-const contour = rectangleContour({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
-```
-
-Lengths use millimetres. Winding and closing conventions are explicit. The [mesh module](mesh.md) constructs and processes ordinary triangle buffers; `mesh.join` concatenates without Boolean union. Mesh inspection reads mutable external arrays afresh. Predictable allocations are checked against limits before sampling.
-
-Use `bounds2`/`bounds3` for immutable measurement queries and `Bounds2Data`/`Bounds3Data` for min/max records. Standalone bounds helpers fit and arrange parts from either form. Fit text vector paths before sampling to retain physical tolerance.
-
-Choose [fluent values or standalone algorithms](../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms), compare [geometry representations](../guides/geometry-values.md#geometry-vocabulary), and check [preflight guarantees](../guides/resolution-and-inspection.md#check-preflight-guarantees).
+Numerical tuple and matrix kernels live in /geometry/math; mechanical dimensions and preflights live in /geometry/mechanical; triangle-buffer operations live in /geometry/mesh. Every public value and type has one import path.
 
 ## Categories
 
-- [Mechanical foundations](geometry/categories/mechanical.md) — Resolve gears, knuckle joints, fastener standards, thread profiles, fit, and predictable allocations.
-- [Triangle meshes and surfaces](geometry/categories/meshes.md) — Data, options, and reports for triangle mesh construction and processing.
+- [Immutable geometry data](geometry/categories/immutable-data.md) — Capture reusable numeric data and construction placement contracts.
 - [SVG and vector layouts](geometry/categories/vector-import.md) — Parse painted SVG within limits and work with explicitly prepared text geometry.
 - [Profiles and regions](geometry/categories/profiles-regions.md) — Define winding, holes, stable profile landmarks, and reusable planar boundaries.
-- [Curves and paths](geometry/categories/curves-paths.md) — Sample reusable lines, arcs, cubic curves, and path frames with explicit physical sampling settings.
+- [Curves and paths](geometry/categories/curves-paths.md) — Query, edit, refine, and interpolate paths with explicit closure and physical sampling settings.
 - [Bounds and layout](geometry/categories/bounds-layout.md) — Measure finite bounds, test positioned containment, and fit or arrange geometry.
 - [Pattern placement](geometry/categories/pattern-placement.md) — Calculate pure linear, radial, grid, and path transforms.
-- [Transforms and vector math](geometry/categories/transforms-math.md) — Build reusable placements and calculate with immutable fluent vectors or tuple math.
+- [Vectors, transforms, and attachment](geometry/categories/transforms-math.md) — Calculate with immutable values and place geometry using frames and anchors.
 - [Resolution and errors](geometry/categories/resolution-errors.md) — Set physical sampling and numerical tolerances, and understand errors in context.
 - [Primitive options](geometry/categories/primitive-options.md) — Configure dimensional primitives and edge treatments with shared options.
 
-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 → math}/AxisAngleRotation3.md

@@ -61,13 +61,12 @@ Excluded when the angle is expressed in radians.
 
 ## 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 type { AxisAngleRotation3 } from "@metamesh/modeling/geometry";
+import type { AxisAngleRotation3 } from "@metamesh/modeling/geometry/math";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/math/IDENTITY_TRANSFORM3.md

@@ -0,0 +1,20 @@
+# IDENTITY_TRANSFORM3
+
+Identity transform, safe to share because it is frozen.
+
+`const` **IDENTITY\_TRANSFORM3**: [`Transform3Data`](../geometry/Transform3Data.md)
+
+
+
+
+## Guides
+
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
+
+## Import
+
+```ts
+import { IDENTITY_TRANSFORM3 } from "@metamesh/modeling/geometry/math";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/math/add2.md

@@ -0,0 +1,38 @@
+# add2
+
+Adds two finite XY vectors component-wise.
+
+`const` **add2**: (`a`: [`Vector2Data`](../geometry/Vector2Data.md), `b`: [`Vector2Data`](../geometry/Vector2Data.md)) => [`Vector2Data`](../geometry/Vector2Data.md)
+
+
+
+## Parameters
+
+<a id="a"></a>
+
+**`a`** · [`Vector2Data`](../geometry/Vector2Data.md) · Required
+
+
+
+<a id="b"></a>
+
+**`b`** · [`Vector2Data`](../geometry/Vector2Data.md) · Required
+
+
+
+## Returns
+
+[`Vector2Data`](../geometry/Vector2Data.md)
+
+
+## Guides
+
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
+
+## Import
+
+```ts
+import { add2 } from "@metamesh/modeling/geometry/math";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/math/add3.md

@@ -0,0 +1,46 @@
+# add3
+
+Adds two finite XYZ vectors component-wise.
+
+`const` **add3**: (`a`: [`Vector3Data`](../geometry/Vector3Data.md), `b`: [`Vector3Data`](../geometry/Vector3Data.md)) => [`Vector3Data`](../geometry/Vector3Data.md)
+
+
+
+## Example
+
+```ts
+import { add3 } from "@metamesh/modeling/geometry/math";
+
+add3([1, 2, 3], [4, 5, 6]); // [5, 7, 9]
+```
+
+## Parameters
+
+<a id="a"></a>
+
+**`a`** · [`Vector3Data`](../geometry/Vector3Data.md) · Required
+
+
+
+<a id="b"></a>
+
+**`b`** · [`Vector3Data`](../geometry/Vector3Data.md) · Required
+
+
+
+## Returns
+
+[`Vector3Data`](../geometry/Vector3Data.md)
+
+
+## Guides
+
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
+
+## Import
+
+```ts
+import { add3 } from "@metamesh/modeling/geometry/math";
+```
+
+Package: `@metamesh/modeling@0.20.0`.