forgecad 0.9.16 → 0.10.1

package/dist-skill/docs/generated/sheet-metal.md

@@ -9,19 +9,18 @@ Folded sheet metal parts with flanges, bends, and flat pattern unfolding.
 
 ## Contents
 
-- [Sheet Metal](#sheet-metal) — `sheetMetal`
-- [Laser Cutting](#laser-cutting) — `kerfCompensateOutline`, `kerfCompensateTabs`, `kerfCompensateSlots`, `kerfCompensatePart`, `lookupKerf`, `flatPanel`, `flatPart`, `fingerJoint`, `tabSlot`, `assemblyPreview`, `assemblyInstructions`, `formatInstructions`, `laserKit`
+- [Sheet Metal](#sheet-metal)
 - [SheetMetalPart](#sheetmetalpart)
 - [FlatPart](#flatpart)
 - [LaserKit](#laserkit)
 - [SHEET_METAL_EDGES](#sheet-metal-edges)
-- [COMMON_KERFS](#common-kerfs)
+- [Laser](#laser)
 
 ## Functions
 
 ### Sheet Metal
 
-#### `sheetMetal()` — Create a parametric sheet metal part with flanges, bend allowances, and flat-pattern unfolding.
+#### `sheetMetal(options: SheetMetalOptions): SheetMetalPart` — Create a parametric sheet metal part with flanges, bend allowances, and flat-pattern unfolding.
 
 `sheetMetal()` keeps one semantic model and derives both a folded 3D solid and an accurate flat pattern from it. The K-factor bend allowance is applied during unfolding. This is a strict v1 subset — it does not infer sheet metal from arbitrary solids.
 
@@ -53,10 +52,6 @@ const folded = cover.folded();
 const flat   = cover.flatPattern();
 ```
 
-```ts
-sheetMetal(options: SheetMetalOptions): SheetMetalPart
-```
-
 **`SheetMetalOptions`**
 
 | Option | Type | Description |
@@ -67,197 +62,6 @@ sheetMetal(options: SheetMetalOptions): SheetMetalPart
 | `bendAllowance` | `{ kFactor: number; }` | Bend allowance model used when computing the flat-pattern developed length. Currently only K-factor is supported. The K-factor (0–1) describes how far the neutral axis sits from the inner bend surface. Typical values: - Soft materials / large radius: 0.50 - General sheet steel: 0.42–0.44 - Hard materials / tight radius: 0.30–0.38 |
 | `cornerRelief?` | `{ kind?: "rect"; size: number; }` | Corner relief cut at each bend intersection. Prevents material overlap when two flanges meet at a corner. Defaults to a rectangular relief sized to `bendRadius + thickness` if omitted. |
 
-### Laser Cutting
-
-#### `kerfCompensateOutline()` — Apply kerf compensation to a complete part outline (outer boundary + holes).
-
-Offsets inward by half-kerf: the outer boundary shrinks and inner holes grow. This is correct because the laser beam removes material on both sides of the cut line.
-
-```ts
-kerfCompensateOutline(sketch: Sketch, kerf: number): Sketch
-```
-
-#### `kerfCompensateTabs()` — Apply kerf compensation to joint protrusions (tabs, fingers).
-
-These grow by half-kerf so they are slightly oversized and fit tightly in their mating slots after the laser removes material.
-
-```ts
-kerfCompensateTabs(sketch: Sketch, kerf: number): Sketch
-```
-
-#### `kerfCompensateSlots()` — Apply kerf compensation to joint cutouts (slots, holes that receive tabs).
-
-These grow by half-kerf so tabs can fit into them after the laser removes material from both sides of the slot walls.
-
-```ts
-kerfCompensateSlots(sketch: Sketch, kerf: number): Sketch
-```
-
-#### `kerfCompensatePart()` — Build a kerf-compensated part profile.
-
-1. Start with the base profile.
-2. Kerf-compensate each tab addition (grow by kerf/2), then union with base.
-3. Kerf-compensate each slot subtraction (grow by kerf/2), then subtract from base.
-4. Kerf-compensate the resulting outline (shrink by kerf/2).
-
-Order matters: joints modify geometry BEFORE outline compensation so the final inward offset applies uniformly to the assembled profile.
-
-```ts
-kerfCompensatePart(baseProfile: Sketch, joints: PartJoints, kerf: number): Sketch
-```
-
-**`PartJoints`**
-- `additions?: Sketch[]` — Geometry to ADD to the base profile (tabs, fingers protruding from edges).
-- `subtractions?: Sketch[]` — Geometry to SUBTRACT from the base profile (slots, holes for mating tabs).
-
-#### `lookupKerf()` — Look up kerf for a material + thickness + laser combo.
-
-If `laserType` is omitted, returns the first matching material + thickness entry. Returns `undefined` when no match is found.
-
-```ts
-lookupKerf(material: string, thickness: number, laserType?: string): number | undefined
-```
-
-#### `flatPanel()` — Create a rectangular flat panel with 4 named edges.
-
-Profile origin at bottom-left corner. Edges: bottom (y=0), right (x=width), top (y=height), left (x=0). Edge traversal follows CCW winding order.
-
-```ts
-flatPanel(name: string, width: number, height: number, thickness: number, options?: FlatPartOptions): FlatPart
-```
-
-`FlatPartOptions`: `{ material?: string, qty?: number, color?: string }`
-
-#### `flatPart()` — Create a flat part from an arbitrary profile with user-named edges.
-
-Edge normals are computed automatically (perpendicular to direction, rotated 90deg CW).
-
-```ts
-flatPart(name: string, profile: Sketch, thickness: number, edges?: Record<string, { start: [ number, number ]; end: [ number, number ]; }>, options?: FlatPartOptions): FlatPart
-```
-
-#### `fingerJoint()` — Connect two parts with finger joints along specified edges.
-
-Adds finger geometry to partA's edge, cuts matching slots from partB's edge. The joint profiles are positioned along each edge using rotation + translation.
-
-```ts
-fingerJoint(partA: FlatPart, edgeNameA: string, partB: FlatPart, edgeNameB: string, options?: FingerJointOptions & { foldAngle?: number; }): void
-```
-
-**`FingerJointOptions`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `fingers?` | `number` | Explicit finger count (must be odd, >= 3). Default: auto from length/thickness. |
-| `fingerWidth?` | `number` | Explicit finger width. Default: auto. |
-| `clearance?` | `number` | Extra clearance per side (mm). Default: 0. |
-| `kerf?` | `number` | Laser kerf (mm). Default: 0. |
-| `endStyle?` | `"full" \| "half"` | Whether edge starts with full finger or half. Default: 'full'. |
-
-#### `tabSlot()` — Connect two parts with tab-and-slot joints along specified edges.
-
-Adds tab geometry to partA's edge, cuts matching slots from partB's edge.
-
-```ts
-tabSlot(partA: FlatPart, edgeNameA: string, partB: FlatPart, edgeNameB: string, options?: TabSlotOptions & { foldAngle?: number; }): void
-```
-
-**`TabSlotOptions`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `tabCount?` | `number` | Number of tabs. Default: auto (length / (4 * thickness)). |
-| `tabWidth?` | `number` | Tab width. Default: 2 * thickness. |
-| `clearance?` | `number` | Extra clearance per side (mm). Default: 0. |
-| `kerf?` | `number` | Laser kerf (mm). Default: 0. |
-| `inset?` | `number` | Distance from panel edges to first/last tab center. Default: thickness. |
-
-#### `assemblyPreview()` — Generate a 3D assembly preview from flat parts and their joint records.
-
-The preview can fold joints partially or fully and optionally apply exploded spacing so part relationships are easier to inspect visually.
-
-```ts
-assemblyPreview(parts: FlatPart[], joints: JointRecord[], options?: AssemblyPreviewOptions): AssemblyPreviewResult
-```
-
-**`JointRecord`**
-- `foldAngle: number` — Fold angle in degrees. Default: 90.
-- Also: `type: "finger" | "tabSlot" | "snapFit", partA: string, partB: string, edgeA: string, edgeB: string`
-
-**`AssemblyPreviewOptions`**
-- `kerf?: number` — Kerf compensation passed to each part's solid(). Default: 0
-- `fold?: number` — Fold amount: 0 = flat layout, 1 = fully assembled. Default: 1
-- `explode?: number` — Explode distance: 0 = assembled, >0 = parts spread outward. Default: 0
-
-**`AssemblyPreviewResult`**
-- `shapes: ShapeGroup` — All part shapes grouped for display.
-- `partShapes: Map<string, Shape>` — Individual transformed shapes keyed by part name.
-
-#### `assemblyInstructions()` — Generate step-by-step assembly instructions from flat parts and joints.
-
-Algorithm:
-
-1. Build adjacency graph from joints
-2. Pick root part (most connections, or user-specified)
-3. BFS from root, creating one step per part addition
-4. Each step describes: which part to add, where it connects, how to orient it
-
-Heuristics for step ordering:
-
-- Start with the part that has the most connections (the base)
-- Add parts that connect to already-assembled parts first (BFS order)
-- Among candidates at the same BFS depth, prefer parts with more connections to already-assembled parts (structurally stable)
-
-```ts
-assemblyInstructions(parts: FlatPart[], joints: JointRecord[], options?: AssemblyInstructionsOptions): AssemblyInstructionsResult
-```
-
-**`AssemblyInstructionsOptions`**
-- `rootPart?: string` — Part to start from. Default: part with most joint connections.
-
-**`AssemblyInstructionsResult`**
-- `totalParts: number` — Total number of parts in the assembly.
-- `orphanParts: string[]` — Parts not connected to the joint graph (orphans).
-- Also: `steps: AssemblyStep[]`
-
-**`AssemblyStep`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `stepNumber` | `number` | 1-based step number. |
-| `description` | `string` | Human-readable instruction. |
-| `partName` | `string` | The part being added in this step. |
-| `partNumber` | `number` | Part number (for cross-ref with cut sheets). |
-| `connectsTo` | `string` | Which existing part it connects to. |
-| `jointType` | `"finger" \| "tabSlot" \| "snapFit"` | Joint type used. |
-| `newPartEdge` | `string` | The edge on the new part. |
-| `existingPartEdge` | `string` | The edge on the existing part. |
-| `foldAngle` | `number` | Fold angle in degrees. |
-| `assembledParts` | `string[]` | Part names in the assembly so far (after this step). |
-
-#### `formatInstructions()` — Format assembly instructions as a human-readable text document.
-
-Includes a "Step 0" preamble identifying the base part, followed by numbered steps, and a note about any orphan parts.
-
-```ts
-formatInstructions(result: AssemblyInstructionsResult): string
-```
-
-#### `laserKit()` — Top-level factory for creating a LaserKit container.
-
-```ts
-laserKit(options?: LaserKitOptions): LaserKit
-```
-
-**`LaserKitOptions`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `material?` | `string` | Default material label for parts that don't specify one. |
-| `sheetWidth?` | `number` | Stock sheet width in mm (default 600). |
-| `sheetHeight?` | `number` | Stock sheet height in mm (default 400). |
-| `kerf?` | `number` | Laser kerf in mm (default 0.2). |
-
 ---
 
 ## Classes
@@ -268,7 +72,7 @@ An immutable sheet metal part that accumulates flanges and cutouts.
 
 Each mutating method returns a **new** `SheetMetalPart`; the original is unchanged. The part does not produce geometry until you call `.folded()` or `.flatPattern()`.
 
-#### `flange()` — Add a 90° flange along one edge of the base panel.
+#### `flange(edge: SheetMetalEdge, options: SheetMetalFlangeOptions): SheetMetalPart` — Add a 90° flange along one edge of the base panel.
 
 Each of the four edges (`'top'`, `'right'`, `'bottom'`, `'left'`) may carry at most one flange. Calling `.flange()` twice for the same edge throws.
 
@@ -280,15 +84,11 @@ const part = sheetMetal({ panel: { width: 100, height: 60 }, thickness: 1.5, ben
   .flange('bottom', { length: 15 });
 ```
 
-```ts
-flange(edge: SheetMetalEdge, options: SheetMetalFlangeOptions): SheetMetalPart
-```
-
 **`SheetMetalFlangeOptions`**
 - `length: number` — Flange leg length in mm, measured from the outside of the bend to the tip.
 - `angleDeg?: number` — Bend angle in degrees (default: `90`). Only `90°` is supported in v1. Values other than 90 will be rejected at build time.
 
-#### `cutout()` — Subtract a 2D sketch cutout from a planar region of the sheet metal part.
+#### `cutout(region: SheetMetalPlanarRegionName, sketch: Sketch, options?: SheetMetalCutoutOptions): SheetMetalPart` — Subtract a 2D sketch cutout from a planar region of the sheet metal part.
 
 `region` must be `'panel'` or one of `'flange-top'`, `'flange-right'`, `'flange-bottom'`, `'flange-left'` (only available once the corresponding flange has been added). Cutouts inside bend regions are **not** supported in v1.
 
@@ -303,16 +103,12 @@ const part = sheetMetal({ panel: { width: 180, height: 110 }, thickness: 1.5, be
   .cutout('flange-top', roundedRect(26, 10, 5), { selfAnchor: 'center' });
 ```
 
-```ts
-cutout(region: SheetMetalPlanarRegionName, sketch: Sketch, options?: SheetMetalCutoutOptions): SheetMetalPart
-```
-
 **`SheetMetalCutoutOptions`**
 - `u?: number` — Horizontal offset within the region, measured from the region centre (mm). Default: `0`.
 - `v?: number` — Vertical offset within the region, measured from the region centre (mm). Default: `0`.
 - `selfAnchor?: Anchor` — Anchor point on the sketch that aligns to `(u, v)`. Use `'center'` for most cases. For asymmetric profiles, verify orientation by placing one test cutout before committing to the final position. Default: `'center'`.
 
-#### `regionNames()` — Return all semantic region names currently available on this part.
+#### `regionNames(): SheetMetalRegionName[]` — Return all semantic region names currently available on this part.
 
 The returned list always includes `'panel'`. For every flange that has been added, the list also includes the corresponding `'flange-<edge>'` and `'bend-<edge>'` entries.
 
@@ -320,30 +116,18 @@ Use this to discover valid targets for `.cutout()` or for querying faces by regi
 
 Defended region names: `panel` | `flange-top` | `flange-right` | `flange-bottom` | `flange-left` | `bend-top` | `bend-right` | `bend-bottom` | `bend-left`
 
-```ts
-regionNames(): SheetMetalRegionName[]
-```
-
-#### `folded()` — Materialize the 3D folded solid.
+#### `folded(): Shape` — Materialize the 3D folded solid.
 
 Applies all flanges (bent up at their configured angles) and all registered cutouts, then returns the resulting [`Shape`](/docs/core#shape). The shape is compiler-owned and exact-exportable (STEP, IGES, etc.).
 
 Prefer calling `.folded()` to validate each build step before proceeding to the final model.
 
-```ts
-folded(): Shape
-```
-
-#### `flatPattern()` — Materialize the flat-pattern (unfolded blank) for fabrication.
+#### `flatPattern(): Shape` — Materialize the flat-pattern (unfolded blank) for fabrication.
 
 Unfolds all flanges using the K-factor bend allowance and lays the result flat in the XY plane. Cutouts are projected into the flat geometry. The returned shape is exact-exportable and ready for laser / waterjet / CNC nesting workflows.
 
 The developed length of each bend zone is: `BA = (bendRadius + kFactor × thickness) × angleDeg × π / 180`
 
-```ts
-flatPattern(): Shape
-```
-
 ### `FlatPart`
 
 **Properties:**
@@ -356,158 +140,107 @@ flatPattern(): Shape
 
 **Methods:**
 
-#### `edges()` — All edges as a read-only map.
-
-```ts
-get edges(): ReadonlyMap<string, EdgeInfo>
-```
-
-#### `edge()` — Look up a named edge. Throws if the edge does not exist.
-
-```ts
-edge(name: string): EdgeInfo
-```
-
-#### `edgeNames()` — All edge names on this part.
-
-```ts
-edgeNames(): string[]
-```
-
-#### `partNumber()` — BOM part number assigned to this flat part.
-
-```ts
-get partNumber(): number
-```
-
-#### `joints()` — Joint records that attach this part to other parts in the kit.
+#### `get edges(): ReadonlyMap<string, EdgeInfo>` — All edges as a read-only map.
 
-```ts
-get joints(): readonly JointRecord[]
-```
+#### `edge(name: string): EdgeInfo` — Look up a named edge. Throws if the edge does not exist.
 
-#### `quantity()` — Requested quantity of this part in the kit. Defaults to `1`.
+#### `edgeNames(): string[]` — All edge names on this part.
 
-```ts
-get quantity(): number
-```
+#### `get partNumber(): number` — BOM part number assigned to this flat part.
 
-#### `addGeometry()` — Add geometry (e.g. protruding tabs) to the part profile.
+#### `get joints(): readonly JointRecord[]` — Joint records that attach this part to other parts in the kit.
 
-```ts
-addGeometry(sketch: Sketch): void
-```
+#### `get quantity(): number` — Requested quantity of this part in the kit. Defaults to `1`.
 
-#### `subtractGeometry()` — Subtract geometry (e.g. slot cuts) from the part profile.
+#### `addGeometry(sketch: Sketch): void` — Add geometry (e.g. protruding tabs) to the part profile.
 
-```ts
-subtractGeometry(sketch: Sketch): void
-```
+#### `subtractGeometry(sketch: Sketch): void` — Subtract geometry (e.g. slot cuts) from the part profile.
 
-#### `addJoint()` — Record a joint connection for assembly preview.
+#### `addJoint(record: JointRecord): void` — Record a joint connection for assembly preview.
 
-```ts
-addJoint(record: JointRecord): void
-```
-
-#### `profile()` — Final 2D profile with joints and optional kerf compensation.
-
-```ts
-profile(kerf?: number): Sketch
-```
+**`JointRecord`**
+- `foldAngle: number` — Fold angle in degrees. Default: 90.
+- Also: `type: "finger" | "tabSlot" | "snapFit"`, `partA: string`, `partB: string`, `edgeA: string`, `edgeB: string`.
 
-#### `solid()` — 3D solid — extrude the profile by material thickness.
+#### `profile(kerf?: number): Sketch` — Final 2D profile with joints and optional kerf compensation.
 
-```ts
-solid(kerf?: number): Shape
-```
+#### `solid(kerf?: number): Shape` — 3D solid — extrude the profile by material thickness.
 
 ### `LaserKit`
 
-#### `kerf()` — Laser kerf in mm.
+#### `get kerf(): number` — Laser kerf in mm.
 
-```ts
-get kerf(): number
-```
+#### `get parts(): readonly FlatPart[]` — All registered parts (flat, in insertion order).
 
-#### `parts()` — All registered parts (flat, in insertion order).
+#### `get material(): string` — Default material label.
 
-```ts
-get parts(): readonly FlatPart[]
-```
+#### `get sheetWidth(): number` — Stock sheet width in mm.
 
-#### `material()` — Default material label.
+#### `get sheetHeight(): number` — Stock sheet height in mm.
 
-```ts
-get material(): string
-```
+#### `addPart(part: FlatPart, overrides?: { qty?: number; }): this` — Register a flat part with this kit. Assigns a sequential part number and records the quantity.
 
-#### `sheetWidth()` — Stock sheet width in mm.
+#### `cutSheets(): CuttingLayoutResult` — Generate nested cut sheets using guillotine bin-packing.
 
-```ts
-get sheetWidth(): number
-```
+#### `bom(): LaserKitBomEntry[]` — Bill of materials listing every part with dimensions.
 
-#### `sheetHeight()` — Stock sheet height in mm.
+#### `partSvgs(): Map<string, string>` — Individual SVG string for each part profile, keyed by part name.
 
-```ts
-get sheetHeight(): number
-```
+#### `inventorySvg(): string` — Combined inventory SVG showing all parts in a labeled grid.
 
-#### `addPart()` — Register a flat part with this kit. Assigns a sequential part number and records the quantity.
+#### `assemblyPreview(options?: Omit<AssemblyPreviewOptions, "kerf">): AssemblyPreviewResult` — 3D fold-up preview of the assembled kit.
 
-```ts
-addPart(part: FlatPart, overrides?: { qty?: number; }): this
-```
+**`AssemblyPreviewOptions`**
+- `kerf?: number` — Kerf compensation passed to each part's solid(). Default: 0
+- `fold?: number` — Fold amount: 0 = flat layout, 1 = fully assembled. Default: 1
+- `explode?: number` — Explode distance: 0 = assembled, >0 = parts spread outward. Default: 0
 
-#### `cutSheets()` — Generate nested cut sheets using guillotine bin-packing.
+#### `assemblyInstructions(options?: AssemblyInstructionsOptions): AssemblyInstructionsResult` — Step-by-step assembly instructions.
 
-```ts
-cutSheets(): CuttingLayoutResult
-```
+**`AssemblyInstructionsOptions`**
+- `rootPart?: string` — Part to start from. Default: part with most joint connections.
 
-#### [`bom()`](/docs/output#bom) — Bill of materials listing every part with dimensions.
+#### `formatInstructions(options?: AssemblyInstructionsOptions): string` — Human-readable assembly instructions text.
 
-```ts
-bom(): LaserKitBomEntry[]
-```
+---
 
-#### `partSvgs()` — Individual SVG string for each part profile, keyed by part name.
+## Constants
 
-```ts
-partSvgs(): Map<string, string>
-```
+### `SHEET_METAL_EDGES`
 
-#### `inventorySvg()` — Combined inventory SVG showing all parts in a labeled grid.
+### `Laser`
 
-```ts
-inventorySvg(): string
-```
+Laser-cutting namespace — flat parts, joints, kits, kerf data, and assembly previews.
 
-#### `assemblyPreview()` — 3D fold-up preview of the assembled kit.
+**Workflow:** create parts with `Laser.panel()` / `Laser.part()`, connect them with `Laser.fingerJoint()` / `Laser.tabSlot()`, then collect them in a `Laser.kit()` for BOM, sheet nesting, SVG export, and assembly previews. The kit applies kerf compensation automatically from its `kerf` option.
 
-```ts
-assemblyPreview(options?: Omit<AssemblyPreviewOptions, "kerf">): AssemblyPreviewResult
-```
+- `panel: (name: string, width: number, height: number, thickness: number, options?: FlatPartOptions) => FlatPart` — Create a rectangular flat panel with 4 named edges.
 
-#### `assemblyInstructions()` — Step-by-step assembly instructions.
+  Profile origin at the bottom-left corner. Edges: `bottom` (y=0), `right` (x=width), `top` (y=height), `left` (x=0). Edge traversal follows CCW winding order.
+- `part: (name: string, profile: Sketch, thickness: number, edges?: Record<string, { start: Vec2; end: Vec2; }>, options?: FlatPartOptions) => FlatPart` — Create a flat part from an arbitrary 2D profile with user-named edges.
 
-```ts
-assemblyInstructions(options?: AssemblyInstructionsOptions): AssemblyInstructionsResult
-```
+  Edge normals are computed automatically (perpendicular to the edge direction, rotated 90 degrees clockwise).
+- `fingerJoint: (partA: FlatPart, edgeNameA: string, partB: FlatPart, edgeNameB: string, options?: FingerJointOptions & { foldAngle?: number; }) => void` — Connect two parts with finger joints along the named edges.
 
-#### `formatInstructions()` — Human-readable assembly instructions text.
+  Adds finger geometry to partA's edge and cuts matching slots from partB's edge; the joint is also recorded on both parts for assembly previews and instructions.
+- `tabSlot: (partA: FlatPart, edgeNameA: string, partB: FlatPart, edgeNameB: string, options?: TabSlotOptions & { foldAngle?: number; }) => void` — Connect two parts with tab-and-slot joints along the named edges.
 
-```ts
-formatInstructions(options?: AssemblyInstructionsOptions): string
-```
+  Adds tab geometry to partA's edge and cuts matching slots from partB's edge; the joint is also recorded on both parts for assembly previews and instructions.
+- `kit: (options?: LaserKitOptions) => LaserKit` — Create a LaserKit container for a flat-pack project.
 
----
+  The kit collects FlatPart instances, assigns sequential part numbers, generates a bill of materials, nests parts onto cut sheets, exports SVG views, and produces kerf-compensated assembly previews and step-by-step instructions. Kerf compensation uses the kit's `kerf` option (default 0.2 mm).
+- `assemblyPreview: (parts: FlatPart[], joints: JointRecord[], options?: AssemblyPreviewOptions) => AssemblyPreviewResult` — Generate a 3D assembly preview from flat parts and their joint records.
 
-## Constants
+  Prefer `Laser.kit(...).assemblyPreview(options)` — the kit collects the joint records and applies its kerf automatically. This standalone form defaults `kerf` to 0.
+- `instructions: (parts: FlatPart[], joints: JointRecord[], options?: AssemblyInstructionsOptions) => AssemblyInstructionsResult` — Generate step-by-step assembly instructions from flat parts and joints.
 
-### `SHEET_METAL_EDGES`
+  Prefer `Laser.kit(...).assemblyInstructions(options)` — the kit collects the joint records for you. Steps are ordered BFS from the most-connected (base) part so each new part attaches to already-assembled parts.
+- `formatInstructions: (result: AssemblyInstructionsResult) => string` — Format assembly instructions as a human-readable text document.
+
+  Includes a "Step 0" preamble identifying the base part, followed by numbered steps, and a note about any orphan parts.
+- `lookupKerf: (material: string, thickness: number, laserType?: string) => number | undefined` — Look up kerf for a material + thickness + laser combo in `Laser.COMMON_KERFS`.
 
-### `COMMON_KERFS`
+  If `laserType` is omitted, returns the first matching material + thickness entry. Returns `undefined` when no match is found. Always test-cut to verify kerf for a specific machine.
+- `COMMON_KERFS: MaterialKerfEntry[]` — Common full-kerf values by material, thickness, and laser type.
 
-Common kerf values. Users should always test-cut to verify for their specific setup.
+  Reference data only — kerf varies per machine, lens, and focus; always test-cut to verify before committing a sheet.