forgecad 0.6.3 → 0.8.0

package/dist/docs-raw/generated/wood.md

@@ -0,0 +1,104 @@
+---
+skill-group: toolbox
+skill-order: 100
+---
+
+# Woodworking
+
+Wood boards with grain/species metadata, and joinery operations: dado, rabbet, mortise & tenon. Access via `Wood.*`.
+
+## Contents
+
+- [WoodBoard](#woodboard)
+- [Wood](#wood)
+
+---
+
+## Classes
+
+### `WoodBoard`
+
+A board of wood with metadata for manufacturing: grain direction, species, and dimensions. The underlying geometry is a simple box.
+
+Shape is mutable — joint operations (Wood.dado, Wood.rabbet, Wood.mortiseAndTenon) subtract material in-place. Transform methods return new WoodBoard instances preserving all metadata.
+
+**Properties:**
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `shape` | `Shape` | The underlying 3D shape — mutable, joints modify it in-place. |
+| `width` | `number` | Board width (mm) — the longer flat dimension |
+| `height` | `number` | Board height (mm) — the shorter flat dimension |
+| `thickness` | `number` | Board thickness (mm) |
+| `grain` | `string` | Grain direction: "long" or "cross" |
+| `species` | `string` | Wood species, e.g. "birch", "oak" |
+| `material` | `string` | Material label for BOM |
+
+**Methods:**
+
+#### `cut()` — Subtract a cutter from this board, modifying it in-place. Used by joint functions (dado, rabbet, mortiseAndTenon).
+
+```ts
+cut(cutter: Shape): this
+```
+
+#### `translate()` — Translate the board in 3D space.
+
+```ts
+translate(x: number, y: number, z: number): WoodBoard
+```
+
+#### `rotate()` — Rotate the board around an axis by a given angle in degrees.
+
+```ts
+rotate(axis: [ number, number, number ], angleDeg: number, options?: { pivot?: [ number, number, number ]; }): WoodBoard
+```
+
+#### `rotateX()` — Rotate the board around the X axis by a given angle in degrees.
+
+```ts
+rotateX(angleDeg: number): WoodBoard
+```
+
+#### `rotateY()` — Rotate the board around the Y axis by a given angle in degrees.
+
+```ts
+rotateY(angleDeg: number): WoodBoard
+```
+
+#### `rotateZ()` — Rotate the board around the Z axis by a given angle in degrees.
+
+```ts
+rotateZ(angleDeg: number): WoodBoard
+```
+
+#### `mirror()` — Mirror the board across a plane defined by its normal.
+
+```ts
+mirror(normal: [ number, number, number ]): WoodBoard
+```
+
+#### `color()` — Set the board's display color.
+
+```ts
+color(value: string): WoodBoard
+```
+
+#### `clone()` — Clone the board (creates an independent copy of the underlying shape).
+
+```ts
+clone(): WoodBoard
+```
+
+---
+
+## Constants
+
+### `Wood`
+
+Woodworking namespace — create boards and cut joints. **Boards:** `Wood.board()` creates a WoodBoard with grain, species, and BOM metadata. **Joints:** `Wood.dado()`, `Wood.rabbet()`, `Wood.mortiseAndTenon()` mutate boards in-place by subtracting material, following the same pattern as LaserKit's [`fingerJoint()`](/docs/sheet-metal#fingerjoint).
+
+- `readonly board: (width: number, height: number, thickness: number, opts?: WoodBoardOptions) => WoodBoard` — Create a wood board with metadata for manufacturing. The board is a box(width, height, thickness) centered on XY, base at Z=0. Width along X, height along Y, thickness along Z (0 to thickness).
+- `dado(host: WoodBoard, guest: WoodBoard, opts: DadoOptions): void` — Cut a dado (channel) across the face of a host board for a guest board to sit in. Mutates `host.shape` by subtracting a rectangular channel.
+- `rabbet(board: WoodBoard, opts: RabbetOptions): void` — Cut a rabbet (L-shaped step) along an edge of a board. Mutates `board.shape` by subtracting a step from the specified edge.
+- `mortiseAndTenon(mortiseBoard: WoodBoard, tenonBoard: WoodBoard, opts?: MortiseAndTenonOptions): void` — Cut a mortise in one board and shape a tenon on another. Mutates both boards — subtracts the mortise pocket and removes shoulder material to form the tenon.

package/dist/index.html

@@ -33,8 +33,8 @@
       * { margin: 0; padding: 0; box-sizing: border-box; }
       html, body, #root { width: 100%; min-height: 100%; background: var(--fc-bg); color: var(--fc-text); font-family: system-ui, -apple-system, sans-serif; }
     </style>
-    <script type="module" crossorigin src="/assets/index-1CYp3zUp.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-2hfs_ub0.css">
+    <script type="module" crossorigin src="/assets/index-Pz321YAt.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-ay13WNfa.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/sitemap.xml

@@ -2,37 +2,37 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://forgecad.io/</loc>
-    <lastmod>2026-04-06</lastmod>
+    <lastmod>2026-04-17</lastmod>
     <changefreq>weekly</changefreq>
     <priority>1.0</priority>
   </url>
   <url>
     <loc>https://forgecad.io/docs</loc>
-    <lastmod>2026-04-06</lastmod>
+    <lastmod>2026-04-17</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://forgecad.io/blog</loc>
-    <lastmod>2026-04-06</lastmod>
+    <lastmod>2026-04-17</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://forgecad.io/pricing</loc>
-    <lastmod>2026-04-06</lastmod>
+    <lastmod>2026-04-17</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://forgecad.io/examples</loc>
-    <lastmod>2026-04-06</lastmod>
+    <lastmod>2026-04-17</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://forgecad.io/blog/hello-forgecad-io</loc>
-    <lastmod>2026-04-06</lastmod>
+    <lastmod>2026-04-17</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.5</priority>
   </url>