@typecad/board-esp32c3 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-esp32c3
+
+ESP32-C3 board definition package for TypeCAD.
+
+## Overview
+
+`@typecad/board-esp32c3` provides typed pins, peripherals, and board metadata for boards built on the ESP32-C3 (single-core 32-bit RISC-V @ 160 MHz, Wi-Fi 4 + BLE 5). It re-exports silicon-level pin definitions from [`@typecad/mcu-esp32c3`](../mcu-esp32c3) and HAL utilities from [`@typecad/hal`](../hal).
+
+## 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-esp32c3',
+```
+
+## What's inside
+
+- **GPIO pins**: `GPIO0`–`GPIO21` (silicon pins from `@typecad/mcu-esp32c3`)
+- **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-esp32c3` are also supported when you want explicit board package references.
+
+## Related packages
+
+- [`@typecad/mcu-esp32c3`](../mcu-esp32c3) — silicon-level pin definitions for the ESP32-C3 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-esp32c3 — 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,62 @@
+import type { BoardDefinition } from '@typecad/cuttlefish/api/schema';
+import * as boardIndex from './index.js';
+export declare const Board: {
+    readonly definition: BoardDefinition;
+    D2: boardIndex.Pin;
+    D3: boardIndex.Pin;
+    D4: boardIndex.Pin;
+    D5: boardIndex.Pin;
+    D6: boardIndex.Pin;
+    D7: boardIndex.Pin;
+    D8: boardIndex.Pin;
+    D9: boardIndex.Pin;
+    D10: 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;
+    D20: boardIndex.Pin;
+    D21: boardIndex.Pin;
+    A0: boardIndex.Pin;
+    A1: boardIndex.Pin;
+    A2: boardIndex.Pin;
+    A3: boardIndex.Pin;
+    A4: boardIndex.Pin;
+    I2C0: boardIndex.I2CBus;
+    SPI0: boardIndex.SPIBus;
+    UART0: boardIndex.SerialPort;
+    UART1: boardIndex.SerialPort;
+    digital: {
+        D2: boardIndex.Pin;
+        D3: boardIndex.Pin;
+        D4: boardIndex.Pin;
+        D5: boardIndex.Pin;
+        D6: boardIndex.Pin;
+        D7: boardIndex.Pin;
+        D8: boardIndex.Pin;
+        D9: boardIndex.Pin;
+        D10: 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;
+        D20: boardIndex.Pin;
+        D21: boardIndex.Pin;
+    };
+    analog: {
+        A0: boardIndex.Pin;
+        A1: boardIndex.Pin;
+        A2: boardIndex.Pin;
+        A3: boardIndex.Pin;
+        A4: boardIndex.Pin;
+    };
+};
+export default Board;

package/dist/board.js

@@ -0,0 +1,22 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32c3 — Board namespace
+//
+// Convenience namespace that exposes every board feature under one object.
+// ---------------------------------------------------------------------------
+import { D2, D3, D4, D5, D6, D7, D8, D9, D10, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, A0, A1, A2, A3, A4, } from './pins.js';
+import { I2C0, SPI0, UART0, UART1 } from '@typecad/mcu-esp32c3';
+import * as boardIndex from './index.js';
+export const Board = {
+    get definition() { return boardIndex.ESP32C3Board; },
+    // Common digital pins (strapping/USB pins omitted from the convenience namespace)
+    D2, D3, D4, D5, D6, D7, D8, D9, D10,
+    D12, D13, D14, D15, D16, D17, D18, D19, D20, D21,
+    // Analog aliases
+    A0, A1, A2, A3, A4,
+    // Peripherals
+    I2C0, SPI0, UART0, UART1,
+    // Collections
+    digital: { D2, D3, D4, D5, D6, D7, D8, D9, D10, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21 },
+    analog: { A0, A1, A2, A3, A4 },
+};
+export default Board;

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import type { BoardDefinition } from '@typecad/cuttlefish/api/schema';
+export declare const ESP32C3Board: BoardDefinition;
+export default ESP32C3Board;
+export * from '@typecad/mcu-esp32c3';
+export * from '@typecad/hal';
+/**
+ * Pin collections for runtime capability discovery.
+ */
+export declare const pins: {
+    /** PWM-capable pins (all output-capable GPIOs that are not USB/strap). */
+    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];
+    /** Analog input pins (ADC1 — usable while Wi-Fi active). */
+    readonly analog: readonly [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-C3. */
+    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];
+    /** 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];
+};
+/**
+ * Peripheral-to-pin mapping for the ESP32-C3.
+ */
+export declare const PeripheralPins: {
+    /** I2C bus 0 — default GPIO8 (SDA) / GPIO9 (SCL); remappable via GPIO matrix. */
+    readonly I2C0: {
+        readonly SDA: "GPIO8";
+        readonly SCL: "GPIO9";
+    };
+    /** SPI bus 0 / GPSPI2 — GPIO6 (MOSI), GPIO5 (MISO), GPIO4 (SCK). GPIO7 is default CS. */
+    readonly SPI0: {
+        readonly MOSI: "GPIO6";
+        readonly MISO: "GPIO5";
+        readonly SCK: "GPIO4";
+        readonly CS: "GPIO7";
+    };
+    /** UART 0 — GPIO21 (TX) / GPIO20 (RX). USB-CDC serial available too. */
+    readonly UART0: {
+        readonly TX: "GPIO21";
+        readonly RX: "GPIO20";
+    };
+    /** UART 1 — no fixed pins (remappable). */
+    readonly UART1: {
+        readonly TX: "remappable";
+        readonly RX: "remappable";
+    };
+};
+export * from './pins.js';
+export * from './analog.js';
+export { Board } from './board.js';

package/dist/index.js

@@ -0,0 +1,100 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32c3 — Board definition manifest
+// ---------------------------------------------------------------------------
+import { ESP32C3 } from '@typecad/mcu-esp32c3';
+/** Arduino core API version for this board's build defines. */
+const ARDUINO_CORE_VERSION = '10819';
+// ---------------------------------------------------------------------------
+// Board definition
+// ---------------------------------------------------------------------------
+export const ESP32C3Board = {
+    id: 'esp32c3',
+    name: 'ESP32-C3',
+    vendor: 'Espressif',
+    description: 'Generic ESP32-C3 devboard (vendor-agnostic). Single-core RISC-V ' +
+        '(RV32IMC) @ 160 MHz with Wi-Fi 4 + BLE 5 and native USB Serial/JTAG. ' +
+        '22 GPIO; no PSRAM support.',
+    mcu: ESP32C3,
+    clockSpeed: 160_000_000, // 160 MHz
+    // ----- Memory (module-level; silicon memory lives on the MCU) -----------
+    // 4 MB module flash; no external RAM (the C3 silicon does not support it).
+    memory: {
+        flash: 4 * 1024 * 1024,
+    },
+    // ----- Pins (no onboard LED declared — generic board) -------------------
+    pins: {
+        ...ESP32C3.pins,
+    },
+    // ----- Peripherals -------------------------------------------------------
+    peripherals: {
+        ...ESP32C3.peripherals,
+        aliases: {
+            UART0: 'Serial',
+            UART1: 'Serial1',
+            I2C0: 'Wire',
+            SPI0: 'SPI',
+        },
+    },
+    // ----- Build config ------------------------------------------------------
+    build: {
+        frameworks: {
+            platformio: 'esp32c3',
+            arduino: 'esp32:esp32:esp32c3',
+        },
+        defines: {
+            F_CPU: '160000000UL',
+            ARDUINO: ARDUINO_CORE_VERSION,
+            ARDUINO_ESP32C3_DEV: '1',
+        },
+    },
+};
+export default ESP32C3Board;
+// ---------------------------------------------------------------------------
+// Re-exports — convenience barrel
+// ---------------------------------------------------------------------------
+// Silicon-level
+export * from '@typecad/mcu-esp32c3';
+// 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 (uses silicon pins from MCU)
+import { GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO6, GPIO7, GPIO8, GPIO9, GPIO10, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17, GPIO18, GPIO19, GPIO20, GPIO21, } from '@typecad/mcu-esp32c3';
+/**
+ * Pin collections for runtime capability discovery.
+ */
+export const pins = {
+    /** PWM-capable pins (all output-capable GPIOs that are not USB/strap). */
+    pwm: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO6, GPIO7, GPIO8, GPIO9,
+        GPIO10, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17,
+        GPIO18, GPIO19, GPIO20, GPIO21],
+    /** Analog input pins (ADC1 — usable while Wi-Fi active). */
+    analog: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4],
+    /** All GPIOs support interrupts on ESP32-C3. */
+    interrupt: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO6, GPIO7, GPIO8, GPIO9,
+        GPIO10, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17,
+        GPIO18, GPIO19, GPIO20, GPIO21],
+    /** All digital I/O pins. */
+    digital: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO6, GPIO7, GPIO8, GPIO9,
+        GPIO10, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17,
+        GPIO18, GPIO19, GPIO20, GPIO21],
+};
+/**
+ * Peripheral-to-pin mapping for the ESP32-C3.
+ */
+export const PeripheralPins = {
+    /** I2C bus 0 — default GPIO8 (SDA) / GPIO9 (SCL); remappable via GPIO matrix. */
+    I2C0: { SDA: 'GPIO8', SCL: 'GPIO9' },
+    /** SPI bus 0 / GPSPI2 — GPIO6 (MOSI), GPIO5 (MISO), GPIO4 (SCK). GPIO7 is default CS. */
+    SPI0: { MOSI: 'GPIO6', MISO: 'GPIO5', SCK: 'GPIO4', CS: 'GPIO7' },
+    /** UART 0 — GPIO21 (TX) / GPIO20 (RX). USB-CDC serial available too. */
+    UART0: { TX: 'GPIO21', RX: 'GPIO20' },
+    /** UART 1 — no fixed pins (remappable). */
+    UART1: { TX: 'remappable', RX: 'remappable' },
+};
+// Board-level typed pins (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,27 @@
+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 D6: import("@typecad/hal").Pin;
+export declare const D7: import("@typecad/hal").Pin;
+export declare const D8: import("@typecad/hal").Pin;
+export declare const D9: import("@typecad/hal").Pin;
+export declare const D10: 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 D20: import("@typecad/hal").Pin;
+export declare const D21: import("@typecad/hal").Pin;
+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 { I2C0, SPI0, UART0, UART1 } from '@typecad/mcu-esp32c3';

package/dist/pins.js

@@ -0,0 +1,40 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32c3 — Pin aliases
+// ---------------------------------------------------------------------------
+import { GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO6, GPIO7, GPIO8, GPIO9, GPIO10, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17, GPIO18, GPIO19, GPIO20, GPIO21, } from '@typecad/mcu-esp32c3';
+// ---------------------------------------------------------------------------
+// Arduino-style digital pin aliases (D-numbers match GPIO numbers on ESP32-C3)
+// ---------------------------------------------------------------------------
+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 D6 = GPIO6;
+export const D7 = GPIO7;
+export const D8 = GPIO8;
+export const D9 = GPIO9;
+export const D10 = GPIO10;
+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 D20 = GPIO20;
+export const D21 = GPIO21;
+// ---------------------------------------------------------------------------
+// Analog input aliases (ADC1 channels — usable while Wi-Fi is active).
+// ADC2 pin (GPIO5) is omitted from Ax aliases because it is unusable while
+// Wi-Fi is enabled.
+// ---------------------------------------------------------------------------
+export const A0 = GPIO0;
+export const A1 = GPIO1;
+export const A2 = GPIO2;
+export const A3 = GPIO3;
+export const A4 = GPIO4;
+// Bus aliases (default pins for I2C0 / SPI0 / UART0)
+export { I2C0, SPI0, UART0, UART1 } from '@typecad/mcu-esp32c3';

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@typecad/board-esp32c3",
+  "version": "0.1.0-alpha.1",
+  "description": "TypeCAD ESP32-C3 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-esp32c3": "0.1.0-alpha.1"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/justind000/typecode.git",
+    "directory": "packages/board-esp32c3"
+  },
+  "homepage": "https://github.com/justind000/typecode/tree/main/packages/board-esp32c3",
+  "bugs": {
+    "url": "https://github.com/justind000/typecode/issues"
+  },
+  "keywords": [
+    "arduino",
+    "board",
+    "cpp",
+    "cuttlefish",
+    "devkit",
+    "embedded",
+    "esp32c3",
+    "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-esp32c3 — 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,36 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32c3 — Board namespace
+//
+// Convenience namespace that exposes every board feature under one object.
+// ---------------------------------------------------------------------------
+
+import type { BoardDefinition } from '@typecad/cuttlefish/api/schema';
+
+import {
+  D2, D3, D4, D5, D6, D7, D8, D9, D10,
+  D12, D13, D14, D15, D16, D17, D18, D19, D20, D21,
+  A0, A1, A2, A3, A4,
+} from './pins.js';
+
+import { I2C0, SPI0, UART0, UART1 } from '@typecad/mcu-esp32c3';
+import * as boardIndex from './index.js';
+
+export const Board = {
+  get definition() { return boardIndex.ESP32C3Board; },
+
+  // Common digital pins (strapping/USB pins omitted from the convenience namespace)
+  D2, D3, D4, D5, D6, D7, D8, D9, D10,
+  D12, D13, D14, D15, D16, D17, D18, D19, D20, D21,
+
+  // Analog aliases
+  A0, A1, A2, A3, A4,
+
+  // Peripherals
+  I2C0, SPI0, UART0, UART1,
+
+  // Collections
+  digital: { D2, D3, D4, D5, D6, D7, D8, D9, D10, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21 },
+  analog:  { A0, A1, A2, A3, A4 },
+};
+
+export default Board;

package/src/index.ts

@@ -0,0 +1,126 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32c3 — Board definition manifest
+// ---------------------------------------------------------------------------
+
+import type { BoardDefinition } from '@typecad/cuttlefish/api/schema';
+import { ESP32C3 } from '@typecad/mcu-esp32c3';
+
+/** Arduino core API version for this board's build defines. */
+const ARDUINO_CORE_VERSION = '10819';
+
+// ---------------------------------------------------------------------------
+// Board definition
+// ---------------------------------------------------------------------------
+
+export const ESP32C3Board: BoardDefinition = {
+  id: 'esp32c3',
+  name: 'ESP32-C3',
+  vendor: 'Espressif',
+  description:
+    'Generic ESP32-C3 devboard (vendor-agnostic). Single-core RISC-V ' +
+    '(RV32IMC) @ 160 MHz with Wi-Fi 4 + BLE 5 and native USB Serial/JTAG. ' +
+    '22 GPIO; no PSRAM support.',
+
+  mcu: ESP32C3,
+  clockSpeed: 160_000_000, // 160 MHz
+
+  // ----- Memory (module-level; silicon memory lives on the MCU) -----------
+  // 4 MB module flash; no external RAM (the C3 silicon does not support it).
+  memory: {
+    flash: 4 * 1024 * 1024,
+  },
+
+  // ----- Pins (no onboard LED declared — generic board) -------------------
+  pins: {
+    ...ESP32C3.pins,
+  },
+
+  // ----- Peripherals -------------------------------------------------------
+  peripherals: {
+    ...ESP32C3.peripherals,
+    aliases: {
+      UART0: 'Serial',
+      UART1: 'Serial1',
+      I2C0:  'Wire',
+      SPI0:  'SPI',
+    },
+  },
+
+  // ----- Build config ------------------------------------------------------
+  build: {
+    frameworks: {
+      platformio: 'esp32c3',
+      arduino: 'esp32:esp32:esp32c3',
+    },
+    defines: {
+      F_CPU:             '160000000UL',
+      ARDUINO:           ARDUINO_CORE_VERSION,
+      ARDUINO_ESP32C3_DEV: '1',
+    },
+  },
+};
+
+export default ESP32C3Board;
+
+// ---------------------------------------------------------------------------
+// Re-exports — convenience barrel
+// ---------------------------------------------------------------------------
+
+// Silicon-level
+export * from '@typecad/mcu-esp32c3';
+
+// 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 (uses silicon pins from MCU)
+import {
+  GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO6, GPIO7,
+  GPIO8, GPIO9, GPIO10,
+  GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17,
+  GPIO18, GPIO19, GPIO20, GPIO21,
+} from '@typecad/mcu-esp32c3';
+
+/**
+ * Pin collections for runtime capability discovery.
+ */
+export const pins = {
+  /** PWM-capable pins (all output-capable GPIOs that are not USB/strap). */
+  pwm: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO6, GPIO7, GPIO8, GPIO9,
+        GPIO10, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17,
+        GPIO18, GPIO19, GPIO20, GPIO21] as const,
+  /** Analog input pins (ADC1 — usable while Wi-Fi active). */
+  analog: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4] as const,
+  /** All GPIOs support interrupts on ESP32-C3. */
+  interrupt: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO6, GPIO7, GPIO8, GPIO9,
+              GPIO10, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17,
+              GPIO18, GPIO19, GPIO20, GPIO21] as const,
+  /** All digital I/O pins. */
+  digital: [GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO6, GPIO7, GPIO8, GPIO9,
+            GPIO10, GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17,
+            GPIO18, GPIO19, GPIO20, GPIO21] as const,
+} as const;
+
+/**
+ * Peripheral-to-pin mapping for the ESP32-C3.
+ */
+export const PeripheralPins = {
+  /** I2C bus 0 — default GPIO8 (SDA) / GPIO9 (SCL); remappable via GPIO matrix. */
+  I2C0: { SDA: 'GPIO8',  SCL: 'GPIO9'  } as const,
+  /** SPI bus 0 / GPSPI2 — GPIO6 (MOSI), GPIO5 (MISO), GPIO4 (SCK). GPIO7 is default CS. */
+  SPI0: { MOSI: 'GPIO6', MISO: 'GPIO5', SCK: 'GPIO4', CS: 'GPIO7' } as const,
+  /** UART 0 — GPIO21 (TX) / GPIO20 (RX). USB-CDC serial available too. */
+  UART0: { TX: 'GPIO21', RX: 'GPIO20' } as const,
+  /** UART 1 — no fixed pins (remappable). */
+  UART1: { TX: 'remappable', RX: 'remappable' } as const,
+} as const;
+
+// Board-level typed pins (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,38 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-esp32c3 — Pin aliases
+// ---------------------------------------------------------------------------
+
+import {
+  GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5, GPIO6, GPIO7,
+  GPIO8, GPIO9, GPIO10,
+  GPIO12, GPIO13, GPIO14, GPIO15, GPIO16, GPIO17,
+  GPIO18, GPIO19, GPIO20, GPIO21,
+} from '@typecad/mcu-esp32c3';
+
+// ---------------------------------------------------------------------------
+// Arduino-style digital pin aliases (D-numbers match GPIO numbers on ESP32-C3)
+// ---------------------------------------------------------------------------
+
+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 D6  = GPIO6;   export const D7  = GPIO7;   export const D8  = GPIO8;
+export const D9  = GPIO9;   export const D10 = GPIO10;
+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 D20 = GPIO20;
+export const D21 = GPIO21;
+
+// ---------------------------------------------------------------------------
+// Analog input aliases (ADC1 channels — usable while Wi-Fi is active).
+// ADC2 pin (GPIO5) is omitted from Ax aliases because it is unusable while
+// Wi-Fi is enabled.
+// ---------------------------------------------------------------------------
+
+export const A0 = GPIO0;
+export const A1 = GPIO1;
+export const A2 = GPIO2;
+export const A3 = GPIO3;
+export const A4 = GPIO4;
+
+// Bus aliases (default pins for I2C0 / SPI0 / UART0)
+export { I2C0, SPI0, UART0, UART1 } from '@typecad/mcu-esp32c3';