@substrate-kit/cli 0.1.0

package/dist/commands/init.js

@@ -0,0 +1,134 @@
+import { join } from "node:path";
+import { copyDir, exists, writeFile, resolveSkillsDir, listDirs, } from "../utils/fs.js";
+import { log } from "../utils/logger.js";
+function claudeMd() {
+    return `# Substrate
+
+This project uses [Substrate](https://substrate.georgedrury.co.uk) — a creative app framework that provides scaffold (toolbar, panels, panes, stores, shortcuts) around different surface types.
+
+## Skills
+
+Substrate skills are installed in \`.claude/skills/\`. They are organised into two groups:
+
+### Surface guides (how to build)
+
+- **scaffold-playground** — bootstrapping a new playground
+- **canvas-2d** / **3d-scene** / **animation** / **image-generation** / **data-visualisation** — surface-specific architecture
+- **composing-panels** / **wire-interactions** / **create-custom-tool** / **theming** — workflow guides
+
+### Component reference (what to use)
+
+- **substrate-scaffold** — Toolbar, Panel, Pane, DocumentTabs, StatusBar, ZoomControls, Breadcrumbs, Resizer
+- **substrate-controls** — NumberInput, Slider, NumberSlider, Select, Toggle, TextArea, ColourPicker, ActionControls
+- **substrate-canvas** — useViewport, useSelection, useDragReorder, snap, boundingBox, hit testing
+- **substrate-nodes** — Node cards, typed ports, port colour theming
+- **substrate-feedback** — Toast, ProgressBar, Badge, EmptyState, CommandPalette, ContextMenu, ShortcutOverlay
+- **substrate-interaction** — useUndoable, useClipboard, createKeyboardShortcuts, HistoryControls, LayerList, TreeList
+
+## Install components
+
+\`\`\`bash
+# Core scaffold
+npx substrate-kit add design-canvas toolbar panel pane action slider
+
+# Surface components
+npx substrate-kit add surface timeline gallery colour-picker easing-curve-editor
+\`\`\`
+
+## Registry
+
+Components are installed from \`substrate.georgedrury.co.uk/r/\` via the shadcn CLI.
+`;
+}
+function componentsJson() {
+    return JSON.stringify({
+        $schema: "https://ui.shadcn.com/schema.json",
+        style: "new-york",
+        rsc: true,
+        tsx: true,
+        tailwind: {
+            config: "",
+            css: "app/globals.css",
+            baseColor: "neutral",
+            cssVariables: true,
+        },
+        aliases: {
+            components: "@/components",
+            utils: "@/lib/utils",
+            ui: "@/components/ui",
+            lib: "@/lib",
+            hooks: "@/hooks",
+        },
+    }, null, 2);
+}
+export async function init(options = {}) {
+    const cwd = process.cwd();
+    const { force = false, skipComponentsJson = false } = options;
+    log.title("Initialising Substrate");
+    // 1. Copy skills
+    const skillsSource = resolveSkillsDir();
+    const skillsDest = join(cwd, ".claude", "skills");
+    const skillNames = listDirs(skillsSource);
+    if (skillNames.length === 0) {
+        log.error("No skills found in the bundled skills directory");
+        process.exit(1);
+    }
+    let copiedCount = 0;
+    let skippedCount = 0;
+    for (const skillName of skillNames) {
+        const dest = join(skillsDest, skillName);
+        if (exists(dest) && !force) {
+            skippedCount++;
+            continue;
+        }
+        copyDir(join(skillsSource, skillName), dest);
+        copiedCount++;
+        log.step(`Installed skill: ${skillName}`);
+    }
+    if (copiedCount > 0) {
+        log.success(`Installed ${copiedCount} skill${copiedCount === 1 ? "" : "s"}`);
+    }
+    if (skippedCount > 0) {
+        log.warn(`Skipped ${skippedCount} existing skill${skippedCount === 1 ? "" : "s"} (use --force to overwrite)`);
+    }
+    // 2. Generate CLAUDE.md
+    const claudeMdPath = join(cwd, "CLAUDE.md");
+    if (exists(claudeMdPath) && !force) {
+        log.warn("CLAUDE.md already exists (use --force to overwrite)");
+    }
+    else {
+        writeFile(claudeMdPath, claudeMd());
+        log.success("Created CLAUDE.md");
+    }
+    // 3. Write components.json
+    if (!skipComponentsJson) {
+        const componentsJsonPath = join(cwd, "components.json");
+        if (exists(componentsJsonPath) && !force) {
+            log.warn("components.json already exists (use --force to overwrite)");
+        }
+        else {
+            writeFile(componentsJsonPath, componentsJson());
+            log.success("Created components.json");
+        }
+    }
+    // 4. Write .mcp.json
+    const mcpJsonPath = join(cwd, ".mcp.json");
+    if (exists(mcpJsonPath) && !force) {
+        log.warn(".mcp.json already exists (use --force to overwrite)");
+    }
+    else {
+        const mcpConfig = {
+            mcpServers: {
+                substrate: {
+                    command: "npx",
+                    args: ["-y", "@substrate-kit/cli", "mcp"],
+                },
+            },
+        };
+        writeFile(mcpJsonPath, JSON.stringify(mcpConfig, null, 2) + "\n");
+        log.success("Created .mcp.json (Substrate MCP server registered)");
+    }
+    log.blank();
+    log.info("Substrate is ready. Claude can now use the skills for creative app development.");
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/variables.d.ts

@@ -0,0 +1,4 @@
+export declare function variables(component: string | undefined, options: {
+    all?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=variables.d.ts.map

package/dist/commands/variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../../src/commands/variables.ts"],"names":[],"mappings":"AAmEA,wBAAsB,SAAS,CAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAuEf"}

package/dist/commands/variables.js

@@ -0,0 +1,111 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { log } from "../utils/logger.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const REGISTRY_URL = "https://substrate.georgedrury.co.uk/registry.json";
+async function loadRegistry() {
+    const localPath = join(process.cwd(), "registry.json");
+    if (existsSync(localPath)) {
+        try {
+            return JSON.parse(readFileSync(localPath, "utf-8"));
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    try {
+        const res = await fetch(REGISTRY_URL);
+        if (res.ok)
+            return (await res.json());
+    }
+    catch {
+        /* fall through */
+    }
+    const bundledPaths = [
+        join(__dirname, "..", "..", "registry.json"),
+        join(__dirname, "..", "..", "..", "registry.json"),
+    ];
+    for (const p of bundledPaths) {
+        if (existsSync(p)) {
+            try {
+                return JSON.parse(readFileSync(p, "utf-8"));
+            }
+            catch {
+                /* fall through */
+            }
+        }
+    }
+    return null;
+}
+function extractOverrideKeys(item) {
+    const theme = item.cssVars?.theme;
+    if (!theme)
+        return [];
+    const keys = [];
+    for (const value of Object.values(theme)) {
+        const match = value.match(/^var\(--([^,)]+)/);
+        if (match)
+            keys.push(`--${match[1]}`);
+    }
+    return keys;
+}
+export async function variables(component, options) {
+    const registry = await loadRegistry();
+    if (!registry) {
+        log.error("Could not load the component registry");
+        process.exit(1);
+    }
+    if (options.all) {
+        const withVars = registry.items
+            .map((item) => ({ item, keys: extractOverrideKeys(item) }))
+            .filter(({ keys }) => keys.length > 0)
+            .sort((a, b) => a.item.name.localeCompare(b.item.name));
+        if (withVars.length === 0) {
+            log.info("No components have theme variables");
+            return;
+        }
+        log.blank();
+        log.info(`${withVars.length} components with theme variables:`);
+        log.blank();
+        for (const { item, keys } of withVars) {
+            console.log(`  ${item.name}`);
+            for (const key of keys) {
+                console.log(`    ${key}`);
+            }
+            console.log();
+        }
+        return;
+    }
+    if (!component) {
+        log.error("Provide a component name, e.g. substrate variables panel");
+        log.info("Use --all to list every component's variables");
+        process.exit(1);
+    }
+    const item = registry.items.find((i) => i.name.toLowerCase() === component.toLowerCase());
+    if (!item) {
+        log.error(`Component "${component}" not found`);
+        const query = component.toLowerCase();
+        const suggestions = registry.items
+            .filter((i) => i.name.toLowerCase().includes(query))
+            .slice(0, 5);
+        if (suggestions.length > 0) {
+            log.info("Did you mean:");
+            for (const s of suggestions) {
+                console.log(`  ${s.name}`);
+            }
+        }
+        process.exit(1);
+    }
+    const keys = extractOverrideKeys(item);
+    if (keys.length === 0) {
+        log.info("No theme variables — this component uses base theme values only");
+        return;
+    }
+    log.blank();
+    for (const key of keys) {
+        console.log(`    ${key}`);
+    }
+    log.blank();
+}
+//# sourceMappingURL=variables.js.map

package/dist/commands/variables.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { createCli } from "./cli.js";
+const program = createCli();
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,OAAO,GAAG,SAAS,EAAE,CAAA;AAC3B,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/mcp/registry.d.ts

@@ -0,0 +1,3 @@
+import type { Registry } from "./types.js";
+export declare function loadRegistry(): Promise<Registry>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/mcp/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/mcp/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAK1C,wBAAsB,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,CAmCtD"}

package/dist/mcp/registry.js

@@ -0,0 +1,43 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const REGISTRY_URL = "https://substrate.georgedrury.co.uk/registry.json";
+export async function loadRegistry() {
+    // Try local
+    const localPath = join(process.cwd(), "registry.json");
+    if (existsSync(localPath)) {
+        try {
+            return JSON.parse(readFileSync(localPath, "utf-8"));
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    // Try remote
+    try {
+        const res = await fetch(REGISTRY_URL);
+        if (res.ok)
+            return (await res.json());
+    }
+    catch {
+        /* fall through */
+    }
+    // Try bundled
+    const bundledPaths = [
+        join(__dirname, "..", "..", "registry.json"),
+        join(__dirname, "..", "..", "..", "registry.json"),
+    ];
+    for (const p of bundledPaths) {
+        if (existsSync(p)) {
+            try {
+                return JSON.parse(readFileSync(p, "utf-8"));
+            }
+            catch {
+                /* fall through */
+            }
+        }
+    }
+    throw new Error("Could not load Substrate registry");
+}
+//# sourceMappingURL=registry.js.map

package/dist/mcp/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/mcp/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAGxC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACzD,MAAM,YAAY,GAAG,mDAAmD,CAAA;AAExE,MAAM,CAAC,KAAK,UAAU,YAAY;IACjC,YAAY;IACZ,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAA;IACtD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;QACpD,CAAC;QAAC,MAAM,CAAC;YACR,kBAAkB;QACnB,CAAC;IACF,CAAC;IAED,aAAa;IACb,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,CAAA;QACrC,IAAI,GAAG,CAAC,EAAE;YAAE,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAa,CAAA;IAClD,CAAC;IAAC,MAAM,CAAC;QACR,kBAAkB;IACnB,CAAC;IAED,cAAc;IACd,MAAM,YAAY,GAAG;QACpB,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC;QAC5C,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC;KAClD,CAAA;IACD,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC9B,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC;gBACJ,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACR,kBAAkB;YACnB,CAAC;QACF,CAAC;IACF,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;AACrD,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AAWA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA+CjD"}

package/dist/mcp/server.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { loadRegistry } from "./registry.js";
+import { handleSearch } from "./tools/search.js";
+import { handleGetComponent } from "./tools/get-component.js";
+import { handleInstall } from "./tools/install.js";
+import { handleGetThemeVariables } from "./tools/theme.js";
+export async function startServer() {
+    const registry = await loadRegistry();
+    const server = new McpServer({
+        name: "substrate",
+        version: "0.1.0",
+    });
+    server.tool("search_components", "Search the Substrate component registry by keyword, category, or description. Returns matching components with name, description, and category.", {
+        query: z.string().optional().describe("Free-text search against component name, title, and description"),
+        category: z.string().optional().describe("Filter by category: substrate, ui, canvas, lib, store"),
+    }, async (args) => handleSearch(registry, args));
+    server.tool("get_component", "Get full details for a specific Substrate component including CSS variables, dependencies, usage example, and lineage.", {
+        name: z.string().describe("Component name (e.g. design-canvas, toolbar, panel)"),
+    }, async (args) => handleGetComponent(registry, args));
+    server.tool("install_components", "Install one or more Substrate components from substrate.georgedrury.co.uk into the current project. Runs shadcn add behind the scenes.", {
+        components: z.array(z.string()).describe("Component names to install (e.g. ['design-canvas', 'toolbar', 'panel'])"),
+    }, async (args) => handleInstall(registry, args));
+    server.tool("get_theme_variables", "Get the CSS variable map for Substrate components, showing the full fallback chain. Useful for building or customising themes.", {
+        components: z.array(z.string()).optional().describe("Component names to get variables for (omit for all)"),
+    }, async (args) => handleGetThemeVariables(registry, args));
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+const isDirectRun = process.argv[1]?.includes("mcp/server");
+if (isDirectRun) {
+    startServer().catch((err) => {
+        console.error("Failed to start Substrate MCP server:", err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAA;IAErC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAA;IAEF,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,iJAAiJ,EACjJ;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;QACxG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;KAClG,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,IAA6C,CAAC,CACtF,CAAA;IAED,MAAM,CAAC,IAAI,CACT,eAAe,EACf,wHAAwH,EACxH;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;KACjF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAwB,CAAC,CACvE,CAAA;IAED,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,wIAAwI,EACxI;QACE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,yEAAyE,CAAC;KACpH,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAgC,CAAC,CAC1E,CAAA;IAED,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,gIAAgI,EAChI;QACE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;KAC3G,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC,QAAQ,EAAE,IAAiC,CAAC,CACrF,CAAA;IAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC;AAED,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;AAC3D,IAAI,WAAW,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAA;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/mcp/tools/get-component.d.ts

@@ -0,0 +1,17 @@
+import type { Registry } from "../types.js";
+export declare function handleGetComponent(registry: Registry, args: {
+    name: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=get-component.d.ts.map

package/dist/mcp/tools/get-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get-component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GA0BvB"}

package/dist/mcp/tools/get-component.js

@@ -0,0 +1,23 @@
+export async function handleGetComponent(registry, args) {
+    const item = registry.items.find((i) => i.name.toLowerCase() === args.name.toLowerCase());
+    if (!item) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Component "${args.name}" not found. Available: ${registry.items.map((i) => i.name).join(", ")}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(item, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-component.js.map

package/dist/mcp/tools/get-component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component.js","sourceRoot":"","sources":["../../../src/mcp/tools/get-component.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAkB,EAClB,IAAsB;IAEtB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CACxD,CAAA;IAED,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,cAAc,IAAI,CAAC,IAAI,2BAA2B,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACvG;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACpC;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/mcp/tools/install.d.ts

@@ -0,0 +1,10 @@
+import type { Registry } from "../types.js";
+export declare function handleInstall(registry: Registry, args: {
+    components: string[];
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=install.d.ts.map

package/dist/mcp/tools/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/install.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAI3C,wBAAsB,aAAa,CAClC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE;;;;;GAuC9B"}

package/dist/mcp/tools/install.js

@@ -0,0 +1,40 @@
+import { execSync } from "node:child_process";
+const REGISTRY_BASE = "https://substrate.georgedrury.co.uk/r";
+export async function handleInstall(registry, args) {
+    const results = [];
+    for (const name of args.components) {
+        const item = registry.items.find((i) => i.name === name);
+        if (!item) {
+            results.push({
+                name,
+                status: "not_found",
+                error: `Component "${name}" not in registry`,
+            });
+            continue;
+        }
+        const url = `${REGISTRY_BASE}/${name}`;
+        try {
+            execSync(`npx shadcn@latest add ${url}`, {
+                encoding: "utf-8",
+                stdio: "pipe",
+            });
+            results.push({ name, status: "installed" });
+        }
+        catch (err) {
+            results.push({
+                name,
+                status: "failed",
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(results, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=install.js.map

package/dist/mcp/tools/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/mcp/tools/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAG7C,MAAM,aAAa,GAAG,uCAAuC,CAAA;AAE7D,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,QAAkB,EAClB,IAA8B;IAE9B,MAAM,OAAO,GAA4D,EAAE,CAAA;IAE3E,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;QACxD,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,MAAM,EAAE,WAAW;gBACnB,KAAK,EAAE,cAAc,IAAI,mBAAmB;aAC5C,CAAC,CAAA;YACF,SAAQ;QACT,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,aAAa,IAAI,IAAI,EAAE,CAAA;QACtC,IAAI,CAAC;YACJ,QAAQ,CAAC,yBAAyB,GAAG,EAAE,EAAE;gBACxC,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,MAAM;aACb,CAAC,CAAA;YACF,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACvD,CAAC,CAAA;QACH,CAAC;IACF,CAAC;IAED,OAAO;QACN,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACD;KACD,CAAA;AACF,CAAC"}

package/dist/mcp/tools/search.d.ts

@@ -0,0 +1,11 @@
+import type { Registry } from "../types.js";
+export declare function handleSearch(registry: Registry, args: {
+    query?: string;
+    category?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=search.d.ts.map

package/dist/mcp/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,wBAAsB,YAAY,CAChC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;GAsC5C"}

package/dist/mcp/tools/search.js

@@ -0,0 +1,30 @@
+export async function handleSearch(registry, args) {
+    let items = registry.items;
+    if (args.category) {
+        const cat = args.category.toLowerCase();
+        items = items.filter((i) => (i.categories || []).some((c) => c.toLowerCase() === cat));
+    }
+    if (args.query) {
+        const q = args.query.toLowerCase();
+        items = items.filter((i) => i.name.includes(q) ||
+            (i.title || "").toLowerCase().includes(q) ||
+            (i.description || "").toLowerCase().includes(q) ||
+            (i.categories || []).some((c) => c.toLowerCase().includes(q)));
+    }
+    const results = items.map((i) => ({
+        name: i.name,
+        title: i.title,
+        description: i.description,
+        categories: i.categories,
+        install: `substrate add ${i.name}`,
+    }));
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(results, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/mcp/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/mcp/tools/search.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAkB,EAClB,IAA2C;IAE3C,IAAI,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAA;IAE1B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAA;QACvC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACzB,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAC1D,CAAA;IACH,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;QAClC,KAAK,GAAG,KAAK,CAAC,MAAM,CAClB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAChE,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,OAAO,EAAE,iBAAiB,CAAC,CAAC,IAAI,EAAE;KACnC,CAAC,CAAC,CAAA;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aACvC;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/mcp/tools/theme.d.ts

@@ -0,0 +1,10 @@
+import type { Registry } from "../types.js";
+export declare function handleGetThemeVariables(registry: Registry, args: {
+    components?: string[];
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=theme.d.ts.map

package/dist/mcp/tools/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,aAAa,CAAA;AAazD,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;;;;;GA2BhC"}

package/dist/mcp/tools/theme.js

@@ -0,0 +1,37 @@
+function extractOverrideKeys(item) {
+    const theme = item.cssVars?.theme;
+    if (!theme)
+        return [];
+    const keys = [];
+    for (const value of Object.values(theme)) {
+        const match = value.match(/^var\(--([^,)]+)/);
+        if (match)
+            keys.push(`--${match[1]}`);
+    }
+    return keys;
+}
+export async function handleGetThemeVariables(registry, args) {
+    let items = registry.items;
+    if (args.components && args.components.length > 0) {
+        const names = new Set(args.components.map((n) => n.toLowerCase()));
+        items = items.filter((i) => names.has(i.name.toLowerCase()));
+    }
+    const result = {};
+    for (const item of items) {
+        if (!item.cssVars)
+            continue;
+        result[item.name] = {
+            cssVars: item.cssVars,
+            overrideKeys: extractOverrideKeys(item),
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=theme.js.map

package/dist/mcp/tools/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../src/mcp/tools/theme.ts"],"names":[],"mappings":"AAEA,SAAS,mBAAmB,CAAC,IAAkB;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAA;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;QAC7C,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACvC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAkB,EAClB,IAA+B;IAE/B,IAAI,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAA;IAE1B,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;QAClE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IAC9D,CAAC;IAED,MAAM,MAAM,GAAoF,EAAE,CAAA;IAElG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,SAAQ;QAC3B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAClB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,mBAAmB,CAAC,IAAI,CAAC;SACxC,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAA;AACH,CAAC"}