@muloka/figma-console-mcp 0.1.0

package/dist/core/design-system-manifest.js

@@ -0,0 +1,266 @@
+/**
+ * Design System Manifest Types
+ *
+ * A structured representation of a Figma design system that enables
+ * high-fidelity AI-assisted design generation.
+ */
+/**
+ * Cache for design system manifests with TTL-based invalidation.
+ * Singleton pattern to share cache across tool calls.
+ */
+export class DesignSystemManifestCache {
+    constructor() {
+        this.cache = new Map();
+        this.TTL_MS = 5 * 60 * 1000; // 5 minutes
+    }
+    static getInstance() {
+        if (!DesignSystemManifestCache.instance) {
+            DesignSystemManifestCache.instance = new DesignSystemManifestCache();
+        }
+        return DesignSystemManifestCache.instance;
+    }
+    get(fileKey) {
+        const entry = this.cache.get(fileKey);
+        if (!entry)
+            return null;
+        if (!this.isValid(entry)) {
+            this.cache.delete(fileKey);
+            return null;
+        }
+        return entry;
+    }
+    set(fileKey, manifest, rawComponents) {
+        this.cache.set(fileKey, {
+            manifest,
+            timestamp: Date.now(),
+            fileKey,
+            rawComponents,
+        });
+    }
+    invalidate(fileKey) {
+        this.cache.delete(fileKey);
+    }
+    invalidateAll() {
+        this.cache.clear();
+    }
+    isValid(entry) {
+        return Date.now() - entry.timestamp < this.TTL_MS;
+    }
+    getStats() {
+        const stats = [];
+        for (const [fileKey, entry] of this.cache) {
+            stats.push({
+                fileKey,
+                age: Math.round((Date.now() - entry.timestamp) / 1000),
+                componentCount: entry.manifest.summary.totalComponents + entry.manifest.summary.totalComponentSets,
+                tokenCount: entry.manifest.summary.totalTokens,
+            });
+        }
+        return stats;
+    }
+}
+/**
+ * Search components by name, category, or description
+ */
+export function searchComponents(manifest, query, options) {
+    const limit = options?.limit ?? 10;
+    const offset = options?.offset ?? 0;
+    const queryLower = query.toLowerCase();
+    const categoryLower = options?.category?.toLowerCase();
+    const allResults = [];
+    // Search component sets first (they're typically the main design system components).
+    // Manifest maps are keyed by component key — always read names from the entry.
+    for (const compSet of Object.values(manifest.componentSets)) {
+        const nameLower = compSet.name.toLowerCase();
+        const descLower = compSet.description?.toLowerCase() || '';
+        const matchesQuery = !query || nameLower.includes(queryLower) || descLower.includes(queryLower);
+        const matchesCategory = !categoryLower || inferCategory(compSet.name).toLowerCase().includes(categoryLower);
+        if (matchesQuery && matchesCategory) {
+            allResults.push({
+                name: compSet.name,
+                key: compSet.key,
+                nodeId: compSet.nodeId,
+                type: 'componentSet',
+                description: compSet.description,
+                category: inferCategory(compSet.name),
+                variantCount: compSet.variants?.length || 0,
+            });
+        }
+    }
+    // Then search standalone components
+    for (const comp of Object.values(manifest.components)) {
+        const nameLower = comp.name.toLowerCase();
+        const descLower = comp.description?.toLowerCase() || '';
+        const matchesQuery = !query || nameLower.includes(queryLower) || descLower.includes(queryLower);
+        const matchesCategory = !categoryLower || inferCategory(comp.name).toLowerCase().includes(categoryLower);
+        if (matchesQuery && matchesCategory) {
+            allResults.push({
+                name: comp.name,
+                key: comp.key,
+                nodeId: comp.nodeId,
+                type: 'component',
+                description: comp.description,
+                category: inferCategory(comp.name),
+                defaultSize: comp.defaultSize,
+            });
+        }
+    }
+    const total = allResults.length;
+    // Truncate long doc blocks in search hits — full text is available via
+    // figma_get_component_details.
+    const paginatedResults = allResults.slice(offset, offset + limit).map((r) => r.description && r.description.length > 200
+        ? { ...r, description: `${r.description.slice(0, 200)}…`, descriptionTruncated: true }
+        : r);
+    const hasMore = offset + limit < total;
+    return { results: paginatedResults, total, hasMore };
+}
+/**
+ * Infer category from component name (e.g., "Button/Primary" -> "Button")
+ */
+function inferCategory(name) {
+    const parts = name.split('/');
+    return parts[0] || 'Uncategorized';
+}
+/**
+ * Get unique categories from manifest
+ */
+export function getCategories(manifest) {
+    const categories = new Map();
+    for (const compSet of Object.values(manifest.componentSets)) {
+        const cat = inferCategory(compSet.name);
+        const existing = categories.get(cat) || { componentCount: 0, componentSetCount: 0 };
+        existing.componentSetCount++;
+        categories.set(cat, existing);
+    }
+    for (const comp of Object.values(manifest.components)) {
+        const cat = inferCategory(comp.name);
+        const existing = categories.get(cat) || { componentCount: 0, componentSetCount: 0 };
+        existing.componentCount++;
+        categories.set(cat, existing);
+    }
+    return Array.from(categories.entries())
+        .map(([name, counts]) => ({ name, ...counts }))
+        .sort((a, b) => (b.componentCount + b.componentSetCount) - (a.componentCount + a.componentSetCount));
+}
+/**
+ * Get token categories and counts for summary
+ */
+export function getTokenSummary(manifest) {
+    // Group colors by prefix (e.g., "primary/500" -> "primary")
+    const colorGroups = new Set();
+    for (const name of Object.keys(manifest.tokens.colors)) {
+        const group = name.split('/')[0];
+        colorGroups.add(group);
+    }
+    // Group typography by prefix
+    const typographyGroups = new Set();
+    for (const name of Object.keys(manifest.tokens.typography)) {
+        const group = name.split('/')[0];
+        typographyGroups.add(group);
+    }
+    // Get spacing scale values
+    const spacingValues = Object.values(manifest.tokens.spacing)
+        .map(t => t.value)
+        .filter((v, i, arr) => arr.indexOf(v) === i)
+        .sort((a, b) => a - b);
+    return {
+        colors: {
+            count: Object.keys(manifest.tokens.colors).length,
+            groups: Array.from(colorGroups).slice(0, 10),
+        },
+        spacing: {
+            count: Object.keys(manifest.tokens.spacing).length,
+            scale: spacingValues.slice(0, 15),
+        },
+        typography: {
+            count: Object.keys(manifest.tokens.typography).length,
+            groups: Array.from(typographyGroups).slice(0, 10),
+        },
+        effects: {
+            count: Object.keys(manifest.tokens.effects).length,
+        },
+        collections: manifest.collections.map(c => c.name),
+    };
+}
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Convert RGB color object to hex string
+ */
+export function rgbToHex(color) {
+    const toHex = (n) => Math.round(n * 255).toString(16).padStart(2, '0');
+    return `#${toHex(color.r)}${toHex(color.g)}${toHex(color.b)}`.toUpperCase();
+}
+/**
+ * Parse a Figma color value to hex
+ */
+export function figmaColorToHex(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value && typeof value === 'object' && 'r' in value) {
+        return rgbToHex(value);
+    }
+    return '#000000';
+}
+/**
+ * Generate a human-readable summary of the manifest
+ */
+export function generateManifestSummary(manifest) {
+    const lines = [
+        `# Design System Manifest`,
+        ``,
+        `**File:** ${manifest.fileName || manifest.fileKey}`,
+        `**Generated:** ${new Date(manifest.generatedAt).toISOString()}`,
+        ``,
+        `## Summary`,
+        `- **${manifest.summary.totalTokens}** design tokens`,
+        `- **${manifest.summary.totalComponents}** components`,
+        `- **${manifest.summary.totalComponentSets}** component sets`,
+        ``,
+        `## Color Palette`,
+        manifest.summary.colorPalette.slice(0, 10).map(c => `- ${c}`).join('\n'),
+        ``,
+        `## Spacing Scale`,
+        `${manifest.summary.spacingScale.join('px, ')}px`,
+        ``,
+        `## Typography`,
+        manifest.summary.typographyScale.slice(0, 10).map(t => `- ${t}`).join('\n'),
+        ``,
+        `## Component Categories`,
+        manifest.summary.componentCategories.map(c => `- ${c}`).join('\n'),
+    ];
+    return lines.join('\n');
+}
+/**
+ * Create an empty manifest template
+ */
+export function createEmptyManifest(fileKey) {
+    return {
+        version: '1.0.0',
+        generatedAt: Date.now(),
+        fileKey,
+        collections: [],
+        tokens: {
+            colors: {},
+            spacing: {},
+            typography: {},
+            effects: {},
+            other: {},
+        },
+        components: {},
+        componentSets: {},
+        patterns: {},
+        rules: [],
+        summary: {
+            totalTokens: 0,
+            totalComponents: 0,
+            totalComponentSets: 0,
+            colorPalette: [],
+            spacingScale: [],
+            typographyScale: [],
+            componentCategories: [],
+        },
+    };
+}
+//# sourceMappingURL=design-system-manifest.js.map

package/dist/core/design-system-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-system-manifest.js","sourceRoot":"","sources":["../../src/core/design-system-manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiNH;;;GAGG;AACH,MAAM,OAAO,yBAAyB;IAKrC;QAHQ,UAAK,GAAoC,IAAI,GAAG,EAAE,CAAC;QAC1C,WAAM,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;IAE9B,CAAC;IAExB,MAAM,CAAC,WAAW;QACjB,IAAI,CAAC,yBAAyB,CAAC,QAAQ,EAAE,CAAC;YACzC,yBAAyB,CAAC,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAC;QACtE,CAAC;QACD,OAAO,yBAAyB,CAAC,QAAQ,CAAC;IAC3C,CAAC;IAED,GAAG,CAAC,OAAe;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,GAAG,CAAC,OAAe,EAAE,QAA8B,EAAE,aAA2D;QAC/G,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE;YACvB,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO;YACP,aAAa;SACb,CAAC,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,OAAe;QACzB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,aAAa;QACZ,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,CAAC,KAAyB;QAChC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;IACnD,CAAC;IAED,QAAQ;QACP,MAAM,KAAK,GAAmF,EAAE,CAAC;QACjG,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC;gBACV,OAAO;gBACP,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;gBACtD,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB;gBAClG,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW;aAC9C,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;CACD;AAkBD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC/B,QAA8B,EAC9B,KAAa,EACb,OAAgE;IAEhE,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,aAAa,GAAG,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAEvD,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,qFAAqF;IACrF,+EAA+E;IAC/E,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAE3D,MAAM,YAAY,GAAG,CAAC,KAAK,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAChG,MAAM,eAAe,GAAG,CAAC,aAAa,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAE5G,IAAI,YAAY,IAAI,eAAe,EAAE,CAAC;YACrC,UAAU,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;gBACrC,YAAY,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;aAC3C,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,oCAAoC;IACpC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAExD,MAAM,YAAY,GAAG,CAAC,KAAK,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAChG,MAAM,eAAe,GAAG,CAAC,aAAa,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAEzG,IAAI,YAAY,IAAI,eAAe,EAAE,CAAC;YACrC,UAAU,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;gBAClC,WAAW,EAAE,IAAI,CAAC,WAAW;aAC7B,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC;IAChC,uEAAuE;IACvE,+BAA+B;IAC/B,MAAM,gBAAgB,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3E,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,GAAG;QAC1C,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE;QACtF,CAAC,CAAC,CAAC,CACJ,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAEvC,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAA8B;IAC3D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAiE,CAAC;IAE5F,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7D,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;QACpF,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QAC7B,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACvD,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;QACpF,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC1B,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;SACrC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;SAC9C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;AACvG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAA8B;IAO7D,4DAA4D;IAC5D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,6BAA6B;IAC7B,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,2BAA2B;IAC3B,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;SAC1D,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;SAC3C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAExB,OAAO;QACN,MAAM,EAAE;YACP,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM;YACjD,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SAC5C;QACD,OAAO,EAAE;YACR,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM;YAClD,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACjC;QACD,UAAU,EAAE;YACX,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM;YACrD,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACjD;QACD,OAAO,EAAE;YACR,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM;SAClD;QACD,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;KAClD,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAA0C;IAClE,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/E,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAU;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;QACxD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAA8B;IACrE,MAAM,KAAK,GAAa;QACvB,0BAA0B;QAC1B,EAAE;QACF,aAAa,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,OAAO,EAAE;QACpD,kBAAkB,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE;QAChE,EAAE;QACF,YAAY;QACZ,OAAO,QAAQ,CAAC,OAAO,CAAC,WAAW,kBAAkB;QACrD,OAAO,QAAQ,CAAC,OAAO,CAAC,eAAe,eAAe;QACtD,OAAO,QAAQ,CAAC,OAAO,CAAC,kBAAkB,mBAAmB;QAC7D,EAAE;QACF,kBAAkB;QAClB,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACxE,EAAE;QACF,kBAAkB;QAClB,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI;QACjD,EAAE;QACF,eAAe;QACf,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3E,EAAE;QACF,yBAAyB;QACzB,QAAQ,CAAC,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KAClE,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IAClD,OAAO;QACN,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;QACvB,OAAO;QACP,WAAW,EAAE,EAAE;QACf,MAAM,EAAE;YACP,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,EAAE;SACT;QACD,UAAU,EAAE,EAAE;QACd,aAAa,EAAE,EAAE;QACjB,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,OAAO,EAAE;YACR,WAAW,EAAE,CAAC;YACd,eAAe,EAAE,CAAC;YAClB,kBAAkB,EAAE,CAAC;YACrB,YAAY,EAAE,EAAE;YAChB,YAAY,EAAE,EAAE;YAChB,eAAe,EAAE,EAAE;YACnB,mBAAmB,EAAE,EAAE;SACvB;KACD,CAAC;AACH,CAAC"}

package/dist/core/design-system-tools.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Design System Kit Tool
+ * MCP tool that orchestrates existing Figma API tools to produce a structured
+ * design system specification — tokens, components, styles — in a single call.
+ *
+ * This enables AI code generation tools (Figma Make, v0, Cursor, Claude, etc.)
+ * to generate code with structural fidelity to the real design system.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { FigmaAPI } from "./figma-api.js";
+interface VisualSpec {
+    fills?: Array<{
+        type: string;
+        color?: string;
+        opacity?: number;
+    }>;
+    strokes?: Array<{
+        type: string;
+        color?: string;
+        weight?: number;
+        align?: string;
+    }>;
+    effects?: Array<{
+        type: string;
+        color?: string;
+        offset?: {
+            x: number;
+            y: number;
+        };
+        radius?: number;
+        spread?: number;
+    }>;
+    cornerRadius?: number;
+    rectangleCornerRadii?: number[];
+    opacity?: number;
+    layout?: {
+        mode?: string;
+        paddingTop?: number;
+        paddingRight?: number;
+        paddingBottom?: number;
+        paddingLeft?: number;
+        itemSpacing?: number;
+        primaryAxisAlign?: string;
+        counterAxisAlign?: string;
+    };
+    typography?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fontWeight?: number;
+        lineHeight?: any;
+        letterSpacing?: any;
+        textAlignHorizontal?: string;
+    };
+}
+/**
+ * Extract a compact visual specification from a Figma node.
+ * Captures the essential CSS-equivalent properties an AI needs to reproduce the component.
+ */
+export declare function extractVisualSpec(node: any): VisualSpec | undefined;
+export declare function registerDesignSystemTools(server: McpServer, getFigmaAPI: () => Promise<FigmaAPI>, getCurrentUrl: () => string | null, variablesCache?: Map<string, {
+    data: any;
+    timestamp: number;
+}>, options?: {
+    isRemoteMode?: boolean;
+}, getDesktopConnector?: () => Promise<any>): void;
+export {};
+//# sourceMappingURL=design-system-tools.d.ts.map

package/dist/core/design-system-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-system-tools.d.ts","sourceRoot":"","sources":["../../src/core/design-system-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAyB/C,UAAU,UAAU;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,UAAU,CAAC,EAAE;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,GAAG,CAAC;QACjB,aAAa,CAAC,EAAE,GAAG,CAAC;QACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;CACF;AAuFD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,UAAU,GAAG,SAAS,CA6FnE;AAiTD,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EACpC,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,EAClC,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9D,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,EACpC,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACtC,IAAI,CAmhBN"}