tailwind-styled-v4 4.0.0 → 5.0.1

package/dist/analyzer.d.ts

@@ -0,0 +1,114 @@
+import { ScanWorkspaceOptions, ScanWorkspaceResult } from './scanner.js';
+
+interface ClassUsage {
+    name: string;
+    count: number;
+    isUnused?: boolean;
+    isConflict?: boolean;
+}
+interface ClassConflict {
+    className: string;
+    variants: string[];
+    classes: string[];
+    message: string;
+}
+interface AnalyzerSemanticReport {
+    unusedClasses: ClassUsage[];
+    unknownClasses: ClassUsage[];
+    conflicts: ClassConflict[];
+    tailwindConfig?: {
+        path: string;
+        loaded: boolean;
+        safelistCount: number;
+        customUtilityCount: number;
+        warning?: string;
+    };
+}
+interface AnalyzerReport {
+    root: string;
+    totalFiles: number;
+    uniqueClassCount: number;
+    totalClassOccurrences: number;
+    classStats: {
+        all: ClassUsage[];
+        top: ClassUsage[];
+        frequent: ClassUsage[];
+        unique: ClassUsage[];
+        distribution: Record<string, number>;
+    };
+    /** All classes found, useful for Tailwind safelist. */
+    safelist: string[];
+    semantic?: AnalyzerSemanticReport;
+}
+interface AnalyzerOptions {
+    scanner?: ScanWorkspaceOptions;
+    classStats?: {
+        top?: number;
+        frequentThreshold?: number;
+    };
+    /**
+     * Enable semantic reporting. Provide `tailwindConfigPath` to override config lookup.
+     * Relative paths are resolved from `root` in `analyzeWorkspace`.
+     */
+    semantic?: boolean | {
+        tailwindConfigPath?: string;
+    };
+    includeClass?: (className: string) => boolean;
+}
+interface ClassToCssOptions {
+    prefix?: string | null;
+    strict?: boolean;
+}
+interface ClassToCssResult {
+    inputClasses: string[];
+    css: string;
+    declarations: string;
+    resolvedClasses: string[];
+    unknownClasses: string[];
+    sizeBytes: number;
+}
+
+declare function collectClassCounts(scan: ScanWorkspaceResult): Map<string, number>;
+declare function buildDistribution(usages: ClassUsage[]): 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>;
+
+declare function normalizeClassInput(input: string | string[]): string[];
+/**
+ * Convert Tailwind class input into atomic CSS output via native binding.
+ * @example
+ * const css = await classToCss("opacity-0 translate-y-2", { strict: true })
+ */
+declare function classToCss(input: string | string[], options?: ClassToCssOptions): Promise<ClassToCssResult>;
+
+declare function splitVariantAndBase(className: string): {
+    variantKey: string;
+    base: string;
+};
+declare function resolveConflictGroup(base: string): string | null;
+declare function utilityPrefix(baseClass: string): string;
+
+/**
+ * @tailwind-styled/analyzer v5
+ *
+ * Native-first async analyzer with semantic reporting.
+ */
+
+declare const __internal: {
+    normalizeClassInput: typeof normalizeClassInput;
+    splitVariantAndBase: typeof splitVariantAndBase;
+    resolveConflictGroup: typeof resolveConflictGroup;
+    collectClassCounts: typeof collectClassCounts;
+    buildDistribution: typeof buildDistribution;
+    utilityPrefix: typeof utilityPrefix;
+};
+
+export { type AnalyzerOptions, type AnalyzerReport, type AnalyzerSemanticReport, type ClassConflict, type ClassToCssOptions, type ClassToCssResult, type ClassUsage, __internal, analyzeWorkspace, classToCss };