@mp3wizard/figma-console-mcp 1.14.0

package/dist/apps/design-system-dashboard/scoring/accessibility.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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 type { CategoryScore, DesignSystemRawData } from "./types.js";
+/**
+ * Accessibility category scorer.
+ * Returns the average score across all accessibility checks.
+ */
+export declare function scoreAccessibility(data: DesignSystemRawData): CategoryScore;
+//# sourceMappingURL=accessibility.d.ts.map

package/dist/apps/design-system-dashboard/scoring/accessibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../../../src/apps/design-system-dashboard/scoring/accessibility.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAW,MAAM,YAAY,CAAC;AAiU9E;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,CAmB3E"}

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

@@ -0,0 +1,278 @@
+/**
+ * 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,
+    };
+}
+//# sourceMappingURL=accessibility.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.js","sourceRoot":"","sources":["../../../../src/apps/design-system-dashboard/scoring/accessibility.ts"],"names":[],"mappings":"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"}

package/dist/apps/design-system-dashboard/scoring/component-metadata.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Component Metadata Scorer (weight: 0.20)
+ *
+ * Checks component quality and completeness within the design system.
+ * Evaluates description presence, description quality, property completeness,
+ * variant structure, and category organization.
+ *
+ * Scores against "scorable units" (component sets + standalone components)
+ * rather than raw variant count to avoid inflated totals.
+ */
+import type { CategoryScore, DesignSystemRawData } from "./types.js";
+export interface ComponentClassification {
+    standalone: any[];
+    variants: any[];
+    componentSets: any[];
+    scorableUnits: any[];
+}
+/**
+ * Classify components into standalone, variants, and component sets.
+ * Scoring evaluates `scorableUnits` (standalone + componentSets)
+ * instead of the raw component list which double-counts variants.
+ */
+export declare function classifyComponents(data: DesignSystemRawData): ComponentClassification;
+/**
+ * Component Metadata category scorer.
+ * Returns the average score across all component metadata checks.
+ */
+export declare function scoreComponentMetadata(data: DesignSystemRawData): CategoryScore;
+//# sourceMappingURL=component-metadata.d.ts.map

package/dist/apps/design-system-dashboard/scoring/component-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-metadata.d.ts","sourceRoot":"","sources":["../../../../src/apps/design-system-dashboard/scoring/component-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAW,MAAM,YAAY,CAAC;AAa9E,MAAM,WAAW,uBAAuB;IACvC,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,aAAa,EAAE,GAAG,EAAE,CAAC;IACrB,aAAa,EAAE,GAAG,EAAE,CAAC;CACrB;AAoDD;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,mBAAmB,GACvB,uBAAuB,CAmBzB;AAwUD;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,mBAAmB,GACvB,aAAa,CAwBf"}