@metamesh/modeling 0.14.0 → 0.16.0

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

@@ -2,7 +2,7 @@
 
 Creates an outward face-center anchor using the same local origin convention as box().
 
-**boxAnchor3**(`options`: [`BoxAnchorOptions`](BoxAnchorOptions.md)): [`Anchor3`](Anchor3.md)
+**boxAnchor3**(`options`: [`BoxAnchorOptions`](BoxAnchorOptions.md)): [`Anchor3`](Anchor3-type.md)
 
 
 
@@ -12,7 +12,7 @@ Creates an outward face-center anchor using the same local origin convention as
 
 **`options`** · [`BoxAnchorOptions`](BoxAnchorOptions.md) · Required
 
-- [`size`](BoxAnchorOptions.md#size) · `number` \| [`Vector3Tuple`](Vector3Tuple.md) · Required
+- [`size`](BoxAnchorOptions.md#size) · `number` \| [`Vector3Data`](Vector3Data.md) · Required
 
   XYZ dimensions, or one uniform dimension, in millimetres.
 
@@ -24,7 +24,7 @@ Creates an outward face-center anchor using the same local origin convention as
 
   Centers the box around its construction origin; defaults to true, matching box().
 
-- [`origin`](BoxAnchorOptions.md#origin) · [`Vector3Tuple`](Vector3Tuple.md) · Optional
+- [`origin`](BoxAnchorOptions.md#origin) · [`Vector3Data`](Vector3Data.md) · Optional
 
   Construction origin; centered-box center or noncentered minimum corner. Defaults to zero.
 
@@ -32,7 +32,7 @@ Creates an outward face-center anchor using the same local origin convention as
 
 ## Returns
 
-[`Anchor3`](Anchor3.md)
+[`Anchor3`](Anchor3-type.md)
 
 ## Remarks
 
@@ -42,11 +42,12 @@ resulting anchor frame explicitly; no anchor is inherited from a Boolean result.
 
 ## Related APIs
 
-- [Anchor3](Anchor3.md)
+- [Anchor3](Anchor3-type.md)
 - [BoxAnchorOptions](BoxAnchorOptions.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/categories/bounds-layout.md

@@ -1,35 +1,52 @@
-# Bounds & Layout
+# Bounds and layout
 
 Measure finite bounds, test positioned containment, and fit or arrange geometry.
 
-Bounds2 and Bounds3 are shared min/max data for text, mesh measurements, and placement. boundsFromSize creates centered bounds unless center is false. containsBounds tests actual positioned containment, including boundary contact. fitBounds uniformly scales and centers into a target, returning scale, position and resulting bounds; maxScale limits enlargement. layoutRow returns translations for a +X row with minimum Y/Z grounded at zero; supply bounds after intended rotations and apply positions through part options.
+Use `bounds2` and `bounds3` for immutable extents with fluent `size()`, `center()`, and `containsBounds()` queries. Zero extents are valid. Containment includes boundary contact in the same coordinate frame; it does not establish manufacturing fit.
+
+- **Interchange:** measurements, snapshots, and `boundsFromSize` retain plain `Bounds2Data`/`Bounds3Data` min/max records. `toData()` returns a stable frozen record. Standalone helpers accept values or data.
+- **Construct:** `boundsFromSize` centers on the origin unless `center` is `false`.
+- **Fit:** `fitBounds` scales uniformly and centers in a target, returning scale, position, and resulting data bounds. `maxScale` limits enlargement.
+- **Arrange:** `layoutRow` returns translations for a +X row with minimum Y/Z at zero. Supply bounds after intended rotations, then apply positions through part options.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
+| [bounds2](../bounds2.md) | Snapshots finite ordered XY bounds in millimetres as an immutable fluent value. |
+| [bounds3](../bounds3.md) | Snapshots finite ordered XYZ bounds in millimetres as an immutable fluent value. |
 | [boundsFromSize](../boundsFromSize.md) | Creates immutable centered XY bounds from nonnegative dimensions in millimetres. |
 | [boundsSize](../boundsSize.md) | Inclusive XY dimensions in millimetres; zero extents are retained. |
 | [boundsCenter](../boundsCenter.md) | Midpoint of finite XY bounds in millimetres. |
 | [containsBounds](../containsBounds.md) | Tests actual XY containment, including touching boundaries; dimensions must match. |
 | [fitBounds](../fitBounds.md) | Fits XY bounds uniformly and centers them in the target; zero source axes do not constrain scale. |
-| [layoutRow](../layoutRow.md) | Returns immutable translations for a +X row of finite XYZ bounds with a nonnegative gap. Each minimum Y/Z becomes zero, and the first minimum X becomes zero. Supply bounds after any intended part rotation; translations apply to those bounds. An empty input returns []. |
+| [layoutRow](../layoutRow.md) | Returns immutable translations for a +X row of finite XYZ bounds with a nonnegative gap. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [Bounds2](../Bounds2.md) | Axis-aligned bounds in two-dimensional model space. |
-| [Bounds3](../Bounds3.md) | Axis-aligned bounds in three-dimensional model space. |
+| [Bounds2](../Bounds2-type.md) | Immutable finite XY bounds in millimetres, with tuple coordinates for data interoperability. |
+| [Bounds3](../Bounds3-type.md) | Immutable finite XYZ bounds in millimetres, with tuple coordinates for data interoperability. |
+| [Bounds2Data](../Bounds2Data.md) | Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods. |
+| [Bounds3Data](../Bounds3Data.md) | Plain axis-aligned XYZ bounds for interchange; use bounds3 for immutable measurement methods. |
 | [BoundsFromSizeOptions](../BoundsFromSizeOptions.md) | Placement of bounds constructed from nonnegative millimetre dimensions. |
 | [BoundsFitOptions](../BoundsFitOptions.md) | Uniform fitting controls; fitting centers the source inside the target. |
 | [BoundsFit2](../BoundsFit2.md) | A uniform XY scale followed by translation, and the resulting bounds. |
 | [BoundsFit3](../BoundsFit3.md) | A uniform XYZ scale followed by translation, and the resulting bounds. |
 | [RowLayoutOptions](../RowLayoutOptions.md) | Simple +X row placement with every minimum Y and Z grounded at zero. |
 
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [Bounds2Input](../Bounds2Input.md) | An immutable XY bounds value or its plain min/max representation. |
+| [Bounds3Input](../Bounds3Input.md) | An immutable XYZ bounds value or its plain min/max representation. |
+
 ## 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/categories/curves-paths.md

@@ -2,21 +2,28 @@
 
 Sample reusable lines, arcs, cubic curves, and path frames with explicit physical policies.
 
-sampleCurve2/3 retain directed endpoints and tangents. Exact curve intervals are uniform in the curve parameter; resamplePolyline2/3 use equal arc length. Both resampling dimensions accept the same closed option and return points plus tangents; closed outputs include the closing edge without repeating the first point. Adaptive policies use millimetre deviation and edge length, with checked vertex ceilings. transformPath2 accepts Transform2 placements or Transform2Matrix data; transformPath3 accepts Transform3 placements or Transform3Matrix data. Paths retain point order after reflection. closestPointOnPath returns a point, distance, edge index and interpolation fraction on an open path or explicitly closed boundary. Sweep frames require explicit seam and orientation choices.
+Use immutable `path2(points, { closed })` and `path3(points, { closed })` values for sampled trajectories. Closed paths omit the duplicated endpoint. Geometry accepts matching path values directly.
+
+- **Transform:** `transform()`, `reverse()`, and `resample()` return new paths. Reflections preserve traversal; polygon construction handles filled-shape winding.
+- **Query:** `length()` includes the closing edge. `bounds()` returns fluent bounds or `undefined` for empty paths. `closestPoint()` returns a fluent point, distance, edge index, and fraction within that edge.
+- **Interchange:** `toData()` returns `Path2Data` or `Path3Data` with dimension, closure, and point tuples.
+- **Sample curves:** analytic `Curve` definitions are separate. `sampleCurve2`/`sampleCurve3` retain directed endpoints and tangents; exact intervals are uniform in the curve parameter.
+- **Resample:** `resamplePolyline2`/`resamplePolyline3` return tuple points and tangents at equal arc lengths. Sampling uses physical policies and checked vertex ceilings.
+
+Sweep frames require explicit seam and orientation choices.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
 | [anchorFrame3](../anchorFrame3.md) | Converts an anchor into a right-handed frame with direction as local +Z. |
-| [closestPointOnPath](../closestPointOnPath.md) | Finds the closest position anywhere on an open XY path or closed contour. |
 | [sampleCurve2](../sampleCurve2.md) | Samples a planar curve with the same guarantees and policy as spatial sampling. |
 | [sampleCurve3](../sampleCurve3.md) | Samples a spatial curve, preserving endpoints and directed unit tangents. |
-| [transformPath2](../transformPath2.md) | Applies a canonical affine XY transform to a 2D path without changing point order. |
-| [transformPath3](../transformPath3.md) | Applies an affine transform to a 3D path without mutating its points. |
 | [resolveGeometrySamplingLimits](../resolveGeometrySamplingLimits.md) | Resolves finite positive safe-integer allocation ceilings without ambient state. |
 | [resamplePolyline2](../resamplePolyline2.md) | Resamples a planar polyline with the same point, tangent, seam and budget guarantees as 3D. |
 | [resamplePolyline3](../resamplePolyline3.md) | Resamples a spatial polyline at equal arc lengths with directed outgoing tangents. |
+| [path2](../path2.md) | Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization. |
+| [path3](../path3.md) | Snapshots finite XYZ coordinates as an immutable sampled path with the same closure, seam, allocation and error rules as path2. Analytic curves must be sampled explicitly first. |
 
 ## Interfaces
 
@@ -26,19 +33,24 @@ sampleCurve2/3 retain directed endpoints and tangents. Exact curve intervals are
 | [ArcCurve3](../ArcCurve3.md) | Spatial circular arc in the plane of two orthogonal unit directions. |
 | [CubicBezierCurve2](../CubicBezierCurve2.md) | Planar cubic Bézier with explicit endpoint and control coordinates. |
 | [CubicBezierCurve3](../CubicBezierCurve3.md) | Spatial cubic Bézier with explicit endpoint and control coordinates. |
-| [ClosestPointOnPathOptions](../ClosestPointOnPathOptions.md) | Topology and work ceiling for a closest-point query on a sampled path. |
-| [ClosestPointOnPathResult](../ClosestPointOnPathResult.md) | Closest position on a sampled path, measured in millimetres. |
 | [CurveSamplingOptions](../CurveSamplingOptions.md) | Explicit physical sampling and allocation policy for reusable curves. |
 | [Frame3](../Frame3.md) | A right-handed orthonormal coordinate frame expressed in world coordinates. |
 | [GeometrySamplingLimits](../GeometrySamplingLimits.md) | Explicit allocation ceilings for pure sampling and host-owned modeling operations. |
 | [LineCurve2](../LineCurve2.md) | Straight planar curve in millimetres. |
 | [LineCurve3](../LineCurve3.md) | Straight spatial curve in millimetres. |
+| [Path2](../Path2-type.md) | Immutable directed XY polyline. Closure is explicit and does not imply a filled Section. |
+| [Path3](../Path3-type.md) | Immutable directed XYZ polyline; it represents sampled edges, not an analytic curve. |
 | [PathFrame](../PathFrame.md) | Orthonormal right-handed frame sampled along a path. |
 | [PathPlacement](../PathPlacement.md) | Position and unit tangent for one path-distributed item. |
 | [SampledCurve2](../SampledCurve2.md) | Immutable planar points and corresponding directed unit tangents. |
 | [SampledCurve3](../SampledCurve3.md) | Immutable spatial points and corresponding directed unit tangents. |
 | [SampleHelixOptions](../SampleHelixOptions.md) | Options for a sampled +Z helix with millimetre dimensions. |
 | [PolylineResamplingOptions](../PolylineResamplingOptions.md) | Equal arc-length sampling of an open path or an implicitly closed loop. |
+| [PathOptions](../PathOptions.md) | Topology and allocation ceiling for an immutable sampled path. |
+| [PathLocation](../PathLocation.md) | Nearest location on a sampled boundary, rather than inside a filled shape or on an analytic curve. |
+| [PathResamplingOptions](../PathResamplingOptions.md) | Equal arc-length sampling; the path itself owns whether its closing edge is included. |
+| [Path2Data](../Path2Data.md) | Complete plain XY path representation, including topology and empty-path dimensional identity. |
+| [Path3Data](../Path3Data.md) | Complete plain XYZ path representation, including topology and empty-path dimensional identity. |
 
 ## Type aliases
 
@@ -46,21 +58,23 @@ sampleCurve2/3 retain directed endpoints and tangents. Exact curve intervals are
 | --- | --- |
 | [Curve2](../Curve2.md) | Reusable planar curve definition. |
 | [Curve3](../Curve3.md) | Reusable spatial curve definition. |
-| [Path2](../Path2.md) | An ordered, open sequence of two-dimensional points. |
-| [Path3](../Path3.md) | An ordered, open sequence of three-dimensional points. |
 | [PathNormalGuide](../PathNormalGuide.md) | Supplies a profile-X orientation guide for each original normalized sweep station. |
+| [Path2Input](../Path2Input.md) | A matching path value, complete plain path data, or a collection of vectors. |
+| [Path3Input](../Path3Input.md) | A matching path value, complete plain path data, or a collection of vectors. |
 
 ## Values
 
 | API | Summary |
 | --- | --- |
 | [computeClosedParallelTransportFrames](../computeClosedParallelTransportFrames.md) | Builds rotation-minimizing frames for a non-duplicated closed path. |
-| [computeParallelTransportFrames](../computeParallelTransportFrames.md) | 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. |
-| [cumulativePathLengths](../cumulativePathLengths.md) | Returns cumulative arc length for finite points under maxPathPoints (default 100000); rejects overflowing length. |
+| [computeParallelTransportFrames](../computeParallelTransportFrames.md) | Builds rotation-minimizing frames by parallel-transporting the previous normal. |
 | [defaultGeometrySamplingLimits](../defaultGeometrySamplingLimits.md) | Conservative defaults; trusted callers can supply larger explicit ceilings. |
 | [distributeAlongPath](../distributeAlongPath.md) | Places an exact item count at equal arc-length intervals along a sampled path. |
-| [pathLength](../pathLength.md) | Returns total sampled 3D path length, or zero for an empty path. |
 | [roundClosedPolylinePath](../roundClosedPolylinePath.md) | Replaces each vertex of a non-duplicated closed polyline with a sampled quadratic corner in the same coordinate system as the input. |
-| [sampleHelix](../sampleHelix.md) | Creates `segments + 1` points including exact helix endpoints from finite positive dimensions. Integrated weights must remain finite. The maxPathPoints ceiling defaults to 100000; excessive exact counts reject before evaluating axial weights or allocating sample arrays. |
+| [sampleHelix](../sampleHelix.md) | Creates `segments + 1` points including exact helix endpoints from finite positive dimensions. |
+
+## 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/categories/mechanical.md

@@ -1,27 +1,30 @@
 # Mechanical foundations
 
-Resolve gears, fastener standards, thread profiles, fit, and predictable allocations.
+Resolve gears, knuckle joints, fastener standards, thread profiles, fit, and predictable allocations.
 
-Pure kernels resolve dimensions and emit outlines or meshes without native state. Keep physical clearance separate from Boolean overtravel. Thread and gear results are modeling aids rather than certified manufacturing or strength specifications.
+Pure kernels resolve dimensions and emit outlines or meshes without native state. Keep physical clearance separate from Boolean overtravel.
+
+Thread and gear results are modeling aids, not certified manufacturing or strength specifications.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [buildHelicalThreadRidgeMesh](../buildHelicalThreadRidgeMesh.md) | Builds closed thread-ridge components with every profile locked to the shaft's radial/axial frame. The mesh is intended for union with its minor-envelope cylinder and never owns WASM objects. |
-| [buildHelicalThreadSolidMesh](../buildHelicalThreadSolidMesh.md) | Builds one closed threaded cylinder without a ridge/core Boolean seam. |
+| [resolveKnuckleHinge](../resolveKnuckleHinge.md) | Resolves equal alternating knuckles along +X, centered at the origin, in millimetres. |
+| [helicalThreadRidgeMesh](../helicalThreadRidgeMesh.md) | Builds closed thread-ridge components with every profile locked to the shaft's radial/axial frame. The mesh is intended for union with its minor-envelope cylinder and never owns WASM objects. |
+| [helicalThreadSolidMesh](../helicalThreadSolidMesh.md) | Builds one closed threaded cylinder without a ridge/core Boolean seam. |
 | [compensateThreadDiameters](../compensateThreadDiameters.md) | Applies role-specific radial compensation while preserving thread depth. |
 | [compensateThreadProfileAxially](../compensateThreadProfileAxially.md) | Applies axial fit allowance to a validated periodic profile. |
 | [compensateThreadProfileForFaceting](../compensateThreadProfileForFaceting.md) | Applies printable axial fit plus the conservative phase allowance required by circular facets. |
-| [createThreadProfile](../createThreadProfile.md) | Creates a periodic thread profile for the shaft-locked helical mesher. |
-| [getMetricClearanceHole](../getMetricClearanceHole.md) | Returns one recommended metric clearance-hole diameter in millimetres. |
+| [threadProfile](../threadProfile.md) | Creates a periodic thread profile for the shaft-locked helical mesher. |
+| [getMetricClearanceHoleDiameter](../getMetricClearanceHoleDiameter.md) | Returns one recommended metric clearance-hole diameter in millimetres. |
 | [getMetricFastenerStandard](../getMetricFastenerStandard.md) | Returns the immutable standards record for one supported metric size. |
 | [measureInternalCylindricalGearPairMotion](../measureInternalCylindricalGearPairMotion.md) | Measures sampled kinematic interference over one tooth cycle of an internal gear pair. |
 | [minimumCylindricalGearToothCountWithoutUndercut](../minimumCylindricalGearToothCountWithoutUndercut.md) | Returns the smallest unshifted full-depth external tooth count that avoids rack-cutter undercut. |
-| [preflightHelicalThreadSolidMesh](../preflightHelicalThreadSolidMesh.md) | Validates a direct thread solid and returns its conservative allocation estimate without constructing vertex or index buffers. |
-| [preflightInternalThreadCutter](../preflightInternalThreadCutter.md) | Preflights the exact extended mesh used by the internal thread cutter constructor. |
-| [preflightThreadedNut](../preflightThreadedNut.md) | Resolves a nut's exact body/cutter chamfer and preflights its extended thread mesh without allocating Manifold WASM objects. |
-| [preflightThreadedRod](../preflightThreadedRod.md) | Preflights the exact compensated direct mesh used by the threaded rod constructor. |
+| [preflightHelicalThreadSolidMesh](../preflightHelicalThreadSolidMesh.md) | Checks thread dimensions, profile, end treatments, sampling, and conservative estimates against output limits. |
+| [preflightInternalThreadCutter](../preflightInternalThreadCutter.md) | Resolves compensated cutter dimensions and checks extended mesh estimates against output limits. |
+| [preflightThreadedNut](../preflightThreadedNut.md) | Checks nut dimensions, chamfers, end-face wall, and the extended compensated cutter's allocation plan. |
+| [preflightThreadedRod](../preflightThreadedRod.md) | Resolves compensated rod dimensions and checks conservative mesh estimates against output limits. |
 | [resolveCylindricalGear](../resolveCylindricalGear.md) | Resolves a validated unshifted full-depth external cylindrical gear. |
 | [resolveCylindricalGearPair](../resolveCylindricalGearPair.md) | Resolves ratio, center distance, and helix relationship for a gear pair. |
 | [resolvePrintableThreadFitPolicy](../resolvePrintableThreadFitPolicy.md) | Resolves and validates a named or caller-defined print-fit policy. |
@@ -37,6 +40,10 @@ Pure kernels resolve dimensions and emit outlines or meshes without native state
 | API | Summary |
 | --- | --- |
 | [AcmeThreadProfileSpec](../AcmeThreadProfileSpec.md) | ACME 29-degree included-angle profile. |
+| [KnuckleHingeBaseSpec](../KnuckleHingeBaseSpec.md) | Shared knuckle-joint dimensions in millimetres, independent of mounting geometry. |
+| [KnuckleHingeSamplingOptions](../KnuckleHingeSamplingOptions.md) | Shared circular sampling for barrels, shafts, and bores. |
+| [KnuckleHingeDimensions](../KnuckleHingeDimensions.md) | Immutable joint layout and conservative faceted envelopes; no engine initialization. |
+| [KnuckleHingeInterval](../KnuckleHingeInterval.md) | One equal-length barrel interval in the shared pin-centered frame. |
 | [ButtressThreadProfileSpec](../ButtressThreadProfileSpec.md) | Asymmetric printable buttress profile with 7/45-degree flanks. |
 | [ClearanceHoleDimensions](../ClearanceHoleDimensions.md) | Close, normal, and loose metric clearance-hole diameters in millimetres. |
 | [CompensatedThreadDiameters](../CompensatedThreadDiameters.md) | Compensated major/minor envelopes and the policy values used. |
@@ -50,7 +57,7 @@ Pure kernels resolve dimensions and emit outlines or meshes without native state
 | [CylindricalGearSpec](../CylindricalGearSpec.md) | Nominal dimensions for a standard full-depth cylindrical involute gear. |
 | [HelicalThreadRidgeMeshOptions](../HelicalThreadRidgeMeshOptions.md) | Runtime-neutral options for the dedicated helical ridge mesher. |
 | [HelicalThreadSolidMeshOptions](../HelicalThreadSolidMeshOptions.md) | Options for a complete threaded-cylinder mesh; base semantics match the ridge builder. |
-| [HelicalThreadSolidMeshPreflight](../HelicalThreadSolidMeshPreflight.md) | Conservative allocation facts resolved before constructing a direct thread solid mesh. |
+| [HelicalThreadSolidMeshPreflight](../HelicalThreadSolidMeshPreflight.md) | Selected sampling counts and conservative allocation estimates, before thread mesh construction. |
 | [InternalThreadCutterOptions](../InternalThreadCutterOptions.md) | Options for a compensated internal-thread subtraction tool along +Z. |
 | [MetricFastenerStandard](../MetricFastenerStandard.md) | Small immutable metric fastener record for modeling common mating features. |
 | [MetricHexNutDimensions](../MetricHexNutDimensions.md) | Regular hex-nut envelope dimensions in millimetres. |
@@ -64,11 +71,11 @@ Pure kernels resolve dimensions and emit outlines or meshes without native state
 | [ThreadCircularSegmentsOptions](../ThreadCircularSegmentsOptions.md) | Inputs for resolving one shared circular facet count for a mating thread pair. |
 | [ThreadCompensationOptions](../ThreadCompensationOptions.md) | Options for compensating nominal male or female thread diameters. |
 | [ThreadedNutOptions](../ThreadedNutOptions.md) | Options for a compensated nut with an internal thread. |
-| [ThreadedNutPreflight](../ThreadedNutPreflight.md) | Allocation-free body, cutter, and end-face facts resolved for a threaded nut. |
+| [ThreadedNutPreflight](../ThreadedNutPreflight.md) | Resolved body and end-face dimensions plus conservative allocation estimates for the thread cutter. |
 | [ThreadedRodOptions](../ThreadedRodOptions.md) | Options for a compensated external threaded rod along +Z. |
 | [ThreadEndTreatmentOptions](../ThreadEndTreatmentOptions.md) | Axial end controls for a generated ridge. |
 | [ThreadHelixOptions](../ThreadHelixOptions.md) | Conventional helix options: `pitch` is adjacent spacing and lead is `pitch * starts`. |
-| [ThreadProfile](../ThreadProfile.md) | A validated immutable periodic thread profile in `[axial, radial]` millimetres. |
+| [ThreadProfile](../ThreadProfile-type.md) | A validated immutable periodic thread profile in `[axial, radial]` millimetres. |
 | [ThreadProfileBaseSpec](../ThreadProfileBaseSpec.md) | Fields shared by all thread profile specifications. |
 | [TrapezoidalThreadProfileSpec](../TrapezoidalThreadProfileSpec.md) | Trapezoidal thread profile with a configurable included angle. |
 | [TriangularThreadProfileSpec](../TriangularThreadProfileSpec.md) | ISO/UTS-like 60-degree truncated triangular profile. |
@@ -77,10 +84,11 @@ Pure kernels resolve dimensions and emit outlines or meshes without native state
 
 | API | Summary |
 | --- | --- |
+| [KnuckleHingeSpec](../KnuckleHingeSpec.md) | Knuckle-joint construction modes and interval ownership. |
 | [ButtressPressureFlankSide](../ButtressPressureFlankSide.md) | Axial side carrying the near-normal pressure flank of a buttress thread. |
 | [ClearanceHoleFit](../ClearanceHoleFit.md) | Common clearance-hole fit categories, ordered from smallest to largest. |
 | [CylindricalGearMeshKind](../CylindricalGearMeshKind.md) | Whether two cylindrical gears mesh on their outside teeth or as a pinion inside a ring. |
-| [MetricFastenerSize](../MetricFastenerSize.md) | Metric fastener sizes included in the first mechanical standards table. |
+| [MetricFastenerSize](../MetricFastenerSize.md) | Supported metric fastener sizes. |
 | [PrintableThreadFit](../PrintableThreadFit.md) | Named baseline fit policies for calibrated FDM-style printed threads. |
 | [ThreadedNutBevel](../ThreadedNutBevel.md) | Nut-edge bevel selection. |
 | [ThreadedNutShape](../ThreadedNutShape.md) | Supported printable nut body shapes. |
@@ -98,4 +106,8 @@ Pure kernels resolve dimensions and emit outlines or meshes without native state
 | [METRIC_FASTENER_STANDARDS](../METRIC_FASTENER_STANDARDS.md) | Curated metric modeling dimensions for clearance holes, regular hex nuts, and socket-head cap screws. |
 | [PRINTABLE_THREAD_FIT_POLICIES](../PRINTABLE_THREAD_FIT_POLICIES.md) | Conservative baseline print-fit policies in millimetres. |
 
-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/categories/meshes.md

@@ -2,7 +2,12 @@
 
 Build, transform, validate, analyze, and locally optimize copied indexed meshes.
 
-Manufacturing meshes use Float32 XYZ positions and Uint32 triangle indices. Closed oriented edge validation does not establish absence of self-intersections. Analysis freshly inspects caller-owned arrays. Signatures add quantized topology and a regression hash. Predictable mesh constructors reject unsafe allocations before sampling. extrudeMesh, loftMesh, sweepMesh and revolveMesh construct TriangleMesh data without a host engine. loftMesh requires a selected direct, reindex, fast-distance or distance correspondence method; LoftOptions, SweepOptions and ExtrudeOptions share the filled modeling vocabulary. Loft stations specify exactly one z or frame, retain original vertices, and interpolate slices in world coordinates. Aggregate association and grid work is bounded without fidelity reduction. validateSolidMesh adds bounded floating-point intersection and nested-shell orientation checks, including legitimate cavity boundaries; contacts within tolerance reject conservatively and work exhaustion fails explicitly. computeTriangleMeshCentroid measures the uniform-density volume centroid of consistently oriented closed geometry, including cavities.
+Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle indices. Analysis freshly inspects caller-owned arrays; signatures add quantized topology and a regression hash. Predictable constructors reject unsafe allocations before sampling.
+
+- **Construct:** `extrudeMesh`, `loftMesh`, `sweepMesh`, and `revolveMesh` return `TriangleMesh` data without a host engine. `LoftOptions`, `SweepOptions`, and `ExtrudeOptions` share the filled modeling vocabulary.
+- **Match lofts:** `loftMesh` requires a `direct`, `reindex`, `fast-distance`, or `distance` method. Stations specify exactly one `z` or `frame`, retain original vertices, and interpolate slices in world coordinates. Association and grid work are bounded without reducing fidelity.
+- **Validate:** closed oriented-edge checks do not establish freedom from self-intersections. `validateSolidMesh` adds bounded floating-point intersection and nested-shell orientation checks, including cavity boundaries. Contacts within tolerance reject conservatively; exhausted work limits fail explicitly.
+- **Measure:** `computeTriangleMeshCentroid` returns the uniform-density volume centroid of consistently oriented closed geometry, including cavities.
 
 ## Functions
 
@@ -10,27 +15,26 @@ Manufacturing meshes use Float32 XYZ positions and Uint32 triangle indices. Clos
 | --- | --- |
 | [analyzeTriangleMesh](../analyzeTriangleMesh.md) | Validates and measures a mesh in one position and one triangle traversal. |
 | [analyzeTriangleMeshQuality](../analyzeTriangleMeshQuality.md) | Measures triangle shape, edge topology, vertex concentration, and connected planar patches. |
-| [heightfieldMesh](../heightfieldMesh.md) | Builds a closed indexed mesh from a rectilinear top, matched boundary walls, and flat base. Heights run once per grid point after preflight; center-error adds one evaluation per cell. Top winding is +Z, the base is -Z, and sides face outward. Coordinates and heights must fit Float32 storage. Explicit axes are captured before sampling; shared wall vertices prevent cracks. |
-| [createTriangleMeshSignature](../createTriangleMeshSignature.md) | Creates an order-independent regression signature for a manufacturing mesh. |
+| [heightfieldMesh](../heightfieldMesh.md) | Builds a closed indexed mesh from a rectilinear top, matched boundary walls, and flat base. |
+| [computeTriangleMeshSignature](../computeTriangleMeshSignature.md) | Creates an order-independent regression signature for a manufacturing mesh. |
 | [joinTriangleMeshes](../joinTriangleMeshes.md) | Concatenates meshes into one indexed mesh without welding coincident vertices. |
-| [extrudeMesh](../extrudeMesh.md) | Linearly extrudes one simple profile along +Z with robust ear-clipped caps. |
+| [extrudeMesh](../extrudeMesh.md) | Linearly extrudes one simple profile along +Z with robust ear-clipped caps. Path2 profiles must be closed; raw point collections have an implicit closing edge. |
 | [loftMesh](../loftMesh.md) | Lofts simple point loops at z heights or explicit right-handed frames, in input order. |
-| [measureTriangleMesh](../measureTriangleMesh.md) | Measures bounds, surface area, and signed volume without changing the mesh. |
-| [preflightHeightfield](../preflightHeightfield.md) | Checks grid dimensions, coordinate precision, and allocation bounds before evaluating heights. |
+| [preflightHeightfield](../preflightHeightfield.md) | Checks grid options, Float32 axis precision, and output limits; returns exact mesh buffer counts. |
 | [reverseTriangleMesh](../reverseTriangleMesh.md) | Returns a copy of a mesh with every triangle winding reversed. |
 | [sweepMesh](../sweepMesh.md) | Sweeps one explicitly ordered point loop, with caps or a geometrically matching closed seam. |
 | [transformTriangleMesh](../transformTriangleMesh.md) | Applies an affine transform to a mesh and preserves outward face orientation. |
 | [validateTriangleMesh](../validateTriangleMesh.md) | Validates mesh buffers, indices, triangle area, and optionally closed topology. |
 | [optimizePlanarPatches](../optimizePlanarPatches.md) | Improves pathological planar triangulation with bounded legal diagonal flips. |
 | [resolveExtrusionDivisions](../resolveExtrusionDivisions.md) | Resolves intermediate profile copies for linear extrusion from physical curve resolution. |
-| [validateSolidMesh](../validateSolidMesh.md) | Checks closed indexed topology, triangle intersections, and alternating nested shell orientation. Outward exterior shells and inward cavity shells are accepted. Separate shells must not touch, intersect, or overlap as material. Indexed neighbours may share their own vertex or edge. |
-| [computeTriangleMeshCentroid](../computeTriangleMeshCentroid.md) | 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. |
+| [validateSolidMesh](../validateSolidMesh.md) | Checks closed indexed topology, triangle intersections, and alternating nested shell orientation. |
+| [computeTriangleMeshCentroid](../computeTriangleMeshCentroid.md) | Computes the uniform-density volume centroid of an oriented closed solid, including cavity shells. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [HeightfieldPreflight](../HeightfieldPreflight.md) | Predictable rectilinear-grid allocation facts; this does not evaluate the height callback. |
+| [HeightfieldPreflight](../HeightfieldPreflight.md) | Exact grid and mesh buffer allocation counts resolved without evaluating the height callback. |
 | [PlanarMeshOptimizationOptions](../PlanarMeshOptimizationOptions.md) | Options controlling bounded, connectivity-only optimization of planar triangle patches. |
 | [PlanarMeshOptimizationResult](../PlanarMeshOptimizationResult.md) | Outcome of bounded planar-patch optimization, including before/after diagnostics. |
 | [RevolveOptions](../RevolveOptions.md) | Circumferential sampling and degree sweep shared by pure and filled revolution. |
@@ -70,4 +74,8 @@ Manufacturing meshes use Float32 XYZ positions and Uint32 triangle indices. Clos
 | [meshBounds](../meshBounds.md) | Computes axis-aligned bounds for a non-empty mesh. |
 | [revolveMesh](../revolveMesh.md) | Revolves a non-duplicated closed `[radius, z]` profile around +Z. |
 
-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/categories/pattern-placement.md

@@ -1,34 +1,36 @@
-# Pattern Placement
+# Pattern placement
 
 Calculate pure linear, radial, grid, and path transforms.
 
-Pure pattern transforms use the same counts, spacing, centering and frames as root pattern operations. Transform3Matrix values can place points, meshes or explicit geometry without a native engine. Linear and grid spacing use millimetres; radial angles use degrees. Paths use physical arc-length intervals and omit the seam when closed.
+Pure pattern transforms share counts, spacing, centering, and frames with root pattern operations. Use `Transform3Data` to place points, meshes, or explicit geometry without a native engine.
+
+Linear and grid spacing use millimetres; radial angles use degrees. Paths use physical arc-length intervals and omit the repeated seam when closed.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [linearPatternTransforms](../linearPatternTransforms.md) | Equal linear placements in millimetres, including the original at the origin. |
+| [linearPatternTransforms](../linearPatternTransforms.md) | Spatial XYZ matrix placements in millimetres, including the original at the origin. |
 | [radialPatternTransforms](../radialPatternTransforms.md) | Rotations about an explicit axis; angles use degrees and the first placement is identity. |
-| [gridPatternTransforms](../gridPatternTransforms.md) | XY or XYZ grid placements in millimetres, in X-fastest order. |
-| [pathPatternTransforms](../pathPatternTransforms.md) | Equal physical arc-length placements along a sampled XYZ path. Tangent orientation maps +Z onto the local path tangent; fixed orientation only translates. Closed paths omit a repeated seam. Explicit sampling ceilings bound both input points and output placements. |
+| [gridPatternTransforms](../gridPatternTransforms.md) | Spatial XYZ matrices for an XY or XYZ grid, in X-fastest order. |
+| [pathPatternTransforms](../pathPatternTransforms.md) | Equal physical arc-length placements along a sampled XYZ path. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [RadialPatternOptions](../RadialPatternOptions.md) | Options for repeating one solid around an axis through a center point. |
 | [PathPatternOptions](../PathPatternOptions.md) | Equal physical arc-length placements along an open or implicitly closed sampled path. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [LinearPatternOptions](../LinearPatternOptions.md) | Equal linear intervals determined by exactly two of count, spacing and total length. |
-| [GridPatternOptions](../GridPatternOptions.md) | XY or XYZ grid with X varying fastest. The first item starts at the local origin. |
+| [LinearPatternOptions](../LinearPatternOptions.md) | Equal linear intervals determined by exactly two of count, spacing and total length. Dimension defaults to 3; Section patterns use 2 and accept XY vector directions. |
+| [RadialPatternOptions](../RadialPatternOptions.md) | Degree rotations about a fixed world-space pivot; XY patterns use the implicit +Z axis. |
+| [GridPatternOptions](../GridPatternOptions.md) | 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. |
 
 ## Guides
 
 - [Primitive booleans and repeated placement](../../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/categories/primitive-options.md

@@ -2,7 +2,13 @@
 
 Share one option contract for dimensional primitives and edge treatments.
 
-Dimensional shapes share object options, millimetre units and explicit placement. Boxes use scalar or XYZ size; cylinders use scalar or bottom/top radii and independent end treatments. Circular shapes share exact segments, physical resolution and vertex/face radial sizing where applicable. EdgeTreatment distinguishes circular radius from equal or unequal setbacks, smooth cubic transitions and exact custom setback profiles. PrimitivePlacementOptions maps a local anchor to a target with alignment, gap and degree spin.
+Dimensional shapes share object options, millimetre units, and explicit placement:
+
+- Boxes use a scalar or XYZ size.
+- Cylinders use uniform or bottom/top radii and independent end treatments.
+- Circular shapes share exact segments, physical resolution, and vertex/face radial sizing where applicable.
+- `EdgeTreatment` distinguishes circular radius, equal or unequal setbacks, smooth cubic transitions, and exact custom setback profiles.
+- `PrimitiveAttachmentOptions` maps a local anchor to a target with alignment, gap, and degree spin.
 
 ## Interfaces
 
@@ -15,8 +21,8 @@ Dimensional shapes share object options, millimetre units and explicit placement
 | [TorusOptions](../TorusOptions.md) | Dimensions and independent ring/profile tessellation for a torus around the Z axis. |
 | [TubeOptions](../TubeOptions.md) | Dimensions, placement, and tessellation for a hollow Z-axis tube. |
 | [EndTreatments](../EndTreatments.md) | Independent inward finishing on primitive or straight convex extrusion ends. Zero amounts leave the end untreated, including when all ends are disabled. |
-| [PrimitivePlacement](../PrimitivePlacement.md) | Placement shared by solid and filled-section factories. |
-| [PrimitivePlacementOptions](../PrimitivePlacementOptions.md) | Maps an explicit or named shape-local attachment anchor onto a world-space anchor. |
+| [PrimitiveAttachment](../PrimitiveAttachment.md) | Anchor attachment shared by solid and filled-section factories. |
+| [PrimitiveAttachmentOptions](../PrimitiveAttachmentOptions.md) | Maps an explicit or named shape-local attachment anchor onto a world-space anchor. |
 | [RadialSizingOptions](../RadialSizingOptions.md) | Nominal radial sizing shared by circular and regular polygon construction. |
 | [SmoothEdgeTreatment](../SmoothEdgeTreatment.md) | A cubic corner transition with zero curvature at its straight tangent joins. |
 | [ProfiledEdgeTreatment](../ProfiledEdgeTreatment.md) | A deliberately sampled, inward-only corner profile with exact polyline geometry. |
@@ -33,4 +39,4 @@ Dimensional shapes share object options, millimetre units and explicit placement
 | [BoxEdgeSelection](../BoxEdgeSelection.md) | Named individual edges or top/bottom rims and all four vertical edges. |
 | [BoxEdgeTreatments](../BoxEdgeTreatments.md) | Independent treatments for disjoint named edge selections; overlapping selections fail. |
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/categories/profiles-regions.md

@@ -2,7 +2,12 @@
 
 Define winding, holes, stable profile landmarks, and reusable planar boundaries.
 
-Outer contours are counterclockwise and holes clockwise in Y-up coordinates, with implicit closing edges. The Loop factories return point data; regularPolygonContour uses degree rotation and explicit vertex/face sizing. transformContour and transformRegionData accept Transform2 placements or canonical Transform2Matrix data and retain reflection-safe winding. Use Section.transform for ordinary filled-shape authoring; transformRegionData serves serialized data preparation. `rectangleProfile({ size, treatment, id })` returns identified spans for family matching, not sampled points. Profile families preserve component, contour and span identities; matchProfiles returns CorrespondingProfile values with stable shared landmarks. No automatic topology guessing or reordering occurs. closeToAxis closes an open upward radius/height outline into a solid-body contour; hollow walls and bores require explicit material contours.
+Outer contours are counterclockwise and holes clockwise in Y-up coordinates, with implicit closing edges.
+
+- **Contours:** factories return point data. `regularPolygonContour` uses degree rotation and explicit vertex/face sizing.
+- **Transforms:** `Path2.transform()` preserves traversal. `transformRegionData` accepts a `Transform2` or canonical `Transform2Data`, preserving filled winding after reflection. Use `Section.transform()` for filled-shape authoring and `transformRegionData` for serialized data preparation.
+- **Profile families:** `rectangleProfile({ size, treatment, id })` returns identified spans. Families preserve component, contour, and span identities; `matchProfiles` creates `CorrespondingProfile` values with shared landmarks. It does not guess topology or reorder components.
+- **Side outlines:** `closeToAxis` closes an upward radius/height outline into a solid-body contour. Hollow walls and bores require explicit material contours.
 
 ## Functions
 
@@ -10,21 +15,20 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | --- | --- |
 | [ellipseContour](../ellipseContour.md) | Creates an immutable centered CCW ellipse with +X seam within the selected sampling ceiling. |
 | [contourContainsPoint](../contourContainsPoint.md) | Returns true when a point lies inside or on the boundary of a loop. |
-| [matchProfiles](../matchProfiles.md) | Explicitly matches identified component/contour/span topology across a family. Every paired span uses the maximum physical subdivision count requested by any member. Cubics share a checked uniform parameter grid, including grids selected by exact paired requests. Input order and winding are preserved. Collapsed spans retain repeated logical slots, which the engine maps to shared physical vertices while omitting degenerate faces. |
+| [matchProfiles](../matchProfiles.md) | Explicitly matches identified component/contour/span topology across a family. |
 | [normalizeContour](../normalizeContour.md) | Cleans and validates one closed loop. |
 | [normalizePolygon](../normalizePolygon.md) | Validates explicit polygon topology and normalizes its winding. |
 | [normalizeRegion](../normalizeRegion.md) | Validates a disjoint explicit region and returns immutable normalized data. Previously validated immutable results may be returned unchanged under the same tolerance policy. |
-| [rectangleContour](../rectangleContour.md) | Creates an immutable CCW rectangle loop. Round radius zero is square; tangent saturated endpoints occur once. |
+| [rectangleContour](../rectangleContour.md) | Creates an immutable sampled CCW rectangle boundary. Round radius zero is square; tangent saturated endpoints occur once. |
 | [regionArea](../regionArea.md) | Returns the total filled area of a normalized region in square millimetres. |
 | [regionBounds](../regionBounds.md) | Returns finite axis-aligned bounds for a non-empty region. |
 | [rectangleProfile](../rectangleProfile.md) | Creates an identified rectangle whose edge/corner spans survive zero and saturated round radii. Outer winding is CCW. |
-| [sampleSideProfile](../sampleSideProfile.md) | Samples 1–31 line/cubic segments into a deeply immutable open [radius,height] polyline. Anchors must progress strictly upward; nonnegative-radius cubic controls must have ordered heights between their endpoints. Cubics use de Casteljau subdivision with a conservative control-hull chord-error bound. Lines also obey the optional physical edge-length ceiling. Neither normalized coordinates nor editor metadata are required. Endpoints are retained once; no axis closure, winding normalization, or manufacturing repair is performed. |
-| [sampleContour](../sampleContour.md) | Samples 2–32 connected line/cubic segments into a simple, nonzero-area, immutable CCW XY loop. Physical scaling precedes adaptive curve sampling; the final end must repeat start exactly. Shared anchors and the closing seam are emitted once. Winding normalization may change the starting vertex. The sampled loop is checked for self-intersection and degeneracy by `normalizeContour`; this is a single contour without holes. No editor modes or normalized coordinate range are required. No native engine, SDK, or ambient resolution is used. |
+| [sampleSideProfile](../sampleSideProfile.md) | Samples 1–31 line/cubic segments into a deeply immutable open [radius,height] polyline. |
+| [sampleContour](../sampleContour.md) | Samples 2–32 connected line/cubic segments into a simple, nonzero-area, immutable CCW XY loop. |
 | [signedContourArea](../signedContourArea.md) | Returns the signed area of a non-duplicated loop; positive means CCW. |
-| [transformContour](../transformContour.md) | Applies a canonical affine XY transform to a closed loop and preserves its original winding. |
 | [transformRegionData](../transformRegionData.md) | Transforms serialized polygon data with reflection-safe winding, without an engine. Use Section.transform(placement) when authoring filled geometry; this utility serves pure data preparation. |
 | [triangulateContour](../triangulateContour.md) | Ear-clips one normalized simple CCW loop into stable local vertex indices. |
-| [closeToAxis](../closeToAxis.md) | 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. |
+| [closeToAxis](../closeToAxis.md) | Closes an open, strictly upward [radius, height] side outline to the radius-zero axis. |
 
 ## Interfaces
 
@@ -36,10 +40,10 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | [ContourCurve](../ContourCurve.md) | One explicitly closed planar contour, independent of editor metadata and parameter contracts. |
 | [ContourPoint](../ContourPoint.md) | Planar X and upward Y in millimetres, or in units converted by sampling scales. |
 | [SideProfilePoint](../SideProfilePoint.md) | Radius and upward height in millimetres, or in units converted by sampling scales. |
-| [PolygonData](../PolygonData.md) | One bounded two-dimensional polygon. |
-| [Profile](../Profile.md) | An explicit component/contour/span topology, before shared family sampling. |
+| [PolygonData](../PolygonData.md) | One filled two-dimensional polygon with an exterior and optional holes. |
+| [Profile](../Profile.md) | An explicit component/contour/span topology, before shared family sampling with matchProfiles. Component, contour and span identities establish correspondence across a loft or sweep family. |
 | [ProfileComponent2](../ProfileComponent2.md) | One component and its explicitly identified holes. |
-| [ProfileContour2](../ProfileContour2.md) | Ordered, closed spans. Outer winding is CCW and hole winding is CW. |
+| [ProfileContour2](../ProfileContour2.md) | An identified closed boundary of curve spans, before shared family sampling. Outer winding is CCW and hole winding is CW. matchProfiles retains span identities in sampled contours. |
 | [RectangleContourOptions](../RectangleContourOptions.md) | Shared rectangle dimensions, origin and uniform or per-corner treatment. |
 | [RectangleProfileOptions](../RectangleProfileOptions.md) | Shared rectangle options with an identified component for explicit profile families. |
 | [SampleSideProfileOptions](../SampleSideProfileOptions.md) | Physical scaling and bounded adaptive subdivision for an open profile. |
@@ -54,12 +58,12 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | --- | --- |
 | [CircleContourOptions](../CircleContourOptions.md) | Circular profile dimensions with exactly one radius or diameter and explicit sampling. |
 | [EllipseContourOptions](../EllipseContourOptions.md) | Ellipse dimensions with exactly one XY radii or full-size tuple and explicit sampling. |
-| [Contour](../Contour.md) | A closed two-dimensional boundary whose first point is not repeated at the end. |
+| [Contour](../Contour.md) | A sampled closed two-dimensional boundary whose first point is not repeated at the end. |
 | [CorrespondingProfileStation](../CorrespondingProfileStation.md) | One already matched profile at an explicit height or right-handed spatial frame. |
 | [ContourSegment](../ContourSegment.md) | Straight or cubic Bézier segment in one closed planar contour. |
 | [SideProfileSegment](../SideProfileSegment.md) | One straight or cubic segment of an open, upward-progressing radius/height outline. |
 | [ProfileSpan2](../ProfileSpan2.md) | An identified line, circular arc, or cubic Bézier between corresponding landmarks. |
-| [RegionData](../RegionData.md) | A two-dimensional region represented by disjoint filled polygons. |
+| [RegionData](../RegionData.md) | A two-dimensional region represented by disjoint filled polygons. Each PolygonData owns one exterior and its holes; an empty region contains no material. |
 | [RectangleCornerTreatment](../RectangleCornerTreatment.md) | A rectangle corner, including an explicitly untreated corner in a treatment tuple. |
 | [RectangleCornerTreatments](../RectangleCornerTreatments.md) | Corner treatments ordered top-right, top-left, bottom-left, bottom-right. |
 
@@ -71,4 +75,8 @@ Outer contours are counterclockwise and holes clockwise in Y-up coordinates, wit
 | [regularPolygonContour](../regularPolygonContour.md) | Creates a centered CCW point loop with vertex or face radial sizing and an implicit seam. |
 | [starContour](../starContour.md) | Creates a centered CCW alternating-radius star within the selected profile sampling ceiling. |
 
-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/categories/resolution-errors.md

@@ -2,13 +2,15 @@
 
 Resolve physical sampling, numerical tolerances, and contextual failures.
 
-Defaults are 0.05 mm maximum circular chord error and 16–512 segments per complete circle. Face-sized circular sampling bounds outward radial excess and actual edge lengths. Exact local counts win. Algorithm limits fail explicitly. GeometryError supplies structured codes and operation context; no ambient resolution state exists.
+Defaults are 0.05 mm maximum circular chord error and 16–512 segments per complete circle. Face-sized circular sampling bounds outward radial excess and actual edge lengths. Exact local counts take precedence.
+
+Algorithm limits fail explicitly. `GeometryError` provides structured codes and operation context; resolution has no ambient state.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [isGeometryError](../isGeometryError.md) | Recognizes structured geometry errors from separately bundled Modeling copies in the same realm. Ordinary errors and unmarked code-shaped objects are rejected. The marker is execution-local and does not survive structured cloning; worker protocols carry their own serialized error envelope. |
+| [isGeometryError](../isGeometryError.md) | Recognizes structured geometry errors from separately bundled Modeling copies in the same realm. |
 | [resolveAlignedCircularSegments](../resolveAlignedCircularSegments.md) | Resolves a deterministic full-circle count aligned to reusable topology factors. |
 | [resolveArcSegments](../resolveArcSegments.md) | Resolves the number of segments needed for a circular arc. |
 | [resolveCircularSegments](../resolveCircularSegments.md) | Resolves a deterministic full-circle segment count for one radius. |
@@ -44,4 +46,4 @@ Defaults are 0.05 mm maximum circular chord error and 16–512 segments per comp
 | --- | --- |
 | [DEFAULT_GEOMETRY_TOLERANCE](../DEFAULT_GEOMETRY_TOLERANCE.md) | Default absolute, relative, and angular tolerances for millimetre-scale models. |
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.