@buoy-design/core 0.1.3 → 0.1.5

package/dist/fix/generator.js

@@ -0,0 +1,250 @@
+/**
+ * Fix Generator
+ *
+ * Generates Fix objects from DriftSignals by matching hardcoded values to design tokens.
+ */
+import { createFixId, meetsConfidenceThreshold } from '../models/fix.js';
+import { scoreConfidence } from './confidence.js';
+/**
+ * Supported fix types for V1
+ */
+const SUPPORTED_FIX_TYPES = [
+    'hardcoded-color',
+    'hardcoded-spacing',
+    'hardcoded-radius',
+    'hardcoded-font-size',
+];
+/**
+ * Generate fixes from drift signals
+ */
+export function generateFixes(drifts, tokens, options = {}) {
+    const { types = [...SUPPORTED_FIX_TYPES], minConfidence = 'low', includeFiles = [], excludeFiles = [], } = options;
+    const fixes = [];
+    for (const drift of drifts) {
+        // Filter by drift type
+        if (!isSupportedFixType(drift.type))
+            continue;
+        if (!types.includes(drift.type))
+            continue;
+        // Filter by file patterns
+        const file = drift.source.location?.split(':')[0] || '';
+        if (!matchesFilePatterns(file, includeFiles, excludeFiles))
+            continue;
+        // Try to generate a fix
+        const fix = generateFixForDrift(drift, tokens);
+        if (!fix)
+            continue;
+        // Filter by confidence
+        if (!meetsConfidenceThreshold(fix.confidence, minConfidence))
+            continue;
+        fixes.push(fix);
+    }
+    // Sort by confidence (high first) then by file
+    return fixes.sort((a, b) => {
+        const confidenceOrder = { high: 0, medium: 1, low: 2 };
+        const confDiff = confidenceOrder[a.confidence] - confidenceOrder[b.confidence];
+        if (confDiff !== 0)
+            return confDiff;
+        return a.file.localeCompare(b.file);
+    });
+}
+/**
+ * Generate a fix for a single drift signal
+ */
+function generateFixForDrift(drift, tokens) {
+    // Extract the hardcoded value from drift details
+    const hardcodedValue = getHardcodedValue(drift);
+    if (!hardcodedValue)
+        return null;
+    // Find the best matching token
+    const match = findBestTokenMatch(hardcodedValue, drift.type, tokens);
+    if (!match)
+        return null;
+    // Parse location
+    const location = parseLocation(drift.source.location);
+    if (!location)
+        return null;
+    // Generate replacement
+    const replacement = generateReplacement(match.token, drift.type);
+    if (!replacement)
+        return null;
+    return {
+        id: createFixId(location.file, location.line, location.column),
+        driftSignalId: drift.id,
+        confidence: match.confidence.level,
+        confidenceScore: match.confidence.score,
+        file: location.file,
+        line: location.line,
+        column: location.column,
+        original: hardcodedValue,
+        replacement,
+        reason: match.confidence.reason,
+        fixType: drift.type,
+        tokenName: match.token.name,
+    };
+}
+/**
+ * Check if drift type is supported for fixing
+ */
+function isSupportedFixType(type) {
+    return SUPPORTED_FIX_TYPES.includes(type);
+}
+/**
+ * Check if file matches include/exclude patterns
+ */
+function matchesFilePatterns(file, includePatterns, excludePatterns) {
+    // If no include patterns, include all
+    if (includePatterns.length > 0) {
+        const included = includePatterns.some((pattern) => simpleGlobMatch(file, pattern));
+        if (!included)
+            return false;
+    }
+    // Check exclude patterns
+    if (excludePatterns.length > 0) {
+        const excluded = excludePatterns.some((pattern) => simpleGlobMatch(file, pattern));
+        if (excluded)
+            return false;
+    }
+    return true;
+}
+/**
+ * Simple glob-like pattern matching
+ * Supports * (any chars except /) and ** (any chars including /)
+ */
+function simpleGlobMatch(file, pattern) {
+    // Convert glob pattern to regex
+    const regexStr = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&') // Escape special regex chars
+        .replace(/\*\*/g, '{{GLOBSTAR}}') // Placeholder for **
+        .replace(/\*/g, '[^/]*') // * matches anything except /
+        .replace(/{{GLOBSTAR}}/g, '.*'); // ** matches anything including /
+    const regex = new RegExp(`^${regexStr}$|/${regexStr}$|^${regexStr}/`);
+    return regex.test(file);
+}
+/**
+ * Extract hardcoded value from drift signal
+ */
+function getHardcodedValue(drift) {
+    // Check details.actual first (the hardcoded value found)
+    if (drift.details?.actual && typeof drift.details.actual === 'string') {
+        return drift.details.actual;
+    }
+    // Try to extract from message
+    // Common patterns: "Found hardcoded color #ffffff", "value '#3b82f6'"
+    const hexMatch = drift.message.match(/#[0-9a-fA-F]{3,8}\b/);
+    if (hexMatch)
+        return hexMatch[0];
+    const rgbMatch = drift.message.match(/rgba?\s*\([^)]+\)/i);
+    if (rgbMatch)
+        return rgbMatch[0];
+    const pxMatch = drift.message.match(/\b\d+(?:\.\d+)?px\b/);
+    if (pxMatch)
+        return pxMatch[0];
+    return null;
+}
+/**
+ * Find the best matching token for a hardcoded value
+ */
+function findBestTokenMatch(value, driftType, tokens) {
+    const relevantTokens = filterTokensByType(tokens, driftType);
+    if (relevantTokens.length === 0)
+        return null;
+    let bestMatch = null;
+    for (const token of relevantTokens) {
+        const confidence = scoreConfidence(value, token, driftType);
+        if (!bestMatch || confidence.score > bestMatch.confidence.score) {
+            bestMatch = { token, confidence };
+        }
+    }
+    // Only return if we have a reasonable match
+    if (bestMatch && bestMatch.confidence.score >= 40) {
+        return bestMatch;
+    }
+    return null;
+}
+/**
+ * Filter tokens by drift type
+ */
+function filterTokensByType(tokens, driftType) {
+    switch (driftType) {
+        case 'hardcoded-color':
+            return tokens.filter((t) => t.category === 'color');
+        case 'hardcoded-spacing':
+        case 'hardcoded-radius':
+            return tokens.filter((t) => t.category === 'spacing');
+        case 'hardcoded-font-size':
+            return tokens.filter((t) => t.category === 'typography' || t.category === 'sizing');
+        default:
+            return [];
+    }
+}
+/**
+ * Generate replacement string for a token
+ */
+function generateReplacement(token, driftType) {
+    // Default to CSS custom property
+    const cssVarName = tokenToCssVar(token.name);
+    switch (driftType) {
+        case 'hardcoded-color':
+            return `var(${cssVarName})`;
+        case 'hardcoded-spacing':
+        case 'hardcoded-radius':
+        case 'hardcoded-font-size':
+            return `var(${cssVarName})`;
+        default:
+            return null;
+    }
+}
+/**
+ * Convert token name to CSS custom property name
+ */
+function tokenToCssVar(name) {
+    // If already has -- prefix, use as-is
+    if (name.startsWith('--'))
+        return name;
+    // Convert camelCase or dot notation to kebab-case
+    const kebab = name
+        .replace(/\./g, '-')
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .toLowerCase();
+    return `--${kebab}`;
+}
+/**
+ * Parse location string into file, line, column
+ */
+function parseLocation(location) {
+    if (!location)
+        return null;
+    // Format: "file/path.tsx:10:5" or "file/path.tsx:10"
+    const match = location.match(/^(.+?):(\d+)(?::(\d+))?$/);
+    if (!match)
+        return null;
+    return {
+        file: match[1],
+        line: parseInt(match[2], 10),
+        column: match[3] ? parseInt(match[3], 10) : 1,
+    };
+}
+/**
+ * Get summary of fixes grouped by type and confidence
+ */
+export function summarizeFixes(fixes) {
+    const byConfidence = {
+        high: 0,
+        medium: 0,
+        low: 0,
+    };
+    const byType = {};
+    for (const fix of fixes) {
+        const conf = fix.confidence;
+        byConfidence[conf] = (byConfidence[conf] || 0) + 1;
+        byType[fix.fixType] = (byType[fix.fixType] || 0) + 1;
+    }
+    return {
+        total: fixes.length,
+        byConfidence,
+        byType,
+        highConfidenceCount: byConfidence.high || 0,
+    };
+}
+//# sourceMappingURL=generator.js.map

package/dist/fix/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/fix/generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,MAAM,mBAAmB,GAAG;IAC1B,iBAAiB;IACjB,mBAAmB;IACnB,kBAAkB;IAClB,qBAAqB;CACb,CAAC;AAIX;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAqB,EACrB,MAAqB,EACrB,UAA+B,EAAE;IAEjC,MAAM,EACJ,KAAK,GAAG,CAAC,GAAG,mBAAmB,CAAC,EAChC,aAAa,GAAG,KAAK,EACrB,YAAY,GAAG,EAAE,EACjB,YAAY,GAAG,EAAE,GAClB,GAAG,OAAO,CAAC;IAEZ,MAAM,KAAK,GAAU,EAAE,CAAC;IAExB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,uBAAuB;QACvB,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QAC9C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAwB,CAAC;YAAE,SAAS;QAE9D,0BAA0B;QAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC;YAAE,SAAS;QAErE,wBAAwB;QACxB,MAAM,GAAG,GAAG,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG;YAAE,SAAS;QAEnB,uBAAuB;QACvB,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC;YAAE,SAAS;QAEvE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,+CAA+C;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACzB,MAAM,eAAe,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACvD,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC/E,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;QACpC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAC1B,KAAkB,EAClB,MAAqB;IAErB,iDAAiD;IACjD,MAAM,cAAc,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAEjC,+BAA+B;IAC/B,MAAM,KAAK,GAAG,kBAAkB,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,iBAAiB;IACjB,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,uBAAuB;IACvB,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACjE,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAE9B,OAAO;QACL,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC;QAC9D,aAAa,EAAE,KAAK,CAAC,EAAE;QACvB,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK;QAClC,eAAe,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK;QACvC,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ,EAAE,cAAc;QACxB,WAAW;QACX,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM;QAC/B,OAAO,EAAE,KAAK,CAAC,IAAsB;QACrC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;KAC5B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,mBAAmB,CAAC,QAAQ,CAAC,IAAwB,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAC1B,IAAY,EACZ,eAAyB,EACzB,eAAyB;IAEzB,sCAAsC;IACtC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAChD,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAC/B,CAAC;QACF,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;IAC9B,CAAC;IAED,yBAAyB;IACzB,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAChD,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAC/B,CAAC;QACF,IAAI,QAAQ;YAAE,OAAO,KAAK,CAAC;IAC7B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,IAAY,EAAE,OAAe;IACpD,gCAAgC;IAChC,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,6BAA6B;SAClE,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,qBAAqB;SACtD,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,8BAA8B;SACtD,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC,kCAAkC;IAErE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,QAAQ,MAAM,QAAQ,MAAM,QAAQ,GAAG,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAkB;IAC3C,yDAAyD;IACzD,IAAI,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,8BAA8B;IAC9B,sEAAsE;IACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC5D,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEjC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC3D,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEjC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC3D,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IAE/B,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CACzB,KAAa,EACb,SAAiB,EACjB,MAAqB;IAErB,MAAM,cAAc,GAAG,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC7D,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7C,IAAI,SAAS,GAGF,IAAI,CAAC;IAEhB,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC5D,IAAI,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YAChE,SAAS,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,IAAI,SAAS,IAAI,SAAS,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CACzB,MAAqB,EACrB,SAAiB;IAEjB,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,iBAAiB;YACpB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;QACtD,KAAK,mBAAmB,CAAC;QACzB,KAAK,kBAAkB;YACrB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;QACxD,KAAK,qBAAqB;YACxB,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,YAAY,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAC9D,CAAC;QACJ;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,KAAkB,EAAE,SAAiB;IAChE,iCAAiC;IACjC,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE7C,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,iBAAiB;YACpB,OAAO,OAAO,UAAU,GAAG,CAAC;QAC9B,KAAK,mBAAmB,CAAC;QACzB,KAAK,kBAAkB,CAAC;QACxB,KAAK,qBAAqB;YACxB,OAAO,OAAO,UAAU,GAAG,CAAC;QAC9B;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,sCAAsC;IACtC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,kDAAkD;IAClD,MAAM,KAAK,GAAG,IAAI;SACf,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,WAAW,EAAE,CAAC;IAEjB,OAAO,KAAK,KAAK,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,QAA4B;IAE5B,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,qDAAqD;IACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE;QACf,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;QAC7B,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY;IAMzC,MAAM,YAAY,GAAoC;QACpD,IAAI,EAAE,CAAC;QACP,MAAM,EAAE,CAAC;QACT,GAAG,EAAE,CAAC;KACP,CAAC;IAEF,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC;QAC5B,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,YAAY;QACZ,MAAM;QACN,mBAAmB,EAAE,YAAY,CAAC,IAAI,IAAI,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/dist/fix/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Fix module - generates and applies fixes for drift signals
+ */
+export { scoreConfidence, scoreColorConfidence, scoreSpacingConfidence } from './confidence.js';
+export type { ConfidenceResult } from './confidence.js';
+export { generateFixes, summarizeFixes } from './generator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fix/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAChG,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/fix/index.js

@@ -0,0 +1,8 @@
+/**
+ * Fix module - generates and applies fixes for drift signals
+ */
+// Re-export confidence scoring
+export { scoreConfidence, scoreColorConfidence, scoreSpacingConfidence } from './confidence.js';
+// Re-export fix generator
+export { generateFixes, summarizeFixes } from './generator.js';
+//# sourceMappingURL=index.js.map

package/dist/fix/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fix/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+BAA+B;AAC/B,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAGhG,0BAA0B;AAC1B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.d.ts

@@ -5,4 +5,5 @@ export * from './tokenization/index.js';
 export * from './plugins/index.js';
 export * from './tokens/index.js';
 export * from './graph/index.js';
+export * from './fix/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAGlC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAGlC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -12,4 +12,6 @@ export * from './plugins/index.js';
 export * from './tokens/index.js';
 // Re-export graph
 export * from './graph/index.js';
+// Re-export fix
+export * from './fix/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,cAAc,mBAAmB,CAAC;AAElC,qBAAqB;AACrB,cAAc,qBAAqB,CAAC;AAEpC,uBAAuB;AACvB,cAAc,uBAAuB,CAAC;AAEtC,yBAAyB;AACzB,cAAc,yBAAyB,CAAC;AAExC,oBAAoB;AACpB,cAAc,oBAAoB,CAAC;AAEnC,0BAA0B;AAC1B,cAAc,mBAAmB,CAAC;AAElC,kBAAkB;AAClB,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,cAAc,mBAAmB,CAAC;AAElC,qBAAqB;AACrB,cAAc,qBAAqB,CAAC;AAEpC,uBAAuB;AACvB,cAAc,uBAAuB,CAAC;AAEtC,yBAAyB;AACzB,cAAc,yBAAyB,CAAC;AAExC,oBAAoB;AACpB,cAAc,oBAAoB,CAAC;AAEnC,0BAA0B;AAC1B,cAAc,mBAAmB,CAAC;AAElC,kBAAkB;AAClB,cAAc,kBAAkB,CAAC;AAEjC,gBAAgB;AAChB,cAAc,gBAAgB,CAAC"}

package/dist/models/fix.d.ts

@@ -0,0 +1,270 @@
+import { z } from 'zod';
+/**
+ * Confidence level for a fix
+ */
+export declare const ConfidenceLevelSchema: z.ZodEnum<["high", "medium", "low"]>;
+export type ConfidenceLevel = z.infer<typeof ConfidenceLevelSchema>;
+/**
+ * A proposed fix for a drift signal
+ */
+export declare const FixSchema: z.ZodObject<{
+    /** Unique identifier for this fix */
+    id: z.ZodString;
+    /** The drift signal this fix addresses */
+    driftSignalId: z.ZodString;
+    /** Confidence level (high = 95%+, medium = 70-94%, low = <70%) */
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    /** Numeric confidence score (0-100) */
+    confidenceScore: z.ZodNumber;
+    /** File path where the fix will be applied */
+    file: z.ZodString;
+    /** Line number (1-indexed) */
+    line: z.ZodNumber;
+    /** Column number (1-indexed) */
+    column: z.ZodNumber;
+    /** Original text to replace */
+    original: z.ZodString;
+    /** Replacement text */
+    replacement: z.ZodString;
+    /** Human-readable reason for this fix */
+    reason: z.ZodString;
+    /** The type of fix */
+    fixType: z.ZodEnum<["hardcoded-color", "hardcoded-spacing", "hardcoded-radius", "hardcoded-font-size"]>;
+    /** Token name being applied (if applicable) */
+    tokenName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    line: number;
+    id: string;
+    reason: string;
+    driftSignalId: string;
+    confidence: "high" | "medium" | "low";
+    confidenceScore: number;
+    file: string;
+    column: number;
+    original: string;
+    replacement: string;
+    fixType: "hardcoded-color" | "hardcoded-spacing" | "hardcoded-radius" | "hardcoded-font-size";
+    tokenName?: string | undefined;
+}, {
+    line: number;
+    id: string;
+    reason: string;
+    driftSignalId: string;
+    confidence: "high" | "medium" | "low";
+    confidenceScore: number;
+    file: string;
+    column: number;
+    original: string;
+    replacement: string;
+    fixType: "hardcoded-color" | "hardcoded-spacing" | "hardcoded-radius" | "hardcoded-font-size";
+    tokenName?: string | undefined;
+}>;
+export type Fix = z.infer<typeof FixSchema>;
+/**
+ * Result of applying a single fix
+ */
+export declare const FixResultSchema: z.ZodObject<{
+    fixId: z.ZodString;
+    status: z.ZodEnum<["applied", "skipped", "failed"]>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "applied" | "skipped" | "failed";
+    fixId: string;
+    error?: string | undefined;
+}, {
+    status: "applied" | "skipped" | "failed";
+    fixId: string;
+    error?: string | undefined;
+}>;
+export type FixResult = z.infer<typeof FixResultSchema>;
+/**
+ * A fix session tracks all fixes applied in one run
+ */
+export declare const FixSessionSchema: z.ZodObject<{
+    /** Unique session identifier */
+    id: z.ZodString;
+    /** When the session started */
+    startedAt: z.ZodDate;
+    /** When the session completed */
+    completedAt: z.ZodOptional<z.ZodDate>;
+    /** All fixes that were considered */
+    fixes: z.ZodArray<z.ZodObject<{
+        /** Unique identifier for this fix */
+        id: z.ZodString;
+        /** The drift signal this fix addresses */
+        driftSignalId: z.ZodString;
+        /** Confidence level (high = 95%+, medium = 70-94%, low = <70%) */
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        /** Numeric confidence score (0-100) */
+        confidenceScore: z.ZodNumber;
+        /** File path where the fix will be applied */
+        file: z.ZodString;
+        /** Line number (1-indexed) */
+        line: z.ZodNumber;
+        /** Column number (1-indexed) */
+        column: z.ZodNumber;
+        /** Original text to replace */
+        original: z.ZodString;
+        /** Replacement text */
+        replacement: z.ZodString;
+        /** Human-readable reason for this fix */
+        reason: z.ZodString;
+        /** The type of fix */
+        fixType: z.ZodEnum<["hardcoded-color", "hardcoded-spacing", "hardcoded-radius", "hardcoded-font-size"]>;
+        /** Token name being applied (if applicable) */
+        tokenName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        line: number;
+        id: string;
+        reason: string;
+        driftSignalId: string;
+        confidence: "high" | "medium" | "low";
+        confidenceScore: number;
+        file: string;
+        column: number;
+        original: string;
+        replacement: string;
+        fixType: "hardcoded-color" | "hardcoded-spacing" | "hardcoded-radius" | "hardcoded-font-size";
+        tokenName?: string | undefined;
+    }, {
+        line: number;
+        id: string;
+        reason: string;
+        driftSignalId: string;
+        confidence: "high" | "medium" | "low";
+        confidenceScore: number;
+        file: string;
+        column: number;
+        original: string;
+        replacement: string;
+        fixType: "hardcoded-color" | "hardcoded-spacing" | "hardcoded-radius" | "hardcoded-font-size";
+        tokenName?: string | undefined;
+    }>, "many">;
+    /** Results for each fix */
+    results: z.ZodArray<z.ZodObject<{
+        fixId: z.ZodString;
+        status: z.ZodEnum<["applied", "skipped", "failed"]>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "applied" | "skipped" | "failed";
+        fixId: string;
+        error?: string | undefined;
+    }, {
+        status: "applied" | "skipped" | "failed";
+        fixId: string;
+        error?: string | undefined;
+    }>, "many">;
+    /** Summary statistics */
+    summary: z.ZodObject<{
+        total: z.ZodNumber;
+        applied: z.ZodNumber;
+        skipped: z.ZodNumber;
+        failed: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        applied: number;
+        skipped: number;
+        failed: number;
+        total: number;
+    }, {
+        applied: number;
+        skipped: number;
+        failed: number;
+        total: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    startedAt: Date;
+    fixes: {
+        line: number;
+        id: string;
+        reason: string;
+        driftSignalId: string;
+        confidence: "high" | "medium" | "low";
+        confidenceScore: number;
+        file: string;
+        column: number;
+        original: string;
+        replacement: string;
+        fixType: "hardcoded-color" | "hardcoded-spacing" | "hardcoded-radius" | "hardcoded-font-size";
+        tokenName?: string | undefined;
+    }[];
+    results: {
+        status: "applied" | "skipped" | "failed";
+        fixId: string;
+        error?: string | undefined;
+    }[];
+    summary: {
+        applied: number;
+        skipped: number;
+        failed: number;
+        total: number;
+    };
+    completedAt?: Date | undefined;
+}, {
+    id: string;
+    startedAt: Date;
+    fixes: {
+        line: number;
+        id: string;
+        reason: string;
+        driftSignalId: string;
+        confidence: "high" | "medium" | "low";
+        confidenceScore: number;
+        file: string;
+        column: number;
+        original: string;
+        replacement: string;
+        fixType: "hardcoded-color" | "hardcoded-spacing" | "hardcoded-radius" | "hardcoded-font-size";
+        tokenName?: string | undefined;
+    }[];
+    results: {
+        status: "applied" | "skipped" | "failed";
+        fixId: string;
+        error?: string | undefined;
+    }[];
+    summary: {
+        applied: number;
+        skipped: number;
+        failed: number;
+        total: number;
+    };
+    completedAt?: Date | undefined;
+}>;
+export type FixSession = z.infer<typeof FixSessionSchema>;
+/**
+ * Options for generating fixes
+ */
+export interface FixGeneratorOptions {
+    /** Filter to specific fix types */
+    types?: Array<Fix['fixType']>;
+    /** Minimum confidence level to include */
+    minConfidence?: ConfidenceLevel;
+    /** File glob patterns to include */
+    includeFiles?: string[];
+    /** File glob patterns to exclude */
+    excludeFiles?: string[];
+}
+/**
+ * Options for applying fixes
+ */
+export interface FixApplyOptions {
+    /** Only show what would be done, don't modify files */
+    dryRun?: boolean;
+    /** Create .bak backup files before modifying */
+    backup?: boolean;
+    /** Minimum confidence level to apply */
+    minConfidence?: ConfidenceLevel;
+}
+/**
+ * Create a unique fix ID
+ */
+export declare function createFixId(file: string, line: number, column: number): string;
+/**
+ * Get confidence level from numeric score
+ */
+export declare function getConfidenceLevel(score: number): ConfidenceLevel;
+/**
+ * Check if a confidence level meets the minimum threshold
+ */
+export declare function meetsConfidenceThreshold(level: ConfidenceLevel, minimum: ConfidenceLevel): boolean;
+//# sourceMappingURL=fix.d.ts.map

package/dist/models/fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.d.ts","sourceRoot":"","sources":["../../src/models/fix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,qBAAqB,sCAAoC,CAAC;AACvE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,qCAAqC;;IAGrC,0CAA0C;;IAG1C,kEAAkE;;IAGlE,uCAAuC;;IAGvC,8CAA8C;;IAG9C,8BAA8B;;IAG9B,gCAAgC;;IAGhC,+BAA+B;;IAG/B,uBAAuB;;IAGvB,yCAAyC;;IAGzC,sBAAsB;;IAQtB,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE/C,CAAC;AAEH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,gCAAgC;;IAGhC,+BAA+B;;IAG/B,iCAAiC;;IAGjC,qCAAqC;;QApErC,qCAAqC;;QAGrC,0CAA0C;;QAG1C,kEAAkE;;QAGlE,uCAAuC;;QAGvC,8CAA8C;;QAG9C,8BAA8B;;QAG9B,gCAAgC;;QAGhC,+BAA+B;;QAG/B,uBAAuB;;QAGvB,yCAAyC;;QAGzC,sBAAsB;;QAQtB,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiC/C,2BAA2B;;;;;;;;;;;;;;IAG3B,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAE9B,0CAA0C;IAC1C,aAAa,CAAC,EAAE,eAAe,CAAC;IAEhC,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,wCAAwC;IACxC,aAAa,CAAC,EAAE,eAAe,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAIjE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,eAAe,GACvB,OAAO,CAOT"}