@typecad/cuttlefish 1.0.0-alpha.13 → 1.0.0-alpha.14

package/assets/editor-extensions/typecad-debug/README.md

@@ -0,0 +1,142 @@
+# TypeCAD Debug
+
+A Visual Studio Code extension that bridges VSCode's breakpoint gutter to the
+TypeCAD `Serial.print` debug pipeline. Set breakpoints in your `.ts` source;
+this extension syncs them to `.cuttlefish/breakpoints.json`, which the
+`@typecad/cuttlefish` transpiler reads (when run with `--debug`) to inject
+`Serial.println` instrumentation that reports variable values and lets you
+step through execution.
+
+This is the producer half of a two-part system. The consumer half lives in
+[`@typecad/cuttlefish`](../../packages/cuttlefish/src/debug/) and is the
+authoritative source for the on-disk schema and matching behavior described
+below.
+
+## Install
+
+This package is `private: true` and is **not** published to the npm registry
+or the VS Code Marketplace. Build the VSIX locally:
+
+```sh
+cd packages/vscode-typecad-debug
+npm install
+npm run compile
+npm run package        # produces vscode-typecad-debug-0.2.0.vsix
+code --install-extension vscode-typecad-debug-0.2.0.vsix
+```
+
+## Usage
+
+1. Open the Command Palette (`Ctrl/Cmd+Shift+P`).
+2. Run **TypeCAD: Debug with Breakpoints** — or set red-dot breakpoints in the
+   gutter and run `cuttlefish build --debug` in a terminal.
+3. Breakpoints (including conditional breakpoints and logpoints) are written
+   to `.cuttlefish/breakpoints.json` on every breakpoint change and on every
+   `.ts` save.
+4. Upload the instrumented firmware and open a serial monitor (`--monitor`).
+   At each breakpoint the firmware prints the location, the original source
+   line, and the variables in scope, then halts. Two keys are available:
+   - **ENTER** — continue (the breakpoint will halt here again the next time
+     execution reaches it).
+   - **`s`** — skip this breakpoint for the rest of the run: it won't halt
+     here again until the device reboots. Other breakpoints are unaffected.
+
+### Commands
+
+| Command | Title |
+|---|---|
+| `typecad-debug.toggleBreakpoint` | TypeCAD: Toggle Breakpoint (bound to `F9` in `.ts` files) |
+| `typecad-debug.clearAllBreakpoints` | TypeCAD: Clear All Breakpoints |
+| `typecad-debug.debugWithBreakpoints` | TypeCAD: Debug with Breakpoints |
+| `typecad-debug.syncBreakpoints` | TypeCAD: Sync Breakpoints from VS Code |
+| `typecad-debug.generateDeclaration` | TypeCAD: Generate Declaration from C++ |
+
+### Enabling instrumentation
+
+Breakpoints are only injected when cuttlefish is run with `--debug`:
+
+```sh
+cuttlefish build --debug                                    # uses cuttlefish.config.ts entry
+cuttlefish src/index.ts --debug --framework @typecad/framework-arduino --compile --upload --port COM4
+```
+
+See `cuttlefish --help` for the full `--debug` description.
+
+## `.cuttlefish/breakpoints.json` schema
+
+The file lives at the project root (or any ancestor of the entry file's
+directory). Each entry uses **the basename** of the source file as `file`
+(this is the only path form that matches reliably on both Windows and POSIX
+under cuttlefish's basename-matching loader):
+
+```jsonc
+{
+  "breakpoints": [
+    { "file": "index.ts", "line": 12 },
+    { "file": "index.ts", "line": 27, "condition": "counter > 5" },
+    { "file": "sensor.ts", "line": 8, "logMessage": "reading = {value}" }
+  ]
+}
+```
+
+| Field | Type | Required | Notes |
+|---|---|---|---|
+| `file` | string | yes | Source file **basename** (e.g. `index.ts`). |
+| `line` | number | yes | 1-indexed line number. `0` is dropped. |
+| `condition` | string | no | Conditional expression; `===`/`!==` are auto-normalized to `==`/`!=` for C++. |
+| `logMessage` | string | no | Logpoint with `{variable}` interpolation. When present, the breakpoint logs instead of halting. |
+
+Two source files sharing the same basename in one project will share
+breakpoints — acceptable for typical single-sketch Arduino projects.
+
+## Native debugging on ESP32-S3
+
+For ESP32-S3, this extension's printf instrumentation is superseded by a
+native GDB path. `cuttlefish build --debug` on `esp32s3` emits `#line`
+directives in the generated C++ and writes `.vscode/launch.json` +
+`tasks.json` (at the git/workspace root, where VS Code reads them) plus
+`openocd.cfg` + `sdkconfig.defaults.debug` next to the build output. Press
+**F5** in VS Code and the generated config attaches GDB to the chip's
+built-in USB-Serial-JTAG — one USB cable, no external probe.
+
+For Zephyr projects (`@typecad/framework-zephyr` on an esp32s3 board),
+`cuttlefish create` writes the same starter artifacts at project creation —
+`.vscode/launch.json` + `tasks.json` + `src/out/.cuttlefish/openocd.cfg` —
+so F5 works on a fresh project before any build: the preLaunch task runs
+`cuttlefish build --compile --upload --debug`, which builds, flashes, and
+re-merges the launch entry with the build-cache-resolved gdbPath. (The
+starter gdbPath is probed from `$ZEPHYR_SDK_INSTALL_DIR`, the
+zephyr-installer micromamba layout, or `~/zephyr-sdk-*`.)
+
+`launch.json` ships a single **`gdbtarget`** configuration, provided by the
+ESP-IDF VS Code extension. The extension's gdbtarget adapter manages OpenOCD
+itself (via its OpenOCD Manager, reading `idf.openOcdConfigs` from settings).
+The `preLaunchTask` is just `build + flash` — no competing OpenOCD process.
+Install the ESP-IDF extension (which bundles OpenOCD + the xtensa GDB, and
+requires ESP-IDF itself configured), set the board's serial port in
+`cuttlefish.config.ts` (`console.port`) or pass `--port`. See
+`demos/demo/README.md` for the full F5 flow.
+
+The printf instrumentation documented below remains the path for targets that
+don't yet support native debugging (Arduino, other ESP32 variants).
+
+## Limitations
+
+- This is a `Serial.print`-based instrumentation shim, not a DAP debug
+  adapter. There is no native step/step-in/step-out — each breakpoint halts
+  until ENTER (continue) or `s` (skip this breakpoint for the run) is received
+  over serial. **On ESP32-S3, use the native GDB path above instead** — it
+  provides full stepping, call stacks, and TS-named variable inspection.
+- The scope analyzer captures module-scope identifiers plus locals and
+  parameters in the enclosing function. Member access and arbitrary
+  expressions are not resolved; `{ value }` in a logpoint emits the literal
+  `"{value}"` if `value` is not in scope.
+- Baud rate is hardcoded to `9600` in the injected `Serial.begin` regardless
+  of the CLI `--baud` value.
+- **Target-specific output:** on Arduino/AVR the injected code uses `Serial.*`
+  and blocks on `Serial.available()`. On ESP-IDF (`@typecad/framework-esp32`)
+  it routes through native `printf` and blocks on `getchar()` with the task
+  watchdog fed — so an ESP32 debug build must have `idf.py monitor` (or
+  equivalent) attached, or it will hang at the first breakpoint until power
+  is cycled. This is the ESP-IDF equivalent of "no IDE attached to a
+  breakpoint."

package/assets/editor-extensions/typecad-debug/out/extension.js

@@ -0,0 +1,347 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// vscode-typecad-debug — VSCode Extension
+//
+// Tracks breakpoints in TypeScript files and syncs them to
+// .cuttlefish/breakpoints.json for the TypeCAD debug preprocessor.
+// Also auto-generates .d.ts declaration files from C++ sources.
+//
+// The breakpoint file is read by @typecad/cuttlefish when invoked with
+// `--debug`. The preprocessor injects Serial.println instrumentation at the
+// recorded line numbers; run `cuttlefish build --debug` (or `cuttlefish
+// index.ts --debug`) to enable it.
+//
+// IMPORTANT: the `file` field in each breakpoint entry is written as the
+// basename only (e.g. "index.ts"). The cuttlefish loader matches breakpoints
+// by exact → basename → suffix, and basename matching is the only strategy
+// that works identically on Windows (backslash) and POSIX (forward slash)
+// without slash normalization. The trade-off is that two files with the same
+// basename in one project share breakpoints — acceptable for typical
+// single-sketch Arduino projects.
+// ---------------------------------------------------------------------------
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activate = activate;
+exports.deactivate = deactivate;
+const vscode = __importStar(require("vscode"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Relative to the workspace root. */
+const BREAKPOINTS_DIR = '.cuttlefish';
+const BREAKPOINTS_FILE = 'breakpoints.json';
+// ---------------------------------------------------------------------------
+// Extension Activation
+// ---------------------------------------------------------------------------
+function activate(context) {
+    console.log('TypeCAD Debug extension activated');
+    const breakpointTracker = new BreakpointTracker();
+    const toggleCmd = vscode.commands.registerCommand('typecad-debug.toggleBreakpoint', () => breakpointTracker.toggleBreakpoint());
+    const clearAllCmd = vscode.commands.registerCommand('typecad-debug.clearAllBreakpoints', () => breakpointTracker.clearAllBreakpoints());
+    const debugCmd = vscode.commands.registerCommand('typecad-debug.debugWithBreakpoints', () => breakpointTracker.debugWithBreakpoints());
+    const syncCmd = vscode.commands.registerCommand('typecad-debug.syncBreakpoints', () => breakpointTracker.syncFromVSCode());
+    // Auto-sync breakpoints when saving TypeScript files.
+    const saveListener = vscode.workspace.onDidSaveTextDocument((doc) => {
+        if (doc.fileName.endsWith('.ts') && !doc.fileName.includes('node_modules')) {
+            breakpointTracker.syncFromVSCode();
+        }
+    });
+    const declGenerator = new DeclarationGenerator();
+    const genDeclCmd = vscode.commands.registerCommand('typecad-debug.generateDeclaration', () => declGenerator.generateForCurrentFile());
+    // Auto-generate a .d.ts when a C++ file is saved and the sidecar is missing.
+    const cppSaveListener = vscode.workspace.onDidSaveTextDocument((doc) => {
+        if (doc.fileName.endsWith('.cpp') && !doc.fileName.includes('node_modules')) {
+            declGenerator.checkAndGenerate(doc.fileName);
+        }
+    });
+    context.subscriptions.push(toggleCmd, clearAllCmd, debugCmd, syncCmd, saveListener, breakpointTracker, genDeclCmd, cppSaveListener, declGenerator);
+}
+function deactivate() { }
+// ---------------------------------------------------------------------------
+// Breakpoint Tracker
+// ---------------------------------------------------------------------------
+class BreakpointTracker {
+    constructor() {
+        /** file fsPath → line → Breakpoint. Keys are full fsPaths for dedup. */
+        this.breakpoints = new Map();
+        this._onDidChange = new vscode.EventEmitter();
+        this.onDidChange = this._onDidChange.event;
+        this.loadFromFile();
+        // VSCode breakpoint gutter changes (red dots, conditions, logpoints).
+        vscode.debug.onDidChangeBreakpoints(() => {
+            console.log('TypeCAD: Breakpoint change detected');
+            this.syncFromVSCode();
+        });
+        // Re-sync when switching editor so a stale in-memory map doesn't survive.
+        vscode.window.onDidChangeActiveTextEditor((editor) => {
+            if (editor) {
+                this.syncFromVSCode();
+            }
+        });
+    }
+    /**
+     * Toggle a breakpoint at the current cursor position.
+     */
+    toggleBreakpoint() {
+        const editor = vscode.window.activeTextEditor;
+        if (!editor)
+            return;
+        const filePath = editor.document.uri.fsPath;
+        const fileName = path.basename(filePath);
+        const line = editor.selection.active.line + 1; // 1-indexed
+        if (!this.breakpoints.has(fileName)) {
+            this.breakpoints.set(fileName, new Map());
+        }
+        const fileBreakpoints = this.breakpoints.get(fileName);
+        if (fileBreakpoints.has(line)) {
+            fileBreakpoints.delete(line);
+            vscode.window.showInformationMessage(`TypeCAD: Breakpoint removed at line ${line}`);
+        }
+        else {
+            fileBreakpoints.set(line, { file: fileName, line });
+            vscode.window.showInformationMessage(`TypeCAD: Breakpoint added at line ${line}`);
+        }
+        this.saveToFile();
+        this._onDidChange.fire();
+    }
+    /**
+     * Clear all breakpoints.
+     */
+    clearAllBreakpoints() {
+        this.breakpoints.clear();
+        this.saveToFile();
+        vscode.window.showInformationMessage('TypeCAD: All breakpoints cleared');
+        this._onDidChange.fire();
+    }
+    /**
+     * Save breakpoints, then run `cuttlefish build --debug` in a terminal.
+     */
+    async debugWithBreakpoints() {
+        const editor = vscode.window.activeTextEditor;
+        if (!editor) {
+            vscode.window.showErrorMessage('TypeCAD: No active editor');
+            return;
+        }
+        this.saveToFile();
+        const terminal = vscode.window.createTerminal('TypeCAD Debug');
+        terminal.show();
+        terminal.sendText('npx cuttlefish build --debug');
+    }
+    /**
+     * Sync breakpoints from VSCode's built-in breakpoint system.
+     * Captures conditional breakpoints and logpoints.
+     * REPLACES all breakpoints with the current VS Code state.
+     */
+    syncFromVSCode() {
+        const vscodeBreakpoints = vscode.debug.breakpoints;
+        console.log(`TypeCAD: Syncing ${vscodeBreakpoints.length} breakpoints from VS Code`);
+        this.breakpoints.clear();
+        let count = 0;
+        for (const bp of vscodeBreakpoints) {
+            if (bp instanceof vscode.SourceBreakpoint) {
+                // Key the in-memory map by basename so saveToFile and the toggle path
+                // agree on a single canonical key. The loader matches by basename.
+                const filePath = bp.location.uri.fsPath;
+                const fileName = path.basename(filePath);
+                const line = bp.location.range.start.line + 1; // 1-indexed
+                if (!this.breakpoints.has(fileName)) {
+                    this.breakpoints.set(fileName, new Map());
+                }
+                this.breakpoints.get(fileName).set(line, {
+                    file: fileName,
+                    line,
+                    condition: bp.condition,
+                    logMessage: bp.logMessage, // LogMessageBreakpoint has this property
+                });
+                count++;
+            }
+        }
+        this.saveToFile();
+        vscode.window.setStatusBarMessage(`TypeCAD: Synced ${count} breakpoints`, 3000);
+        console.log(`TypeCAD: Synced ${count} breakpoints to file`);
+    }
+    /**
+     * Load breakpoints from .cuttlefish/breakpoints.json
+     */
+    loadFromFile() {
+        const workspaceFolders = vscode.workspace.workspaceFolders;
+        if (!workspaceFolders || workspaceFolders.length === 0)
+            return;
+        const filePath = path.join(workspaceFolders[0].uri.fsPath, BREAKPOINTS_DIR, BREAKPOINTS_FILE);
+        if (!fs.existsSync(filePath))
+            return;
+        try {
+            const content = fs.readFileSync(filePath, 'utf8');
+            const map = JSON.parse(content);
+            for (const bp of map.breakpoints ?? []) {
+                if (!this.breakpoints.has(bp.file)) {
+                    this.breakpoints.set(bp.file, new Map());
+                }
+                this.breakpoints.get(bp.file).set(bp.line, bp);
+            }
+        }
+        catch (err) {
+            console.error('TypeCAD: Failed to load breakpoints:', err);
+        }
+    }
+    /**
+     * Save breakpoints to .cuttlefish/breakpoints.json atomically.
+     * Writes to a temp file then renames, so a watching transpiler never reads
+     * a half-written file.
+     */
+    saveToFile() {
+        const workspaceFolders = vscode.workspace.workspaceFolders;
+        if (!workspaceFolders || workspaceFolders.length === 0) {
+            console.log('TypeCAD: No workspace folder, skipping save');
+            return;
+        }
+        const dirPath = path.join(workspaceFolders[0].uri.fsPath, BREAKPOINTS_DIR);
+        const filePath = path.join(dirPath, BREAKPOINTS_FILE);
+        const tmpPath = `${filePath}.tmp`;
+        try {
+            if (!fs.existsSync(dirPath)) {
+                fs.mkdirSync(dirPath, { recursive: true });
+            }
+        }
+        catch (mkdirErr) {
+            console.error('TypeCAD: Failed to create directory:', mkdirErr);
+            vscode.window.showErrorMessage(`TypeCAD: Failed to create ${BREAKPOINTS_DIR} directory: ${mkdirErr}`);
+            return;
+        }
+        const map = { breakpoints: [] };
+        for (const [, fileBreakpoints] of this.breakpoints) {
+            for (const [, bp] of fileBreakpoints) {
+                map.breakpoints.push(bp);
+            }
+        }
+        // Stable order for clean diffs and reproducible output.
+        map.breakpoints.sort((a, b) => {
+            if (a.file !== b.file)
+                return a.file.localeCompare(b.file);
+            return a.line - b.line;
+        });
+        try {
+            fs.writeFileSync(tmpPath, JSON.stringify(map, null, 2));
+            fs.renameSync(tmpPath, filePath);
+            console.log(`TypeCAD: Saved ${map.breakpoints.length} breakpoints to ${filePath}`);
+        }
+        catch (err) {
+            // Best effort: clean up the temp file on failure.
+            try {
+                fs.unlinkSync(tmpPath);
+            }
+            catch { }
+            console.error('TypeCAD: Failed to save breakpoints:', err);
+            vscode.window.showErrorMessage(`TypeCAD: Failed to save breakpoints: ${err}`);
+        }
+    }
+    dispose() {
+        this._onDidChange.dispose();
+    }
+}
+// ---------------------------------------------------------------------------
+// Declaration Generator
+// ---------------------------------------------------------------------------
+class DeclarationGenerator {
+    /**
+     * Generate a .d.ts sidecar for a C++ file if one is not already present.
+     */
+    async checkAndGenerate(cppPath) {
+        const declPath = cppPath.replace(/\.cpp$/i, '.d.ts');
+        if (fs.existsSync(declPath)) {
+            return; // Already exists — never clobber.
+        }
+        const result = await this.generateDeclaration(cppPath, declPath);
+        if (result) {
+            vscode.window.showInformationMessage(`TypeCAD: Generated ${path.basename(declPath)} from ${path.basename(cppPath)}. Review and adjust types if needed.`);
+        }
+    }
+    /**
+     * Generate a declaration for the currently active C++ file.
+     */
+    async generateForCurrentFile() {
+        const editor = vscode.window.activeTextEditor;
+        if (!editor) {
+            vscode.window.showErrorMessage('TypeCAD: No active editor');
+            return;
+        }
+        const filePath = editor.document.uri.fsPath;
+        if (!filePath.endsWith('.cpp')) {
+            vscode.window.showErrorMessage('TypeCAD: Active file must be a .cpp file');
+            return;
+        }
+        const declPath = filePath.replace(/\.cpp$/i, '.d.ts');
+        const result = await this.generateDeclaration(filePath, declPath);
+        if (result) {
+            vscode.window.showInformationMessage(`TypeCAD: Generated ${path.basename(declPath)}`);
+            const doc = await vscode.workspace.openTextDocument(result);
+            await vscode.window.showTextDocument(doc);
+        }
+        else {
+            vscode.window.showWarningMessage('TypeCAD: No classes or constants found in C++ file');
+        }
+    }
+    /**
+     * Generate a .d.ts file from a C++ file via the cuttlefish CLI.
+     * Uses the monorepo source directly when developing inside this repo,
+     * falls back to `npx cuttlefish` for installed users.
+     */
+    async generateDeclaration(cppPath, declPath) {
+        return new Promise((resolve) => {
+            const workspaceFolders = vscode.workspace.workspaceFolders;
+            // Local-CLI fallback for development inside the typecode monorepo.
+            const localCliPath = workspaceFolders
+                ? path.join(workspaceFolders[0].uri.fsPath, 'packages/cuttlefish/src/cli.ts')
+                : null;
+            const cmd = localCliPath && fs.existsSync(localCliPath)
+                ? `npx tsx "${localCliPath}" gen-decls "${cppPath}"`
+                : `npx cuttlefish gen-decls "${cppPath}"`;
+            (0, node_child_process_1.exec)(cmd, { cwd: workspaceFolders?.[0]?.uri.fsPath }, (error) => {
+                if (error) {
+                    console.error('TypeCAD: Failed to generate declaration:', error);
+                    vscode.window.showErrorMessage(`TypeCAD: Failed to generate declaration: ${error.message}`);
+                    resolve(null);
+                    return;
+                }
+                resolve(fs.existsSync(declPath) ? declPath : null);
+            });
+        });
+    }
+    dispose() { }
+}
+//# sourceMappingURL=extension.js.map

package/assets/editor-extensions/typecad-debug/out/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"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"}

package/assets/editor-extensions/typecad-debug/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "vscode-typecad-debug",
+  "displayName": "TypeCAD Debug",
+  "description": "Breakpoint debugging for TypeCAD embedded projects",
+  "version": "0.2.0",
+  "private": true,
+  "publisher": "typecad",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/justind000/typecode.git"
+  },
+  "engines": {
+    "vscode": "^1.85.0"
+  },
+  "categories": [
+    "Debuggers"
+  ],
+  "activationEvents": [
+    "onLanguage:typescript",
+    "workspaceContains:**/cuttlefish.config.ts"
+  ],
+  "main": "./out/extension.js",
+  "contributes": {
+    "commands": [
+      {
+        "command": "typecad-debug.toggleBreakpoint",
+        "title": "TypeCAD: Toggle Breakpoint"
+      },
+      {
+        "command": "typecad-debug.clearAllBreakpoints",
+        "title": "TypeCAD: Clear All Breakpoints"
+      },
+      {
+        "command": "typecad-debug.debugWithBreakpoints",
+        "title": "TypeCAD: Debug with Breakpoints"
+      },
+      {
+        "command": "typecad-debug.syncBreakpoints",
+        "title": "TypeCAD: Sync Breakpoints from VS Code"
+      },
+      {
+        "command": "typecad-debug.generateDeclaration",
+        "title": "TypeCAD: Generate Declaration from C++"
+      }
+    ],
+    "keybindings": [
+      {
+        "command": "typecad-debug.toggleBreakpoint",
+        "key": "f9",
+        "when": "editorTextFocus && resourceExtname == .ts"
+      }
+    ],
+    "menus": {
+      "editor/context": [
+        {
+          "command": "typecad-debug.toggleBreakpoint",
+          "group": "debug",
+          "when": "resourceExtname == .ts"
+        }
+      ]
+    }
+  },
+  "scripts": {
+    "vscode:prepublish": "npm run compile",
+    "compile": "tsc -p ./",
+    "watch": "tsc -watch -p ./",
+    "package": "vsce package --no-yarn --no-dependencies"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "@types/vscode": "^1.85.0",
+    "@vscode/vsce": "^3.2.0",
+    "typescript": "^5.7.3"
+  }
+}

package/assets/editor-extensions/typecad-ui/LICENSE

@@ -0,0 +1,27 @@
+MIT License with third-party attribution
+
+Copyright (c) TypeCAD contributors
+
+TextMate grammar and language configuration adapted from sveltejs/language-tools
+(https://github.com/sveltejs/language-tools), Copyright (c) 2020-Present
+sveltejs/language-tools contributors, MIT licensed:
+
+Copyright (c) 2020-Present sveltejs/language-tools contributors
+
+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/assets/editor-extensions/typecad-ui/README.md

@@ -0,0 +1,52 @@
+# TypeCAD UI (.ui) Syntax
+
+Syntax highlighting and editor support for cuttlefish `.ui` single-file
+components. A `.ui` file interleaves three streams — TypeScript in `<script>`,
+CSS in `<style>`, and Svelte-style markup (`on:click={handler}`,
+`{expression}` interpolations) — and the grammar highlights all three by
+embedding VS Code's builtin TypeScript, CSS, and HTML grammars.
+
+Beyond the grammar, the extension statically contributes:
+
+- **Snippets** for the `.ui` idioms (`screen`, `button`, `bind`, `signal`,
+  `canvas`, `list`, …) — type the prefix and Tab.
+- **Markdown injection** so ` ```ui ` fenced blocks highlight in docs.
+- **File icons** for `.ui` files, shown when the active icon theme has no
+  mapping (VS Code's default Seti theme has none).
+- **Word/indentation rules** so `{expr}` and `on:click` select as one word and
+  Enter indents inside tags and braces.
+
+This is a grammar-only extension: no activation events, no code, no
+dependencies beyond static contributions. It never runs anything.
+
+## Why it lives here
+
+`cuttlefish create` copies this folder into each new project's
+`.vscode/extensions/typecad-ui/`. VS Code (1.89+, trusted workspaces) detects
+workspace-bundled extensions and installs them scoped to that workspace — the
+project carries its own highlighting with no marketplace install. The
+scaffold also writes `.vscode/extensions.json` with a `forceInstall` entry so
+current VS Code builds install it without a prompt once that feature ships.
+
+## Attribution
+
+The TextMate grammar and language configuration are adapted from the Svelte
+team's work in [sveltejs/language-tools]
+(https://github.com/sveltejs/language-tools) (`svelte-vscode/syntaxes/
+svelte.tmLanguage.src.yaml` and `svelte-vscode/language-configuration.json`),
+MIT licensed — see LICENSE. Adaptations: scopes renamed from `source.svelte`
+to `source.typecad-ui`, Svelte built-in element patterns (`<svelte:*>`)
+removed, folding markers adjusted for `<screen>` roots. The `.ui` format is a
+Svelte-syntax subset, so the grammar is otherwise kept structurally identical
+to stay close to upstream.
+
+## Manual install (existing projects)
+
+Copy this folder to `<project>/.vscode/extensions/typecad-ui/` and reload the
+VS Code window. Commit it so collaborators get highlighting too.
+
+## Regenerating the icon
+
+`icon.png` is rendered by `scripts/render-typecad-ui-icon.mjs` at the repo
+root (dependency-free SDF rasterizer). Re-run it after changing the design or
+dimensions in that script.