tailwind-unwind 0.1.1 → 0.3.0

package/dist/cli/index.js

@@ -2,23 +2,142 @@
 import {
   analyzeCommand,
   applyCommand,
-  generateCommand
-} from "../chunk-N7HD4T2I.js";
+  generateCommand,
+  loadCommandOptions
+} from "../chunk-4GXMK3NB.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
+import chalk from "chalk";
+
+// src/cli/defaults.ts
+var ANALYZE_DEFAULTS = {
+  minOccurrences: 5,
+  minSize: 2,
+  maxSize: 5,
+  top: 10
+};
+var GENERATE_DEFAULTS = {
+  minOccurrences: 3,
+  minSize: 2,
+  maxSize: 5,
+  top: 10,
+  prefix: "twu-"
+};
+
+// src/cli/parseOptions.ts
+function splitPatterns(value) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    return void 0;
+  }
+  return value.split(",").map((part) => part.trim()).filter((part) => part.length > 0);
+}
+function optionalNumber(value) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function cliNumber(value, fallback) {
+  const parsed = optionalNumber(value);
+  return parsed ?? fallback;
+}
+async function resolveCommandOptions(command, opts, targetPath) {
+  const resolved = await loadCommandOptions(
+    command,
+    {
+      configPath: opts.config,
+      minOccurrences: optionalNumber(opts.minOccurrences),
+      minSize: optionalNumber(opts.minSize),
+      maxSize: optionalNumber(opts.maxSize),
+      top: optionalNumber(opts.top),
+      prefix: opts.prefix,
+      dedupeSubsets: opts.dedupeSubsets,
+      include: splitPatterns(opts.include),
+      exclude: splitPatterns(opts.exclude),
+      output: opts.output,
+      dryRun: opts.dryRun,
+      prettier: opts.prettier,
+      fromReport: opts.fromReport,
+      extractableOnly: opts.extractableOnly
+    },
+    { targetPath }
+  );
+  return {
+    minOccurrences: resolved.minOccurrences,
+    minSize: resolved.minSize,
+    maxSize: resolved.maxSize,
+    top: resolved.top,
+    prefix: resolved.prefix,
+    dedupeSubsets: resolved.dedupeSubsets,
+    include: resolved.include,
+    exclude: resolved.exclude,
+    configPath: resolved.configPath,
+    output: resolved.output,
+    names: resolved.names,
+    format: opts.format === "json" ? "json" : "console",
+    dryRun: opts.dryRun ?? resolved.dryRun,
+    prettier: opts.prettier ?? resolved.prettier,
+    fromReport: opts.fromReport ?? resolved.fromReport,
+    extractableOnly: opts.extractableOnly ?? resolved.extractableOnly
+  };
+}
+function withNumericDefaults(resolved, opts, defaults) {
+  return {
+    ...resolved,
+    minOccurrences: resolved.minOccurrences ?? cliNumber(opts.minOccurrences, defaults.minOccurrences),
+    minSize: resolved.minSize ?? cliNumber(opts.minSize, defaults.minSize),
+    maxSize: resolved.maxSize ?? cliNumber(opts.maxSize, defaults.maxSize),
+    top: resolved.top ?? cliNumber(opts.top, defaults.top),
+    prefix: resolved.prefix ?? opts.prefix ?? defaults.prefix
+  };
+}
+
+// src/cli/version.ts
+import { readFileSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+function readPackageVersion() {
+  const currentDir = path.dirname(fileURLToPath(import.meta.url));
+  const packageJsonPath = path.join(currentDir, "../../package.json");
+  const raw = readFileSync(packageJsonPath, "utf-8");
+  const pkg = JSON.parse(raw);
+  return pkg.version ?? "0.0.0";
+}
+var CLI_VERSION = readPackageVersion();
+
+// src/cli/index.ts
 var program = new Command();
-program.name("tailwind-unwind").description("Analyze Tailwind CSS class usage in React/Next.js projects").version("0.1.0");
-program.command("analyze").description("Scan a directory and report frequent Tailwind class combinations").argument("<path>", "Directory to analyze").option("--min-occurrences <n>", "Minimum occurrences threshold", "5").option("--min-size <n>", "Minimum classes per combination", "2").option("--max-size <n>", "Maximum classes per combination", "5").option("--top <n>", "Number of top combinations to show", "10").option("--format <type>", "Output format: console or json", "console").option("--no-dedupe-subsets", "Include subset combinations in results").action(async (targetPath, opts) => {
+function addSharedOptions(command) {
+  return command.option("--config <file>", "Path to tailwind-unwind config file").option(
+    "--include <patterns>",
+    'Comma-separated glob include patterns (e.g. "src/**/*.tsx")'
+  ).option(
+    "--exclude <patterns>",
+    'Comma-separated glob exclude patterns (e.g. "**/*.test.tsx")'
+  );
+}
+program.name("tailwind-unwind").description("Analyze Tailwind CSS class usage in React/Next.js projects").version(CLI_VERSION);
+addSharedOptions(
+  program.command("analyze").description("Scan a directory and report frequent Tailwind class combinations").argument("<path>", "Directory to analyze").option("--min-occurrences <n>", "Minimum occurrences threshold").option("--min-size <n>", "Minimum classes per combination").option("--max-size <n>", "Maximum classes per combination").option("--top <n>", "Number of top combinations to show").option("--format <type>", "Output format: console or json", "console").option("--no-dedupe-subsets", "Include subset combinations in results")
+).action(async (targetPath, opts) => {
   try {
-    const format = opts.format === "json" ? "json" : "console";
+    const resolved = withNumericDefaults(
+      await resolveCommandOptions("analyze", opts, targetPath),
+      opts,
+      ANALYZE_DEFAULTS
+    );
     await analyzeCommand(targetPath, {
-      minOccurrences: Number(opts.minOccurrences),
-      minSize: Number(opts.minSize),
-      maxSize: Number(opts.maxSize),
-      top: Number(opts.top),
-      format,
-      dedupeSubsets: opts.dedupeSubsets
+      minOccurrences: resolved.minOccurrences,
+      minSize: resolved.minSize,
+      maxSize: resolved.maxSize,
+      top: resolved.top,
+      format: resolved.format,
+      dedupeSubsets: process.argv.includes("--no-dedupe-subsets") ? false : resolved.dedupeSubsets ?? true,
+      include: resolved.include,
+      exclude: resolved.exclude,
+      configPath: resolved.configPath
     });
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -26,15 +145,39 @@ program.command("analyze").description("Scan a directory and report frequent Tai
     process.exit(1);
   }
 });
-program.command("generate").description("Generate @layer components CSS from repeated className sets").argument("<path>", "Directory to analyze").requiredOption("--output <file>", "Output CSS file path").option("--min-occurrences <n>", "Minimum occurrences threshold", "3").option("--min-size <n>", "Minimum classes per combination", "2").option("--max-size <n>", "Maximum classes per combination", "5").option("--top <n>", "Number of combinations to generate", "10").option("--prefix <name>", "Namespace prefix for generated classes", "twu-").action(async (targetPath, opts) => {
+addSharedOptions(
+  program.command("generate").description("Generate @layer components CSS from repeated className sets").argument("[path]", "Directory to analyze").option("--output <file>", "Output CSS file path").option("--from-report <file>", "Generate from analyze JSON report").option("--extractable-only", "Only generate extractable patterns from analyze").option("--format <type>", "Output format: console or json", "console").option("--min-occurrences <n>", "Minimum occurrences threshold").option("--min-size <n>", "Minimum classes per combination").option("--max-size <n>", "Maximum classes per combination").option("--top <n>", "Number of combinations to generate").option("--prefix <name>", "Namespace prefix for generated classes")
+).action(async (targetPath, opts) => {
   try {
-    await generateCommand(targetPath, {
-      output: opts.output,
-      minOccurrences: Number(opts.minOccurrences),
-      minSize: Number(opts.minSize),
-      maxSize: Number(opts.maxSize),
-      top: Number(opts.top),
-      prefix: opts.prefix
+    const resolved = withNumericDefaults(
+      await resolveCommandOptions("generate", opts, targetPath),
+      opts,
+      GENERATE_DEFAULTS
+    );
+    const output = opts.output ?? resolved.output;
+    const scanPath = targetPath ?? ".";
+    if (!output) {
+      console.error(chalk.red("Error: --output is required"));
+      process.exit(1);
+    }
+    if (!opts.fromReport && !resolved.fromReport && !targetPath) {
+      console.error(chalk.red("Error: <path> is required without --from-report"));
+      process.exit(1);
+    }
+    await generateCommand(scanPath, {
+      output,
+      minOccurrences: resolved.minOccurrences,
+      minSize: resolved.minSize,
+      maxSize: resolved.maxSize,
+      top: resolved.top,
+      prefix: resolved.prefix,
+      include: resolved.include,
+      exclude: resolved.exclude,
+      configPath: resolved.configPath,
+      names: resolved.names,
+      format: resolved.format,
+      fromReport: opts.fromReport ?? resolved.fromReport,
+      extractableOnly: Boolean(opts.extractableOnly || resolved.extractableOnly)
     });
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -42,16 +185,36 @@ program.command("generate").description("Generate @layer components CSS from rep
     process.exit(1);
   }
 });
-program.command("apply").description("Replace repeated className strings with generated component classes").argument("<path>", "Directory to modify").requiredOption("--output <file>", "Output CSS file path").option("--min-occurrences <n>", "Minimum occurrences threshold", "3").option("--min-size <n>", "Minimum classes per combination", "2").option("--max-size <n>", "Maximum classes per combination", "5").option("--top <n>", "Number of component classes to use", "10").option("--dry-run", "Preview replacements without writing files").option("--prefix <name>", "Namespace prefix for generated classes", "twu-").action(async (targetPath, opts) => {
+addSharedOptions(
+  program.command("apply").description("Replace repeated className strings with generated component classes").argument("<path>", "Directory to modify").option("--output <file>", "Output CSS file path").option("--from-report <file>", "Use component list from analyze JSON report").option("--extractable-only", "Only apply extractable patterns from analyze").option("--format <type>", "Output format: console or json", "console").option("--prettier", "Format modified files with Prettier when available").option("--min-occurrences <n>", "Minimum occurrences threshold").option("--min-size <n>", "Minimum classes per combination").option("--max-size <n>", "Maximum classes per combination").option("--top <n>", "Number of component classes to use").option("--dry-run", "Preview replacements without writing files").option("--prefix <name>", "Namespace prefix for generated classes")
+).action(async (targetPath, opts) => {
   try {
+    const resolved = withNumericDefaults(
+      await resolveCommandOptions("apply", opts, targetPath),
+      opts,
+      GENERATE_DEFAULTS
+    );
+    const output = opts.output ?? resolved.output;
+    if (!output) {
+      console.error(chalk.red("Error: --output is required"));
+      process.exit(1);
+    }
     await applyCommand(targetPath, {
-      output: opts.output,
-      minOccurrences: Number(opts.minOccurrences),
-      minSize: Number(opts.minSize),
-      maxSize: Number(opts.maxSize),
-      top: Number(opts.top),
-      prefix: opts.prefix,
-      dryRun: Boolean(opts.dryRun)
+      output,
+      minOccurrences: resolved.minOccurrences,
+      minSize: resolved.minSize,
+      maxSize: resolved.maxSize,
+      top: resolved.top,
+      prefix: resolved.prefix,
+      include: resolved.include,
+      exclude: resolved.exclude,
+      configPath: resolved.configPath,
+      names: resolved.names,
+      format: resolved.format,
+      fromReport: opts.fromReport ?? resolved.fromReport,
+      extractableOnly: Boolean(opts.extractableOnly || resolved.extractableOnly),
+      dryRun: process.argv.includes("--dry-run") ? true : Boolean(resolved.dryRun),
+      prettier: Boolean(opts.prettier || resolved.prettier)
     });
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { Command } from 'commander';\nimport { analyzeCommand } from '../commands/analyze.js';\nimport { applyCommand } from '../commands/apply.js';\nimport { generateCommand } from '../commands/generate.js';\n\nconst program = new Command();\n\nprogram\n  .name('tailwind-unwind')\n  .description('Analyze Tailwind CSS class usage in React/Next.js projects')\n  .version('0.1.0');\n\nprogram\n  .command('analyze')\n  .description('Scan a directory and report frequent Tailwind class combinations')\n  .argument('<path>', 'Directory to analyze')\n  .option('--min-occurrences <n>', 'Minimum occurrences threshold', '5')\n  .option('--min-size <n>', 'Minimum classes per combination', '2')\n  .option('--max-size <n>', 'Maximum classes per combination', '5')\n  .option('--top <n>', 'Number of top combinations to show', '10')\n  .option('--format <type>', 'Output format: console or json', 'console')\n  .option('--no-dedupe-subsets', 'Include subset combinations in results')\n  .action(async (targetPath: string, opts) => {\n    try {\n      const format = opts.format === 'json' ? 'json' : 'console';\n\n      await analyzeCommand(targetPath, {\n        minOccurrences: Number(opts.minOccurrences),\n        minSize: Number(opts.minSize),\n        maxSize: Number(opts.maxSize),\n        top: Number(opts.top),\n        format,\n        dedupeSubsets: opts.dedupeSubsets,\n      });\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      console.error('Unexpected error:', message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('generate')\n  .description('Generate @layer components CSS from repeated className sets')\n  .argument('<path>', 'Directory to analyze')\n  .requiredOption('--output <file>', 'Output CSS file path')\n  .option('--min-occurrences <n>', 'Minimum occurrences threshold', '3')\n  .option('--min-size <n>', 'Minimum classes per combination', '2')\n  .option('--max-size <n>', 'Maximum classes per combination', '5')\n  .option('--top <n>', 'Number of combinations to generate', '10')\n  .option('--prefix <name>', 'Namespace prefix for generated classes', 'twu-')\n  .action(async (targetPath: string, opts) => {\n    try {\n      await generateCommand(targetPath, {\n        output: opts.output,\n        minOccurrences: Number(opts.minOccurrences),\n        minSize: Number(opts.minSize),\n        maxSize: Number(opts.maxSize),\n        top: Number(opts.top),\n        prefix: opts.prefix,\n      });\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      console.error('Unexpected error:', message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('apply')\n  .description('Replace repeated className strings with generated component classes')\n  .argument('<path>', 'Directory to modify')\n  .requiredOption('--output <file>', 'Output CSS file path')\n  .option('--min-occurrences <n>', 'Minimum occurrences threshold', '3')\n  .option('--min-size <n>', 'Minimum classes per combination', '2')\n  .option('--max-size <n>', 'Maximum classes per combination', '5')\n  .option('--top <n>', 'Number of component classes to use', '10')\n  .option('--dry-run', 'Preview replacements without writing files')\n  .option('--prefix <name>', 'Namespace prefix for generated classes', 'twu-')\n  .action(async (targetPath: string, opts) => {\n    try {\n      await applyCommand(targetPath, {\n        output: opts.output,\n        minOccurrences: Number(opts.minOccurrences),\n        minSize: Number(opts.minSize),\n        maxSize: Number(opts.maxSize),\n        top: Number(opts.top),\n        prefix: opts.prefix,\n        dryRun: Boolean(opts.dryRun),\n      });\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      console.error('Unexpected error:', message);\n      process.exit(1);\n    }\n  });\n\nprogram.parse();\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/cli/index.ts","../../src/cli/defaults.ts","../../src/cli/parseOptions.ts","../../src/cli/version.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport { analyzeCommand } from '../commands/analyze.js';\nimport { applyCommand } from '../commands/apply.js';\nimport { generateCommand } from '../commands/generate.js';\nimport { ANALYZE_DEFAULTS, GENERATE_DEFAULTS } from './defaults.js';\nimport { resolveCommandOptions, withNumericDefaults } from './parseOptions.js';\nimport { CLI_VERSION } from './version.js';\n\nconst program = new Command();\n\nfunction addSharedOptions(command: Command): Command {\n  return command\n    .option('--config <file>', 'Path to tailwind-unwind config file')\n    .option(\n      '--include <patterns>',\n      'Comma-separated glob include patterns (e.g. \"src/**/*.tsx\")',\n    )\n    .option(\n      '--exclude <patterns>',\n      'Comma-separated glob exclude patterns (e.g. \"**/*.test.tsx\")',\n    );\n}\n\nprogram\n  .name('tailwind-unwind')\n  .description('Analyze Tailwind CSS class usage in React/Next.js projects')\n  .version(CLI_VERSION);\n\naddSharedOptions(\n  program\n    .command('analyze')\n    .description('Scan a directory and report frequent Tailwind class combinations')\n    .argument('<path>', 'Directory to analyze')\n    .option('--min-occurrences <n>', 'Minimum occurrences threshold')\n    .option('--min-size <n>', 'Minimum classes per combination')\n    .option('--max-size <n>', 'Maximum classes per combination')\n    .option('--top <n>', 'Number of top combinations to show')\n    .option('--format <type>', 'Output format: console or json', 'console')\n    .option('--no-dedupe-subsets', 'Include subset combinations in results'),\n).action(async (targetPath: string, opts) => {\n  try {\n    const resolved = withNumericDefaults(\n      await resolveCommandOptions('analyze', opts, targetPath),\n      opts,\n      ANALYZE_DEFAULTS,\n    );\n\n    await analyzeCommand(targetPath, {\n      minOccurrences: resolved.minOccurrences,\n      minSize: resolved.minSize,\n      maxSize: resolved.maxSize,\n      top: resolved.top,\n      format: resolved.format,\n      dedupeSubsets: process.argv.includes('--no-dedupe-subsets')\n        ? false\n        : (resolved.dedupeSubsets ?? true),\n      include: resolved.include,\n      exclude: resolved.exclude,\n      configPath: resolved.configPath,\n    });\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    console.error('Unexpected error:', message);\n    process.exit(1);\n  }\n});\n\naddSharedOptions(\n  program\n    .command('generate')\n    .description('Generate @layer components CSS from repeated className sets')\n    .argument('[path]', 'Directory to analyze')\n    .option('--output <file>', 'Output CSS file path')\n    .option('--from-report <file>', 'Generate from analyze JSON report')\n    .option('--extractable-only', 'Only generate extractable patterns from analyze')\n    .option('--format <type>', 'Output format: console or json', 'console')\n    .option('--min-occurrences <n>', 'Minimum occurrences threshold')\n    .option('--min-size <n>', 'Minimum classes per combination')\n    .option('--max-size <n>', 'Maximum classes per combination')\n    .option('--top <n>', 'Number of combinations to generate')\n    .option('--prefix <name>', 'Namespace prefix for generated classes'),\n).action(async (targetPath: string | undefined, opts) => {\n  try {\n    const resolved = withNumericDefaults(\n      await resolveCommandOptions('generate', opts, targetPath),\n      opts,\n      GENERATE_DEFAULTS,\n    );\n    const output = opts.output ?? resolved.output;\n    const scanPath = targetPath ?? '.';\n\n    if (!output) {\n      console.error(chalk.red('Error: --output is required'));\n      process.exit(1);\n    }\n\n    if (!opts.fromReport && !resolved.fromReport && !targetPath) {\n      console.error(chalk.red('Error: <path> is required without --from-report'));\n      process.exit(1);\n    }\n\n    await generateCommand(scanPath, {\n      output,\n      minOccurrences: resolved.minOccurrences,\n      minSize: resolved.minSize,\n      maxSize: resolved.maxSize,\n      top: resolved.top,\n      prefix: resolved.prefix,\n      include: resolved.include,\n      exclude: resolved.exclude,\n      configPath: resolved.configPath,\n      names: resolved.names,\n      format: resolved.format,\n      fromReport: opts.fromReport ?? resolved.fromReport,\n      extractableOnly: Boolean(opts.extractableOnly || resolved.extractableOnly),\n    });\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    console.error('Unexpected error:', message);\n    process.exit(1);\n  }\n});\n\naddSharedOptions(\n  program\n    .command('apply')\n    .description('Replace repeated className strings with generated component classes')\n    .argument('<path>', 'Directory to modify')\n    .option('--output <file>', 'Output CSS file path')\n    .option('--from-report <file>', 'Use component list from analyze JSON report')\n    .option('--extractable-only', 'Only apply extractable patterns from analyze')\n    .option('--format <type>', 'Output format: console or json', 'console')\n    .option('--prettier', 'Format modified files with Prettier when available')\n    .option('--min-occurrences <n>', 'Minimum occurrences threshold')\n    .option('--min-size <n>', 'Minimum classes per combination')\n    .option('--max-size <n>', 'Maximum classes per combination')\n    .option('--top <n>', 'Number of component classes to use')\n    .option('--dry-run', 'Preview replacements without writing files')\n    .option('--prefix <name>', 'Namespace prefix for generated classes'),\n).action(async (targetPath: string, opts) => {\n  try {\n    const resolved = withNumericDefaults(\n      await resolveCommandOptions('apply', opts, targetPath),\n      opts,\n      GENERATE_DEFAULTS,\n    );\n    const output = opts.output ?? resolved.output;\n\n    if (!output) {\n      console.error(chalk.red('Error: --output is required'));\n      process.exit(1);\n    }\n\n    await applyCommand(targetPath, {\n      output,\n      minOccurrences: resolved.minOccurrences,\n      minSize: resolved.minSize,\n      maxSize: resolved.maxSize,\n      top: resolved.top,\n      prefix: resolved.prefix,\n      include: resolved.include,\n      exclude: resolved.exclude,\n      configPath: resolved.configPath,\n      names: resolved.names,\n      format: resolved.format,\n      fromReport: opts.fromReport ?? resolved.fromReport,\n      extractableOnly: Boolean(opts.extractableOnly || resolved.extractableOnly),\n      dryRun: process.argv.includes('--dry-run')\n        ? true\n        : Boolean(resolved.dryRun),\n      prettier: Boolean(opts.prettier || resolved.prettier),\n    });\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    console.error('Unexpected error:', message);\n    process.exit(1);\n  }\n});\n\nprogram.parse();\n","export const ANALYZE_DEFAULTS = {\n  minOccurrences: 5,\n  minSize: 2,\n  maxSize: 5,\n  top: 10,\n} as const;\n\nexport const GENERATE_DEFAULTS = {\n  minOccurrences: 3,\n  minSize: 2,\n  maxSize: 5,\n  top: 10,\n  prefix: 'twu-',\n} as const;\n","import { loadCommandOptions } from '../config/loadConfig.js';\nimport type { CliCommand } from '../config/types.js';\nimport type { AnalyzeOptions } from '../parser/types.js';\n\nfunction splitPatterns(value: unknown): string[] | undefined {\n  if (typeof value !== 'string' || value.trim().length === 0) {\n    return undefined;\n  }\n\n  return value\n    .split(',')\n    .map((part) => part.trim())\n    .filter((part) => part.length > 0);\n}\n\nfunction optionalNumber(value: unknown): number | undefined {\n  if (value === undefined || value === null || value === '') {\n    return undefined;\n  }\n\n  const parsed = Number(value);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nexport interface RawCliOptions {\n  config?: string;\n  minOccurrences?: string | number;\n  minSize?: string | number;\n  maxSize?: string | number;\n  top?: string | number;\n  prefix?: string;\n  dedupeSubsets?: boolean;\n  include?: string;\n  exclude?: string;\n  output?: string;\n  format?: string;\n  dryRun?: boolean;\n  prettier?: boolean;\n  fromReport?: string;\n  extractableOnly?: boolean;\n}\n\nfunction cliNumber(\n  value: string | number | undefined,\n  fallback: number,\n): number {\n  const parsed = optionalNumber(value);\n  return parsed ?? fallback;\n}\n\n/**\n * Merge config file values with CLI flags (CLI wins).\n */\nexport async function resolveCommandOptions(\n  command: CliCommand,\n  opts: RawCliOptions,\n  targetPath?: string,\n): Promise<\n  AnalyzeOptions & { output?: string; dryRun?: boolean; names?: Record<string, string> }\n> {\n  const resolved = await loadCommandOptions(\n    command,\n    {\n      configPath: opts.config,\n      minOccurrences: optionalNumber(opts.minOccurrences),\n      minSize: optionalNumber(opts.minSize),\n      maxSize: optionalNumber(opts.maxSize),\n      top: optionalNumber(opts.top),\n      prefix: opts.prefix,\n      dedupeSubsets: opts.dedupeSubsets,\n      include: splitPatterns(opts.include),\n      exclude: splitPatterns(opts.exclude),\n      output: opts.output,\n    dryRun: opts.dryRun,\n    prettier: opts.prettier,\n    fromReport: opts.fromReport,\n    extractableOnly: opts.extractableOnly,\n  },\n    { targetPath },\n  );\n\n  return {\n    minOccurrences: resolved.minOccurrences,\n    minSize: resolved.minSize,\n    maxSize: resolved.maxSize,\n    top: resolved.top,\n    prefix: resolved.prefix,\n    dedupeSubsets: resolved.dedupeSubsets,\n    include: resolved.include,\n    exclude: resolved.exclude,\n    configPath: resolved.configPath,\n    output: resolved.output,\n    names: resolved.names,\n    format: opts.format === 'json' ? 'json' : 'console',\n    dryRun: opts.dryRun ?? resolved.dryRun,\n    prettier: opts.prettier ?? resolved.prettier,\n    fromReport: opts.fromReport ?? resolved.fromReport,\n    extractableOnly: opts.extractableOnly ?? resolved.extractableOnly,\n  };\n}\n\nexport function withNumericDefaults(\n  resolved: Awaited<ReturnType<typeof resolveCommandOptions>>,\n  opts: RawCliOptions,\n  defaults: {\n    minOccurrences: number;\n    minSize: number;\n    maxSize: number;\n    top: number;\n    prefix?: string;\n  },\n) {\n  return {\n    ...resolved,\n    minOccurrences:\n      resolved.minOccurrences ??\n      cliNumber(opts.minOccurrences, defaults.minOccurrences),\n    minSize: resolved.minSize ?? cliNumber(opts.minSize, defaults.minSize),\n    maxSize: resolved.maxSize ?? cliNumber(opts.maxSize, defaults.maxSize),\n    top: resolved.top ?? cliNumber(opts.top, defaults.top),\n    prefix: resolved.prefix ?? opts.prefix ?? defaults.prefix,\n  };\n}\n\n/** @deprecated Use resolveCommandOptions */\nexport const resolveAnalyzeOptions = (\n  opts: RawCliOptions,\n  targetPath?: string,\n) => resolveCommandOptions('analyze', opts, targetPath);\n","import { readFileSync } from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nfunction readPackageVersion(): string {\n  const currentDir = path.dirname(fileURLToPath(import.meta.url));\n  const packageJsonPath = path.join(currentDir, '../../package.json');\n  const raw = readFileSync(packageJsonPath, 'utf-8');\n  const pkg = JSON.parse(raw) as { version?: string };\n  return pkg.version ?? '0.0.0';\n}\n\nexport const CLI_VERSION = readPackageVersion();\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,4 +1,51 @@
-import { Expression, JSXAttribute, Node } from '@babel/types';
+import { Node, CallExpression, Expression, JSXAttribute } from '@babel/types';
+
+type CliCommand = 'analyze' | 'generate' | 'apply';
+interface CommandConfig {
+    minOccurrences?: number;
+    minSize?: number;
+    maxSize?: number;
+    top?: number;
+    prefix?: string;
+    output?: string;
+    dedupeSubsets?: boolean;
+    dryRun?: boolean;
+    prettier?: boolean;
+    fromReport?: string;
+    extractableOnly?: boolean;
+}
+/** Keys are space-separated utility strings; values are base class names (without prefix). */
+type CustomNamesConfig = Record<string, string>;
+interface TailwindUnwindConfigFile extends CommandConfig {
+    include?: string[];
+    exclude?: string[];
+    names?: CustomNamesConfig;
+    analyze?: CommandConfig;
+    generate?: CommandConfig;
+    apply?: CommandConfig;
+}
+interface TailwindUnwindConfig extends CommandConfig {
+    include?: string[];
+    exclude?: string[];
+    names?: CustomNamesConfig;
+}
+interface ResolvedCommandOptions extends TailwindUnwindConfig {
+    configPath?: string;
+}
+
+/**
+ * Load tailwind-unwind config for a command and merge CLI overrides on top.
+ */
+declare function loadCommandOptions(command: CliCommand, cliOptions: ResolvedCommandOptions, options?: {
+    cwd?: string;
+    targetPath?: string;
+}): Promise<ResolvedCommandOptions>;
+
+/**
+ * Validate a parsed config object and throw with all errors at once.
+ */
+declare function validateConfigFile(raw: unknown, configPath: string): void;
+declare function normalizeNamesConfig(names: CustomNamesConfig | undefined): Map<string, string>;
 
 interface ClassNameExtraction {
     classes: string[];
@@ -25,6 +72,8 @@ interface ClassCombination {
     occurrences: number;
     suggestion: string;
     locations: CombinationLocation[];
+    /** True when generate/apply can extract this exact class set */
+    extractable?: boolean;
 }
 interface AnalysisStats {
     filesScanned: number;
@@ -48,6 +97,14 @@ interface AnalyzeOptions {
     dedupeSubsets?: boolean;
     /** Namespace prefix for generated component classes (default: twu-) */
     prefix?: string;
+    include?: string[];
+    exclude?: string[];
+    configPath?: string;
+    /** Custom base class names keyed by space-separated utility strings */
+    names?: Record<string, string>;
+    prettier?: boolean;
+    fromReport?: string;
+    extractableOnly?: boolean;
 }
 
 /**
@@ -55,20 +112,32 @@ interface AnalyzeOptions {
  */
 declare function analyzeCommand(targetPath: string, options?: AnalyzeOptions): Promise<AnalysisReport>;
 
-interface ApplyOptions extends AnalyzeOptions {
-    output: string;
-    dryRun?: boolean;
+interface GeneratedComponent {
+    className: string;
+    classes: string[];
+    occurrences: number;
 }
-interface ApplyResult {
-    filesModified: number;
-    replacementsTotal: number;
-    outputPath: string;
-    componentsGenerated: number;
+interface CssGeneratorOptions {
+    sourcePath: string;
+    combinations: ClassCombination[];
+    prefix?: string;
+    names?: CustomNamesConfig;
+}
+interface CssGeneratorResult {
+    css: string;
+    components: GeneratedComponent[];
 }
+interface AssignClassNamesOptions {
+    prefix?: string;
+    names?: CustomNamesConfig;
+}
+/** Assign unique, prefixed component class names. */
+declare function assignComponentClassNames(combinations: ClassCombination[], options?: AssignClassNamesOptions): GeneratedComponent[];
 /**
- * Generate component CSS and replace matching className strings in source files.
+ * Build a Tailwind CSS file with @layer components and @apply rules
+ * for the most frequent class combinations.
  */
-declare function applyCommand(targetPath: string, options: ApplyOptions): Promise<ApplyResult>;
+declare function generateComponentCss(options: CssGeneratorOptions): CssGeneratorResult;
 
 interface PatternFinderOptions {
     minOccurrences?: number;
@@ -93,8 +162,92 @@ declare function findRepeatedClassSets(occurrences: ClassNameOccurrence[], optio
  */
 declare function calculatePotentialReduction(occurrences: ClassNameOccurrence[], topCombinations: ClassCombination[]): number;
 
+interface BuildComponentsOptions extends PatternFinderOptions {
+    sourcePath: string;
+    prefix?: string;
+    names?: Record<string, string>;
+}
+interface BuildComponentsResult {
+    components: GeneratedComponent[];
+    css: string;
+    replacementMap: Map<string, string>;
+}
+/** Build component classes, CSS, and a normalized-class → name lookup map. */
+declare function buildComponents(occurrences: ClassNameOccurrence[], options: BuildComponentsOptions): BuildComponentsResult;
+/** Build components from pre-selected combinations (e.g. analyze report). */
+declare function buildComponentsFromCombinations(combinations: ClassCombination[], options: BuildComponentsOptions): BuildComponentsResult;
+
+interface ClassReplacement {
+    filePath: string;
+    line?: number;
+    from: string;
+    to: string;
+    partial?: boolean;
+}
+interface SkippedReplacement {
+    filePath: string;
+    line?: number;
+    reason: string;
+    classes: string[];
+}
+interface ReplaceClassNamesResult {
+    source: string;
+    replacements: ClassReplacement[];
+    skipped: SkippedReplacement[];
+    changed: boolean;
+}
+/**
+ * Replace exact matching className/class values with generated component classes.
+ * Supports partial replacement inside cn()/clsx() when dynamic args are present.
+ */
+declare function replaceClassNamesInSource(source: string, replacementMap: Map<string, string>, filePath: string): ReplaceClassNamesResult;
+
+interface GenerateJsonReport {
+    command: 'generate';
+    outputPath: string;
+    componentsGenerated: number;
+    components: GeneratedComponent[];
+    cssWritten: boolean;
+}
+interface ApplyJsonReport {
+    command: 'apply';
+    dryRun: boolean;
+    outputPath: string;
+    filesModified: number;
+    replacementsTotal: number;
+    componentsGenerated: number;
+    components: GeneratedComponent[];
+    replacements: ClassReplacement[];
+    skipped: SkippedReplacement[];
+}
+declare function printGenerateJsonReport(report: GenerateJsonReport): void;
+declare function printApplyJsonReport(report: ApplyJsonReport): void;
+
+interface ApplyOptions extends AnalyzeOptions {
+    output: string;
+    dryRun?: boolean;
+}
+interface ApplyResult {
+    filesModified: number;
+    replacementsTotal: number;
+    outputPath: string;
+    componentsGenerated: number;
+    components: Awaited<ReturnType<typeof buildComponents>>['components'];
+    replacements: ApplyJsonReport['replacements'];
+    skipped: ApplyJsonReport['skipped'];
+    prettierFormatted: string[];
+}
+/**
+ * Generate component CSS and replace matching className strings in source files.
+ */
+declare function applyCommand(targetPath: string, options: ApplyOptions): Promise<ApplyResult>;
+
 interface ScanProjectOptions extends PatternFinderOptions {
     targetPath: string;
+    include?: string[];
+    exclude?: string[];
+    /** Threshold used to mark combinations as extractable by generate/apply */
+    extractableMinOccurrences?: number;
 }
 interface ScanProjectResult {
     resolvedPath: string;
@@ -114,72 +267,54 @@ interface GenerateOptions extends AnalyzeOptions {
 interface GenerateResult {
     outputPath: string;
     componentsGenerated: number;
-    report: Awaited<ReturnType<typeof scanProject>>['report'];
+    components: Awaited<ReturnType<typeof buildComponents>>['components'];
+    report: Awaited<ReturnType<typeof scanProject>>['report'] | null;
 }
 /**
  * Analyze a project and write @layer components CSS to the output file.
  */
 declare function generateCommand(targetPath: string, options: GenerateOptions): Promise<GenerateResult>;
 
-interface GeneratedComponent {
-    className: string;
-    classes: string[];
-    occurrences: number;
-}
-interface CssGeneratorOptions {
-    sourcePath: string;
+interface LoadedAnalyzeReport {
+    targetPath: string;
     combinations: ClassCombination[];
-    prefix?: string;
-}
-interface CssGeneratorResult {
-    css: string;
-    components: GeneratedComponent[];
-}
-interface AssignClassNamesOptions {
-    prefix?: string;
 }
-/** Assign unique, prefixed component class names. */
-declare function assignComponentClassNames(combinations: ClassCombination[], options?: AssignClassNamesOptions): GeneratedComponent[];
 /**
- * Build a Tailwind CSS file with @layer components and @apply rules
- * for the most frequent class combinations.
+ * Load an analyze JSON report and return extractable combinations for generate.
  */
-declare function generateComponentCss(options: CssGeneratorOptions): CssGeneratorResult;
+declare function loadExtractableCombinations(reportPath: string, options?: {
+    extractableOnly?: boolean;
+}): Promise<LoadedAnalyzeReport>;
 
-interface BuildComponentsOptions extends PatternFinderOptions {
-    sourcePath: string;
-    prefix?: string;
-}
-interface BuildComponentsResult {
-    components: GeneratedComponent[];
-    css: string;
-    replacementMap: Map<string, string>;
-}
-/** Build component classes, CSS, and a normalized-class → name lookup map. */
-declare function buildComponents(occurrences: ClassNameOccurrence[], options: BuildComponentsOptions): BuildComponentsResult;
-
-interface ClassReplacement {
-    filePath: string;
-    line?: number;
-    from: string;
-    to: string;
-}
-interface SkippedReplacement {
+interface FormatSourceOptions {
     filePath: string;
-    line?: number;
-    reason: string;
-    classes: string[];
+    cwd?: string;
 }
-interface ReplaceClassNamesResult {
+/**
+ * Format source with Prettier when available in the project.
+ * Returns original source unchanged if Prettier is not installed.
+ */
+declare function formatSource(source: string, options: FormatSourceOptions): Promise<{
     source: string;
-    replacements: ClassReplacement[];
-    skipped: SkippedReplacement[];
-    changed: boolean;
-}
+    formatted: boolean;
+}>;
+declare function formatModifiedFiles(files: string[], sources: Map<string, string>, cwd?: string): Promise<{
+    formatted: string[];
+    skipped: string[];
+}>;
+
+/** Variant APIs that define reusable Tailwind class sets. */
+declare const VARIANT_CALLEES: Set<string>;
+declare function isVariantCallee(expression: Expression): boolean;
 /**
- * Replace exact matching className/class values with generated component classes.
+ * Extract Tailwind tokens from a cva()/tv() definition call.
  */
-declare function replaceClassNamesInSource(source: string, replacementMap: Map<string, string>, filePath: string): ReplaceClassNamesResult;
+declare function extractClassesFromVariantCall(call: CallExpression): string[];
+type VariantRegistry = Map<string, string[]>;
+/**
+ * Collect `const x = cva(...)` / `const x = tv(...)` definitions in a file.
+ */
+declare function collectVariantRegistry(ast: Node): VariantRegistry;
 
 /**
  * Suggest a short, human-readable component class name from a utility list.
@@ -221,15 +356,11 @@ interface ExtractedClasses {
     classes: string[];
     isDynamic: boolean;
 }
-/**
- * Recursively pull static Tailwind tokens from JSX className expressions.
- * Unknown/dynamic fragments set `isDynamic: true` but may still yield partial classes.
- */
-declare function extractClassesFromExpression(expression: Expression): ExtractedClasses;
+declare function extractClassesFromExpression(expression: Expression, registry?: VariantRegistry): ExtractedClasses;
 
 declare function isClassAttribute(attr: JSXAttribute): boolean;
 /** Extract Tailwind classes from a className/class JSX attribute. */
-declare function extractFromJSXAttribute(attr: JSXAttribute): ClassNameExtraction | null;
+declare function extractFromJSXAttribute(attr: JSXAttribute, registry?: VariantRegistry): ClassNameExtraction | null;
 declare function parseSourceToAst(source: string): Node;
 
 /**
@@ -241,10 +372,14 @@ declare function parseSource(source: string, filePath?: string): ParseResult;
  */
 declare function parseFile(filePath: string): Promise<ParseResult>;
 
+interface WalkSourceFilesOptions {
+    include?: string[];
+    exclude?: string[];
+}
 /**
  * Recursively collect source files under `targetPath`, skipping common build/cache dirs.
  */
-declare function walkSourceFiles(targetPath: string): Promise<string[]>;
+declare function walkSourceFiles(targetPath: string, options?: WalkSourceFilesOptions): Promise<string[]>;
 
 interface ConsoleReportOptions {
     topLimit?: number;
@@ -262,4 +397,4 @@ declare const IGNORED_DIRECTORIES: readonly ["node_modules", ".next", "dist", "b
 /** fast-glob ignore patterns — match directories at any depth. */
 declare const IGNORE_PATTERNS: string[];
 
-export { type AnalysisReport, type AnalysisStats, type AnalyzeOptions, type ApplyOptions, type ApplyResult, CLASS_MERGE_CALLEES, type ClassCombination, type ClassNameExtraction, type ClassNameOccurrence, type ClassReplacement, type CombinationLocation, type CssGeneratorOptions, type CssGeneratorResult, DEFAULT_CLASS_PREFIX, type GenerateOptions, type GenerateResult, type GeneratedComponent, IGNORED_DIRECTORIES, IGNORE_PATTERNS, type ParseResult, type ReplaceClassNamesResult, type SkippedReplacement, analyzeCommand, applyCommand, assignComponentClassNames, buildComponents, calculatePotentialReduction, dedupeSubsetCombinations, extractClassesFromExpression, extractFromJSXAttribute, findFrequentPatterns, findRepeatedClassSets, generateCombinations, generateCommand, generateComponentCss, isClassAttribute, isStrictSubset, normalizeClassPrefix, normalizeClasses, parseFile, parseSource, parseSourceToAst, printConsoleReport, printJsonReport, replaceClassNamesInSource, scanProject, splitClassString, suggestClassName, walkSourceFiles, withClassPrefix };
+export { type AnalysisReport, type AnalysisStats, type AnalyzeOptions, type ApplyOptions, type ApplyResult, CLASS_MERGE_CALLEES, type ClassCombination, type ClassNameExtraction, type ClassNameOccurrence, type ClassReplacement, type CliCommand, type CombinationLocation, type CommandConfig, type CssGeneratorOptions, type CssGeneratorResult, type CustomNamesConfig, DEFAULT_CLASS_PREFIX, type GenerateOptions, type GenerateResult, type GeneratedComponent, IGNORED_DIRECTORIES, IGNORE_PATTERNS, type ParseResult, type ReplaceClassNamesResult, type SkippedReplacement, type TailwindUnwindConfig, type TailwindUnwindConfigFile, VARIANT_CALLEES, analyzeCommand, applyCommand, assignComponentClassNames, buildComponents, buildComponentsFromCombinations, calculatePotentialReduction, collectVariantRegistry, dedupeSubsetCombinations, extractClassesFromExpression, extractClassesFromVariantCall, extractFromJSXAttribute, findFrequentPatterns, findRepeatedClassSets, formatModifiedFiles, formatSource, generateCombinations, generateCommand, generateComponentCss, isClassAttribute, isStrictSubset, isVariantCallee, loadCommandOptions, loadExtractableCombinations, normalizeClassPrefix, normalizeClasses, normalizeNamesConfig, parseFile, parseSource, parseSourceToAst, printApplyJsonReport, printConsoleReport, printGenerateJsonReport, printJsonReport, replaceClassNamesInSource, scanProject, splitClassString, suggestClassName, validateConfigFile, walkSourceFiles, withClassPrefix };