@obra-studio/figma-console-mcp 1.32.0

package/dist/core/figma-style-extractor.js

@@ -0,0 +1,312 @@
+/**
+ * Figma Style Extractor
+ *
+ * Extracts style information (colors, typography, spacing) from Figma files
+ * using the REST API /files endpoint. This provides an alternative to the
+ * Enterprise-only Variables API by parsing style data directly from nodes.
+ *
+ * Based on the approach used by Figma-Context-MCP
+ */
+import { logger } from './logger';
+export class FigmaStyleExtractor {
+    constructor() {
+        this.extractedVariables = new Map();
+        this.colorIndex = 0;
+        this.typographyIndex = 0;
+        this.spacingIndex = 0;
+        this.radiusIndex = 0;
+    }
+    /**
+     * Extract style "variables" from Figma file data
+     * This mimics what users would see as variables in Figma
+     */
+    async extractStylesFromFile(fileData) {
+        try {
+            logger.info('Extracting styles from Figma file data');
+            this.extractedVariables.clear();
+            this.colorIndex = 0;
+            this.typographyIndex = 0;
+            this.spacingIndex = 0;
+            this.radiusIndex = 0;
+            // Process the document tree
+            if (fileData.document) {
+                this.processNode(fileData.document);
+            }
+            // Also process components for more style data
+            if (fileData.components) {
+                Object.values(fileData.components).forEach((component) => {
+                    if (component.node) {
+                        this.processNode(component.node);
+                    }
+                });
+            }
+            // Process styles if available
+            if (fileData.styles) {
+                this.processStyles(fileData.styles);
+            }
+            const variables = Array.from(this.extractedVariables.values());
+            logger.info({
+                colorCount: variables.filter(v => v.type === 'COLOR').length,
+                typographyCount: variables.filter(v => v.type === 'TYPOGRAPHY').length,
+                spacingCount: variables.filter(v => v.type === 'SPACING').length,
+                radiusCount: variables.filter(v => v.type === 'RADIUS').length,
+                totalCount: variables.length
+            }, 'Extracted style variables from file');
+            return variables;
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to extract styles from file');
+            throw error;
+        }
+    }
+    /**
+     * Process a single node and extract style information
+     */
+    processNode(node, depth = 0) {
+        if (!node || depth > 10)
+            return; // Limit depth to prevent infinite recursion
+        // Extract colors from fills
+        if (node.fills && Array.isArray(node.fills)) {
+            node.fills.forEach(fill => {
+                if (fill.type === 'SOLID' && fill.color && fill.visible !== false) {
+                    this.extractColor(fill.color, fill.opacity, node);
+                }
+            });
+        }
+        // Extract colors from strokes
+        if (node.strokes && Array.isArray(node.strokes)) {
+            node.strokes.forEach(stroke => {
+                if (stroke.type === 'SOLID' && stroke.color && stroke.visible !== false) {
+                    this.extractColor(stroke.color, stroke.opacity, node, 'stroke');
+                }
+            });
+        }
+        // Extract typography styles
+        if (node.type === 'TEXT' && node.style) {
+            this.extractTypography(node.style, node);
+        }
+        // Extract spacing from auto-layout
+        if (node.layoutMode) {
+            if (node.itemSpacing !== undefined && node.itemSpacing > 0) {
+                this.extractSpacing('spacing', node.itemSpacing, node);
+            }
+            if (node.paddingLeft !== undefined && node.paddingLeft > 0) {
+                this.extractSpacing('padding', node.paddingLeft, node);
+            }
+        }
+        // Extract corner radius
+        if (node.cornerRadius !== undefined && node.cornerRadius > 0) {
+            this.extractRadius(node.cornerRadius, node);
+        }
+        else if (node.rectangleCornerRadii && node.rectangleCornerRadii.length > 0) {
+            const uniqueRadii = [...new Set(node.rectangleCornerRadii)];
+            uniqueRadii.forEach(radius => {
+                if (radius > 0) {
+                    this.extractRadius(radius, node);
+                }
+            });
+        }
+        // Process children recursively
+        if (node.children && Array.isArray(node.children)) {
+            node.children.forEach(child => {
+                this.processNode(child, depth + 1);
+            });
+        }
+    }
+    /**
+     * Extract color variable
+     */
+    extractColor(color, opacity = 1, node, type = 'fill') {
+        const r = Math.round(color.r * 255);
+        const g = Math.round(color.g * 255);
+        const b = Math.round(color.b * 255);
+        const a = opacity * (color.a || 1);
+        const hex = '#' + ((1 << 24) + (r << 16) + (g << 8) + b).toString(16).slice(1).toUpperCase();
+        const rgba = a < 1 ? `rgba(${r}, ${g}, ${b}, ${a})` : hex;
+        // Create a unique key based on the color value
+        const key = `color_${hex}_${a}`;
+        if (!this.extractedVariables.has(key)) {
+            // Generate a meaningful name based on the node
+            const category = this.inferColorCategory(node.name);
+            const name = this.generateColorName(category, type, this.colorIndex++);
+            this.extractedVariables.set(key, {
+                id: key,
+                name,
+                value: rgba,
+                type: 'COLOR',
+                category,
+                description: `Extracted from ${node.name || 'unnamed node'}`,
+                nodeId: node.id
+            });
+        }
+    }
+    /**
+     * Extract typography variable
+     */
+    extractTypography(style, node) {
+        const key = `typography_${style.fontFamily}_${style.fontSize}_${style.fontWeight}`;
+        if (!this.extractedVariables.has(key)) {
+            const name = this.generateTypographyName(node.name, this.typographyIndex++);
+            const value = [
+                `font-family: "${style.fontFamily || 'Inter'}"`,
+                style.fontSize ? `font-size: ${style.fontSize}px` : '',
+                style.fontWeight ? `font-weight: ${style.fontWeight}` : '',
+                style.lineHeightPx ? `line-height: ${style.lineHeightPx}px` : '',
+                style.letterSpacing ? `letter-spacing: ${style.letterSpacing}px` : ''
+            ].filter(Boolean).join(', ');
+            this.extractedVariables.set(key, {
+                id: key,
+                name,
+                value,
+                type: 'TYPOGRAPHY',
+                category: 'text',
+                description: `Extracted from ${node.name || 'unnamed text'}`,
+                nodeId: node.id
+            });
+        }
+    }
+    /**
+     * Extract spacing variable
+     */
+    extractSpacing(type, value, node) {
+        const key = `spacing_${type}_${value}`;
+        if (!this.extractedVariables.has(key)) {
+            const name = `${type}/${Math.round(value / 4) * 4 || value}`; // Round to nearest 4px
+            this.extractedVariables.set(key, {
+                id: key,
+                name,
+                value: `${value}px`,
+                type: 'SPACING',
+                category: type,
+                description: `Extracted from ${node.name || 'unnamed node'}`,
+                nodeId: node.id
+            });
+        }
+    }
+    /**
+     * Extract radius variable
+     */
+    extractRadius(value, node) {
+        const key = `radius_${value}`;
+        if (!this.extractedVariables.has(key)) {
+            const name = `radius/${this.categorizeRadius(value)}`;
+            this.extractedVariables.set(key, {
+                id: key,
+                name,
+                value: `${value}px`,
+                type: 'RADIUS',
+                category: 'border',
+                description: `Extracted from ${node.name || 'unnamed node'}`,
+                nodeId: node.id
+            });
+        }
+    }
+    /**
+     * Process Figma styles object
+     */
+    processStyles(styles) {
+        Object.entries(styles).forEach(([styleId, styleData]) => {
+            const { name, description, styleType } = styleData;
+            if (styleType === 'FILL' || styleType === 'TEXT') {
+                // These are named styles that could be considered variables
+                const variable = {
+                    id: styleId,
+                    name: name || styleId,
+                    value: styleId,
+                    type: styleType === 'FILL' ? 'COLOR' : 'TYPOGRAPHY',
+                    description: description || `Style: ${name}`,
+                    category: 'style'
+                };
+                this.extractedVariables.set(`style_${styleId}`, variable);
+            }
+        });
+    }
+    /**
+     * Helper to infer color category from node name
+     */
+    inferColorCategory(nodeName) {
+        if (!nodeName)
+            return 'color';
+        const name = nodeName.toLowerCase();
+        if (name.includes('background') || name.includes('bg'))
+            return 'background';
+        if (name.includes('text') || name.includes('label') || name.includes('title'))
+            return 'text';
+        if (name.includes('border') || name.includes('stroke'))
+            return 'border';
+        if (name.includes('primary') || name.includes('secondary') || name.includes('accent'))
+            return 'theme';
+        if (name.includes('success') || name.includes('error') || name.includes('warning'))
+            return 'semantic';
+        return 'color';
+    }
+    /**
+     * Generate a meaningful color name
+     */
+    generateColorName(category, type, index) {
+        const tier = index < 5 ? 'primary' : index < 10 ? 'secondary' : 'tertiary';
+        return `${category}/${tier}-${type}`;
+    }
+    /**
+     * Generate a meaningful typography name
+     */
+    generateTypographyName(nodeName, index) {
+        if (nodeName) {
+            const name = nodeName.toLowerCase();
+            if (name.includes('heading') || name.includes('h1') || name.includes('h2')) {
+                return `heading/${name.replace(/[^a-z0-9]/g, '-')}`;
+            }
+            if (name.includes('body') || name.includes('paragraph')) {
+                return `body/${name.replace(/[^a-z0-9]/g, '-')}`;
+            }
+            if (name.includes('caption') || name.includes('label')) {
+                return `caption/${name.replace(/[^a-z0-9]/g, '-')}`;
+            }
+        }
+        return `text/style-${index}`;
+    }
+    /**
+     * Categorize radius values
+     */
+    categorizeRadius(value) {
+        if (value === 0)
+            return 'none';
+        if (value <= 2)
+            return 'xs';
+        if (value <= 4)
+            return 'sm';
+        if (value <= 8)
+            return 'md';
+        if (value <= 16)
+            return 'lg';
+        if (value <= 24)
+            return 'xl';
+        return 'xxl';
+    }
+    /**
+     * Format the extracted variables for output
+     */
+    formatVariablesAsOutput(variables) {
+        // Group variables by type and category
+        const grouped = {};
+        variables.forEach(variable => {
+            const key = variable.name;
+            grouped[key] = variable.value;
+        });
+        // Add metadata about extraction method
+        grouped['_metadata'] = {
+            extractionMethod: 'REST_API_STYLES',
+            note: 'These are extracted style properties, not true Figma Variables (which require Enterprise)',
+            timestamp: new Date().toISOString(),
+            counts: {
+                colors: variables.filter(v => v.type === 'COLOR').length,
+                typography: variables.filter(v => v.type === 'TYPOGRAPHY').length,
+                spacing: variables.filter(v => v.type === 'SPACING').length,
+                radius: variables.filter(v => v.type === 'RADIUS').length,
+                total: variables.length
+            }
+        };
+        return grouped;
+    }
+}
+//# sourceMappingURL=figma-style-extractor.js.map

package/dist/core/figma-style-extractor.js.map

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

package/dist/core/figma-tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Figma API MCP Tools
+ * MCP tool definitions for Figma REST API data extraction
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { FigmaAPI } from "./figma-api.js";
+/**
+ * Options for registering Figma API tools
+ */
+interface FigmaAPIToolsOptions {
+    /** When true, suppresses Desktop Bridge mentions in tool descriptions (for remote/cloud mode) */
+    isRemoteMode?: boolean;
+}
+/**
+ * Register Figma API tools with the MCP server
+ */
+export declare function registerFigmaAPITools(server: McpServer, getFigmaAPI: () => Promise<FigmaAPI>, getCurrentUrl: () => string | null, variablesCache?: Map<string, {
+    data: any;
+    timestamp: number;
+}>, options?: FigmaAPIToolsOptions, getDesktopConnector?: () => Promise<any>): void;
+export {};
+//# sourceMappingURL=figma-tools.d.ts.map

package/dist/core/figma-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-tools.d.ts","sourceRoot":"","sources":["../../src/core/figma-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,gBAAgB,CAAC;AAiwB7D;;GAEG;AACH,UAAU,oBAAoB;IAC7B,iGAAiG;IACjG,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,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,oBAAoB,EAC9B,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,QAo9FxC"}