@mp3wizard/figma-console-mcp 1.14.0

package/dist/browser/local.js

@@ -0,0 +1,318 @@
+/**
+ * Local Browser Manager (Legacy)
+ * Note: This module is maintained for backwards compatibility but is no longer
+ * the primary connection method. Use the WebSocket Desktop Bridge plugin instead.
+ */
+import puppeteer from 'puppeteer-core';
+import { createChildLogger } from '../core/logger.js';
+import { extractFileKey } from '../core/figma-api.js';
+const logger = createChildLogger({ component: 'local-browser' });
+/**
+ * Local Browser Manager
+ * Connects to existing Figma Desktop instance via remote debugging port
+ */
+export class LocalBrowserManager {
+    constructor(config) {
+        this.browser = null;
+        this.page = null;
+        this.config = config;
+    }
+    /**
+     * Connect to Figma Desktop via remote debugging port
+     */
+    async launch() {
+        if (this.browser) {
+            logger.info('Browser already connected, reusing instance');
+            return;
+        }
+        const { debugHost, debugPort } = this.config;
+        const browserURL = `http://${debugHost}:${debugPort}`;
+        logger.info({ browserURL }, 'Connecting to Figma Desktop');
+        try {
+            // Connect to existing browser (Figma Desktop)
+            this.browser = await puppeteer.connect({
+                browserURL,
+                defaultViewport: null, // Use Figma's viewport
+            });
+            logger.info('Connected to Figma Desktop successfully');
+            // Handle disconnection
+            this.browser.on('disconnected', () => {
+                logger.warn('Disconnected from Figma Desktop');
+                this.browser = null;
+                this.page = null;
+            });
+        }
+        catch (error) {
+            logger.error({ error, browserURL }, 'Failed to connect to Figma Desktop');
+            throw new Error(`Failed to connect to Figma Desktop.\n\n` +
+                `Please open the Desktop Bridge plugin in Figma:\n` +
+                `  Plugins → Development → Figma Desktop Bridge\n\n` +
+                `Error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Find the best page for plugin debugging
+     * Actively searches for pages with workers across ALL tabs
+     */
+    async findBestPage() {
+        if (!this.browser) {
+            return null;
+        }
+        const pages = await this.browser.pages();
+        // Find Figma pages with workers
+        const figmaPages = pages.filter(p => {
+            const url = p.url();
+            return url.includes('figma.com') && !url.includes('devtools');
+        });
+        if (figmaPages.length === 0) {
+            return null;
+        }
+        // Check each page for workers
+        const pagesWithWorkers = figmaPages
+            .map(p => ({
+            page: p,
+            workerCount: p.workers().length,
+            url: p.url()
+        }))
+            .filter(p => p.workerCount > 0)
+            .sort((a, b) => b.workerCount - a.workerCount); // Most workers first
+        if (pagesWithWorkers.length > 0) {
+            logger.info({
+                url: pagesWithWorkers[0].url,
+                workerCount: pagesWithWorkers[0].workerCount,
+                totalPagesWithWorkers: pagesWithWorkers.length
+            }, 'Found page with active plugin workers');
+            return pagesWithWorkers[0].page;
+        }
+        // No workers found - prefer design/file pages
+        const designPage = figmaPages.find(p => p.url().includes('/design/') || p.url().includes('/file/'));
+        return designPage || figmaPages[0];
+    }
+    /**
+     * Find an existing browser tab whose URL matches the given Figma file key
+     */
+    async findPageByFileKey(targetFileKey) {
+        if (!this.browser) {
+            return null;
+        }
+        const pages = await this.browser.pages();
+        for (const page of pages) {
+            const pageUrl = page.url();
+            if (!pageUrl.includes('figma.com') || pageUrl.includes('devtools')) {
+                continue;
+            }
+            const pageFileKey = extractFileKey(pageUrl);
+            if (pageFileKey && pageFileKey === targetFileKey) {
+                logger.info({ url: pageUrl, fileKey: pageFileKey }, 'Found existing tab for file key');
+                return page;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get active Figma page or create new one
+     * Prefers pages with active plugin workers for plugin debugging
+     */
+    async getPage() {
+        // Ensure connection is alive before proceeding
+        await this.ensureConnection();
+        if (!this.browser) {
+            await this.launch();
+        }
+        // If we already have a page from explicit navigation, use it (don't override with findBestPage)
+        if (this.page && !this.page.isClosed()) {
+            return this.page;
+        }
+        // No explicit page set — find the best page (most workers) for initial connection
+        const bestPage = await this.findBestPage();
+        if (bestPage) {
+            const workerCount = bestPage.workers().length;
+            logger.info({
+                url: bestPage.url(),
+                workerCount
+            }, 'Selected page for monitoring (auto-detected)');
+            this.page = bestPage;
+            return this.page;
+        }
+        // Fallback: Get any existing page or create new one
+        const pages = await this.browser.pages();
+        if (pages.length > 0 && pages[0].url() !== 'about:blank') {
+            logger.warn({ url: pages[0].url() }, 'No Figma pages found, using first available page');
+            this.page = pages[0];
+            return this.page;
+        }
+        // Last resort: Create new page
+        logger.warn('No suitable pages found, creating new page in Figma Desktop');
+        this.page = await this.browser.newPage();
+        return this.page;
+    }
+    /**
+     * Navigate to Figma URL
+     * If the target file is already open in a tab, switches to it instead of navigating.
+     */
+    async navigateToFigma(figmaUrl) {
+        // Ensure connection is alive before navigation
+        await this.ensureConnection();
+        // Default to Figma homepage if no URL provided
+        const url = figmaUrl || 'https://www.figma.com';
+        // Check if the target file is already open in an existing tab
+        const targetFileKey = extractFileKey(url);
+        if (targetFileKey) {
+            const existingPage = await this.findPageByFileKey(targetFileKey);
+            if (existingPage) {
+                logger.info({ url, fileKey: targetFileKey }, 'Switching to existing tab instead of navigating');
+                await existingPage.bringToFront();
+                this.page = existingPage;
+                return { page: existingPage, action: 'switched_to_existing', url: existingPage.url() };
+            }
+        }
+        // No existing tab found — fall through to normal navigation
+        const page = await this.getPage();
+        logger.info({ url }, 'Navigating to Figma');
+        try {
+            await page.goto(url, {
+                waitUntil: 'networkidle2',
+                timeout: 30000,
+            });
+            logger.info({ url }, 'Navigation successful');
+            return { page, action: 'navigated', url };
+        }
+        catch (error) {
+            logger.error({ error, url }, 'Navigation failed');
+            throw new Error(`Failed to navigate to ${url}: ${error}`);
+        }
+    }
+    /**
+     * Reload current page
+     */
+    async reload(hardReload = false) {
+        if (!this.page || this.page.isClosed()) {
+            throw new Error('No active page to reload');
+        }
+        logger.info({ hardReload }, 'Reloading page');
+        try {
+            await this.page.reload({
+                waitUntil: 'networkidle2',
+                timeout: 30000,
+            });
+            logger.info('Page reloaded successfully');
+        }
+        catch (error) {
+            logger.error({ error }, 'Page reload failed');
+            throw new Error(`Page reload failed: ${error}`);
+        }
+    }
+    /**
+     * Execute JavaScript in page context
+     */
+    async evaluate(fn) {
+        const page = await this.getPage();
+        return page.evaluate(fn);
+    }
+    // Screenshot functionality removed - use Figma REST API's getImages() instead
+    // See: figma_take_screenshot and figma_get_component_image tools
+    /**
+     * Check if browser is connected
+     */
+    isRunning() {
+        return this.browser !== null && this.browser.isConnected();
+    }
+    /**
+     * Disconnect from browser (doesn't close Figma Desktop)
+     */
+    async close() {
+        if (!this.browser) {
+            return;
+        }
+        logger.info('Disconnecting from Figma Desktop');
+        try {
+            // Just disconnect, don't close Figma Desktop
+            this.browser.disconnect();
+            this.browser = null;
+            this.page = null;
+            logger.info('Disconnected from Figma Desktop successfully');
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to disconnect from browser');
+            throw error;
+        }
+    }
+    /**
+     * Get current page URL
+     */
+    getCurrentUrl() {
+        if (!this.page || this.page.isClosed()) {
+            return null;
+        }
+        return this.page.url();
+    }
+    /**
+     * Check if the browser connection is still alive
+     * Returns false if connection is stale (e.g., after computer sleep)
+     */
+    async isConnectionAlive() {
+        try {
+            if (!this.browser || !this.page) {
+                return false;
+            }
+            // Try to get the page title - this will fail if connection is dead
+            await this.page.title();
+            return true;
+        }
+        catch (error) {
+            logger.warn({ error }, 'Browser connection appears to be dead');
+            return false;
+        }
+    }
+    /**
+     * Reconnect to Figma Desktop if connection was lost
+     * Call this before any operation that requires a live connection
+     */
+    async ensureConnection() {
+        const isAlive = await this.isConnectionAlive();
+        if (!isAlive) {
+            logger.info('Connection lost, attempting to reconnect to Figma Desktop');
+            // Clear stale references
+            this.browser = null;
+            this.page = null;
+            // Reconnect
+            await this.launch();
+            logger.info('Successfully reconnected to Figma Desktop');
+        }
+    }
+    /**
+     * Force a complete reconnection to Figma Desktop
+     * Use this when frames become detached or stale even though the browser appears connected
+     */
+    async forceReconnect() {
+        logger.info('Force reconnecting to Figma Desktop');
+        // Disconnect current connection if exists
+        if (this.browser) {
+            try {
+                this.browser.disconnect();
+            }
+            catch (e) {
+                // Ignore disconnect errors
+            }
+        }
+        // Clear all references
+        this.browser = null;
+        this.page = null;
+        // Reconnect
+        await this.launch();
+        logger.info('Force reconnect completed');
+    }
+    /**
+     * Wait for navigation
+     */
+    async waitForNavigation(timeout = 30000) {
+        if (!this.page || this.page.isClosed()) {
+            throw new Error('No active page');
+        }
+        await this.page.waitForNavigation({
+            waitUntil: 'networkidle2',
+            timeout,
+        });
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/browser/local.js.map

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

package/dist/cloudflare/apps/design-system-dashboard/scoring/accessibility.js

@@ -0,0 +1,277 @@
+/**
+ * Accessibility Scorer (weight: 0.15)
+ *
+ * Checks accessibility-related signals in the design system.
+ * Evaluates color contrast ratios, state variant coverage,
+ * and semantic color naming patterns.
+ */
+import { clamp, getSeverity } from "./types.js";
+/** Maximum examples to include in a finding. */
+const MAX_EXAMPLES = 5;
+/** WCAG AA minimum contrast ratio for normal text. */
+const WCAG_AA_RATIO = 4.5;
+/** State-related variant values that indicate accessible component design. */
+const STATE_VARIANTS = [
+    "disabled",
+    "error",
+    "focus",
+    "hover",
+    "active",
+    "pressed",
+    "selected",
+];
+/** Semantic color token name patterns that indicate accessibility awareness. */
+const SEMANTIC_COLOR_NAMES = ["error", "warning", "success", "info", "danger"];
+/**
+ * Linearize an sRGB channel value for luminance calculation.
+ * Input: channel value in 0-1 range.
+ */
+function linearize(channel) {
+    return channel <= 0.04045
+        ? channel / 12.92
+        : ((channel + 0.055) / 1.055) ** 2.4;
+}
+/**
+ * Calculate relative luminance of a color.
+ * r, g, b are in 0-1 range (as Figma provides them).
+ */
+function luminance(r, g, b) {
+    return 0.2126 * linearize(r) + 0.7152 * linearize(g) + 0.0722 * linearize(b);
+}
+/**
+ * Calculate contrast ratio between two colors.
+ * Returns a ratio >= 1 (e.g., 4.5 for WCAG AA compliance).
+ */
+function contrastRatio(r1, g1, b1, r2, g2, b2) {
+    const lum1 = luminance(r1, g1, b1);
+    const lum2 = luminance(r2, g2, b2);
+    const lighter = Math.max(lum1, lum2);
+    const darker = Math.min(lum1, lum2);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+/**
+ * Check if a value is a direct color (not an alias).
+ */
+function isDirectColor(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return (typeof v.r === "number" &&
+        typeof v.g === "number" &&
+        typeof v.b === "number" &&
+        v.type !== "VARIABLE_ALIAS");
+}
+/**
+ * Extract resolved color values from variables.
+ * Returns an array of { name, r, g, b } objects for direct color values.
+ */
+function extractColorValues(variables) {
+    const colors = [];
+    for (const variable of variables) {
+        if (variable.resolvedType !== "COLOR" || !variable.valuesByMode)
+            continue;
+        for (const value of Object.values(variable.valuesByMode)) {
+            if (isDirectColor(value)) {
+                colors.push({
+                    name: variable.name,
+                    r: value.r,
+                    g: value.g,
+                    b: value.b,
+                });
+                break; // Use the first direct color value per variable
+            }
+        }
+    }
+    return colors;
+}
+/**
+ * Identify likely foreground/background color pairs and check contrast.
+ *
+ * Strategy: pair colors whose names suggest fg/bg relationships:
+ * - Names containing "background"/"bg"/"surface" are backgrounds
+ * - Names containing "text"/"foreground"/"fg"/"on" are foregrounds
+ * Falls back to pairing dark colors with light colors if no naming convention found.
+ */
+function scoreColorContrast(data) {
+    const colors = extractColorValues(data.variables);
+    if (colors.length < 2) {
+        return {
+            id: "a11y-color-contrast",
+            label: "Color contrast",
+            score: 100,
+            severity: "info",
+            tooltip: "Foreground/background color pairs should meet WCAG AA contrast ratio (4.5:1). Low contrast makes content unreadable for users with vision impairments.",
+            details: colors.length === 0
+                ? "No direct color values to evaluate."
+                : "Only one color found; need at least two to check contrast.",
+        };
+    }
+    const bgPattern = /background|bg|surface|canvas|base/i;
+    const fgPattern = /text|foreground|fg|on-|on\.|label|title|body|heading/i;
+    const backgrounds = colors.filter((c) => bgPattern.test(c.name));
+    const foregrounds = colors.filter((c) => fgPattern.test(c.name));
+    // If naming conventions are not used, use luminance-based heuristic
+    let pairs = [];
+    if (backgrounds.length > 0 && foregrounds.length > 0) {
+        // Pair foregrounds with backgrounds by naming proximity
+        for (const fg of foregrounds) {
+            for (const bg of backgrounds) {
+                pairs.push({ fg, bg });
+            }
+        }
+    }
+    else {
+        // Heuristic: separate into light (luminance > 0.5) and dark (luminance <= 0.5)
+        const lightColors = colors.filter((c) => luminance(c.r, c.g, c.b) > 0.5);
+        const darkColors = colors.filter((c) => luminance(c.r, c.g, c.b) <= 0.5);
+        for (const dark of darkColors) {
+            for (const light of lightColors) {
+                pairs.push({ fg: dark, bg: light });
+            }
+        }
+    }
+    if (pairs.length === 0) {
+        return {
+            id: "a11y-color-contrast",
+            label: "Color contrast",
+            score: 50,
+            severity: "warning",
+            tooltip: "Foreground/background color pairs should meet WCAG AA contrast ratio (4.5:1). Low contrast makes content unreadable for users with vision impairments.",
+            details: "Could not identify foreground/background color pairs to check contrast.",
+        };
+    }
+    // Limit pair evaluation to avoid performance issues with large token sets
+    const maxPairs = 50;
+    if (pairs.length > maxPairs) {
+        pairs = pairs.slice(0, maxPairs);
+    }
+    let passingPairs = 0;
+    const failingExamples = [];
+    for (const { fg, bg } of pairs) {
+        const ratio = contrastRatio(fg.r, fg.g, fg.b, bg.r, bg.g, bg.b);
+        if (ratio >= WCAG_AA_RATIO) {
+            passingPairs++;
+        }
+        else if (failingExamples.length < MAX_EXAMPLES) {
+            failingExamples.push(`${fg.name} / ${bg.name} (${ratio.toFixed(1)}:1)`);
+        }
+    }
+    const passRatio = passingPairs / pairs.length;
+    const score = clamp(passRatio * 100);
+    return {
+        id: "a11y-color-contrast",
+        label: "Color contrast",
+        score,
+        severity: getSeverity(score),
+        tooltip: "Foreground/background color pairs should meet WCAG AA contrast ratio (4.5:1). Low contrast makes content unreadable for users with vision impairments.",
+        details: `${passingPairs} of ${pairs.length} color pairs meet WCAG AA contrast ratio (${WCAG_AA_RATIO}:1).`,
+        examples: failingExamples.length > 0 ? failingExamples : undefined,
+    };
+}
+/**
+ * Score state variant coverage.
+ * Components should include state-related variants for accessibility.
+ */
+function scoreStateVariants(data) {
+    const components = data.components;
+    if (components.length === 0) {
+        return {
+            id: "a11y-state-variants",
+            label: "State variants",
+            score: 100,
+            severity: "info",
+            tooltip: "Interactive components should include state variants (disabled, error, focus, hover, active, pressed, selected) for accessible interactions.",
+            details: "No components to evaluate.",
+        };
+    }
+    // Check which state variants exist across all component names
+    const allNames = components.map((c) => c.name.toLowerCase()).join(" ");
+    const foundStates = STATE_VARIANTS.filter((state) => allNames.includes(state));
+    const ratio = foundStates.length / STATE_VARIANTS.length;
+    const score = clamp(ratio * 100);
+    const missingStates = STATE_VARIANTS.filter((state) => !allNames.includes(state));
+    return {
+        id: "a11y-state-variants",
+        label: "State variants",
+        score,
+        severity: getSeverity(score),
+        tooltip: "Interactive components should include state variants (disabled, error, focus, hover, active, pressed, selected) for accessible interactions.",
+        details: missingStates.length > 0
+            ? `Found ${foundStates.length} of ${STATE_VARIANTS.length} state variants. Missing: ${missingStates.join(", ")}.`
+            : `All ${STATE_VARIANTS.length} state variants are represented.`,
+    };
+}
+/**
+ * Score semantic color naming.
+ * The token set should include semantic color tokens for error/warning/success/info.
+ */
+function variableDataUnavailable(data) {
+    return (data.dataAvailability !== undefined && !data.dataAvailability.variables);
+}
+function scoreSemanticColorNaming(data) {
+    const colorVars = data.variables.filter((v) => v.resolvedType === "COLOR");
+    if (colorVars.length === 0) {
+        const unavailable = variableDataUnavailable(data);
+        return {
+            id: "a11y-semantic-colors",
+            label: "Semantic color naming",
+            score: 0,
+            severity: unavailable ? "info" : "fail",
+            tooltip: "The token set should include semantic color categories (error, warning, success, info, danger) to convey meaning beyond color alone.",
+            details: unavailable
+                ? `Variable data unavailable: ${data.dataAvailability?.variableError || "Requires Desktop Bridge or Enterprise plan."}`
+                : "No color variables found.",
+        };
+    }
+    const foundSemantic = [];
+    const missingSemantic = [];
+    const semanticExamples = [];
+    for (const name of SEMANTIC_COLOR_NAMES) {
+        const matching = colorVars.filter((v) => v.name.toLowerCase().includes(name));
+        if (matching.length > 0) {
+            foundSemantic.push(name);
+            semanticExamples.push(`${name}: ${matching
+                .slice(0, 2)
+                .map((v) => v.name)
+                .join(", ")}`);
+        }
+        else {
+            missingSemantic.push(name);
+        }
+    }
+    const ratio = foundSemantic.length / SEMANTIC_COLOR_NAMES.length;
+    const score = clamp(ratio * 100);
+    return {
+        id: "a11y-semantic-colors",
+        label: "Semantic color naming",
+        score,
+        severity: getSeverity(score),
+        tooltip: "The token set should include semantic color categories (error, warning, success, info, danger) to convey meaning beyond color alone.",
+        details: missingSemantic.length > 0
+            ? `Found ${foundSemantic.length} of ${SEMANTIC_COLOR_NAMES.length} semantic color categories. Missing: ${missingSemantic.join(", ")}.`
+            : "All semantic color categories (error, warning, success, info, danger) are present.",
+        examples: semanticExamples.length > 0
+            ? semanticExamples.slice(0, MAX_EXAMPLES)
+            : undefined,
+    };
+}
+/**
+ * Accessibility category scorer.
+ * Returns the average score across all accessibility checks.
+ */
+export function scoreAccessibility(data) {
+    const findings = [
+        scoreColorContrast(data),
+        scoreStateVariants(data),
+        scoreSemanticColorNaming(data),
+    ];
+    const score = clamp(findings.reduce((sum, f) => sum + f.score, 0) / findings.length);
+    return {
+        id: "accessibility",
+        label: "Accessibility",
+        shortLabel: "Accessibility",
+        score,
+        weight: 0.15,
+        findings,
+    };
+}