@gemini-designer/mcp-server 0.1.0

package/dist/tokens/sync.js

@@ -0,0 +1,188 @@
+/**
+ * Token Sync Utilities
+ *
+ * Normalizes tokens into a small internal representation and can output:
+ * - CSS custom properties
+ * - Tailwind theme extension
+ * - Tokens Studio JSON
+ * - Style Dictionary JSON
+ */
+import * as path from 'node:path';
+function isColorValue(v) {
+    const s = v.trim().toLowerCase();
+    return (/^#([0-9a-f]{3,8})$/.test(s) ||
+        /^rgb\(/.test(s) ||
+        /^rgba\(/.test(s) ||
+        /^hsl\(/.test(s) ||
+        /^hsla\(/.test(s) ||
+        /^oklch\(/.test(s) ||
+        /^oklab\(/.test(s));
+}
+function isDimensionValue(v) {
+    const s = v.trim().toLowerCase();
+    return /^-?\d+(\.\d+)?(px|rem|em|vh|vw|%|ch|ex)$/.test(s);
+}
+function isDurationValue(v) {
+    const s = v.trim().toLowerCase();
+    return /^\d+(\.\d+)?(ms|s)$/.test(s);
+}
+function inferTokenType(name, value) {
+    const n = name.toLowerCase();
+    const v = value.trim();
+    if (isColorValue(v) || n.includes('color') || n.includes('bg') || n.includes('foreground') || n.includes('surface'))
+        return 'color';
+    if (isDurationValue(v) || n.includes('duration') || n.includes('transition'))
+        return 'duration';
+    if (n.includes('easing') || n.includes('ease'))
+        return 'easing';
+    if (n.includes('shadow') || v.includes('rgba') && v.includes('px'))
+        return 'shadow';
+    if (n.includes('font') && n.includes('family'))
+        return 'fontFamily';
+    if (n.includes('weight'))
+        return 'fontWeight';
+    if (isDimensionValue(v) || n.includes('space') || n.includes('radius') || n.includes('size') || n.includes('gap'))
+        return 'dimension';
+    if (/^-?\d+(\.\d+)?$/.test(v))
+        return 'number';
+    return 'string';
+}
+function normalizeCssVarNameToTokenName(cssVar) {
+    // '--color-primary' -> 'color.primary'
+    // '--radius-md' -> 'radius.md'
+    let n = cssVar.trim();
+    if (n.startsWith('--'))
+        n = n.slice(2);
+    n = n.replace(/\s+/g, '-');
+    // Convert separators to dots for nesting
+    return n
+        .replace(/__/g, '.')
+        .replace(/--/g, '.')
+        .replace(/-/g, '.')
+        .replace(/\.+/g, '.')
+        .replace(/^\./, '')
+        .replace(/\.$/, '');
+}
+export function parseCssVars(content, sourceFile) {
+    const warnings = [];
+    const tokens = [];
+    // Very simple parse: extract any --var: value; pairs
+    const re = /(--[A-Za-z0-9_-]+)\s*:\s*([^;\n\r]+)\s*;/g;
+    let match;
+    const seen = new Set();
+    while ((match = re.exec(content))) {
+        const originalName = match[1];
+        const value = match[2].trim();
+        const name = normalizeCssVarNameToTokenName(originalName);
+        if (!name)
+            continue;
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        tokens.push({
+            name,
+            value,
+            type: inferTokenType(name, value),
+            source: {
+                file: sourceFile ? path.basename(sourceFile) : undefined,
+                originalName,
+            },
+        });
+    }
+    if (tokens.length === 0) {
+        warnings.push('No CSS custom properties found (expected patterns like --token-name: value;)');
+    }
+    return { tokens, warnings };
+}
+function setNested(obj, pathParts, value) {
+    // Protect against prototype pollution
+    const dangerousKeys = new Set(['__proto__', 'constructor', 'prototype']);
+    let cur = obj;
+    for (let i = 0; i < pathParts.length; i++) {
+        const key = pathParts[i];
+        // Block dangerous keys
+        if (dangerousKeys.has(key)) {
+            return;
+        }
+        if (i === pathParts.length - 1) {
+            cur[key] = value;
+            return;
+        }
+        if (!Object.hasOwn(cur, key) || typeof cur[key] !== 'object' || cur[key] === null) {
+            cur[key] = Object.create(null);
+        }
+        cur = cur[key];
+    }
+}
+export function tokensToCssVars(tokens, options) {
+    const selector = options?.selector || ':root';
+    const lines = [`${selector} {`];
+    for (const t of tokens) {
+        const cssName = `--${t.name.replace(/\./g, '-')}`;
+        lines.push(`  ${cssName}: ${t.value};`);
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+export function tokensToTailwindTheme(tokens) {
+    const extend = { colors: {}, spacing: {}, borderRadius: {}, boxShadow: {}, fontFamily: {}, fontWeight: {}, transitionDuration: {} };
+    for (const t of tokens) {
+        const parts = t.name.split('.').filter(Boolean);
+        if (parts.length === 0)
+            continue;
+        const root = parts[0];
+        const rest = parts.slice(1);
+        if (t.type === 'color' && (root === 'color' || root === 'colors')) {
+            setNested(extend.colors, rest.length ? rest : ['DEFAULT'], t.value);
+        }
+        else if (t.type === 'dimension' && (root === 'space' || root === 'spacing')) {
+            setNested(extend.spacing, rest.length ? rest : ['DEFAULT'], t.value);
+        }
+        else if (t.type === 'dimension' && (root === 'radius' || root === 'radii' || root === 'borderRadius')) {
+            setNested(extend.borderRadius, rest.length ? rest : ['DEFAULT'], t.value);
+        }
+        else if (t.type === 'shadow' && (root === 'shadow' || root === 'shadows')) {
+            setNested(extend.boxShadow, rest.length ? rest : ['DEFAULT'], t.value);
+        }
+        else if (t.type === 'fontFamily') {
+            setNested(extend.fontFamily, rest.length ? rest : ['sans'], t.value);
+        }
+        else if (t.type === 'fontWeight') {
+            setNested(extend.fontWeight, rest.length ? rest : ['normal'], t.value);
+        }
+        else if (t.type === 'duration') {
+            setNested(extend.transitionDuration, rest.length ? rest : ['DEFAULT'], t.value);
+        }
+    }
+    // Prune empty sections
+    for (const k of Object.keys(extend)) {
+        if (extend[k] && typeof extend[k] === 'object' && Object.keys(extend[k]).length === 0) {
+            delete extend[k];
+        }
+    }
+    return `/** Auto-generated by sync_design_tokens */\nexport default {\n  theme: {\n    extend: ${JSON.stringify(extend, null, 2)}\n  }\n}`;
+}
+export function tokensToTokensStudio(tokens) {
+    // Tokens Studio expects {"token": {"value": ..., "type": ...}}
+    const out = {};
+    for (const t of tokens) {
+        const parts = t.name.split('.').filter(Boolean);
+        if (parts.length === 0)
+            continue;
+        setNested(out, parts, { value: t.value, type: t.type, description: t.description });
+    }
+    return JSON.stringify(out, null, 2);
+}
+export function tokensToStyleDictionary(tokens) {
+    // Style Dictionary commonly uses nested objects with { value, type }
+    // We'll output a format compatible with SD v3+ token JSON.
+    const out = {};
+    for (const t of tokens) {
+        const parts = t.name.split('.').filter(Boolean);
+        if (parts.length === 0)
+            continue;
+        setNested(out, parts, { value: t.value, type: t.type });
+    }
+    return JSON.stringify(out, null, 2);
+}
+//# sourceMappingURL=sync.js.map

package/dist/tokens/sync.js.map

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

package/dist/tools/analyze-screenshot-ui.d.ts

@@ -0,0 +1,18 @@
+/**
+ * analyze_screenshot_ui Tool
+ *
+ * Multimodal screenshot analysis:
+ * - layout breakdown
+ * - component suggestions
+ * - token guesses
+ * - accessibility notes
+ *
+ * This tool can run in:
+ * - local gemini mode (Gemini SDK multimodal)
+ * - remote mode (gateway supports userParts)
+ * - local litellm mode (OpenAI-compatible image_url content)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Config } from '../config/index.js';
+export declare function registerAnalyzeScreenshotUI(server: McpServer, config: Config): void;
+//# sourceMappingURL=analyze-screenshot-ui.d.ts.map

package/dist/tools/analyze-screenshot-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-screenshot-ui.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-screenshot-ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAkD5C,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAgFnF"}

package/dist/tools/analyze-screenshot-ui.js

@@ -0,0 +1,133 @@
+/**
+ * analyze_screenshot_ui Tool
+ *
+ * Multimodal screenshot analysis:
+ * - layout breakdown
+ * - component suggestions
+ * - token guesses
+ * - accessibility notes
+ *
+ * This tool can run in:
+ * - local gemini mode (Gemini SDK multimodal)
+ * - remote mode (gateway supports userParts)
+ * - local litellm mode (OpenAI-compatible image_url content)
+ */
+import { z } from 'zod';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { assertReadablePath } from '../context/guards.js';
+import { sanitizeContent } from '../context/filter.js';
+import { buildContext } from '../context/builder.js';
+import { generateWithGemini } from '../generation/gemini-client.js';
+const inputSchema = {
+    imagePath: z.string().optional().describe('Path to an image file (png/jpg/webp).'),
+    imageBase64: z.string().optional().describe('Base64 image data (if not using imagePath).'),
+    mimeType: z.string().optional().describe('Image mime type, e.g. image/png. Required when using imageBase64.'),
+    instruction: z
+        .string()
+        .optional()
+        .describe('What to extract from the screenshot. Defaults to a full UI breakdown.'),
+    outputFormat: z.enum(['json', 'markdown']).default('json').describe('Response format.'),
+    framework: z
+        .enum(['react', 'nextjs', 'vue', 'svelte', 'vanilla'])
+        .optional()
+        .describe('Target framework hint.'),
+    context: z.array(z.string()).optional().describe('Related design/token files for grounding.'),
+};
+const SYSTEM_PROMPT = `You are a senior UI engineer and design system expert.
+
+You will analyze a UI screenshot and return a structured breakdown suitable for code generation.
+
+Output requirements:
+- If outputFormat=json: output ONE valid JSON object only. No prose. No markdown. No code fences.
+- If outputFormat=markdown: output concise markdown with headings and bullet points.
+
+When outputFormat=json, include:
+{
+  "layout": {"type": "page|modal|panel|component", "grid": "...", "sections": [...]},
+  "components": [{"name": "...", "role": "...", "suggestedImplementation": "..."}],
+  "tokensGuess": {"colors": [...], "typography": [...], "spacing": [...], "radii": [...], "shadows": [...]},
+  "a11y": {"landmarks": [...], "labels": [...], "keyboard": [...], "contrastRisks": [...]},
+  "notes": [...]
+}
+
+Be practical: prefer reusable primitives (Button, Input, Card, Table) and suggest variants/states.
+Do not invent backend logic.`;
+function mimeFromPath(p) {
+    const ext = path.extname(p).toLowerCase();
+    if (ext === '.png')
+        return 'image/png';
+    if (ext === '.jpg' || ext === '.jpeg')
+        return 'image/jpeg';
+    if (ext === '.webp')
+        return 'image/webp';
+    return 'application/octet-stream';
+}
+export function registerAnalyzeScreenshotUI(server, config) {
+    server.registerTool('analyze_screenshot_ui', {
+        title: 'Analyze UI Screenshot',
+        description: 'Analyze a UI screenshot (layout/components/tokens/a11y). Supports multimodal prompts in local or remote mode.',
+        inputSchema,
+    }, async (args) => {
+        const imagePath = args.imagePath;
+        const imageBase64 = args.imageBase64;
+        const mimeType = args.mimeType;
+        const instruction = args.instruction || '';
+        const outputFormat = args.outputFormat || 'json';
+        const framework = args.framework || config.defaultFramework;
+        const contextPaths = args.context;
+        if (!imagePath && !imageBase64) {
+            return {
+                content: [{ type: 'text', text: 'Error: Provide imagePath or imageBase64.' }],
+                isError: true,
+            };
+        }
+        let data;
+        let mime;
+        try {
+            if (imagePath) {
+                const safe = assertReadablePath(imagePath, config);
+                const buf = fs.readFileSync(safe);
+                data = buf.toString('base64');
+                mime = mimeFromPath(safe);
+            }
+            else {
+                data = imageBase64;
+                mime = mimeType || 'application/octet-stream';
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Could not read image';
+            return { content: [{ type: 'text', text: `Error: ${message}` }], isError: true };
+        }
+        let contextContent = '';
+        if (contextPaths && contextPaths.length > 0) {
+            contextContent = await buildContext(contextPaths, config);
+            contextContent = sanitizeContent(contextContent);
+        }
+        const userText = `Analyze this screenshot.
+
+outputFormat: ${outputFormat}
+frameworkHint: ${framework}
+instruction: ${instruction || '(full breakdown)'}
+
+${contextContent ? `RELATED FILES (sanitized):\n${contextContent}` : ''}
+
+Return in the requested format.`;
+        try {
+            const resp = await generateWithGemini(config, SYSTEM_PROMPT, [
+                { text: userText },
+                { inlineData: { mimeType: mime, data } },
+            ], { toolName: 'analyze_screenshot_ui' });
+            return { content: [{ type: 'text', text: resp.trim() }] };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [{ type: 'text', text: `Error analyzing screenshot: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=analyze-screenshot-ui.js.map

package/dist/tools/analyze-screenshot-ui.js.map

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

package/dist/tools/analyze-tokens.d.ts

@@ -0,0 +1,10 @@
+/**
+ * analyze_tokens Tool
+ *
+ * Extracts and understands existing design systems.
+ * Returns structured design tokens from CSS/SCSS files.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Config } from '../config/index.js';
+export declare function registerAnalyzeTokens(server: McpServer, config: Config): void;
+//# sourceMappingURL=analyze-tokens.d.ts.map

package/dist/tools/analyze-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-tokens.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-tokens.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAiC5C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA+E7E"}

package/dist/tools/analyze-tokens.js

@@ -0,0 +1,107 @@
+/**
+ * analyze_tokens Tool
+ *
+ * Extracts and understands existing design systems.
+ * Returns structured design tokens from CSS/SCSS files.
+ */
+import { z } from 'zod';
+import * as fs from 'node:fs';
+import { assertReadablePath } from '../context/guards.js';
+import { sanitizeContent } from '../context/filter.js';
+import { generateWithGemini } from '../generation/gemini-client.js';
+const inputSchema = {
+    paths: z.array(z.string()).describe('Paths to CSS, SCSS, or design token files to analyze'),
+    format: z
+        .enum(['json', 'css-vars', 'tailwind', 'summary'])
+        .default('json')
+        .describe('Output format for the extracted tokens'),
+};
+const SYSTEM_PROMPT = `You are a design system analyst. Your task is to extract and structure design tokens from CSS/SCSS files.
+
+Analyze the provided files and extract:
+1. Colors - with semantic names and usage hints
+2. Typography - font families, sizes, weights, line heights
+3. Spacing - margin/padding values, identify a scale (e.g. 4px base)
+4. Breakpoints - media query values
+5. Shadows - box-shadow values
+6. Border radii - radius values
+7. Transitions - duration and easing values
+8. Z-index - layering values
+
+Output rules:
+- If format=json: output ONE valid JSON object only. No prose. No markdown. No code fences.
+- If format=css-vars: output ONLY CSS custom properties (no markdown).
+- If format=tailwind: output ONLY a tailwind theme extension (JS object or full tailwind.config.js), no markdown.
+- If format=summary: output concise bullet points.
+
+When naming tokens, prefer semantic names (primary, surface, text, border) rather than raw hex values.`;
+export function registerAnalyzeTokens(server, config) {
+    server.registerTool('analyze_tokens', {
+        title: 'Analyze Design Tokens',
+        description: 'Extract and structure design tokens from existing CSS/SCSS files. Use before create_ui to understand existing design systems.',
+        inputSchema,
+    }, async (args) => {
+        const paths = args.paths;
+        const format = args.format || 'json';
+        // Read all specified files (with safety checks)
+        const fileContents = [];
+        const errors = [];
+        for (const filePath of paths) {
+            try {
+                const safePath = assertReadablePath(filePath, config);
+                const raw = fs.readFileSync(safePath, 'utf-8');
+                const content = sanitizeContent(raw);
+                fileContents.push(`/* File: ${filePath} */\n${content}`);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Could not read';
+                errors.push(`${filePath}: ${message}`);
+            }
+        }
+        if (fileContents.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: Could not read any files.\n${errors.join('\n')}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (errors.length > 0 && config.debug) {
+            console.error('[analyze_tokens] Warnings:\n' + errors.join('\n'));
+        }
+        const combinedContent = fileContents.join('\n\n');
+        const userPrompt = `Analyze these CSS/SCSS files and extract design tokens.
+Format: ${format}
+
+FILES:
+${combinedContent}`;
+        try {
+            const response = await generateWithGemini(config, SYSTEM_PROMPT, userPrompt, { toolName: 'analyze_tokens' });
+            // IMPORTANT: Return raw model output ONLY (no wrappers) so JSON / CSS output stays valid.
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: response.trim(),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error analyzing tokens: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=analyze-tokens.js.map

package/dist/tools/analyze-tokens.js.map

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

package/dist/tools/catalog-components.d.ts

@@ -0,0 +1,14 @@
+/**
+ * catalog_components Tool
+ *
+ * Builds a machine-readable catalog of exported components in the codebase.
+ *
+ * Why this matters:
+ * - Lets create_ui/snippet_ui/modify_ui match existing patterns
+ * - Enables component-library detection & reuse instead of regenerating duplicates
+ * - Grounding data for agents (props, file paths, exports)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Config } from '../config/index.js';
+export declare function registerCatalogComponents(server: McpServer, config: Config): void;
+//# sourceMappingURL=catalog-components.d.ts.map

package/dist/tools/catalog-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-components.d.ts","sourceRoot":"","sources":["../../src/tools/catalog-components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAuB5C,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA6DjF"}

package/dist/tools/catalog-components.js

@@ -0,0 +1,85 @@
+/**
+ * catalog_components Tool
+ *
+ * Builds a machine-readable catalog of exported components in the codebase.
+ *
+ * Why this matters:
+ * - Lets create_ui/snippet_ui/modify_ui match existing patterns
+ * - Enables component-library detection & reuse instead of regenerating duplicates
+ * - Grounding data for agents (props, file paths, exports)
+ */
+import { z } from 'zod';
+import * as path from 'node:path';
+import { assertReadableDir } from '../context/guards.js';
+import { walkFiles, toPosixPath } from '../utils/walk.js';
+import { buildComponentCatalog } from '../components/catalog.js';
+const inputSchema = {
+    roots: z
+        .array(z.string())
+        .optional()
+        .describe('Directories to scan (defaults to ["src"]).'),
+    extensions: z
+        .array(z.string())
+        .optional()
+        .describe('File extensions to include (defaults to [".tsx", ".jsx"]).'),
+    maxFiles: z
+        .number()
+        .int()
+        .min(1)
+        .max(50_000)
+        .default(2000)
+        .describe('Safety limit to avoid scanning huge repos.'),
+};
+export function registerCatalogComponents(server, config) {
+    server.registerTool('catalog_components', {
+        title: 'Catalog Components',
+        description: 'Scan the repo and return a JSON catalog of exported components (no LLM).',
+        inputSchema,
+    }, async (args) => {
+        const roots = args.roots || ['src'];
+        const extensions = args.extensions || ['.tsx', '.jsx'];
+        const maxFiles = args.maxFiles || 2000;
+        const safeRoots = [];
+        for (const r of roots) {
+            try {
+                safeRoots.push(assertReadableDir(r, config));
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Invalid root';
+                return {
+                    content: [{ type: 'text', text: `Error: ${message}` }],
+                    isError: true,
+                };
+            }
+        }
+        const allFiles = [];
+        for (const r of safeRoots) {
+            const found = walkFiles(r, { includeExtensions: extensions, maxFiles });
+            allFiles.push(...found);
+        }
+        // Use cwd as catalog root so paths are stable for agents
+        const root = path.resolve(process.cwd());
+        const catalog = await buildComponentCatalog(root, allFiles.map((f) => path.resolve(f)));
+        // Ensure POSIX paths
+        catalog.components = catalog.components.map((c) => ({ ...c, file: toPosixPath(c.file) }));
+        catalog.root = toPosixPath(catalog.root);
+        // Small summary
+        const summary = {
+            totalFiles: catalog.filesScanned,
+            totalComponents: catalog.components.length,
+            byExportType: {
+                named: catalog.components.filter((c) => c.exportType === 'named').length,
+                default: catalog.components.filter((c) => c.exportType === 'default').length,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ ...catalog, summary }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=catalog-components.js.map

package/dist/tools/catalog-components.js.map

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

package/dist/tools/create-ui.d.ts

@@ -0,0 +1,10 @@
+/**
+ * create_ui Tool
+ *
+ * Scaffolds new UI components or views.
+ * Generates complete, responsive, accessible frontend code.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Config } from '../config/index.js';
+export declare function registerCreateUI(server: McpServer, config: Config): void;
+//# sourceMappingURL=create-ui.d.ts.map

package/dist/tools/create-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-ui.d.ts","sourceRoot":"","sources":["../../src/tools/create-ui.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAsF5C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,QAkGjE"}