@muloka/figma-console-mcp 0.1.0

package/dist/core/enrichment/relationship-mapper.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Relationship Mapper
+ * Maps relationships between styles, variables, and components
+ * Tracks usage counts and builds reverse lookup indexes
+ */
+import type { ComponentUsage, StyleUsage, VariableDependency } from "../types/enriched.js";
+import type pino from "pino";
+type Logger = pino.Logger;
+export declare class RelationshipMapper {
+    private logger;
+    private componentsByStyle;
+    private componentsByVariable;
+    private stylesByVariable;
+    private variableDependencies;
+    private styleUsageCount;
+    private variableUsageCount;
+    constructor(logger: Logger);
+    /**
+     * Build all relationship indexes from file data
+     */
+    buildRelationships(fileData: any): Promise<void>;
+    /**
+     * Get components that use a specific style
+     */
+    getComponentsByStyle(styleId: string): ComponentUsage[];
+    /**
+     * Get components that use a specific variable
+     */
+    getComponentsByVariable(variableId: string): ComponentUsage[];
+    /**
+     * Get styles that use a specific variable
+     */
+    getStylesByVariable(variableId: string): StyleUsage[];
+    /**
+     * Get variable dependencies (what variables this variable references)
+     */
+    getVariableDependencies(variableId: string): VariableDependency[];
+    /**
+     * Get usage count for a style
+     */
+    getStyleUsageCount(styleId: string): number;
+    /**
+     * Get usage count for a variable
+     */
+    getVariableUsageCount(variableId: string): number;
+    /**
+     * Find unused styles (styles with zero usage)
+     */
+    getUnusedStyles(allStyles: any[]): StyleUsage[];
+    /**
+     * Find unused variables (variables with zero usage)
+     */
+    getUnusedVariables(allVariables: any[]): any[];
+    /**
+     * Build variable dependency graph (which variables reference which)
+     */
+    private buildVariableDependencies;
+    /**
+     * Extract dependencies from a single variable
+     */
+    private extractVariableDependencies;
+    /**
+     * Build relationships between styles and variables
+     */
+    private buildStyleVariableRelationships;
+    /**
+     * Extract variable references from a style
+     */
+    private extractStyleVariableReferences;
+    /**
+     * Build component relationships by traversing the document tree
+     */
+    private buildComponentRelationships;
+    /**
+     * Recursively traverse nodes to find component instances and their style/variable usage
+     */
+    private traverseNode;
+    /**
+     * Track which styles a node uses
+     */
+    private trackNodeStyleUsage;
+    /**
+     * Track which variables a node uses
+     */
+    private trackNodeVariableUsage;
+    /**
+     * Extract all variable references from a node's boundVariables
+     */
+    private extractNodeVariableReferences;
+    /**
+     * Detect circular variable references
+     */
+    detectCircularReferences(): Array<{
+        chain: string[];
+    }>;
+    /**
+     * DFS helper for detecting circular references
+     */
+    private detectCircularDFS;
+    /**
+     * Clear all indexes and caches
+     */
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=relationship-mapper.d.ts.map

package/dist/core/enrichment/relationship-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-mapper.d.ts","sourceRoot":"","sources":["../../../src/core/enrichment/relationship-mapper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;AAE1B,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,MAAM,CAAS;IAGvB,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,oBAAoB,CAA4C;IACxE,OAAO,CAAC,gBAAgB,CAAwC;IAChE,OAAO,CAAC,oBAAoB,CAAgD;IAG5E,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,kBAAkB,CAAkC;gBAEhD,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCtD;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE;IAIvD;;OAEG;IACH,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE;IAI7D;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE;IAIrD;;OAEG;IACH,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAIjE;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIjD;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,UAAU,EAAE;IAoB/C;;OAEG;IACH,kBAAkB,CAAC,YAAY,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE;IAkB9C;;OAEG;YACW,yBAAyB;IAWvC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAqCnC;;OAEG;YACW,+BAA+B;IA2B7C;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAuBtC;;OAEG;YACW,2BAA2B;IASzC;;OAEG;YACW,YAAY;IAyB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+B3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAmBrC;;OAEG;IACH,wBAAwB,IAAI,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAYtD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,KAAK,IAAI,IAAI;CAQb"}

package/dist/core/enrichment/relationship-mapper.js

@@ -0,0 +1,352 @@
+/**
+ * Relationship Mapper
+ * Maps relationships between styles, variables, and components
+ * Tracks usage counts and builds reverse lookup indexes
+ */
+export class RelationshipMapper {
+    constructor(logger) {
+        // Relationship indexes
+        this.componentsByStyle = new Map();
+        this.componentsByVariable = new Map();
+        this.stylesByVariable = new Map();
+        this.variableDependencies = new Map();
+        // Usage counters
+        this.styleUsageCount = new Map();
+        this.variableUsageCount = new Map();
+        this.logger = logger;
+    }
+    /**
+     * Build all relationship indexes from file data
+     */
+    async buildRelationships(fileData) {
+        this.logger.info("Building relationship indexes");
+        try {
+            // Clear existing indexes
+            this.clear();
+            // Build variable dependencies first
+            if (fileData.variables) {
+                await this.buildVariableDependencies(fileData.variables);
+            }
+            // Build style-variable relationships
+            if (fileData.styles && fileData.variables) {
+                await this.buildStyleVariableRelationships(fileData.styles, fileData.variables);
+            }
+            // Build component relationships
+            if (fileData.document) {
+                await this.buildComponentRelationships(fileData.document);
+            }
+            this.logger.info({
+                styles: this.componentsByStyle.size,
+                variables: this.componentsByVariable.size,
+            }, "Relationship indexes built successfully");
+        }
+        catch (error) {
+            this.logger.error({ error }, "Error building relationships");
+            throw error;
+        }
+    }
+    /**
+     * Get components that use a specific style
+     */
+    getComponentsByStyle(styleId) {
+        return this.componentsByStyle.get(styleId) || [];
+    }
+    /**
+     * Get components that use a specific variable
+     */
+    getComponentsByVariable(variableId) {
+        return this.componentsByVariable.get(variableId) || [];
+    }
+    /**
+     * Get styles that use a specific variable
+     */
+    getStylesByVariable(variableId) {
+        return this.stylesByVariable.get(variableId) || [];
+    }
+    /**
+     * Get variable dependencies (what variables this variable references)
+     */
+    getVariableDependencies(variableId) {
+        return this.variableDependencies.get(variableId) || [];
+    }
+    /**
+     * Get usage count for a style
+     */
+    getStyleUsageCount(styleId) {
+        return this.styleUsageCount.get(styleId) || 0;
+    }
+    /**
+     * Get usage count for a variable
+     */
+    getVariableUsageCount(variableId) {
+        return this.variableUsageCount.get(variableId) || 0;
+    }
+    /**
+     * Find unused styles (styles with zero usage)
+     */
+    getUnusedStyles(allStyles) {
+        const unused = [];
+        for (const style of allStyles) {
+            const usageCount = this.getStyleUsageCount(style.node_id || style.key || style.id);
+            if (usageCount === 0) {
+                unused.push({
+                    id: style.id || style.key,
+                    name: style.name,
+                    type: style.style_type || style.styleType,
+                    node_id: style.node_id || style.key,
+                });
+            }
+        }
+        return unused;
+    }
+    /**
+     * Find unused variables (variables with zero usage)
+     */
+    getUnusedVariables(allVariables) {
+        const unused = [];
+        for (const variable of allVariables) {
+            const usageCount = this.getVariableUsageCount(variable.id);
+            if (usageCount === 0) {
+                unused.push({
+                    id: variable.id,
+                    name: variable.name,
+                    collection: variable.variableCollectionId,
+                    resolvedType: variable.resolvedType,
+                });
+            }
+        }
+        return unused;
+    }
+    /**
+     * Build variable dependency graph (which variables reference which)
+     */
+    async buildVariableDependencies(variables) {
+        for (const [variableId, variable] of variables.entries()) {
+            const dependencies = this.extractVariableDependencies(variable, variables);
+            if (dependencies.length > 0) {
+                this.variableDependencies.set(variableId, dependencies);
+            }
+        }
+    }
+    /**
+     * Extract dependencies from a single variable
+     */
+    extractVariableDependencies(variable, allVariables, depth = 0) {
+        const dependencies = [];
+        // Check all modes for variable aliases
+        for (const [modeId, value] of Object.entries(variable.valuesByMode || {})) {
+            if (typeof value === "object" &&
+                value !== null &&
+                value.type === "VARIABLE_ALIAS") {
+                const targetId = value.id;
+                const targetVariable = allVariables.get(targetId);
+                if (targetVariable) {
+                    dependencies.push({
+                        id: targetId,
+                        name: targetVariable.name,
+                        type: "alias",
+                        depth,
+                    });
+                    // Increment usage count for the referenced variable
+                    const currentCount = this.variableUsageCount.get(targetId) || 0;
+                    this.variableUsageCount.set(targetId, currentCount + 1);
+                }
+            }
+        }
+        return dependencies;
+    }
+    /**
+     * Build relationships between styles and variables
+     */
+    async buildStyleVariableRelationships(styles, variables) {
+        for (const style of styles) {
+            const variableRefs = this.extractStyleVariableReferences(style);
+            for (const varRef of variableRefs) {
+                // Track which styles use this variable
+                if (!this.stylesByVariable.has(varRef)) {
+                    this.stylesByVariable.set(varRef, []);
+                }
+                this.stylesByVariable.get(varRef)?.push({
+                    id: style.id || style.key,
+                    name: style.name,
+                    type: style.style_type || style.styleType,
+                    node_id: style.node_id || style.key,
+                });
+                // Increment variable usage count
+                const currentCount = this.variableUsageCount.get(varRef) || 0;
+                this.variableUsageCount.set(varRef, currentCount + 1);
+            }
+        }
+    }
+    /**
+     * Extract variable references from a style
+     */
+    extractStyleVariableReferences(style) {
+        const refs = [];
+        // Check boundVariables
+        if (style.boundVariables) {
+            const props = ["fills", "strokes", "effects", "text"];
+            for (const prop of props) {
+                if (style.boundVariables[prop]) {
+                    const binding = style.boundVariables[prop];
+                    if (Array.isArray(binding)) {
+                        for (const b of binding) {
+                            if (b.id)
+                                refs.push(b.id);
+                        }
+                    }
+                    else if (binding.id) {
+                        refs.push(binding.id);
+                    }
+                }
+            }
+        }
+        return refs;
+    }
+    /**
+     * Build component relationships by traversing the document tree
+     */
+    async buildComponentRelationships(document) {
+        // Traverse all pages
+        if (document.children) {
+            for (const page of document.children) {
+                await this.traverseNode(page, page.name);
+            }
+        }
+    }
+    /**
+     * Recursively traverse nodes to find component instances and their style/variable usage
+     */
+    async traverseNode(node, pageName, path = []) {
+        const currentPath = [...path, node.name];
+        // Check if this node uses any styles
+        if (node.styles) {
+            this.trackNodeStyleUsage(node, pageName, currentPath);
+        }
+        // Check if this node uses any variables (via boundVariables)
+        if (node.boundVariables) {
+            this.trackNodeVariableUsage(node, pageName, currentPath);
+        }
+        // Recurse into children
+        if (node.children) {
+            for (const child of node.children) {
+                await this.traverseNode(child, pageName, currentPath);
+            }
+        }
+    }
+    /**
+     * Track which styles a node uses
+     */
+    trackNodeStyleUsage(node, pageName, path) {
+        const componentUsage = {
+            id: node.id,
+            name: node.name,
+            type: node.type,
+            page: pageName,
+        };
+        // Check all style properties (fill, stroke, text, effect, grid)
+        const styleProps = ["fill", "stroke", "text", "effect", "grid"];
+        for (const prop of styleProps) {
+            const styleId = node.styles?.[prop];
+            if (styleId) {
+                // Add to componentsByStyle index
+                if (!this.componentsByStyle.has(styleId)) {
+                    this.componentsByStyle.set(styleId, []);
+                }
+                this.componentsByStyle.get(styleId)?.push(componentUsage);
+                // Increment style usage count
+                const currentCount = this.styleUsageCount.get(styleId) || 0;
+                this.styleUsageCount.set(styleId, currentCount + 1);
+            }
+        }
+    }
+    /**
+     * Track which variables a node uses
+     */
+    trackNodeVariableUsage(node, pageName, path) {
+        const componentUsage = {
+            id: node.id,
+            name: node.name,
+            type: node.type,
+            page: pageName,
+        };
+        // Extract all variable IDs from boundVariables
+        const variableIds = this.extractNodeVariableReferences(node);
+        for (const varId of variableIds) {
+            // Add to componentsByVariable index
+            if (!this.componentsByVariable.has(varId)) {
+                this.componentsByVariable.set(varId, []);
+            }
+            this.componentsByVariable.get(varId)?.push(componentUsage);
+            // Increment variable usage count
+            const currentCount = this.variableUsageCount.get(varId) || 0;
+            this.variableUsageCount.set(varId, currentCount + 1);
+        }
+    }
+    /**
+     * Extract all variable references from a node's boundVariables
+     */
+    extractNodeVariableReferences(node) {
+        const refs = [];
+        if (!node.boundVariables)
+            return refs;
+        // boundVariables can have many properties (fills, strokes, etc.)
+        for (const [prop, binding] of Object.entries(node.boundVariables)) {
+            if (Array.isArray(binding)) {
+                for (const b of binding) {
+                    if (b.id)
+                        refs.push(b.id);
+                }
+            }
+            else if (binding && typeof binding === "object" && binding.id) {
+                refs.push(binding.id);
+            }
+        }
+        return refs;
+    }
+    /**
+     * Detect circular variable references
+     */
+    detectCircularReferences() {
+        const circular = [];
+        const visited = new Set();
+        const currentPath = [];
+        for (const [variableId] of this.variableDependencies) {
+            this.detectCircularDFS(variableId, visited, currentPath, circular);
+        }
+        return circular;
+    }
+    /**
+     * DFS helper for detecting circular references
+     */
+    detectCircularDFS(variableId, visited, currentPath, circular) {
+        if (currentPath.includes(variableId)) {
+            // Found a cycle
+            const cycleStart = currentPath.indexOf(variableId);
+            const cycle = currentPath.slice(cycleStart).concat(variableId);
+            circular.push({ chain: cycle });
+            return;
+        }
+        if (visited.has(variableId))
+            return;
+        visited.add(variableId);
+        currentPath.push(variableId);
+        const dependencies = this.variableDependencies.get(variableId) || [];
+        for (const dep of dependencies) {
+            this.detectCircularDFS(dep.id, visited, currentPath, circular);
+        }
+        currentPath.pop();
+    }
+    /**
+     * Clear all indexes and caches
+     */
+    clear() {
+        this.componentsByStyle.clear();
+        this.componentsByVariable.clear();
+        this.stylesByVariable.clear();
+        this.variableDependencies.clear();
+        this.styleUsageCount.clear();
+        this.variableUsageCount.clear();
+    }
+}
+//# sourceMappingURL=relationship-mapper.js.map

package/dist/core/enrichment/relationship-mapper.js.map

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

package/dist/core/enrichment/style-resolver.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Style Value Resolver
+ * Resolves style values from variable references and provides formatted outputs
+ */
+import type { VariableReference, ExportFormats, ExportFormat } from "../types/enriched.js";
+import type pino from "pino";
+type Logger = pino.Logger;
+export declare class StyleValueResolver {
+    private cache;
+    private variableCache;
+    private logger;
+    constructor(logger: Logger);
+    /**
+     * Resolve a style's value, handling variable references
+     */
+    resolveStyleValue(style: any, variables: Map<string, any>, maxDepth?: number): Promise<{
+        value: any;
+        variableRef?: VariableReference;
+    }>;
+    /**
+     * Resolve a variable's value, handling alias chains.
+     *
+     * `modeId` selects which mode's value to resolve; omitted, it falls back
+     * to the variable's first mode (legacy behavior for callers that don't
+     * care about modes). The cache is keyed per (variable, mode) so
+     * multi-mode variables don't all resolve to the first mode's value.
+     */
+    resolveVariableValue(variable: any, allVariables: Map<string, any>, maxDepth?: number, currentDepth?: number, modeId?: string): Promise<any>;
+    /**
+     * Format a variable value based on its type
+     */
+    private formatVariableValue;
+    /**
+     * Format a color value to hex string
+     */
+    private formatColor;
+    /**
+     * Generate export formats for a resolved value
+     */
+    generateExportFormats(name: string, value: any, type: string, formats?: ExportFormat[]): ExportFormats;
+    /**
+     * Convert token name to CSS variable format
+     * Example: "color/background/primary-default" -> "--color-background-primary-default"
+     */
+    private toCSSVariableName;
+    /**
+     * Convert token name to Sass variable format
+     * Example: "color/background/primary-default" -> "$color-background-primary-default"
+     */
+    private toSassVariableName;
+    /**
+     * Convert token name to Tailwind class format
+     * Example: "color/background/primary-default" -> "bg-primary"
+     */
+    private toTailwindClassName;
+    /**
+     * Convert token name to TypeScript path format
+     * Example: "color/background/primary-default" -> "tokens.color.background.primaryDefault"
+     */
+    private toTypeScriptPath;
+    /**
+     * Convert token name to nested JSON path
+     * Example: "color/background/primary-default" -> { color: { background: { primaryDefault: value } } }
+     */
+    private toJSONPath;
+    /**
+     * Get style data from Figma API
+     * This would be called via the Figma API client
+     */
+    private getStyleData;
+    /**
+     * Find variable reference in style data
+     */
+    private findVariableReference;
+    /**
+     * Extract direct value from style (no variable)
+     */
+    private extractDirectValue;
+    /**
+     * Clear the cache
+     */
+    clearCache(): void;
+}
+export {};
+//# sourceMappingURL=style-resolver.d.ts.map

package/dist/core/enrichment/style-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-resolver.d.ts","sourceRoot":"","sources":["../../../src/core/enrichment/style-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAEX,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;AAE1B,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACG,iBAAiB,CACtB,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,QAAQ,SAAK,GACX,OAAO,CAAC;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,WAAW,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAwD3D;;;;;;;OAOG;IACG,oBAAoB,CACzB,QAAQ,EAAE,GAAG,EACb,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,QAAQ,SAAK,EACb,YAAY,SAAI,EAChB,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,GAAG,CAAC;IAoEf;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAwBnB;;OAEG;IACH,qBAAqB,CACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,GAAG,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAY,EAAsD,GACzE,aAAa;IAiChB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;OAGG;IACH,OAAO,CAAC,UAAU;IA0BlB;;;OAGG;YACW,YAAY;IAM1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiC1B;;OAEG;IACH,UAAU,IAAI,IAAI;CAIlB"}