@buoy-design/core 0.1.8 → 0.1.10

package/dist/analysis/analyzers/prop-analyzer.js

@@ -0,0 +1,130 @@
+/**
+ * Prop Type Analyzer
+ *
+ * Analyzes prop type consistency and naming conventions across components.
+ * Detects inconsistencies where the same prop name uses different types
+ * in different components.
+ */
+import { NAMING_CONFIG } from "../config.js";
+/**
+ * Build a map of prop names to their types across all components
+ */
+export function buildPropTypeMap(components) {
+    const map = new Map();
+    for (const comp of components) {
+        for (const prop of comp.props) {
+            const normalizedName = prop.name.toLowerCase();
+            if (!map.has(normalizedName)) {
+                map.set(normalizedName, { types: new Map(), total: 0 });
+            }
+            const usage = map.get(normalizedName);
+            const typeCount = usage.types.get(prop.type) || {
+                count: 0,
+                examples: [],
+            };
+            typeCount.count++;
+            if (typeCount.examples.length < 3) {
+                typeCount.examples.push(comp.name);
+            }
+            usage.types.set(prop.type, typeCount);
+            usage.total++;
+        }
+    }
+    return map;
+}
+/**
+ * Check if a prop's type conflicts with the dominant type for that prop name
+ */
+export function checkPropTypeConsistency(prop, propTypeMap) {
+    const usage = propTypeMap.get(prop.name.toLowerCase());
+    if (!usage || usage.total < 3)
+        return null; // Not enough data
+    // Find dominant type
+    let dominantType = "";
+    let dominantCount = 0;
+    for (const [type, data] of usage.types) {
+        if (data.count > dominantCount) {
+            dominantType = type;
+            dominantCount = data.count;
+        }
+    }
+    // Only flag if this prop's type differs and dominant exceeds threshold
+    if (prop.type === dominantType)
+        return null;
+    if (dominantCount / usage.total <
+        NAMING_CONFIG.establishedConventionThreshold) {
+        return null;
+    }
+    const examples = usage.types.get(dominantType)?.examples || [];
+    return { dominantType, examples };
+}
+/**
+ * Build a map of semantic prop purposes to their naming patterns
+ */
+export function buildPropNamingMap(components) {
+    const map = new Map();
+    // Group props by semantic purpose
+    const clickHandlers = [];
+    const changeHandlers = [];
+    for (const comp of components) {
+        for (const prop of comp.props) {
+            const lower = prop.name.toLowerCase();
+            if (lower.includes("click") || lower.includes("press")) {
+                clickHandlers.push(prop.name);
+            }
+            if (lower.includes("change")) {
+                changeHandlers.push(prop.name);
+            }
+        }
+    }
+    map.set("click", clickHandlers);
+    map.set("change", changeHandlers);
+    return map;
+}
+/**
+ * Find the dominant prefix pattern in a list of prop names
+ */
+export function findDominantPropPattern(propNames) {
+    const prefixes = {};
+    for (const name of propNames) {
+        if (name.startsWith("on"))
+            prefixes["on"] = (prefixes["on"] || 0) + 1;
+        else if (name.startsWith("handle"))
+            prefixes["handle"] = (prefixes["handle"] || 0) + 1;
+    }
+    let dominant = null;
+    for (const [prefix, count] of Object.entries(prefixes)) {
+        if (!dominant || count > dominant.count) {
+            dominant = { prefix, count };
+        }
+    }
+    return dominant;
+}
+/**
+ * Check prop naming consistency for a component against project patterns
+ */
+export function checkPropNamingConsistency(component, propNamingMap) {
+    const issues = [];
+    for (const prop of component.props) {
+        const lower = prop.name.toLowerCase();
+        // Check click handler naming
+        if (lower.includes("click") || lower.includes("press")) {
+            const allClickHandlers = propNamingMap.get("click") || [];
+            if (allClickHandlers.length >= 5) {
+                const dominant = findDominantPropPattern(allClickHandlers);
+                if (dominant && !prop.name.startsWith(dominant.prefix)) {
+                    const dominantPct = Math.round((dominant.count / allClickHandlers.length) * 100);
+                    if (dominantPct >= 70) {
+                        issues.push({
+                            propName: prop.name,
+                            message: `"${prop.name}" in "${component.name}" - ${dominantPct}% of click handlers use "${dominant.prefix}..." pattern`,
+                            suggestion: `Consider using "${dominant.prefix}${prop.name.replace(/^(on|handle)/i, "")}" for consistency`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=prop-analyzer.js.map

package/dist/analysis/analyzers/prop-analyzer.js.map

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

package/dist/analysis/drift-aggregator.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Drift Aggregator
+ *
+ * Post-processing layer that groups raw drift signals for actionability
+ * while preserving total counts for severity scoring.
+ */
+import type { DriftSignal } from "../models/index.js";
+export interface DriftGroup {
+    /** Unique ID for this group */
+    id: string;
+    /** What grouped these signals together */
+    groupingKey: {
+        strategy: string;
+        value: string;
+    };
+    /** Human-readable summary */
+    summary: string;
+    /** All individual signals (preserved for scoring) */
+    signals: DriftSignal[];
+    /** Quick access counts */
+    totalCount: number;
+    bySeverity: {
+        critical: number;
+        warning: number;
+        info: number;
+    };
+    /** Unified suggestion if all signals share one */
+    commonSuggestion?: string;
+    /** Representative signal for display */
+    representative: DriftSignal;
+}
+export interface AggregationResult {
+    groups: DriftGroup[];
+    ungrouped: DriftSignal[];
+    totalSignals: number;
+    totalGroups: number;
+    /** Noise reduction metric: 100 signals → 5 groups = 20x */
+    reductionRatio: number;
+}
+export interface GroupingStrategy {
+    /** Unique identifier for this strategy */
+    type: string;
+    /**
+     * Extract a grouping key from a signal.
+     * @returns Grouping key string, or null if strategy doesn't apply
+     */
+    getKey(signal: DriftSignal): string | null;
+    /**
+     * Generate human-readable summary for a group.
+     */
+    summarize(signals: DriftSignal[], key: string): string;
+}
+export type BuiltInStrategyType = "value" | "suggestion" | "path" | "entity";
+export interface AggregatorOptions {
+    /** Strategies to apply, in priority order. First match wins. */
+    strategies?: Array<BuiltInStrategyType | GroupingStrategy>;
+    /** Minimum signals to form a group (default: 2) */
+    minGroupSize?: number;
+    /** Path patterns for path-based grouping */
+    pathPatterns?: string[];
+}
+export declare class DriftAggregator {
+    private strategies;
+    private options;
+    constructor(options?: AggregatorOptions);
+    private resolveStrategy;
+    /**
+     * Aggregate signals into groups.
+     * Returns both grouped and ungrouped for flexible consumption.
+     */
+    aggregate(signals: DriftSignal[]): AggregationResult;
+    private applyStrategy;
+    private createGroup;
+}
+export declare const builtInStrategies: {
+    readonly value: GroupingStrategy;
+    readonly suggestion: GroupingStrategy;
+    readonly path: GroupingStrategy;
+    readonly entity: GroupingStrategy;
+};
+export declare function createStrategy(config: GroupingStrategy): GroupingStrategy;
+//# sourceMappingURL=drift-aggregator.d.ts.map

package/dist/analysis/drift-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-aggregator.d.ts","sourceRoot":"","sources":["../../src/analysis/drift-aggregator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMtD,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,0CAA0C;IAC1C,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAEF,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,OAAO,EAAE,WAAW,EAAE,CAAC;IAEvB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAEhE,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,wCAAwC;IACxC,cAAc,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACxD;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7E,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,UAAU,CAAC,EAAE,KAAK,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAAC;IAE3D,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAgJD,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,OAAO,CAAkD;gBAErD,OAAO,GAAE,iBAAsB;IAgB3C,OAAO,CAAC,eAAe;IAqBvB;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,iBAAiB;IAgCpD,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,WAAW;CAoBpB;AAMD,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAEzE"}

package/dist/analysis/drift-aggregator.js

@@ -0,0 +1,241 @@
+/**
+ * Drift Aggregator
+ *
+ * Post-processing layer that groups raw drift signals for actionability
+ * while preserving total counts for severity scoring.
+ */
+// ============================================================================
+// Built-in Strategies
+// ============================================================================
+const valueStrategy = {
+    type: "value",
+    getKey(signal) {
+        if (signal.type !== "hardcoded-value")
+            return null;
+        const actual = signal.details.actual;
+        if (typeof actual !== "string")
+            return null;
+        return `value:${actual}`;
+    },
+    summarize(signals, key) {
+        const value = key.replace("value:", "");
+        return `${signals.length} components use hardcoded value "${value}"`;
+    },
+};
+const suggestionStrategy = {
+    type: "suggestion",
+    getKey(signal) {
+        const suggestions = signal.details.tokenSuggestions;
+        if (!suggestions?.length)
+            return null;
+        // Parse: "value → tokenName (confidence)"
+        const first = suggestions[0];
+        if (!first)
+            return null;
+        const match = first.match(/→\s*([^\s(]+)/);
+        if (!match)
+            return null;
+        return `suggestion:${match[1]}`;
+    },
+    summarize(signals, key) {
+        const token = key.replace("suggestion:", "");
+        return `${signals.length} issues fixable by using ${token}`;
+    },
+};
+function createPathStrategy(patterns) {
+    return {
+        type: "path",
+        getKey(signal) {
+            const location = signal.source.location;
+            if (!location || !location.includes("/"))
+                return null;
+            // Check configured patterns first
+            for (const pattern of patterns) {
+                if (matchGlob(location, pattern)) {
+                    return `path:${pattern}`;
+                }
+            }
+            // Fallback: group by directory
+            const parts = location.split("/");
+            if (parts.length >= 2) {
+                const dir = parts.slice(0, -1).join("/");
+                return `path:${dir}`;
+            }
+            return null;
+        },
+        summarize(signals, key) {
+            const path = key.replace("path:", "");
+            const types = [...new Set(signals.map((s) => s.type))];
+            return `${signals.length} issues in ${path}/ (${types.join(", ")})`;
+        },
+    };
+}
+const entityStrategy = {
+    type: "entity",
+    getKey(signal) {
+        return `entity:${signal.source.entityId}`;
+    },
+    summarize(signals, _key) {
+        const entityName = signals[0]?.source.entityName ?? "Unknown";
+        const types = [...new Set(signals.map((s) => s.type))];
+        if (types.length === 1) {
+            return `${signals.length} ${types[0]} issues in ${entityName}`;
+        }
+        return `${signals.length} issues in ${entityName} (${types.join(", ")})`;
+    },
+};
+// ============================================================================
+// Helpers
+// ============================================================================
+function matchGlob(path, pattern) {
+    // Convert glob to regex
+    // Use placeholder for ** to avoid single-star replacement affecting it
+    const regex = new RegExp("^" +
+        pattern
+            .replace(/\*\*/g, "<<<GLOBSTAR>>>")
+            .replace(/\*/g, "[^/]*")
+            .replace(/<<<GLOBSTAR>>>/g, ".*") +
+        "$");
+    return regex.test(path);
+}
+function countBySeverity(signals) {
+    const counts = { critical: 0, warning: 0, info: 0 };
+    for (const signal of signals) {
+        counts[signal.severity]++;
+    }
+    return counts;
+}
+function generateGroupId(strategy, key) {
+    // Simple hash for stable IDs
+    const content = `${strategy}:${key}`;
+    let hash = 0;
+    for (let i = 0; i < content.length; i++) {
+        const char = content.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash;
+    }
+    return `group:${strategy}:${Math.abs(hash).toString(16)}`;
+}
+// ============================================================================
+// DriftAggregator
+// ============================================================================
+export class DriftAggregator {
+    strategies;
+    options;
+    constructor(options = {}) {
+        this.options = {
+            minGroupSize: options.minGroupSize ?? 2,
+            pathPatterns: options.pathPatterns ?? [],
+        };
+        // Build strategy list
+        const strategyDefs = options.strategies ?? [
+            "value",
+            "suggestion",
+            "path",
+            "entity",
+        ];
+        this.strategies = strategyDefs.map((s) => this.resolveStrategy(s));
+    }
+    resolveStrategy(strategy) {
+        if (typeof strategy === "object") {
+            return strategy;
+        }
+        switch (strategy) {
+            case "value":
+                return valueStrategy;
+            case "suggestion":
+                return suggestionStrategy;
+            case "path":
+                return createPathStrategy(this.options.pathPatterns);
+            case "entity":
+                return entityStrategy;
+            default:
+                throw new Error(`Unknown strategy: ${strategy}`);
+        }
+    }
+    /**
+     * Aggregate signals into groups.
+     * Returns both grouped and ungrouped for flexible consumption.
+     */
+    aggregate(signals) {
+        if (signals.length === 0) {
+            return {
+                groups: [],
+                ungrouped: [],
+                totalSignals: 0,
+                totalGroups: 0,
+                reductionRatio: 1,
+            };
+        }
+        const groups = [];
+        let remaining = [...signals];
+        // Multi-pass: each strategy gets a shot at remaining signals
+        for (const strategy of this.strategies) {
+            const { formed, leftover } = this.applyStrategy(strategy, remaining);
+            groups.push(...formed);
+            remaining = leftover;
+        }
+        const outputCount = groups.length + remaining.length;
+        return {
+            groups,
+            ungrouped: remaining,
+            totalSignals: signals.length,
+            totalGroups: groups.length,
+            reductionRatio: outputCount > 0 ? signals.length / outputCount : 1,
+        };
+    }
+    applyStrategy(strategy, signals) {
+        const buckets = new Map();
+        const noKey = [];
+        for (const signal of signals) {
+            const key = strategy.getKey(signal);
+            if (key) {
+                const bucket = buckets.get(key) ?? [];
+                bucket.push(signal);
+                buckets.set(key, bucket);
+            }
+            else {
+                noKey.push(signal);
+            }
+        }
+        const formed = [];
+        const leftover = [...noKey];
+        for (const [key, bucket] of buckets) {
+            if (bucket.length >= this.options.minGroupSize) {
+                formed.push(this.createGroup(strategy, key, bucket));
+            }
+            else {
+                leftover.push(...bucket);
+            }
+        }
+        return { formed, leftover };
+    }
+    createGroup(strategy, key, signals) {
+        const keyValue = key.includes(":") ? key.split(":").slice(1).join(":") : key;
+        return {
+            id: generateGroupId(strategy.type, key),
+            groupingKey: {
+                strategy: strategy.type,
+                value: keyValue,
+            },
+            summary: strategy.summarize(signals, key),
+            signals,
+            totalCount: signals.length,
+            bySeverity: countBySeverity(signals),
+            representative: signals[0],
+        };
+    }
+}
+// ============================================================================
+// Exports for extensibility
+// ============================================================================
+export const builtInStrategies = {
+    value: valueStrategy,
+    suggestion: suggestionStrategy,
+    path: createPathStrategy([]),
+    entity: entityStrategy,
+};
+export function createStrategy(config) {
+    return config;
+}
+//# sourceMappingURL=drift-aggregator.js.map

package/dist/analysis/drift-aggregator.js.map

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

package/dist/analysis/index.d.ts

@@ -3,4 +3,5 @@ export { TokenSuggestionService, type TokenSuggestion, } from "./token-suggestio
 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";
+export { DriftAggregator, createStrategy, builtInStrategies, type DriftGroup, type AggregationResult, type GroupingStrategy, type AggregatorOptions, type BuiltInStrategyType, } from "./drift-aggregator.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;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"}
+{"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;AAGpB,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/analysis/index.js

@@ -7,4 +7,6 @@ export { stringSimilarity, levenshteinDistance, normalizeForComparison, } from "
 export { MATCHING_CONFIG, NAMING_CONFIG, TOKEN_SUGGESTION_CONFIG, SCANNER_CONFIG, getOutlierThreshold, } from "./config.js";
 // Audit report
 export { generateAuditReport, findCloseMatches, calculateHealthScore, } from "./audit.js";
+// Drift aggregation
+export { DriftAggregator, createStrategy, builtInStrategies, } from "./drift-aggregator.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;AAErB,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GAMrB,MAAM,YAAY,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;AAEpB,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,GAMlB,MAAM,uBAAuB,CAAC"}

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

@@ -1,6 +1,14 @@
+/**
+ * Semantic Diff Engine
+ *
+ * Orchestrates design drift detection by coordinating specialized analyzers.
+ * This is the main entry point for comparing components and detecting issues.
+ */
 import type { Component, DesignToken, DriftSignal, Severity } from "../models/index.js";
 import { type TokenSuggestion } from "./token-suggestions.js";
+import { SEMANTIC_COMPONENT_SUFFIXES, VERSION_SUFFIXES_PATTERN } from "./analyzers/duplicate-detector.js";
 export type { TokenSuggestion } from "./token-suggestions.js";
+export { SEMANTIC_COMPONENT_SUFFIXES, VERSION_SUFFIXES_PATTERN };
 export interface ComponentMatch {
     source: Component;
     target: Component;
@@ -42,7 +50,6 @@ export interface AnalysisOptions {
         components?: RegExp;
         tokens?: RegExp;
     };
-    /** Available design tokens to suggest as replacements for hardcoded values */
     availableTokens?: DesignToken[];
 }
 export interface FrameworkInfo {
@@ -53,17 +60,8 @@ export declare class SemanticDiffEngine {
     private nameCache;
     private componentMetadataCache;
     private tokenSuggestionService;
-    /**
-     * Cached version of normalizeComponentName to avoid repeated string operations
-     */
     private cachedNormalizeName;
-    /**
-     * Get pre-computed component metadata for faster similarity calculations
-     */
     private getComponentMetadata;
-    /**
-     * Clear caches to prevent memory leaks between operations
-     */
     private clearCaches;
     /**
      * Check for framework sprawl - multiple UI frameworks in one codebase
@@ -71,7 +69,6 @@ export declare class SemanticDiffEngine {
     checkFrameworkSprawl(frameworks: FrameworkInfo[]): DriftSignal | null;
     /**
      * Compare components from different sources (e.g., React vs Figma)
-     * Optimized with Map-based indexing for O(n+m) instead of O(n×m)
      */
     compareComponents(sourceComponents: Component[], targetComponents: Component[], options?: DiffOptions): SemanticDiffResult;
     /**
@@ -84,78 +81,33 @@ export declare class SemanticDiffEngine {
     analyzeComponents(components: Component[], options?: AnalysisOptions): {
         drifts: DriftSignal[];
     };
-    /**
-     * Detect the dominant naming patterns in the codebase
-     */
-    private detectNamingPatterns;
-    private identifyNamingPattern;
-    private checkNamingConsistency;
-    /**
-     * Build a map of prop names to their types across all components
-     */
-    private buildPropTypeMap;
-    private checkPropTypeConsistency;
-    /**
-     * Build a map of semantic prop purposes to their naming patterns
-     */
-    private buildPropNamingMap;
-    private checkPropNamingConsistency;
-    private findDominantPropPattern;
-    /**
-     * Detect potential duplicate components based on similar names.
-     * Only flags true duplicates like Button vs ButtonNew or Card vs CardLegacy.
-     * Does NOT flag compound components like Button vs ButtonGroup or Card vs CardHeader.
-     */
-    private detectPotentialDuplicates;
-    /**
-     * Extract the base name from a component name, stripping version suffixes.
-     * Returns whether the name had a version suffix (indicating potential duplicate).
-     */
-    private extractBaseName;
-    private createMatch;
-    private findBestMatch;
-    private calculateSimilarity;
-    private stringSimilarity;
-    private findDifferences;
-    private generateComponentDrifts;
-    private componentToDriftSource;
-    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
-     */
     findColorTokenSuggestions(hardcodedValue: string, tokens: DesignToken[], maxSuggestions?: number): TokenSuggestion[];
-    /**
-     * Find token suggestions for a hardcoded spacing value
-     * Delegates to TokenSuggestionService
-     */
     findSpacingTokenSuggestions(hardcodedValue: string, tokens: DesignToken[], maxSuggestions?: number): TokenSuggestion[];
-    /**
-     * Generate actionable suggestions for hardcoded values
-     * Delegates to TokenSuggestionService
-     */
     generateTokenSuggestions(hardcodedValues: Array<{
         type: string;
         value: string;
         property: string;
         location: string;
     }>, tokens: DesignToken[]): Map<string, TokenSuggestion[]>;
+    private analyzeHardcodedValues;
+    private createDeprecatedDrift;
+    private createNamingDrift;
+    private createPropTypeDrift;
+    private createMatch;
+    private findBestMatch;
+    private calculateSimilarity;
+    private findDifferences;
+    private generateComponentDrifts;
+    private componentToDriftSource;
+    private tokenToDriftSource;
+    private getHighestSeverity;
 }
 //# sourceMappingURL=semantic-diff.d.ts.map

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":"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"}
+{"version":3,"file":"semantic-diff.d.ts","sourceRoot":"","sources":["../../src/analysis/semantic-diff.ts"],"names":[],"mappings":"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"}