@metamesh/modeling 0.15.0 → 0.16.0

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

@@ -4,4 +4,11 @@ Whether two cylindrical gears mesh on their outside teeth or as a pinion inside
 
 **CylindricalGearMeshKind** = `"external"` \| `"internal"`
 
-Package: `@metamesh/modeling@0.15.0`.
+
+
+
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -68,4 +68,8 @@ Exact samples along each tooth tip, at least one, within selected circular/profi
 - [GeometryResolution](GeometryResolution.md)
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -79,4 +79,8 @@ Helix angle required on the driven member for conjugate teeth, in degrees.
 
 - [CylindricalGearDimensions](CylindricalGearDimensions.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -31,4 +31,8 @@ Coupled poses sampled over one driver tooth pitch. Defaults to 24.
 
 - [CylindricalGearOutlineOptions](CylindricalGearOutlineOptions.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -38,4 +38,9 @@ Maximum pinion area lying inside ring material, in square millimetres.
 
 Number of evenly spaced coupled poses inspected.
 
-Package: `@metamesh/modeling@0.15.0`.
+
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -44,4 +44,8 @@ External/external or external/internal mesh.
 - [CylindricalGearMeshKind](CylindricalGearMeshKind.md)
 - [CylindricalGearSpec](CylindricalGearSpec.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -79,4 +79,9 @@ Normal pressure angle in degrees; defaults to 20 degrees.
 
 Integer tooth count from 6 through 1,000; external profiles also enforce the no-undercut limit.
 
-Package: `@metamesh/modeling@0.15.0`.
+
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -4,4 +4,4 @@ Default absolute, relative, and angular tolerances for millimetre-scale models.
 
 `const` **DEFAULT\_GEOMETRY\_TOLERANCE**: `Readonly`\<\{ `absolute`: `1e-9`; `angular`: `1e-10`; `relative`: `1e-12`; \}\>
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -14,4 +14,4 @@ Uniform finishing vocabulary shared by applicable solid edges and profile corner
 - [RoundedEdgeTreatment](RoundedEdgeTreatment.md)
 - [SmoothEdgeTreatment](SmoothEdgeTreatment.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 Ellipse dimensions with exactly one XY radii or full-size tuple and explicit sampling.
 
-**EllipseContourOptions** = [`CircularPrimitiveOptions`](CircularPrimitiveOptions.md) & (\{ `radius`: [`Vector2Tuple`](Vector2Tuple.md); `size?`: `never`; \} \| \{ `size`: [`Vector2Tuple`](Vector2Tuple.md); `radius?`: `never`; \})
+**EllipseContourOptions** = [`CircularPrimitiveOptions`](CircularPrimitiveOptions.md) & (\{ `radius`: [`Vector2Data`](Vector2Data.md); `size?`: `never`; \} \| \{ `size`: [`Vector2Data`](Vector2Data.md); `radius?`: `never`; \})
 
 
 
@@ -10,6 +10,10 @@ Ellipse dimensions with exactly one XY radii or full-size tuple and explicit sam
 ## Related APIs
 
 - [CircularPrimitiveOptions](CircularPrimitiveOptions.md)
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Choose a geometry representation](../../guides/concepts.md#geometry-vocabulary)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -31,4 +31,4 @@ Top cap and adjoining side; omitted leaves the end untreated.
 
 - [EdgeTreatment](EdgeTreatment.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -131,4 +131,8 @@ Finite rotation of the top profile about +Z, in degrees; defaults to zero.
 - [ModelingLimits](ModelingLimits.md)
 - [Vector2Input](Vector2Input.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -74,4 +74,8 @@ Finite rotation of the top profile about +Z, in degrees; defaults to zero.
 - [ModelingLimits](ModelingLimits.md)
 - [Vector2Input](Vector2Input.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -24,7 +24,7 @@ Transformed physical measurements, including nonempty visible ink bounds.
 
 
 
-`readonly` **bounds**: [`Bounds2`](Bounds2.md)
+`readonly` **bounds**: [`Bounds2Data`](Bounds2Data.md)
 
 
 
@@ -53,8 +53,12 @@ Nonzero-filled path data in millimetres, positive Y upward; empty for text with
 
 ## Related APIs
 
-- [Bounds2](Bounds2.md)
+- [Bounds2Data](Bounds2Data.md)
 - [VectorTextLayout](VectorTextLayout.md)
 - [VectorTextMetrics](VectorTextMetrics.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [SVG preflight work and guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -8,7 +8,7 @@ A right-handed orthonormal coordinate frame expressed in world coordinates.
 
 
 
-`readonly` **origin**: [`Vector3Tuple`](Vector3Tuple.md)
+`readonly` **origin**: [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -20,7 +20,7 @@ World-space origin of the local frame.
 
 
 
-`readonly` **xAxis**: [`Vector3Tuple`](Vector3Tuple.md)
+`readonly` **xAxis**: [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -32,7 +32,7 @@ Unit vector defining the local +X axis.
 
 
 
-`readonly` **yAxis**: [`Vector3Tuple`](Vector3Tuple.md)
+`readonly` **yAxis**: [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -44,7 +44,7 @@ Unit vector defining the local +Y axis.
 
 
 
-`readonly` **zAxis**: [`Vector3Tuple`](Vector3Tuple.md)
+`readonly` **zAxis**: [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -53,6 +53,10 @@ Unit vector defining the local +Z axis.
 
 ## Related APIs
 
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector3Data](Vector3Data.md)
 
-Package: `@metamesh/modeling@0.15.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/GeometryError.md

@@ -94,4 +94,4 @@ Operation and scalar facts associated with the failure.
 - [GeometryErrorCode](GeometryErrorCode.md)
 - [GeometryErrorContext](GeometryErrorContext.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -4,4 +4,4 @@ Stable categories for invalid inputs, topology, allocation, and runtime failures
 
 **GeometryErrorCode** = `"COMPLEXITY_LIMIT"` \| `"DEGENERATE_GEOMETRY"` \| `"INVALID_ARGUMENT"` \| `"INVALID_MESH"` \| `"INVALID_TOPOLOGY"` \| `"INVALID_TOLERANCE"` \| `"NON_FINITE_VALUE"` \| `"SELF_INTERSECTION"` \| `"SINGULAR_TRANSFORM"` \| `"UNSUPPORTED_RUNTIME"`
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -26,4 +26,4 @@ Optional scalar facts useful for diagnostics without parsing the message.
 
 Stable operation name, such as `normalizeContour` or `extrude`.
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -71,4 +71,4 @@ Lower full-circle segment count; defaults to 16 or a lower selected circular cei
 
 - [CircularResolutionOptions](CircularResolutionOptions.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -59,4 +59,8 @@ Maximum segments around one complete circle.
 
 - [ModelingLimits](ModelingLimits.md)
 
-Package: `@metamesh/modeling@0.15.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/GeometryToleranceOptions.md

@@ -38,4 +38,4 @@ Angular comparison threshold in radians. Must be finite and greater than zero.
 
 Dimensionless scale multiplier. Must be finite and non-negative.
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 XY or XYZ grid with X varying fastest. The first item starts at the local origin. Dimension 2 restricts counts and spacing to XY; any frame must preserve the XY plane.
 
-**GridPatternOptions**\<`Dimension` *extends* `2` \| `3` = `3`\> = `object` & (\{ `count`: [`Vector2Tuple`](Vector2Tuple.md); `spacing`: [`Vector2Tuple`](Vector2Tuple.md); \} \| `Dimension` *extends* `3` ? `object` : `never`)
+**GridPatternOptions**\<`Dimension` *extends* `2` \| `3` = `3`\> = `object` & (\{ `count`: [`Vector2Data`](Vector2Data.md); `spacing`: [`Vector2Data`](Vector2Data.md); \} \| `Dimension` *extends* `3` ? `object` : `never`)
 
 
 
@@ -38,11 +38,11 @@ Optional right-handed local axes and origin for the grid.
 ## Related APIs
 
 - [Frame3](Frame3.md)
-- [Vector2Tuple](Vector2Tuple.md)
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector2Data](Vector2Data.md)
+- [Vector3Data](Vector3Data.md)
 
 ## Guides
 
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -11,4 +11,8 @@ Trusted output ceilings for pure construction; omitted fields use engine default
 
 - [ModelingLimits](ModelingLimits.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,7 +2,7 @@
 
 A closed rectilinear heightfield above a flat base, with uniform or explicit XY samples in millimetres.
 
-**HeightfieldOptions** = `object` & (\{ `size`: [`Vector2Tuple`](Vector2Tuple.md); `segments`: readonly \[`x`: `number`, `y`: `number`\]; `origin?`: [`Vector2Tuple`](Vector2Tuple.md); `coordinates?`: `never`; \} \| \{ `coordinates`: \{ `x`: readonly `number`[]; `y`: readonly `number`[]; \}; `size?`: `never`; `segments?`: `never`; `origin?`: `never`; \})
+**HeightfieldOptions** = `object` & (\{ `size`: [`Vector2Data`](Vector2Data.md); `segments`: readonly \[`x`: `number`, `y`: `number`\]; `origin?`: [`Vector2Data`](Vector2Data.md); `coordinates?`: `never`; \} \| \{ `coordinates`: \{ `x`: readonly `number`[]; `y`: readonly `number`[]; \}; `size?`: `never`; `segments?`: `never`; `origin?`: `never`; \})
 
 
 
@@ -18,7 +18,7 @@ absolute samples per axis, distinct in Float32. This infers the footprint and in
 
 
 
-`readonly` **height**: (`point`: [`Vector2Tuple`](Vector2Tuple.md)) => `number`
+`readonly` **height**: (`point`: [`Vector2Data`](Vector2Data.md)) => `number`
 
 
 
@@ -28,7 +28,7 @@ Absolute top Z at the supplied XY point. Every sample must be above baseZ.
 
 <a id="point"></a>
 
-**`point`** · [`Vector2Tuple`](Vector2Tuple.md) · Required
+**`point`** · [`Vector2Data`](Vector2Data.md) · Required
 
 
 
@@ -62,6 +62,10 @@ All policies retain two triangles per cell; neither estimates error elsewhere in
 
 ## Related APIs
 
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,6 +1,6 @@
 # HeightfieldPreflight
 
-Predictable rectilinear-grid allocation facts; this does not evaluate the height callback.
+Exact grid and mesh buffer allocation counts resolved without evaluating the height callback.
 
 ## Properties
 
@@ -12,7 +12,7 @@ Predictable rectilinear-grid allocation facts; this does not evaluate the height
 
 
 
-Number of top grid points; center-error also evaluates one height per cell.
+Number of top grid points; excludes the extra per-cell height evaluations for center-error.
 
 ***
 
@@ -48,6 +48,11 @@ Number of allocated indexed triangles.
 
 
 
-Total bytes of Float32 positions and Uint32 indices.
+Total bytes of Float32 positions and Uint32 indices, excluding temporary storage.
 
-Package: `@metamesh/modeling@0.15.0`.
+
+## Guides
+
+- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -138,4 +138,8 @@ Optional numerical tolerance overrides.
 - [ThreadHandedness](ThreadHandedness.md)
 - [ThreadProfile](ThreadProfile-type.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -262,4 +262,8 @@ Upper bevel size override. Takes precedence over `bevelSize`.
 - [ThreadHandedness](ThreadHandedness.md)
 - [ThreadProfile](ThreadProfile-type.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,6 +1,6 @@
 # HelicalThreadSolidMeshPreflight
 
-Conservative allocation facts resolved before constructing a direct thread solid mesh.
+Selected sampling counts and conservative allocation estimates, before thread mesh construction.
 
 ## Properties
 
@@ -50,4 +50,9 @@ Conservative surface-row count across profile breaks, ends, and bevel stations.
 
 Conservative triangle count used by the selected output allocation policy.
 
-Package: `@metamesh/modeling@0.15.0`.
+
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,17 +2,18 @@
 
 Identity transform, safe to share because it is frozen.
 
-`const` **IDENTITY\_TRANSFORM3**: [`Transform3Matrix`](Transform3Matrix.md)
+`const` **IDENTITY\_TRANSFORM3**: [`Transform3Data`](Transform3Data.md)
 
 
 
 
 ## 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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -239,4 +239,8 @@ Apply a 45-degree bevel at Z=length.
 - [ThreadHandedness](ThreadHandedness.md)
 - [ThreadProfile](ThreadProfile-type.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -0,0 +1,82 @@
+# KnuckleHingeBaseSpec
+
+Shared knuckle-joint dimensions in millimetres, independent of mounting geometry.
+
+## Properties
+
+### length
+
+
+
+`readonly` **length**: `number`
+
+
+
+Total extent along the +X pin axis, centered at the origin.
+
+***
+
+### knuckleCount
+
+
+
+`readonly` **knuckleCount**: `number`
+
+
+
+Number of equal alternating intervals, starting with half A.
+
+***
+
+### barrelDiameter
+
+
+
+`readonly` **barrelDiameter**: `number`
+
+
+
+Outside vertex-sized barrel diameter.
+
+***
+
+### pinDiameter
+
+
+
+`readonly` **pinDiameter**: `number`
+
+
+
+Vertex-sized shaft diameter, including an externally supplied shaft.
+
+***
+
+### radialClearance
+
+
+
+`readonly` **radialClearance**: `number`
+
+
+
+Nonnegative per-side radial allowance; bores circumscribe this running envelope.
+
+***
+
+### axialGap
+
+
+
+`readonly` **axialGap**: `number`
+
+
+
+Nonnegative total air gap between each neighboring pair of knuckle ends.
+
+
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.