@buoy-design/core 0.1.1 → 0.1.3

package/dist/analysis/audit.d.ts

@@ -0,0 +1,47 @@
+export interface AuditValue {
+    category: 'color' | 'spacing' | 'typography' | 'radius';
+    value: string;
+    file: string;
+    line: number;
+}
+export interface CategoryStats {
+    uniqueCount: number;
+    totalUsages: number;
+    mostCommon: Array<{
+        value: string;
+        count: number;
+    }>;
+}
+export interface FileIssue {
+    file: string;
+    issueCount: number;
+}
+export interface CloseMatch {
+    value: string;
+    closeTo: string;
+    distance: number;
+}
+export interface AuditReport {
+    categories: Record<string, CategoryStats>;
+    worstFiles: FileIssue[];
+    totals: {
+        uniqueValues: number;
+        totalUsages: number;
+        filesAffected: number;
+    };
+    closeMatches: CloseMatch[];
+    score: number;
+}
+/**
+ * Generate an audit report from extracted values
+ */
+export declare function generateAuditReport(values: AuditValue[]): AuditReport;
+/**
+ * Find values that are close to design tokens (likely typos)
+ */
+export declare function findCloseMatches(foundValues: string[], designTokens: string[], category: 'color' | 'spacing' | 'typography' | 'radius'): CloseMatch[];
+/**
+ * Calculate health score (0-100) from audit report
+ */
+export declare function calculateHealthScore(report: AuditReport): number;
+//# sourceMappingURL=audit.d.ts.map

package/dist/analysis/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/analysis/audit.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,MAAM,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,WAAW,CAoErE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EAAE,EACrB,YAAY,EAAE,MAAM,EAAE,EACtB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GACtD,UAAU,EAAE,CAoCd;AA0DD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA6BhE"}

package/dist/analysis/audit.js

@@ -0,0 +1,168 @@
+// Audit report generation - analyzes codebase for design system health
+/**
+ * Generate an audit report from extracted values
+ */
+export function generateAuditReport(values) {
+    if (values.length === 0) {
+        return {
+            categories: {},
+            worstFiles: [],
+            totals: { uniqueValues: 0, totalUsages: 0, filesAffected: 0 },
+            closeMatches: [],
+            score: 100,
+        };
+    }
+    // Group by category
+    const byCategory = new Map();
+    const byFile = new Map();
+    const allFiles = new Set();
+    for (const v of values) {
+        // Category stats
+        if (!byCategory.has(v.category)) {
+            byCategory.set(v.category, new Map());
+        }
+        const catMap = byCategory.get(v.category);
+        catMap.set(v.value, (catMap.get(v.value) || 0) + 1);
+        // File stats
+        byFile.set(v.file, (byFile.get(v.file) || 0) + 1);
+        allFiles.add(v.file);
+    }
+    // Build category stats
+    const categories = {};
+    let totalUnique = 0;
+    for (const [category, valueMap] of byCategory) {
+        const entries = [...valueMap.entries()];
+        const uniqueCount = entries.length;
+        const totalUsages = entries.reduce((sum, [, count]) => sum + count, 0);
+        // Sort by count descending for mostCommon
+        const mostCommon = entries
+            .map(([value, count]) => ({ value, count }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 10);
+        categories[category] = { uniqueCount, totalUsages, mostCommon };
+        totalUnique += uniqueCount;
+    }
+    // Build worst files list
+    const worstFiles = [...byFile.entries()]
+        .map(([file, issueCount]) => ({ file, issueCount }))
+        .sort((a, b) => b.issueCount - a.issueCount)
+        .slice(0, 10);
+    const report = {
+        categories,
+        worstFiles,
+        totals: {
+            uniqueValues: totalUnique,
+            totalUsages: values.length,
+            filesAffected: allFiles.size,
+        },
+        closeMatches: [],
+        score: 0,
+    };
+    report.score = calculateHealthScore(report);
+    return report;
+}
+/**
+ * Find values that are close to design tokens (likely typos)
+ */
+export function findCloseMatches(foundValues, designTokens, category) {
+    const matches = [];
+    const tokenSet = new Set(designTokens.map((t) => t.toLowerCase()));
+    for (const value of foundValues) {
+        const valueLower = value.toLowerCase();
+        // Skip exact matches
+        if (tokenSet.has(valueLower)) {
+            continue;
+        }
+        // Find closest token
+        let closestToken = null;
+        let closestDistance = Infinity;
+        for (const token of designTokens) {
+            const distance = getDistance(value, token, category);
+            if (distance < closestDistance && distance > 0) {
+                closestDistance = distance;
+                closestToken = token;
+            }
+        }
+        // Only include if close enough (threshold depends on category)
+        const threshold = category === 'color' ? 5 : 2;
+        if (closestToken && closestDistance <= threshold) {
+            matches.push({
+                value,
+                closeTo: closestToken,
+                distance: closestDistance,
+            });
+        }
+    }
+    return matches;
+}
+/**
+ * Calculate distance between two values
+ */
+function getDistance(a, b, category) {
+    if (category === 'color') {
+        return colorDistance(a, b);
+    }
+    if (category === 'spacing' || category === 'radius') {
+        return numericDistance(a, b);
+    }
+    // For typography, use simple string comparison
+    return a.toLowerCase() === b.toLowerCase() ? 0 : Infinity;
+}
+/**
+ * Calculate color distance (simple hex comparison)
+ */
+function colorDistance(a, b) {
+    const hexA = a.replace('#', '').toLowerCase();
+    const hexB = b.replace('#', '').toLowerCase();
+    if (hexA.length !== 6 || hexB.length !== 6) {
+        return Infinity;
+    }
+    // Count differing characters
+    let diff = 0;
+    for (let i = 0; i < 6; i++) {
+        if (hexA[i] !== hexB[i]) {
+            diff++;
+        }
+    }
+    return diff;
+}
+/**
+ * Calculate numeric distance for spacing/radius
+ */
+function numericDistance(a, b) {
+    const numA = parseFloat(a);
+    const numB = parseFloat(b);
+    if (isNaN(numA) || isNaN(numB)) {
+        return Infinity;
+    }
+    return Math.abs(numA - numB);
+}
+/**
+ * Calculate health score (0-100) from audit report
+ */
+export function calculateHealthScore(report) {
+    // Perfect score if no issues
+    if (report.totals.uniqueValues === 0) {
+        return 100;
+    }
+    let score = 100;
+    // Penalize for too many unique values
+    // Expect roughly: colors ~12, spacing ~8, typography ~6, radius ~4 = ~30 total
+    const expectedMaxUnique = 30;
+    const uniqueRatio = report.totals.uniqueValues / expectedMaxUnique;
+    if (uniqueRatio > 1) {
+        // Heavy penalty for exceeding expected unique values
+        // 50 unique = ratio 1.67, penalty = 0.67 * 80 = 53
+        score -= Math.min(80, (uniqueRatio - 1) * 80);
+    }
+    // Penalize for close matches (typos) - 6 points each
+    score -= report.closeMatches.length * 6;
+    // Penalize for concentration in worst files
+    const worstFile = report.worstFiles[0];
+    if (worstFile && worstFile.issueCount > 20) {
+        score -= Math.min(20, (worstFile.issueCount - 20) * 0.5);
+    }
+    // Clamp to 0-100
+    return Math.max(0, Math.min(100, Math.round(score)));
+}
+//# sourceMappingURL=audit.js.map

package/dist/analysis/audit.js.map

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

package/dist/analysis/index.d.ts

@@ -2,4 +2,5 @@ export { SemanticDiffEngine, type ComponentMatch, type ComponentDifference, type
 export { TokenSuggestionService, type TokenSuggestion, } from "./token-suggestions.js";
 export { stringSimilarity, levenshteinDistance, normalizeForComparison, } from "./string-utils.js";
 export { MATCHING_CONFIG, NAMING_CONFIG, TOKEN_SUGGESTION_CONFIG, SCANNER_CONFIG, getOutlierThreshold, } from "./config.js";
+export { generateAuditReport, findCloseMatches, calculateHealthScore, type AuditValue, type AuditReport, type CategoryStats, type FileIssue, type CloseMatch, } from "./audit.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/analysis/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC"}

package/dist/analysis/index.js

@@ -5,4 +5,6 @@ export { TokenSuggestionService, } from "./token-suggestions.js";
 export { stringSimilarity, levenshteinDistance, normalizeForComparison, } from "./string-utils.js";
 // Analysis configuration
 export { MATCHING_CONFIG, NAMING_CONFIG, TOKEN_SUGGESTION_CONFIG, SCANNER_CONFIG, getOutlierThreshold, } from "./config.js";
+// Audit report
+export { generateAuditReport, findCloseMatches, calculateHealthScore, } from "./audit.js";
 //# sourceMappingURL=index.js.map

package/dist/analysis/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAOnB,MAAM,oBAAoB,CAAC;AAE5B,6BAA6B;AAC7B,OAAO,EACL,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC;AAEhC,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,yBAAyB;AACzB,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAOnB,MAAM,oBAAoB,CAAC;AAE5B,6BAA6B;AAC7B,OAAO,EACL,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC;AAEhC,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,yBAAyB;AACzB,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GAMrB,MAAM,YAAY,CAAC"}

package/dist/analysis/semantic-diff.d.ts

@@ -122,6 +122,21 @@ export declare class SemanticDiffEngine {
     private tokenToDriftSource;
     private getHighestSeverity;
     private checkAccessibility;
+    /**
+     * Check for color contrast issues in component
+     * Detects foreground/background color pairs that fail WCAG contrast ratios
+     */
+    private checkColorContrast;
+    /**
+     * Check for unused components
+     * Components that are defined but never imported/used elsewhere
+     */
+    checkUnusedComponents(components: Component[], usageMap: Map<string, number>): DriftSignal[];
+    /**
+     * Check for unused tokens
+     * Design tokens that are defined but never referenced
+     */
+    checkUnusedTokens(tokens: DesignToken[], usageMap: Map<string, number>): DriftSignal[];
     /**
      * Find token suggestions for a hardcoded color value
      * Delegates to TokenSuggestionService

package/dist/analysis/semantic-diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semantic-diff.d.ts","sourceRoot":"","sources":["../../src/analysis/semantic-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,QAAQ,EAET,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAShC,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAgF9D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,cAAc,EAAE,SAAS,EAAE,CAAC;IAC5B,cAAc,EAAE,SAAS,EAAE,CAAC;IAC5B,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,EAAE,CAAC;IACxD,cAAc,EAAE,WAAW,EAAE,CAAC;IAC9B,cAAc,EAAE,WAAW,EAAE,CAAC;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,CAAC,EAAE;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,8EAA8E;IAC9E,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;CACjC;AA4BD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,kBAAkB;IAE7B,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,sBAAsB,CAO1B;IAGJ,OAAO,CAAC,sBAAsB,CAAgC;IAE9D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,WAAW,GAAG,IAAI;IAiErE;;;OAGG;IACH,iBAAiB,CACf,gBAAgB,EAAE,SAAS,EAAE,EAC7B,gBAAgB,EAAE,SAAS,EAAE,EAC7B,OAAO,GAAE,WAAgB,GACxB,kBAAkB;IA0ErB;;OAEG;IACH,aAAa,CACX,YAAY,EAAE,WAAW,EAAE,EAC3B,YAAY,EAAE,WAAW,EAAE,GAC1B,eAAe;IA4ElB;;OAEG;IACH,iBAAiB,CACf,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,GAAE,eAAoB,GAC5B;QAAE,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE;IA2P5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgC5B,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,sBAAsB;IAmB9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,wBAAwB;IA6BhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,0BAA0B;IAqClC,OAAO,CAAC,uBAAuB;IAqB/B;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAsCjC;;;OAGG;IACH,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,mBAAmB;IAwC3B,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,eAAe;IA+CvB,OAAO,CAAC,uBAAuB;IAqE/B,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,kBAAkB;IAsC1B;;;OAGG;IACH,yBAAyB,CACvB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,WAAW,EAAE,EACrB,cAAc,GAAE,MAAU,GACzB,eAAe,EAAE;IAQpB;;;OAGG;IACH,2BAA2B,CACzB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,WAAW,EAAE,EACrB,cAAc,GAAE,MAAU,GACzB,eAAe,EAAE;IAQpB;;;OAGG;IACH,wBAAwB,CACtB,eAAe,EAAE,KAAK,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,EACF,MAAM,EAAE,WAAW,EAAE,GACpB,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;CAMlC"}
+{"version":3,"file":"semantic-diff.d.ts","sourceRoot":"","sources":["../../src/analysis/semantic-diff.ts"],"names":[],"mappings":"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"}

package/dist/analysis/semantic-diff.js

@@ -2,6 +2,84 @@ import { createDriftId, normalizeComponentName, normalizeTokenName, tokensMatch,
 import { TokenSuggestionService, } from "./token-suggestions.js";
 import { stringSimilarity as calcStringSimilarity } from "./string-utils.js";
 import { MATCHING_CONFIG, NAMING_CONFIG, getOutlierThreshold, } from "./config.js";
+/**
+ * Calculate relative luminance for WCAG contrast ratio
+ * https://www.w3.org/TR/WCAG20/#relativeluminancedef
+ */
+function getRelativeLuminance(r, g, b) {
+    const normalize = (c) => {
+        const sRGB = c / 255;
+        return sRGB <= 0.03928 ? sRGB / 12.92 : Math.pow((sRGB + 0.055) / 1.055, 2.4);
+    };
+    const rs = normalize(r);
+    const gs = normalize(g);
+    const bs = normalize(b);
+    return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;
+}
+/**
+ * Calculate WCAG contrast ratio between two colors
+ * https://www.w3.org/TR/WCAG20/#contrast-ratiodef
+ */
+function getContrastRatio(color1, color2) {
+    const l1 = getRelativeLuminance(color1.r, color1.g, color1.b);
+    const l2 = getRelativeLuminance(color2.r, color2.g, color2.b);
+    const lighter = Math.max(l1, l2);
+    const darker = Math.min(l1, l2);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+/**
+ * Parse hex color to RGB
+ */
+function hexToRgb(hex) {
+    const normalized = hex.replace(/^#/, '');
+    // Handle 3-digit hex
+    if (normalized.length === 3) {
+        const [r, g, b] = normalized.split('').map(c => parseInt(c + c, 16));
+        return { r: r, g: g, b: b };
+    }
+    // Handle 6-digit hex
+    if (normalized.length === 6) {
+        const r = parseInt(normalized.substring(0, 2), 16);
+        const g = parseInt(normalized.substring(2, 4), 16);
+        const b = parseInt(normalized.substring(4, 6), 16);
+        return { r, g, b };
+    }
+    return null;
+}
+/**
+ * Parse rgb/rgba string to RGB
+ */
+function parseRgbString(rgbString) {
+    const match = rgbString.match(/rgba?\((\d+),?\s*(\d+),?\s*(\d+)/);
+    if (!match)
+        return null;
+    return {
+        r: parseInt(match[1]),
+        g: parseInt(match[2]),
+        b: parseInt(match[3]),
+    };
+}
+/**
+ * Convert color value to RGB
+ */
+function colorToRgb(color) {
+    if (color.startsWith('#')) {
+        return hexToRgb(color);
+    }
+    if (color.startsWith('rgb')) {
+        return parseRgbString(color);
+    }
+    // Named colors (common ones)
+    const namedColors = {
+        'white': { r: 255, g: 255, b: 255 },
+        'black': { r: 0, g: 0, b: 0 },
+        'red': { r: 255, g: 0, b: 0 },
+        'green': { r: 0, g: 128, b: 0 },
+        'blue': { r: 0, g: 0, b: 255 },
+        'transparent': { r: 255, g: 255, b: 255 }, // Treat as white for contrast purposes
+    };
+    return namedColors[color.toLowerCase()] || null;
+}
 /**
  * Semantic suffixes that represent legitimate separate components.
  * Components with these suffixes are NOT duplicates of their base component.
@@ -473,6 +551,11 @@ export class SemanticDiffEngine {
                     });
                 }
             }
+            // Check for color contrast issues
+            if (options.checkAccessibility) {
+                const contrastIssues = this.checkColorContrast(component);
+                drifts.push(...contrastIssues);
+            }
         }
         // Cross-component checks
         // Check for potential duplicate components
@@ -705,7 +788,8 @@ export class SemanticDiffEngine {
             if (lowerName.endsWith(suffix) &&
                 lowerName.length > suffix.length &&
                 // Ensure the suffix is at a word boundary (e.g., "ButtonGroup" not "Buttong")
-                lowerName[lowerName.length - suffix.length - 1]?.match(/[a-z]/)) {
+                // Use [a-z0-9] to handle names like "Button2Group" where digit precedes suffix
+                lowerName[lowerName.length - suffix.length - 1]?.match(/[a-z0-9]/)) {
                 // This is a compound component, not a duplicate candidate
                 // Return the full name as the base (it's distinct)
                 return { baseName: lowerName, hasVersionSuffix: false };
@@ -932,6 +1016,125 @@ export class SemanticDiffEngine {
         }
         return issues;
     }
+    /**
+     * Check for color contrast issues in component
+     * Detects foreground/background color pairs that fail WCAG contrast ratios
+     */
+    checkColorContrast(component) {
+        const drifts = [];
+        if (!component.metadata.hardcodedValues) {
+            return drifts;
+        }
+        const colorValues = component.metadata.hardcodedValues.filter((h) => h.type === "color");
+        // Look for color/background-color pairs
+        const colorsByProperty = new Map();
+        for (const cv of colorValues) {
+            const prop = cv.property.toLowerCase();
+            if (!colorsByProperty.has(prop)) {
+                colorsByProperty.set(prop, []);
+            }
+            colorsByProperty.get(prop).push(cv);
+        }
+        const foregroundColors = colorsByProperty.get("color") || [];
+        const backgroundColors = colorsByProperty.get("background-color") ||
+            colorsByProperty.get("background") ||
+            [];
+        // Check contrast ratio for each foreground/background pair
+        for (const fg of foregroundColors) {
+            for (const bg of backgroundColors) {
+                const fgRgb = colorToRgb(fg.value);
+                const bgRgb = colorToRgb(bg.value);
+                if (!fgRgb || !bgRgb)
+                    continue;
+                const ratio = getContrastRatio(fgRgb, bgRgb);
+                // WCAG AA requires 4.5:1 for normal text, 3:1 for large text
+                // WCAG AAA requires 7:1 for normal text, 4.5:1 for large text
+                const minRatioAA = 4.5;
+                const minRatioAAA = 7;
+                if (ratio < minRatioAA) {
+                    const level = ratio < 3 ? "WCAG AA and AAA" : "WCAG AAA";
+                    drifts.push({
+                        id: createDriftId("color-contrast", component.id, `${fg.value}-${bg.value}`),
+                        type: "color-contrast",
+                        severity: "critical",
+                        source: this.componentToDriftSource(component),
+                        message: `Component "${component.name}" has insufficient color contrast: ${fg.value} on ${bg.value} (ratio: ${ratio.toFixed(2)}:1)`,
+                        details: {
+                            expected: `Minimum ${minRatioAA}:1 for WCAG AA, ${minRatioAAA}:1 for AAA`,
+                            actual: `${ratio.toFixed(2)}:1`,
+                            suggestions: [
+                                `Fails ${level} - adjust colors to meet minimum ${minRatioAA}:1 ratio`,
+                                "Use a contrast checker tool to find accessible color combinations",
+                                "Consider using design system color tokens with built-in contrast ratios",
+                            ],
+                            affectedFiles: [
+                                `${fg.location}: ${fg.property}: ${fg.value}`,
+                                `${bg.location}: ${bg.property}: ${bg.value}`,
+                            ],
+                        },
+                        detectedAt: new Date(),
+                    });
+                }
+            }
+        }
+        return drifts;
+    }
+    /**
+     * Check for unused components
+     * Components that are defined but never imported/used elsewhere
+     */
+    checkUnusedComponents(components, usageMap) {
+        const drifts = [];
+        for (const component of components) {
+            const usageCount = usageMap.get(component.id) || usageMap.get(component.name) || 0;
+            if (usageCount === 0) {
+                drifts.push({
+                    id: createDriftId("unused-component", component.id),
+                    type: "unused-component",
+                    severity: "warning",
+                    source: this.componentToDriftSource(component),
+                    message: `Component "${component.name}" is defined but never used`,
+                    details: {
+                        suggestions: [
+                            "Remove component if no longer needed",
+                            "Export component if it's part of the public API",
+                            "Add usage in tests or documentation",
+                        ],
+                    },
+                    detectedAt: new Date(),
+                });
+            }
+        }
+        return drifts;
+    }
+    /**
+     * Check for unused tokens
+     * Design tokens that are defined but never referenced
+     */
+    checkUnusedTokens(tokens, usageMap) {
+        const drifts = [];
+        for (const token of tokens) {
+            const usageCount = usageMap.get(token.id) || usageMap.get(token.name) || 0;
+            if (usageCount === 0) {
+                drifts.push({
+                    id: createDriftId("unused-token", token.id),
+                    type: "unused-token",
+                    severity: "info",
+                    source: this.tokenToDriftSource(token),
+                    message: `Token "${token.name}" is defined but never used`,
+                    details: {
+                        suggestions: [
+                            "Remove token if no longer needed",
+                            "Document token for future use",
+                            "Check if token is referenced by name in CSS/JS",
+                        ],
+                    },
+                    detectedAt: new Date(),
+                });
+            }
+        }
+        return drifts;
+    }
     /**
      * Find token suggestions for a hardcoded color value
      * Delegates to TokenSuggestionService