@metamesh/modeling 0.14.0 → 0.16.0

package/dist/docs/reference/model/polygon.md

@@ -1,8 +1,8 @@
 # polygon
 
-Fills one closed millimetre XY outline, explicit outer/hole topology, or compound contours. Closing edges are implicit. Compound contours use nonzero fill unless selected otherwise. Explicit topology must be simple and disjoint; compound winding may resolve overlaps.
+Fills one closed millimetre XY outline, explicit outer/hole topology, or compound contours.
 
-**polygon**(`input`: [`Contour`](Contour.md) \| [`PolygonOptions`](PolygonOptions.md)): [`Section`](Section.md)
+**polygon**(`input`: [`Path2Input`](Path2Input.md) \| [`PolygonOptions`](PolygonOptions.md)): [`Section`](Section.md)
 
 
 
@@ -12,11 +12,14 @@ Fills one closed millimetre XY outline, explicit outer/hole topology, or compoun
 polygon([[0, 0], [20, 0], [10, 12]]).extrude({ height: 3 });
 ```
 
+Closing edges are implicit. Compound contours use nonzero fill unless selected otherwise.
+Explicit topology must be simple and disjoint; compound winding may resolve overlaps.
+
 ## Parameters
 
 <a id="input"></a>
 
-**`input`** · [`Contour`](Contour.md) \| [`PolygonOptions`](PolygonOptions.md) · Required
+**`input`** · [`Path2Input`](Path2Input.md) \| [`PolygonOptions`](PolygonOptions.md) · Required
 
 
 
@@ -27,7 +30,7 @@ polygon([[0, 0], [20, 0], [10, 12]]).extrude({ height: 3 });
 
 ## Related APIs
 
-- [Contour](Contour.md)
+- [Path2Input](Path2Input.md)
 - [PolygonOptions](PolygonOptions.md)
 - [Section](Section.md)
 
@@ -37,4 +40,4 @@ polygon([[0, 0], [20, 0], [10, 12]]).extrude({ height: 3 });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/preflightInternalThreadCutter.md

@@ -1,11 +1,15 @@
 # preflightInternalThreadCutter
 
-Allocation-free internal-thread facts.
+Checks compensated cutter dimensions and conservative mesh estimates against host output limits.
 
 **preflightInternalThreadCutter**(`options`: [`InternalThreadCutterOptions`](InternalThreadCutterOptions.md)): [`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
 
 
 
+Requires active synchronous model execution and uses its resolution and limits. Estimates include
+the one-pitch extension beyond each requested face, without mesh buffers or native objects.
+Mesh validity, native construction, and aggregate output limits are checked later.
+
 ## Parameters
 
 <a id="options"></a>
@@ -37,7 +41,7 @@ Allocation-free internal-thread facts.
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](InternalThreadCutterOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](InternalThreadCutterOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -81,9 +85,11 @@ Allocation-free internal-thread facts.
 
 - [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
 - [InternalThreadCutterOptions](InternalThreadCutterOptions.md)
+- [internalThreadCutter](internalThreadCutter.md)
 
 ## Guides
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/preflightThreadedNut.md

@@ -1,11 +1,15 @@
 # preflightThreadedNut
 
-Allocation-free nut/cutter facts.
+Checks nut dimensions, chamfers, end-face wall, and the extended compensated cutter's allocation plan.
 
 **preflightThreadedNut**(`options`: [`ThreadedNutOptions`](ThreadedNutOptions.md)): [`ThreadedNutPreflight`](ThreadedNutPreflight.md)
 
 
 
+Requires active synchronous model execution and uses its resolution and limits, without mesh
+buffers or native objects. Returned thread estimates cover the cutter, excluding the body and
+Boolean result. Mesh validity, native construction, and aggregate output limits are checked later.
+
 ## Parameters
 
 <a id="options"></a>
@@ -45,7 +49,7 @@ Allocation-free nut/cutter facts.
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](ThreadedNutOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](ThreadedNutOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -92,9 +96,11 @@ Allocation-free nut/cutter facts.
 
 - [ThreadedNutOptions](ThreadedNutOptions.md)
 - [ThreadedNutPreflight](ThreadedNutPreflight.md)
+- [threadedNut](threadedNut.md)
 
 ## Guides
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/preflightThreadedRod.md

@@ -1,11 +1,15 @@
 # preflightThreadedRod
 
-Allocation-free external-thread facts.
+Checks compensated rod dimensions and conservative mesh estimates against host output limits.
 
 **preflightThreadedRod**(`options`: [`ThreadedRodOptions`](ThreadedRodOptions.md)): [`HelicalThreadSolidMeshPreflight`](HelicalThreadSolidMeshPreflight.md)
 
 
 
+Requires active synchronous model execution and uses its resolution and limits. Returns selected
+sampling and conservative row/triangle estimates without mesh buffers or native objects.
+Mesh validity, native construction, and aggregate output limits are checked later.
+
 ## Parameters
 
 <a id="options"></a>
@@ -37,7 +41,7 @@ Allocation-free external-thread facts.
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](ThreadedRodOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](ThreadedRodOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -81,9 +85,11 @@ Allocation-free external-thread facts.
 
 - [HelicalThreadSolidMeshPreflight](HelicalThreadSolidMeshPreflight.md)
 - [ThreadedRodOptions](ThreadedRodOptions.md)
+- [threadedRod](threadedRod.md)
 
 ## Guides
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/radialPattern.md

@@ -14,7 +14,7 @@ Repeats one solid about an axis.
 
 ```ts
 const pin = cylinder({ height: 6, radius: 2 }).translate([12, 0, 0]);
-radialPattern(pin, { count: 6, axis: [0, 0, 1], angleDegrees: 60 });
+radialPattern(pin, { count: 6, axis: [0, 0, 1], angle: 60 });
 ```
 
 Repeats one solid about an axis.
@@ -31,22 +31,6 @@ Repeats one solid about an axis.
 
 **`options`** · [`RadialPatternOptions`](RadialPatternOptions.md) · Required
 
-- [`count`](RadialPatternOptions.md#count) · `number` · Required
-
-  Number of solids to return, including the original.
-
-- [`axis`](RadialPatternOptions.md#axis) · [`Vector3Tuple`](Vector3Tuple.md) · Required
-
-  Axis of the right-handed rotation. Its magnitude is ignored.
-
-- [`angleDegrees`](RadialPatternOptions.md#angledegrees) · `number` · Required
-
-  Signed rotation from one copy to the next, in degrees.
-
-- [`center`](RadialPatternOptions.md#center) · [`Vector3Tuple`](Vector3Tuple.md) · Optional
-
-  Rotation center in world coordinates. Defaults to the origin.
-
 
 
 ### Returns
@@ -57,11 +41,11 @@ readonly [`Solid`](Solid.md)[]
 
 
 
-**radialPattern**(`source`: [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\>, `options`: [`RadialPatternOptions`](RadialPatternOptions.md)): readonly [`Section`](Section.md)[]
+**radialPattern**(`source`: [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\>, `options`: [`RadialPatternOptions`](RadialPatternOptions.md)\<`2`\>): readonly [`Section`](Section.md)[]
 
 
 
-Repeats a filled Section about an axis; placements must preserve its XY plane.
+Repeats a filled Section counterclockwise about a fixed XY pivot, using the implicit +Z axis.
 
 ### Parameters
 
@@ -73,23 +57,7 @@ Repeats a filled Section about an axis; placements must preserve its XY plane.
 
 <a id="options-1"></a>
 
-**`options`** · [`RadialPatternOptions`](RadialPatternOptions.md) · Required
-
-- [`count`](RadialPatternOptions.md#count) · `number` · Required
-
-  Number of solids to return, including the original.
-
-- [`axis`](RadialPatternOptions.md#axis) · [`Vector3Tuple`](Vector3Tuple.md) · Required
-
-  Axis of the right-handed rotation. Its magnitude is ignored.
-
-- [`angleDegrees`](RadialPatternOptions.md#angledegrees) · `number` · Required
-
-  Signed rotation from one copy to the next, in degrees.
-
-- [`center`](RadialPatternOptions.md#center) · [`Vector3Tuple`](Vector3Tuple.md) · Optional
-
-  Rotation center in world coordinates. Defaults to the origin.
+**`options`** · [`RadialPatternOptions`](RadialPatternOptions.md)\<`2`\> · Required
 
 
 
@@ -109,5 +77,6 @@ readonly [`Section`](Section.md)[]
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/rectangle.md

@@ -12,19 +12,22 @@ Filled rectangular section with uniform or independently treated corners.
 rectangle({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 ```
 
+Use [rectangleContour](../geometry/rectangleContour.md) for sampled boundary coordinates,
+or [rectangleProfile](../geometry/rectangleProfile.md) to retain identified loft landmarks.
+
 ## Parameters
 
 <a id="options"></a>
 
 **`options`** · [`RectangleOptions`](RectangleOptions.md) · Required
 
-- [`size`](RectangleOptions.md#size) · `number` \| [`Vector2Tuple`](Vector2Tuple.md) · Required
+- [`size`](RectangleOptions.md#size) · `number` \| [`Vector2Data`](Vector2Data.md) · Required
 
   Positive uniform size or explicit XY extents in millimetres.
 
-- [`placement`](RectangleOptions.md#placement) · [`PrimitivePlacementOptions`](PrimitivePlacementOptions.md) · Optional
+- [`attachment`](RectangleOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
 
-  Applied after local construction; Section placement must preserve the XY plane.
+  Applied after local construction; Section attachment must preserve the XY plane.
 
 - [`center`](RectangleOptions.md#center) · `boolean` · Optional
 
@@ -56,4 +59,4 @@ rectangle({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/regularPolygon.md

@@ -36,4 +36,4 @@ regularPolygon({ radius: 10, sides: 6, sizing: "face" });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/revolve.md

@@ -14,7 +14,7 @@ import { rectangleProfile } from "@metamesh/modeling/geometry";
 
 // Contour coordinates are [radius, Z].
 const [profile] = matchProfiles([rectangleProfile({ size: [4, 16], center: false })]);
-revolve(profile!, { revolveDegrees: 270 });
+revolve(profile!, { degrees: 270 });
 ```
 
 ## Parameters
@@ -40,9 +40,10 @@ revolve(profile!, { revolveDegrees: 270 });
 
   Operation-level physical tessellation policy over the active model-wide policy.
 
-- [`revolveDegrees`](RevolveOptions.md#revolvedegrees) · `number` · Optional
+- [`degrees`](RevolveOptions.md#degrees) · `number` · Optional · Default: `360`
 
-  Positive angular sweep no greater than 360 degrees; partial revolutions have end caps.
+  Positive sweep in degrees, no greater than 360. Defaults to a full revolution;
+  smaller sweeps form partial revolutions with end caps.
   Segment counts describe a complete circle and scale to this angular span. Native filled
   revolutions require at least three sweep intervals: adaptive sampling refines to that floor,
   while exact counts that imply fewer intervals reject. Pure revolveMesh supports one interval.
@@ -71,4 +72,4 @@ revolve(profile!, { revolveDegrees: 270 });
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/solidFromMesh.md

@@ -39,4 +39,4 @@ solidFromMesh(mesh);
 
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/sphere.md

@@ -39,4 +39,4 @@ sphere({ diameter: 20 });
 - [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/split.md

@@ -51,4 +51,4 @@ readonly \[[`Solid`](Solid.md), [`Solid`](Solid.md)\]
 - [Choose the Boolean by the material you want](../../guides/fundamentals.md#choose-the-boolean-by-the-material-you-want)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/splitByPlane.md

@@ -63,4 +63,4 @@ readonly \[[`Solid`](Solid.md), [`Solid`](Solid.md)\]
 - [Choose the Boolean by the material you want](../../guides/fundamentals.md#choose-the-boolean-by-the-material-you-want)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/star.md

@@ -30,15 +30,15 @@ star({ outerRadius: 12, innerRadius: 6, points: 5 });
 
   Integer outer point count from three through 50000.
 
-- [`placement`](StarOptions.md#placement) · [`PrimitivePlacementOptions`](PrimitivePlacementOptions.md) · Optional
+- [`attachment`](StarOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
 
-  Applied after local construction; Section placement must preserve the XY plane.
+  Applied after local construction; Section attachment must preserve the XY plane.
 
 - [`limits`](StarOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
   Explicit sampling ceilings, bounded by the host policy.
 
-- [`rotationDegrees`](StarOptions.md#rotationdegrees) · `number` · Optional
+- [`rotation`](StarOptions.md#rotation) · `number` · Optional
 
   Initial counterclockwise rotation in degrees; defaults to zero.
 
@@ -60,4 +60,4 @@ star({ outerRadius: 12, innerRadius: 6, points: 5 });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/stroke.md

@@ -2,7 +2,7 @@
 
 Creates a centered-width native Section along a sampled XY path.
 
-**stroke**(`path`: [`Path2`](Path2.md), `options`: [`StrokeOptions`](StrokeOptions.md)): [`Section`](Section.md)
+**stroke**(`path`: [`Path2Input`](Path2Input.md), `options`: [`StrokeOptions`](StrokeOptions.md)): [`Section`](Section.md)
 
 
 
@@ -12,7 +12,7 @@ Creates a centered-width native Section along a sampled XY path.
 stroke([[0, 0], [20, 0], [20, 10]], { width: 3, join: "round", cap: "round" }).extrude({ height: 2 });
 ```
 
-Shares caps, joins and physical sampling with Geometry's strokePathRegion. Native union
+Shares caps, joins and physical sampling with Geometry's strokeRegionData. Native union
 resolves overlapping stroke primitives. Session resolution and resource ceilings apply;
 closed paths omit the duplicated seam. Returns an immutable deferred recipe.
 
@@ -20,7 +20,7 @@ closed paths omit the duplicated seam. Returns an immutable deferred recipe.
 
 <a id="path"></a>
 
-**`path`** · [`Path2`](Path2.md) · Required
+**`path`** · [`Path2Input`](Path2Input.md) · Required
 
 
 
@@ -38,13 +38,13 @@ closed paths omit the duplicated seam. Returns an immutable deferred recipe.
 
 - [`closed`](StrokeOptions.md#closed) · `boolean` · Optional
 
-  Treat the path as a closed non-duplicated loop. Default: `false`.
+  Raw point closure defaults to false; a Path2 supplies its closure and rejects conflicts.
 
-- [`cap`](StrokeOptions.md#cap) · [`StrokePathCap`](StrokePathCap.md) · Optional
+- [`cap`](StrokeOptions.md#cap) · [`StrokeCap`](StrokeCap.md) · Optional
 
   End-cap treatment for an open path. Ignored for closed paths. Default: `butt`.
 
-- [`join`](StrokeOptions.md#join) · [`StrokePathJoin`](StrokePathJoin.md) · Optional
+- [`join`](StrokeOptions.md#join) · [`StrokeJoin`](StrokeJoin.md) · Optional
 
   Corner treatment; miters exceeding SVG's default limit of 4 become bevels. Default: `miter`.
 
@@ -61,7 +61,7 @@ closed paths omit the duplicated seam. Returns an immutable deferred recipe.
 
 ## Related APIs
 
-- [Path2](Path2.md)
+- [Path2Input](Path2Input.md)
 - [Section](Section.md)
 - [StrokeOptions](StrokeOptions.md)
 
@@ -71,4 +71,4 @@ closed paths omit the duplicated seam. Returns an immutable deferred recipe.
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/svgPathSection.md

@@ -62,4 +62,4 @@ svgPathSection("M0 0H20V12H0Z", { origin: "center", scale: 1 });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/svgSection.md

@@ -61,4 +61,4 @@ svgSection(
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/sweep.md

@@ -2,7 +2,7 @@
 
 Sweeps explicit corresponding contours using the selected frame policy. Filled Sections use `section.sweep(path, options)`.
 
-**sweep**(`shape`: [`CorrespondingProfile`](CorrespondingProfile.md), `path`: readonly [`Vector3Tuple`](Vector3Tuple.md)[], `options?`: [`SweepOptions`](SweepOptions.md)): [`Solid`](Solid.md)
+**sweep**(`shape`: [`CorrespondingProfile`](CorrespondingProfile.md), `path`: [`Path3Input`](Path3Input.md), `options?`: [`SweepOptions`](SweepOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -28,7 +28,7 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
 <a id="path"></a>
 
-**`path`** · readonly [`Vector3Tuple`](Vector3Tuple.md)[] · Required
+**`path`** · [`Path3Input`](Path3Input.md) · Required
 
 
 
@@ -38,7 +38,7 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
 - [`closed`](SweepOptions.md#closed) · `boolean` · Optional
 
-  Join the path's last station to its first. Open paths retain watertight end caps.
+  Raw point closure defaults to false; a Path3 supplies its closure and rejects conflicts.
 
 - [`limits`](SweepOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
 
@@ -52,7 +52,7 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
   Physical sampling of nonzero twist; inserted stations retain authored station controls.
 
-- [`twistDegrees`](SweepOptions.md#twistdegrees) · `number` · Optional
+- [`twist`](SweepOptions.md#twist) · `number` · Optional
 
   Total additional profile rotation in degrees, with progression selected by twistBy.
 
@@ -60,7 +60,7 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
   Twist advances by physical path length (default), or normalized authored station position, including a closed seam gap.
 
-- [`scale`](SweepOptions.md#scale) · `number` \| [`Vector2Tuple`](Vector2Tuple.md) \| readonly [`Vector2Tuple`](Vector2Tuple.md)[] · Optional
+- [`scale`](SweepOptions.md#scale) · `number` \| [`Vector2Input`](Vector2Input.md) \| readonly [`Vector2Input`](Vector2Input.md)[] · Optional
 
   Positive uniform/XY scale, or one XY pair per path station. Defaults to one.
 
@@ -78,9 +78,9 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 ## Related APIs
 
 - [CorrespondingProfile](CorrespondingProfile.md)
+- [Path3Input](Path3Input.md)
 - [Solid](Solid.md)
 - [SweepOptions](SweepOptions.md)
-- [Vector3Tuple](Vector3Tuple.md)
 
 ## Guides
 
@@ -89,4 +89,4 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/textSection.md

@@ -54,4 +54,4 @@ function labelSection(layout: VectorTextLayout) {
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/threadRidge.md

@@ -37,7 +37,7 @@ Helical ridge mesh construction.
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](HelicalThreadRidgeMeshOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](HelicalThreadRidgeMeshOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -68,5 +68,6 @@ Helical ridge mesh construction.
 ## Guides
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/threadedNut.md

@@ -10,9 +10,9 @@ Compensated threaded nut.
 
 ```ts
 import { threadedNut } from "@metamesh/modeling";
-import { createThreadProfile } from "@metamesh/modeling/geometry";
+import { threadProfile } from "@metamesh/modeling/geometry";
 
-const profile = createThreadProfile({ kind: "triangular", pitch: 1.75 });
+const profile = threadProfile({ kind: "triangular", pitch: 1.75 });
 threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", profile, fit: "normal" });
 ```
 
@@ -55,7 +55,7 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](ThreadedNutOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](ThreadedNutOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -106,5 +106,6 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 ## Guides
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/threadedRod.md

@@ -10,9 +10,9 @@ Compensated external threaded rod.
 
 ```ts
 import { threadedRod } from "@metamesh/modeling";
-import { createThreadProfile } from "@metamesh/modeling/geometry";
+import { threadProfile } from "@metamesh/modeling/geometry";
 
-const profile = createThreadProfile({ kind: "triangular", pitch: 1.75 });
+const profile = threadProfile({ kind: "triangular", pitch: 1.75 });
 threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 ```
 
@@ -47,7 +47,7 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](ThreadedRodOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](ThreadedRodOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -95,5 +95,6 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 ## Guides
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/torus.md

@@ -30,9 +30,9 @@ torus({ majorRadius: 12, minorRadius: 3 });
 
   Radius of the swept circular profile in millimetres.
 
-- [`placement`](TorusOptions.md#placement) · [`PrimitivePlacementOptions`](PrimitivePlacementOptions.md) · Optional
+- [`attachment`](TorusOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
 
-  Applied after local construction; Section placement must preserve the XY plane.
+  Applied after local construction; Section attachment must preserve the XY plane.
 
 - [`limits`](TorusOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
@@ -67,4 +67,4 @@ torus({ majorRadius: 12, minorRadius: 3 });
 - [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model/transform2.md

@@ -1,8 +1,8 @@
 # transform2
 
-Creates an immutable XY transform, identity by default. Matrices are copied and validated. Pass it directly to Section.transform() and planar data helpers; to3D() explicitly crosses into XYZ. Zero scales and singular matrices throw GeometryError; negative scales reflect.
+Creates an immutable XY transform, identity by default.
 
-**transform2**(`matrix?`: [`Transform2Matrix`](Transform2Matrix.md)): [`Transform2`](Transform2-type.md)
+**transform2**(`input?`: [`Transform2Input`](Transform2Input.md)): [`Transform2`](Transform2-type.md)
 
 
 
@@ -10,14 +10,20 @@ Creates an immutable XY transform, identity by default. Matrices are copied and
 
 ```ts
 const placement = transform2().rotate(90).translate([10, 0]);
-placement.applyPoint([1, 0]).toArray(); // approximately [10, 1]
+placement.applyPoint([1, 0]).toData(); // approximately [10, 1]
 ```
 
+Values and data are copied and validated.
+Pass it directly to Section.transform() and planar data helpers; to3D() explicitly crosses into XYZ.
+Zero scales and singular matrices throw GeometryError; negative scales reflect.
+
+Use `toData()` for frozen matrix interchange.
+
 ## Parameters
 
-<a id="matrix"></a>
+<a id="input"></a>
 
-**`matrix`** · [`Transform2Matrix`](Transform2Matrix.md) · Optional
+**`input`** · [`Transform2Input`](Transform2Input.md) · Optional
 
 
 
@@ -29,11 +35,12 @@ placement.applyPoint([1, 0]).toArray(); // approximately [10, 1]
 ## Related APIs
 
 - [Transform2](Transform2-type.md)
-- [Transform2Matrix](Transform2Matrix.md)
+- [Transform2Input](Transform2Input.md)
 
 ## Guides
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.