@metamesh/modeling 0.12.0 → 0.13.0

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

@@ -0,0 +1,102 @@
+# buildHelicalThreadSolidMesh
+
+Builds one closed threaded cylinder without a ridge/core Boolean seam.
+
+**buildHelicalThreadSolidMesh**(`options`: [`HelicalThreadSolidMeshOptions`](HelicalThreadSolidMeshOptions.md)): [`TriangleMesh`](TriangleMesh.md)
+
+
+
+Each circular facet includes its exact phase-shifted profile breakpoints, including duplicate-Z
+samples for vertical flanks and blunt transitions. Adjacent variable grids are stitched as a
+monotone strip, with optional intermediate rows bounded by physical `maxSegmentLength`. A
+conservative pre-allocation estimate rejects excessive meshes before constructing position
+arrays.
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`HelicalThreadSolidMeshOptions`](HelicalThreadSolidMeshOptions.md) · Required
+
+- [`length`](HelicalThreadSolidMeshOptions.md#length) · `number` · Required
+
+  Total threaded axial length in millimetres.
+
+- [`majorDiameter`](HelicalThreadSolidMeshOptions.md#majordiameter) · `number` · Required
+
+  Nominal major diameter before any caller-owned fit compensation.
+
+- [`profile`](HelicalThreadSolidMeshOptions.md#profile) · [`ThreadProfile`](ThreadProfile.md) · Required
+
+  Validated periodic profile repeated around the shaft.
+
+- [`ends`](HelicalThreadSolidMeshOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
+
+  Optional bottom/top ridge-end treatments. Standalone ridges honor the requested boundaries;
+  BOSL2-style non-cut lead-in scaling is available on complete thread solids.
+
+- [`handedness`](HelicalThreadSolidMeshOptions.md#handedness) · [`ThreadHandedness`](ThreadHandedness.md) · Optional
+
+  Helix direction. Default: `right`.
+
+- [`limits`](HelicalThreadSolidMeshOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+
+  Explicit output and circular allocation ceilings.
+
+- [`phaseDegrees`](HelicalThreadSolidMeshOptions.md#phasedegrees) · `number` · Optional
+
+  Angular offset of the first start in degrees. Default: `0`.
+
+- [`resolution`](HelicalThreadSolidMeshOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+
+  Optional circular-resolution policy.
+
+- [`starts`](HelicalThreadSolidMeshOptions.md#starts) · `number` · Optional
+
+  Number of evenly phased starts. Default: `1`.
+
+- [`tolerance`](HelicalThreadSolidMeshOptions.md#tolerance) · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
+
+  Optional numerical tolerance overrides.
+
+- [`bevelBottom`](HelicalThreadSolidMeshOptions.md#bevelbottom) · `boolean` · Optional
+
+  Apply a 45-degree radial bevel at the lower target face.
+
+- [`bevelBottomSize`](HelicalThreadSolidMeshOptions.md#bevelbottomsize) · `number` · Optional
+
+  Lower bevel size override. Takes precedence over `bevelSize`.
+
+- [`bevelOffset`](HelicalThreadSolidMeshOptions.md#beveloffset) · `number` · Optional
+
+  Distance of each bevel target face inward from the corresponding mesh end.
+
+- [`bevelMode`](HelicalThreadSolidMeshOptions.md#bevelmode) · `"inset"` \| `"outset"` · Optional
+
+  `inset` trims an external rod; `outset` expands an internal cutter.
+
+- [`bevelSize`](HelicalThreadSolidMeshOptions.md#bevelsize) · `number` · Optional
+
+  Axial and radial bevel size. Defaults to the profile depth.
+
+- [`bevelTop`](HelicalThreadSolidMeshOptions.md#beveltop) · `boolean` · Optional
+
+  Apply a 45-degree radial bevel at the upper target face.
+
+- [`bevelTopSize`](HelicalThreadSolidMeshOptions.md#beveltopsize) · `number` · Optional
+
+  Upper bevel size override. Takes precedence over `bevelSize`.
+
+
+
+## Returns
+
+[`TriangleMesh`](TriangleMesh.md)
+
+
+## Related APIs
+
+- [HelicalThreadSolidMeshOptions](HelicalThreadSolidMeshOptions.md)
+- [TriangleMesh](TriangleMesh.md)
+
+Package: `@metamesh/modeling@0.13.0`.

package/dist/docs/reference/geometry/categories/bounds-layout.md

@@ -0,0 +1,35 @@
+# Bounds & 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.
+
+## Functions
+
+| API | Summary |
+| --- | --- |
+| [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 []. |
+
+## 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. |
+| [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. |
+
+## Guides
+
+- [Text from a Font parameter](../../../guides/recipes.md#text-from-a-font-parameter)
+- [Solid inspection](../../../guides/recipes.md#solid-inspection)
+
+Package: `@metamesh/modeling@0.13.0`.

package/dist/docs/reference/geometry/categories/curves-paths.md

@@ -0,0 +1,63 @@
+# Curves and paths
+
+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. 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. |
+| [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 an XY-plane-preserving affine transform to a 2D path. |
+| [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. |
+
+## Interfaces
+
+| API | Summary |
+| --- | --- |
+| [ArcCurve2](../ArcCurve2.md) | Planar circular arc with counterclockwise degree angles. |
+| [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. |
+| [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. |
+| [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. |
+
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [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. |
+
+## 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. |
+| [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. |
+
+Package: `@metamesh/modeling@0.13.0`.

package/dist/docs/reference/geometry/categories/mechanical.md

@@ -0,0 +1,101 @@
+# Mechanical foundations
+
+Resolve gears, 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.
+
+## 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. |
+| [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. |
+| [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. |
+| [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. |
+| [resolveRackPitch](../resolveRackPitch.md) | Resolves a rack segment that is conjugate with the same normal cylindrical pitch system. |
+| [resolveThreadCircularSegments](../resolveThreadCircularSegments.md) | Resolves a role-independent, start-aligned facet count from the larger female mating envelope. |
+| [sampleCylindricalGearOutline](../sampleCylindricalGearOutline.md) | Samples a complete external involute gear boundary in the XY plane. |
+| [sampleInternalCylindricalGearSpaceOutline](../sampleInternalCylindricalGearSpaceOutline.md) | Samples the center opening and tooth spaces used to subtract an internal ring gear. |
+| [sampleRackToothPath](../sampleRackToothPath.md) | Samples the open top boundary of a finite rack in its XY pitch plane. |
+| [sampleThreadHelices](../sampleThreadHelices.md) | Samples evenly phased thread helices with finite `lead = pitch * starts`. All starts together respect maxPathPoints (default 100000); excessive counts fail before allocation. |
+
+## Interfaces
+
+| API | Summary |
+| --- | --- |
+| [AcmeThreadProfileSpec](../AcmeThreadProfileSpec.md) | ACME 29-degree included-angle profile. |
+| [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. |
+| [CustomThreadProfileSpec](../CustomThreadProfileSpec.md) | Caller-defined periodic axial/radial profile in millimetres. |
+| [CylindricalGearDimensions](../CylindricalGearDimensions.md) | Resolved transverse pitch-plane dimensions for one cylindrical gear. |
+| [CylindricalGearOutlineOptions](../CylindricalGearOutlineOptions.md) | Sampling controls for a complete non-duplicated gear outline. |
+| [CylindricalGearPairDimensions](../CylindricalGearPairDimensions.md) | Pitch solution for a coordinated cylindrical gear pair. |
+| [CylindricalGearPairMotionOptions](../CylindricalGearPairMotionOptions.md) | Sampling controls for one coupled internal-gear tooth cycle. |
+| [CylindricalGearPairMotionReport](../CylindricalGearPairMotionReport.md) | Maximum sampled planar overlap for an external pinion inside an internal ring. |
+| [CylindricalGearPairSpec](../CylindricalGearPairSpec.md) | Inputs for resolving a coordinated cylindrical gear pair. |
+| [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. |
+| [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. |
+| [MetricSocketCapHeadDimensions](../MetricSocketCapHeadDimensions.md) | Socket-head cap screw head and drive dimensions in millimetres. |
+| [PrintableThreadFitPolicy](../PrintableThreadFitPolicy.md) | Explicit radial and axial allowances for a mating printed thread pair. |
+| [RackPitchDimensions](../RackPitchDimensions.md) | Resolved pitch-line dimensions for a finite rack segment. |
+| [RackPitchSpec](../RackPitchSpec.md) | Normal-plane inputs for a finite rack pitch segment. |
+| [SampledThreadHelices](../SampledThreadHelices.md) | Sampled paths plus conventional pitch and lead measurements. |
+| [SquareThreadProfileSpec](../SquareThreadProfileSpec.md) | Square profile with equal crest and root widths. |
+| [ThreadBevelOptions](../ThreadBevelOptions.md) | End bevel controls shared by threaded rods and cutters. |
+| [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. |
+| [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. |
+| [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. |
+
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [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. |
+| [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. |
+| [ThreadEndStyle](../ThreadEndStyle.md) | End shape of a generated helical ridge. |
+| [ThreadHandedness](../ThreadHandedness.md) | Direction in which a conventional helical thread advances around +Z. |
+| [ThreadLeadInEnvelope](../ThreadLeadInEnvelope.md) | Radial envelope toward which a blunt lead-in collapses. |
+| [ThreadLeadInShape](../ThreadLeadInShape.md) | BOSL2-compatible cross-section scaling curve for a blunt thread lead-in. |
+| [ThreadProfileSpec](../ThreadProfileSpec.md) | Supported built-in and caller-defined thread profiles. |
+| [ThreadRole](../ThreadRole.md) | Whether compensation is being applied to an external or internal thread. |
+
+## Values
+
+| API | Summary |
+| --- | --- |
+| [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.13.0`.

package/dist/docs/reference/geometry/categories/meshes.md

@@ -0,0 +1,73 @@
+# Triangle meshes and surfaces
+
+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.
+
+## Functions
+
+| API | Summary |
+| --- | --- |
+| [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. |
+| [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. |
+| [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. |
+| [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. |
+
+## Interfaces
+
+| API | Summary |
+| --- | --- |
+| [HeightfieldPreflight](../HeightfieldPreflight.md) | Predictable rectilinear-grid allocation facts; this does not evaluate 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. |
+| [SweepOptions](../SweepOptions.md) | Controls shared by pure mesh construction and filled modeling sweeps. |
+| [TriangleMesh](../TriangleMesh.md) | A topology-preserving indexed triangle mesh with XYZ vertex positions. |
+| [TriangleMeshAnalysis](../TriangleMeshAnalysis.md) | Measurements and optional edge-connected topology from one validated mesh traversal. |
+| [TriangleMeshAnalysisOptions](../TriangleMeshAnalysisOptions.md) | Validation and optional connectivity controls for a shared mesh analysis. |
+| [TriangleMeshMeasurements](../TriangleMeshMeasurements.md) | Geometric measurements derived from a validated, non-empty triangle mesh. |
+| [TriangleMeshQualityOptions](../TriangleMeshQualityOptions.md) | Options controlling bounded triangle-mesh quality analysis. |
+| [TriangleMeshQualityReport](../TriangleMeshQualityReport.md) | Structural, topological, and planar-patch measurements for one indexed triangle mesh. |
+| [TriangleMeshSignature](../TriangleMeshSignature.md) | Immutable deterministic measurements for a closed, oriented triangle mesh. |
+| [TriangleMeshSignatureOptions](../TriangleMeshSignatureOptions.md) | Options controlling deterministic triangle-mesh regression signatures. |
+| [TriangleMeshSignatureTolerances](../TriangleMeshSignatureTolerances.md) | Absolute tolerances recorded in a triangle-mesh regression signature. |
+| [TriangleMeshValidationOptions](../TriangleMeshValidationOptions.md) | Options controlling structural and manufacturing validation of a mesh. |
+| [ExtrudeOptions](../ExtrudeOptions.md) | Dimensions and sampling shared by native and pure +Z extrusion. |
+| [ExtrusionSamplingOptions](../ExtrusionSamplingOptions.md) | Shared sampling controls for a twisted or scaled linear extrusion. |
+| [LoftOptions](../LoftOptions.md) | Shared controls for native and pure lofts. Point data and arbitrary Sections require explicit correspondence. |
+| [PlanarPatchQuality](../PlanarPatchQuality.md) | Quality measurements for one edge-connected coplanar triangle patch. |
+| [SolidMeshValidationOptions](../SolidMeshValidationOptions.md) | Bounded floating-point intersection and shell-orientation validation settings. |
+
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [HeightfieldMeshLimits](../HeightfieldMeshLimits.md) | Trusted output ceilings for pure construction; omitted fields use engine defaults. |
+| [HeightfieldOptions](../HeightfieldOptions.md) | A closed rectilinear heightfield above a flat base, with uniform or explicit XY samples in millimetres. |
+| [LoftMeshStation](../LoftMeshStation.md) | One point-data profile at a height or explicit right-handed spatial frame. |
+| [PlanarMeshOptimizationFallbackReason](../PlanarMeshOptimizationFallbackReason.md) | Stable reason why planar optimization returned the original mesh unchanged. |
+| [SweepOrientation](../SweepOrientation.md) | Explicit profile-X frame policy; all normals are directed, and selected singular policies reject. |
+| [LoftCorrespondence](../LoftCorrespondence.md) | Associates ordered loft contours without inferring component identities or repairing topology. |
+| [LoftPlacement](../LoftPlacement.md) | A horizontal XY station height, or an explicit right-handed spatial frame, never both. |
+
+## Values
+
+| API | Summary |
+| --- | --- |
+| [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.13.0`.

package/dist/docs/reference/geometry/categories/pattern-placement.md

@@ -0,0 +1,34 @@
+# 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. Transform3 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.
+
+## Functions
+
+| API | Summary |
+| --- | --- |
+| [linearPatternTransforms](../linearPatternTransforms.md) | Equal linear 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. |
+
+## 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. |
+
+## Guides
+
+- [Primitive booleans and repeated placement](../../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+
+Package: `@metamesh/modeling@0.13.0`.

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

@@ -0,0 +1,36 @@
+# Primitive options
+
+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.
+
+## Interfaces
+
+| API | Summary |
+| --- | --- |
+| [BoxOptions](../BoxOptions.md) | Dimensions, placement, and uniform or independently selected finishing for an axis-aligned box. |
+| [ChamferedEdgeTreatment](../ChamferedEdgeTreatment.md) | A planar edge or corner chamfer with equal or independent surface setbacks. |
+| [CircularPrimitiveOptions](../CircularPrimitiveOptions.md) | Tessellation controls shared by circular primitives across Geometry entry points. |
+| [RoundedEdgeTreatment](../RoundedEdgeTreatment.md) | A circular edge or corner roundover with explicit physical sampling. |
+| [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. |
+| [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. |
+
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [EdgeTreatment](../EdgeTreatment.md) | Uniform finishing vocabulary shared by applicable solid edges and profile corners. |
+| [CylinderOptions](../CylinderOptions.md) | Dimensions, placement, independent end finishing, and tessellation for a Z-axis cylinder or frustum. |
+| [SphereOptions](../SphereOptions.md) | Exactly one radius or diameter, placement, and tessellation for an origin-centered sphere. |
+| [RadialSizing](../RadialSizing.md) | Radial dimensions refer to polygon vertices or compensate faceting to meet polygon faces. |
+| [BoxEdge](../BoxEdge.md) | Box edges use +Z top, +Y front and +X right; vertical names list front/back first. |
+| [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.13.0`.

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

@@ -0,0 +1,74 @@
+# Profiles and regions
+
+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. `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.
+
+## Functions
+
+| API | Summary |
+| --- | --- |
+| [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. |
+| [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. |
+| [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. |
+| [signedContourArea](../signedContourArea.md) | Returns the signed area of a non-duplicated loop; positive means CCW. |
+| [transformContour](../transformContour.md) | Transforms a closed loop and preserves its original winding convention. |
+| [transformRegion](../transformRegion.md) | Transforms an explicit outer/hole region with reflection-safe winding correction. |
+| [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. |
+
+## Interfaces
+
+| API | Summary |
+| --- | --- |
+| [CorrespondingProfile](../CorrespondingProfile.md) | Shared logical contour sampling suitable for a loft or hollow sweep. |
+| [MatchProfilesOptions](../MatchProfilesOptions.md) | Explicit family sampling settings; omitted values use physical package defaults. |
+| [SideProfileCurve](../SideProfileCurve.md) | An open radius/height outline; consumers own closure, mounting geometry, and wall policy. |
+| [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. |
+| [Polygon](../Polygon.md) | One bounded two-dimensional polygon. |
+| [Profile](../Profile.md) | An explicit component/contour/span topology, before shared family sampling. |
+| [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. |
+| [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. |
+| [SampleContourOptions](../SampleContourOptions.md) | Physical scaling, subdivision policy, and output ceilings for one closed contour. |
+| [CorrespondingComponent](../CorrespondingComponent.md) | One sampled component retaining contour identities and logical point correspondence. |
+| [CorrespondingContour](../CorrespondingContour.md) | A sampled contour retaining logical slots, including intentionally collapsed spans. |
+| [RegularPolygonContourOptions](../RegularPolygonContourOptions.md) | Exact regular polygon dimensions and counterclockwise degree rotation. |
+
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [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. |
+| [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. |
+| [Region](../Region.md) | A two-dimensional region represented by disjoint filled polygons. |
+| [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. |
+
+## Values
+
+| API | Summary |
+| --- | --- |
+| [circleContour](../circleContour.md) | Creates an immutable centered CCW circle with +X seam and vertex or face radial sizing. |
+| [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.13.0`.

package/dist/docs/reference/geometry/categories/resolution-errors.md

@@ -0,0 +1,46 @@
+# Resolution and errors
+
+Resolve physical sampling, numerical tolerances, and contextual failures.
+
+Defaults are 0.05 mm maximum circular chord error and 16–512 segments per complete circle. Exact local counts win. Algorithm limits fail explicitly. GeometryError supplies structured codes and operation context; no ambient resolution state exists.
+
+## 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. |
+| [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. |
+| [resolveGeometryTolerance](../resolveGeometryTolerance.md) | Resolves comparison tolerances for a characteristic model scale. |
+
+## Classes
+
+| API | Summary |
+| --- | --- |
+| [GeometryError](../GeometryError.md) | Error raised when a geometry precondition or invariant is not satisfied. |
+
+## Interfaces
+
+| API | Summary |
+| --- | --- |
+| [AlignedCircularSegmentsOptions](../AlignedCircularSegmentsOptions.md) | Controls full-circle sampling that must satisfy one or more topology alignments. |
+| [GeometryErrorContext](../GeometryErrorContext.md) | Serializable context attached to a geometry failure. |
+| [GeometryResolution](../GeometryResolution.md) | Tessellation policy for sampled geometry measured in millimetres. |
+| [GeometryToleranceOptions](../GeometryToleranceOptions.md) | Optional overrides for MetaMesh's geometry comparison policy. |
+| [ModelingLimits](../ModelingLimits.md) | Aggregate manufacturing output ceilings selected by a trusted host. |
+| [ResolvedGeometryTolerance](../ResolvedGeometryTolerance.md) | Fully resolved tolerances for one operation and model scale. |
+
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [GeometryErrorCode](../GeometryErrorCode.md) | Stable categories for invalid inputs, topology, allocation, and runtime failures. |
+
+## Values
+
+| API | Summary |
+| --- | --- |
+| [DEFAULT_GEOMETRY_TOLERANCE](../DEFAULT_GEOMETRY_TOLERANCE.md) | Default absolute, relative, and angular tolerances for millimetre-scale models. |
+
+Package: `@metamesh/modeling@0.13.0`.