@metamesh/modeling 0.19.0 → 0.20.0

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

@@ -2,7 +2,7 @@
 
 Axis-aligned box with uniform or disjoint named edge/group treatments.
 
-**box**(`options`: [`BoxOptions`](../geometry/BoxOptions.md)): [`Solid`](Solid.md)
+**box**(`options`: [`BoxOptions`](BoxOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -20,25 +20,25 @@ box({ size: [30, 20, 8], treatment: { kind: "round", radius: 2 } });
 
 <a id="options"></a>
 
-**`options`** · [`BoxOptions`](../geometry/BoxOptions.md) · Required
+**`options`** · [`BoxOptions`](BoxOptions.md) · Required
 
-- [`size`](../geometry/BoxOptions.md#size) · `number` \| [`Vector3Input`](../geometry/Vector3Input.md) · Required
+- [`size`](BoxOptions.md#size) · `number` \| [`Vector3Input`](../geometry/Vector3Input.md) · Required
 
   Positive uniform size or explicit `[X, Y, Z]` extents in millimetres.
 
-- [`limits`](../geometry/BoxOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](../geometry/GeometrySamplingLimits.md)\> · Optional
+- [`limits`](BoxOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](../geometry/GeometrySamplingLimits.md)\> · Optional
 
   Explicit sampling ceilings for edge treatments, bounded by the host policy.
 
-- [`center`](../geometry/BoxOptions.md#center) · `boolean` · Optional · Default: `true`
+- [`center`](BoxOptions.md#center) · `boolean` · Optional · Default: `true`
 
   Centers the box on the XYZ origin when `true`; otherwise its minimum corner is at the origin.
 
-- [`treatment`](../geometry/BoxOptions.md#treatment) · [`EdgeTreatment`](../geometry/EdgeTreatment.md) \| `Readonly`\<`Partial`\<`Record`\<[`BoxEdgeSelection`](../geometry/BoxEdgeSelection.md), [`EdgeTreatment`](../geometry/EdgeTreatment.md)\>\>\> · Optional
+- [`treatment`](BoxOptions.md#treatment) · [`EdgeTreatment`](../geometry/EdgeTreatment.md) \| `Readonly`\<`Partial`\<`Record`\<[`BoxEdgeSelection`](BoxEdgeSelection.md), [`EdgeTreatment`](../geometry/EdgeTreatment.md)\>\>\> · Optional
 
   Uniform treatment or independent disjoint nominal edge/group treatments.
 
-- [`attachment`](../geometry/BoxOptions.md#attachment) · [`PrimitiveAttachmentOptions`](../geometry/PrimitiveAttachmentOptions.md) · Optional
+- [`attachment`](BoxOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
 
   Applied after local construction; Section attachment must preserve the XY plane.
 
@@ -51,7 +51,7 @@ box({ size: [30, 20, 8], treatment: { kind: "round", radius: 2 } });
 
 ## Related APIs
 
-- [BoxOptions](../geometry/BoxOptions.md)
+- [BoxOptions](BoxOptions.md)
 - [Solid](Solid.md)
 
 ## Guides
@@ -59,11 +59,12 @@ box({ size: [30, 20, 8], treatment: { kind: "round", radius: 2 } });
 - [Choose a primitive](../../guides/profiles-and-extrusion.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/profiles-and-extrusion.md#treated-boxes-frustums-and-mirrored-arrays)
 - [Finish a profile with a hole](../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
+- [Shape openings and local edges](../../guides/profiles-and-extrusion.md#shape-openings-and-local-edges)
 
-## Supported imports
+## Import
 
 ```ts
 import { box } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/model/categories/boolean-operations.md

@@ -19,7 +19,7 @@ Keep Boolean overtravel separate from physical fit clearance.
 | [hull](../hull.md) | Convex hull of points or solids. |
 | [intersect](../intersect.md) | Robust intersection of one or more shapes; empty input rejects during declaration. |
 | [join](../join.md) | Fuses two positioned solids with a dimensioned transition at the feature's source datum. |
-| [minkowskiSum](../minkowskiSum.md) | Three-dimensional Minkowski sum. |
+| [minkowskiSum](../minkowskiSum.md) | Declares the three-dimensional Minkowski sum of two Solid recipes. |
 | [union](../union.md) | Robust union of one or more shapes; empty input rejects during declaration. |
 
 ## Interfaces
@@ -28,7 +28,7 @@ Keep Boolean overtravel separate from physical fit clearance.
 | --- | --- |
 | [JoinOptions](../JoinOptions.md) | Options for joining two positioned solids through a validated local straight feature collar. |
 | [JoinTransition](../JoinTransition.md) | Connection profile and setbacks, independent of feature construction. |
-| [PlaneOptions](../PlaneOptions.md) | A world-space cutting plane, retaining the half-space in the normal's direction. |
+| [PlaneOptions](../PlaneOptions.md) | A world-space cutting plane defined by a normal and signed millimetre offset. |
 
 ## Type aliases
 
@@ -43,4 +43,10 @@ Keep Boolean overtravel separate from physical fit clearance.
 - [Primitive booleans and repeated placement](../../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
 - [Join an independently modeled feature](../../../guides/solid-joins.md#join-an-independently-modeled-feature)
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/model/categories/bounded-surfaces.md

@@ -19,4 +19,16 @@ Implicit sampling requires finite bounds, positive grid spacing, and fixed algor
 | --- | --- |
 | [ImplicitOptions](../ImplicitOptions.md) | Positive-inside sampling, bounded to 4M native BCC grid slots and 8M field calls. |
 
-Package: `@metamesh/modeling@0.19.0`.
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [HeightfieldOptions](../HeightfieldOptions.md) | A closed rectilinear heightfield above a flat base, with uniform or explicit XY samples in millimetres. |
+
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/model/categories/extrude-revolve-sweep.md

@@ -4,10 +4,10 @@ Turn sections and paths into extruded, lofted, revolved, or swept solids.
 
 Turn filled Sections or explicitly matched profiles into solids:
 
-- **Extrude:** `section.extrude({ height, twist, scaleTop })` adds +Z depth. `center` defaults to `false`.
+- **Extrude:** `section.extrude({ height, twist, scale, slices })` adds +Z depth. `scale` tapers from one to its final profile-local XY value; `slices` counts positive longitudinal intervals. End treatments insert required rings into that grid. `center` defaults to `false`.
 - **Revolve:** `section.revolve({ degrees })` rotates radial/Z geometry around +Z and caps partial turns.
-- **Loft:** `loft(stations, options)` places profiles at exactly one `z` or `frame` per station, in input order. `refine` controls density; slices interpolate world vertices.
-- **Sweep:** `section.sweep(path, options)` supports implicitly closed paths, transport/fixed-normal/guide/Frenet orientation, physical-length or station twist progression, uniform/XY/per-station scales, and an explicit rotationally equivalent `seamProfileOffset`. Open sweeps have watertight end caps. Closed sweeps require compatible seam orientation and scale.
+- **Loft:** `loft(stations, options)` places profiles at exactly one `z` or `transform` per station, in input order. `refine` controls profile density; positive integer `slices` counts longitudinal intervals per station gap, defaulting to one. Inserted profiles interpolate world vertices.
+- **Sweep:** `section.sweep(path, options)` computes transport/fixed-normal/guide/Frenet orientation, physical-length or station twist progression, and verified cyclic seam alignment. `section.sweep(transforms, options)` instead connects exactly the supplied affine placements, preserving profile seams without inferred rotation or refinement. Open sweeps have watertight end caps and scalar/XY `scale` tapers from one to the final value by path length. Closed sweeps use scalar/XY `scale` uniformly and require compatible seam orientation and scale. Arrays supply positive XY scales at authored stations in either form.
 
 Lofts match compatible primitive landmarks directly, including circle/ellipse quadrants to rectangle corners. Other unlike primitive families use direct perimeter association from construction-local +X seams. Arbitrary Sections and loops require an explicit `direct`, `reindex`, `fast-distance`, or `distance` method. Identified `CorrespondingProfile` landmarks reject geometric remapping.
 
@@ -18,22 +18,41 @@ Use Section methods in fluent modeling sequences. Imported `extrude`, `revolve`,
 | API | Summary |
 | --- | --- |
 | [extrude](../extrude.md) | Extrudes a filled Section or explicit corresponding contours along +Z with degree twist and top scaling. Use `section.extrude(options)` in fluent sequences, or this function for generic profile inputs. |
-| [loft](../loft.md) | Lofts Sections and point loops at z heights or frames. Known primitive landmarks are retained; other profiles default to direct correspondence, preserving their supplied seams. |
+| [loft](../loft.md) | Lofts Sections and point contours at z heights or affine transforms. Known primitive landmarks are retained; other profiles default to direct correspondence, preserving their supplied seams. |
 | [revolve](../revolve.md) | Revolves a filled Section or explicit corresponding radial/Z contours around +Z, with caps for partial sweeps. Use `section.revolve(options)` in fluent sequences, or this function for generic profile inputs. |
-| [sweep](../sweep.md) | Sweeps a filled Section or explicit corresponding contours using the selected frame policy. Use `section.sweep(path, options)` in fluent sequences, or this function for generic profile inputs. |
+| [sweep](../sweep.md) | Sweeps a filled Section or corresponding contours along a path or explicit affine placements. Use `section.sweep(path, options)` in fluent sequences, or this function for generic profile inputs. |
+
+## Interfaces
+
+| API | Summary |
+| --- | --- |
+| [ExtrudeOptions](../ExtrudeOptions.md) | Native +Z extrusion with optional inward end treatments. |
+| [LoftOptions](../LoftOptions.md) | Shared controls for native and pure lofts. Point data and arbitrary Sections default to direct correspondence. |
+| [RevolveOptions](../RevolveOptions.md) | Circumferential sampling and degree sweep shared by pure and filled revolution. |
+| [SweepOptions](../SweepOptions.md) | Path-driven sweep orientation, deformation, and physical refinement controls. |
+| [SweepTransformOptions](../SweepTransformOptions.md) | Explicit-transform sweeps connect exactly the supplied stations, with no inferred rotation or refinement. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [LoftStation](../LoftStation.md) | A Section or point loop at an explicit height or frame. |
+| [LoftStation](../LoftStation.md) | A Section or point loop at a horizontal height or explicit affine transform. |
+| [LoftCorrespondence](../LoftCorrespondence.md) | Associates ordered loft contours without inferring component identities or repairing topology. |
+| [SweepOrientation](../SweepOrientation.md) | Explicit profile-X frame policy; all normals are directed, and selected singular policies reject. |
 
 ## Guides
 
 - [Finish a profile with a hole](../../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
+- [Chamfer a twisted extrusion](../../../guides/profiles-and-extrusion.md#chamfer-a-twisted-extrusion)
 - [Revolve a radial profile](../../../guides/profiles-and-extrusion.md#revolve-a-radial-profile)
 - [Rotation-minimizing path sweep](../../../guides/sweeps-and-lofts.md#rotation-minimizing-path-sweep)
 - [Matched-section loft](../../../guides/sweeps-and-lofts.md#matched-section-loft)
 - [Choose a modeling path](../../../guides/recipes.md#choose-a-technique)
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -6,9 +6,11 @@ Start with `generate(({ params, part, assert }) => ...)` and return one `part(..
 
 - **Cache:** `memo(fn, ...args)` eagerly reuses stable pure functions and returns immutable data or geometry. Pass actual inputs as arguments; the exact current params/context tracks fields read by the helper. Fresh functions safely recompute; ordinary object arguments must be deeply immutable.
 - **Report issues:** assertions stop immediately. Warnings continue and must be emitted in the outer callback.
-- **Place parts:** `transform` accepts a fluent `transform3()` value or row-major 16-number matrix. Only translation and proper rotation are supported; omission means identity. Pattern and attachment matrices work directly.
+- **Place parts:** `transform` accepts a fluent `transform3()` value or row-major 16-number matrix. Only translation and proper rotation are supported; omission means identity. Pattern and attachment transforms work directly.
 - **Keep cached data immutable:** use `immutableBuffer` for numeric arrays and `mesh.immutable` for indexed meshes. Buffers expose `length`, `at(index)`, standard iteration, and `copy()`. Results expose these immutable buffers; call `copy()` for mutable typed arrays.
 
+The context exposes effective immutable resolution and limits. Pass them explicitly to pure sampling or preflight functions so preparation uses the same physical policy as model evaluation.
+
 ## Functions
 
 | API | Summary |
@@ -27,7 +29,7 @@ Start with `generate(({ params, part, assert }) => ...)` and return one `part(..
 | --- | --- |
 | [Memo](../Memo.md) | Invokes fn(...args) and returns captured immutable data. Stable helpers reuse work across runs. Arguments compare with Object.is and must be deeply immutable; the exact current params or generation context instead tracks parameter fields read by the function. Functions must be pure: supply changing inputs explicitly, and do not read changing globals or ambient state. |
 | [DiagnosticOptions](../DiagnosticOptions.md) | Typed parameter association for an assertion or warning. |
-| [GenerateContext](../GenerateContext.md) | The sole synchronous authoring context, supplied independently of Studio. |
+| [GenerateContext](../GenerateContext.md) | Synchronous authoring context with immutable parameters and host-prepared services. |
 | [PartDeclaration](../PartDeclaration.md) | One declared output part. Construct with the context's `part` helper. |
 | [GenerationDiagnostic](../GenerationDiagnostic.md) | Structured user-facing issue associated with the attempted revision. |
 | [ModelProgram](../ModelProgram.md) | Stateless portable program descriptor. Execution and caches belong to an engine session. |
@@ -45,4 +47,10 @@ Start with `generate(({ params, part, assert }) => ...)` and return one `part(..
 
 - [Complete standalone model example](../../../guides/standalone-model.md#minimal-model-entry)
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -32,4 +32,10 @@ Radial clearance is per side; axial gap is the total gap between adjacent interv
 | --- | --- |
 | [KnuckleHingeOptions](../KnuckleHingeOptions.md) | Joint declaration with independent attachments; unspecified sampling inherits the evaluating host. |
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/model/categories/mesh-inspection.md

@@ -33,4 +33,10 @@ Inspection does not certify wall thickness, overhangs, printer fit, or material
 
 - [Solid inspection](../../../guides/resolution-and-inspection.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -5,7 +5,7 @@ Create basic solids with explicit dimensions and tessellation.
 All primitives use millimetres and one options object. Boxes, cylinders, and tubes are centered by default.
 
 - **Dimensions:** `box` accepts a scalar or XYZ size. `cylinder` accepts exactly one radius or diameter, uniform or a bottom/top tuple along +Z. Radial sizing selects polygon vertices or compensated faces.
-- **Treatments:** choose `{ kind: "round", radius }`, `{ kind: "chamfer", distance }`, `{ kind: "smooth", distance }`, or `{ kind: "profile", profile }`. Boxes support named edges; cylinders and straight extrusions support independent bottom/top treatments. Straight extrusion finishing admits concavity, holes, and disconnected components when every boundary survives without contact or collapse.
+- **Treatments:** choose `{ kind: "round", radius }`, `{ kind: "chamfer", distance }`, `{ kind: "smooth", distance }`, or `{ kind: "profile", profile }`. Boxes support named edges; cylinders, tubes, and straight extrusions support independent bottom/top treatments. Tube end treatments finish both outer and inner rims. Straight extrusion finishing admits concavity, holes, and disconnected components when every boundary survives without contact or collapse.
 - **Placement:** `attachment` maps a named or explicit local anchor onto a world anchor after construction.
 
 Use imported primitives inside generation:
@@ -21,35 +21,63 @@ export default generate(({ part }) => {
 
 A zero round radius or zero chamfer/smooth setback leaves a feature untreated. Setback tuples must be all zero or both positive.
 
+Use holeCutter for bores and blind pockets with independent openings.top and openings.bottom. Each opening accepts a shared edge treatment; circular bores also admit counterbores and countersinks. Opening treatments widen the mouth and must leave a positive untreated throat. Treated Sections require one strictly convex contour without holes; plain Section cutters retain arbitrary topology. CutterOverrun extends terminal cross sections outside the nominal interval and defaults to zero at both ends, preserving blind floors. It is separate from manufacturing clearance.
+
+Use edgeCutter for an explicitly placed straight convex edge and cornerCutter for a matching perpendicular three-face corner. Edge cutters share all four treatments; corners admit spherical round or equal-setback chamfer treatments. Existing transforms, anchors, and patterns position the ordinary Solid cutters before subtraction. These operations do not discover edges or perform general filleting.
+
 ## Functions
 
 | API | Summary |
 | --- | --- |
 | [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. |
-| [sphere](../sphere.md) | Origin-centered sphere. |
+| [holeCutter](../holeCutter.md) | Declares a +Z hole or blind-pocket cutter with independent opening treatments. |
+| [sphere](../sphere.md) | Origin-centered sphere with adaptive sampling that bounds spherical triangle error. Explicit segment requests select octahedral refinement and round up to a multiple of four. |
 | [torus](../torus.md) | Torus around +Z. |
 | [tube](../tube.md) | Hollow +Z tube. |
+| [edgeCutter](../edgeCutter.md) | Creates a cutter for one straight convex edge along +Z, with its sharp reference at XY=0. Position it explicitly before subtraction; the included material angle defaults to 90 degrees. |
+| [cornerCutter](../cornerCutter.md) | Creates a round or chamfer cutter at the origin for three perpendicular positive-axis faces. Complements matching edge cutters; construction, placement, and subtraction remain explicit. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
 | [Solid](../Solid.md) | Immutable deferred solid recipe. |
-| [HoleCutterOverrun](../HoleCutterOverrun.md) | Explicit extra cutter length outside the nominal Z=0..height interval, in millimetres. |
+| [BoxOptions](../BoxOptions.md) | Dimensions, placement, and uniform or independently selected finishing for an axis-aligned box. |
+| [TorusOptions](../TorusOptions.md) | Dimensions and independent ring/profile tessellation for a torus around the Z axis. |
+| [EndTreatments](../EndTreatments.md) | Independent inward finishing on primitive or source-corresponding extrusion ends. Zero amounts leave the end untreated, including when all ends are disabled. |
+| [PrimitiveAttachment](../PrimitiveAttachment.md) | Anchor attachment shared by solid and filled-section factories. |
+| [PrimitiveAttachmentOptions](../PrimitiveAttachmentOptions.md) | Maps an explicit or named shape-local attachment anchor onto a world-space anchor. |
+| [EdgeCutterOptions](../EdgeCutterOptions.md) | A subtractive treatment along one explicitly positioned straight convex edge. Right-angle rounds share the corner sphere's sampling lattice; full-circle segment requests round up to a multiple of four. |
+| [CornerCutterOptions](../CornerCutterOptions.md) | A subtractive corner transition for material occupying the positive XYZ octant. Round treatments share their lattice with right-angle edge cutters; full-circle segment requests round up to a multiple of four. |
+| [CutterOverrun](../CutterOverrun.md) | Numerical cutter extension outside its nominal +Z interval, in millimetres. |
 
 ## Type aliases
 
 | 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. |
+| [HoleCutterOptions](../HoleCutterOptions.md) | A deferred +Z hole or pocket cutter, with exactly one circular diameter or existing Section. Openings widen nominal ends without changing the untreated bore. Both depths together must leave a positive untreated interval. Overrun extends the terminal mouth unchanged; omitted ends and overrun preserve blind-pocket floors. No support surface or printer fit is inferred. |
 | [HoleCutterRecess](../HoleCutterRecess.md) | Circular screw seating dimensions in millimetres; allowances belong to the caller. |
+| [BoxEdge](../BoxEdge.md) | Box edges use +Z top, +Y front and +X right; vertical names list front/back first. |
+| [BoxEdgeSelection](../BoxEdgeSelection.md) | Named individual edges or top/bottom rims and all four vertical edges. |
+| [BoxEdgeTreatments](../BoxEdgeTreatments.md) | Independent treatments for disjoint named edge selections; overlapping selections fail. |
+| [CylinderOptions](../CylinderOptions.md) | Dimensions, placement, independent end finishing, and tessellation for a Z-axis cylinder or frustum. |
+| [SphereOptions](../SphereOptions.md) | Exactly one radius or diameter, placement, and tessellation for an origin-centered sphere. |
+| [TubeOptions](../TubeOptions.md) | Dimensions, placement, and tessellation for a hollow Z-axis tube. |
+| [HoleCutterOpening](../HoleCutterOpening.md) | A finished circular opening: outward edge treatment or screw seat, one per end. Treatment setbacks measure radial expansion first and axial depth second. A round radius is circular in that radial/axial section. Profile points run from [mouth expansion, 0] to [0, depth]. |
+| [CornerCutterTreatment](../CornerCutterTreatment.md) | Symmetric trihedral treatments that meet three matching perpendicular edge treatments. |
 
 ## Guides
 
 - [Choose a primitive](../../../guides/profiles-and-extrusion.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../../guides/profiles-and-extrusion.md#treated-boxes-frustums-and-mirrored-arrays)
 - [Finish a profile with a hole](../../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
+- [Shape openings and local edges](../../../guides/profiles-and-extrusion.md#shape-openings-and-local-edges)
+
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -13,7 +13,7 @@ Create immutable filled XY shapes, including prepared text and bounded painted S
 
 | API | Summary |
 | --- | --- |
-| [stroke](../stroke.md) | Creates a centered-width native Section along a sampled XY path. |
+| [stroke](../stroke.md) | Declares a centered-width Section recipe along a sampled XY path. |
 | [circle](../circle.md) | Centered circular section. |
 | [ellipse](../ellipse.md) | Centered elliptical section. |
 | [rectangle](../rectangle.md) | Filled rectangular section with uniform or independently treated corners. |
@@ -53,4 +53,10 @@ Create immutable filled XY shapes, including prepared text and bounded painted S
 - [SVG sections: fills and strokes are different inputs](../../../guides/svg-and-text.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../../guides/svg-and-text.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -11,16 +11,19 @@ Constructors enforce safety automatically. Use optional preflight to estimate re
 | API | Summary |
 | --- | --- |
 | [internalThreadCutter](../internalThreadCutter.md) | Compensated internal threaded cutter. |
-| [preflightInternalThreadCutter](../preflightInternalThreadCutter.md) | Checks compensated cutter dimensions and conservative mesh estimates against host output limits. |
-| [preflightThreadedNut](../preflightThreadedNut.md) | Checks nut dimensions, chamfers, end-face wall, and the extended compensated cutter's allocation plan. |
-| [preflightThreadedRod](../preflightThreadedRod.md) | Checks compensated rod dimensions and conservative mesh estimates against host output limits. |
 | [threadedNut](../threadedNut.md) | Compensated threaded nut. |
 | [threadedRod](../threadedRod.md) | Compensated external threaded rod. |
-| [threadRidge](../threadRidge.md) | Helical ridge mesh construction. |
+| [threadRidge](../threadRidge.md) | Declares a helical ridge Solid recipe along +Z, with lengths in millimetres. |
 
 ## Guides
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 - [Preflight guarantees and host settings](../../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -1,15 +1,14 @@
-# Transforms, vectors, and placement
+# Shape patterns
 
-Calculate with immutable vectors, reuse transforms, and position geometry.
+Repeat Solid and Section recipes along lines, grids, circles, or paths.
 
-Use `vector2`/`vector3` for immutable arithmetic and `transform2`/`transform3` for reusable placements. Tuples are accepted as operands; `dot()`, `length()`, and `distance()` return numbers. Shape `transform()` methods accept matching transforms directly.
+Use `linearPattern`, `radialPattern`, `gridPattern`, and `pathPattern` to repeat Solid or Section recipes. A source callback can vary the geometry for each occurrence.
 
-- **Order and units:** operations and `andThen()` composition apply in written order. Rotations use degrees. Optional `{ pivot }` points use world coordinates and default to the origin.
-- **Transformed values:** `applyPoint()` includes translation; `applyDirection()` retains scale without translation; `applyNormal()` uses the inverse transpose and returns a unit vector.
-- **Interchange:** `toData()` returns canonical data. `to3D()` embeds XY placements explicitly; `to2D()` rejects plane changes.
-- **Attachment:** `Solid.attach()` and primitive attachment share source/target anchors, alignment, millimetre gap, and degree spin. Part placement can reuse finished geometry.
 - **Section patterns:** use XY directions and `Path2` trajectories. Tangent orientation aligns local +X in the XY plane; radial patterns use an XY pivot and implicit +Z axis.
 - **Solid patterns:** use XYZ inputs and explicit radial axes. Path tangent orientation aligns local +Z.
+- **Placement:** keep final part placement separate from local geometry so repeated parts can reuse their meshes.
+
+Import immutable vectors, transforms, anchors, and pure placement calculations from `/geometry`. Shared pattern option types also belong to that entry.
 
 ## Functions
 
@@ -24,12 +23,18 @@ Use `vector2`/`vector3` for immutable arithmetic and `transform2`/`transform3` f
 
 | API | Summary |
 | --- | --- |
-| [PatternSource](../PatternSource.md) | One immutable shape, or a synchronous factory called once per copy in index order. |
+| [PatternSource](../PatternSource.md) | One immutable shape, or a synchronous factory called once per copy in zero-based index order. |
 
 ## Guides
 
 - [Named anchors and custom frames](../../../guides/transforms-and-placement.md#named-anchors-and-custom-frames)
 - [Primitive booleans and repeated placement](../../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
-- [Fluent values and standalone algorithms](../../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
+- [Fluent values and standalone algorithms](../../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
+
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -8,10 +8,14 @@ Centered circular section.
 
 ## Example: Size to polygon faces
 
+
+
 ```ts
-circle({ diameter: 12, sizing: "face" });
+circle({ diameter: 12, sizing: "face" }).extrude({ height: 3 });
 ```
 
+
+
 ## Parameters
 
 <a id="options"></a>
@@ -36,10 +40,10 @@ circle({ diameter: 12, sizing: "face" });
 - [SVG sections: fills and strokes are different inputs](../../guides/svg-and-text.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/svg-and-text.md#text-and-font-variability)
 
-## Supported imports
+## Import
 
 ```ts
 import { circle } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -0,0 +1,88 @@
+# cornerCutter
+
+Creates a round or chamfer cutter at the origin for three perpendicular positive-axis faces. Complements matching edge cutters; construction, placement, and subtraction remain explicit.
+
+**cornerCutter**(`options`: [`CornerCutterOptions`](CornerCutterOptions.md)): [`Solid`](Solid.md)
+
+
+
+## Example: Amber corner cutter · Blue three-edge junction
+
+
+
+```ts
+import { box, cornerCutter, edgeCutter, generate } from "@metamesh/modeling";
+import { transform3 } from "@metamesh/modeling/geometry";
+
+const treatment = { kind: "round", radius: 5 } as const;
+const cutter = cornerCutter({ treatment, excess: 0 });
+const edge = edgeCutter({ length: 12, treatment, excess: 0 });
+const result = box({ size: 12, center: false }).subtract([
+  edge,
+  edge.rotate([0, -90, 0]).translate([12, 0, 0]),
+  edge.rotate([90, 0, 0]).translate([0, 12, 0]),
+  cutter,
+]);
+// Display the concave mask and completed upper junction from opposite sides.
+const view = (shape: typeof result, center: number, height: number) =>
+  shape.translate([-center, -center, 0]).mirror([0, 0, 1]).translate([0, 0, height]).rotate([0, 0, 90]);
+export default generate(({ part }) => [
+  part("cutter", { geometry: cutter.translate([-2.5, -2.5, 0]).rotate([0, 0, -90]), color: "#f6ad55", transform: transform3().translate([-8, -8, 0]) }),
+  part("result", { geometry: view(result, 6, 12), color: "#4f83a6", transform: transform3().translate([8, 8, 0]) }),
+]);
+```
+
+
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`CornerCutterOptions`](CornerCutterOptions.md) · Required
+
+- [`treatment`](CornerCutterOptions.md#treatment) · [`CornerCutterTreatment`](CornerCutterTreatment.md) · Required
+
+  Round sphere or triangular chamfer meeting three equal perpendicular edge treatments.
+
+- [`excess`](CornerCutterOptions.md#excess) · `number` · Optional
+
+  Numerical extension outside the three material faces, in millimetres; defaults to 0.05.
+
+- [`resolution`](CornerCutterOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+
+  Physical sphere sampling; explicit round-treatment sampling takes precedence.
+
+- [`limits`](CornerCutterOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+
+  Local allocation ceilings may only lower the evaluating host's limits.
+
+- [`attachment`](CornerCutterOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
+
+  Applied after local construction; Section attachment must preserve the XY plane.
+
+
+
+## Returns
+
+[`Solid`](Solid.md)
+
+
+## Related APIs
+
+- [CornerCutterOptions](CornerCutterOptions.md)
+- [Solid](Solid.md)
+
+## Guides
+
+- [Choose a primitive](../../guides/profiles-and-extrusion.md#choose-a-primitive)
+- [Treated boxes, frustums, and mirrored arrays](../../guides/profiles-and-extrusion.md#treated-boxes-frustums-and-mirrored-arrays)
+- [Finish a profile with a hole](../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
+- [Shape openings and local edges](../../guides/profiles-and-extrusion.md#shape-openings-and-local-edges)
+
+## Import
+
+```ts
+import { cornerCutter } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,7 +2,7 @@
 
 +Z cylinder or frustum. Face sizing compensates polygon faceting.
 
-**cylinder**(`options`: [`CylinderOptions`](../geometry/CylinderOptions.md)): [`Solid`](Solid.md)
+**cylinder**(`options`: [`CylinderOptions`](CylinderOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -30,7 +30,7 @@ cylinder({ height: 20, radius: [10, 0] });
 
 <a id="options"></a>
 
-**`options`** · [`CylinderOptions`](../geometry/CylinderOptions.md) · Required
+**`options`** · [`CylinderOptions`](CylinderOptions.md) · Required
 
 
 
@@ -41,7 +41,7 @@ cylinder({ height: 20, radius: [10, 0] });
 
 ## Related APIs
 
-- [CylinderOptions](../geometry/CylinderOptions.md)
+- [CylinderOptions](CylinderOptions.md)
 - [Solid](Solid.md)
 
 ## Guides
@@ -49,11 +49,12 @@ cylinder({ height: 20, radius: [10, 0] });
 - [Choose a primitive](../../guides/profiles-and-extrusion.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/profiles-and-extrusion.md#treated-boxes-frustums-and-mirrored-arrays)
 - [Finish a profile with a hole](../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
+- [Shape openings and local edges](../../guides/profiles-and-extrusion.md#shape-openings-and-local-edges)
 
-## Supported imports
+## Import
 
 ```ts
 import { cylinder } from "@metamesh/modeling";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.