@metamesh/modeling 0.15.0 → 0.17.0

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

@@ -1,6 +1,6 @@
 # heightfield
 
-Closed rectilinear top above a flat base, with uniform or explicit XY coordinates. Samples each grid height once; center-error triangulation also samples each cell centre. The retained callback must capture independent immutable inputs, not live session readers or parameters.
+Closed rectilinear top above a flat base, with uniform or explicit XY coordinates.
 
 **heightfield**(`options`: [`HeightfieldOptions`](HeightfieldOptions.md)): [`Solid`](Solid.md)
 
@@ -19,6 +19,9 @@ heightfield({
 
 
 
+Samples each grid height once; center-error triangulation also samples each cell centre.
+The retained callback must capture independent immutable inputs, not live session readers or parameters.
+
 ## Parameters
 
 <a id="options"></a>
@@ -37,4 +40,4 @@ heightfield({
 - [HeightfieldOptions](HeightfieldOptions.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -0,0 +1,45 @@
+# holeCutter
+
+Declares a +Z hole or blind-pocket cutter with explicit end overrun in millimetres. Choose exactly one circular diameter or existing Section. A 45-degree entry chamfer supports one strictly convex contour without holes; plain profiles may have any topology. Circular entries retain nominal frustum radii; profile entries offset the supplied polygon edges. Circular head recesses are mutually exclusive with entryChamfer. Both overrun ends default to zero, so the nominal bottom remains at Z=0 and blind pocket floors are preserved. Existing Section samples are authoritative; limits and unspecified circular sampling belong to the evaluating host. Compiled packages require runtime major 9.
+
+**holeCutter**(`options`: [`HoleCutterOptions`](HoleCutterOptions.md)): [`Solid`](Solid.md)
+
+
+
+## Example: A blind hex pocket with an open top
+
+
+
+```ts
+holeCutter({
+  profile: regularPolygon({ sides: 6, radius: 3.5, sizing: "face", rotation: 30 }),
+  height: 12, entryChamfer: 0.5, overrun: { top: 0.05 },
+});
+```
+
+
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`HoleCutterOptions`](HoleCutterOptions.md) · Required
+
+
+
+## Returns
+
+[`Solid`](Solid.md)
+
+
+## Related APIs
+
+- [HoleCutterOptions](HoleCutterOptions.md)
+- [Solid](Solid.md)
+
+## Guides
+
+- [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.17.0`.

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

@@ -71,4 +71,4 @@ Convex filled XY hull of finite points or filled section recipes.
 - [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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -41,4 +41,8 @@ editable[0] = 8; // heights still contains 2, 4, 6.
 - [ImmutableBuffer](ImmutableBuffer-type.md)
 - [NumericArray](NumericArray.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -37,4 +37,8 @@ const model = generate(({ computed, part }) => {
 - [ImmutableTriangleMesh](ImmutableTriangleMesh.md)
 - [TriangleMesh](TriangleMesh.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -12,11 +12,11 @@ Bounded positive-inside implicit field constructor. The retained callback must c
 
 **`options`** · [`ImplicitOptions`](ImplicitOptions.md) · Required
 
-- [`field`](ImplicitOptions.md#field) · (`point`: [`Vector3Tuple`](Vector3Tuple.md)) => `number` · Required
+- [`field`](ImplicitOptions.md#field) · (`point`: [`Vector3Data`](Vector3Data.md)) => `number` · Required
 
   Positive-inside scalar field evaluated at finite XYZ points.
 
-- [`bounds`](ImplicitOptions.md#bounds) · [`Bounds3`](Bounds3.md) · Required
+- [`bounds`](ImplicitOptions.md#bounds) · [`Bounds3Data`](Bounds3Data.md) · Required
 
   Axis-aligned XYZ bounds in millimetres.
 
@@ -44,4 +44,4 @@ Bounded positive-inside implicit field constructor. The retained callback must c
 - [ImplicitOptions](ImplicitOptions.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -35,4 +35,4 @@ facts.area; // 200 mm²
 
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -35,4 +35,4 @@ facts.volume; // 3600 mm³
 
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -96,5 +96,6 @@ body.subtract([cutter]);
 ## 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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -67,4 +67,4 @@ Native filled section intersection; dimensions cannot be mixed.
 - [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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -36,4 +36,4 @@ Useful after a Boolean operation whose inputs may not overlap; no mesh is extrac
 - [Section](Section.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -0,0 +1,47 @@
+# knuckleHinge
+
+Declares separate knuckle-joint halves along the centered +X pin axis, in millimetres.
+
+**knuckleHinge**(`options`: [`KnuckleHingeOptions`](KnuckleHingeOptions.md)): [`KnuckleHinge`](KnuckleHinge-type.md)
+
+
+
+## Example: Integral-pin hinge with two mounting webs
+
+```ts
+const joint = knuckleHinge({
+  mode: "print-in-place", length: 30, knuckleCount: 3,
+  barrelDiameter: 10, pinDiameter: 3, radialClearance: 0.3, axialGap: 0.4,
+  halfA: { web: { direction: "positive-y", reach: 8, zMin: -5, thickness: 2 } },
+  halfB: { web: { direction: "negative-y", reach: 8, zMin: -5, thickness: 2 } },
+});
+```
+
+A starts at negative X. Attach independent webs or use barrels only; caller geometry connects
+otherwise disconnected intervals. Returns portable recipes without initializing the engine.
+Unspecified resolution inherits the evaluating session. Axis direction is +X with +Z up.
+
+Each half's `chamfer` bevels its barrel outer rims and all web edges. Consumers own plates, screw holes,
+pin retention, fit policy, and part placement. Added mounting material must preserve the bores.
+No opening range or collision freedom is implied for arbitrary caller attachments.
+Compiled Generator packages using this operation require runtime 9.0.0 or newer in major 9.
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`KnuckleHingeOptions`](KnuckleHingeOptions.md) · Required
+
+
+
+## Returns
+
+[`KnuckleHinge`](KnuckleHinge-type.md)
+
+
+## Related APIs
+
+- [KnuckleHinge](KnuckleHinge-type.md)
+- [KnuckleHingeOptions](KnuckleHingeOptions.md)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -76,5 +76,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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -134,4 +134,4 @@ Lofts explicit corresponding contours, including holes and collapsed logical slo
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -39,4 +39,4 @@ readonly [`CorrespondingProfile`](CorrespondingProfile.md)[]
 - [MatchProfilesOptions](MatchProfilesOptions.md)
 - [Profile](Profile.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -34,4 +34,4 @@ Three-dimensional Minkowski sum.
 - [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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,11 +1,19 @@
 # path2
 
-Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization. Open paths may be empty or have one point; closed paths need three vertices and omit a duplicated seam. Repeated adjacent vertices are retained. No winding normalization or filling is performed. Malformed dimensions or topology throw INVALID_ARGUMENT; nonfinite coordinates or measurement overflow throw NON_FINITE_VALUE; exhausted allocation ceilings throw COMPLEXITY_LIMIT GeometryError. A path input retains its closure. Limits bound construction only; resampling takes its own limits.
+Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization.
 
 **path2**(`input`: [`Path2Input`](Path2Input.md), `options?`: [`PathOptions`](PathOptions.md)): [`Path2`](Path2-type.md)
 
 
 
+Open paths may be empty or have one point; closed paths need three vertices and omit a duplicated
+seam. Repeated adjacent vertices are retained. No winding normalization or filling is performed.
+Malformed dimensions or topology throw INVALID_ARGUMENT; nonfinite coordinates or measurement
+overflow throw NON_FINITE_VALUE; exhausted allocation ceilings throw COMPLEXITY_LIMIT GeometryError.
+A path input retains its closure. Limits bound construction only; resampling takes its own limits.
+
+Use `toData()` for a frozen record that restores coordinates, closure, and dimension together.
+
 ## Parameters
 
 <a id="input"></a>
@@ -39,4 +47,8 @@ Snapshots finite XY coordinates as an immutable sampled path, independent of eng
 - [Path2Input](Path2Input.md)
 - [PathOptions](PathOptions.md)
 
-Package: `@metamesh/modeling@0.15.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -6,6 +6,8 @@ Snapshots finite XYZ coordinates as an immutable sampled path with the same clos
 
 
 
+Use `toData()` for a frozen record that restores coordinates, closure, and dimension together.
+
 ## Parameters
 
 <a id="input"></a>
@@ -38,5 +40,10 @@ Snapshots finite XYZ coordinates as an immutable sampled path with the same clos
 - [Path3](Path3-type.md)
 - [Path3Input](Path3Input.md)
 - [PathOptions](PathOptions.md)
+- [path2](path2.md)
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -115,5 +115,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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,6 +1,6 @@
 # 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`: [`Path2Input`](Path2Input.md) \| [`PolygonOptions`](PolygonOptions.md)): [`Section`](Section.md)
 
@@ -12,6 +12,9 @@ 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>
@@ -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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,11 +1,15 @@
 # preflightInternalThreadCutter
 
-Internal-thread facts using host resolution and limits; requires active synchronous model execution.
+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>
@@ -81,9 +85,11 @@ Internal-thread facts using host resolution and limits; requires active synchron
 
 - [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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,11 +1,15 @@
 # preflightThreadedNut
 
-Nut/cutter facts using host resolution and limits; requires active synchronous model execution.
+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>
@@ -92,9 +96,11 @@ Nut/cutter facts using host resolution and limits; requires active synchronous m
 
 - [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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -1,11 +1,15 @@
 # preflightThreadedRod
 
-External-thread facts using host resolution and limits; requires active synchronous model execution.
+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>
@@ -81,9 +85,11 @@ External-thread facts using host resolution and limits; requires active synchron
 
 - [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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -77,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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -12,13 +12,16 @@ 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.
 
@@ -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.15.0`.
+Package: `@metamesh/modeling@0.17.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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -72,4 +72,4 @@ revolve(profile!, { degrees: 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.15.0`.
+Package: `@metamesh/modeling@0.17.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.15.0`.
+Package: `@metamesh/modeling@0.17.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.15.0`.
+Package: `@metamesh/modeling@0.17.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.15.0`.
+Package: `@metamesh/modeling@0.17.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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/model/stroke.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.15.0`.
+Package: `@metamesh/modeling@0.17.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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -27,6 +27,10 @@ svgSection(
 
 **`options`** · [`SvgSectionOptions`](SvgSectionOptions.md) · Optional
 
+- [`fit`](SvgSectionOptions.md#fit) · [`Bounds2Input`](Bounds2Input.md) · Optional
+
+  Fit painted bounds uniformly inside positioned XY millimetre bounds; adaptive resolution applies at the fitted size.
+
 - [`limits`](SvgSectionOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
   Local allocation ceilings may only lower the configured engine policy.
@@ -61,4 +65,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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -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.15.0`.
+Package: `@metamesh/modeling@0.17.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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -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.15.0`.
+Package: `@metamesh/modeling@0.17.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.15.0`.
+Package: `@metamesh/modeling@0.17.0`.