@metamesh/modeling 0.16.0 → 0.17.0

package/dist/docs/reference/model/categories/primitives.md

@@ -27,6 +27,7 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 | --- | --- |
 | [box](../box.md) | Axis-aligned box with uniform or disjoint named edge/group treatments. |
 | [cylinder](../cylinder.md) | +Z cylinder or frustum. Face sizing compensates polygon faceting. |
+| [holeCutter](../holeCutter.md) | 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. |
 | [sphere](../sphere.md) | Origin-centered sphere. |
 | [torus](../torus.md) | Torus around +Z. |
 | [tube](../tube.md) | Hollow +Z tube. |
@@ -39,6 +40,7 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 | [BoxOptions](../BoxOptions.md) | Dimensions, placement, and uniform or independently selected finishing for an axis-aligned box. |
 | [ChamferedEdgeTreatment](../ChamferedEdgeTreatment.md) | A planar edge or corner chamfer with equal or independent surface setbacks. |
 | [CircularPrimitiveOptions](../CircularPrimitiveOptions.md) | Tessellation controls shared by circular primitives across Geometry entry points. |
+| [HoleCutterOverrun](../HoleCutterOverrun.md) | Explicit extra cutter length outside the nominal Z=0..height interval, in millimetres. |
 | [EndTreatments](../EndTreatments.md) | Independent inward finishing on primitive or straight convex extrusion ends. Zero amounts leave the end untreated, including when all ends are disabled. |
 | [RadialSizingOptions](../RadialSizingOptions.md) | Nominal radial sizing shared by circular and regular polygon construction. |
 | [RoundedEdgeTreatment](../RoundedEdgeTreatment.md) | A circular edge or corner roundover with explicit physical sampling. |
@@ -51,6 +53,8 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 
 | API | Summary |
 | --- | --- |
+| [HoleCutterOptions](../HoleCutterOptions.md) | A deferred +Z hole or pocket cutter, with exactly one circular diameter or existing Section. Profile entry chamfers expand one strictly convex contour without holes by parallel-edge offsets; the supplied sampled boundary remains authoritative. Plain profile cutters accept any Section. Circular entry chamfers retain nominal circular/frustum radii under the selected radial sizing. |
+| [HoleCutterRecess](../HoleCutterRecess.md) | Circular screw seating dimensions in millimetres; allowances belong to the caller. |
 | [CylinderOptions](../CylinderOptions.md) | Dimensions, placement, independent end finishing, and tessellation for a Z-axis cylinder or frustum. |
 | [EdgeTreatment](../EdgeTreatment.md) | Uniform finishing vocabulary shared by applicable solid edges and profile corners. |
 | [RadialSizing](../RadialSizing.md) | Radial dimensions refer to polygon vertices or compensate faceting to meet polygon faces. |
@@ -64,4 +68,4 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/model/categories/resolution.md

@@ -17,4 +17,4 @@ Exact operation counts override the operation's resolution policy, which overrid
 
 - [Coordinates, units, and resolution](../../../guides/concepts.md#coordinates-units-and-resolution)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/model/categories/sections.md

@@ -63,4 +63,4 @@ Create immutable filled XY shapes, including prepared text and bounded painted S
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/model/categories/threads.md

@@ -50,4 +50,4 @@ Constructors enforce safety automatically. Optional preflight provides resource
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/model/categories/transforms-placement.md

@@ -62,4 +62,4 @@ Use `vector2`/`vector3` for immutable arithmetic and `transform2`/`transform3` f
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -36,4 +36,4 @@ circle({ diameter: 12, 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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -68,4 +68,4 @@ readonly [`Section`](Section.md)[]
 - [Section](Section.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -28,4 +28,4 @@ Combines disjoint components without resolving overlap.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -49,4 +49,4 @@ cylinder({ height: 20, radius: [10, 0] });
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -42,4 +42,4 @@ Empty geometry and component selections from another session reject. Results fol
 
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -36,4 +36,4 @@ ellipse({ size: [30, 20] });
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -80,4 +80,4 @@ extrude(profile!, { height: 8 });
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -47,4 +47,4 @@ const model = generate<{ height: number }>(({ params, part, assert }) => {
 
 - [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -78,4 +78,4 @@ readonly [`Section`](Section.md)[]
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -40,4 +40,4 @@ The retained callback must capture independent immutable inputs, not live sessio
 - [HeightfieldOptions](HeightfieldOptions.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.16.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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

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

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

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

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

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

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

@@ -98,4 +98,4 @@ body.subtract([cutter]);
 - [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.16.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.16.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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -21,10 +21,10 @@ A starts at negative X. Attach independent webs or use barrels only; caller geom
 otherwise disconnected intervals. Returns portable recipes without initializing the engine.
 Unspecified resolution inherits the evaluating session. Axis direction is +X with +Z up.
 
-Barrel end chamfers affect outer rims only; webs have square edges. Consumers own plates, screw holes,
+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 8.0.0 or newer in major 8.
+Compiled Generator packages using this operation require runtime 9.0.0 or newer in major 9.
 
 ## Parameters
 
@@ -44,4 +44,4 @@ Compiled Generator packages using this operation require runtime 8.0.0 or newer
 - [KnuckleHinge](KnuckleHinge-type.md)
 - [KnuckleHingeOptions](KnuckleHingeOptions.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -78,4 +78,4 @@ readonly [`Section`](Section.md)[]
 - [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.16.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.16.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.16.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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -51,4 +51,4 @@ Use `toData()` for a frozen record that restores coordinates, closure, and dimen
 
 - [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -46,4 +46,4 @@ Use `toData()` for a frozen record that restores coordinates, closure, and dimen
 
 - [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -117,4 +117,4 @@ readonly [`Section`](Section.md)[]
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -40,4 +40,4 @@ Explicit topology must be simple and disjoint; compound winding may resolve over
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -92,4 +92,4 @@ Mesh validity, native construction, and aggregate output limits are checked late
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -103,4 +103,4 @@ Boolean result. Mesh validity, native construction, and aggregate output limits
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -92,4 +92,4 @@ Mesh validity, native construction, and aggregate output limits are checked late
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -79,4 +79,4 @@ readonly [`Section`](Section.md)[]
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -59,4 +59,4 @@ or [rectangleProfile](../geometry/rectangleProfile.md) to retain identified loft
 - [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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -70,4 +70,4 @@ Helical ridge mesh construction.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -108,4 +108,4 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -97,4 +97,4 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 - [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.16.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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -43,4 +43,4 @@ Use `toData()` for frozen matrix interchange.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -45,4 +45,4 @@ Use `toData()` for frozen matrix interchange.
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -74,4 +74,4 @@ tube({ height: 20, outerRadius: 10, innerRadius: 6 });
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -69,4 +69,4 @@ Native filled section union; 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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -37,4 +37,4 @@ Use `toData()` for frozen tuple interchange, or
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

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

@@ -44,4 +44,4 @@ Use `toData()` for frozen tuple interchange, or
 - [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.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/model.md

@@ -44,4 +44,4 @@ See [host lifecycle](engine.md) and [pure foundations](geometry.md).
 - [Model generation](model/categories/generation.md) — Declare typed programs, optional computations, semantic parts and structured diagnostics.
 - [Model contracts](model/categories/contracts.md) — Describe opaque handles, dimensions, manufacturing parts, and completed snapshots.
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/text/Bounds2Data.md

@@ -31,4 +31,4 @@ Inclusive minimum X/Y coordinates.
 
 - [Vector2Data](Vector2Data.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/text/MAX_VECTOR_FONT_BYTES.md

@@ -4,4 +4,4 @@ Limits apply before parsing or shaping untrusted font data.
 
 `const` **MAX\_VECTOR\_FONT\_BYTES**: `number`
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/text/Vector2Data.md

@@ -4,4 +4,4 @@ A two-dimensional Cartesian vector or point.
 
 **Vector2Data** = readonly \[`x`: `number`, `y`: `number`\]
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.17.0`.