tailwind-styled-v4 5.0.36 → 5.0.37

package/dist/analyzer.d.mts

@@ -1,7 +1,154 @@
-import { C as ClassToCssOptions, a as ClassToCssResult, c as collectClassCounts, b as buildDistribution } from './analyzeWorkspace-hYfu4Hg3.mjs';
-export { A as AnalyzerOptions, d as AnalyzerReport, e as AnalyzerSemanticReport, f as ClassConflict, g as ClassUsage, h as analyzeWorkspace } from './analyzeWorkspace-hYfu4Hg3.mjs';
-import './schemas-DR-SLxZZ.mjs';
-import 'zod';
+import { z } from 'zod';
+
+declare const ScanWorkspaceOptionsSchema: z.ZodObject<{
+    includeExtensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ignoreDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    useCache: z.ZodOptional<z.ZodBoolean>;
+    cacheDir: z.ZodOptional<z.ZodString>;
+    smartInvalidation: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type ScanWorkspaceOptions = z.infer<typeof ScanWorkspaceOptionsSchema>;
+declare const ScanWorkspaceResultSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        classes: z.ZodArray<z.ZodString>;
+        hash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalFiles: z.ZodNumber;
+    uniqueClasses: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type ScanWorkspaceResult = z.infer<typeof ScanWorkspaceResultSchema>;
+
+/**
+ * Public type contracts for @tailwind-styled/analyzer.
+ * Keep this file aligned with the runtime report shape exposed by src/index.ts.
+ */
+
+interface ClassUsage {
+    readonly name: string;
+    readonly count: number;
+    readonly isUnused?: boolean;
+    readonly isConflict?: boolean;
+}
+interface ClassConflict {
+    readonly className: string;
+    readonly variants: readonly string[];
+    readonly classes: readonly string[];
+    readonly message: string;
+}
+interface AnalyzerClassStats {
+    readonly all: readonly ClassUsage[];
+    readonly top: readonly ClassUsage[];
+    readonly frequent: readonly ClassUsage[];
+    readonly unique: readonly ClassUsage[];
+    readonly distribution: Readonly<Record<string, number>>;
+}
+interface TailwindConfigSummary {
+    readonly path: string;
+    readonly loaded: boolean;
+    readonly safelistCount: number;
+    readonly customUtilityCount: number;
+    readonly warning?: string;
+}
+interface AnalyzerSemanticReport {
+    readonly unusedClasses: readonly ClassUsage[];
+    readonly unknownClasses: readonly ClassUsage[];
+    readonly conflicts: readonly ClassConflict[];
+    readonly tailwindConfig?: TailwindConfigSummary;
+}
+interface AnalyzerReport {
+    readonly root: string;
+    readonly totalFiles: number;
+    readonly uniqueClassCount: number;
+    readonly totalClassOccurrences: number;
+    readonly classStats: AnalyzerClassStats;
+    /** Alias for classStats.top — backward compat & test contract */
+    readonly topClasses: readonly ClassUsage[];
+    readonly safelist: readonly string[];
+    readonly semantic?: AnalyzerSemanticReport;
+}
+interface AnalyzerOptions {
+    readonly scanner?: ScanWorkspaceOptions;
+    readonly classStats?: {
+        readonly top?: number;
+        readonly frequentThreshold?: number;
+    };
+    readonly includeClass?: (className: string) => boolean;
+    readonly semantic?: boolean | {
+        readonly tailwindConfigPath?: string;
+    };
+}
+interface ClassToCssOptions {
+    readonly prefix?: string | null;
+    readonly strict?: boolean;
+}
+interface ClassToCssResult {
+    readonly inputClasses: readonly string[];
+    readonly css: string;
+    readonly declarations: string;
+    readonly resolvedClasses: readonly string[];
+    readonly unknownClasses: readonly string[];
+    readonly sizeBytes: number;
+}
+interface NativeAnalyzerBinding {
+    analyzeClassesWorkspace?(filesJson: string, cwd: string, flags: number): unknown;
+    analyzeClasses(filesJson: string, cwd: string, flags: number): unknown;
+    compileCss?: (classes: string[], prefix: string | null) => unknown;
+    /** Detect conflicting Tailwind utilities in a usage list. */
+    detectClassConflicts?(usagesJson: string): {
+        conflicts: Array<{
+            group: string;
+            variantKey: string;
+            classes: string[];
+            message: string;
+        }>;
+        conflictedClassNames: string[];
+    };
+    /** Classify classes as known/unknown Tailwind utilities. */
+    classifyKnownClasses?(classes: string[], safelist: string[], customUtilities: string[]): Array<{
+        className: string;
+        isKnown: boolean;
+        variantKey: string;
+        baseClass: string;
+        utilityPrefix: string;
+        isArbitrary: boolean;
+    }>;
+    /** Map Tailwind class base → conflict group name. Return "" if no group. */
+    resolveConflictGroup?(base: string): string;
+    /** Aggregate class counts from scan files JSON. */
+    collectClassCounts?(filesJson: string): Array<{
+        name: string;
+        count: number;
+    }>;
+    /** Compute frequency distribution buckets for class usages. */
+    computeClassStats?(usagesJson: string, topLimit: number, frequentThreshold: number): {
+        totalClassOccurrences: number;
+        topJson: string;
+        frequentJson: string;
+        uniqueJson: string;
+    };
+    buildDistribution?(usagesJson: string): {
+        once: number;
+        few: number;
+        moderate: number;
+        frequent: number;
+    };
+}
+
+declare function requireNativeBinding(): Promise<NativeAnalyzerBinding>;
+
+declare function collectClassCounts(scan: ScanWorkspaceResult): Promise<Map<string, number>>;
+declare function buildDistribution(usages: ClassUsage[], native?: Awaited<ReturnType<typeof requireNativeBinding>>): Promise<Record<string, number>>;
+/**
+ * Analyze Tailwind class usage in a workspace and return usage statistics.
+ * Set `semantic.tailwindConfigPath` to override Tailwind config lookup.
+ * @example
+ * const report = await analyzeWorkspace("./src", {
+ *   classStats: { top: 20, frequentThreshold: 2 },
+ *   semantic: { tailwindConfigPath: "tailwind.config.js" },
+ * })
+ */
+declare function analyzeWorkspace(root: string, options?: AnalyzerOptions): Promise<AnalyzerReport>;
 
 /**
  * Convert Tailwind class input into atomic CSS output via native binding.
@@ -72,4 +219,4 @@ declare const __internal: {
     };
 };
 
-export { ClassToCssOptions, ClassToCssResult, __internal, classToCss };
+export { type AnalyzerOptions, type AnalyzerReport, type AnalyzerSemanticReport, type ClassConflict, type ClassToCssOptions, type ClassToCssResult, type ClassUsage, __internal, analyzeWorkspace, classToCss };

package/dist/analyzer.d.ts

@@ -1,7 +1,154 @@
-import { C as ClassToCssOptions, a as ClassToCssResult, c as collectClassCounts, b as buildDistribution } from './analyzeWorkspace-B1_XRfdl.js';
-export { A as AnalyzerOptions, d as AnalyzerReport, e as AnalyzerSemanticReport, f as ClassConflict, g as ClassUsage, h as analyzeWorkspace } from './analyzeWorkspace-B1_XRfdl.js';
-import './schemas-DR-SLxZZ.js';
-import 'zod';
+import { z } from 'zod';
+
+declare const ScanWorkspaceOptionsSchema: z.ZodObject<{
+    includeExtensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ignoreDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    useCache: z.ZodOptional<z.ZodBoolean>;
+    cacheDir: z.ZodOptional<z.ZodString>;
+    smartInvalidation: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type ScanWorkspaceOptions = z.infer<typeof ScanWorkspaceOptionsSchema>;
+declare const ScanWorkspaceResultSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        classes: z.ZodArray<z.ZodString>;
+        hash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalFiles: z.ZodNumber;
+    uniqueClasses: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type ScanWorkspaceResult = z.infer<typeof ScanWorkspaceResultSchema>;
+
+/**
+ * Public type contracts for @tailwind-styled/analyzer.
+ * Keep this file aligned with the runtime report shape exposed by src/index.ts.
+ */
+
+interface ClassUsage {
+    readonly name: string;
+    readonly count: number;
+    readonly isUnused?: boolean;
+    readonly isConflict?: boolean;
+}
+interface ClassConflict {
+    readonly className: string;
+    readonly variants: readonly string[];
+    readonly classes: readonly string[];
+    readonly message: string;
+}
+interface AnalyzerClassStats {
+    readonly all: readonly ClassUsage[];
+    readonly top: readonly ClassUsage[];
+    readonly frequent: readonly ClassUsage[];
+    readonly unique: readonly ClassUsage[];
+    readonly distribution: Readonly<Record<string, number>>;
+}
+interface TailwindConfigSummary {
+    readonly path: string;
+    readonly loaded: boolean;
+    readonly safelistCount: number;
+    readonly customUtilityCount: number;
+    readonly warning?: string;
+}
+interface AnalyzerSemanticReport {
+    readonly unusedClasses: readonly ClassUsage[];
+    readonly unknownClasses: readonly ClassUsage[];
+    readonly conflicts: readonly ClassConflict[];
+    readonly tailwindConfig?: TailwindConfigSummary;
+}
+interface AnalyzerReport {
+    readonly root: string;
+    readonly totalFiles: number;
+    readonly uniqueClassCount: number;
+    readonly totalClassOccurrences: number;
+    readonly classStats: AnalyzerClassStats;
+    /** Alias for classStats.top — backward compat & test contract */
+    readonly topClasses: readonly ClassUsage[];
+    readonly safelist: readonly string[];
+    readonly semantic?: AnalyzerSemanticReport;
+}
+interface AnalyzerOptions {
+    readonly scanner?: ScanWorkspaceOptions;
+    readonly classStats?: {
+        readonly top?: number;
+        readonly frequentThreshold?: number;
+    };
+    readonly includeClass?: (className: string) => boolean;
+    readonly semantic?: boolean | {
+        readonly tailwindConfigPath?: string;
+    };
+}
+interface ClassToCssOptions {
+    readonly prefix?: string | null;
+    readonly strict?: boolean;
+}
+interface ClassToCssResult {
+    readonly inputClasses: readonly string[];
+    readonly css: string;
+    readonly declarations: string;
+    readonly resolvedClasses: readonly string[];
+    readonly unknownClasses: readonly string[];
+    readonly sizeBytes: number;
+}
+interface NativeAnalyzerBinding {
+    analyzeClassesWorkspace?(filesJson: string, cwd: string, flags: number): unknown;
+    analyzeClasses(filesJson: string, cwd: string, flags: number): unknown;
+    compileCss?: (classes: string[], prefix: string | null) => unknown;
+    /** Detect conflicting Tailwind utilities in a usage list. */
+    detectClassConflicts?(usagesJson: string): {
+        conflicts: Array<{
+            group: string;
+            variantKey: string;
+            classes: string[];
+            message: string;
+        }>;
+        conflictedClassNames: string[];
+    };
+    /** Classify classes as known/unknown Tailwind utilities. */
+    classifyKnownClasses?(classes: string[], safelist: string[], customUtilities: string[]): Array<{
+        className: string;
+        isKnown: boolean;
+        variantKey: string;
+        baseClass: string;
+        utilityPrefix: string;
+        isArbitrary: boolean;
+    }>;
+    /** Map Tailwind class base → conflict group name. Return "" if no group. */
+    resolveConflictGroup?(base: string): string;
+    /** Aggregate class counts from scan files JSON. */
+    collectClassCounts?(filesJson: string): Array<{
+        name: string;
+        count: number;
+    }>;
+    /** Compute frequency distribution buckets for class usages. */
+    computeClassStats?(usagesJson: string, topLimit: number, frequentThreshold: number): {
+        totalClassOccurrences: number;
+        topJson: string;
+        frequentJson: string;
+        uniqueJson: string;
+    };
+    buildDistribution?(usagesJson: string): {
+        once: number;
+        few: number;
+        moderate: number;
+        frequent: number;
+    };
+}
+
+declare function requireNativeBinding(): Promise<NativeAnalyzerBinding>;
+
+declare function collectClassCounts(scan: ScanWorkspaceResult): Promise<Map<string, number>>;
+declare function buildDistribution(usages: ClassUsage[], native?: Awaited<ReturnType<typeof requireNativeBinding>>): Promise<Record<string, number>>;
+/**
+ * Analyze Tailwind class usage in a workspace and return usage statistics.
+ * Set `semantic.tailwindConfigPath` to override Tailwind config lookup.
+ * @example
+ * const report = await analyzeWorkspace("./src", {
+ *   classStats: { top: 20, frequentThreshold: 2 },
+ *   semantic: { tailwindConfigPath: "tailwind.config.js" },
+ * })
+ */
+declare function analyzeWorkspace(root: string, options?: AnalyzerOptions): Promise<AnalyzerReport>;
 
 /**
  * Convert Tailwind class input into atomic CSS output via native binding.
@@ -72,4 +219,4 @@ declare const __internal: {
     };
 };
 
-export { ClassToCssOptions, ClassToCssResult, __internal, classToCss };
+export { type AnalyzerOptions, type AnalyzerReport, type AnalyzerSemanticReport, type ClassConflict, type ClassToCssOptions, type ClassToCssResult, type ClassUsage, __internal, analyzeWorkspace, classToCss };

package/dist/animate.d.mts

@@ -1,5 +1,32 @@
-import { A as AnimationRegistryOptions, a as AnimateOptions, C as CompiledAnimation, K as KeyframesDefinition } from './types-DXr2PmGP.mjs';
-export { b as CSSDirection, c as CSSEasing, d as CSSFillMode, e as CSSIterationCount, f as CubicBezierEasing, P as PresetEasing, S as StepsEasing } from './types-DXr2PmGP.mjs';
+type CSSFillMode = "none" | "forwards" | "backwards" | "both";
+type CSSDirection = "normal" | "reverse" | "alternate" | "alternate-reverse";
+type CSSIterationCount = number | "infinite";
+type PresetEasing = "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out" | "step-start" | "step-end";
+type CubicBezierEasing = `cubic-bezier(${string})`;
+type StepsEasing = `steps(${string})`;
+type CSSEasing = PresetEasing | CubicBezierEasing | StepsEasing;
+interface AnimateOptions {
+    from: string;
+    to: string;
+    duration?: number;
+    easing?: CSSEasing;
+    delay?: number;
+    fill?: CSSFillMode;
+    iterations?: CSSIterationCount;
+    direction?: CSSDirection;
+    name?: string;
+}
+interface KeyframesDefinition {
+    [stop: string]: string;
+}
+interface CompiledAnimation {
+    className: string;
+    keyframesCss: string;
+    animationCss: string;
+}
+interface AnimationRegistryOptions {
+    cacheLimit?: number;
+}
 
 interface AnimationRegistry {
     compileAnimation(opts: AnimateOptions): Promise<CompiledAnimation>;
@@ -44,4 +71,4 @@ declare const animations: {
     readonly spinIn: () => Promise<string>;
 };
 
-export { AnimateOptions, createAnimationRegistry as AnimationRegistry, AnimationRegistryOptions, type AnimationRegistry as AnimationRegistryType, CompiledAnimation, type InjectAnimationCssOptions, KeyframesDefinition, animate, animations, compileAnimation, compileKeyframes, createAnimationRegistry, extractAnimationCss, getDefaultAnimationRegistry, initAnimate, injectAnimationCss, keyframes, resetAnimationRegistry };
+export { type AnimateOptions, createAnimationRegistry as AnimationRegistry, type AnimationRegistryOptions, type AnimationRegistry as AnimationRegistryType, type CSSDirection, type CSSEasing, type CSSFillMode, type CSSIterationCount, type CompiledAnimation, type CubicBezierEasing, type InjectAnimationCssOptions, type KeyframesDefinition, type PresetEasing, type StepsEasing, animate, animations, compileAnimation, compileKeyframes, createAnimationRegistry, extractAnimationCss, getDefaultAnimationRegistry, initAnimate, injectAnimationCss, keyframes, resetAnimationRegistry };

package/dist/animate.d.ts

@@ -1,5 +1,32 @@
-import { A as AnimationRegistryOptions, a as AnimateOptions, C as CompiledAnimation, K as KeyframesDefinition } from './types-DXr2PmGP.js';
-export { b as CSSDirection, c as CSSEasing, d as CSSFillMode, e as CSSIterationCount, f as CubicBezierEasing, P as PresetEasing, S as StepsEasing } from './types-DXr2PmGP.js';
+type CSSFillMode = "none" | "forwards" | "backwards" | "both";
+type CSSDirection = "normal" | "reverse" | "alternate" | "alternate-reverse";
+type CSSIterationCount = number | "infinite";
+type PresetEasing = "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out" | "step-start" | "step-end";
+type CubicBezierEasing = `cubic-bezier(${string})`;
+type StepsEasing = `steps(${string})`;
+type CSSEasing = PresetEasing | CubicBezierEasing | StepsEasing;
+interface AnimateOptions {
+    from: string;
+    to: string;
+    duration?: number;
+    easing?: CSSEasing;
+    delay?: number;
+    fill?: CSSFillMode;
+    iterations?: CSSIterationCount;
+    direction?: CSSDirection;
+    name?: string;
+}
+interface KeyframesDefinition {
+    [stop: string]: string;
+}
+interface CompiledAnimation {
+    className: string;
+    keyframesCss: string;
+    animationCss: string;
+}
+interface AnimationRegistryOptions {
+    cacheLimit?: number;
+}
 
 interface AnimationRegistry {
     compileAnimation(opts: AnimateOptions): Promise<CompiledAnimation>;
@@ -44,4 +71,4 @@ declare const animations: {
     readonly spinIn: () => Promise<string>;
 };
 
-export { AnimateOptions, createAnimationRegistry as AnimationRegistry, AnimationRegistryOptions, type AnimationRegistry as AnimationRegistryType, CompiledAnimation, type InjectAnimationCssOptions, KeyframesDefinition, animate, animations, compileAnimation, compileKeyframes, createAnimationRegistry, extractAnimationCss, getDefaultAnimationRegistry, initAnimate, injectAnimationCss, keyframes, resetAnimationRegistry };
+export { type AnimateOptions, createAnimationRegistry as AnimationRegistry, type AnimationRegistryOptions, type AnimationRegistry as AnimationRegistryType, type CSSDirection, type CSSEasing, type CSSFillMode, type CSSIterationCount, type CompiledAnimation, type CubicBezierEasing, type InjectAnimationCssOptions, type KeyframesDefinition, type PresetEasing, type StepsEasing, animate, animations, compileAnimation, compileKeyframes, createAnimationRegistry, extractAnimationCss, getDefaultAnimationRegistry, initAnimate, injectAnimationCss, keyframes, resetAnimationRegistry };

package/dist/compiler.d.mts

@@ -633,6 +633,11 @@ interface CompiledCssRule {
         value: string;
     }>;
     specificity: number;
+    source?: {
+        file: string;
+        line: number;
+        column: number;
+    };
 }
 /**
  * Compiled animation result

package/dist/compiler.d.ts

@@ -633,6 +633,11 @@ interface CompiledCssRule {
         value: string;
     }>;
     specificity: number;
+    source?: {
+        file: string;
+        line: number;
+        column: number;
+    };
 }
 /**
  * Compiled animation result