@metamesh/modeling 0.18.0 → 0.20.0

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

@@ -2,7 +2,7 @@
 
 Checks grid options, Float32 axis precision, and output limits; returns exact mesh buffer counts.
 
-**preflightHeightfield**(`options`: [`HeightfieldOptions`](../geometry/HeightfieldOptions.md), `limits?`: `Partial`\<`Pick`\<[`ModelingLimits`](../geometry/ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\>): [`HeightfieldPreflight`](../geometry/HeightfieldPreflight.md)
+**preflightHeightfield**(`options`: [`HeightfieldOptions`](../model/HeightfieldOptions.md), `limits?`: `Partial`\<`Pick`\<[`ModelingLimits`](../geometry/ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\>): [`HeightfieldPreflight`](HeightfieldPreflight.md)
 
 
 
@@ -14,7 +14,9 @@ construction. `byteCount` covers position and index buffers, not total working m
 
 <a id="options"></a>
 
-**`options`** · [`HeightfieldOptions`](../geometry/HeightfieldOptions.md) · Required
+**`options`** · [`HeightfieldOptions`](../model/HeightfieldOptions.md) · Required
+
+Grid in millimetres; the height callback is not evaluated.
 
 
 
@@ -26,17 +28,21 @@ construction. `byteCount` covers position and index buffers, not total working m
 
 ## Returns
 
-[`HeightfieldPreflight`](../geometry/HeightfieldPreflight.md)
+[`HeightfieldPreflight`](HeightfieldPreflight.md)
 
 
 ## Related APIs
 
-- [HeightfieldOptions](HeightfieldOptions.md)
 - [HeightfieldPreflight](HeightfieldPreflight.md)
-- [ModelingLimits](ModelingLimits.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/preflightThreadSolid.md

@@ -2,7 +2,7 @@
 
 Checks thread dimensions, profile, end treatments, sampling, and conservative estimates against output limits.
 
-**preflightThreadSolid**(`options`: [`ThreadSolidOptions`](../geometry/ThreadSolidOptions.md)): [`ThreadSolidPreflight`](../geometry/ThreadSolidPreflight.md)
+**preflightThreadSolid**(`options`: [`ThreadSolidOptions`](../mechanical/ThreadSolidOptions.md)): [`ThreadSolidPreflight`](../mechanical/ThreadSolidPreflight.md)
 
 
 
@@ -16,58 +16,60 @@ See `mesh.threadSolid` for standalone mesh construction.
 
 <a id="options"></a>
 
-**`options`** · [`ThreadSolidOptions`](../geometry/ThreadSolidOptions.md) · Required
+**`options`** · [`ThreadSolidOptions`](../mechanical/ThreadSolidOptions.md) · Required
 
-- [`length`](../geometry/ThreadSolidOptions.md#length) · `number` · Required
+Dimensions in millimetres and a validated profile; apply any fit compensation first.
+
+- [`length`](../mechanical/ThreadSolidOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
 
-- [`majorDiameter`](../geometry/ThreadSolidOptions.md#majordiameter) · `number` · Required
+- [`majorDiameter`](../mechanical/ThreadSolidOptions.md#majordiameter) · `number` · Required
 
-  Nominal major diameter before any caller-owned fit compensation.
+  Major diameter in millimetres; apply any caller-owned fit compensation before construction.
 
-- [`profile`](../geometry/ThreadSolidOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
+- [`profile`](../mechanical/ThreadSolidOptions.md#profile) · [`ThreadProfile`](../mechanical/ThreadProfile-type.md) · Required
 
   Validated periodic profile repeated around the shaft.
 
-- [`ends`](../geometry/ThreadSolidOptions.md#ends) · [`ThreadEndTreatmentOptions`](../geometry/ThreadEndTreatmentOptions.md) · Optional
+- [`ends`](../mechanical/ThreadSolidOptions.md#ends) · [`ThreadEndTreatmentOptions`](../mechanical/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`](../geometry/ThreadSolidOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
+- [`handedness`](../mechanical/ThreadSolidOptions.md#handedness) · [`ThreadHandedness`](../mechanical/ThreadHandedness.md) · Optional
 
   Helix direction. Default: `right`.
 
-- [`limits`](../geometry/ThreadSolidOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`limits`](../mechanical/ThreadSolidOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and circular allocation ceilings.
 
-- [`phase`](../geometry/ThreadSolidOptions.md#phase) · `number` · Optional
+- [`phase`](../mechanical/ThreadSolidOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
-- [`resolution`](../geometry/ThreadSolidOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](../mechanical/ThreadSolidOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Optional circular-resolution policy.
 
-- [`starts`](../geometry/ThreadSolidOptions.md#starts) · `number` · Optional
+- [`starts`](../mechanical/ThreadSolidOptions.md#starts) · `number` · Optional
 
   Number of evenly phased starts. Default: `1`.
 
-- [`tolerance`](../geometry/ThreadSolidOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../mechanical/ThreadSolidOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Optional numerical tolerance overrides.
 
-- [`bevel`](../geometry/ThreadSolidOptions.md#bevel) · [`Bevel`](../geometry/Bevel.md) · Optional
+- [`bevel`](../mechanical/ThreadSolidOptions.md#bevel) · [`Bevel`](../mechanical/Bevel.md) · Optional
 
   Independent 45-degree bottom/top bevels; omitted disables both. Auto uses profile depth.
 
-- [`bevelOffset`](../geometry/ThreadSolidOptions.md#beveloffset) · `number` · Optional
+- [`bevelOffset`](../mechanical/ThreadSolidOptions.md#beveloffset) · `number` · Optional
 
-  Distance of each bevel target face inward from the corresponding mesh end.
+  Distance in millimetres of each bevel target face inward from the corresponding mesh end.
 
-- [`bevelMode`](../geometry/ThreadSolidOptions.md#bevelmode) · `"inset"` \| `"outset"` · Optional
+- [`bevelMode`](../mechanical/ThreadSolidOptions.md#bevelmode) · `"inset"` \| `"outset"` · Optional
 
   `inset` trims an external rod; `outset` expands an internal cutter.
 
@@ -75,16 +77,17 @@ See `mesh.threadSolid` for standalone mesh construction.
 
 ## Returns
 
-[`ThreadSolidPreflight`](../geometry/ThreadSolidPreflight.md)
+[`ThreadSolidPreflight`](../mechanical/ThreadSolidPreflight.md)
 
 
-## Related APIs
+## Guides
 
-- [ThreadSolidOptions](ThreadSolidOptions.md)
-- [ThreadSolidPreflight](ThreadSolidPreflight.md)
+- [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Guides
+## Import
 
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+```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/render.md

@@ -0,0 +1,59 @@
+# render
+
+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.
+
+**render**(`input`: [`TriangleMeshInput`](TriangleMeshInput.md), `options?`: [`MeshRenderOptions`](MeshRenderOptions.md)): [`RenderMesh`](RenderMesh.md)
+
+
+
+## Example
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+const surface = mesh.heightfield({ size: [10, 10], segments: [2, 2], height: () => 0 });
+const rendered = mesh.render(surface);
+// rendered.positions and rendered.normals can be passed to a renderer or GLB writer.
+```
+
+## Parameters
+
+<a id="input"></a>
+
+**`input`** · [`TriangleMeshInput`](TriangleMeshInput.md) · Required
+
+Indexed mesh to copy; source buffers remain unchanged.
+
+
+
+<a id="options"></a>
+
+**`options`** · [`MeshRenderOptions`](MeshRenderOptions.md) · Optional
+
+- [`creaseAngle`](MeshRenderOptions.md#creaseangle) · `number` · Optional
+
+  Maximum angle between averaged face normals, in degrees. Defaults to `20`; `0` is flat.
+
+
+
+## Returns
+
+[`RenderMesh`](RenderMesh.md)
+
+
+## Related APIs
+
+- [MeshRenderOptions](MeshRenderOptions.md)
+- [RenderMesh](RenderMesh.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
+
+## Guides
+
+- [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.20.0`.

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

@@ -2,7 +2,7 @@
 
 Returns a copy of a mesh with every triangle winding reversed.
 
-**reverse**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+**reverse**(`mesh`: [`TriangleMeshInput`](TriangleMeshInput.md)): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -10,7 +10,7 @@ Returns a copy of a mesh with every triangle winding reversed.
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+**`mesh`** · [`TriangleMeshInput`](TriangleMeshInput.md) · Required
 
 Mesh to copy and reverse.
 
@@ -18,7 +18,7 @@ Mesh to copy and reverse.
 
 ## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 Fresh position and index buffers; the input remains unchanged.
 
@@ -30,6 +30,12 @@ Fresh position and index buffers; the input remains unchanged.
 
 ## 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/revolve.md

@@ -2,7 +2,7 @@
 
 Revolves a non-duplicated closed `[radius, z]` profile around +Z.
 
-`const` **revolve**: (`input`: [`Path2Input`](../geometry/Path2Input.md), `options?`: [`RevolveOptions`](../geometry/RevolveOptions.md)) => [`TriangleMesh`](../geometry/TriangleMesh.md)
+`const` **revolve**: (`input`: [`Path2Input`](../geometry/Path2Input.md), `options?`: [`RevolveOptions`](../model/RevolveOptions.md)) => [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -27,26 +27,26 @@ mesh.revolve([[0, 0], [12, 0], [8, 20], [0, 20]], { degrees: 270 });
 
 **`input`** · [`Path2Input`](../geometry/Path2Input.md) · Required
 
+Closed `[radius, Z]` profile in millimetres; radii must be non-negative.
 
 
-<a id="options"></a>
 
-**`options`** · [`RevolveOptions`](../geometry/RevolveOptions.md) · Optional
+<a id="options"></a>
 
-Optional physical or exact circumferential sampling controls. Defaults to `{}`.
+**`options`** · [`RevolveOptions`](../model/RevolveOptions.md) · Optional
 
-- [`segments`](../geometry/RevolveOptions.md#segments) · `number` · Optional
+- [`segments`](../model/RevolveOptions.md#segments) · `number` · Optional
 
   Exact circumferential segment count from three through the configured safety limit.
 
   This local topology override takes precedence over [CircularPrimitiveOptions.resolution](../geometry/CircularPrimitiveOptions.md#resolution)
   and any active model-wide resolution policy.
 
-- [`resolution`](../geometry/RevolveOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](../model/RevolveOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Operation-level physical tessellation policy over the active model-wide policy.
 
-- [`degrees`](../geometry/RevolveOptions.md#degrees) · `number` · Optional · Default: `360`
+- [`degrees`](../model/RevolveOptions.md#degrees) · `number` · Optional · Default: `360`
 
   Positive sweep in degrees, no greater than 360. Defaults to a full revolution;
   smaller sweeps form partial revolutions with end caps.
@@ -54,7 +54,7 @@ Optional physical or exact circumferential sampling controls. Defaults to `{}`.
   revolutions require at least three sweep intervals: adaptive sampling refines to that floor,
   while exact counts that imply fewer intervals reject. Pure mesh.revolve supports one interval.
 
-- [`limits`](../geometry/RevolveOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`limits`](../model/RevolveOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and sampling allocation ceilings.
 
@@ -62,19 +62,23 @@ Optional physical or exact circumferential sampling controls. Defaults to `{}`.
 
 ## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 A closed indexed triangle mesh revolved counter-clockwise around +Z.
 
 
 ## Related APIs
 
-- [Path2Input](Path2Input.md)
-- [RevolveOptions](RevolveOptions.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/signature.md

@@ -2,7 +2,7 @@
 
 Creates an order-independent regression signature for a manufacturing mesh.
 
-**signature**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `options?`: [`TriangleMeshSignatureOptions`](../geometry/TriangleMeshSignatureOptions.md)): [`TriangleMeshSignature`](../geometry/TriangleMeshSignature.md)
+**signature**(`mesh`: [`TriangleMeshInput`](TriangleMeshInput.md), `options?`: [`TriangleMeshSignatureOptions`](TriangleMeshSignatureOptions.md)): [`TriangleMeshSignature`](TriangleMeshSignature.md)
 
 
 
@@ -14,7 +14,7 @@ connectivity metrics do. The fingerprint is a regression aid, not a cryptographi
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+**`mesh`** · [`TriangleMeshInput`](TriangleMeshInput.md) · Required
 
 Closed oriented mesh to measure without mutation.
 
@@ -22,19 +22,19 @@ Closed oriented mesh to measure without mutation.
 
 <a id="options"></a>
 
-**`options`** · [`TriangleMeshSignatureOptions`](../geometry/TriangleMeshSignatureOptions.md) · Optional
+**`options`** · [`TriangleMeshSignatureOptions`](TriangleMeshSignatureOptions.md) · Optional
 
 Absolute quantization and complexity limits.
 
-- [`maxTriangles`](../geometry/TriangleMeshSignatureOptions.md#maxtriangles) · `number` · Optional
+- [`maxTriangles`](TriangleMeshSignatureOptions.md#maxtriangles) · `number` · Optional
 
   Maximum accepted triangle count. Defaults to 200,000.
 
-- [`positionTolerance`](../geometry/TriangleMeshSignatureOptions.md#positiontolerance) · `number` · Optional
+- [`positionTolerance`](TriangleMeshSignatureOptions.md#positiontolerance) · `number` · Optional
 
   Position and bounds quantization in model units. Defaults to `1e-5`.
 
-- [`volumeTolerance`](../geometry/TriangleMeshSignatureOptions.md#volumetolerance) · `number` · Optional
+- [`volumeTolerance`](TriangleMeshSignatureOptions.md#volumetolerance) · `number` · Optional
 
   Signed-volume quantization in cubic model units. Defaults to `1e-4`.
 
@@ -42,7 +42,7 @@ Absolute quantization and complexity limits.
 
 ## Returns
 
-[`TriangleMeshSignature`](../geometry/TriangleMeshSignature.md)
+[`TriangleMeshSignature`](TriangleMeshSignature.md)
 
 Compact counts, bounds, volume, topology, tolerances, and canonical fingerprint.
 
@@ -59,6 +59,12 @@ Compact counts, bounds, volume, topology, tolerances, and canonical fingerprint.
 
 ## 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/sweep.md

@@ -1,8 +1,12 @@
 # sweep
 
-Sweeps one explicitly ordered point loop, with caps or a geometrically matching closed seam.
+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.
 
-**sweep**(`profile`: [`Path2Input`](../geometry/Path2Input.md), `path`: [`Path3Input`](../geometry/Path3Input.md), `options?`: [`SweepOptions`](../geometry/SweepOptions.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+## Call Signature
+
+
+
+**sweep**(`profile`: [`Path2Input`](../geometry/Path2Input.md), `path`: [`Path3Input`](../geometry/Path3Input.md), `options?`: [`SweepOptions`](../model/SweepOptions.md)): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -15,72 +19,145 @@ mesh.sweep(profile, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 });
 ```
 
-## Parameters
+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.
+
+### Parameters
 
 <a id="profile"></a>
 
 **`profile`** · [`Path2Input`](../geometry/Path2Input.md) · Required
 
+Closed XY path or simple contour, in millimetres.
+
 
 
 <a id="path"></a>
 
 **`path`** · [`Path3Input`](../geometry/Path3Input.md) · Required
 
+Ordered XYZ path in millimetres; a Path3 supplies its closure.
+
 
 
 <a id="options"></a>
 
-**`options`** · [`SweepOptions`](../geometry/SweepOptions.md) · Optional
+**`options`** · [`SweepOptions`](../model/SweepOptions.md) · Optional
 
-- [`closed`](../geometry/SweepOptions.md#closed) · `boolean` · Optional
+- [`closed`](../model/SweepOptions.md#closed) · `boolean` · Optional
 
   Raw point closure defaults to false; a Path3 supplies its closure and rejects conflicts.
 
-- [`limits`](../geometry/SweepOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`limits`](../model/SweepOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and sampling allocation ceilings.
 
-- [`orientation`](../geometry/SweepOptions.md#orientation) · [`SweepOrientation`](../geometry/SweepOrientation.md) · Optional
+- [`orientation`](../model/SweepOptions.md#orientation) · [`SweepOrientation`](../model/SweepOrientation.md) · Optional
 
-  Explicit frame policy; default transport minimizes rotations, initially projecting +X then +Y then +Z.
+  Default transport minimizes rotations, initially projecting +X then +Y then +Z.
 
-- [`resolution`](../geometry/SweepOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](../model/SweepOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
-  Physical sampling of nonzero twist; inserted stations retain authored station controls.
+  Physical sampling of twist and varying scale, plus optional segment-length limits. Inserted stations retain authored controls.
 
-- [`twist`](../geometry/SweepOptions.md#twist) · `number` · Optional
+- [`twist`](../model/SweepOptions.md#twist) · `number` · Optional
 
-  Total additional profile rotation in degrees, with progression selected by twistBy.
+  Total additional profile rotation in degrees; compatible closed boundaries are aligned automatically.
 
-- [`twistBy`](../geometry/SweepOptions.md#twistby) · `"length"` \| `"stations"` · Optional
+- [`twistBy`](../model/SweepOptions.md#twistby) · `"length"` \| `"stations"` · Optional
 
   Twist advances by physical path length (default), or normalized authored station position, including a closed seam gap.
 
-- [`scale`](../geometry/SweepOptions.md#scale) · `number` \| [`Vector2Input`](../geometry/Vector2Input.md) \| readonly [`Vector2Input`](../geometry/Vector2Input.md)[] · Optional
+- [`scale`](../model/SweepOptions.md#scale) · `number` \| [`Vector2Input`](../geometry/Vector2Input.md) \| readonly [`Vector2Input`](../geometry/Vector2Input.md)[] · Optional
+
+  Positive final uniform/XY scale on open paths, interpolated from one by path length. Closed paths use a uniform scale. Explicit XY pairs set each original station; omitted is one.
+
+
+
+### Returns
+
+[`TriangleMesh`](TriangleMesh.md)
+
+## Call Signature
+
+
+
+**sweep**(`profile`: [`Path2Input`](../geometry/Path2Input.md), `transforms`: readonly [`Transform3Input`](../geometry/Transform3Input.md)[], `options?`: [`SweepTransformOptions`](../model/SweepTransformOptions.md)): [`TriangleMesh`](TriangleMesh.md)
+
+
+
+Connects one point loop through exactly the supplied affine placements.
+
+### Parameters
+
+<a id="profile-1"></a>
+
+**`profile`** · [`Path2Input`](../geometry/Path2Input.md) · Required
+
+Closed XY path or simple contour, in millimetres.
+
 
-  Positive uniform/XY scale, or one XY pair per path station. Defaults to one.
 
-- [`seamProfileOffset`](../geometry/SweepOptions.md#seamprofileoffset) · `number` · Optional
+<a id="transforms"></a>
 
-  Corresponding point-index advance at a rotationally equivalent closed seam.
+**`transforms`** · readonly [`Transform3Input`](../geometry/Transform3Input.md)[] · Required
 
+Affine placements in connection order; at least two when open, three when closed.
 
 
-## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+<a id="options-1"></a>
+
+**`options`** · [`SweepTransformOptions`](../model/SweepTransformOptions.md) · Optional
+
+- [`closed`](../model/SweepTransformOptions.md#closed) · `boolean` · Optional
+
+  Connect the last supplied station to the first without caps. Defaults to false.
+
+- [`limits`](../model/SweepTransformOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+
+  Explicit output and station allocation ceilings.
+
+- [`orientation`](../model/SweepTransformOptions.md#orientation) · `undefined` · Optional
+
+  Encoded by the explicit transforms.
+
+- [`resolution`](../model/SweepTransformOptions.md#resolution) · `undefined` · Optional
+
+  Explicit stations are never refined.
+
+- [`twist`](../model/SweepTransformOptions.md#twist) · `undefined` · Optional
+
+  Encoded by the explicit transforms.
+
+- [`twistBy`](../model/SweepTransformOptions.md#twistby) · `undefined` · Optional
+
+  Encoded by the explicit transforms.
+
+- [`scale`](../model/SweepTransformOptions.md#scale) · `undefined` · Optional
+
+  Encoded by the explicit transforms.
+
+
+
+### Returns
+
+[`TriangleMesh`](TriangleMesh.md)
 
 
 ## Related APIs
 
-- [Path2Input](Path2Input.md)
-- [Path3Input](Path3Input.md)
-- [SweepOptions](SweepOptions.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`.