@mp3wizard/figma-console-mcp 1.14.0

package/dist/core/console-monitor.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Console Monitor
+ * Captures and manages console logs from Figma plugins
+ * Monitors both main page console AND Web Worker consoles (where Figma plugins run)
+ */
+import type { ConsoleLogEntry, ConsoleConfig } from './types/index.js';
+/**
+ * Console Monitor
+ * Listens to page console events and maintains a circular buffer of logs
+ * Also monitors Web Workers to capture Figma plugin console logs
+ */
+export declare class ConsoleMonitor {
+    private logs;
+    private config;
+    private isMonitoring;
+    private page;
+    private workers;
+    private lastUrl;
+    constructor(config: ConsoleConfig);
+    /**
+     * Start monitoring console logs on a page
+     * Accepts any puppeteer Page type (puppeteer-core or @cloudflare/puppeteer)
+     */
+    startMonitoring(page: any): Promise<void>;
+    /**
+     * Attach console listeners to a Web Worker
+     * This captures Figma plugin console logs
+     */
+    private attachWorkerListeners;
+    /**
+     * Process console message from Puppeteer
+     * @param msg - Console message from page or worker
+     * @param context - Where the message came from ('page' or 'worker')
+     * @param workerUrl - URL of the worker (if context is 'worker')
+     */
+    private processConsoleMessage;
+    /**
+     * Determine if log is from plugin or Figma based on URL
+     */
+    private determineSource;
+    /**
+     * Add log to circular buffer
+     */
+    private addLog;
+    /**
+     * Truncate string to max length
+     */
+    private truncateString;
+    /**
+     * Truncate value (string, array, object) intelligently
+     * Based on AgentDesk pattern to prevent context overflow
+     */
+    private truncateValue;
+    /**
+     * Get logs with optional filtering
+     */
+    getLogs(options?: {
+        count?: number;
+        level?: ConsoleLogEntry['level'] | 'all';
+        since?: number;
+    }): ConsoleLogEntry[];
+    /**
+     * Clear log buffer
+     */
+    clear(): number;
+    /**
+     * Stop monitoring
+     */
+    stopMonitoring(): void;
+    /**
+     * Get monitoring status
+     */
+    getStatus(): {
+        isMonitoring: boolean;
+        logCount: number;
+        bufferSize: number;
+        workerCount: number;
+        oldestTimestamp: number;
+        newestTimestamp: number;
+    };
+}
+//# sourceMappingURL=console-monitor.d.ts.map

package/dist/core/console-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-monitor.d.ts","sourceRoot":"","sources":["../../src/core/console-monitor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAQvE;;;;GAIG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAc;gBAEjB,MAAM,EAAE,aAAa;IAIjC;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA6L/C;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;;;;OAKG;YACW,qBAAqB;IAqEnC;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;OAEG;IACH,OAAO,CAAC,MAAM;IAWd;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAqDrB;;OAEG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;QACzC,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,eAAe,EAAE;IAqBrB;;OAEG;IACH,KAAK,IAAI,MAAM;IAOf;;OAEG;IACH,cAAc,IAAI,IAAI;IAYtB;;OAEG;IACH,SAAS;;;;;;;;CAUT"}

package/dist/core/console-monitor.js

@@ -0,0 +1,428 @@
+/**
+ * Console Monitor
+ * Captures and manages console logs from Figma plugins
+ * Monitors both main page console AND Web Worker consoles (where Figma plugins run)
+ */
+import { createChildLogger } from './logger.js';
+const logger = createChildLogger({ component: 'console-monitor' });
+/**
+ * Console Monitor
+ * Listens to page console events and maintains a circular buffer of logs
+ * Also monitors Web Workers to capture Figma plugin console logs
+ */
+export class ConsoleMonitor {
+    constructor(config) {
+        this.logs = [];
+        this.isMonitoring = false;
+        this.page = null; // Supports both puppeteer-core and @cloudflare/puppeteer
+        this.workers = new Set();
+        this.lastUrl = ''; // Track the last URL to detect real navigations vs hash changes
+        this.config = config;
+    }
+    /**
+     * Start monitoring console logs on a page
+     * Accepts any puppeteer Page type (puppeteer-core or @cloudflare/puppeteer)
+     */
+    async startMonitoring(page) {
+        if (this.isMonitoring && this.page === page) {
+            logger.info('Already monitoring this page');
+            return;
+        }
+        this.page = page;
+        this.isMonitoring = true;
+        logger.info('Starting console monitoring (page + workers + frames)');
+        // DIAGNOSTIC: Log all frames on the page and add to console
+        const frames = page.frames();
+        logger.info({ frameCount: frames.length }, 'Frames detected on page');
+        // Add diagnostic marker to console logs
+        this.addLog({
+            timestamp: Date.now(),
+            level: 'info',
+            message: `[MCP DIAGNOSTIC] Monitoring started. Detected ${frames.length} frames and ${page.workers().length} workers.`,
+            args: [],
+            source: 'page',
+        });
+        for (const frame of frames) {
+            const frameUrl = frame.url();
+            const frameName = frame.name() || 'unnamed';
+            logger.info({
+                frameUrl,
+                isDetached: frame.isDetached(),
+                name: frameName
+            }, 'Frame details');
+            // Add frame detection to console logs
+            this.addLog({
+                timestamp: Date.now(),
+                level: 'info',
+                message: `[MCP DIAGNOSTIC] Frame detected: ${frameName} - ${frameUrl}`,
+                args: [],
+                source: 'page',
+            });
+        }
+        // Listen to ALL console events (includes main page, iframes, and workers)
+        page.on('console', async (msg) => {
+            try {
+                const location = msg.location();
+                const url = location?.url || 'unknown';
+                const text = msg.text();
+                const type = msg.type();
+                // DIAGNOSTIC: Log every console event with its source
+                logger.info({
+                    type,
+                    url,
+                    textPreview: text.substring(0, 100),
+                    location
+                }, 'Console event captured');
+                const entry = await this.processConsoleMessage(msg, 'page', url);
+                if (entry) {
+                    this.addLog(entry);
+                }
+            }
+            catch (error) {
+                logger.error({ error }, 'Failed to process console message');
+            }
+        });
+        // Listen to page errors
+        page.on('pageerror', (error) => {
+            this.addLog({
+                timestamp: Date.now(),
+                level: 'error',
+                message: error.message,
+                args: [],
+                stackTrace: {
+                    callFrames: error.stack
+                        ? error.stack.split('\n').map((line) => ({
+                            functionName: line.trim(),
+                            url: '',
+                            lineNumber: 0,
+                            columnNumber: 0,
+                        }))
+                        : [],
+                },
+                source: 'page',
+            });
+        });
+        // Monitor existing workers (for Figma plugin console logs)
+        const existingWorkers = page.workers();
+        logger.info({ workerCount: existingWorkers.length }, 'Found existing workers');
+        for (const worker of existingWorkers) {
+            this.attachWorkerListeners(worker);
+        }
+        // Listen for new workers being created (e.g., when plugin starts)
+        page.on('workercreated', (worker) => {
+            logger.info({ workerUrl: worker.url() }, 'New worker created');
+            this.attachWorkerListeners(worker);
+        });
+        // Listen for workers being destroyed
+        page.on('workerdestroyed', (worker) => {
+            logger.info({ workerUrl: worker.url() }, 'Worker destroyed');
+            this.workers.delete(worker);
+        });
+        // Listen for new frames being attached (e.g., when plugin UI loads)
+        page.on('frameattached', (frame) => {
+            const frameUrl = frame.url();
+            const frameName = frame.name() || 'unnamed';
+            logger.info({ frameUrl, frameName }, 'New frame attached');
+            // Add diagnostic marker for new frame
+            this.addLog({
+                timestamp: Date.now(),
+                level: 'info',
+                message: `[MCP DIAGNOSTIC] New frame attached: ${frameName} - ${frameUrl}`,
+                args: [],
+                source: 'page',
+            });
+        });
+        // Listen for frames being detached
+        page.on('framedetached', (frame) => {
+            logger.info({ frameUrl: frame.url() }, 'Frame detached');
+        });
+        // Listen for main frame navigation - clear logs when navigating to a DIFFERENT page
+        // (not just hash changes or SPA navigations within the same Figma file)
+        page.on('framenavigated', (frame) => {
+            // Only handle main frame navigation (not iframe navigations)
+            if (frame === page.mainFrame()) {
+                const frameUrl = frame.url();
+                // Extract base URL without hash/query params to detect real navigation
+                const getBaseUrl = (url) => {
+                    try {
+                        const urlObj = new URL(url);
+                        // For Figma, consider the file ID part of the path
+                        // Example: https://figma.com/design/FILE_ID/...
+                        // Only clear if the file ID changes
+                        return urlObj.origin + urlObj.pathname.split('?')[0].split('#')[0];
+                    }
+                    catch {
+                        return url;
+                    }
+                };
+                const currentBaseUrl = getBaseUrl(frameUrl);
+                const previousBaseUrl = this.lastUrl ? getBaseUrl(this.lastUrl) : '';
+                // Only clear logs if we've actually navigated to a different file
+                // (not just hash changes like going from one component to another)
+                if (previousBaseUrl && currentBaseUrl !== previousBaseUrl) {
+                    logger.info({
+                        from: previousBaseUrl,
+                        to: currentBaseUrl
+                    }, 'Navigated to different file - clearing console logs');
+                    // Clear old logs to prevent stale data from previous file
+                    this.logs = [];
+                    // Add diagnostic marker for navigation
+                    this.addLog({
+                        timestamp: Date.now(),
+                        level: 'info',
+                        message: `[MCP DIAGNOSTIC] Navigated to new file: ${frameUrl}. Console logs cleared.`,
+                        args: [],
+                        source: 'page',
+                    });
+                }
+                // Update last URL for next comparison
+                this.lastUrl = frameUrl;
+            }
+        });
+        logger.info({
+            pageMonitoring: true,
+            workerMonitoring: true,
+            frameMonitoring: true,
+            initialWorkerCount: existingWorkers.length,
+            initialFrameCount: frames.length
+        }, 'Console monitoring started');
+    }
+    /**
+     * Attach console listeners to a Web Worker
+     * This captures Figma plugin console logs
+     */
+    attachWorkerListeners(worker) {
+        this.workers.add(worker);
+        const workerUrl = worker.url();
+        logger.info({ workerUrl }, 'Attaching console listener to worker');
+        // DIAGNOSTIC: Log a marker when worker listener is attached
+        this.addLog({
+            timestamp: Date.now(),
+            level: 'info',
+            message: `[MCP] Worker detected and monitored: ${workerUrl}`,
+            args: [],
+            source: 'plugin',
+            workerUrl,
+        });
+        // Listen to worker console events
+        worker.on('console', async (msg) => {
+            try {
+                logger.info({ workerUrl, type: msg.type(), text: msg.text() }, 'Worker console event received');
+                const entry = await this.processConsoleMessage(msg, 'worker', workerUrl);
+                if (entry) {
+                    this.addLog(entry);
+                }
+            }
+            catch (error) {
+                logger.error({ error, workerUrl }, 'Failed to process worker console message');
+            }
+        });
+        // Worker doesn't have pageerror, but console.error will be captured above
+    }
+    /**
+     * Process console message from Puppeteer
+     * @param msg - Console message from page or worker
+     * @param context - Where the message came from ('page' or 'worker')
+     * @param workerUrl - URL of the worker (if context is 'worker')
+     */
+    async processConsoleMessage(msg, context, workerUrl) {
+        const level = msg.type();
+        // Filter by configured levels
+        if (this.config.filterLevels.length > 0 &&
+            !this.config.filterLevels.includes(level)) {
+            return null;
+        }
+        try {
+            // Extract message text
+            const message = msg.text();
+            // Extract arguments (with truncation)
+            const args = await Promise.all(msg.args().map(async (arg) => {
+                try {
+                    const jsonValue = await arg.jsonValue();
+                    return this.truncateValue(jsonValue);
+                }
+                catch {
+                    return String(arg);
+                }
+            }));
+            // Determine source based on context
+            let source;
+            if (context === 'worker') {
+                // Workers are where Figma plugins run
+                source = 'plugin';
+            }
+            else {
+                // Page console - determine if plugin or figma
+                const location = msg.location();
+                source = this.determineSource(location?.url);
+            }
+            const entry = {
+                timestamp: Date.now(),
+                level,
+                message: this.truncateString(message),
+                args,
+                source,
+            };
+            // Add worker URL metadata for debugging
+            if (workerUrl && context === 'worker') {
+                entry.workerUrl = workerUrl;
+            }
+            // Add stack trace for errors
+            if (level === 'error' && msg.stackTrace) {
+                entry.stackTrace = {
+                    callFrames: msg.stackTrace().callFrames || [],
+                };
+            }
+            return entry;
+        }
+        catch (error) {
+            logger.error({ error, context, workerUrl }, 'Failed to extract console message details');
+            return null;
+        }
+    }
+    /**
+     * Determine if log is from plugin or Figma based on URL
+     */
+    determineSource(url) {
+        if (!url)
+            return 'unknown';
+        // Check for plugin-related URLs
+        // Plugins might run in:
+        // - iframes with plugin-specific URLs
+        // - blob: URLs created by the plugin
+        // - chrome-extension: URLs (for dev mode)
+        // - any URL containing "plugin"
+        if (url.includes('plugin') ||
+            url.includes('iframe') ||
+            url.startsWith('blob:') ||
+            url.startsWith('chrome-extension:') ||
+            url.includes('figma.com/plugin') ||
+            url.includes('/plugin-')) {
+            return 'plugin';
+        }
+        // Main Figma application
+        if (url.includes('figma.com')) {
+            return 'figma';
+        }
+        return 'unknown';
+    }
+    /**
+     * Add log to circular buffer
+     */
+    addLog(entry) {
+        this.logs.push(entry);
+        // Maintain buffer size
+        if (this.logs.length > this.config.bufferSize) {
+            this.logs.shift();
+        }
+        logger.debug({ level: entry.level, source: entry.source }, 'Log captured');
+    }
+    /**
+     * Truncate string to max length
+     */
+    truncateString(str) {
+        const maxLength = this.config.truncation.maxStringLength;
+        if (str.length <= maxLength) {
+            return str;
+        }
+        return str.substring(0, maxLength) + '... (truncated)';
+    }
+    /**
+     * Truncate value (string, array, object) intelligently
+     * Based on AgentDesk pattern to prevent context overflow
+     */
+    truncateValue(value, depth = 0) {
+        const { maxStringLength, maxArrayLength, maxObjectDepth } = this.config.truncation;
+        // Max depth reached
+        if (depth >= maxObjectDepth) {
+            return '[Max depth reached]';
+        }
+        // Handle null/undefined
+        if (value === null || value === undefined) {
+            return value;
+        }
+        // Handle strings
+        if (typeof value === 'string') {
+            return this.truncateString(value);
+        }
+        // Handle arrays
+        if (Array.isArray(value)) {
+            const truncated = value.slice(0, maxArrayLength).map((item) => this.truncateValue(item, depth + 1));
+            if (value.length > maxArrayLength) {
+                truncated.push(`... (${value.length - maxArrayLength} more items)`);
+            }
+            return truncated;
+        }
+        // Handle objects
+        if (typeof value === 'object') {
+            const result = {};
+            let count = 0;
+            for (const [key, val] of Object.entries(value)) {
+                if (count >= 10) {
+                    // Limit object properties
+                    result['...'] = '(more properties)';
+                    break;
+                }
+                result[key] = this.truncateValue(val, depth + 1);
+                count++;
+            }
+            return result;
+        }
+        // Primitives (number, boolean, etc.)
+        return value;
+    }
+    /**
+     * Get logs with optional filtering
+     */
+    getLogs(options) {
+        let filtered = [...this.logs];
+        // Filter by timestamp
+        if (options?.since) {
+            filtered = filtered.filter((log) => log.timestamp >= options.since);
+        }
+        // Filter by level
+        if (options?.level && options.level !== 'all') {
+            filtered = filtered.filter((log) => log.level === options.level);
+        }
+        // Limit count (get most recent)
+        if (options?.count) {
+            filtered = filtered.slice(-options.count);
+        }
+        return filtered;
+    }
+    /**
+     * Clear log buffer
+     */
+    clear() {
+        const count = this.logs.length;
+        this.logs = [];
+        logger.info({ clearedCount: count }, 'Console buffer cleared');
+        return count;
+    }
+    /**
+     * Stop monitoring
+     */
+    stopMonitoring() {
+        if (!this.isMonitoring) {
+            return;
+        }
+        this.isMonitoring = false;
+        this.page = null;
+        this.lastUrl = ''; // Clear last URL to prevent stale comparisons after restart
+        logger.info('Console monitoring stopped');
+    }
+    /**
+     * Get monitoring status
+     */
+    getStatus() {
+        return {
+            isMonitoring: this.isMonitoring,
+            logCount: this.logs.length,
+            bufferSize: this.config.bufferSize,
+            workerCount: this.workers.size,
+            oldestTimestamp: this.logs[0]?.timestamp,
+            newestTimestamp: this.logs[this.logs.length - 1]?.timestamp,
+        };
+    }
+}
+//# sourceMappingURL=console-monitor.js.map

package/dist/core/console-monitor.js.map

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

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

@@ -0,0 +1,127 @@
+/**
+ * Design-Code Parity Checker & Documentation Generator
+ * MCP tools for comparing Figma design specs with code-side data
+ * and generating platform-agnostic component documentation.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { FigmaAPI } from "./figma-api.js";
+import type { CompanyDocsContentEntry } from "./types/design-code.js";
+/** Convert Figma RGBA (0-1 floats) to hex string */
+export declare function figmaRGBAToHex(color: {
+    r: number;
+    g: number;
+    b: number;
+    a?: number;
+}): string;
+/** Normalize a color string for comparison (uppercase hex without alpha if fully opaque) */
+export declare function normalizeColor(color: string): string;
+/** Compare numeric values with a tolerance */
+export declare function numericClose(a: number, b: number, tolerance?: number): boolean;
+/** Calculate parity score from discrepancy counts */
+export declare function calculateParityScore(critical: number, major: number, minor: number, info: number): number;
+/** Split markdown by H2 headers for platforms that need chunking */
+export declare function chunkMarkdownByHeaders(markdown: string): Array<{
+    heading: string;
+    content: string;
+}>;
+/**
+ * Clean a raw Figma variant name like "Type=Image, Size=12" into "Image / 12".
+ * Extracts just the values from "Key=Value" pairs, joined by " / ".
+ */
+export declare function cleanVariantName(rawName: string): string;
+/** Structured content extracted from a Figma component description */
+interface ParsedDescription {
+    /** The main overview/summary text */
+    overview: string;
+    /** "When to Use" bullet points */
+    whenToUse: string[];
+    /** "When NOT to Use" bullet points */
+    whenNotToUse: string[];
+    /** Content guidelines sections (title text, description text, etc.) */
+    contentGuidelines: Array<{
+        heading: string;
+        items: string[];
+    }>;
+    /** Accessibility notes */
+    accessibilityNotes: string[];
+    /** Any remaining unclassified content */
+    additionalNotes: string[];
+}
+/**
+ * Parse a Figma component description into structured sections.
+ * Handles markdown-formatted descriptions with headers, bullet points, etc.
+ */
+export declare function parseComponentDescription(description: string): ParsedDescription;
+/** Color data collected from a specific variant */
+interface VariantColorData {
+    variantName: string;
+    fills: Array<{
+        hex: string;
+        nodeName: string;
+        variableId?: string;
+        variableName?: string;
+    }>;
+    strokes: Array<{
+        hex: string;
+        nodeName: string;
+        variableId?: string;
+        variableName?: string;
+    }>;
+    textColors: Array<{
+        hex: string;
+        nodeName: string;
+        variableId?: string;
+        variableName?: string;
+    }>;
+    icons: Array<{
+        name: string;
+        type: string;
+    }>;
+}
+/** Typography data from a text node */
+interface TextStyleData {
+    nodeName: string;
+    fontFamily: string;
+    fontWeight: number;
+    fontWeightName: string;
+    fontSize: number;
+    lineHeight: number;
+    letterSpacing: number;
+    variableBindings?: Record<string, string>;
+}
+/**
+ * Collect color data from all variants in a COMPONENT_SET.
+ * For single COMPONENTs, returns data for just that component.
+ */
+export declare function collectAllVariantData(node: any, varNameMap: Map<string, string>): VariantColorData[];
+/**
+ * Collect typography data from all text nodes in a component tree.
+ */
+export declare function collectTypographyData(node: any, depth?: number, maxDepth?: number): TextStyleData[];
+/**
+ * Build an anatomy tree representation from a Figma node structure.
+ * Returns a formatted string showing the component's nested structure.
+ */
+export declare function buildAnatomyTree(node: any, depth?: number, maxDepth?: number): string;
+/**
+ * Resolve the node to use for visual/spacing/typography comparisons.
+ * COMPONENT_SET frames have container-level styling (Figma's purple dashed stroke,
+ * default cornerRadius: 5, organizational padding) that are NOT actual design specs.
+ * The real design properties live on the child COMPONENT variants.
+ * Returns the default variant (first child) for COMPONENT_SET, or the node itself otherwise.
+ */
+export declare function resolveVisualNode(node: any): any;
+/** Detect if a node name is a Figma variant pattern like "Variant=Default, State=Hover, Size=lg" */
+export declare function isVariantName(name: string): boolean;
+/** Sanitize a component name for use as a file path */
+export declare function sanitizeComponentName(name: string): string;
+/** Convert generated markdown into a CompanyDocsMCP-compatible content entry */
+export declare function toCompanyDocsEntry(markdown: string, componentName: string, figmaUrl: string, systemName?: string): CompanyDocsContentEntry;
+export declare function registerDesignCodeTools(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-code-tools.d.ts.map

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

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