code-auditor-mcp 3.4.1 → 3.4.2

package/dist/styles/tailwindUtilityExpander.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Tailwind Utility Class Expander — Spec 22 R1
+ *
+ * Generates the full set of valid Tailwind utility classes from default theme
+ * scales plus arbitrary-value grammar, variant prefix stripping, and project
+ * config resolution. Replaces the hand-curated ~30-class Set previously in
+ * UniversalStylesAnalyzer.detectUndefinedClasses.
+ *
+ * Fail-open rule (per Spec 22 R1.3): if project Tailwind config resolution
+ * fails, the undefined-class detector disables for that project with one
+ * visible warning naming the failure. A claim that a class "does not exist"
+ * may not ship on a known-incomplete dictionary.
+ */
+/**
+ * Get the full set of bundled Tailwind utility classes.
+ * Generated from the default theme scales plus static utilities.
+ * Cached after first call — callers get the same Set instance.
+ */
+export declare function getBundledUtilityClasses(): Set<string>;
+/**
+ * Result of resolving a Tailwind utility class against the full expansion path.
+ */
+export interface UtilityClassResolution {
+    /** Is this a known/valid utility class? */
+    valid: boolean;
+    /**
+     * Which tier resolved it: 'bundled' (default theme), 'project-config' (project
+     * config resolution), 'arbitrary-value' (matches `prefix-[...]` grammar), or
+     * 'none' (no match).
+     */
+    tier: 'bundled' | 'project-config' | 'arbitrary-value' | 'none';
+}
+/**
+ * Configuration for the Tailwind utility class expansion.
+ */
+export interface TailwindExpanderConfig {
+    /** Project root for loading Tailwind config. */
+    projectRoot?: string;
+    /** If true, load and include project Tailwind config custom classes. */
+    useProjectConfig?: boolean;
+    /** User-supplied class names from project config (use when useProjectConfig
+     *  would fail — the caller pre-resolves and passes them). */
+    customClasses?: Set<string>;
+}
+/**
+ * Tailwind utility class expander.
+ *
+ * Validates a class name against the full expansion path:
+ * 1. Bundled default theme dictionary
+ * 2. Project config custom classes (if resolved)
+ * 3. Arbitrary-value grammar (`prefix-[...]`)
+ * 4. Variant prefix stripping + retry against all of the above
+ *
+ * Fail-open: if project config resolution is requested but fails, the
+ * expander enters fail-open mode where project-config tier is silently
+ * empty. The CALLER is responsible for emitting the visible warning and
+ * potentially disabling the undefined-class detector.
+ */
+export declare class TailwindUtilityExpander {
+    private bundled;
+    private projectClasses;
+    private _configFailed;
+    private _configFailureReason;
+    /**
+     * Initialize the expander with optional project config.
+     * Call once at the start of a project audit.
+     */
+    init(config?: TailwindExpanderConfig): void;
+    /** Did the project config resolution fail? */
+    get configFailed(): boolean;
+    /** Why did project config resolution fail? */
+    get configFailureReason(): string | null;
+    /**
+     * Resolve a single class name against the expansion path.
+     * Returns the highest-priority matching tier, or 'none'.
+     */
+    resolve(className: string): UtilityClassResolution;
+    /**
+     * Check whether a class matches the arbitrary-value grammar:
+     * `{known-prefix}-[...]`
+     */
+    private matchesArbitraryValue;
+    /**
+     * Check the opacity-modifier syntax: `{utility}/{opacity}`.
+     * e.g., `bg-red-500/50` → `bg-red-500` must be a valid utility AND
+     * `50` must be a valid opacity value.
+     *
+     * We split on the LAST `/` to avoid confusing fractional widths
+     * (e.g. `w-1/2`) — those are in the dictionary directly and won't
+     * reach this check.
+     */
+    private checkOpacityModifier;
+    /**
+     * Check a negative utility: `-{prefix}-{value}`.
+     * e.g., `-mt-1`, `-top-2`, `-translate-x-1/2`, `-z-10`.
+     *
+     * Strips the leading `-` and checks whether the remainder is a valid
+     * utility whose prefix is in the negative-allowed set.
+     */
+    private checkNegativeUtility;
+    /**
+     * Strip a Tailwind variant prefix from a class name.
+     * E.g., "hover:bg-blue-500" → "bg-blue-500"
+     * Returns the original if no variant prefix is matched.
+     */
+    stripVariantPrefix(className: string): string;
+    /**
+     * Check if a class has a variant prefix at all.
+     */
+    hasVariantPrefix(className: string): boolean;
+    /** Reset state (useful for testing). */
+    reset(): void;
+}
+export declare function getTailwindExpander(): TailwindUtilityExpander;
+export declare function resetTailwindExpander(): void;
+//# sourceMappingURL=tailwindUtilityExpander.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tailwindUtilityExpander.d.ts","sourceRoot":"","sources":["../../src/styles/tailwindUtilityExpander.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAspBH;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,GAAG,CAAC,MAAM,CAAC,CAgBtD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,IAAI,EAAE,SAAS,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,MAAM,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;iEAC6D;IAC7D,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,oBAAoB,CAAuB;IAEnD;;;OAGG;IACH,IAAI,CAAC,MAAM,GAAE,sBAA2B,GAAG,IAAI,CA6C9C;IAED,8CAA8C;IAC9C,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,8CAA8C;IAC9C,IAAI,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEvC;IAED;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAmCjD;IAED;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;;;OAIG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAO5C;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3C;IAED,wCAAwC;IACxC,KAAK,IAAI,IAAI,CAKZ;CACF;AAKD,wBAAgB,mBAAmB,IAAI,uBAAuB,CAK7D;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}