code-auditor-mcp 3.1.1 → 3.4.0

package/dist/styles/tailwindConfigLoader.js

@@ -0,0 +1,374 @@
+/**
+ * Tailwind config loader — Spec 10.
+ *
+ * Loads a project's Tailwind configuration to resolve design tokens
+ * (colors, spacing, font sizes, etc.) for utility expansion.
+ *
+ * Three-tier resolution:
+ *   1. Tailwind v3 JS config (tailwind.config.js / tailwind.config.ts)
+ *   2. Tailwind v4 CSS config (@theme blocks in CSS files)
+ *   3. Bundled default design tokens (Tailwind v4 defaults)
+ *
+ * Falls back gracefully — no config means we use defaults only.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createRequire } from 'node:module';
+// ---------------------------------------------------------------------------
+// Tailwind v4 Default Design Tokens
+// ---------------------------------------------------------------------------
+/**
+ * Bundled Tailwind v4 default design tokens.
+ * This is a simplified subset covering the most-used values.
+ * Full Tailwind v4 theme is massive; we cover the common scales.
+ */
+const DEFAULT_TOKENS = {
+    colors: defaultColorScale(),
+    spacing: defaultSpacingScale(),
+    fontSize: defaultFontSizeScale(),
+    borderRadius: defaultBorderRadiusScale(),
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Load Tailwind config tokens from a project root.
+ * Returns default tokens if no config is found — this is always graceful.
+ */
+export function loadTailwindConfig(projectRoot) {
+    // Tier 1: Tailwind v3 JS config
+    const v3Result = tryLoadV3Config(projectRoot);
+    if (v3Result)
+        return v3Result;
+    // Tier 2: Tailwind v4 CSS config
+    const v4Result = tryLoadV4Config(projectRoot);
+    if (v4Result)
+        return v4Result;
+    // Tier 3: Bundled defaults
+    return {
+        tokens: { ...DEFAULT_TOKENS },
+        source: 'defaults',
+        configPath: null,
+    };
+}
+/**
+ * Get the tokens as StyleToken[] for storage in the style index.
+ */
+export function tokensToStyleTokens(result, projectRoot) {
+    const tokens = [];
+    const configPath = result.configPath ?? 'built-in defaults';
+    for (const [name, value] of Object.entries(result.tokens.colors)) {
+        tokens.push({
+            name: `colors.${name}`,
+            value,
+            filePath: configPath,
+            mechanism: 'tailwind-theme',
+        });
+    }
+    for (const [name, value] of Object.entries(result.tokens.spacing)) {
+        tokens.push({
+            name: `spacing.${name}`,
+            value,
+            filePath: configPath,
+            mechanism: 'tailwind-theme',
+        });
+    }
+    for (const [name, value] of Object.entries(result.tokens.fontSize)) {
+        tokens.push({
+            name: `fontSize.${name}`,
+            value,
+            filePath: configPath,
+            mechanism: 'tailwind-theme',
+        });
+    }
+    for (const [name, value] of Object.entries(result.tokens.borderRadius)) {
+        tokens.push({
+            name: `borderRadius.${name}`,
+            value,
+            filePath: configPath,
+            mechanism: 'tailwind-theme',
+        });
+    }
+    return tokens;
+}
+// ---------------------------------------------------------------------------
+// Tier 1: v3 JS config
+// ---------------------------------------------------------------------------
+function tryLoadV3Config(projectRoot) {
+    const candidates = [
+        'tailwind.config.js',
+        'tailwind.config.ts',
+        'tailwind.config.cjs',
+        'tailwind.config.mjs',
+    ];
+    for (const candidate of candidates) {
+        const configPath = join(projectRoot, candidate);
+        if (!existsSync(configPath))
+            continue;
+        try {
+            const tokens = loadV3ConfigFile(configPath);
+            if (tokens) {
+                return { tokens, source: 'v3-js', configPath };
+            }
+        }
+        catch {
+            // Silently fall through — config exists but can't be parsed
+        }
+    }
+    return null;
+}
+function loadV3ConfigFile(configPath) {
+    try {
+        // Dynamic require to load the config module
+        const require = createRequire(import.meta.url);
+        const config = require(configPath);
+        // Handle default exports
+        const resolved = config.default ?? config;
+        if (!resolved || !resolved.theme)
+            return null;
+        const theme = resolved.theme;
+        const extend = theme.extend ?? {};
+        // Merge extend over theme
+        return {
+            colors: mergeThemeConfig(theme.colors ?? {}, extend.colors ?? {}),
+            spacing: mergeThemeConfig(resolveSpacing(theme.spacing), resolveSpacing(extend.spacing)),
+            fontSize: mergeThemeConfig(theme.fontSize ?? {}, extend.fontSize ?? {}),
+            borderRadius: mergeThemeConfig(theme.borderRadius ?? {}, extend.borderRadius ?? {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Tier 2: v4 CSS config
+// ---------------------------------------------------------------------------
+function tryLoadV4Config(projectRoot) {
+    // Tailwind v4 typically uses app.css or globals.css with @theme
+    const candidates = [
+        'app/globals.css',
+        'src/app/globals.css',
+        'app.css',
+        'src/styles/globals.css',
+        'styles/globals.css',
+        'globals.css',
+    ];
+    for (const candidate of candidates) {
+        const configPath = join(projectRoot, candidate);
+        if (!existsSync(configPath))
+            continue;
+        try {
+            const content = readFileSync(configPath, 'utf-8');
+            const tokens = parseV4ThemeBlocks(content);
+            // Only return if we actually found @theme directives
+            if (tokens.colors.size > 0 || tokens.spacing.size > 0 ||
+                tokens.fontSize.size > 0 || tokens.borderRadius.size > 0) {
+                return {
+                    tokens: {
+                        colors: Object.fromEntries(tokens.colors),
+                        spacing: Object.fromEntries(tokens.spacing),
+                        fontSize: Object.fromEntries(tokens.fontSize),
+                        borderRadius: Object.fromEntries(tokens.borderRadius),
+                    },
+                    source: 'v4-css',
+                    configPath,
+                };
+            }
+        }
+        catch {
+            // Silently continue
+        }
+    }
+    return null;
+}
+function parseV4ThemeBlocks(css) {
+    const tokens = {
+        colors: new Map(),
+        spacing: new Map(),
+        fontSize: new Map(),
+        borderRadius: new Map(),
+    };
+    // Match @theme { ... } blocks
+    const themeRegex = /@theme\s*\{([^}]*(?:\{[^}]*\}[^}]*)*)\}/g;
+    let match;
+    while ((match = themeRegex.exec(css)) !== null) {
+        const block = match[1];
+        // Parse individual declarations: --key: value;
+        const declRegex = /--([a-zA-Z0-9_-]+)\s*:\s*([^;]+);/g;
+        let declMatch;
+        while ((declMatch = declRegex.exec(block)) !== null) {
+            const name = declMatch[1].trim();
+            const value = declMatch[2].trim();
+            // Classify the token by naming convention
+            if (name.startsWith('color-') || name === 'colors') {
+                const colorName = name.startsWith('color-') ? name.slice(6) : name;
+                tokens.colors.set(colorName, value);
+            }
+            else if (name.startsWith('spacing-') || name.endsWith('-spacing')) {
+                const spaceName = name.startsWith('spacing-') ? name.slice(8) : name;
+                tokens.spacing.set(spaceName, value);
+            }
+            else if (name.startsWith('font-size-') || name.endsWith('-font-size')) {
+                const fontSizeName = name.startsWith('font-size-') ? name.slice(10) : name;
+                tokens.fontSize.set(fontSizeName, value);
+            }
+            else if (name.startsWith('radius-') || name.endsWith('-radius')) {
+                const radiusName = name.startsWith('radius-') ? name.slice(7) : name;
+                tokens.borderRadius.set(radiusName, value);
+            }
+            // Many v4 themes use dotted notation: --color-blue-500, --spacing-4
+            if (name.startsWith('color-')) {
+                const colorName = name.slice(6);
+                tokens.colors.set(colorName, value);
+            }
+        }
+        // Re-parse: dotted notation like --color-blue-500, --color-red-400
+        resetLastIndex(declRegex);
+        while ((declMatch = declRegex.exec(block)) !== null) {
+            const name = declMatch[1].trim();
+            const value = declMatch[2].trim();
+            if (name.startsWith('color-')) {
+                const colorName = name.slice(6);
+                if (!tokens.colors.has(colorName)) {
+                    tokens.colors.set(colorName, value);
+                }
+            }
+        }
+    }
+    return tokens;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function mergeThemeConfig(base, extend) {
+    const merged = {};
+    for (const [key, value] of Object.entries(base)) {
+        if (typeof value === 'string') {
+            merged[key] = value;
+        }
+        else if (typeof value === 'object' && value !== null) {
+            // Nested objects like colors: { blue: { 500: '#...' } }
+            flattenNested(key, value, merged);
+        }
+    }
+    for (const [key, value] of Object.entries(extend)) {
+        if (typeof value === 'string') {
+            merged[key] = value;
+        }
+        else if (typeof value === 'object' && value !== null) {
+            flattenNested(key, value, merged);
+        }
+    }
+    return merged;
+}
+function flattenNested(prefix, obj, out) {
+    for (const [key, value] of Object.entries(obj)) {
+        if (typeof value === 'string') {
+            // Handle DEFAULT key: "DEFAULT": "#fff" → out["blue"] = "#fff"
+            if (key === 'DEFAULT') {
+                out[prefix] = value;
+            }
+            else {
+                out[`${prefix}.${key}`] = value;
+            }
+        }
+        else if (typeof value === 'object' && value !== null) {
+            // Nested object: { blue: { 500: '#...', 600: '#...' } }
+            flattenNested(`${prefix}.${key}`, value, out);
+        }
+    }
+}
+function resolveSpacing(spacing) {
+    if (!spacing)
+        return {};
+    if (typeof spacing === 'function') {
+        // Spacing in Tailwind v3 can be a function
+        try {
+            return spacing();
+        }
+        catch {
+            return {};
+        }
+    }
+    return spacing;
+}
+function resetLastIndex(regex) {
+    regex.lastIndex = 0;
+}
+// ---------------------------------------------------------------------------
+// Bundled Defaults
+// ---------------------------------------------------------------------------
+function defaultColorScale() {
+    // Tailwind v4 default color palette (subset — core grays + popular hues)
+    return {
+        'white': '#ffffff',
+        'black': '#000000',
+        'transparent': 'transparent',
+        'current': 'currentColor',
+        // Slate
+        'slate.50': '#f8fafc', 'slate.100': '#f1f5f9', 'slate.200': '#e2e8f0',
+        'slate.300': '#cbd5e1', 'slate.400': '#94a3b8', 'slate.500': '#64748b',
+        'slate.600': '#475569', 'slate.700': '#334155', 'slate.800': '#1e293b',
+        'slate.900': '#0f172a', 'slate.950': '#020617',
+        // Gray
+        'gray.50': '#f9fafb', 'gray.100': '#f3f4f6', 'gray.200': '#e5e7eb',
+        'gray.300': '#d1d5db', 'gray.400': '#9ca3af', 'gray.500': '#6b7280',
+        'gray.600': '#4b5563', 'gray.700': '#374151', 'gray.800': '#1f2937',
+        'gray.900': '#111827', 'gray.950': '#030712',
+        // Red
+        'red.50': '#fef2f2', 'red.100': '#fee2e2', 'red.200': '#fecaca',
+        'red.300': '#fca5a5', 'red.400': '#f87171', 'red.500': '#ef4444',
+        'red.600': '#dc2626', 'red.700': '#b91c1c', 'red.800': '#991b1b',
+        'red.900': '#7f1d1d', 'red.950': '#450a0a',
+        // Blue
+        'blue.50': '#eff6ff', 'blue.100': '#dbeafe', 'blue.200': '#bfdbfe',
+        'blue.300': '#93c5fd', 'blue.400': '#60a5fa', 'blue.500': '#3b82f6',
+        'blue.600': '#2563eb', 'blue.700': '#1d4ed8', 'blue.800': '#1e40af',
+        'blue.900': '#1e3a8a', 'blue.950': '#172554',
+        // Green
+        'green.50': '#f0fdf4', 'green.100': '#dcfce7', 'green.200': '#bbf7d0',
+        'green.300': '#86efac', 'green.400': '#4ade80', 'green.500': '#22c55e',
+        'green.600': '#16a34a', 'green.700': '#15803d', 'green.800': '#166534',
+        'green.900': '#14532d', 'green.950': '#052e16',
+        // Yellow
+        'yellow.50': '#fefce8', 'yellow.100': '#fef9c3', 'yellow.200': '#fef08a',
+        'yellow.300': '#fde047', 'yellow.400': '#facc15', 'yellow.500': '#eab308',
+        'yellow.600': '#ca8a04', 'yellow.700': '#a16207', 'yellow.800': '#854d0e',
+        'yellow.900': '#713f12', 'yellow.950': '#422006',
+        // Indigo
+        'indigo.50': '#eef2ff', 'indigo.100': '#e0e7ff', 'indigo.200': '#c7d2fe',
+        'indigo.300': '#a5b4fc', 'indigo.400': '#818cf8', 'indigo.500': '#6366f1',
+        'indigo.600': '#4f46e5', 'indigo.700': '#4338ca', 'indigo.800': '#3730a3',
+        'indigo.900': '#312e81', 'indigo.950': '#1e1b4b',
+    };
+}
+function defaultSpacingScale() {
+    // Tailwind spacing scale (px values)
+    return {
+        '0': '0px', 'px': '1px', '0.5': '2px',
+        '1': '4px', '2': '8px', '3': '12px', '4': '16px',
+        '5': '20px', '6': '24px', '7': '28px', '8': '32px',
+        '9': '36px', '10': '40px', '11': '44px', '12': '48px',
+        '14': '56px', '16': '64px', '20': '80px', '24': '96px',
+        '28': '112px', '32': '128px', '36': '144px', '40': '160px',
+        '44': '176px', '48': '192px', '52': '208px', '56': '224px',
+        '60': '240px', '64': '256px', '72': '288px', '80': '320px',
+        '96': '384px',
+    };
+}
+function defaultFontSizeScale() {
+    return {
+        'xs': '12px', 'sm': '14px', 'base': '16px',
+        'lg': '18px', 'xl': '20px', '2xl': '24px',
+        '3xl': '30px', '4xl': '36px', '5xl': '48px',
+        '6xl': '60px', '7xl': '72px', '8xl': '96px', '9xl': '128px',
+    };
+}
+function defaultBorderRadiusScale() {
+    return {
+        'none': '0px', 'sm': '2px', '': '4px', 'DEFAULT': '4px',
+        'md': '6px', 'lg': '8px', 'xl': '12px', '2xl': '16px',
+        '3xl': '24px', 'full': '9999px',
+    };
+}
+//# sourceMappingURL=tailwindConfigLoader.js.map

package/dist/styles/tailwindConfigLoader.js.map

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

package/dist/styles/tailwindExpander.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Tailwind utility class expander — Spec 10.
+ *
+ * Expands Tailwind utility classes into normalized CSS declarations.
+ * Uses design tokens from the config loader for value resolution.
+ *
+ * Three-tier resolution for values:
+ *   1. Arbitrary values: mt-[17px] → margin-top: 17px
+ *   2. Theme tokens: bg-blue-500 → background-color: #3b82f6
+ *   3. Fixed scale: rounded-lg → border-radius: 8px
+ */
+import type { NormalizedDeclaration } from './types.js';
+import type { TailwindThemeTokens } from './tailwindConfigLoader.js';
+/**
+ * Expand a single Tailwind utility class into normalized declarations.
+ *
+ * @param className - The utility class (e.g. "bg-blue-500", "mt-4", "hover:bg-red-500")
+ * @param tokens - Theme tokens from config loader (or defaults)
+ * @param filePath - Source file path (for the declaration)
+ * @param line - Line number (for the declaration)
+ * @returns Array of NormalizedDeclaration, or empty if the class can't be expanded.
+ */
+export declare function expandUtility(className: string, tokens: TailwindThemeTokens, filePath: string, line: number): NormalizedDeclaration[];
+/**
+ * Expand variant-prefixed declarations by applying variantContext.
+ * This is a convenience wrapper that first expands the utility, then
+ * applies the variant context.
+ *
+ * @param variantPrefix - e.g. "hover", "sm:dark"
+ * @param declarations - Declarations to apply the variant to
+ */
+export declare function expandVariant(variantPrefix: string, declarations: NormalizedDeclaration[]): NormalizedDeclaration[];
+/**
+ * Heuristic check: does this class name look like a Tailwind utility?
+ * Used to skip non-utility class names without attempting expansion.
+ */
+export declare function looksLikeTailwind(className: string): boolean;
+//# sourceMappingURL=tailwindExpander.d.ts.map

package/dist/styles/tailwindExpander.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwindExpander.d.ts","sourceRoot":"","sources":["../../src/styles/tailwindExpander.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAmC,MAAM,YAAY,CAAC;AAEzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAkNrE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,qBAAqB,EAAE,CAqBzB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,qBAAqB,EAAE,GACpC,qBAAqB,EAAE,CAQzB;AAmeD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAe5D"}