@metamesh/modeling 0.18.0 → 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,9 +18,9 @@ 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
 
@@ -29,25 +29,30 @@ Use Section methods in fluent modeling sequences. Imported `extrude`, `revolve`,
 | [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) | Controls shared by pure mesh construction and filled modeling sweeps. |
-| [ExtrudeMeshOptions](../ExtrudeMeshOptions.md) | Dimensions and sampling for pure +Z mesh extrusion, without end treatments. |
-| [ExtrusionSamplingOptions](../ExtrusionSamplingOptions.md) | Shared sampling controls for a twisted or scaled linear extrusion. |
+| [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 a horizontal height or explicit affine transform. |
 | [LoftCorrespondence](../LoftCorrespondence.md) | Associates ordered loft contours without inferring component identities or repairing topology. |
-| [LoftPlacement](../LoftPlacement.md) | A horizontal XY station height, or an explicit right-handed spatial frame, never both. |
-| [LoftStation](../LoftStation.md) | A Section or point loop at an explicit height or frame. |
-| [PathNormalGuide](../PathNormalGuide.md) | Supplies a profile-X orientation guide for each original normalized sweep station. |
 | [SweepOrientation](../SweepOrientation.md) | Explicit profile-X frame policy; all normals are directed, and selected singular policies reject. |
 
 ## Guides
 
-- [Revolve a radial profile](../../../guides/recipes.md#revolve-a-radial-profile)
-- [Rotation-minimizing path sweep](../../../guides/recipes.md#rotation-minimizing-path-sweep)
-- [Matched-section loft](../../../guides/recipes.md#matched-section-loft)
-- [Choose a modeling path](../../../guides/concepts.md#choose-a-modeling-path)
+- [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.18.0`.
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -4,33 +4,32 @@ Build typed models with optional cached computations, named parts, and structure
 
 Start with `generate(({ params, part, assert }) => ...)` and return one `part(...)` or a readonly array of parts. Parameter values are ordinary readonly data.
 
-- **Cache:** `computed(id, callback)` optionally caches pure data or geometry and tracks synchronous reads. List changing outer captures with `computed(id, () => ..., [value])`; dependency arrays supplement automatic tracking.
+- **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 |
 | --- | --- |
-| [generate](../generate.md) | Defines a typed model without executing it. Parameters are an object map of capturable data; runtime capture rejects arrays at the root, ordinary class instances, mutable buffers, and functions. Supply live capabilities through services. Use `computed` only for work worth reusing. |
-| [immutableBuffer](../immutableBuffer.md) | Copies numeric data once into private storage. This pure helper needs no active generation. |
+| [generate](../generate.md) | Defines a typed model without executing it. Parameters are an object map of capturable data; runtime capture rejects arrays at the root, ordinary class instances, mutable buffers, and functions. Supply live capabilities through services. Use `memo` only for work worth reusing. |
 
 ## Classes
 
 | API | Summary |
 | --- | --- |
-| [GenerationError](../GenerationError.md) | A user-correctable assertion failure. Successful computation caches never retain failures. |
+| [GenerationError](../GenerationError.md) | A user-correctable assertion failure. Successful memo caches never retain failures. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [ImmutableBuffer](../ImmutableBuffer-type.md) | Owned immutable numeric data. Iterate without copying; use copy() for mutable storage. |
-| [ImmutableTriangleMesh](../ImmutableTriangleMesh.md) | Immutable local XYZ positions and triangle indices, suitable for a computed value or part. |
-| [Computed](../Computed.md) | Reads immutable data or a deferred recipe; evaluation is synchronous and cached. |
+| [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. |
@@ -40,9 +39,7 @@ Start with `generate(({ params, part, assert }) => ...)` and return one `part(..
 
 | API | Summary |
 | --- | --- |
-| [NumericArray](../NumericArray.md) | Numeric storage supported by immutable generation buffers. |
 | [ImmutableValue](../ImmutableValue.md) | Deeply readonly view of captured generation data, including nested arrays and tuples. Modeling value methods keep their signatures, including explicit mutable copies. This type does not make unsupported runtime values valid generation data. |
-| [ComputedValue](../ComputedValue.md) | A value supplied immediately or by a lazy computed reader. |
 | [GenerateCallback](../GenerateCallback.md) | Pure synchronous callback returning one declared part or an array; caches are optional. |
 | [PartGeometry](../PartGeometry.md) | Manufacturing geometry; filled sections are intermediate construction values. |
 
@@ -50,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.18.0`.
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -23,8 +23,6 @@ Radial clearance is per side; axial gap is the total gap between adjacent interv
 | API | Summary |
 | --- | --- |
 | [KnuckleHinge](../KnuckleHinge-type.md) | Portable local geometry; consumers own plates, holes, part declarations, and final placement. |
-| [KnuckleHingeBaseSpec](../KnuckleHingeBaseSpec.md) | Shared knuckle-joint dimensions in millimetres, independent of mounting geometry. |
-| [KnuckleHingeSamplingOptions](../KnuckleHingeSamplingOptions.md) | Shared circular sampling for barrels, shafts, and bores. |
 | [KnuckleHingeHalfOptions](../KnuckleHingeHalfOptions.md) | Optional mounting and edge treatment for one knuckle owner. |
 | [KnuckleHingeWeb](../KnuckleHingeWeb.md) | Rectangular connection from the axis into a caller-owned mounting body, in millimetres. |
 
@@ -33,6 +31,11 @@ Radial clearance is per side; axial gap is the total gap between adjacent interv
 | API | Summary |
 | --- | --- |
 | [KnuckleHingeOptions](../KnuckleHingeOptions.md) | Joint declaration with independent attachments; unspecified sampling inherits the evaluating host. |
-| [KnuckleHingeSpec](../KnuckleHingeSpec.md) | Knuckle-joint construction modes and interval ownership. |
 
-Package: `@metamesh/modeling@0.18.0`.
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -27,14 +27,16 @@ Inspection does not certify wall thickness, overhangs, printer fit, or material
 | --- | --- |
 | [SectionInspection](../SectionInspection.md) | Immutable native filled section facts in millimetres and square millimetres. Repeated inspections of the same native shape share these facts within one revision. |
 | [SolidInspection](../SolidInspection.md) | Immutable solid bounds, emptiness, component count, volume, surface area and native tolerance. Repeated inspections of the same native shape share these facts within one revision. |
-| [TriangleMesh](../TriangleMesh.md) | A topology-preserving indexed triangle mesh with mutable owned XYZ buffers. |
-| [TriangleMeshAnalysis](../TriangleMeshAnalysis.md) | Measurements and optional edge-connected topology from one validated mesh traversal. |
-| [TriangleMeshTopologyAnalysis](../TriangleMeshTopologyAnalysis.md) | Mesh measurements with the indexed surface-shell and edge counts requested by includeTopology. |
-| [TriangleMeshMeasurements](../TriangleMeshMeasurements.md) | Geometric measurements derived from a validated, non-empty triangle mesh. |
 | [SolidSegmentHit](../SolidSegmentHit.md) | Copied surface intersection from a finite directed segment. Distance is in millimetres. |
 
 ## Guides
 
-- [Solid inspection](../../../guides/recipes.md#solid-inspection)
+- [Solid inspection](../../../guides/resolution-and-inspection.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.18.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 convex extrusions support independent bottom/top treatments.
+- **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,16 +21,22 @@ 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
 
@@ -38,34 +44,40 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 | --- | --- |
 | [Solid](../Solid.md) | Immutable deferred solid recipe. |
 | [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. |
 | [TorusOptions](../TorusOptions.md) | Dimensions and independent ring/profile tessellation for a torus around the Z axis. |
-| [SmoothEdgeTreatment](../SmoothEdgeTreatment.md) | A cubic corner transition with zero curvature at its straight tangent joins. |
-| [ProfiledEdgeTreatment](../ProfiledEdgeTreatment.md) | A deliberately sampled, inward-only corner profile with exact polyline geometry. |
+| [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. |
-| [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. |
-| [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. |
 | [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/recipes.md#choose-a-primitive)
-- [Treated boxes, frustums, and mirrored arrays](../../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
+- [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.18.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. |
@@ -29,30 +29,19 @@ Create immutable filled XY shapes, including prepared text and bounded painted S
 | API | Summary |
 | --- | --- |
 | [Section](../Section.md) | Immutable deferred filled XY section recipe. |
-| [StrokeOptions](../StrokeOptions.md) | Physical stroke and topology controls shared by pure regions and native Sections. |
-| [RectangleContourOptions](../RectangleContourOptions.md) | Shared rectangle dimensions, origin and uniform or per-corner treatment. |
 | [RectangleOptions](../RectangleOptions.md) | Rectangle dimensions, placement and uniform or per-corner treatment. |
 | [SectionOffsetOptions](../SectionOffsetOptions.md) | Options controlling robust Clipper2 region offsets. |
 | [StarOptions](../StarOptions.md) | Alternating outer and inner vertices, centered on the XY origin. |
-| [StarContourOptions](../StarContourOptions.md) | Alternating vertex radii and exact point count for a centered XY star. |
 | [SvgPathSectionOptions](../SvgPathSectionOptions.md) | Bounded filled SVG path sampling. Path scale converts user units to millimetres. |
 | [SvgSectionOptions](../SvgSectionOptions.md) | Bounded SVG document sampling. Center origin uses the final painted bounds. |
 | [TextSectionOptions](../TextSectionOptions.md) | Physical curve sampling applied to already prepared vector text. |
-| [VectorTextLayout](../VectorTextLayout.md) | Immutable vector layout with no browser, font parser, or kernel ownership. |
-| [VectorTextMetrics](../VectorTextMetrics.md) | Text measurements from the same immutable layout that supplies geometry and SVG outlines. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [StrokeCap](../StrokeCap.md) | End-cap treatment for an open stroked path. |
-| [StrokeJoin](../StrokeJoin.md) | Join treatment where adjacent stroked path segments meet. |
-| [CircleContourOptions](../CircleContourOptions.md) | Circular profile dimensions with exactly one radius or diameter and explicit sampling. |
 | [CircleOptions](../CircleOptions.md) | Circular dimensions with exactly one nominal radius or diameter. |
-| [EllipseContourOptions](../EllipseContourOptions.md) | Ellipse dimensions with exactly one XY radii or full-size tuple and explicit sampling. |
 | [EllipseOptions](../EllipseOptions.md) | Ellipse dimensions in local XY, with exactly one radii or full-size tuple. |
-| [RectangleCornerTreatment](../RectangleCornerTreatment.md) | A rectangle corner, including an explicitly untreated corner in a treatment tuple. |
-| [RectangleCornerTreatments](../RectangleCornerTreatments.md) | Corner treatments ordered top-right, top-left, bottom-left, bottom-right. |
 | [RegularPolygonOptions](../RegularPolygonOptions.md) | Regular polygon dimensions, radial convention and degree rotation. |
 | [SectionOffsetJoin](../SectionOffsetJoin.md) | Clipper2 join styles accepted by robust region offsets. |
 | [PolygonOptions](../PolygonOptions.md) | Explicit polygon topology or compound contours; all closing edges are implicit. |
@@ -60,8 +49,14 @@ Create immutable filled XY shapes, including prepared text and bounded painted S
 
 ## Guides
 
-- [Section, hole, offset, and extrusion](../../../guides/recipes.md#section-hole-offset-and-extrusion)
-- [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)
+- [Section, hole, offset, and extrusion](../../../guides/profiles-and-extrusion.md#section-hole-offset-and-extrusion)
+- [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.18.0`.
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -11,53 +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. |
-
-## Interfaces
-
-| API | Summary |
-| --- | --- |
-| [ThreadSolidPreflight](../ThreadSolidPreflight.md) | Selected sampling counts and conservative allocation estimates, before thread mesh construction. |
-| [InternalThreadCutterOptions](../InternalThreadCutterOptions.md) | Options for a compensated internal-thread subtraction tool along +Z. |
-| [PrintableThreadFitPolicy](../PrintableThreadFitPolicy.md) | Explicit radial and axial allowances for a mating printed thread pair. |
-| [ThreadedNutOptions](../ThreadedNutOptions.md) | Options for a compensated nut with an internal thread. |
-| [ThreadedNutPreflight](../ThreadedNutPreflight.md) | Resolved body and end-face dimensions plus conservative allocation estimates for the thread cutter. |
-| [ThreadedRodOptions](../ThreadedRodOptions.md) | Options for a compensated external threaded rod along +Z. |
-| [ThreadEndTreatmentOptions](../ThreadEndTreatmentOptions.md) | Axial end controls for a generated ridge. |
-| [ThreadProfile](../ThreadProfile.md) | A validated immutable periodic thread profile in `[axial, radial]` millimetres. |
-| [ThreadRidgeOptions](../ThreadRidgeOptions.md) | Runtime-neutral options for the dedicated helical ridge mesher. |
-| [ThreadBevelOptions](../ThreadBevelOptions.md) | 45-degree end bevels for compensated rods and cutters. |
-| [ThreadProfileBaseSpec](../ThreadProfileBaseSpec.md) | Fields shared by all thread profile specifications. |
-| [AcmeThreadProfileSpec](../AcmeThreadProfileSpec.md) | ACME 29-degree included-angle profile. |
-| [ButtressThreadProfileSpec](../ButtressThreadProfileSpec.md) | Asymmetric printable buttress profile with 7/45-degree flanks. |
-| [CustomThreadProfileSpec](../CustomThreadProfileSpec.md) | Caller-defined periodic axial/radial profile in millimetres. |
-| [SquareThreadProfileSpec](../SquareThreadProfileSpec.md) | Square profile with equal crest and root widths. |
-| [TrapezoidalThreadProfileSpec](../TrapezoidalThreadProfileSpec.md) | Trapezoidal thread profile with a configurable included angle. |
-| [TriangularThreadProfileSpec](../TriangularThreadProfileSpec.md) | ISO/UTS-like 60-degree truncated triangular profile. |
-
-## Type aliases
-
-| API | Summary |
-| --- | --- |
-| [PrintableThreadFit](../PrintableThreadFit.md) | Named baseline fit policies for calibrated FDM-style printed threads. |
-| [Bevel](../Bevel.md) | One size for both ends, or independent sizes in bottom/top order. Zero disables an end. |
-| [BevelSize](../BevelSize.md) | Nonnegative 45-degree axial/radial bevel size in millimetres, or factory automatic sizing. |
-| [ThreadedNutShape](../ThreadedNutShape.md) | Supported printable nut body shapes. |
-| [ThreadEndStyle](../ThreadEndStyle.md) | End shape of a generated helical ridge. |
-| [ThreadHandedness](../ThreadHandedness.md) | Direction in which a conventional helical thread advances around +Z. |
-| [ThreadLeadInEnvelope](../ThreadLeadInEnvelope.md) | Radial envelope toward which a blunt lead-in collapses. |
-| [ThreadLeadInShape](../ThreadLeadInShape.md) | BOSL2-compatible cross-section scaling curve for a blunt thread lead-in. |
-| [ThreadProfileSpec](../ThreadProfileSpec.md) | Supported built-in and caller-defined thread profiles. |
-| [ButtressPressureFlankSide](../ButtressPressureFlankSide.md) | Axial side carrying the near-normal pressure flank of a buttress thread. |
+| [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/concepts.md#check-preflight-guarantees)
+- [Preflight guarantees and host settings](../../../guides/resolution-and-inspection.md#check-preflight-guarantees)
+
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -1,64 +1,40 @@
-# 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
 
 | API | Summary |
 | --- | --- |
-| [transform2](../transform2.md) | Creates an immutable XY transform, identity by default. |
-| [transform3](../transform3.md) | Creates an immutable XYZ transform, identity by default. |
-| [vector2](../vector2.md) | Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates. |
-| [vector3](../vector3.md) | Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates. |
 | [gridPattern](../gridPattern.md) | XY or XYZ copies, optionally centered or placed in an explicit frame. |
 | [linearPattern](../linearPattern.md) | Repeats one solid along a normalized direction. |
 | [pathPattern](../pathPattern.md) | Physical arc-length copies along a sampled path, with optional tangent orientation. |
 | [radialPattern](../radialPattern.md) | Repeats one solid about an axis. |
 
-## Interfaces
-
-| API | Summary |
-| --- | --- |
-| [Transform2](../Transform2-type.md) | Immutable reusable XY placement. Methods apply in written order; angles are degrees. |
-| [Transform3](../Transform3-type.md) | Immutable reusable XYZ placement. Methods apply in written order; angles are degrees. |
-| [Pivot2Options](../Pivot2Options.md) | A fixed XY point in world coordinates; omitted pivots use the coordinate origin. |
-| [Pivot3Options](../Pivot3Options.md) | A fixed XYZ point in world coordinates; omitted pivots use the coordinate origin. |
-| [Vector2](../Vector2-type.md) | Immutable XY arithmetic; vector operations return new values and measurements return numbers. |
-| [Vector3](../Vector3-type.md) | Immutable XYZ arithmetic; vector operations return new values and measurements return numbers. |
-| [Anchor3](../Anchor3.md) | An attachment pose on a solid or assembly. |
-| [AttachOptions](../AttachOptions.md) | Options controlling how one anchor is attached to another. |
-| [PathPatternOptions](../PathPatternOptions.md) | Equal physical arc-length placements along an open or implicitly closed sampled path. |
-| [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. |
-
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [Transform2Input](../Transform2Input.md) | An immutable XY transform or its canonical row-major matrix for interchange. |
-| [Transform3Input](../Transform3Input.md) | An immutable XYZ transform or its canonical row-major matrix for interchange. |
-| [Vector2Input](../Vector2Input.md) | An XY tuple or immutable fluent vector accepted by vector operations. |
-| [Vector3Input](../Vector3Input.md) | An XYZ tuple or immutable fluent vector accepted by vector operations. |
-| [GridPatternOptions](../GridPatternOptions.md) | XY or XYZ grid with X varying fastest. The first item starts at the local origin. Dimension 2 restricts counts and spacing to XY; any frame must preserve the XY plane. |
-| [LinearPatternOptions](../LinearPatternOptions.md) | Equal linear intervals determined by exactly two of count, spacing and total length. Dimension defaults to 3; Section patterns use 2 and accept XY vector directions. |
-| [PatternSource](../PatternSource.md) | One immutable shape, or a synchronous factory called once per copy in index order. |
-| [RadialPatternOptions](../RadialPatternOptions.md) | Degree rotations about a fixed world-space pivot; XY patterns use the implicit +Z axis. |
-| [Transform2Data](../Transform2Data.md) | A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`. |
-| [Transform3Data](../Transform3Data.md) | A row-major affine 4x4 matrix applied to column vectors. |
+| [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/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)
+- [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#fluent-values-plain-data-and-descriptors)
+
+## Import
+
+```ts
+import * as model from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.18.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>
@@ -32,8 +36,14 @@ circle({ diameter: 12, sizing: "face" });
 
 ## Guides
 
-- [Section, hole, offset, and extrusion](../../guides/recipes.md#section-hole-offset-and-extrusion)
-- [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)
+- [Section, hole, offset, and extrusion](../../guides/profiles-and-extrusion.md#section-hole-offset-and-extrusion)
+- [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)
+
+## Import
+
+```ts
+import { circle } from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.18.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`.