@metamesh/modeling 0.18.0 → 0.20.0

package/dist/docs/reference/mesh/categories/operations.md

@@ -7,7 +7,7 @@ Use `import * as mesh from "@metamesh/modeling/geometry/mesh"` for static, remov
 Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle indices. Mesh analysis accepts raw arrays or stable immutable buffers directly; signatures add quantized topology and a regression hash. Predictable constructors reject unsafe allocations before sampling.
 
 - **Construct:** `mesh.extrude`, `mesh.loft`, `mesh.sweep`, `mesh.revolve`, `mesh.threadRidge`, and `mesh.threadSolid` return `TriangleMesh` data without a host engine. `LoftOptions`, `SweepOptions`, and `ExtrudeMeshOptions` describe pure construction. Native `ExtrudeOptions` additionally accepts end treatments.
-- **Match lofts:** `mesh.loft` defaults to `direct` correspondence; select `reindex`, `fast-distance`, or `distance` explicitly when needed. Stations specify exactly one `z` or `frame`, retain original vertices, and interpolate slices in world coordinates. Profile association and sampling-grid work have explicit limits; fidelity isn't reduced to meet them.
+- **Match lofts:** `mesh.loft` defaults to `direct` correspondence; select `reindex`, `fast-distance`, or `distance` explicitly when needed. Stations specify exactly one `z` or `transform`, retain original vertices, and interpolate slices in world coordinates. Profile association and sampling-grid work have explicit limits; fidelity isn't reduced to meet them.
 - **Validate:** closed oriented-edge checks do not establish freedom from self-intersections. `mesh.validateSolid` adds bounded floating-point intersection and nested-shell orientation checks, including cavity boundaries. Contacts within tolerance reject conservatively; exhausted work limits fail explicitly.
 - **Measure:** `mesh.centroid` returns the uniform-density volume centroid of consistently oriented closed geometry, including cavities.
 
@@ -16,8 +16,8 @@ Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle
 | API | Summary |
 | --- | --- |
 | [extrude](../extrude.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. End treatments are unsupported and reject at runtime. Use Section.extrude for finished ends. |
-| [loft](../loft.md) | Lofts simple point loops at z heights or explicit right-handed frames, in input order. |
-| [sweep](../sweep.md) | Sweeps one explicitly ordered point loop, with caps or a geometrically matching closed seam. |
+| [loft](../loft.md) | Lofts simple point contours at z heights or explicit affine transforms, in input order. |
+| [sweep](../sweep.md) | Sweeps one ordered point loop along a path or explicit affine placements. Path mode computes orientation and deformation, automatically matching compatible closed seams. Transform mode connects only the supplied stations, preserving profile indices without refinement. |
 | [heightfield](../heightfield.md) | Builds a closed indexed mesh from a rectilinear top, matched boundary walls, and flat base. |
 | [preflightHeightfield](../preflightHeightfield.md) | Checks grid options, Float32 axis precision, and output limits; returns exact mesh buffer counts. |
 | [threadRidge](../threadRidge.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. |
@@ -34,104 +34,41 @@ Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle
 | [validateSolid](../validateSolid.md) | Checks closed indexed topology, triangle intersections, and alternating nested shell orientation. |
 | [optimizePlanarPatches](../optimizePlanarPatches.md) | Improves pathological planar triangulation with bounded legal diagonal flips. |
 | [immutable](../immutable.md) | Copies mesh buffers into immutable data; geometric validation still occurs when modeling or finalizing. |
+| [render](../render.md) | Builds crease-aware render buffers without moving or merging distinct positions. Face normals are averaged only at exactly coincident positions within the crease angle. Returns owned buffers; every triangle retains its coordinates, order and winding. Pathological vertex fans exceeding 50 million normal comparisons reject with a complexity error. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
+| [MeshRenderOptions](../MeshRenderOptions.md) | Shading policy for a render copy; manufacturing positions and triangle order never change. |
+| [RenderMesh](../RenderMesh.md) | Owned indexed render buffers with unit vertex normals and positions in millimetres. |
+| [SolidMeshValidationOptions](../SolidMeshValidationOptions.md) | Bounded floating-point intersection and shell-orientation validation settings. |
 | [TriangleMesh](../TriangleMesh.md) | A topology-preserving indexed triangle mesh with mutable owned XYZ buffers. |
-| [TriangleMeshMeasurements](../TriangleMeshMeasurements.md) | Geometric measurements derived from a validated, non-empty triangle mesh. |
 | [TriangleMeshAnalysis](../TriangleMeshAnalysis.md) | Measurements and optional edge-connected topology from one validated mesh traversal. |
 | [TriangleMeshTopologyAnalysis](../TriangleMeshTopologyAnalysis.md) | Mesh measurements with the indexed surface-shell and edge counts requested by includeTopology. |
 | [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. |
 | [TriangleMeshValidationOptions](../TriangleMeshValidationOptions.md) | Options controlling structural and manufacturing validation of a mesh. |
-| [ImmutableTriangleMesh](../ImmutableTriangleMesh.md) | Immutable local XYZ positions and triangle indices, suitable for a computed value or part. |
-| [ExtrudeMeshOptions](../ExtrudeMeshOptions.md) | Dimensions and sampling for pure +Z mesh extrusion, without end treatments. |
-| [LoftOptions](../LoftOptions.md) | Shared controls for native and pure lofts. Point data and arbitrary Sections default to direct correspondence. |
-| [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. |
-| [HeightfieldPreflight](../HeightfieldPreflight.md) | Exact grid and mesh buffer allocation counts resolved without evaluating the height callback. |
-| [SolidMeshValidationOptions](../SolidMeshValidationOptions.md) | Bounded floating-point intersection and shell-orientation validation settings. |
 | [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. |
+| [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. |
 | [PlanarPatchQuality](../PlanarPatchQuality.md) | Quality measurements for one edge-connected coplanar triangle patch. |
 | [TriangleMeshQualityOptions](../TriangleMeshQualityOptions.md) | Options controlling bounded triangle-mesh quality analysis. |
 | [TriangleMeshQualityReport](../TriangleMeshQualityReport.md) | Structural, topological, and planar-patch measurements for one indexed triangle mesh. |
-| [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. |
-| [ImmutableBuffer](../ImmutableBuffer.md) | Owned immutable numeric data. Iterate without copying; use copy() for mutable storage. |
-| [ExtrusionSamplingOptions](../ExtrusionSamplingOptions.md) | Shared sampling controls for a twisted or scaled linear extrusion. |
-| [Bounds2](../Bounds2.md) | Immutable finite XY bounds in millimetres, with tuple coordinates for data interoperability. |
-| [Bounds3](../Bounds3.md) | Immutable finite XYZ bounds in millimetres, with tuple coordinates for data interoperability. |
-| [Vector2](../Vector2.md) | Immutable XY arithmetic; vector operations return new values and measurements return numbers. |
-| [Vector3](../Vector3.md) | Immutable XYZ arithmetic; vector operations return new values and measurements return numbers. |
-| [Path2](../Path2.md) | Immutable directed XY polyline. Closure is explicit and does not imply a filled Section. |
-| [Path3](../Path3.md) | Immutable directed XYZ polyline; it represents sampled edges, not an analytic curve. |
-| [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. |
-| [Transform2](../Transform2.md) | Immutable reusable XY placement. Methods apply in written order; angles are degrees. |
-| [Transform3](../Transform3.md) | Immutable reusable XYZ placement. Methods apply in written order; angles are degrees. |
-| [Pivot2Options](../Pivot2Options.md) | A fixed XY point in world coordinates; omitted pivots use the coordinate origin. |
-| [Pivot3Options](../Pivot3Options.md) | A fixed XYZ point in world coordinates; omitted pivots use the coordinate origin. |
-| [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. |
-| [Frame3](../Frame3.md) | A right-handed orthonormal coordinate frame expressed in world coordinates. |
-| [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. |
-| [CurveSamplingOptions](../CurveSamplingOptions.md) | Explicit physical sampling and allocation policy for reusable curves. |
-| [CircularPrimitiveOptions](../CircularPrimitiveOptions.md) | Tessellation controls shared by circular primitives across Geometry entry points. |
-| [GeometryResolution](../GeometryResolution.md) | Tessellation policy for sampled geometry measured in millimetres. |
-| [GeometrySamplingLimits](../GeometrySamplingLimits.md) | Explicit allocation ceilings for pure sampling and host-owned modeling operations. |
-| [GeometryToleranceOptions](../GeometryToleranceOptions.md) | Optional overrides for MetaMesh's geometry comparison policy. |
-| [ModelingLimits](../ModelingLimits.md) | Aggregate manufacturing output ceilings selected by a trusted host. |
-| [ThreadRidgeOptions](../ThreadRidgeOptions.md) | Runtime-neutral options for the dedicated helical ridge mesher. |
-| [ThreadSolidOptions](../ThreadSolidOptions.md) | Options for a complete threaded-cylinder mesh; base semantics match the ridge builder. |
-| [ThreadSolidPreflight](../ThreadSolidPreflight.md) | Selected sampling counts and conservative allocation estimates, before thread mesh construction. |
-| [ThreadEndTreatmentOptions](../ThreadEndTreatmentOptions.md) | Axial end controls for a generated ridge. |
-| [ThreadProfile](../ThreadProfile.md) | A validated immutable periodic thread profile in `[axial, radial]` millimetres. |
-| [AcmeThreadProfileSpec](../AcmeThreadProfileSpec.md) | ACME 29-degree included-angle profile. |
-| [ButtressThreadProfileSpec](../ButtressThreadProfileSpec.md) | Asymmetric printable buttress profile with 7/45-degree flanks. |
-| [CustomThreadProfileSpec](../CustomThreadProfileSpec.md) | Caller-defined periodic axial/radial profile in millimetres. |
-| [SquareThreadProfileSpec](../SquareThreadProfileSpec.md) | Square profile with equal crest and root widths. |
-| [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. |
+| [ImmutableTriangleMesh](../ImmutableTriangleMesh.md) | Immutable local XYZ positions and triangle indices, suitable for a memo result or part. |
+| [HeightfieldPreflight](../HeightfieldPreflight.md) | Exact grid and mesh buffer allocation counts resolved without evaluating the height callback. |
+| [ExtrudeMeshOptions](../ExtrudeMeshOptions.md) | Dimensions and sampling for pure +Z mesh extrusion, without end treatments. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
+| [PlanarMeshOptimizationFallbackReason](../PlanarMeshOptimizationFallbackReason.md) | Stable reason why planar optimization preserved the original connectivity. |
 | [TriangleMeshInput](../TriangleMeshInput.md) | Raw construction buffers or immutable captured geometry accepted by mesh utilities. |
-| [LoftMeshStation](../LoftMeshStation.md) | One point-data profile at a height or explicit right-handed spatial frame. |
-| [LoftPlacement](../LoftPlacement.md) | A horizontal XY station height, or an explicit right-handed spatial frame, never both. |
-| [LoftCorrespondence](../LoftCorrespondence.md) | Associates ordered loft contours without inferring component identities or repairing topology. |
-| [SweepOrientation](../SweepOrientation.md) | Explicit profile-X frame policy; all normals are directed, and selected singular policies reject. |
-| [HeightfieldOptions](../HeightfieldOptions.md) | A closed rectilinear heightfield above a flat base, with uniform or explicit XY samples in millimetres. |
-| [HeightfieldMeshLimits](../HeightfieldMeshLimits.md) | Trusted output ceilings for pure construction; omitted fields use engine defaults. |
-| [PlanarMeshOptimizationFallbackReason](../PlanarMeshOptimizationFallbackReason.md) | Stable reason why planar optimization returned the original mesh unchanged. |
-| [NumericArray](../NumericArray.md) | Numeric storage supported by immutable generation buffers. |
-| [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. |
-| [Vector2Input](../Vector2Input.md) | An XY tuple or immutable fluent vector accepted by vector operations. |
-| [Vector3Input](../Vector3Input.md) | An XYZ tuple or immutable fluent vector accepted by vector operations. |
-| [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. |
-| [PathNormalGuide](../PathNormalGuide.md) | Supplies a profile-X orientation guide for each original normalized sweep station. |
-| [Transform2Input](../Transform2Input.md) | An immutable XY transform or its canonical row-major matrix for interchange. |
-| [Transform3Input](../Transform3Input.md) | An immutable XYZ transform or its canonical row-major matrix for interchange. |
-| [Transform2Data](../Transform2Data.md) | A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`. |
-| [Transform3Data](../Transform3Data.md) | A row-major affine 4x4 matrix applied to column vectors. |
-| [Vector2Data](../Vector2Data.md) | A two-dimensional Cartesian vector or point. |
-| [Vector3Data](../Vector3Data.md) | A three-dimensional Cartesian vector or point. |
-| [ThreadEndStyle](../ThreadEndStyle.md) | End shape of a generated helical ridge. |
-| [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. |
-| [ThreadHandedness](../ThreadHandedness.md) | Direction in which a conventional helical thread advances around +Z. |
-| [Bevel](../Bevel.md) | One size for both ends, or independent sizes in bottom/top order. Zero disables an end. |
-| [BevelSize](../BevelSize.md) | Nonnegative 45-degree axial/radial bevel size in millimetres, or factory automatic sizing. |
-| [ButtressPressureFlankSide](../ButtressPressureFlankSide.md) | Axial side carrying the near-normal pressure flank of a buttress thread. |
-| [ThreadProfileSpec](../ThreadProfileSpec.md) | Supported built-in and caller-defined thread profiles. |
+| [HeightfieldMeshLimits](../HeightfieldMeshLimits.md) | Trusted output ceilings for pure construction; omitted fields use package defaults. |
+| [LoftMeshStation](../LoftMeshStation.md) | One point-data profile at a horizontal height or explicit affine transform. |
 
 ## Values
 
@@ -142,6 +79,12 @@ Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle
 
 ## Guides
 
-- [Exact counts and preflight guarantees](../../../guides/concepts.md#check-preflight-guarantees)
+- [Exact counts and preflight guarantees](../../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Import
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/centroid.md

@@ -2,7 +2,7 @@
 
 Computes the uniform-density volume centroid of an oriented closed solid, including cavity shells.
 
-**centroid**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)): [`Vector3Data`](../geometry/Vector3Data.md)
+**centroid**(`mesh`: [`TriangleMeshInput`](TriangleMeshInput.md)): [`Vector3Data`](../geometry/Vector3Data.md)
 
 
 
@@ -14,7 +14,7 @@ Fresh mutable input is inspected on every call, and buffers are never changed.
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+**`mesh`** · [`TriangleMeshInput`](TriangleMeshInput.md) · Required
 
 Consistently oriented closed mesh with positive enclosed volume.
 
@@ -30,10 +30,15 @@ A fresh immutable XYZ volume centroid.
 ## Related APIs
 
 - [TriangleMeshInput](TriangleMeshInput.md)
-- [Vector3Data](Vector3Data.md)
 
 ## Guides
 
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/extrude.md

@@ -2,7 +2,7 @@
 
 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. End treatments are unsupported and reject at runtime. Use Section.extrude for finished ends.
 
-**extrude**(`input`: [`Path2Input`](../geometry/Path2Input.md), `options`: [`ExtrudeMeshOptions`](../geometry/ExtrudeMeshOptions.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+**extrude**(`input`: [`Path2Input`](../geometry/Path2Input.md), `options`: [`ExtrudeMeshOptions`](ExtrudeMeshOptions.md)): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -19,55 +19,62 @@ mesh.extrude(outline, { height: 8 });
 
 **`input`** · [`Path2Input`](../geometry/Path2Input.md) · Required
 
+Closed XY path or simple contour, in millimetres.
+
 
 
 <a id="options"></a>
 
-**`options`** · [`ExtrudeMeshOptions`](../geometry/ExtrudeMeshOptions.md) · Required
+**`options`** · [`ExtrudeMeshOptions`](ExtrudeMeshOptions.md) · Required
 
-- [`height`](../geometry/ExtrudeMeshOptions.md#height) · `number` · Required
+- [`height`](ExtrudeMeshOptions.md#height) · `number` · Required
 
   Positive extrusion height in millimetres.
 
-- [`center`](../geometry/ExtrudeMeshOptions.md#center) · `boolean` · Optional
-
-  Center the extrusion on Z; otherwise its bottom is at zero. Defaults to false.
-
-- [`divisions`](../geometry/ExtrudeMeshOptions.md#divisions) · `number` · Optional
+- [`slices`](ExtrudeMeshOptions.md#slices) · `number` · Optional
 
-  Exact number of intermediate profiles, nonnegative; overrides physical sampling.
+  Positive longitudinal interval count; n slices create n + 1 profile layers. Overrides ordinary extrusion's physical sampling.
 
-- [`limits`](../geometry/ExtrudeMeshOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`limits`](ExtrudeMeshOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and sampling allocation ceilings.
 
-- [`resolution`](../geometry/ExtrudeMeshOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](ExtrudeMeshOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Operation-level physical policy over the nearest model scope.
 
-- [`scaleTop`](../geometry/ExtrudeMeshOptions.md#scaletop) · `number` \| [`Vector2Input`](../geometry/Vector2Input.md) · Optional
+- [`scale`](ExtrudeMeshOptions.md#scale) · `number` \| [`Vector2Input`](../geometry/Vector2Input.md) · Optional
 
-  Finite uniform or XY scale of the top profile; defaults to one.
+  Final profile-local uniform or XY scale, interpolated from one before twisting. Both components must be positive or both zero for an apex of one simple boundary. Defaults to one.
 
-- [`twist`](../geometry/ExtrudeMeshOptions.md#twist) · `number` · Optional
+- [`twist`](ExtrudeMeshOptions.md#twist) · `number` · Optional
 
   Finite rotation of the top profile about +Z, in degrees; defaults to zero.
 
+- [`center`](ExtrudeMeshOptions.md#center) · `boolean` · Optional
+
+  Center the extrusion on Z; otherwise its bottom is at zero. Defaults to false.
+
 
 
 ## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 
 ## Related APIs
 
 - [ExtrudeMeshOptions](ExtrudeMeshOptions.md)
-- [Path2Input](Path2Input.md)
 - [TriangleMesh](TriangleMesh.md)
 
 ## Guides
 
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Import
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/heightfield.md

@@ -2,7 +2,7 @@
 
 Builds a closed indexed mesh from a rectilinear top, matched boundary walls, and flat base.
 
-**heightfield**(`options`: [`HeightfieldOptions`](../geometry/HeightfieldOptions.md), `limits?`: `Partial`\<`Pick`\<[`ModelingLimits`](../geometry/ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\>): [`TriangleMesh`](../geometry/TriangleMesh.md)
+**heightfield**(`options`: [`HeightfieldOptions`](../model/HeightfieldOptions.md), `limits?`: `Partial`\<`Pick`\<[`ModelingLimits`](../geometry/ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\>): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -23,7 +23,9 @@ Float32 storage. Explicit axes are captured before sampling; shared wall vertice
 
 <a id="options"></a>
 
-**`options`** · [`HeightfieldOptions`](../geometry/HeightfieldOptions.md) · Required
+**`options`** · [`HeightfieldOptions`](../model/HeightfieldOptions.md) · Required
+
+Grid and absolute height callback in millimetres.
 
 
 
@@ -35,17 +37,21 @@ Float32 storage. Explicit axes are captured before sampling; shared wall vertice
 
 ## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 
 ## Related APIs
 
-- [HeightfieldOptions](HeightfieldOptions.md)
-- [ModelingLimits](ModelingLimits.md)
 - [TriangleMesh](TriangleMesh.md)
 
 ## Guides
 
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Import
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/immutable.md

@@ -2,7 +2,7 @@
 
 Copies mesh buffers into immutable data; geometric validation still occurs when modeling or finalizing.
 
-**immutable**(`mesh`: `object`): [`ImmutableTriangleMesh`](../geometry/ImmutableTriangleMesh.md)
+**immutable**(`mesh`: `object`): [`ImmutableTriangleMesh`](ImmutableTriangleMesh.md)
 
 
 
@@ -11,18 +11,18 @@ Copies mesh buffers into immutable data; geometric validation still occurs when
 ```ts
 import { generate } from "@metamesh/modeling";
 import * as mesh from "@metamesh/modeling/geometry/mesh";
-const model = generate(({ computed, part }) => {
-  const surface = computed("surface", () => mesh.immutable(mesh.heightfield({
-    size: [10, 10], segments: [8, 8], height: () => 2,
-  })));
-  return [part("surface", surface)];
-});
+const buildSurface = () => mesh.immutable(mesh.heightfield({
+  size: [10, 10], segments: [8, 8], height: () => 2,
+}));
+const model = generate(({ memo, part }) => part("surface", memo(buildSurface)));
 ```
 
 ## Parameters
 
 ### mesh
 
+Triangle buffers to copy; the consumer validates topology.
+
 #### positions
 
 `Float32Array`
@@ -33,7 +33,7 @@ const model = generate(({ computed, part }) => {
 
 ## Returns
 
-[`ImmutableTriangleMesh`](../geometry/ImmutableTriangleMesh.md)
+[`ImmutableTriangleMesh`](ImmutableTriangleMesh.md)
 
 
 ## Related APIs
@@ -42,6 +42,12 @@ const model = generate(({ computed, part }) => {
 
 ## Guides
 
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Import
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/join.md

@@ -2,7 +2,7 @@
 
 Concatenates meshes into one indexed mesh without welding coincident vertices.
 
-**join**(`meshes`: readonly [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)[]): [`TriangleMesh`](../geometry/TriangleMesh.md)
+**join**(`meshes`: readonly [`TriangleMeshInput`](TriangleMeshInput.md)[]): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -12,7 +12,7 @@ Inputs are validated and never mutated. Face order and winding remain stable.
 
 <a id="meshes"></a>
 
-**`meshes`** · readonly [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)[] · Required
+**`meshes`** · readonly [`TriangleMeshInput`](TriangleMeshInput.md)[] · Required
 
 One or more meshes to concatenate.
 
@@ -20,7 +20,7 @@ One or more meshes to concatenate.
 
 ## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 Fresh typed arrays with indices offset to their source vertex ranges.
 
@@ -36,6 +36,12 @@ Fresh typed arrays with indices offset to their source vertex ranges.
 
 ## Guides
 
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/loft.md

@@ -1,8 +1,8 @@
 # loft
 
-Lofts simple point loops at z heights or explicit right-handed frames, in input order.
+Lofts simple point contours at z heights or explicit affine transforms, in input order.
 
-**loft**(`stations`: readonly [`LoftMeshStation`](../geometry/LoftMeshStation.md)[], `options?`: [`LoftOptions`](../geometry/LoftOptions.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+**loft**(`stations`: readonly [`LoftMeshStation`](LoftMeshStation.md)[], `options?`: [`LoftOptions`](../model/LoftOptions.md)): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -14,7 +14,7 @@ const top = rectangleContour({ size: [30, 20], treatment: { kind: "round", radiu
 mesh.loft([{ profile: bottom, z: 0 }, { profile: top, z: 30 }], { correspondence: "reindex" });
 ```
 
-Correspondence defaults to direct. CCW-normalized loops retain their
+Correspondence defaults to direct. CCW-normalized contours retain their
 seam and original vertices; unequal counts gain subdivisions or repeated fan slots.
 Both ends use ear-clipped caps, supporting concave profiles without center fans.
 Intermediate slices interpolate placed world vertices, never frame axes.
@@ -25,35 +25,37 @@ Path2 profiles must be closed; raw point collections are interpreted as closed.
 
 <a id="stations"></a>
 
-**`stations`** · readonly [`LoftMeshStation`](../geometry/LoftMeshStation.md)[] · Required
+**`stations`** · readonly [`LoftMeshStation`](LoftMeshStation.md)[] · Required
+
+At least two XY profiles in connection order, each with Z height or affine placement.
 
 
 
 <a id="options"></a>
 
-**`options`** · [`LoftOptions`](../geometry/LoftOptions.md) · Optional
+**`options`** · [`LoftOptions`](../model/LoftOptions.md) · Optional
 
-- [`correspondence`](../geometry/LoftOptions.md#correspondence) · [`LoftCorrespondence`](../geometry/LoftCorrespondence.md) \| readonly [`LoftCorrespondence`](../geometry/LoftCorrespondence.md)[] · Optional
+- [`correspondence`](../model/LoftOptions.md#correspondence) · [`LoftCorrespondence`](../model/LoftCorrespondence.md) \| readonly [`LoftCorrespondence`](../model/LoftCorrespondence.md)[] · Optional
 
   One method or one per consecutive station gap. Omitted preserves known primitive landmarks, including circle/ellipse-to-rectangle corners, and otherwise uses direct correspondence with the supplied seams.
 
-- [`distribution`](../geometry/LoftOptions.md#distribution) · `"perimeter"` \| `"segments"` · Optional
+- [`distribution`](../model/LoftOptions.md#distribution) · `"perimeter"` \| `"segments"` · Optional
 
   Extra points follow edge length or distribute equally across existing segments. Defaults to perimeter for direct/reindex, or segments when any distance method is selected; distance methods require segments.
 
-- [`refine`](../geometry/LoftOptions.md#refine) · `number` \| readonly `number`[] · Optional
+- [`refine`](../model/LoftOptions.md#refine) · `number` \| readonly `number`[] · Optional
 
   Positive integer point-density multiplier, uniformly or per input profile. Original vertices are retained. Defaults to one.
 
-- [`slices`](../geometry/LoftOptions.md#slices) · `number` \| readonly `number`[] · Optional
+- [`slices`](../model/LoftOptions.md#slices) · `number` \| readonly `number`[] · Optional
 
-  Nonnegative count of world-linearly interpolated profiles, uniformly or per gap. Defaults to zero.
+  Positive longitudinal interval count, uniformly or per supplied station gap. Each gap with n slices has n - 1 inserted profiles. Defaults to one; placed world vertices interpolate linearly.
 
-- [`resolution`](../geometry/LoftOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](../model/LoftOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Physical curve policy for retained primitives, and maximum edge length for point data. Exact primitive curve counts take precedence.
 
-- [`limits`](../geometry/LoftOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`limits`](../model/LoftOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and sampling budgets; native operations may only lower host ceilings.
 
@@ -61,17 +63,22 @@ Path2 profiles must be closed; raw point collections are interpreted as closed.
 
 ## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 
 ## Related APIs
 
 - [LoftMeshStation](LoftMeshStation.md)
-- [LoftOptions](LoftOptions.md)
 - [TriangleMesh](TriangleMesh.md)
 
 ## Guides
 
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Import
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/optimizePlanarPatches.md

@@ -2,7 +2,7 @@
 
 Improves pathological planar triangulation with bounded legal diagonal flips.
 
-**optimizePlanarPatches**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `options?`: [`PlanarMeshOptimizationOptions`](../geometry/PlanarMeshOptimizationOptions.md)): [`PlanarMeshOptimizationResult`](../geometry/PlanarMeshOptimizationResult.md)
+**optimizePlanarPatches**(`mesh`: [`TriangleMeshInput`](TriangleMeshInput.md), `options?`: [`PlanarMeshOptimizationOptions`](PlanarMeshOptimizationOptions.md)): [`PlanarMeshOptimizationResult`](PlanarMeshOptimizationResult.md)
 
 
 
@@ -17,60 +17,60 @@ results. Malformed buffers and the configured analysis complexity limit throw.
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+**`mesh`** · [`TriangleMeshInput`](TriangleMeshInput.md) · Required
 
-Closed, consistently wound indexed triangle mesh in arbitrary consistent units.
+Closed, consistently wound mesh in consistent units.
 
 
 
 <a id="options"></a>
 
-**`options`** · [`PlanarMeshOptimizationOptions`](../geometry/PlanarMeshOptimizationOptions.md) · Optional
+**`options`** · [`PlanarMeshOptimizationOptions`](PlanarMeshOptimizationOptions.md) · Optional
 
 Patch eligibility, numeric tolerance, and deterministic work bounds.
 
-- [`maxFlipAttempts`](../geometry/PlanarMeshOptimizationOptions.md#maxflipattempts) · `number` · Optional
+- [`maxFlipAttempts`](PlanarMeshOptimizationOptions.md#maxflipattempts) · `number` · Optional
 
   Maximum attempted edge evaluations. By default this is twenty times the initial candidate
   edge count, capped at `1000000`.
 
-- [`maxEdgeRevisits`](../geometry/PlanarMeshOptimizationOptions.md#maxedgerevisits) · `number` · Optional
+- [`maxEdgeRevisits`](PlanarMeshOptimizationOptions.md#maxedgerevisits) · `number` · Optional
 
   Maximum times one edge may be reconsidered after neighbouring flips. Defaults to `12`.
 
-- [`maxPatchTriangles`](../geometry/PlanarMeshOptimizationOptions.md#maxpatchtriangles) · `number` · Optional
+- [`maxPatchTriangles`](PlanarMeshOptimizationOptions.md#maxpatchtriangles) · `number` · Optional
 
   Maximum triangles allowed in one selected patch. Defaults to `50000`.
 
-- [`maxProcessedTriangles`](../geometry/PlanarMeshOptimizationOptions.md#maxprocessedtriangles) · `number` · Optional
+- [`maxProcessedTriangles`](PlanarMeshOptimizationOptions.md#maxprocessedtriangles) · `number` · Optional
 
   Maximum cumulative triangles across selected patches. Defaults to `200000`.
 
-- [`minPatchTriangles`](../geometry/PlanarMeshOptimizationOptions.md#minpatchtriangles) · `number` · Optional
+- [`minPatchTriangles`](PlanarMeshOptimizationOptions.md#minpatchtriangles) · `number` · Optional
 
   Minimum triangles required before a planar patch is eligible. Defaults to `8`.
 
-- [`triggerMaxAspectRatio`](../geometry/PlanarMeshOptimizationOptions.md#triggermaxaspectratio) · `number` · Optional
+- [`triggerMaxAspectRatio`](PlanarMeshOptimizationOptions.md#triggermaxaspectratio) · `number` · Optional
 
   Select patches whose worst normalized aspect ratio exceeds this value. Defaults to `12`.
 
-- [`triggerMaxFanRatio`](../geometry/PlanarMeshOptimizationOptions.md#triggermaxfanratio) · `number` · Optional
+- [`triggerMaxFanRatio`](PlanarMeshOptimizationOptions.md#triggermaxfanratio) · `number` · Optional
 
   Select patches whose largest per-vertex triangle share exceeds this ratio. Defaults to `0.2`.
 
-- [`triggerMaxVertexTriangleIncidence`](../geometry/PlanarMeshOptimizationOptions.md#triggermaxvertextriangleincidence) · `number` · Optional
+- [`triggerMaxVertexTriangleIncidence`](PlanarMeshOptimizationOptions.md#triggermaxvertextriangleincidence) · `number` · Optional
 
   Select patches whose largest vertex triangle incidence exceeds this value. Defaults to `16`.
 
-- [`triggerMinAngleDegrees`](../geometry/PlanarMeshOptimizationOptions.md#triggerminangledegrees) · `number` · Optional
+- [`triggerMinAngleDegrees`](PlanarMeshOptimizationOptions.md#triggerminangledegrees) · `number` · Optional
 
   Select patches whose smallest interior angle is below this many degrees. Defaults to `8`.
 
-- [`maxTriangles`](../geometry/PlanarMeshOptimizationOptions.md#maxtriangles) · `number` · Optional
+- [`maxTriangles`](PlanarMeshOptimizationOptions.md#maxtriangles) · `number` · Optional
 
   Maximum number of triangles inspected. Defaults to `200000`.
 
-- [`tolerance`](../geometry/PlanarMeshOptimizationOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+- [`tolerance`](PlanarMeshOptimizationOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Numeric comparison overrides; model coordinates are interpreted in their existing units.
 
@@ -78,7 +78,7 @@ Patch eligibility, numeric tolerance, and deterministic work bounds.
 
 ## Returns
 
-[`PlanarMeshOptimizationResult`](../geometry/PlanarMeshOptimizationResult.md)
+[`PlanarMeshOptimizationResult`](PlanarMeshOptimizationResult.md)
 
 Optimized connectivity and before/after diagnostics, or an unchanged safe fallback.
 
@@ -91,6 +91,12 @@ Optimized connectivity and before/after diagnostics, or an unchanged safe fallba
 
 ## Guides
 
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.20.0`.