@mp3wizard/figma-console-mcp 1.14.0

package/dist/core/enrichment/style-resolver.js

@@ -0,0 +1,327 @@
+/**
+ * Style Value Resolver
+ * Resolves style values from variable references and provides formatted outputs
+ */
+export class StyleValueResolver {
+    constructor(logger) {
+        this.cache = new Map();
+        this.variableCache = new Map();
+        this.logger = logger;
+    }
+    /**
+     * Resolve a style's value, handling variable references
+     */
+    async resolveStyleValue(style, variables, maxDepth = 10) {
+        const cacheKey = `style:${style.key || style.node_id}`;
+        // Check cache
+        if (this.cache.has(cacheKey)) {
+            return this.cache.get(cacheKey);
+        }
+        try {
+            // Get the actual style node data
+            const styleData = await this.getStyleData(style);
+            if (!styleData) {
+                return { value: null };
+            }
+            // Check if this style uses a variable
+            const variableRef = this.findVariableReference(styleData);
+            if (variableRef && variables.has(variableRef.id)) {
+                // Resolve the variable value
+                const variable = variables.get(variableRef.id);
+                const resolvedValue = await this.resolveVariableValue(variable, variables, maxDepth);
+                const result = {
+                    value: resolvedValue,
+                    variableRef: {
+                        id: variableRef.id,
+                        name: variable.name,
+                        collection: variable.variableCollectionId,
+                        resolvedType: variable.resolvedType,
+                    },
+                };
+                this.cache.set(cacheKey, result);
+                return result;
+            }
+            // No variable reference, return direct value
+            const directValue = this.extractDirectValue(styleData, style.style_type);
+            const result = { value: directValue };
+            this.cache.set(cacheKey, result);
+            return result;
+        }
+        catch (error) {
+            this.logger.error({
+                error,
+                style: style.name,
+            }, "Error resolving style value");
+            return { value: null };
+        }
+    }
+    /**
+     * Resolve a variable's value, handling alias chains
+     */
+    async resolveVariableValue(variable, allVariables, maxDepth = 10, currentDepth = 0) {
+        if (currentDepth >= maxDepth) {
+            this.logger.warn({
+                variable: variable.name,
+            }, "Max resolution depth reached");
+            return null;
+        }
+        const cacheKey = `var:${variable.id}`;
+        if (this.variableCache.has(cacheKey)) {
+            return this.variableCache.get(cacheKey);
+        }
+        try {
+            // Get the value for the default mode (or first available mode)
+            const modes = Object.keys(variable.valuesByMode || {});
+            if (modes.length === 0) {
+                return null;
+            }
+            const defaultMode = modes[0]; // TODO: Support mode selection
+            const value = variable.valuesByMode[defaultMode];
+            // Check if this is an alias (reference to another variable)
+            if (typeof value === "object" && value.type === "VARIABLE_ALIAS") {
+                const targetVariable = allVariables.get(value.id);
+                if (!targetVariable) {
+                    this.logger.warn({
+                        source: variable.name,
+                        targetId: value.id,
+                    }, "Variable alias target not found");
+                    return null;
+                }
+                // Recursively resolve the alias
+                const resolvedValue = await this.resolveVariableValue(targetVariable, allVariables, maxDepth, currentDepth + 1);
+                this.variableCache.set(cacheKey, resolvedValue);
+                return resolvedValue;
+            }
+            // Direct value - format based on type
+            const formattedValue = this.formatVariableValue(value, variable.resolvedType);
+            this.variableCache.set(cacheKey, formattedValue);
+            return formattedValue;
+        }
+        catch (error) {
+            this.logger.error({
+                error,
+                variable: variable.name,
+            }, "Error resolving variable value");
+            return null;
+        }
+    }
+    /**
+     * Format a variable value based on its type
+     */
+    formatVariableValue(value, type) {
+        if (!value)
+            return null;
+        switch (type) {
+            case "COLOR":
+                return this.formatColor(value);
+            case "FLOAT":
+            case "NUMBER":
+                return value;
+            case "STRING":
+                return value;
+            case "BOOLEAN":
+                return Boolean(value);
+            default:
+                return value;
+        }
+    }
+    /**
+     * Format a color value to hex string
+     */
+    formatColor(color) {
+        if (typeof color === "string") {
+            return color;
+        }
+        if (color.r !== undefined && color.g !== undefined && color.b !== undefined) {
+            const r = Math.round(color.r * 255);
+            const g = Math.round(color.g * 255);
+            const b = Math.round(color.b * 255);
+            return `#${r.toString(16).padStart(2, "0")}${g.toString(16).padStart(2, "0")}${b.toString(16).padStart(2, "0")}`.toUpperCase();
+        }
+        return null;
+    }
+    /**
+     * Generate export formats for a resolved value
+     */
+    generateExportFormats(name, value, type, formats = ["css", "sass", "tailwind", "typescript", "json"]) {
+        const result = {};
+        // Sanitize name for different formats
+        const cssName = this.toCSSVariableName(name);
+        const sassName = this.toSassVariableName(name);
+        const tailwindName = this.toTailwindClassName(name);
+        const tsName = this.toTypeScriptPath(name);
+        const jsonPath = this.toJSONPath(name);
+        for (const format of formats) {
+            switch (format) {
+                case "css":
+                    result.css = `var(${cssName})`;
+                    break;
+                case "sass":
+                    result.sass = sassName;
+                    break;
+                case "tailwind":
+                    result.tailwind = tailwindName;
+                    break;
+                case "typescript":
+                    result.typescript = tsName;
+                    break;
+                case "json":
+                    result.json = jsonPath;
+                    break;
+            }
+        }
+        return result;
+    }
+    /**
+     * Convert token name to CSS variable format
+     * Example: "color/background/primary-default" -> "--color-background-primary-default"
+     */
+    toCSSVariableName(name) {
+        return `--${name.replace(/\//g, "-").toLowerCase()}`;
+    }
+    /**
+     * Convert token name to Sass variable format
+     * Example: "color/background/primary-default" -> "$color-background-primary-default"
+     */
+    toSassVariableName(name) {
+        return `$${name.replace(/\//g, "-").toLowerCase()}`;
+    }
+    /**
+     * Convert token name to Tailwind class format
+     * Example: "color/background/primary-default" -> "bg-primary"
+     */
+    toTailwindClassName(name) {
+        const parts = name.split("/");
+        // Try to infer Tailwind utility class
+        if (parts[0] === "color") {
+            if (parts[1] === "background") {
+                return `bg-${parts[parts.length - 1].toLowerCase()}`;
+            }
+            if (parts[1] === "text") {
+                return `text-${parts[parts.length - 1].toLowerCase()}`;
+            }
+            if (parts[1] === "border") {
+                return `border-${parts[parts.length - 1].toLowerCase()}`;
+            }
+        }
+        if (parts[0] === "spacing") {
+            return `space-${parts[parts.length - 1].toLowerCase()}`;
+        }
+        // Fallback: use last part
+        return parts[parts.length - 1].toLowerCase();
+    }
+    /**
+     * Convert token name to TypeScript path format
+     * Example: "color/background/primary-default" -> "tokens.color.background.primaryDefault"
+     */
+    toTypeScriptPath(name) {
+        const parts = name.split("/");
+        const camelCaseParts = parts.map((part, index) => {
+            if (index === 0)
+                return part.toLowerCase();
+            return part
+                .split("-")
+                .map((word, i) => i === 0
+                ? word.toLowerCase()
+                : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+                .join("");
+        });
+        return `tokens.${camelCaseParts.join(".")}`;
+    }
+    /**
+     * Convert token name to nested JSON path
+     * Example: "color/background/primary-default" -> { color: { background: { primaryDefault: value } } }
+     */
+    toJSONPath(name) {
+        const parts = name.split("/");
+        const result = {};
+        let current = result;
+        for (let i = 0; i < parts.length; i++) {
+            const key = parts[i]
+                .split("-")
+                .map((word, j) => j === 0
+                ? word.toLowerCase()
+                : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+                .join("");
+            if (i === parts.length - 1) {
+                current[key] = "[VALUE]"; // Placeholder
+            }
+            else {
+                current[key] = {};
+                current = current[key];
+            }
+        }
+        return result;
+    }
+    /**
+     * Get style data from Figma API
+     * This would be called via the Figma API client
+     */
+    async getStyleData(style) {
+        // TODO: Implement actual Figma API call
+        // For now, return the style object itself
+        return style;
+    }
+    /**
+     * Find variable reference in style data
+     */
+    findVariableReference(styleData) {
+        // Check for boundVariables (new variables API)
+        if (styleData.boundVariables) {
+            // Check common properties that can be bound to variables
+            const props = ["fills", "strokes", "effects", "text"];
+            for (const prop of props) {
+                if (styleData.boundVariables[prop]) {
+                    const binding = styleData.boundVariables[prop];
+                    if (Array.isArray(binding) && binding.length > 0) {
+                        return { id: binding[0].id };
+                    }
+                    if (binding.id) {
+                        return { id: binding.id };
+                    }
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Extract direct value from style (no variable)
+     */
+    extractDirectValue(styleData, styleType) {
+        switch (styleType) {
+            case "FILL":
+                if (styleData.fills && styleData.fills.length > 0) {
+                    const fill = styleData.fills[0];
+                    if (fill.type === "SOLID") {
+                        return this.formatColor(fill.color);
+                    }
+                }
+                return null;
+            case "TEXT":
+                if (styleData.fontFamily) {
+                    return {
+                        fontFamily: styleData.fontFamily,
+                        fontSize: styleData.fontSize,
+                        fontWeight: styleData.fontWeight,
+                        lineHeight: styleData.lineHeight,
+                    };
+                }
+                return null;
+            case "EFFECT":
+                if (styleData.effects && styleData.effects.length > 0) {
+                    return styleData.effects;
+                }
+                return null;
+            default:
+                return null;
+        }
+    }
+    /**
+     * Clear the cache
+     */
+    clearCache() {
+        this.cache.clear();
+        this.variableCache.clear();
+    }
+}
+//# sourceMappingURL=style-resolver.js.map

package/dist/core/enrichment/style-resolver.js.map

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

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

@@ -0,0 +1,201 @@
+/**
+ * Figma REST API Client
+ * Handles HTTP calls to Figma's REST API for file data, variables, components, and styles
+ */
+/**
+ * Figma API Client Configuration
+ */
+export interface FigmaAPIConfig {
+    accessToken: string;
+}
+/**
+ * Extract file key from Figma URL
+ * @example https://www.figma.com/design/abc123/My-File -> abc123
+ */
+export declare function extractFileKey(url: string): string | null;
+/**
+ * Information extracted from a Figma URL
+ * Includes file key, optional branch ID, and optional node ID
+ */
+export interface FigmaUrlInfo {
+    fileKey: string;
+    branchId?: string;
+    nodeId?: string;
+}
+/**
+ * Extract comprehensive URL info including branch and node IDs
+ * Supports both URL formats:
+ * - Path-based: /design/{fileKey}/branch/{branchKey}/{fileName}
+ * - Query-based: /design/{fileKey}/{fileName}?branch-id={branchId}
+ *
+ * @example https://www.figma.com/design/abc123/branch/xyz789/My-File?node-id=1-2
+ *   -> { fileKey: 'abc123', branchId: 'xyz789', nodeId: '1:2' }
+ * @example https://www.figma.com/design/abc123/My-File?branch-id=xyz789&node-id=1-2
+ *   -> { fileKey: 'abc123', branchId: 'xyz789', nodeId: '1:2' }
+ */
+export declare function extractFigmaUrlInfo(url: string): FigmaUrlInfo | null;
+/**
+ * Wrap a promise with a timeout
+ * @param promise The promise to wrap
+ * @param ms Timeout in milliseconds
+ * @param label Label for error message
+ * @returns Promise that rejects if timeout exceeded
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, label: string): Promise<T>;
+/**
+ * Figma API Client
+ * Makes authenticated requests to Figma REST API
+ */
+export declare class FigmaAPI {
+    private accessToken;
+    constructor(config: FigmaAPIConfig);
+    /**
+     * Make authenticated request to Figma API
+     */
+    private request;
+    /**
+     * GET /v1/files/:file_key
+     * Get full file data including document tree, components, and styles
+     */
+    getFile(fileKey: string, options?: {
+        version?: string;
+        ids?: string[];
+        depth?: number;
+        geometry?: 'paths' | 'screen';
+        plugin_data?: string;
+        branch_data?: boolean;
+    }): Promise<any>;
+    /**
+     * Resolve a branch key from a branch ID
+     * If branchId is provided, fetches branch data and returns the branch's unique key
+     * Otherwise returns the main file key unchanged
+     * @param fileKey The main file key from the URL
+     * @param branchId Optional branch ID from URL query param (branch-id)
+     * @returns The effective file key to use for API calls (branch key if on branch, otherwise fileKey)
+     */
+    getBranchKey(fileKey: string, branchId?: string): Promise<string>;
+    /**
+     * GET /v1/files/:file_key/variables/local
+     * Get local variables (design tokens) from a file
+     */
+    getLocalVariables(fileKey: string): Promise<any>;
+    /**
+     * GET /v1/files/:file_key/variables/published
+     * Get published variables from a file
+     */
+    getPublishedVariables(fileKey: string): Promise<any>;
+    /**
+     * GET /v1/files/:file_key/nodes
+     * Get specific nodes by ID
+     */
+    getNodes(fileKey: string, nodeIds: string[], options?: {
+        version?: string;
+        depth?: number;
+        geometry?: 'paths' | 'screen';
+        plugin_data?: string;
+    }): Promise<any>;
+    /**
+     * GET /v1/files/:file_key/styles
+     * Get styles from a file
+     */
+    getStyles(fileKey: string): Promise<any>;
+    /**
+     * GET /v1/files/:file_key/components
+     * Get components from a file
+     */
+    getComponents(fileKey: string): Promise<any>;
+    /**
+     * GET /v1/files/:file_key/component_sets
+     * Get component sets (variants) from a file
+     */
+    getComponentSets(fileKey: string): Promise<any>;
+    /**
+     * GET /v1/images/:file_key
+     * Renders images for specified nodes
+     * @param fileKey - The file key
+     * @param nodeIds - Node IDs to render (single string or array)
+     * @param options - Rendering options
+     * @returns Map of node IDs to image URLs (URLs expire after 30 days)
+     */
+    getImages(fileKey: string, nodeIds: string | string[], options?: {
+        scale?: number;
+        format?: 'png' | 'jpg' | 'svg' | 'pdf';
+        svg_outline_text?: boolean;
+        svg_include_id?: boolean;
+        svg_include_node_id?: boolean;
+        svg_simplify_stroke?: boolean;
+        contents_only?: boolean;
+    }): Promise<{
+        images: Record<string, string | null>;
+    }>;
+    /**
+     * GET /v1/files/:file_key/comments
+     * Get comments on a file
+     */
+    getComments(fileKey: string, options?: {
+        as_md?: boolean;
+    }): Promise<any>;
+    /**
+     * POST /v1/files/:file_key/comments
+     * Post a comment on a file
+     */
+    postComment(fileKey: string, message: string, clientMeta?: {
+        node_id?: string;
+        node_offset?: {
+            x: number;
+            y: number;
+        };
+    }, commentId?: string): Promise<any>;
+    /**
+     * DELETE /v1/files/:file_key/comments/:comment_id
+     * Delete a comment on a file
+     */
+    deleteComment(fileKey: string, commentId: string): Promise<any>;
+    /**
+     * Helper: Get all design tokens (variables) with formatted output
+     * Both local and published can fail gracefully (e.g., 403 without Enterprise plan)
+     */
+    getAllVariables(fileKey: string): Promise<{
+        local: any;
+        published: any;
+        localError?: string;
+        publishedError?: string;
+    }>;
+    /**
+     * Helper: Get component metadata with properties
+     */
+    getComponentData(fileKey: string, nodeId: string): Promise<any>;
+    /**
+     * Helper: Search for components by name
+     */
+    searchComponents(fileKey: string, searchTerm: string): Promise<any[]>;
+}
+/**
+ * Helper function to format variables for display
+ */
+export declare function formatVariables(variablesData: any): {
+    collections: any[];
+    variables: any[];
+    summary: {
+        totalCollections: number;
+        totalVariables: number;
+        variablesByType: Record<string, number>;
+    };
+};
+/**
+ * Helper function to format component data for display
+ */
+export declare function formatComponentData(componentNode: any): {
+    id: string;
+    name: string;
+    type: string;
+    description?: string;
+    descriptionMarkdown?: string;
+    properties?: any;
+    children?: any[];
+    bounds?: any;
+    fills?: any[];
+    strokes?: any[];
+    effects?: any[];
+};
+//# sourceMappingURL=figma-api.d.ts.map

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

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