tailwind-styled-v4 5.0.36 → 5.0.38

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 };