@typecad/board-arduino-uno 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,103 @@
+# @typecad/board-arduino-uno
+
+Arduino Uno board definition package for TypeCAD.
+
+## Overview
+
+`@typecad/board-arduino-uno` provides a fully-typed TypeScript SDK for the Arduino Uno (ATmega328P). It exports pins, peripherals, timing utilities, and board metadata so TypeCAD can perform board-aware transpilation and catch hardware mistakes early.
+
+## Quick start
+
+Add or reference this board in `cuttlefish.config.ts`:
+
+```ts
+import type { CuttlefishConfig } from '@typecad/cuttlefish/api';
+
+const config: CuttlefishConfig = {
+  entry: './src/main.ts',
+  target: 'avr',
+  mcu: '@typecad/mcu-atmega328p',
+  board: '@typecad/board-arduino-uno',
+  framework: '@typecad/framework-arduino',
+  output: { framework: 'arduino', optimize: 'size' },
+};
+
+export default config;
+```
+
+Transpile and compile:
+
+```bash
+npx cuttlefish src/main.ts --compile --upload --port COM3
+```
+
+## How to use
+
+### Import styles
+
+There are several import styles:
+
+#### Virtual `@typecad/board` import (recommended)
+
+```ts
+import { D13, A0, LED, UART0, delay, millis, I2C0, SPI0, Board } from '@typecad/board';
+```
+
+The `@typecad/board` import is a virtual module that the TypeCAD transpiler resolves to whichever board package you configured in `cuttlefish.config.ts`. This is the recommended style.
+
+#### Barrel import
+
+```ts
+import {
+  D13, A0, LED, UART0, delay, millis,
+  I2C0, SPI0, Board,
+} from '@typecad/board-arduino-uno';
+```
+
+#### Board namespace
+
+```ts
+import { Board } from '@typecad/board-arduino-uno';
+
+Board.D13.high();
+Board.UART0.println('Hello');
+```
+
+### Pin and peripheral exports
+
+The package exports full Uno pin definitions plus convenience aliases:
+
+- `D0`..`D13`
+- `A0`..`A5`
+- `LED`, `SDA`, `SCL`, `MOSI`, `MISO`, `SCK`, `SS`, `TX`, `RX`
+- `I2C0`, `SPI0`, `UART0`
+- timing utilities: `delay`, `millis`, `micros`, `delayMicroseconds`, `map`, `constrain`
+- numeric helpers: `abs`, `min`, `max`, `clamp`, `inRange`, `toPercent`, `toByte`, `Num`
+- pulse helpers: `pulseIn`, `pulseInLong`, `Pulse`
+- shift utilities: `shiftIn`, `shiftOut`, `Shift`, `ShiftBitOrder`
+- random utilities: `randomSeed`, `random`, `Random`
+- analog helpers: `AnalogReference`, `analogReference`
+- interrupt helpers: `noInterrupts`, `interrupts`, `attachInterrupt`, `detachInterrupt`
+
+### Pin safety
+
+The Arduino Uno pin package exposes peripheral pin mappings and capability information that TypeCAD uses to warn about unsafe pin usage. Key reserved pin groups include:
+
+- `D0` / `D1` — UART0 RX/TX
+- `A4` / `A5` — I2C0 SDA/SCL
+- `D11` / `D12` / `D13` — SPI0 MOSI/MISO/SCK
+
+### Example
+
+```ts
+import { LED, delay, HIGH } from '@typecad/board';
+
+LED.output(HIGH);
+
+while (true) {
+  LED.toggle();
+  delay(1000);
+}
+```
+
+This package is intended to be used through the virtual `@typecad/board` import resolver in TypeCAD, but direct imports from `@typecad/board-arduino-uno` are also supported when you want explicit board package references.

package/dist/analog.d.ts

@@ -0,0 +1,6 @@
+/** Default reference (VCC). */
+export declare const DEFAULT = 0;
+/** Internal 1.1V reference. */
+export declare const INTERNAL = 3;
+/** External AREF pin. */
+export declare const EXTERNAL = 1;

package/dist/analog.js

@@ -0,0 +1,9 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-arduino-uno — Analog constants
+// ---------------------------------------------------------------------------
+/** Default reference (VCC). */
+export const DEFAULT = 0;
+/** Internal 1.1V reference. */
+export const INTERNAL = 3;
+/** External AREF pin. */
+export const EXTERNAL = 1;

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;
+    D0: boardIndex.Pin;
+    D1: boardIndex.Pin;
+    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;
+    D11: boardIndex.Pin;
+    D12: boardIndex.Pin;
+    D13: 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;
+    I2C0: boardIndex.I2CBus;
+    SPI0: boardIndex.SPIBus;
+    UART0: boardIndex.SerialPort;
+    digital: {
+        D0: boardIndex.Pin;
+        D1: boardIndex.Pin;
+        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;
+        D11: boardIndex.Pin;
+        D12: boardIndex.Pin;
+        D13: 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,26 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-arduino-uno — Board namespace
+//
+// Convenience namespace that exposes every board feature under one object.
+// For method calls on pins/peripherals, prefer direct imports:
+//
+//   import { D13, UART0 } from '@typecad/board-arduino-uno';
+//   D13.high();
+//   UART0.begin(115200);
+//
+// The Board object is useful for pin iteration and metadata access.
+// ---------------------------------------------------------------------------
+import { D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, A0, A1, A2, A3, A4, A5, LED, SDA, SCL, MOSI, MISO, SCK, SS, TX, RX, } from './pins.js';
+import { I2C0, SPI0, UART0 } from '@typecad/mcu-atmega328p';
+import * as boardIndex from './index.js';
+export const Board = {
+    get definition() { return boardIndex.ArduinoUno; },
+    D0, D1, D2, D3, D4, D5, D6, D7,
+    D8, D9, D10, D11, D12, D13,
+    A0, A1, A2, A3, A4, A5,
+    LED, SDA, SCL, MOSI, MISO, SCK, SS, TX, RX,
+    I2C0, SPI0, UART0,
+    digital: { D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13 },
+    analog: { A0, A1, A2, A3, A4, A5 },
+};
+export default Board;

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import type { BoardDefinition } from '@typecad/cuttlefish/api/schema';
+export declare const ArduinoUno: BoardDefinition;
+export default ArduinoUno;
+export * from '@typecad/mcu-atmega328p';
+export * from '@typecad/hal';
+/**
+ * Pin collections for runtime capability discovery.
+ */
+export declare const pins: {
+    /** PWM-capable pins: PD3, PD5, PD6, PB1, PB2, PB3 */
+    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];
+    /** Analog input pins: PC0, PC1, PC2, PC3, PC4, PC5 */
+    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];
+    /** External interrupt-capable pins: PD0, PD1, PD2, PD3 */
+    readonly interrupt: readonly [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];
+};
+/**
+ * Peripheral-to-pin mapping for the Arduino Uno.
+ */
+export declare const PeripheralPins: {
+    /** I2C bus 0 — requires PC4 (SDA) and PC5 (SCL). */
+    readonly I2C0: {
+        readonly SDA: "PC4";
+        readonly SCL: "PC5";
+    };
+    /** SPI bus 0 — requires PB3 (MOSI), PB4 (MISO), PB5 (SCK). PB2 is default CS. */
+    readonly SPI0: {
+        readonly MOSI: "PB3";
+        readonly MISO: "PB4";
+        readonly SCK: "PB5";
+        readonly CS: "PB2";
+    };
+    /** UART/Serial 0 — requires PD1 (TX) and PD0 (RX). */
+    readonly UART0: {
+        readonly TX: "PD1";
+        readonly RX: "PD0";
+    };
+    /** UART/Serial 1 — requires PD2 (TX) and PD3 (RX). */
+    readonly UART1: {
+        readonly TX: "PD2";
+        readonly RX: "PD3";
+    };
+};
+export * from './pins.js';
+export * from './analog.js';
+export { Board } from './board.js';

package/dist/index.js

@@ -0,0 +1,94 @@
+import { ATmega328P } from '@typecad/mcu-atmega328p';
+// ---------------------------------------------------------------------------
+// Board definition
+// ---------------------------------------------------------------------------
+export const ArduinoUno = {
+    id: 'arduino-uno',
+    name: 'Arduino Uno',
+    vendor: 'Arduino',
+    description: 'Arduino Uno Rev3 — ATmega328P',
+    mcu: ATmega328P,
+    clockSpeed: 16_000_000, // 16 MHz
+    // ----- Pins --------------------------------------------------------------
+    pins: {
+        ...ATmega328P.pins,
+        all: ATmega328P.pins.all.map(p => {
+            // Add board-specific metadata to PB5 (LED)
+            if (p.name === 'PB5') {
+                return {
+                    ...p,
+                    aliases: [...(p.aliases || []), 'LED'],
+                    onboardLed: true,
+                    alternateFunctions: [...(p.alternateFunctions || []), 'On-board LED'],
+                    warnings: [...(p.warnings || []), 'PB5 is also the on-board LED — using as GPIO conflicts with SPI0 SCK']
+                };
+            }
+            return p;
+        }),
+        led: 'PB5',
+    },
+    // ----- Peripherals -------------------------------------------------------
+    peripherals: {
+        ...ATmega328P.peripherals,
+        aliases: {
+            UART0: 'Serial',
+            I2C0: 'Wire',
+            SPI0: 'SPI',
+        },
+    },
+    // ----- Build config ------------------------------------------------------
+    build: {
+        frameworks: {
+            platformio: 'uno',
+            arduino: 'arduino:avr:uno',
+        },
+        defines: {
+            F_CPU: '16000000UL',
+            ARDUINO_AVR_UNO: '1',
+        },
+    },
+};
+export default ArduinoUno;
+// ---------------------------------------------------------------------------
+// Re-exports — convenience barrel
+// ---------------------------------------------------------------------------
+// Silicon-level re-exports from MCU package (pure silicon)
+export * from '@typecad/mcu-atmega328p';
+// 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 (using silicon pins from MCU)
+import { PD0, PD1, PD2, PD3, PD4, PD5, PD6, PD7, PB0, PB1, PB2, PB3, PB4, PB5, PC0, PC1, PC2, PC3, PC4, PC5, } from '@typecad/mcu-atmega328p';
+/**
+ * Pin collections for runtime capability discovery.
+ */
+export const pins = {
+    /** PWM-capable pins: PD3, PD5, PD6, PB1, PB2, PB3 */
+    pwm: [PD3, PD5, PD6, PB1, PB2, PB3],
+    /** Analog input pins: PC0, PC1, PC2, PC3, PC4, PC5 */
+    analog: [PC0, PC1, PC2, PC3, PC4, PC5],
+    /** External interrupt-capable pins: PD0, PD1, PD2, PD3 */
+    interrupt: [PD0, PD1, PD2, PD3],
+    /** All digital I/O pins */
+    digital: [PD0, PD1, PD2, PD3, PD4, PD5, PD6, PD7, PB0, PB1, PB2, PB3, PB4, PB5, PC0, PC1, PC2, PC3, PC4, PC5],
+};
+/**
+ * Peripheral-to-pin mapping for the Arduino Uno.
+ */
+export const PeripheralPins = {
+    /** I2C bus 0 — requires PC4 (SDA) and PC5 (SCL). */
+    I2C0: { SDA: 'PC4', SCL: 'PC5' },
+    /** SPI bus 0 — requires PB3 (MOSI), PB4 (MISO), PB5 (SCK). PB2 is default CS. */
+    SPI0: { MOSI: 'PB3', MISO: 'PB4', SCK: 'PB5', CS: 'PB2' },
+    /** UART/Serial 0 — requires PD1 (TX) and PD0 (RX). */
+    UART0: { TX: 'PD1', RX: 'PD0' },
+    /** UART/Serial 1 — requires PD2 (TX) and PD3 (RX). */
+    UART1: { TX: 'PD2', RX: 'PD3' },
+};
+// 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,24 @@
+export { PD0, PD1, PD2, PD3, PD4, PD5, PD6, PD7, PB0, PB1, PB2, PB3, PB4, PB5, PC0, PC1, PC2, PC3, PC4, PC5, } from '@typecad/mcu-atmega328p';
+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 D11: import("@typecad/hal").Pin;
+export declare const D12: import("@typecad/hal").Pin;
+export declare const D13: 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 declare const A5: import("@typecad/hal").Pin;
+/** On-board LED (PB5). */
+export declare const LED: import("@typecad/hal").Pin;
+export { SDA, SCL, MOSI, MISO, SCK, SS, TX, RX } from '@typecad/mcu-atmega328p';

package/dist/pins.js

@@ -0,0 +1,47 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-arduino-uno — Pin exports
+//
+// Each pin is a Pin instance from @typecad/hal. The transpiler inlines
+// method calls (high(), low(), write(), etc.) as direct Arduino C++.
+// Pin names use MCU port identifiers (PD0, PB5, PC0) matching the
+// ATmega328P datasheet and KiCad symbol library.
+//
+// Port-name pins are imported from the MCU package and re-exported here
+// for backward compatibility. The Pin.fromPort() factory stores both the
+// port name and the resolved Arduino pin number.
+// ---------------------------------------------------------------------------
+// Import datasheet pins from MCU package — these use Pin.fromPort() internally
+// so each Pin carries both its port name (PB5) and Arduino pin number (13).
+export { PD0, PD1, PD2, PD3, PD4, PD5, PD6, PD7, PB0, PB1, PB2, PB3, PB4, PB5, PC0, PC1, PC2, PC3, PC4, PC5, } from '@typecad/mcu-atmega328p';
+// Re-import for local aliasing
+import { PD0, PD1, PD2, PD3, PD4, PD5, PD6, PD7, PB0, PB1, PB2, PB3, PB4, PB5, PC0, PC1, PC2, PC3, PC4, PC5, } from '@typecad/mcu-atmega328p';
+// ---------------------------------------------------------------------------
+// Arduino-style pin aliases (D0–D13, A0–A5)
+// ---------------------------------------------------------------------------
+export const D0 = PD0;
+export const D1 = PD1;
+export const D2 = PD2;
+export const D3 = PD3;
+export const D4 = PD4;
+export const D5 = PD5;
+export const D6 = PD6;
+export const D7 = PD7;
+export const D8 = PB0;
+export const D9 = PB1;
+export const D10 = PB2;
+export const D11 = PB3;
+export const D12 = PB4;
+export const D13 = PB5;
+export const A0 = PC0;
+export const A1 = PC1;
+export const A2 = PC2;
+export const A3 = PC3;
+export const A4 = PC4;
+export const A5 = PC5;
+// ---------------------------------------------------------------------------
+// Convenience aliases
+// ---------------------------------------------------------------------------
+/** On-board LED (PB5). */
+export const LED = PB5;
+// Re-export silicon-level aliases (SDA, MOSI, etc.) from MCU package
+export { SDA, SCL, MOSI, MISO, SCK, SS, TX, RX } from '@typecad/mcu-atmega328p';

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@typecad/board-arduino-uno",
+  "version": "0.1.0-alpha.1",
+  "description": "TypeCAD Arduino Uno 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-atmega328p": "0.1.0-alpha.1"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/justind000/typecode.git",
+    "directory": "packages/board-arduino-uno"
+  },
+  "homepage": "https://github.com/justind000/typecode/tree/main/packages/board-arduino-uno",
+  "bugs": {
+    "url": "https://github.com/justind000/typecode/issues"
+  },
+  "keywords": [
+    "arduino",
+    "arduino-uno",
+    "board",
+    "cpp",
+    "cuttlefish",
+    "devkit",
+    "embedded",
+    "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/USAGE.md

@@ -0,0 +1,485 @@
+# Arduino Uno TypeCAD SDK — Usage Guide
+
+The `@typecad/board-arduino-uno` package provides a fully-typed TypeScript
+SDK for the Arduino Uno (ATmega328P).  Every pin, peripheral, and timing
+function carries rich type information so that TypeScript catches hardware
+errors **at compile time** — before you flash anything.
+
+---
+
+## Quick Start
+
+```typescript
+// cuttlefish.config.ts
+import type { CuttlefishConfig } from '@typecad/cuttlefish/api';
+
+const config: CuttlefishConfig = {
+  entry: './src/main.ts',
+  target: 'avr',
+  mcu: '@typecad/mcu-atmega328p',
+  board: '@typecad/board-arduino-uno',
+  framework: '@typecad/framework-arduino',
+  output: { framework: 'arduino', optimize: 'size' },
+};
+export default config;
+```
+
+Then create your firmware in TypeScript and transpile:
+
+```bash
+npx tsc -p tsconfig.json                         # build the transpiler
+node dist/cli.js transpile main.ts \
+  --target arduino --fqbn arduino:avr:uno         # TS → C++
+arduino-cli compile --fqbn arduino:avr:uno main   # compile to hex
+arduino-cli upload  --fqbn arduino:avr:uno -p COM3 main  # flash
+```
+
+---
+
+## Importing
+
+There are two import styles — pick whichever you prefer.
+
+### Style 1: Individual imports (tree-shakeable)
+
+```typescript
+import { D13, A0 }        from '@typecad/board-arduino-uno/pins';
+import { UART0 }          from '@typecad/board-arduino-uno/peripherals';
+import { delay, millis }  from '@typecad/board-arduino-uno/timing';
+```
+
+### Style 2: Unified `Board` namespace
+
+```typescript
+import { Board } from '@typecad/board-arduino-uno/board';
+
+Board.D13.high();
+Board.UART0.println("Hello");
+```
+
+### Style 3: Barrel import (everything)
+
+```typescript
+import {
+  D13, A0, LED, UART0, delay, millis,
+  I2C0, SPI0, Board,
+} from '@typecad/board-arduino-uno';
+```
+
+### Style 4: Virtual `@typecad/board` import (recommended)
+
+```typescript
+import { D13, A0, LED, UART0, delay, millis, I2C0, SPI0, Board } from '@typecad/board';
+```
+
+---
+
+## Pin System
+
+### Pin types at a glance
+
+| Export | TypeScript Type | Capabilities |
+|--------|----------------|--------------|
+| `D0`, `D1` | `IDigitalPin & IInterruptPin` | Digital I/O + external interrupt |
+| `D2` | `IDigitalPin & IInterruptPin` | Digital I/O + INT0 |
+| `D3` | `IPWMPin` | Digital I/O + PWM (Timer2B) + INT1 |
+| `D4`, `D7`, `D8`, `D12` | `IDigitalPin` | Digital I/O only |
+| `D5`, `D6` | `IPWMPin` | Digital I/O + PWM (Timer0) |
+| `D9`, `D10`, `D11` | `IPWMPin` | Digital I/O + PWM (Timer1/2) |
+| `D13` | `IDigitalPin` | Digital I/O (+ onboard LED) |
+| `A0`–`A5` | `IAnalogInput` | 10-bit ADC input |
+
+### Convenience Aliases
+
+| Alias | Points to | Function |
+|-------|-----------|----------|
+| `LED` | `D13` | Onboard LED |
+| `SDA` | `A4` | I2C data |
+| `SCL` | `A5` | I2C clock |
+| `MOSI` | `D11` | SPI master out |
+| `MISO` | `D12` | SPI master in |
+| `SCK` | `D13` | SPI clock |
+| `SS` | `D10` | SPI slave select |
+| `TX` | `D1` | UART transmit |
+| `RX` | `D0` | UART receive |
+
+### Alias And Timer Notes
+
+- `LED` and `D13` are the same physical pin. Use one name consistently.
+- `SDA/A4`, `SCL/A5`, `TX/D1`, and `RX/D0` follow the same rule.
+- PWM pins are grouped by timer on Uno: `D5/D6` share `timer0`, `D9/D10` share `timer1`, and `D3/D11` share `timer2`.
+
+TypeCAD surfaces both conditions as diagnostics so the schematic does not stay hidden until runtime.
+
+### Type Safety in Action
+
+```typescript
+import { D4, A0 } from '@typecad/board-arduino-uno/pins';
+
+// ✅ OK  — D4 is IDigitalPin, supports .high()
+D4.high();
+
+// ✅ OK  — A0 is IAnalogInput, supports .readAnalog()
+const value = A0.readAnalog();
+
+// ❌ COMPILE ERROR — IAnalogInput has no .high() method
+A0.high();  // Property 'high' does not exist on type 'IAnalogInput'
+
+// ❌ COMPILE ERROR — IDigitalPin has no .pwm()
+D4.pwm(50);  // Property 'pwm' does not exist on type 'IDigitalPin'
+
+// ✅ OK  — D5 is IPWMPin, supports .pwm()
+import { D5 } from '@typecad/board-arduino-uno/pins';
+D5.pwm(50);
+```
+
+---
+
+## Examples
+
+Each example below is a complete, self-contained `.ts` file that the
+transpiler converts to a valid `.ino` sketch.
+
+### 1. Blink (Hello World)
+
+```typescript
+// examples/01-blink.ts
+import { LED, delay, HIGH } from '@typecad/board';
+
+LED.output(HIGH);
+
+while (true) {
+  LED.toggle();
+  delay(1000);
+}
+```
+
+**Generated C++:**
+```cpp
+void setup() {
+  pinMode(13, OUTPUT);
+}
+void loop() {
+  digitalWrite(13, !digitalRead(13));
+  delay(1000);
+}
+```
+
+---
+
+### 2. Analog Read → Serial
+
+```typescript
+// examples/02-analog-serial.ts
+import { A0, UART0, delay } from '@typecad/board';
+
+UART0.begin(9600);
+
+while (true) {
+  const value = A0.readAnalog();
+  UART0.println(value.toString());
+  delay(500);
+}
+```
+
+---
+
+### 3. PWM Fade
+
+```typescript
+// examples/03-pwm-fade.ts
+import { D9, delay, LOW } from '@typecad/board';
+
+D9.output(LOW);
+
+let brightness = 0;
+let step = 5;
+
+while (true) {
+  D9.pwm(brightness / 2.55);
+  brightness += step;
+  if (brightness <= 0 || brightness >= 255) {
+    step = -step;
+  }
+  delay(30);
+}
+```
+
+---
+
+### 4. External Interrupt (Button)
+
+```typescript
+// examples/04-interrupt.ts
+import { D2, LED, LOW } from '@typecad/board';
+
+LED.output(LOW);
+D2.inputPullUp();
+
+let ledState = false;
+
+D2.onFalling(() => {
+  ledState = !ledState;
+  if (ledState) {
+    LED.high();
+  } else {
+    LED.low();
+  }
+});
+```
+
+---
+
+### 5. I2C — Read From a Sensor
+
+```typescript
+// examples/05-i2c-sensor.ts
+import { I2C0, UART0, delay } from '@typecad/board';
+
+UART0.begin(9600);
+I2C0.begin();                      // Wire.begin() - master mode
+
+const BME280_ADDR = 0x76;
+
+while (true) {
+  // Read 2 bytes from register 0xFA (temperature data)
+  const tempData = I2C0.device(BME280_ADDR).readBytes(0xFA, 2);
+  const msb = tempData[0];
+  const lsb = tempData[1];
+  const tempRaw = (msb << 8) | lsb;
+  const temperature = tempRaw / 100.0;
+  
+  UART0.println(temperature.toString());
+  delay(1000);
+}
+```
+
+---
+
+### 6. SPI — Write to a Shift Register
+
+```typescript
+// examples/06-spi-shift-register.ts
+import { SPI0, SS, delay, LOW } from '@typecad/board';
+
+SPI0.begin();
+SPI0.setFrequency(1_000_000);
+SS.output(LOW);
+
+let pattern = 0b00000001;
+
+while (true) {
+  SPI0.device(SS).write(pattern);
+
+  // rotate left
+  pattern = ((pattern << 1) | (pattern >> 7)) & 0xFF;
+  delay(200);
+}
+```
+
+---
+
+### 7. Board Namespace (All-In-One)
+
+```typescript
+// examples/07-board-namespace.ts
+import { Board, LOW } from '@typecad/board';
+
+Board.UART0.begin(115200);
+Board.LED.output(LOW);
+
+Board.UART0.println("Arduino Uno booted");
+Board.UART0.println("MCU: " + Board.definition.mcu);
+Board.UART0.println("Flash: " + Board.definition.memory.flash + " bytes");
+
+while (true) {
+  const sensor = Board.A0.readAnalog();
+  Board.UART0.println(sensor.toString());
+  Board.LED.toggle();
+}
+```
+
+---
+
+## Peripheral Reference
+
+### Serial (UART 0)
+
+```typescript
+import { UART0 } from '@typecad/board';
+
+UART0.begin(9600);
+UART0.println("Hello, World!");
+UART0.print("Value: ");
+UART0.println(42);
+UART0.flush();   // wait for transmit buffer to empty
+```
+
+### I2C0 (Wire)
+
+```typescript
+import { I2C0, UART0 } from '@typecad/board';
+
+// Initialize as master
+I2C0.begin();            // 100 kHz (default)
+I2C0.setClock(400000);   // optionally switch to 400 kHz fast mode
+
+const DEVICE_ADDR = 0x76;
+
+// Read bytes from a register
+const data = I2C0.device(DEVICE_ADDR).readBytes(0xFA, 2);
+UART0.println(`Received: ${data[0]}, ${data[1]}`);
+
+// Write bytes to a register
+I2C0.device(DEVICE_ADDR).writeByte(0xF4, 0x27);
+```
+
+#### Wire-Compatible API
+
+This API directly maps to Arduino's Wire library:
+
+```typescript
+import { I2C0 } from '@typecad/board';
+import { I2CStatus } from '@typecad/hal';
+
+// Initialize as master
+I2C0.begin();
+
+// Set clock speed (optional, default 100kHz)
+I2C0.setClock(400000);  // 400 kHz fast mode
+
+// Write to a device with error checking
+I2C0.beginTransmission(0x68);  // MPU-6050 address
+I2C0.write(0x6B);              // PWR_MGMT_1 register
+I2C0.write(0x00);              // wake up
+const status = I2C0.endTransmission();
+
+// Check status (I2CStatus enum)
+if (status === I2CStatus.SUCCESS) {
+  // Write succeeded
+} else if (status === I2CStatus.NACK_ON_ADDRESS) {
+  // Device not responding
+}
+
+// Read from a device
+I2C0.beginTransmission(0x68);
+I2C0.write(0x75);              // WHO_AM_I register
+I2C0.endTransmission();
+
+const bytesReceived = I2C0.requestFrom(0x68, 1);
+if (bytesReceived > 0) {
+  const whoAmI = I2C0.read();
+}
+```
+
+#### Error Codes (I2CStatus)
+
+| Status | Value | Description |
+|--------|-------|-------------|
+| `SUCCESS` | 0 | Operation completed successfully |
+| `DATA_TOO_LONG` | 1 | Transmit buffer overflow |
+| `NACK_ON_ADDRESS` | 2 | NACK received on address (device not found) |
+| `NACK_ON_DATA` | 3 | NACK received on data byte |
+| `OTHER_ERROR` | 4 | Other error |
+| `PARTIAL_READ` | 5 | Fewer bytes read than requested |
+
+### SPI0
+
+```typescript
+import { SPI0, SS, D10 } from '@typecad/board';
+
+// Initialize and configure
+SPI0.begin();
+SPI0.setFrequency(4_000_000);
+SPI0.setMode(0);
+SPI0.setBitOrder('msb');
+
+// Chip select pin
+const CS = D10;
+CS.output(HIGH);  // HIGH = deselected
+
+// Single byte transfer with fluent device API
+const response = SPI0.device(CS).transfer(0x55);
+
+// Write data to device
+SPI0.device(CS).write(0xFF);
+
+// Multi-byte transfer
+const rxData = SPI0.device(CS).transfer(new Uint8Array([0x80, 0x00, 0xFF]));
+```
+
+---
+
+## Timing Functions
+
+```typescript
+import { delay, millis, micros, delayMicroseconds } from '@typecad/board';
+
+delay(1000);             // block 1 second
+delayMicroseconds(10);   // block 10 µs
+
+const t = millis();      // ms since reset
+const us = micros();     // µs since reset
+```
+
+---
+
+## Utility Functions
+
+```typescript
+import { map, constrain } from '@typecad/board';
+
+// Re-map a 10-bit ADC reading (0–1023) to an 8-bit PWM range (0–255)
+const pwmValue = map(sensorReading, 0, 1023, 0, 255);
+
+// Clamp a value to the valid PWM range
+const clamped = constrain(pwmValue, 0, 255);
+```
+
+---
+
+## Board Definition Metadata
+
+The `ArduinoUno` constant (or `Board.definition`) exposes the full hardware
+manifest at design time.
+
+```typescript
+import { ArduinoUno, Board } from '@typecad/board';
+
+// Access via ArduinoUno export
+console.log(ArduinoUno.name);             // "Arduino Uno"
+console.log(ArduinoUno.mcu);              // "ATmega328P"
+console.log(ArduinoUno.clockSpeed);       // 16000000
+console.log(ArduinoUno.memory.flash);     // 32768
+console.log(ArduinoUno.memory.sram);      // 2048
+console.log(ArduinoUno.memory.eeprom);    // 1024
+console.log(ArduinoUno.pins.pwm);         // ["D3","D5","D6","D9","D10","D11"]
+console.log(ArduinoUno.features.watchdog);// true
+console.log(ArduinoUno.build.frameworks.arduino);    // "arduino:avr:uno"
+
+// Or via Board namespace
+console.log(Board.definition.name);       // "Arduino Uno"
+```
+
+---
+
+## Project Structure (Recommended)
+
+```
+my-project/
+├── cuttlefish.config.ts        ← board + target selection
+├── main.ts                      ← your firmware
+├── lib/
+│   └── bme280.ts                ← reusable driver (uses core interfaces)
+├── code/
+│   ├── core/                    ← @typecad/cuttlefish type system
+│   └── board-arduino-uno/       ← board SDK
+│       ├── index.ts             ← barrel export + ArduinoUno manifest
+│       ├── board.ts             ← Board namespace (single-import)
+│       ├── pins.ts              ← Typed pin exports (D0-D13, A0-A5)
+│       ├── peripherals.ts       ← I2C0, SPI0, Serial stubs
+│       ├── timing.ts            ← delay, millis, micros
+│       ├── analog.ts            ← analogReference
+│       └── interrupts.ts        ← noInterrupts, attachInterrupt
+└── out/                         ← generated .ino files
+```

package/src/analog.ts

@@ -0,0 +1,10 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-arduino-uno — Analog constants
+// ---------------------------------------------------------------------------
+
+/** Default reference (VCC). */
+export const DEFAULT = 0;
+/** Internal 1.1V reference. */
+export const INTERNAL = 3;
+/** External AREF pin. */
+export const EXTERNAL = 1;

package/src/board.ts

@@ -0,0 +1,41 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-arduino-uno — Board namespace
+//
+// Convenience namespace that exposes every board feature under one object.
+// For method calls on pins/peripherals, prefer direct imports:
+//
+//   import { D13, UART0 } from '@typecad/board-arduino-uno';
+//   D13.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, D6, D7,
+  D8, D9, D10, D11, D12, D13,
+  A0, A1, A2, A3, A4, A5,
+  LED, SDA, SCL, MOSI, MISO, SCK, SS, TX, RX,
+} from './pins.js';
+
+import { I2C0, SPI0, UART0 } from '@typecad/mcu-atmega328p';
+import * as boardIndex from './index.js';
+
+export const Board = {
+  get definition() { return boardIndex.ArduinoUno; },
+
+  D0, D1, D2, D3, D4, D5, D6, D7,
+  D8, D9, D10, D11, D12, D13,
+  A0, A1, A2, A3, A4, A5,
+
+  LED, SDA, SCL, MOSI, MISO, SCK, SS, TX, RX,
+
+  I2C0, SPI0, UART0,
+
+  digital: { D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13 },
+  analog:  { A0, A1, A2, A3, A4, A5 },
+};
+
+export default Board;

package/src/index.ts

@@ -0,0 +1,115 @@
+import type { BoardDefinition } from '@typecad/cuttlefish/api/schema';
+import { ATmega328P } from '@typecad/mcu-atmega328p';
+
+// ---------------------------------------------------------------------------
+// Board definition
+// ---------------------------------------------------------------------------
+
+export const ArduinoUno: BoardDefinition = {
+  id: 'arduino-uno',
+  name: 'Arduino Uno',
+  vendor: 'Arduino',
+  description: 'Arduino Uno Rev3 — ATmega328P',
+
+  mcu: ATmega328P,
+  clockSpeed: 16_000_000, // 16 MHz
+
+  // ----- Pins --------------------------------------------------------------
+  pins: {
+    ...ATmega328P.pins,
+    all: ATmega328P.pins.all.map(p => {
+      // Add board-specific metadata to PB5 (LED)
+      if (p.name === 'PB5') {
+        return {
+          ...p,
+          aliases: [...(p.aliases || []), 'LED'],
+          onboardLed: true,
+          alternateFunctions: [...(p.alternateFunctions || []), 'On-board LED'],
+          warnings: [...(p.warnings || []), 'PB5 is also the on-board LED — using as GPIO conflicts with SPI0 SCK']
+        };
+      }
+      return p;
+    }),
+    led: 'PB5',
+  },
+
+  // ----- Peripherals -------------------------------------------------------
+  peripherals: {
+    ...ATmega328P.peripherals,
+    aliases: {
+      UART0: 'Serial',
+      I2C0:  'Wire',
+      SPI0:  'SPI',
+    },
+  },
+
+  // ----- Build config ------------------------------------------------------
+  build: {
+    frameworks: {
+      platformio: 'uno',
+      arduino: 'arduino:avr:uno',
+    },
+    defines: {
+      F_CPU:           '16000000UL',
+      ARDUINO_AVR_UNO: '1',
+    },
+  },
+};
+
+export default ArduinoUno;
+
+// ---------------------------------------------------------------------------
+// Re-exports — convenience barrel
+// ---------------------------------------------------------------------------
+
+// Silicon-level re-exports from MCU package (pure silicon)
+export * from '@typecad/mcu-atmega328p';
+
+// 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 (using silicon pins from MCU)
+import {
+  PD0, PD1, PD2, PD3, PD4, PD5, PD6, PD7,
+  PB0, PB1, PB2, PB3, PB4, PB5,
+  PC0, PC1, PC2, PC3, PC4, PC5,
+} from '@typecad/mcu-atmega328p';
+
+/**
+ * Pin collections for runtime capability discovery.
+ */
+export const pins = {
+  /** PWM-capable pins: PD3, PD5, PD6, PB1, PB2, PB3 */
+  pwm: [PD3, PD5, PD6, PB1, PB2, PB3] as const,
+  /** Analog input pins: PC0, PC1, PC2, PC3, PC4, PC5 */
+  analog: [PC0, PC1, PC2, PC3, PC4, PC5] as const,
+  /** External interrupt-capable pins: PD0, PD1, PD2, PD3 */
+  interrupt: [PD0, PD1, PD2, PD3] as const,
+  /** All digital I/O pins */
+  digital: [PD0, PD1, PD2, PD3, PD4, PD5, PD6, PD7, PB0, PB1, PB2, PB3, PB4, PB5, PC0, PC1, PC2, PC3, PC4, PC5] as const,
+} as const;
+
+/**
+ * Peripheral-to-pin mapping for the Arduino Uno.
+ */
+export const PeripheralPins = {
+  /** I2C bus 0 — requires PC4 (SDA) and PC5 (SCL). */
+  I2C0: { SDA: 'PC4', SCL: 'PC5' } as const,
+  /** SPI bus 0 — requires PB3 (MOSI), PB4 (MISO), PB5 (SCK). PB2 is default CS. */
+  SPI0: { MOSI: 'PB3', MISO: 'PB4', SCK: 'PB5', CS: 'PB2' } as const,
+  /** UART/Serial 0 — requires PD1 (TX) and PD0 (RX). */
+  UART0: { TX: 'PD1', RX: 'PD0' } as const,
+  /** UART/Serial 1 — requires PD2 (TX) and PD3 (RX). */
+  UART1: { TX: 'PD2', RX: 'PD3' } 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,63 @@
+// ---------------------------------------------------------------------------
+// @typecad/board-arduino-uno — Pin exports
+//
+// Each pin is a Pin instance from @typecad/hal. The transpiler inlines
+// method calls (high(), low(), write(), etc.) as direct Arduino C++.
+// Pin names use MCU port identifiers (PD0, PB5, PC0) matching the
+// ATmega328P datasheet and KiCad symbol library.
+//
+// Port-name pins are imported from the MCU package and re-exported here
+// for backward compatibility. The Pin.fromPort() factory stores both the
+// port name and the resolved Arduino pin number.
+// ---------------------------------------------------------------------------
+
+// Import datasheet pins from MCU package — these use Pin.fromPort() internally
+// so each Pin carries both its port name (PB5) and Arduino pin number (13).
+export {
+  PD0, PD1, PD2, PD3, PD4, PD5, PD6, PD7,
+  PB0, PB1, PB2, PB3, PB4, PB5,
+  PC0, PC1, PC2, PC3, PC4, PC5,
+} from '@typecad/mcu-atmega328p';
+
+// Re-import for local aliasing
+import {
+  PD0, PD1, PD2, PD3, PD4, PD5, PD6, PD7,
+  PB0, PB1, PB2, PB3, PB4, PB5,
+  PC0, PC1, PC2, PC3, PC4, PC5,
+} from '@typecad/mcu-atmega328p';
+
+// ---------------------------------------------------------------------------
+// Arduino-style pin aliases (D0–D13, A0–A5)
+// ---------------------------------------------------------------------------
+
+export const D0  = PD0;
+export const D1  = PD1;
+export const D2  = PD2;
+export const D3  = PD3;
+export const D4  = PD4;
+export const D5  = PD5;
+export const D6  = PD6;
+export const D7  = PD7;
+export const D8  = PB0;
+export const D9  = PB1;
+export const D10 = PB2;
+export const D11 = PB3;
+export const D12 = PB4;
+export const D13 = PB5;
+
+export const A0 = PC0;
+export const A1 = PC1;
+export const A2 = PC2;
+export const A3 = PC3;
+export const A4 = PC4;
+export const A5 = PC5;
+
+// ---------------------------------------------------------------------------
+// Convenience aliases
+// ---------------------------------------------------------------------------
+
+/** On-board LED (PB5). */
+export const LED  = PB5;
+
+// Re-export silicon-level aliases (SDA, MOSI, etc.) from MCU package
+export { SDA, SCL, MOSI, MISO, SCK, SS, TX, RX } from '@typecad/mcu-atmega328p';