figma-console-mcp 0.1.0

package/dist/core/enrichment/enrichment-service.js

@@ -0,0 +1,273 @@
+/**
+ * Enrichment Service
+ * Coordinates enrichment of Figma API responses
+ */
+import { StyleValueResolver } from "./style-resolver.js";
+import { RelationshipMapper } from "./relationship-mapper.js";
+export class EnrichmentService {
+    constructor(logger) {
+        // Caches
+        this.fileDataCache = new Map();
+        this.lastEnrichmentTime = new Map();
+        this.CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+        this.logger = logger;
+        this.styleResolver = new StyleValueResolver(logger);
+        this.relationshipMapper = new RelationshipMapper(logger);
+    }
+    /**
+     * Enrich styles response
+     */
+    async enrichStyles(styles, fileKey, options = {}, fileData) {
+        if (!options.enrich) {
+            return styles; // Return as-is if enrichment not requested
+        }
+        this.logger.info({ fileKey, count: styles.length }, "Enriching styles");
+        try {
+            // Get file data for relationships (use provided data if available)
+            const data = fileData || await this.getFileDataForEnrichment(fileKey);
+            const variables = this.extractVariablesMap(data);
+            // Build relationships if requested
+            if (options.include_usage) {
+                await this.relationshipMapper.buildRelationships(data);
+            }
+            const enrichedStyles = [];
+            for (const style of styles) {
+                const enriched = {
+                    ...style,
+                };
+                // Resolve value and variable reference
+                if (options.include_exports !== false) {
+                    const { value, variableRef } = await this.styleResolver.resolveStyleValue(style, variables, options.max_depth);
+                    enriched.resolved_value = value;
+                    enriched.variable_reference = variableRef;
+                    // Generate export formats
+                    if (value && options.export_formats) {
+                        enriched.export_formats = this.styleResolver.generateExportFormats(style.name, value, style.style_type, options.export_formats);
+                    }
+                }
+                // Add usage information
+                if (options.include_usage) {
+                    const styleId = style.node_id || style.key || style.id;
+                    enriched.used_in_components =
+                        this.relationshipMapper.getComponentsByStyle(styleId);
+                    enriched.usage_count =
+                        this.relationshipMapper.getStyleUsageCount(styleId);
+                }
+                enrichedStyles.push(enriched);
+            }
+            this.logger.info({ enrichedCount: enrichedStyles.length }, "Styles enrichment complete");
+            return enrichedStyles;
+        }
+        catch (error) {
+            this.logger.error({ error }, "Failed to enrich styles");
+            return styles; // Return original on error
+        }
+    }
+    /**
+     * Enrich variables response
+     */
+    async enrichVariables(variables, fileKey, options = {}, fileData) {
+        if (!options.enrich) {
+            return variables;
+        }
+        this.logger.info({ fileKey, count: variables.length }, "Enriching variables");
+        try {
+            const data = fileData || await this.getFileDataForEnrichment(fileKey);
+            const variablesMap = this.extractVariablesMap(data);
+            // Build relationships if requested
+            if (options.include_usage) {
+                await this.relationshipMapper.buildRelationships(data);
+            }
+            const enrichedVars = [];
+            for (const variable of variables) {
+                const enriched = {
+                    ...variable,
+                };
+                // Resolve values for all modes
+                if (options.include_exports !== false) {
+                    const resolved_values = {};
+                    for (const [modeId, value] of Object.entries(variable.valuesByMode || {})) {
+                        const resolvedValue = await this.styleResolver.resolveVariableValue(variable, variablesMap, options.max_depth);
+                        resolved_values[modeId] = resolvedValue;
+                    }
+                    enriched.resolved_values = resolved_values;
+                    // Generate export formats using first mode
+                    const firstModeValue = Object.values(resolved_values)[0];
+                    if (firstModeValue && options.export_formats) {
+                        enriched.export_formats = this.styleResolver.generateExportFormats(variable.name, firstModeValue, variable.resolvedType, options.export_formats);
+                    }
+                }
+                // Add usage information
+                if (options.include_usage) {
+                    enriched.used_in_styles =
+                        this.relationshipMapper.getStylesByVariable(variable.id);
+                    enriched.used_in_components =
+                        this.relationshipMapper.getComponentsByVariable(variable.id);
+                    enriched.usage_count =
+                        this.relationshipMapper.getVariableUsageCount(variable.id);
+                }
+                // Add dependencies
+                if (options.include_dependencies) {
+                    enriched.dependencies =
+                        this.relationshipMapper.getVariableDependencies(variable.id);
+                }
+                enrichedVars.push(enriched);
+            }
+            this.logger.info({ enrichedCount: enrichedVars.length }, "Variables enrichment complete");
+            return enrichedVars;
+        }
+        catch (error) {
+            this.logger.error({ error }, "Failed to enrich variables");
+            return variables;
+        }
+    }
+    /**
+     * Enrich component response
+     */
+    async enrichComponent(component, fileKey, options = {}, fileData) {
+        if (!options.enrich) {
+            return component;
+        }
+        this.logger.info({ fileKey, componentId: component.id }, "Enriching component");
+        try {
+            const enriched = {
+                ...component,
+            };
+            const data = fileData || await this.getFileDataForEnrichment(fileKey);
+            // Build relationships
+            await this.relationshipMapper.buildRelationships(data);
+            // Extract styles used
+            if (component.styles) {
+                const stylesUsed = [];
+                for (const [prop, styleId] of Object.entries(component.styles)) {
+                    const style = data.styles?.[styleId];
+                    if (style) {
+                        stylesUsed.push({
+                            style_id: styleId,
+                            style_name: style.name,
+                            style_type: style.style_type,
+                            property: prop,
+                        });
+                    }
+                }
+                enriched.styles_used = stylesUsed;
+            }
+            // Extract variables used
+            if (component.boundVariables) {
+                const varsUsed = [];
+                // This would need actual variable resolution
+                enriched.variables_used = varsUsed;
+            }
+            // Detect hardcoded values (simplified for now)
+            // TODO: Implement full hardcoded value detection
+            enriched.hardcoded_values = [];
+            // Calculate token coverage
+            const totalProps = (enriched.styles_used?.length || 0) + (enriched.variables_used?.length || 0) + (enriched.hardcoded_values?.length || 0);
+            const tokenProps = (enriched.styles_used?.length || 0) + (enriched.variables_used?.length || 0);
+            enriched.token_coverage =
+                totalProps > 0 ? Math.round((tokenProps / totalProps) * 100) : 0;
+            this.logger.info({ componentId: component.id, coverage: enriched.token_coverage }, "Component enrichment complete");
+            return enriched;
+        }
+        catch (error) {
+            this.logger.error({ error }, "Failed to enrich component");
+            return component;
+        }
+    }
+    /**
+     * Enrich file data response
+     */
+    async enrichFileData(fileData, options = {}) {
+        if (!options.enrich) {
+            return fileData;
+        }
+        this.logger.info({ fileKey: fileData.fileKey }, "Enriching file data");
+        try {
+            const enriched = {
+                ...fileData,
+            };
+            // Build relationships for statistics
+            await this.relationshipMapper.buildRelationships(fileData);
+            // Calculate statistics
+            const styles = Object.values(fileData.styles || {});
+            const variables = Array.from(this.extractVariablesMap(fileData).values());
+            const unusedStyles = this.relationshipMapper.getUnusedStyles(styles);
+            const unusedVars = this.relationshipMapper.getUnusedVariables(variables);
+            enriched.statistics = {
+                total_variables: variables.length,
+                total_styles: styles.length,
+                total_components: Object.keys(fileData.components || {}).length,
+                unused_variables: unusedVars.length,
+                unused_styles: unusedStyles.length,
+                average_token_coverage: 0, // TODO: Calculate from components
+                total_hardcoded_values: 0, // TODO: Calculate from components
+                audit_issues_count: 0, // TODO: Calculate from audit
+            };
+            // Calculate health score (simple formula)
+            const usageRate = variables.length > 0
+                ? ((variables.length - unusedVars.length) / variables.length) * 100
+                : 100;
+            enriched.health_score = Math.round(usageRate);
+            this.logger.info({ health_score: enriched.health_score }, "File data enrichment complete");
+            return enriched;
+        }
+        catch (error) {
+            this.logger.error({ error }, "Failed to enrich file data");
+            return fileData;
+        }
+    }
+    /**
+     * Get file data for enrichment (with caching)
+     * NOTE: This is a placeholder that returns the data passed in
+     * In a full implementation, this would fetch fresh data from Figma API
+     */
+    async getFileDataForEnrichment(fileKey, providedData) {
+        const now = Date.now();
+        const lastEnrich = this.lastEnrichmentTime.get(fileKey) || 0;
+        // Return cached if fresh
+        if (this.fileDataCache.has(fileKey) &&
+            now - lastEnrich < this.CACHE_TTL_MS) {
+            return this.fileDataCache.get(fileKey);
+        }
+        // If data is provided, use it (from the tool that called us)
+        // This avoids redundant API calls since the tool already fetched the data
+        const fileData = providedData || {
+            styles: {},
+            variables: {},
+            document: {},
+            components: {},
+        };
+        this.fileDataCache.set(fileKey, fileData);
+        this.lastEnrichmentTime.set(fileKey, now);
+        return fileData;
+    }
+    /**
+     * Set file data in cache (called by tools that already have the data)
+     */
+    setFileDataCache(fileKey, fileData) {
+        this.fileDataCache.set(fileKey, fileData);
+        this.lastEnrichmentTime.set(fileKey, Date.now());
+    }
+    /**
+     * Extract variables as a Map for efficient lookup
+     */
+    extractVariablesMap(fileData) {
+        const variablesMap = new Map();
+        if (fileData.variables) {
+            for (const [id, variable] of Object.entries(fileData.variables)) {
+                variablesMap.set(id, variable);
+            }
+        }
+        return variablesMap;
+    }
+    /**
+     * Clear all caches
+     */
+    clearCache() {
+        this.fileDataCache.clear();
+        this.lastEnrichmentTime.clear();
+        this.styleResolver.clearCache();
+        this.relationshipMapper.clear();
+    }
+}
+//# sourceMappingURL=enrichment-service.js.map

package/dist/core/enrichment/enrichment-service.js.map

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

package/dist/core/enrichment/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Enrichment module exports
+ * Phase 5: Enriched Data Extraction & Design System Auditing
+ */
+export { StyleValueResolver } from "./style-resolver.js";
+export { RelationshipMapper } from "./relationship-mapper.js";
+export { EnrichmentService } from "./enrichment-service.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/enrichment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/enrichment/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/core/enrichment/index.js

@@ -0,0 +1,8 @@
+/**
+ * Enrichment module exports
+ * Phase 5: Enriched Data Extraction & Design System Auditing
+ */
+export { StyleValueResolver } from "./style-resolver.js";
+export { RelationshipMapper } from "./relationship-mapper.js";
+export { EnrichmentService } from "./enrichment-service.js";
+//# sourceMappingURL=index.js.map

package/dist/core/enrichment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/enrichment/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

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"}