@buoy-design/cli 0.3.28 → 0.3.30

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

@@ -112,11 +112,20 @@ export declare function applySeverityOverrides(drifts: DriftSignal[], overrides:
  */
 export declare class DriftAnalysisService {
     private config;
-    constructor(config: BuoyConfig);
+    private projectRoot;
+    constructor(config: BuoyConfig, projectRoot?: string);
     /**
      * Run full drift analysis pipeline
      */
     analyze(options?: DriftAnalysisOptions): Promise<DriftAnalysisResult>;
+    private getUsageCollectorGlobs;
+    private applyTailwindConfigAliasUsages;
+    private resolveTailwindSemanticAliasMap;
+    private findTailwindConfigFile;
+    private extractLocalImportSpecifiers;
+    private resolveLocalImport;
+    private extractTailwindColorAliasesFromSource;
+    private extractTailwindClassTokens;
     /**
      * Scan barrel files (index.ts) for re-exports and count re-exported components as used.
      * Components re-exported from barrel files are part of the public API.

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

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

package/dist/services/drift-analysis.js

@@ -15,7 +15,8 @@ import { detectRepeatedPatterns, checkVariantConsistency, checkExampleCompliance
 import { glob } from "glob";
 import { minimatch } from "minimatch";
 import { readFile } from "fs/promises";
-import { resolve } from "path";
+import { existsSync } from "fs";
+import { dirname, extname, resolve } from "path";
 /**
  * Severity order for filtering and sorting (0 = lowest, 2 = highest)
  * Use getSeverityWeight from @buoy-design/core for consistent ordering
@@ -149,6 +150,118 @@ function ruleMatches(d, rule, onWarning) {
     }
     return true;
 }
+function extractTailwindSemanticTokenNameLocal(classToken) {
+    const core = classToken.split(":").pop()?.trim() ?? "";
+    if (!core)
+        return null;
+    const normalizedCore = core.replace(/^!/, "").replace(/^-/, "");
+    if (!normalizedCore)
+        return null;
+    const withoutOpacity = normalizedCore.replace(/\/[a-zA-Z0-9.[\]-]+$/, "");
+    const match = withoutOpacity.match(/^(?:bg|text|border|ring|fill|stroke|outline|caret|accent|from|via|to)-([a-zA-Z0-9_-]+)$/);
+    if (!match?.[1])
+        return null;
+    const value = match[1];
+    if (/^(transparent|current|black|white|inherit)$/.test(value) ||
+        /^[a-z]+-\d{2,3}$/.test(value) ||
+        /^\[[^\]]+\]$/.test(value)) {
+        return null;
+    }
+    return value;
+}
+function extractNamedObjectBlocks(content, key) {
+    const results = [];
+    const patterns = [
+        new RegExp(`${key}\\s*:\\s*\\{`, "g"),
+        new RegExp(`['"]${key}['"]\\s*:\\s*\\{`, "g"),
+    ];
+    for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            const openBraceIndex = match.index + match[0].length - 1;
+            const block = extractBalancedBracesContent(content, openBraceIndex);
+            if (block != null)
+                results.push(block);
+        }
+    }
+    return results;
+}
+function extractBalancedBracesContent(content, openBraceIndex) {
+    if (content[openBraceIndex] !== "{")
+        return null;
+    let depth = 0;
+    for (let i = openBraceIndex; i < content.length; i++) {
+        const ch = content[i];
+        if (ch === "{")
+            depth++;
+        if (ch === "}")
+            depth--;
+        if (depth === 0) {
+            return content.slice(openBraceIndex + 1, i);
+        }
+    }
+    return null;
+}
+function parseColorObjectAliases(colorsBlock) {
+    const aliases = new Map();
+    // First parse one-level nested scales (e.g., surface: { DEFAULT: "var(--surface)" ... })
+    const nestedPattern = /['"]?([a-zA-Z0-9_-]+)['"]?\s*:\s*\{/g;
+    let nestedMatch;
+    while ((nestedMatch = nestedPattern.exec(colorsBlock)) !== null) {
+        const parent = nestedMatch[1];
+        const openBraceIndex = nestedMatch.index + nestedMatch[0].length - 1;
+        const nestedContent = extractBalancedBracesContent(colorsBlock, openBraceIndex);
+        if (!nestedContent)
+            continue;
+        const nestedStart = openBraceIndex;
+        const nestedEnd = nestedStart + nestedContent.length + 2; // braces
+        const kvPattern = /['"]?([a-zA-Z0-9_-]+)['"]?\s*:\s*["'`]([^"'`]+)["'`]/g;
+        let kv;
+        while ((kv = kvPattern.exec(nestedContent)) !== null) {
+            const child = kv[1];
+            const value = kv[2];
+            const refs = extractCssVarRefs(value);
+            if (refs.length === 0)
+                continue;
+            const semantic = child === "DEFAULT" ? parent : `${parent}-${child}`;
+            for (const ref of refs)
+                addAlias(aliases, semantic, ref);
+        }
+        // Skip over nested object contents so top-level string scan doesn't double-process nested entries.
+        nestedPattern.lastIndex = nestedEnd;
+    }
+    // Top-level direct string colors (e.g., background: "var(--surface)")
+    const topLevelPattern = /['"]?([a-zA-Z0-9_-]+)['"]?\s*:\s*["'`]([^"'`]+)["'`]/g;
+    let top;
+    while ((top = topLevelPattern.exec(colorsBlock)) !== null) {
+        const semantic = top[1];
+        const value = top[2];
+        const refs = extractCssVarRefs(value);
+        if (refs.length === 0)
+            continue;
+        for (const ref of refs)
+            addAlias(aliases, semantic, ref);
+    }
+    return aliases;
+}
+function extractCssVarRefs(value) {
+    const refs = [];
+    const pattern = /var\(\s*--([a-zA-Z0-9_-]+)/g;
+    let match;
+    while ((match = pattern.exec(value)) !== null) {
+        if (match[1])
+            refs.push(match[1]);
+    }
+    return refs;
+}
+function addAlias(map, semantic, tokenName) {
+    let bucket = map.get(semantic);
+    if (!bucket) {
+        bucket = new Set();
+        map.set(semantic, bucket);
+    }
+    bucket.add(tokenName);
+}
 /**
  * Apply severity filter to drifts
  */
@@ -211,8 +324,10 @@ function isEntryPointComponent(component) {
  */
 export class DriftAnalysisService {
     config;
-    constructor(config) {
+    projectRoot;
+    constructor(config, projectRoot = process.cwd()) {
         this.config = config;
+        this.projectRoot = projectRoot;
     }
     /**
      * Run full drift analysis pipeline
@@ -221,7 +336,7 @@ export class DriftAnalysisService {
         const { onProgress, includeIgnored, minSeverity, filterType, cache, checkVariants, checkTokenUtilities, checkExamples, } = options;
         // Step 1: Scan components
         onProgress?.("Scanning components...");
-        const orchestrator = new ScanOrchestrator(this.config, process.cwd(), {
+        const orchestrator = new ScanOrchestrator(this.config, this.projectRoot, {
             cache,
         });
         const { components } = await orchestrator.scanComponents({
@@ -245,7 +360,7 @@ export class DriftAnalysisService {
         // Step 2.2: Check framework sprawl
         onProgress?.("Checking for framework sprawl...");
         const { ProjectDetector } = await import("../detect/project-detector.js");
-        const detector = new ProjectDetector(process.cwd());
+        const detector = new ProjectDetector(this.projectRoot);
         const projectInfo = await detector.detect();
         if (projectInfo.frameworks.length > 0) {
             const sprawlDrift = engine.checkFrameworkSprawl(projectInfo.frameworks.map((f) => ({ name: f.name, version: f.version })));
@@ -257,10 +372,13 @@ export class DriftAnalysisService {
         // Step 2.3: Scan for unused components and tokens
         onProgress?.("Scanning for unused components and tokens...");
         const { collectUsages } = await import("@buoy-design/core");
+        const usageGlobs = this.getUsageCollectorGlobs();
         const componentNames = components.map((c) => c.name);
         const tokenNames = scannedTokens.map((t) => t.name);
         const usageResult = await collectUsages({
-            projectRoot: process.cwd(),
+            projectRoot: this.projectRoot,
+            include: usageGlobs.include,
+            exclude: usageGlobs.exclude,
             knownComponents: componentNames,
             knownTokens: tokenNames,
         });
@@ -273,6 +391,9 @@ export class DriftAnalysisService {
         for (const tu of usageResult.tokenUsages) {
             tokenUsageMap.set(tu.tokenName, (tokenUsageMap.get(tu.tokenName) || 0) + 1);
         }
+        // Tailwind semantic aliases may map class names to differently named CSS vars
+        // via imported presets (e.g., bg-background -> var(--surface)).
+        await this.applyTailwindConfigAliasUsages(tokenUsageMap);
         // Fix 2: Count barrel file re-exports as usage
         // Components re-exported from barrel files (index.ts) are part of the public API
         await this.scanBarrelReExports(componentUsageMap);
@@ -348,7 +469,7 @@ export class DriftAnalysisService {
         if (this.config.sources.tailwind?.enabled) {
             onProgress?.("Scanning for Tailwind arbitrary values...");
             const tailwindScanner = new TailwindScanner({
-                projectRoot: process.cwd(),
+                projectRoot: this.projectRoot,
                 include: this.config.sources.tailwind.files,
                 exclude: this.config.sources.tailwind.exclude,
                 detectArbitraryValues: true,
@@ -449,12 +570,195 @@ export class DriftAnalysisService {
             summary: calculateDriftSummary(drifts),
         };
     }
+    getUsageCollectorGlobs() {
+        const include = new Set();
+        const exclude = new Set();
+        const addMany = (target, values) => {
+            if (!values)
+                return;
+            for (const value of values) {
+                if (value?.trim())
+                    target.add(value);
+            }
+        };
+        const { react, nextjs, vue, svelte, angular, webcomponent, templates, tailwind, tokens, } = this.config.sources;
+        for (const source of [react, nextjs, vue, svelte, angular, webcomponent, templates]) {
+            if (!source?.enabled)
+                continue;
+            addMany(include, source.include);
+            addMany(exclude, source.exclude);
+        }
+        if (tailwind?.enabled) {
+            addMany(include, tailwind.files);
+            addMany(exclude, tailwind.exclude);
+        }
+        if (tokens?.enabled) {
+            addMany(include, tokens.files);
+        }
+        return {
+            include: include.size > 0 ? [...include] : undefined,
+            exclude: exclude.size > 0 ? [...exclude] : undefined,
+        };
+    }
+    async applyTailwindConfigAliasUsages(tokenUsageMap) {
+        if (!this.config.sources.tailwind?.enabled)
+            return;
+        const aliasMap = await this.resolveTailwindSemanticAliasMap();
+        if (aliasMap.size === 0)
+            return;
+        const usageGlobs = this.getUsageCollectorGlobs();
+        const include = usageGlobs.include ?? ["**/*.{ts,tsx,js,jsx,vue,svelte,astro,html,mdx,md}"];
+        const exclude = usageGlobs.exclude ?? ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.next/**"];
+        const files = await glob(include, {
+            cwd: this.projectRoot,
+            ignore: exclude,
+            absolute: false,
+            nodir: true,
+        });
+        for (const file of files) {
+            let content = "";
+            try {
+                content = await readFile(resolve(this.projectRoot, file), "utf-8");
+            }
+            catch {
+                continue;
+            }
+            for (const classToken of this.extractTailwindClassTokens(content)) {
+                const semantic = extractTailwindSemanticTokenNameLocal(classToken);
+                if (!semantic)
+                    continue;
+                const mapped = aliasMap.get(semantic);
+                if (!mapped || mapped.size === 0)
+                    continue;
+                for (const tokenName of mapped) {
+                    tokenUsageMap.set(tokenName, (tokenUsageMap.get(tokenName) || 0) + 1);
+                }
+            }
+        }
+    }
+    async resolveTailwindSemanticAliasMap() {
+        const configFile = this.findTailwindConfigFile();
+        if (!configFile)
+            return new Map();
+        const visited = new Set();
+        const queue = [configFile];
+        const aliases = new Map();
+        while (queue.length > 0 && visited.size < 64) {
+            const filePath = queue.shift();
+            if (visited.has(filePath))
+                continue;
+            visited.add(filePath);
+            let content = "";
+            try {
+                content = await readFile(filePath, "utf-8");
+            }
+            catch {
+                continue;
+            }
+            this.extractTailwindColorAliasesFromSource(content, aliases);
+            for (const specifier of this.extractLocalImportSpecifiers(content)) {
+                const resolved = this.resolveLocalImport(filePath, specifier);
+                if (resolved && !visited.has(resolved)) {
+                    queue.push(resolved);
+                }
+            }
+        }
+        return aliases;
+    }
+    findTailwindConfigFile() {
+        for (const name of [
+            "tailwind.config.ts",
+            "tailwind.config.js",
+            "tailwind.config.mjs",
+            "tailwind.config.cjs",
+        ]) {
+            const path = resolve(this.projectRoot, name);
+            if (existsSync(path))
+                return path;
+        }
+        return null;
+    }
+    extractLocalImportSpecifiers(content) {
+        const out = new Set();
+        const patterns = [
+            /import[\s\S]*?\sfrom\s*["']([^"']+)["']/g,
+            /(?:export\s+\{[^}]*\}\s+from|export\s+\*\s+from)\s*["']([^"']+)["']/g,
+            /require\(\s*["']([^"']+)["']\s*\)/g,
+        ];
+        for (const pattern of patterns) {
+            let match;
+            while ((match = pattern.exec(content)) !== null) {
+                const spec = match[1];
+                if (spec?.startsWith("."))
+                    out.add(spec);
+            }
+        }
+        return [...out];
+    }
+    resolveLocalImport(fromFile, specifier) {
+        const base = resolve(dirname(fromFile), specifier);
+        const candidates = extname(base)
+            ? [base]
+            : [
+                base,
+                `${base}.ts`,
+                `${base}.tsx`,
+                `${base}.js`,
+                `${base}.mjs`,
+                `${base}.cjs`,
+                resolve(base, "index.ts"),
+                resolve(base, "index.tsx"),
+                resolve(base, "index.js"),
+                resolve(base, "index.mjs"),
+                resolve(base, "index.cjs"),
+            ];
+        for (const candidate of candidates) {
+            if (existsSync(candidate))
+                return candidate;
+        }
+        return null;
+    }
+    extractTailwindColorAliasesFromSource(content, aliases) {
+        for (const colorsBlock of extractNamedObjectBlocks(content, "colors")) {
+            const parsed = parseColorObjectAliases(colorsBlock);
+            for (const [semantic, tokenNames] of parsed) {
+                let bucket = aliases.get(semantic);
+                if (!bucket) {
+                    bucket = new Set();
+                    aliases.set(semantic, bucket);
+                }
+                for (const tokenName of tokenNames)
+                    bucket.add(tokenName);
+            }
+        }
+    }
+    extractTailwindClassTokens(content) {
+        const classTokens = new Set();
+        // Generic string literal scan catches JSX, Astro, template literals, and utility wrappers.
+        const stringPattern = /(['"`])((?:\\.|(?!\1)[\s\S])*)\1/g;
+        let match;
+        while ((match = stringPattern.exec(content)) !== null) {
+            const raw = match[2];
+            if (!raw || (!raw.includes("-") && !raw.includes(":")))
+                continue;
+            for (const token of raw.split(/\s+/)) {
+                if (token)
+                    classTokens.add(token);
+            }
+        }
+        // Also include extractor output for nested utility helper patterns.
+        for (const extracted of extractStaticClassStrings(content)) {
+            for (const token of extracted.classes)
+                classTokens.add(token);
+        }
+        return [...classTokens];
+    }
     /**
      * Scan barrel files (index.ts) for re-exports and count re-exported components as used.
      * Components re-exported from barrel files are part of the public API.
      */
     async scanBarrelReExports(componentUsageMap) {
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         const barrelFiles = await glob('**/index.{ts,tsx,js,jsx}', {
             cwd,
             ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**'],
@@ -505,7 +809,7 @@ export class DriftAnalysisService {
      * Handles React.lazy(() => import('./Component')) and next/dynamic patterns.
      */
     async scanDynamicImports(componentUsageMap) {
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         const sourceFiles = await glob('**/*.{tsx,jsx,ts,js}', {
             cwd,
             ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**', '**/*.test.*', '**/*.spec.*'],
@@ -542,7 +846,7 @@ export class DriftAnalysisService {
     async scanTemplateComponentUsage(componentUsageMap, knownComponents) {
         if (knownComponents.length === 0)
             return;
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         const templateFiles = await glob('**/*.{vue,svelte,html}', {
             cwd,
             ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**'],
@@ -591,7 +895,7 @@ export class DriftAnalysisService {
      * Detects app.component('Name', ...) and Vue.component('Name', ...) calls.
      */
     async scanAutoRegistration(componentUsageMap) {
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         const sourceFiles = await glob('**/*.{ts,js,tsx,jsx}', {
             cwd,
             ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**'],
@@ -621,7 +925,7 @@ export class DriftAnalysisService {
      * Components in declarations: [...] are registered and should count as used.
      */
     async scanNgModuleDeclarations(componentUsageMap) {
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         const moduleFiles = await glob('**/*.module.ts', {
             cwd,
             ignore: ['**/node_modules/**', '**/dist/**', '**/build/**'],
@@ -666,7 +970,7 @@ export class DriftAnalysisService {
      * A component referenced in a .stories file is documented/tested and should count as used.
      */
     async scanStoryFileUsages(componentUsageMap) {
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         const storyFiles = await glob('**/*.stories.{ts,tsx,js,jsx}', {
             cwd,
             ignore: ['**/node_modules/**', '**/dist/**', '**/build/**'],
@@ -712,7 +1016,7 @@ export class DriftAnalysisService {
      * mean the component is registered and used by the browser.
      */
     async scanWebComponentRegistrations(componentUsageMap) {
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         const files = await glob('**/*.{ts,js}', {
             cwd,
             ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/*.d.ts', '**/*.spec.*', '**/*.test.*'],
@@ -748,7 +1052,7 @@ export class DriftAnalysisService {
      * If we detect Nuxt (nuxt.config.ts exists), mark all components in components/ as used.
      */
     async scanNuxtAutoImports(componentUsageMap, componentNames) {
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         // Check for Nuxt config
         const nuxtConfigs = await glob('nuxt.config.{ts,js,mjs}', { cwd, nodir: true });
         if (nuxtConfigs.length === 0)
@@ -764,7 +1068,7 @@ export class DriftAnalysisService {
      * Components imported in .test.tsx/.spec.tsx are actively maintained/tested.
      */
     async scanTestFileUsages(componentUsageMap) {
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         const testFiles = await glob('**/*.{test,spec}.{ts,tsx,js,jsx}', {
             cwd,
             ignore: ['**/node_modules/**', '**/dist/**', '**/build/**'],
@@ -805,7 +1109,7 @@ export class DriftAnalysisService {
      * compound component patterns like Component.Sub = SubComponent.
      */
     async scanHOCWrapperUsages(componentUsageMap) {
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         const sourceFiles = await glob('**/*.{ts,tsx,js,jsx}', {
             cwd,
             ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**', '**/*.d.ts'],
@@ -878,7 +1182,7 @@ export class DriftAnalysisService {
      * all components re-exported from that barrel are the product's public API.
      */
     async scanPackageExports(componentUsageMap) {
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         try {
             const pkgContent = await readFile(resolve(cwd, 'package.json'), 'utf-8');
             const pkg = JSON.parse(pkgContent);
@@ -949,7 +1253,7 @@ export class DriftAnalysisService {
     async scanComponentAsValueUsages(componentUsageMap, knownComponents) {
         if (knownComponents.length === 0)
             return;
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         const sourceFiles = await glob('**/*.{tsx,jsx,ts,js}', {
             cwd,
             ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**', '**/*.d.ts'],
@@ -987,7 +1291,7 @@ export class DriftAnalysisService {
      */
     async detectRepeatedPatterns(config) {
         const occurrences = [];
-        const cwd = process.cwd();
+        const cwd = this.projectRoot;
         // Find all source files
         const patterns = ["**/*.tsx", "**/*.jsx", "**/*.vue", "**/*.svelte"];
         const ignore = ["**/node_modules/**", "**/dist/**", "**/.next/**", "**/build/**"];