crosspad-mcp-server 4.0.0

package/dist/tools/screenshot.d.ts

@@ -0,0 +1,24 @@
+/**
+ * MCP tool: capture a screenshot from the running CrossPad simulator.
+ * The simulator encodes PNG natively via stb_image_write.
+ *
+ * When saving to file, the simulator writes the PNG directly to disk
+ * (no base64 round-trip over TCP). Otherwise returns inline base64.
+ */
+export interface ScreenshotResult {
+    success: boolean;
+    width?: number;
+    height?: number;
+    format?: string;
+    file_path?: string;
+    data_base64?: string;
+    size?: number;
+    error?: string;
+}
+/**
+ * Take a screenshot of the simulator window.
+ * @param save_to_file If true, simulator writes PNG directly to disk (fast path).
+ * @param filename     Custom filename (default: screenshot_<timestamp>.png)
+ * @param region       "full" for entire window (490x680), "lcd" for LCD only (320x240)
+ */
+export declare function crosspadScreenshot(saveToFile?: boolean, filename?: string, region?: "full" | "lcd"): Promise<ScreenshotResult>;

package/dist/tools/screenshot.js

@@ -0,0 +1,80 @@
+/**
+ * MCP tool: capture a screenshot from the running CrossPad simulator.
+ * The simulator encodes PNG natively via stb_image_write.
+ *
+ * When saving to file, the simulator writes the PNG directly to disk
+ * (no base64 round-trip over TCP). Otherwise returns inline base64.
+ */
+import { sendRemoteCommand, isSimulatorRunning } from "../utils/remote-client.js";
+import fs from "fs";
+import path from "path";
+import { CROSSPAD_PC_ROOT } from "../config.js";
+/**
+ * Take a screenshot of the simulator window.
+ * @param save_to_file If true, simulator writes PNG directly to disk (fast path).
+ * @param filename     Custom filename (default: screenshot_<timestamp>.png)
+ * @param region       "full" for entire window (490x680), "lcd" for LCD only (320x240)
+ */
+export async function crosspadScreenshot(saveToFile = true, filename, region = "full") {
+    const running = await isSimulatorRunning();
+    if (!running) {
+        return {
+            success: false,
+            error: "Simulator is not running. Use crosspad_run to start it.",
+        };
+    }
+    try {
+        if (saveToFile) {
+            // Fast path: simulator writes PNG directly to disk
+            const fname = filename || `screenshot_${Date.now()}.png`;
+            const screenshotsDir = path.join(CROSSPAD_PC_ROOT, "screenshots");
+            if (!fs.existsSync(screenshotsDir)) {
+                fs.mkdirSync(screenshotsDir, { recursive: true });
+            }
+            const filePath = path.join(screenshotsDir, fname).replace(/\\/g, "/");
+            const cmd = { cmd: "screenshot", file: filePath };
+            if (region === "lcd")
+                cmd.region = "lcd";
+            const resp = await sendRemoteCommand(cmd);
+            if (!resp.ok) {
+                return {
+                    success: false,
+                    error: resp.error || "Screenshot failed",
+                };
+            }
+            return {
+                success: true,
+                width: resp.width,
+                height: resp.height,
+                format: "png",
+                file_path: filePath,
+                size: resp.size,
+            };
+        }
+        // Inline path: returns base64-encoded PNG
+        const inlineCmd = { cmd: "screenshot" };
+        if (region === "lcd")
+            inlineCmd.region = "lcd";
+        const resp = await sendRemoteCommand(inlineCmd);
+        if (!resp.ok) {
+            return {
+                success: false,
+                error: resp.error || "Screenshot failed",
+            };
+        }
+        return {
+            success: true,
+            width: resp.width,
+            height: resp.height,
+            format: "png",
+            data_base64: resp.data,
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: err.message,
+        };
+    }
+}
+//# sourceMappingURL=screenshot.js.map

package/dist/tools/screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/tools/screenshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAahD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,aAAsB,IAAI,EAC1B,QAAiB,EACjB,SAAyB,MAAM;IAE/B,MAAM,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,yDAAyD;SACjE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,IAAI,UAAU,EAAE,CAAC;YACf,mDAAmD;YACnD,MAAM,KAAK,GAAG,QAAQ,IAAI,cAAc,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;YACzD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;YAClE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;gBACnC,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAEtE,MAAM,GAAG,GAA4B,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YAC3E,IAAI,MAAM,KAAK,KAAK;gBAAE,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC;YACzC,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;YAE1C,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,mBAAmB;iBACrD,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,IAAI,CAAC,KAAe;gBAC3B,MAAM,EAAE,IAAI,CAAC,MAAgB;gBAC7B,MAAM,EAAE,KAAK;gBACb,SAAS,EAAE,QAAQ;gBACnB,IAAI,EAAE,IAAI,CAAC,IAAc;aAC1B,CAAC;QACJ,CAAC;QAED,0CAA0C;QAC1C,MAAM,SAAS,GAA4B,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;QACjE,IAAI,MAAM,KAAK,KAAK;YAAE,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEhD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,mBAAmB;aACrD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,IAAI,CAAC,KAAe;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAgB;YAC7B,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,IAAI,CAAC,IAAc;SACjC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,GAAG,CAAC,OAAO;SACnB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/settings.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MCP tool: read/write CrossPad settings via the running simulator.
+ */
+export interface SettingsGetResult {
+    success: boolean;
+    settings?: Record<string, unknown>;
+    error?: string;
+}
+export interface SettingsSetResult {
+    success: boolean;
+    key?: string;
+    value?: number;
+    error?: string;
+}
+/**
+ * Read settings from the running simulator.
+ * @param category  "all", "display", "keypad", "vibration", "wireless", "audio", "system"
+ */
+export declare function crosspadSettingsGet(category?: string): Promise<SettingsGetResult>;
+/**
+ * Write a single setting on the running simulator.
+ * @param key    Dotted key name (e.g. "lcd_brightness", "keypad.eco_mode", "vibration.enable")
+ * @param value  Numeric value (booleans: 0=false, 1=true)
+ */
+export declare function crosspadSettingsSet(key: string, value: number): Promise<SettingsSetResult>;

package/dist/tools/settings.js

@@ -0,0 +1,48 @@
+/**
+ * MCP tool: read/write CrossPad settings via the running simulator.
+ */
+import { sendRemoteCommand, isSimulatorRunning } from "../utils/remote-client.js";
+/**
+ * Read settings from the running simulator.
+ * @param category  "all", "display", "keypad", "vibration", "wireless", "audio", "system"
+ */
+export async function crosspadSettingsGet(category = "all") {
+    const running = await isSimulatorRunning();
+    if (!running) {
+        return { success: false, error: "Simulator is not running. Use crosspad_run to start it." };
+    }
+    try {
+        const resp = await sendRemoteCommand({ cmd: "settings_get", category });
+        if (!resp.ok) {
+            return { success: false, error: resp.error || "settings_get failed" };
+        }
+        // Remove 'ok' field, pass the rest as settings
+        const { ok, ...settings } = resp;
+        return { success: true, settings };
+    }
+    catch (err) {
+        return { success: false, error: err.message };
+    }
+}
+/**
+ * Write a single setting on the running simulator.
+ * @param key    Dotted key name (e.g. "lcd_brightness", "keypad.eco_mode", "vibration.enable")
+ * @param value  Numeric value (booleans: 0=false, 1=true)
+ */
+export async function crosspadSettingsSet(key, value) {
+    const running = await isSimulatorRunning();
+    if (!running) {
+        return { success: false, error: "Simulator is not running. Use crosspad_run to start it." };
+    }
+    try {
+        const resp = await sendRemoteCommand({ cmd: "settings_set", key, value });
+        if (!resp.ok) {
+            return { success: false, error: resp.error || "settings_set failed" };
+        }
+        return { success: true, key: resp.key, value: resp.value };
+    }
+    catch (err) {
+        return { success: false, error: err.message };
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/tools/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/tools/settings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAelF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,KAAK;IAExB,MAAM,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yDAAyD,EAAE,CAAC;IAC9F,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,qBAAqB,EAAE,CAAC;QACpF,CAAC;QACD,+CAA+C;QAC/C,MAAM,EAAE,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAChD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,KAAa;IAEb,MAAM,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yDAAyD,EAAE,CAAC;IAC9F,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,qBAAqB,EAAE,CAAC;QACpF,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAa,EAAE,KAAK,EAAE,IAAI,CAAC,KAAe,EAAE,CAAC;IACjF,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/tools/stats.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MCP tool: read runtime statistics from the running CrossPad simulator.
+ */
+export interface StatsResult {
+    success: boolean;
+    stats?: Record<string, unknown>;
+    error?: string;
+}
+/**
+ * Query runtime statistics from the simulator:
+ * - Platform capabilities (active flags)
+ * - Pad state (16 pads: pressed, playing, note, channel, RGB color)
+ * - Active pad logic handler + registered handlers
+ * - Registered apps
+ * - Heap stats (SRAM/PSRAM)
+ * - Settings summary (brightness, theme, kit, audio engine)
+ */
+export declare function crosspadStats(): Promise<StatsResult>;

package/dist/tools/stats.js

@@ -0,0 +1,31 @@
+/**
+ * MCP tool: read runtime statistics from the running CrossPad simulator.
+ */
+import { sendRemoteCommand, isSimulatorRunning } from "../utils/remote-client.js";
+/**
+ * Query runtime statistics from the simulator:
+ * - Platform capabilities (active flags)
+ * - Pad state (16 pads: pressed, playing, note, channel, RGB color)
+ * - Active pad logic handler + registered handlers
+ * - Registered apps
+ * - Heap stats (SRAM/PSRAM)
+ * - Settings summary (brightness, theme, kit, audio engine)
+ */
+export async function crosspadStats() {
+    const running = await isSimulatorRunning();
+    if (!running) {
+        return { success: false, error: "Simulator is not running. Use crosspad_run to start it." };
+    }
+    try {
+        const resp = await sendRemoteCommand({ cmd: "stats" });
+        if (!resp.ok) {
+            return { success: false, error: resp.error || "stats failed" };
+        }
+        const { ok, ...stats } = resp;
+        return { success: true, stats };
+    }
+    catch (err) {
+        return { success: false, error: err.message };
+    }
+}
+//# sourceMappingURL=stats.js.map

package/dist/tools/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/tools/stats.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQlF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yDAAyD,EAAE,CAAC;IAC9F,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,cAAc,EAAE,CAAC;QAC7E,CAAC;QACD,MAAM,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/tools/symbols.d.ts

@@ -0,0 +1,20 @@
+export interface SymbolResult {
+    symbol: string;
+    kind: "class" | "function" | "macro" | "enum" | "typedef";
+    file: string;
+    line: number;
+    context: string;
+    repo: string;
+}
+export interface SymbolSearchResult {
+    query: string;
+    kind_filter: string;
+    results: SymbolResult[];
+    total_matches: number;
+    truncated: boolean;
+}
+/**
+ * Search for symbol definitions (classes, functions, macros, enums) across CrossPad repos.
+ * Only matches definition lines, not usages.
+ */
+export declare function crosspadSearchSymbols(query: string, kind?: string, repos?: string[], maxResults?: number): SymbolSearchResult;

package/dist/tools/symbols.js

@@ -0,0 +1,157 @@
+import fs from "fs";
+import { REPOS } from "../config.js";
+import { runCommand } from "../utils/exec.js";
+/**
+ * Build a regex pattern that matches definition lines containing the query.
+ * Each kind has a specific pattern that only matches declarations/definitions.
+ */
+function buildPattern(query, kind) {
+    const q = query; // Already escaped by caller
+    const patterns = [];
+    if (kind === "class" || kind === "all") {
+        // class/struct definition: class Foo { or class Foo : public Bar {
+        patterns.push(`(class|struct)\\s+\\w*${q}\\w*\\s*[:{]`);
+        patterns.push(`(class|struct)\\s+\\w*${q}\\w*\\s*$`); // multi-line def
+    }
+    if (kind === "macro" || kind === "all") {
+        patterns.push(`#define\\s+\\w*${q}\\w*`);
+    }
+    if (kind === "enum" || kind === "all") {
+        patterns.push(`enum\\s+(class\\s+)?\\w*${q}\\w*`);
+    }
+    if (kind === "typedef" || kind === "all") {
+        patterns.push(`using\\s+\\w*${q}\\w*\\s*=`);
+        patterns.push(`typedef\\s+.*\\b\\w*${q}\\w*\\s*;`);
+    }
+    if (kind === "function" || kind === "all") {
+        // Function definition: type name( or void name(  — exclude calls by requiring return type or line start
+        patterns.push(`^\\w[\\w:\\s*&<>]+\\b\\w*${q}\\w*\\s*\\(`);
+    }
+    return patterns.join("|");
+}
+/**
+ * Search for symbol definitions (classes, functions, macros, enums) across CrossPad repos.
+ * Only matches definition lines, not usages.
+ */
+export function crosspadSearchSymbols(query, kind = "all", repos = ["all"], maxResults = 50) {
+    const results = [];
+    const targetRepos = repos.includes("all")
+        ? Object.entries(REPOS)
+        : Object.entries(REPOS).filter(([name]) => repos.includes(name));
+    const pattern = buildPattern(escapeForRegex(query), kind);
+    if (!pattern) {
+        return { query, kind_filter: kind, results: [], total_matches: 0, truncated: false };
+    }
+    for (const [repoName, repoPath] of targetRepos) {
+        if (!fs.existsSync(repoPath))
+            continue;
+        const grepCmd = `git grep -n -E "${escapeForShell(pattern)}" -- "*.hpp" "*.h" "*.cpp" "*.c"`;
+        const result = runCommand(grepCmd, repoPath, 30_000);
+        if (!result.success && result.stdout.length === 0)
+            continue;
+        for (const line of result.stdout.split("\n")) {
+            if (!line.trim())
+                continue;
+            const match = line.match(/^([^:]+):(\d+):(.*)$/);
+            if (!match)
+                continue;
+            const [, file, lineStr, content] = match;
+            const lineNum = parseInt(lineStr, 10);
+            const trimmedContent = content.trim();
+            // Skip forward declarations (class Foo;)
+            if (/^\s*(class|struct)\s+\w+\s*;/.test(trimmedContent))
+                continue;
+            // Skip includes
+            if (/^\s*#include/.test(trimmedContent))
+                continue;
+            // Skip comments
+            if (/^\s*(\/\/|\/\*|\*)/.test(trimmedContent))
+                continue;
+            const detectedKind = classifyDefinition(trimmedContent);
+            if (!detectedKind)
+                continue;
+            if (kind !== "all" && detectedKind !== kind)
+                continue;
+            const symbolName = extractSymbolName(trimmedContent, detectedKind);
+            if (!symbolName)
+                continue;
+            // Symbol name must contain query
+            if (!symbolName.toLowerCase().includes(query.toLowerCase()))
+                continue;
+            // Deduplicate by symbol+file
+            const key = `${symbolName}:${file}`;
+            if (results.some((r) => `${r.symbol}:${r.file.split("/").pop()}` === key))
+                continue;
+            results.push({
+                symbol: symbolName,
+                kind: detectedKind,
+                file: `${repoPath}/${file}`.replace(/\\/g, "/"),
+                line: lineNum,
+                context: trimmedContent.slice(0, 150),
+                repo: repoName,
+            });
+            if (results.length >= maxResults)
+                break;
+        }
+        if (results.length >= maxResults)
+            break;
+    }
+    return {
+        query,
+        kind_filter: kind,
+        results: results.slice(0, maxResults),
+        total_matches: results.length,
+        truncated: results.length >= maxResults,
+    };
+}
+function escapeForShell(s) {
+    // Only escape shell metacharacters, NOT backslashes (needed for regex \s \w etc.)
+    return s.replace(/["`$]/g, "\\$&");
+}
+function escapeForRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function classifyDefinition(line) {
+    if (/^\s*#define\s+/.test(line))
+        return "macro";
+    if (/^\s*enum\s+/.test(line))
+        return "enum";
+    if (/^\s*(typedef|using)\s+/.test(line))
+        return "typedef";
+    if (/^\s*(class|struct)\s+\w+/.test(line))
+        return "class";
+    // Function: starts with type qualifier, has word( pattern
+    if (/^[\w:][\w:\s*&<>,]*\b\w+\s*\(/.test(line) &&
+        !/^\s*(if|while|for|switch|return|delete|new|throw|sizeof)\b/.test(line)) {
+        return "function";
+    }
+    return null;
+}
+function extractSymbolName(line, kind) {
+    switch (kind) {
+        case "class": {
+            const m = line.match(/(?:class|struct)\s+(\w+)/);
+            return m ? m[1] : null;
+        }
+        case "macro": {
+            const m = line.match(/#define\s+(\w+)/);
+            return m ? m[1] : null;
+        }
+        case "enum": {
+            const m = line.match(/enum\s+(?:class\s+)?(\w+)/);
+            return m ? m[1] : null;
+        }
+        case "typedef": {
+            const m = line.match(/using\s+(\w+)\s*=/) || line.match(/typedef\s+.*\b(\w+)\s*;/);
+            return m ? m[1] : null;
+        }
+        case "function": {
+            // Last word before opening paren: returnType funcName(
+            const m = line.match(/\b(\w+)\s*\(/);
+            return m ? m[1] : null;
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=symbols.js.map

package/dist/tools/symbols.js.map

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

package/dist/tools/test.d.ts

@@ -0,0 +1,24 @@
+import { OnLine } from "../utils/exec.js";
+export interface TestResult {
+    success: boolean;
+    tests_found: boolean;
+    build_output: string;
+    test_output: string;
+    passed: number;
+    failed: number;
+    errors: string[];
+    duration_seconds: number;
+}
+/**
+ * Build and run the crosspad test suite (Catch2).
+ * If tests/ dir doesn't exist, offers to scaffold it.
+ */
+export declare function crosspadTest(filter?: string, listOnly?: boolean, onLine?: OnLine): Promise<TestResult>;
+/**
+ * Scaffold the test infrastructure: CMakeLists.txt additions + sample test file.
+ * Returns file contents — does NOT write to disk.
+ */
+export declare function crosspadTestScaffold(): {
+    files: Record<string, string>;
+    cmake_patch: string;
+};