@typecad/board-esp32-devkit 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 typecad0
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# @typecad/board-esp32-devkit
+
+ESP32 DevKit (WROOM-32) board definition package for TypeCAD.
+
+## Overview
+
+`@typecad/board-esp32-devkit` provides typed pins, peripherals, and board metadata for the standard ESP32 DevKit module (ESP32-WROOM-32 dual-core Xtensa LX6 @ 240 MHz, Wi-Fi + BLE). It re-exports the silicon-level pin definitions from [`@typecad/mcu-esp32`](../mcu-esp32) and the HAL utilities from [`@typecad/hal`](../hal) so a single import gives you everything.
+
+## Quick start
+
+```ts
+import { GPIO2, delay } from '@typecad/board';
+
+const led = GPIO2.asOutput(false);
+
+while (true) {
+  led.toggle();
+  delay(1000);
+}
+```
+
+Reference this board in `cuttlefish.config.ts`:
+
+```ts
+board: '@typecad/board-esp32-devkit',
+```
+
+## What's inside
+
+- **GPIO pins**: `GPIO0`–`GPIO39` (silicon pins from `@typecad/mcu-esp32`)
+- **Peripheral instances**: `I2C0`, `SPI0`, `UART0`, `ADC`
+- **HAL utilities** (re-exported from `@typecad/hal`): `delay`, `millis`, `Pin`, `I2CBus`, `SPIBus`, etc.
+- **Board metadata**: `BoardDefinition` manifest with PWM/analog/interrupt pin capabilities and memory specs
+
+Direct imports from `@typecad/board-esp32-devkit` are also supported when you want explicit board package references.
+
+## Related packages
+
+- [`@typecad/mcu-esp32`](../mcu-esp32) — silicon-level pin definitions for the ESP32 chip
+- [`@typecad/hal`](../hal) — hardware abstraction layer (GPIO, I2C, SPI, UART)
+
+## License
+
+MIT

package/dist/analog.d.ts

@@ -0,0 +1,4 @@
+/** Default reference (3.3V). */
+export declare const DEFAULT = 0;
+/** Internal 1.1V reference. */
+export declare const INTERNAL = 3;

package/dist/analog.js

@@ -0,0 +1,7 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32-devkit — Analog constants
+// ---------------------------------------------------------------------------
+/** Default reference (3.3V). */
+export const DEFAULT = 0;
+/** Internal 1.1V reference. */
+export const INTERNAL = 3;

package/dist/board.d.ts

@@ -0,0 +1,89 @@
+import type { BoardDefinition } from '@typecad/cuttlefish/api/schema';
+import * as boardIndex from './index.js';
+export declare const Board: {
+    readonly definition: BoardDefinition;
+    D0: boardIndex.Pin;
+    D1: boardIndex.Pin;
+    D2: boardIndex.Pin;
+    D3: boardIndex.Pin;
+    D4: boardIndex.Pin;
+    D5: boardIndex.Pin;
+    D12: boardIndex.Pin;
+    D13: boardIndex.Pin;
+    D14: boardIndex.Pin;
+    D15: boardIndex.Pin;
+    D16: boardIndex.Pin;
+    D17: boardIndex.Pin;
+    D18: boardIndex.Pin;
+    D19: boardIndex.Pin;
+    D21: boardIndex.Pin;
+    D22: boardIndex.Pin;
+    D23: boardIndex.Pin;
+    D25: boardIndex.Pin;
+    D26: boardIndex.Pin;
+    D27: boardIndex.Pin;
+    D32: boardIndex.Pin;
+    D33: boardIndex.Pin;
+    D34: boardIndex.Pin;
+    D35: boardIndex.Pin;
+    D36: boardIndex.Pin;
+    D39: boardIndex.Pin;
+    A0: boardIndex.Pin;
+    A1: boardIndex.Pin;
+    A2: boardIndex.Pin;
+    A3: boardIndex.Pin;
+    A4: boardIndex.Pin;
+    A5: boardIndex.Pin;
+    LED: boardIndex.Pin;
+    SDA: boardIndex.Pin;
+    SCL: boardIndex.Pin;
+    MOSI: boardIndex.Pin;
+    MISO: boardIndex.Pin;
+    SCK: boardIndex.Pin;
+    SS: boardIndex.Pin;
+    TX: boardIndex.Pin;
+    RX: boardIndex.Pin;
+    TX2: boardIndex.Pin;
+    RX2: boardIndex.Pin;
+    DAC1: boardIndex.Pin;
+    DAC2: boardIndex.Pin;
+    I2C0: boardIndex.I2CBus;
+    I2C1: boardIndex.I2CBus;
+    SPI0: boardIndex.SPIBus;
+    SPI1: boardIndex.SPIBus;
+    UART0: boardIndex.SerialPort;
+    UART2: boardIndex.SerialPort;
+    digital: {
+        D0: boardIndex.Pin;
+        D1: boardIndex.Pin;
+        D2: boardIndex.Pin;
+        D3: boardIndex.Pin;
+        D4: boardIndex.Pin;
+        D5: boardIndex.Pin;
+        D12: boardIndex.Pin;
+        D13: boardIndex.Pin;
+        D14: boardIndex.Pin;
+        D15: boardIndex.Pin;
+        D16: boardIndex.Pin;
+        D17: boardIndex.Pin;
+        D18: boardIndex.Pin;
+        D19: boardIndex.Pin;
+        D21: boardIndex.Pin;
+        D22: boardIndex.Pin;
+        D23: boardIndex.Pin;
+        D25: boardIndex.Pin;
+        D26: boardIndex.Pin;
+        D27: boardIndex.Pin;
+        D32: boardIndex.Pin;
+        D33: boardIndex.Pin;
+    };
+    analog: {
+        A0: boardIndex.Pin;
+        A1: boardIndex.Pin;
+        A2: boardIndex.Pin;
+        A3: boardIndex.Pin;
+        A4: boardIndex.Pin;
+        A5: boardIndex.Pin;
+    };
+};
+export default Board;

package/dist/board.js

@@ -0,0 +1,34 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32-devkit — Board namespace
+//
+// Convenience namespace that exposes every board feature under one object.
+// For method calls on pins/peripherals, prefer direct imports:
+//
+//   import { D2, UART0 } from '@typecad/board-esp32-devkit';
+//   D2.high();
+//   UART0.begin(115200);
+//
+// The Board object is useful for pin iteration and metadata access.
+// ---------------------------------------------------------------------------
+import { D0, D1, D2, D3, D4, D5, D12, D13, D14, D15, D16, D17, D18, D19, D21, D22, D23, D25, D26, D27, D32, D33, D34, D35, D36, D39, A0, A1, A2, A3, A4, A5, LED, SDA, SCL, MOSI, MISO, SCK, SS, TX, RX, TX2, RX2, DAC1, DAC2, } from './pins.js';
+import { I2C0, I2C1, SPI0, SPI1, UART0, UART2 } from '@typecad/mcu-esp32';
+import * as boardIndex from './index.js';
+export const Board = {
+    get definition() { return boardIndex.ESP32DevKit; },
+    // Output-capable GPIOs
+    D0, D1, D2, D3, D4, D5,
+    D12, D13, D14, D15, D16, D17, D18, D19,
+    D21, D22, D23, D25, D26, D27, D32, D33,
+    // Input-only pins
+    D34, D35, D36, D39,
+    // Analog aliases
+    A0, A1, A2, A3, A4, A5,
+    // Convenience aliases
+    LED, SDA, SCL, MOSI, MISO, SCK, SS, TX, RX, TX2, RX2, DAC1, DAC2,
+    // Peripherals
+    I2C0, I2C1, SPI0, SPI1, UART0, UART2,
+    // Collections
+    digital: { D0, D1, D2, D3, D4, D5, D12, D13, D14, D15, D16, D17, D18, D19, D21, D22, D23, D25, D26, D27, D32, D33 },
+    analog: { A0, A1, A2, A3, A4, A5 },
+};
+export default Board;

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+import type { BoardDefinition } from '@typecad/cuttlefish/api/schema';
+export declare const ESP32DevKit: BoardDefinition;
+export default ESP32DevKit;
+export * from '@typecad/mcu-esp32';
+export * from '@typecad/hal';
+/**
+ * Pin collections for runtime capability discovery.
+ */
+export declare const pins: {
+    /** PWM-capable pins (all output-capable GPIOs on ESP32). */
+    readonly pwm: readonly [import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin];
+    /** Analog input pins. */
+    readonly analog: readonly [import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin];
+    /** All GPIOs support interrupts on ESP32. */
+    readonly interrupt: readonly [import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin];
+    /** All digital I/O pins. */
+    readonly digital: readonly [import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin, import("@typecad/hal").Pin];
+};
+/**
+ * Peripheral-to-pin mapping for the ESP32 DevKit.
+ */
+export declare const PeripheralPins: {
+    /** I2C bus 0 — requires GPIO21 (SDA) and GPIO22 (SCL). */
+    readonly I2C0: {
+        readonly SDA: "GPIO21";
+        readonly SCL: "GPIO22";
+    };
+    /** I2C bus 1 — no fixed pins (remappable). */
+    readonly I2C1: {
+        readonly SDA: "remappable";
+        readonly SCL: "remappable";
+    };
+    /** SPI bus 0 / HSPI — GPIO13 (MOSI), GPIO12 (MISO), GPIO14 (SCK). GPIO15 is default CS. */
+    readonly SPI0: {
+        readonly MOSI: "GPIO13";
+        readonly MISO: "GPIO12";
+        readonly SCK: "GPIO14";
+        readonly CS: "GPIO15";
+    };
+    /** SPI bus 1 / VSPI — GPIO23 (MOSI), GPIO19 (MISO), GPIO18 (SCK). GPIO5 is default CS. */
+    readonly SPI1: {
+        readonly MOSI: "GPIO23";
+        readonly MISO: "GPIO19";
+        readonly SCK: "GPIO18";
+        readonly CS: "GPIO5";
+    };
+    /** UART 0 — GPIO1 (TX) and GPIO3 (RX). USB serial. */
+    readonly UART0: {
+        readonly TX: "GPIO1";
+        readonly RX: "GPIO3";
+    };
+    /** UART 2 — GPIO17 (TX) and GPIO16 (RX). */
+    readonly UART2: {
+        readonly TX: "GPIO17";
+        readonly RX: "GPIO16";
+    };
+};
+export * from './pins.js';
+export * from './analog.js';
+export { Board } from './board.js';

package/dist/index.js

@@ -0,0 +1,95 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32-devkit — Board definition manifest
+// ---------------------------------------------------------------------------
+import { ESP32WROOM32 } from '@typecad/mcu-esp32';
+/** Arduino core API version for this board's build defines. */
+const ARDUINO_CORE_VERSION = '10819';
+// ---------------------------------------------------------------------------
+// Board definition
+// ---------------------------------------------------------------------------
+export const ESP32DevKit = {
+    id: 'esp32-devkit',
+    name: 'ESP32 DevKit',
+    vendor: 'Espressif',
+    description: 'ESP32 DevKit v1 (38-pin) — ESP32-WROOM-32',
+    mcu: ESP32WROOM32,
+    clockSpeed: 240_000_000, // 240 MHz
+    // ----- Pins --------------------------------------------------------------
+    pins: {
+        ...ESP32WROOM32.pins,
+        led: 'GPIO2',
+    },
+    // ----- Peripherals -------------------------------------------------------
+    peripherals: {
+        ...ESP32WROOM32.peripherals,
+        aliases: {
+            UART0: 'Serial',
+            UART1: 'Serial1',
+            UART2: 'Serial2',
+            I2C0: 'Wire',
+            I2C1: 'Wire1',
+            SPI0: 'SPI',
+            SPI1: 'SPI1',
+        },
+    },
+    // ----- Build config ------------------------------------------------------
+    build: {
+        frameworks: {
+            platformio: 'esp32dev',
+            arduino: 'esp32:esp32:esp32',
+        },
+        defines: {
+            F_CPU: '240000000UL',
+            ARDUINO: ARDUINO_CORE_VERSION,
+            ARDUINO_ESP32_DEV: '1',
+        },
+    },
+};
+export default ESP32DevKit;
+// ---------------------------------------------------------------------------
+// Re-exports — convenience barrel
+// ---------------------------------------------------------------------------
+// Silicon-level re-exports from MCU package
+export * from '@typecad/mcu-esp32';
+// Generic HAL re-exports from @typecad/hal. Full re-export so this board package
+// is a superset of @typecad/hal — `import { ... } from '@typecad/hal'` resolves
+// here at transpile time and exposes every HAL symbol plus board-specific pins.
+export * from '@typecad/hal';
+// Board-level pin Discovery API overrides (using silicon pins from MCU)
+import { GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17, GPIO18, GPIO19, GPIO21, GPIO22, GPIO23, GPIO25, GPIO26, GPIO27, GPIO32, GPIO33, GPIO34, GPIO35, GPIO36, GPIO39, } from '@typecad/mcu-esp32';
+/**
+ * Pin collections for runtime capability discovery.
+ */
+export const pins = {
+    /** PWM-capable pins (all output-capable GPIOs on ESP32). */
+    pwm: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17, GPIO18, GPIO19, GPIO21, GPIO22, GPIO23, GPIO25, GPIO26, GPIO27, GPIO32, GPIO33],
+    /** Analog input pins. */
+    analog: [GPIO36, GPIO39, GPIO34, GPIO35, GPIO32, GPIO33],
+    /** All GPIOs support interrupts on ESP32. */
+    interrupt: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17, GPIO18, GPIO19, GPIO21, GPIO22, GPIO23, GPIO25, GPIO26, GPIO27, GPIO32, GPIO33, GPIO34, GPIO35, GPIO36, GPIO39],
+    /** All digital I/O pins. */
+    digital: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17, GPIO18, GPIO19, GPIO21, GPIO22, GPIO23, GPIO25, GPIO26, GPIO27, GPIO32, GPIO33, GPIO34, GPIO35, GPIO36, GPIO39],
+};
+/**
+ * Peripheral-to-pin mapping for the ESP32 DevKit.
+ */
+export const PeripheralPins = {
+    /** I2C bus 0 — requires GPIO21 (SDA) and GPIO22 (SCL). */
+    I2C0: { SDA: 'GPIO21', SCL: 'GPIO22' },
+    /** I2C bus 1 — no fixed pins (remappable). */
+    I2C1: { SDA: 'remappable', SCL: 'remappable' },
+    /** SPI bus 0 / HSPI — GPIO13 (MOSI), GPIO12 (MISO), GPIO14 (SCK). GPIO15 is default CS. */
+    SPI0: { MOSI: 'GPIO13', MISO: 'GPIO12', SCK: 'GPIO14', CS: 'GPIO15' },
+    /** SPI bus 1 / VSPI — GPIO23 (MOSI), GPIO19 (MISO), GPIO18 (SCK). GPIO5 is default CS. */
+    SPI1: { MOSI: 'GPIO23', MISO: 'GPIO19', SCK: 'GPIO18', CS: 'GPIO5' },
+    /** UART 0 — GPIO1 (TX) and GPIO3 (RX). USB serial. */
+    UART0: { TX: 'GPIO1', RX: 'GPIO3' },
+    /** UART 2 — GPIO17 (TX) and GPIO16 (RX). */
+    UART2: { TX: 'GPIO17', RX: 'GPIO16' },
+};
+// Board-level typed pins (including Arduino-style aliases D0, A0, etc.)
+export * from './pins.js';
+// Board-specific analog constants
+export * from './analog.js';
+// Board namespace (single-import convenience)
+export { Board } from './board.js';

package/dist/pins.d.ts

@@ -0,0 +1,36 @@
+export declare const D0: import("@typecad/hal").Pin;
+export declare const D1: import("@typecad/hal").Pin;
+export declare const D2: import("@typecad/hal").Pin;
+export declare const D3: import("@typecad/hal").Pin;
+export declare const D4: import("@typecad/hal").Pin;
+export declare const D5: import("@typecad/hal").Pin;
+export declare const D12: import("@typecad/hal").Pin;
+export declare const D13: import("@typecad/hal").Pin;
+export declare const D14: import("@typecad/hal").Pin;
+export declare const D15: import("@typecad/hal").Pin;
+export declare const D16: import("@typecad/hal").Pin;
+export declare const D17: import("@typecad/hal").Pin;
+export declare const D18: import("@typecad/hal").Pin;
+export declare const D19: import("@typecad/hal").Pin;
+export declare const D21: import("@typecad/hal").Pin;
+export declare const D22: import("@typecad/hal").Pin;
+export declare const D23: import("@typecad/hal").Pin;
+export declare const D25: import("@typecad/hal").Pin;
+export declare const D26: import("@typecad/hal").Pin;
+export declare const D27: import("@typecad/hal").Pin;
+export declare const D32: import("@typecad/hal").Pin;
+export declare const D33: import("@typecad/hal").Pin;
+export declare const D34: import("@typecad/hal").Pin;
+export declare const D35: import("@typecad/hal").Pin;
+export declare const D36: import("@typecad/hal").Pin;
+export declare const D39: import("@typecad/hal").Pin;
+/** Analog input aliases (ADC1 channels on ESP32). */
+export declare const A0: import("@typecad/hal").Pin;
+export declare const A1: import("@typecad/hal").Pin;
+export declare const A2: import("@typecad/hal").Pin;
+export declare const A3: import("@typecad/hal").Pin;
+export declare const A4: import("@typecad/hal").Pin;
+export declare const A5: import("@typecad/hal").Pin;
+/** On-board LED (GPIO2 on most ESP32 DevKit boards). */
+export declare const LED: import("@typecad/hal").Pin;
+export { SDA, SCL, MOSI, MISO, SCK, SS, TX, RX, TX2, RX2, DAC1, DAC2 } from '@typecad/mcu-esp32';

package/dist/pins.js

@@ -0,0 +1,47 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32-devkit — Pin aliases and header mappings
+// ---------------------------------------------------------------------------
+import { GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17, GPIO18, GPIO19, GPIO21, GPIO22, GPIO23, GPIO25, GPIO26, GPIO27, GPIO32, GPIO33, GPIO34, GPIO35, GPIO36, GPIO39, } from '@typecad/mcu-esp32';
+// ---------------------------------------------------------------------------
+// Arduino-style pin aliases (D-numbers match GPIO numbers on ESP32 DevKit)
+// ---------------------------------------------------------------------------
+export const D0 = GPIO0;
+export const D1 = GPIO1;
+export const D2 = GPIO2;
+export const D3 = GPIO3;
+export const D4 = GPIO4;
+export const D5 = GPIO5;
+export const D12 = GPIO12;
+export const D13 = GPIO13;
+export const D14 = GPIO14;
+export const D15 = GPIO15;
+export const D16 = GPIO16;
+export const D17 = GPIO17;
+export const D18 = GPIO18;
+export const D19 = GPIO19;
+export const D21 = GPIO21;
+export const D22 = GPIO22;
+export const D23 = GPIO23;
+export const D25 = GPIO25;
+export const D26 = GPIO26;
+export const D27 = GPIO27;
+export const D32 = GPIO32;
+export const D33 = GPIO33;
+export const D34 = GPIO34;
+export const D35 = GPIO35;
+export const D36 = GPIO36;
+export const D39 = GPIO39;
+/** Analog input aliases (ADC1 channels on ESP32). */
+export const A0 = GPIO36;
+export const A1 = GPIO39;
+export const A2 = GPIO34;
+export const A3 = GPIO35;
+export const A4 = GPIO32;
+export const A5 = GPIO33;
+// ---------------------------------------------------------------------------
+// Board-specific aliases
+// ---------------------------------------------------------------------------
+/** On-board LED (GPIO2 on most ESP32 DevKit boards). */
+export const LED = GPIO2;
+// Re-export silicon-level aliases (SDA, MOSI, etc.) from MCU package
+export { SDA, SCL, MOSI, MISO, SCK, SS, TX, RX, TX2, RX2, DAC1, DAC2 } from '@typecad/mcu-esp32';

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@typecad/board-esp32-devkit",
+  "version": "0.1.0-alpha.1",
+  "description": "TypeCAD ESP32 DevKit (WROOM-32) board definition with typed pins and peripherals",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@typecad/cuttlefish": "0.1.0-alpha.1",
+    "@typecad/hal": "0.1.0-alpha.1",
+    "@typecad/mcu-esp32": "0.1.0-alpha.1"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/justind000/typecode.git",
+    "directory": "packages/board-esp32-devkit"
+  },
+  "homepage": "https://github.com/justind000/typecode/tree/main/packages/board-esp32-devkit",
+  "bugs": {
+    "url": "https://github.com/justind000/typecode/issues"
+  },
+  "keywords": [
+    "arduino",
+    "board",
+    "cpp",
+    "cuttlefish",
+    "devkit",
+    "embedded",
+    "esp32-devkit",
+    "firmware",
+    "microcontroller",
+    "pins",
+    "typecad",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "author": "typecad0",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  }
+}

package/src/analog.ts

@@ -0,0 +1,8 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32-devkit — Analog constants
+// ---------------------------------------------------------------------------
+
+/** Default reference (3.3V). */
+export const DEFAULT = 0;
+/** Internal 1.1V reference. */
+export const INTERNAL = 3;

package/src/board.ts

@@ -0,0 +1,53 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32-devkit — Board namespace
+//
+// Convenience namespace that exposes every board feature under one object.
+// For method calls on pins/peripherals, prefer direct imports:
+//
+//   import { D2, UART0 } from '@typecad/board-esp32-devkit';
+//   D2.high();
+//   UART0.begin(115200);
+//
+// The Board object is useful for pin iteration and metadata access.
+// ---------------------------------------------------------------------------
+
+import type { BoardDefinition } from '@typecad/cuttlefish/api/schema';
+
+import {
+  D0, D1, D2, D3, D4, D5,
+  D12, D13, D14, D15, D16, D17, D18, D19,
+  D21, D22, D23, D25, D26, D27, D32, D33,
+  D34, D35, D36, D39,
+  A0, A1, A2, A3, A4, A5,
+  LED, SDA, SCL, MOSI, MISO, SCK, SS, TX, RX, TX2, RX2, DAC1, DAC2,
+} from './pins.js';
+
+import { I2C0, I2C1, SPI0, SPI1, UART0, UART2 } from '@typecad/mcu-esp32';
+import * as boardIndex from './index.js';
+
+export const Board = {
+  get definition() { return boardIndex.ESP32DevKit; },
+
+  // Output-capable GPIOs
+  D0, D1, D2, D3, D4, D5,
+  D12, D13, D14, D15, D16, D17, D18, D19,
+  D21, D22, D23, D25, D26, D27, D32, D33,
+
+  // Input-only pins
+  D34, D35, D36, D39,
+
+  // Analog aliases
+  A0, A1, A2, A3, A4, A5,
+
+  // Convenience aliases
+  LED, SDA, SCL, MOSI, MISO, SCK, SS, TX, RX, TX2, RX2, DAC1, DAC2,
+
+  // Peripherals
+  I2C0, I2C1, SPI0, SPI1, UART0, UART2,
+
+  // Collections
+  digital: { D0, D1, D2, D3, D4, D5, D12, D13, D14, D15, D16, D17, D18, D19, D21, D22, D23, D25, D26, D27, D32, D33 },
+  analog:  { A0, A1, A2, A3, A4, A5 },
+};
+
+export default Board;

package/src/index.ts

@@ -0,0 +1,119 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32-devkit — Board definition manifest
+// ---------------------------------------------------------------------------
+
+import type { BoardDefinition } from '@typecad/cuttlefish/api/schema';
+import { ESP32WROOM32 } from '@typecad/mcu-esp32';
+
+/** Arduino core API version for this board's build defines. */
+const ARDUINO_CORE_VERSION = '10819';
+
+// ---------------------------------------------------------------------------
+// Board definition
+// ---------------------------------------------------------------------------
+
+export const ESP32DevKit: BoardDefinition = {
+  id: 'esp32-devkit',
+  name: 'ESP32 DevKit',
+  vendor: 'Espressif',
+  description: 'ESP32 DevKit v1 (38-pin) — ESP32-WROOM-32',
+
+  mcu: ESP32WROOM32,
+  clockSpeed: 240_000_000, // 240 MHz
+
+  // ----- Pins --------------------------------------------------------------
+  pins: {
+    ...ESP32WROOM32.pins,
+    led: 'GPIO2',
+  },
+
+  // ----- Peripherals -------------------------------------------------------
+  peripherals: {
+    ...ESP32WROOM32.peripherals,
+    aliases: {
+      UART0: 'Serial',
+      UART1: 'Serial1',
+      UART2: 'Serial2',
+      I2C0:  'Wire',
+      I2C1:  'Wire1',
+      SPI0:  'SPI',
+      SPI1:  'SPI1',
+    },
+  },
+
+  // ----- Build config ------------------------------------------------------
+  build: {
+    frameworks: {
+      platformio: 'esp32dev',
+      arduino: 'esp32:esp32:esp32',
+    },
+    defines: {
+      F_CPU:            '240000000UL',
+      ARDUINO:          ARDUINO_CORE_VERSION,
+      ARDUINO_ESP32_DEV: '1',
+    },
+  },
+};
+
+export default ESP32DevKit;
+
+// ---------------------------------------------------------------------------
+// Re-exports — convenience barrel
+// ---------------------------------------------------------------------------
+
+// Silicon-level re-exports from MCU package
+export * from '@typecad/mcu-esp32';
+
+// Generic HAL re-exports from @typecad/hal. Full re-export so this board package
+// is a superset of @typecad/hal — `import { ... } from '@typecad/hal'` resolves
+// here at transpile time and exposes every HAL symbol plus board-specific pins.
+export * from '@typecad/hal';
+
+// Board-level pin Discovery API overrides (using silicon pins from MCU)
+import {
+  GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5,
+  GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17, GPIO18, GPIO19,
+  GPIO21, GPIO22, GPIO23, GPIO25, GPIO26, GPIO27, GPIO32, GPIO33,
+  GPIO34, GPIO35, GPIO36, GPIO39,
+} from '@typecad/mcu-esp32';
+
+/**
+ * Pin collections for runtime capability discovery.
+ */
+export const pins = {
+  /** PWM-capable pins (all output-capable GPIOs on ESP32). */
+  pwm: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17, GPIO18, GPIO19, GPIO21, GPIO22, GPIO23, GPIO25, GPIO26, GPIO27, GPIO32, GPIO33] as const,
+  /** Analog input pins. */
+  analog: [GPIO36, GPIO39, GPIO34, GPIO35, GPIO32, GPIO33] as const,
+  /** All GPIOs support interrupts on ESP32. */
+  interrupt: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17, GPIO18, GPIO19, GPIO21, GPIO22, GPIO23, GPIO25, GPIO26, GPIO27, GPIO32, GPIO33, GPIO34, GPIO35, GPIO36, GPIO39] as const,
+  /** All digital I/O pins. */
+  digital: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17, GPIO18, GPIO19, GPIO21, GPIO22, GPIO23, GPIO25, GPIO26, GPIO27, GPIO32, GPIO33, GPIO34, GPIO35, GPIO36, GPIO39] as const,
+} as const;
+
+/**
+ * Peripheral-to-pin mapping for the ESP32 DevKit.
+ */
+export const PeripheralPins = {
+  /** I2C bus 0 — requires GPIO21 (SDA) and GPIO22 (SCL). */
+  I2C0: { SDA: 'GPIO21', SCL: 'GPIO22' } as const,
+  /** I2C bus 1 — no fixed pins (remappable). */
+  I2C1: { SDA: 'remappable', SCL: 'remappable' } as const,
+  /** SPI bus 0 / HSPI — GPIO13 (MOSI), GPIO12 (MISO), GPIO14 (SCK). GPIO15 is default CS. */
+  SPI0: { MOSI: 'GPIO13', MISO: 'GPIO12', SCK: 'GPIO14', CS: 'GPIO15' } as const,
+  /** SPI bus 1 / VSPI — GPIO23 (MOSI), GPIO19 (MISO), GPIO18 (SCK). GPIO5 is default CS. */
+  SPI1: { MOSI: 'GPIO23', MISO: 'GPIO19', SCK: 'GPIO18', CS: 'GPIO5' } as const,
+  /** UART 0 — GPIO1 (TX) and GPIO3 (RX). USB serial. */
+  UART0: { TX: 'GPIO1', RX: 'GPIO3' } as const,
+  /** UART 2 — GPIO17 (TX) and GPIO16 (RX). */
+  UART2: { TX: 'GPIO17', RX: 'GPIO16' } as const,
+} as const;
+
+// Board-level typed pins (including Arduino-style aliases D0, A0, etc.)
+export * from './pins.js';
+
+// Board-specific analog constants
+export * from './analog.js';
+
+// Board namespace (single-import convenience)
+export { Board } from './board.js';

package/src/pins.ts

@@ -0,0 +1,59 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32-devkit — Pin aliases and header mappings
+// ---------------------------------------------------------------------------
+
+import {
+  GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5,
+  GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17, GPIO18, GPIO19,
+  GPIO21, GPIO22, GPIO23, GPIO25, GPIO26, GPIO27, GPIO32, GPIO33,
+  GPIO34, GPIO35, GPIO36, GPIO39,
+} from '@typecad/mcu-esp32';
+
+// ---------------------------------------------------------------------------
+// Arduino-style pin aliases (D-numbers match GPIO numbers on ESP32 DevKit)
+// ---------------------------------------------------------------------------
+
+export const D0  = GPIO0;
+export const D1  = GPIO1;
+export const D2  = GPIO2;
+export const D3  = GPIO3;
+export const D4  = GPIO4;
+export const D5  = GPIO5;
+export const D12 = GPIO12;
+export const D13 = GPIO13;
+export const D14 = GPIO14;
+export const D15 = GPIO15;
+export const D16 = GPIO16;
+export const D17 = GPIO17;
+export const D18 = GPIO18;
+export const D19 = GPIO19;
+export const D21 = GPIO21;
+export const D22 = GPIO22;
+export const D23 = GPIO23;
+export const D25 = GPIO25;
+export const D26 = GPIO26;
+export const D27 = GPIO27;
+export const D32 = GPIO32;
+export const D33 = GPIO33;
+export const D34 = GPIO34;
+export const D35 = GPIO35;
+export const D36 = GPIO36;
+export const D39 = GPIO39;
+
+/** Analog input aliases (ADC1 channels on ESP32). */
+export const A0 = GPIO36;
+export const A1 = GPIO39;
+export const A2 = GPIO34;
+export const A3 = GPIO35;
+export const A4 = GPIO32;
+export const A5 = GPIO33;
+
+// ---------------------------------------------------------------------------
+// Board-specific aliases
+// ---------------------------------------------------------------------------
+
+/** On-board LED (GPIO2 on most ESP32 DevKit boards). */
+export const LED = GPIO2;
+
+// Re-export silicon-level aliases (SDA, MOSI, etc.) from MCU package
+export { SDA, SCL, MOSI, MISO, SCK, SS, TX, RX, TX2, RX2, DAC1, DAC2 } from '@typecad/mcu-esp32';