tailwind-unwind 0.1.1 → 0.3.0

package/dist/{chunk-N7HD4T2I.js → chunk-4GXMK3NB.js}

@@ -1,3 +1,357 @@
+// src/config/validate.ts
+var CLASS_NAME_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
+var KNOWN_ROOT_KEYS = /* @__PURE__ */ new Set([
+  "include",
+  "exclude",
+  "names",
+  "prefix",
+  "output",
+  "minOccurrences",
+  "minSize",
+  "maxSize",
+  "top",
+  "dedupeSubsets",
+  "dryRun",
+  "prettier",
+  "fromReport",
+  "extractableOnly",
+  "analyze",
+  "generate",
+  "apply"
+]);
+var KNOWN_COMMAND_KEYS = /* @__PURE__ */ new Set([
+  "minOccurrences",
+  "minSize",
+  "maxSize",
+  "top",
+  "prefix",
+  "output",
+  "dedupeSubsets",
+  "dryRun",
+  "prettier",
+  "fromReport",
+  "extractableOnly"
+]);
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function assertPositiveNumber(value, path7, errors) {
+  if (value === void 0) {
+    return;
+  }
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 1) {
+    errors.push(`${path7} must be a positive number`);
+  }
+}
+function assertBoolean(value, path7, errors) {
+  if (value === void 0) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    errors.push(`${path7} must be a boolean`);
+  }
+}
+function assertStringArray(value, path7, errors) {
+  if (value === void 0) {
+    return;
+  }
+  if (!Array.isArray(value) || !value.every((item) => typeof item === "string" && item.length > 0)) {
+    errors.push(`${path7} must be an array of non-empty strings`);
+  }
+}
+function validateCommandSection(value, section, errors) {
+  if (value === void 0) {
+    return;
+  }
+  if (!isRecord(value)) {
+    errors.push(`${section} must be an object`);
+    return;
+  }
+  for (const key of Object.keys(value)) {
+    if (!KNOWN_COMMAND_KEYS.has(key)) {
+      errors.push(`Unknown key "${key}" in ${section}`);
+    }
+  }
+  assertPositiveNumber(value.minOccurrences, `${section}.minOccurrences`, errors);
+  assertPositiveNumber(value.minSize, `${section}.minSize`, errors);
+  assertPositiveNumber(value.maxSize, `${section}.maxSize`, errors);
+  assertPositiveNumber(value.top, `${section}.top`, errors);
+  assertBoolean(value.dedupeSubsets, `${section}.dedupeSubsets`, errors);
+  assertBoolean(value.dryRun, `${section}.dryRun`, errors);
+  assertBoolean(value.prettier, `${section}.prettier`, errors);
+  assertBoolean(value.extractableOnly, `${section}.extractableOnly`, errors);
+  if (value.fromReport !== void 0 && (typeof value.fromReport !== "string" || value.fromReport.length === 0)) {
+    errors.push(`${section}.fromReport must be a non-empty string`);
+  }
+  if (value.prefix !== void 0 && (typeof value.prefix !== "string" || value.prefix.length === 0)) {
+    errors.push(`${section}.prefix must be a non-empty string`);
+  }
+  if (value.output !== void 0 && (typeof value.output !== "string" || value.output.length === 0)) {
+    errors.push(`${section}.output must be a non-empty string`);
+  }
+}
+function validateNames(value, errors) {
+  if (value === void 0) {
+    return;
+  }
+  if (!isRecord(value)) {
+    errors.push('names must be an object of "utility string": "class-name" pairs');
+    return;
+  }
+  for (const [utilities, name] of Object.entries(value)) {
+    if (typeof utilities !== "string" || utilities.trim().length === 0) {
+      errors.push("names keys must be non-empty utility strings");
+      continue;
+    }
+    if (typeof name !== "string" || !CLASS_NAME_PATTERN.test(name)) {
+      errors.push(
+        `names["${utilities}"] must be a valid class name (letters, numbers, hyphens)`
+      );
+    }
+  }
+}
+function validateConfigFile(raw, configPath) {
+  if (!isRecord(raw)) {
+    throw new Error(`Invalid config in ${configPath}: root value must be an object`);
+  }
+  const source = isRecord(raw.default) ? raw.default : raw;
+  const errors = [];
+  for (const key of Object.keys(source)) {
+    if (!KNOWN_ROOT_KEYS.has(key)) {
+      errors.push(`Unknown config key "${key}"`);
+    }
+  }
+  assertStringArray(source.include, "include", errors);
+  assertStringArray(source.exclude, "exclude", errors);
+  assertPositiveNumber(source.minOccurrences, "minOccurrences", errors);
+  assertPositiveNumber(source.minSize, "minSize", errors);
+  assertPositiveNumber(source.maxSize, "maxSize", errors);
+  assertPositiveNumber(source.top, "top", errors);
+  assertBoolean(source.dedupeSubsets, "dedupeSubsets", errors);
+  assertBoolean(source.dryRun, "dryRun", errors);
+  assertBoolean(source.prettier, "prettier", errors);
+  assertBoolean(source.extractableOnly, "extractableOnly", errors);
+  if (source.fromReport !== void 0 && (typeof source.fromReport !== "string" || source.fromReport.length === 0)) {
+    errors.push("fromReport must be a non-empty string");
+  }
+  validateNames(source.names, errors);
+  validateCommandSection(source.analyze, "analyze", errors);
+  validateCommandSection(source.generate, "generate", errors);
+  validateCommandSection(source.apply, "apply", errors);
+  if (source.prefix !== void 0 && (typeof source.prefix !== "string" || source.prefix.length === 0)) {
+    errors.push("prefix must be a non-empty string");
+  }
+  if (source.output !== void 0 && (typeof source.output !== "string" || source.output.length === 0)) {
+    errors.push("output must be a non-empty string");
+  }
+  if (errors.length > 0) {
+    throw new Error(
+      `Invalid config in ${configPath}:
+${errors.map((error) => `  - ${error}`).join("\n")}`
+    );
+  }
+}
+function normalizeNamesConfig(names) {
+  const map = /* @__PURE__ */ new Map();
+  if (!names) {
+    return map;
+  }
+  for (const [utilities, baseName] of Object.entries(names)) {
+    const tokens = utilities.trim().split(/\s+/).filter((token) => token.length > 0);
+    const key = [...tokens].sort().join(" ");
+    map.set(key, baseName);
+  }
+  return map;
+}
+
+// src/config/loadConfig.ts
+import fs from "fs/promises";
+import path from "path";
+import { pathToFileURL } from "url";
+var CONFIG_FILENAMES = [
+  "tailwind-unwind.config.js",
+  "tailwind-unwind.config.mjs",
+  "tailwind-unwind.config.cjs",
+  "tailwind-unwind.config.json",
+  ".tailwind-unwindrc",
+  ".tailwind-unwindrc.json"
+];
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function pickNumber(source, key) {
+  const value = source[key];
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function pickCommandConfig(source) {
+  const config = {};
+  const minOccurrences = pickNumber(source, "minOccurrences");
+  if (minOccurrences !== void 0) config.minOccurrences = minOccurrences;
+  const minSize = pickNumber(source, "minSize");
+  if (minSize !== void 0) config.minSize = minSize;
+  const maxSize = pickNumber(source, "maxSize");
+  if (maxSize !== void 0) config.maxSize = maxSize;
+  const top = pickNumber(source, "top");
+  if (top !== void 0) config.top = top;
+  if (typeof source.prefix === "string" && source.prefix.length > 0) {
+    config.prefix = source.prefix;
+  }
+  if (typeof source.output === "string" && source.output.length > 0) {
+    config.output = source.output;
+  }
+  if (typeof source.dedupeSubsets === "boolean") {
+    config.dedupeSubsets = source.dedupeSubsets;
+  }
+  if (typeof source.dryRun === "boolean") {
+    config.dryRun = source.dryRun;
+  }
+  if (typeof source.prettier === "boolean") {
+    config.prettier = source.prettier;
+  }
+  if (typeof source.fromReport === "string" && source.fromReport.length > 0) {
+    config.fromReport = source.fromReport;
+  }
+  if (typeof source.extractableOnly === "boolean") {
+    config.extractableOnly = source.extractableOnly;
+  }
+  return config;
+}
+function pickNames(source) {
+  if (!isRecord2(source.names)) {
+    return void 0;
+  }
+  const names = {};
+  for (const [utilities, name] of Object.entries(source.names)) {
+    if (typeof utilities === "string" && typeof name === "string") {
+      names[utilities] = name;
+    }
+  }
+  return Object.keys(names).length > 0 ? names : void 0;
+}
+function normalizeLoadedConfig(raw) {
+  if (!isRecord2(raw)) {
+    return {};
+  }
+  const source = isRecord2(raw.default) ? raw.default : raw;
+  const config = {
+    ...pickCommandConfig(source)
+  };
+  const names = pickNames(source);
+  if (names) {
+    config.names = names;
+  }
+  if (Array.isArray(source.include)) {
+    config.include = source.include.filter(
+      (item) => typeof item === "string" && item.length > 0
+    );
+  }
+  if (Array.isArray(source.exclude)) {
+    config.exclude = source.exclude.filter(
+      (item) => typeof item === "string" && item.length > 0
+    );
+  }
+  if (isRecord2(source.analyze)) {
+    config.analyze = pickCommandConfig(source.analyze);
+  }
+  if (isRecord2(source.generate)) {
+    config.generate = pickCommandConfig(source.generate);
+  }
+  if (isRecord2(source.apply)) {
+    config.apply = pickCommandConfig(source.apply);
+  }
+  return config;
+}
+function mergeCommandConfig(command, fileConfig) {
+  const { analyze, generate: generate2, apply, ...root } = fileConfig;
+  const commandSection = command === "analyze" ? analyze : command === "generate" ? generate2 : apply;
+  return {
+    ...root,
+    ...commandSection
+  };
+}
+async function pathExists(targetPath) {
+  try {
+    await fs.access(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function collectSearchRoots(cwd, targetPath) {
+  const roots = [path.resolve(cwd)];
+  if (!targetPath) {
+    return roots;
+  }
+  let current = path.resolve(targetPath);
+  try {
+    const stat = await fs.stat(current);
+    if (stat.isFile()) {
+      current = path.dirname(current);
+    }
+  } catch {
+    return roots;
+  }
+  while (true) {
+    const resolved = path.resolve(current);
+    if (!roots.includes(resolved)) {
+      roots.push(resolved);
+    }
+    const parent = path.dirname(resolved);
+    if (parent === resolved) {
+      break;
+    }
+    current = parent;
+  }
+  return roots;
+}
+async function resolveConfigFile(explicitPath, searchRoots) {
+  if (explicitPath) {
+    const resolved = path.resolve(explicitPath);
+    if (!await pathExists(resolved)) {
+      throw new Error(`Config file not found: ${resolved}`);
+    }
+    return resolved;
+  }
+  for (const root of searchRoots) {
+    for (const filename of CONFIG_FILENAMES) {
+      const candidate = path.join(root, filename);
+      if (await pathExists(candidate)) {
+        return candidate;
+      }
+    }
+  }
+  return null;
+}
+async function importConfigModule(configPath) {
+  const moduleUrl = pathToFileURL(configPath).href;
+  const imported = await import(moduleUrl);
+  return imported;
+}
+async function readJsonConfig(configPath) {
+  const raw = await fs.readFile(configPath, "utf-8");
+  return JSON.parse(raw);
+}
+async function loadCommandOptions(command, cliOptions, options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  const searchRoots = await collectSearchRoots(cwd, options.targetPath);
+  const configPath = await resolveConfigFile(cliOptions.configPath, searchRoots);
+  if (!configPath) {
+    return cliOptions;
+  }
+  const isJson = configPath.endsWith(".json") || configPath.endsWith(".tailwind-unwindrc");
+  const loaded = isJson ? await readJsonConfig(configPath) : await importConfigModule(configPath);
+  validateConfigFile(loaded, configPath);
+  const fileConfig = mergeCommandConfig(command, normalizeLoadedConfig(loaded));
+  const { configPath: _ignored, ...cliOverrides } = cliOptions;
+  return {
+    ...fileConfig,
+    ...Object.fromEntries(
+      Object.entries(cliOverrides).filter(([, value]) => value !== void 0)
+    ),
+    configPath
+  };
+}
+
 // src/analyzer/suggestions.ts
 var BREAKPOINT_PREFIX = /^(sm|md|lg|xl|2xl):/;
 function baseClass(cls) {
@@ -607,6 +961,113 @@ function calculatePotentialReduction(occurrences, topCombinations) {
   return Math.min(100, Math.round(savable / totalClassUsages * 100));
 }
 
+// src/parser/variantHelpers.ts
+import babelTraverse from "@babel/traverse";
+var VARIANT_CALLEES = /* @__PURE__ */ new Set(["tv", "cva"]);
+function isVariantCallee(expression) {
+  if (expression.type === "Identifier") {
+    return VARIANT_CALLEES.has(expression.name);
+  }
+  if (expression.type === "MemberExpression" && expression.property.type === "Identifier") {
+    return VARIANT_CALLEES.has(expression.property.name);
+  }
+  return false;
+}
+function collectStringsFromObject(node) {
+  const classes = [];
+  for (const prop of node.properties) {
+    if (prop.type === "SpreadElement") {
+      continue;
+    }
+    if (prop.type !== "ObjectProperty") {
+      continue;
+    }
+    collectStringsFromPropertyValue(prop, classes);
+  }
+  return classes;
+}
+function collectStringsFromPropertyValue(prop, classes) {
+  const keyName = prop.key.type === "Identifier" ? prop.key.name : prop.key.type === "StringLiteral" ? prop.key.value : null;
+  const { value } = prop;
+  if (value.type === "StringLiteral") {
+    classes.push(...splitClassString(value.value));
+    return;
+  }
+  if (value.type === "ObjectExpression") {
+    if (keyName === "variants" || keyName === "compoundVariants") {
+      for (const nested of value.properties) {
+        if (nested.type === "ObjectProperty") {
+          collectStringsFromPropertyValue(nested, classes);
+        }
+      }
+      return;
+    }
+    classes.push(...collectStringsFromObject(value));
+    return;
+  }
+  if (value.type === "ArrayExpression") {
+    for (const element of value.elements) {
+      if (element === null || element.type === "SpreadElement") {
+        continue;
+      }
+      if (element.type === "StringLiteral") {
+        classes.push(...splitClassString(element.value));
+      } else if (element.type === "ObjectExpression") {
+        classes.push(...collectStringsFromObject(element));
+      }
+    }
+  }
+}
+function extractClassesFromVariantCall(call) {
+  const classes = [];
+  for (const arg of call.arguments) {
+    if (arg.type === "SpreadElement" || arg.type === "ArgumentPlaceholder") {
+      continue;
+    }
+    if (arg.type === "StringLiteral") {
+      classes.push(...splitClassString(arg.value));
+      continue;
+    }
+    if (arg.type === "ObjectExpression") {
+      classes.push(...collectStringsFromObject(arg));
+    }
+  }
+  return [...new Set(classes)];
+}
+function resolveTraverse(module) {
+  if (typeof module === "function") {
+    return module;
+  }
+  const withDefault = module;
+  if (typeof withDefault.default === "function") {
+    return withDefault.default;
+  }
+  throw new Error("Failed to load @babel/traverse");
+}
+var traverse = resolveTraverse(babelTraverse);
+function collectVariantRegistry(ast) {
+  const registry = /* @__PURE__ */ new Map();
+  traverse(ast, {
+    VariableDeclarator(path7) {
+      registerVariantDeclarator(path7.node, registry);
+    }
+  });
+  return registry;
+}
+function registerVariantDeclarator(declarator, registry) {
+  if (declarator.id.type !== "Identifier" || declarator.init?.type !== "CallExpression") {
+    return;
+  }
+  const { init } = declarator;
+  if (init.callee.type === "V8IntrinsicIdentifier" || !isVariantCallee(init.callee)) {
+    return;
+  }
+  const classes = extractClassesFromVariantCall(init);
+  if (classes.length > 0) {
+    registry.set(declarator.id.name, classes);
+  }
+}
+
 // src/parser/classHelpers.ts
 var CLASS_MERGE_CALLEES = /* @__PURE__ */ new Set([
   "cn",
@@ -649,18 +1110,34 @@ function isClassMergeCallee(expression) {
   }
   return false;
 }
-function extractFromCallArguments(args) {
+function extractFromCallArguments(args, registry) {
   const parts = [];
   for (const arg of args) {
     if (arg.type === "SpreadElement" || arg.type === "ArgumentPlaceholder") {
       parts.push({ classes: [], isDynamic: true });
       continue;
     }
-    parts.push(extractClassesFromExpression(arg));
+    parts.push(extractClassesFromExpression(arg, registry));
   }
   return mergeExtractions(parts);
 }
-function extractClassesFromExpression(expression) {
+function extractFromVariantCall(call, registry) {
+  const { callee } = call;
+  if (callee.type !== "V8IntrinsicIdentifier" && isVariantCallee(callee)) {
+    const classes = extractClassesFromVariantCall(call);
+    const hasDynamicArgs = call.arguments.some(
+      (arg) => arg.type === "SpreadElement" || arg.type === "ArgumentPlaceholder"
+    );
+    return { classes, isDynamic: hasDynamicArgs };
+  }
+  if (callee.type === "Identifier" && registry?.has(callee.name)) {
+    const classes = registry.get(callee.name) ?? [];
+    const hasArgs = call.arguments.length > 0;
+    return { classes, isDynamic: hasArgs };
+  }
+  return { classes: [], isDynamic: true };
+}
+function extractClassesFromExpression(expression, registry) {
   switch (expression.type) {
     case "StringLiteral":
       return extractFromStringLiteral(expression.value);
@@ -669,40 +1146,44 @@ function extractClassesFromExpression(expression) {
     case "CallExpression": {
       const { callee } = expression;
       if (callee.type !== "V8IntrinsicIdentifier" && isClassMergeCallee(callee)) {
-        return extractFromCallArguments(expression.arguments);
+        return extractFromCallArguments(expression.arguments, registry);
+      }
+      const variantExtraction = extractFromVariantCall(expression, registry);
+      if (variantExtraction.classes.length > 0 || !variantExtraction.isDynamic) {
+        return variantExtraction;
       }
       return { classes: [], isDynamic: true };
     }
     case "ConditionalExpression": {
       const merged = mergeExtractions([
-        extractClassesFromExpression(expression.consequent),
-        extractClassesFromExpression(expression.alternate)
+        extractClassesFromExpression(expression.consequent, registry),
+        extractClassesFromExpression(expression.alternate, registry)
       ]);
       return { ...merged, isDynamic: true };
     }
     case "LogicalExpression": {
       const merged = mergeExtractions([
-        extractClassesFromExpression(expression.left),
-        extractClassesFromExpression(expression.right)
+        extractClassesFromExpression(expression.left, registry),
+        extractClassesFromExpression(expression.right, registry)
       ]);
       return { ...merged, isDynamic: true };
     }
     case "ArrayExpression":
-      return extractFromArrayExpression(expression);
+      return extractFromArrayExpression(expression, registry);
     case "ObjectExpression":
       return extractFromObjectExpression(expression);
     default:
       return { classes: [], isDynamic: true };
   }
 }
-function extractFromArrayExpression(node) {
+function extractFromArrayExpression(node, registry) {
   const parts = [];
   for (const element of node.elements) {
     if (element === null || element.type === "SpreadElement") {
       parts.push({ classes: [], isDynamic: true });
       continue;
     }
-    parts.push(extractClassesFromExpression(element));
+    parts.push(extractClassesFromExpression(element, registry));
   }
   return mergeExtractions(parts);
 }
@@ -757,7 +1238,7 @@ function isClassAttribute(attr) {
   const name = getAttributeName(attr);
   return name !== null && CLASS_ATTRIBUTES.has(name);
 }
-function extractFromJSXAttribute(attr) {
+function extractFromJSXAttribute(attr, registry) {
   if (!isClassAttribute(attr)) {
     return null;
   }
@@ -767,7 +1248,7 @@ function extractFromJSXAttribute(attr) {
     return { classes: [], isDynamic: true, line };
   }
   if (value.type === "StringLiteral") {
-    const result = extractClassesFromExpression(value);
+    const result = extractClassesFromExpression(value, registry);
     return { classes: result.classes, isDynamic: result.isDynamic, line };
   }
   if (value.type === "JSXExpressionContainer") {
@@ -775,7 +1256,7 @@ function extractFromJSXAttribute(attr) {
     if (expr.type === "JSXEmptyExpression") {
       return { classes: [], isDynamic: true, line };
     }
-    const result = extractClassesFromExpression(expr);
+    const result = extractClassesFromExpression(expr, registry);
     return { classes: result.classes, isDynamic: result.isDynamic, line };
   }
   return { classes: [], isDynamic: true, line };
@@ -792,9 +1273,9 @@ function parseSourceToAst(source) {
 }
 
 // src/parser/jsxParser.ts
-import babelTraverse from "@babel/traverse";
-import fs from "fs/promises";
-function resolveTraverse(module) {
+import babelTraverse2 from "@babel/traverse";
+import fs2 from "fs/promises";
+function resolveTraverse2(module) {
   if (typeof module === "function") {
     return module;
   }
@@ -804,9 +1285,9 @@ function resolveTraverse(module) {
   }
   throw new Error("Failed to load @babel/traverse");
 }
-var traverse = resolveTraverse(babelTraverse);
-function isJSXElementWithClassAttribute(path5) {
-  const opening = path5.node.openingElement;
+var traverse2 = resolveTraverse2(babelTraverse2);
+function isJSXElementWithClassAttribute(path7) {
+  const opening = path7.node.openingElement;
   return opening.attributes.some(
     (attr) => attr.type === "JSXAttribute" && isClassAttribute(attr)
   );
@@ -814,15 +1295,16 @@ function isJSXElementWithClassAttribute(path5) {
 function collectExtractionsFromAst(ast, filePath) {
   const extractions = [];
   const warnings = [];
-  traverse(ast, {
-    JSXElement(path5) {
-      if (!isJSXElementWithClassAttribute(path5)) {
+  const variantRegistry = collectVariantRegistry(ast);
+  traverse2(ast, {
+    JSXElement(path7) {
+      if (!isJSXElementWithClassAttribute(path7)) {
         return;
       }
-      const opening = path5.node.openingElement;
+      const opening = path7.node.openingElement;
       for (const attr of opening.attributes) {
         if (attr.type !== "JSXAttribute") continue;
-        const extraction = extractFromJSXAttribute(attr);
+        const extraction = extractFromJSXAttribute(attr, variantRegistry);
         if (!extraction) continue;
         if (extraction.isDynamic && extraction.classes.length === 0) {
           const lineInfo = extraction.line ? `:${extraction.line}` : "";
@@ -854,7 +1336,7 @@ function parseSource(source, filePath = "unknown") {
   return { filePath, extractions, warnings };
 }
 async function parseFile(filePath) {
-  const source = await fs.readFile(filePath, "utf-8");
+  const source = await fs2.readFile(filePath, "utf-8");
   return parseSource(source, filePath);
 }
 
@@ -872,40 +1354,67 @@ var IGNORE_PATTERNS = IGNORED_DIRECTORIES.map(
 
 // src/scanner/fileWalker.ts
 import fg from "fast-glob";
-import path from "path";
+import path2 from "path";
 var SOURCE_EXTENSIONS = ["tsx", "jsx", "ts", "js"];
-async function walkSourceFiles(targetPath) {
-  const absolutePath = path.resolve(targetPath);
-  const patterns = SOURCE_EXTENSIONS.map(
-    (ext) => path.join(absolutePath, `**/*.${ext}`).replace(/\\/g, "/")
+function toAbsolutePattern(basePath, pattern) {
+  const normalized = pattern.replace(/\\/g, "/");
+  if (path2.isAbsolute(normalized)) {
+    return normalized;
+  }
+  return path2.join(basePath, normalized).replace(/\\/g, "/");
+}
+function buildIncludePatterns(basePath, include) {
+  if (include && include.length > 0) {
+    return include.map((pattern) => toAbsolutePattern(basePath, pattern));
+  }
+  return SOURCE_EXTENSIONS.map(
+    (ext) => path2.join(basePath, `**/*.${ext}`).replace(/\\/g, "/")
   );
+}
+function buildIgnorePatterns(exclude) {
+  const userExcludes = (exclude ?? []).map((pattern) => {
+    const normalized = pattern.replace(/\\/g, "/");
+    if (normalized.startsWith("**")) {
+      return normalized;
+    }
+    return `**/${normalized}`;
+  });
+  return [...IGNORE_PATTERNS, ...userExcludes];
+}
+async function walkSourceFiles(targetPath, options = {}) {
+  const absolutePath = path2.resolve(targetPath);
+  const patterns = buildIncludePatterns(absolutePath, options.include);
+  const ignore = buildIgnorePatterns(options.exclude);
   const files = await fg(patterns, {
     absolute: true,
     onlyFiles: true,
     unique: true,
-    ignore: IGNORE_PATTERNS,
+    ignore,
     dot: false
   });
   return files.sort();
 }
 
 // src/core/scanProject.ts
-import fs2 from "fs/promises";
-import path2 from "path";
-async function pathExists(targetPath) {
+import fs3 from "fs/promises";
+import path3 from "path";
+async function pathExists2(targetPath) {
   try {
-    await fs2.access(targetPath);
+    await fs3.access(targetPath);
     return true;
   } catch {
     return false;
   }
 }
 async function scanProject(options) {
-  const resolvedPath = path2.resolve(options.targetPath);
-  if (!await pathExists(resolvedPath)) {
+  const resolvedPath = path3.resolve(options.targetPath);
+  if (!await pathExists2(resolvedPath)) {
     throw new Error(`Path does not exist: ${resolvedPath}`);
   }
-  const files = await walkSourceFiles(resolvedPath);
+  const files = await walkSourceFiles(resolvedPath, {
+    include: options.include,
+    exclude: options.exclude
+  });
   if (files.length === 0) {
     throw new Error(
       `No source files (.tsx, .jsx, .ts, .js) found in: ${resolvedPath}`
@@ -931,13 +1440,26 @@ async function scanProject(options) {
       (occurrence) => normalizeClasses([...new Set(occurrence.classes)])
     )
   );
-  const topCombinations = findFrequentPatterns(occurrences, {
+  const frequentCombinations = findFrequentPatterns(occurrences, {
     minOccurrences: options.minOccurrences,
     minSize: options.minSize,
     maxSize: options.maxSize,
     topLimit: options.topLimit,
     dedupeSubsets: options.dedupeSubsets
   });
+  const extractableSets = findRepeatedClassSets(occurrences, {
+    minOccurrences: options.extractableMinOccurrences ?? 3,
+    minSize: options.minSize,
+    maxSize: options.maxSize,
+    topLimit: Number.POSITIVE_INFINITY
+  });
+  const extractableKeys = new Set(
+    extractableSets.map((combo) => combo.normalized)
+  );
+  const topCombinations = frequentCombinations.map((combo) => ({
+    ...combo,
+    extractable: extractableKeys.has(combo.normalized)
+  }));
   const potentialReductionPercent = calculatePotentialReduction(
     occurrences,
     topCombinations
@@ -1015,6 +1537,15 @@ function printConsoleReport(report, options = {}) {
       console.log(
         chalk.gray(`   Suggestion: `) + chalk.green(combo.suggestion)
       );
+      if (combo.extractable) {
+        console.log(
+          chalk.gray(`   Extractable: `) + chalk.green("yes \u2014 use generate/apply")
+        );
+      } else {
+        console.log(
+          chalk.gray(`   Extractable: `) + chalk.yellow("subset only \u2014 analyze hint")
+        );
+      }
       console.log(
         chalk.gray(`   Found in: `) + chalk.dim(formatLocations(combo.locations))
       );
@@ -1026,6 +1557,16 @@ function printConsoleReport(report, options = {}) {
       `\u{1F4A1} Potential code reduction: ${stats.potentialReductionPercent}%`
     )
   );
+  const extractableCount = stats.topCombinations.filter(
+    (combo) => combo.extractable
+  ).length;
+  if (extractableCount > 0) {
+    console.log(
+      chalk.magenta(
+        `\u{1F4A1} ${extractableCount} pattern(s) ready for generate/apply`
+      )
+    );
+  }
   console.log(
     chalk.magenta(
       "\u{1F4A1} Generate CSS: npx tailwind-unwind generate <path> --output styles.css"
@@ -1055,7 +1596,10 @@ async function analyzeCommand(targetPath, options = {}) {
       minSize: options.minSize,
       maxSize: options.maxSize,
       topLimit: options.top,
-      dedupeSubsets: options.dedupeSubsets
+      dedupeSubsets: options.dedupeSubsets,
+      include: options.include,
+      exclude: options.exclude,
+      extractableMinOccurrences: 3
     });
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -1076,11 +1620,66 @@ async function analyzeCommand(targetPath, options = {}) {
   return report;
 }
 
+// src/codemod/formatSource.ts
+import { createRequire } from "module";
+import path4 from "path";
+var require2 = createRequire(import.meta.url);
+async function loadPrettier() {
+  try {
+    const prettier = await import("prettier");
+    return prettier;
+  } catch {
+    try {
+      return require2("prettier");
+    } catch {
+      return null;
+    }
+  }
+}
+async function formatSource(source, options) {
+  const prettier = await loadPrettier();
+  if (!prettier) {
+    return { source, formatted: false };
+  }
+  try {
+    const config = await prettier.resolveConfig(options.filePath);
+    const formatted = await prettier.format(source, {
+      ...config,
+      filepath: options.filePath
+    });
+    return { source: formatted, formatted: true };
+  } catch {
+    return { source, formatted: false };
+  }
+}
+async function formatModifiedFiles(files, sources, cwd = process.cwd()) {
+  const formatted = [];
+  const skipped = [];
+  for (const file of files) {
+    const source = sources.get(file);
+    if (!source) {
+      skipped.push(file);
+      continue;
+    }
+    const result = await formatSource(source, {
+      filePath: path4.resolve(cwd, file),
+      cwd
+    });
+    if (result.formatted) {
+      sources.set(file, result.source);
+      formatted.push(file);
+    } else {
+      skipped.push(file);
+    }
+  }
+  return { formatted, skipped };
+}
+
 // src/codemod/replaceClassNames.ts
 import babelGenerate from "@babel/generator";
-import babelTraverse2 from "@babel/traverse";
+import babelTraverse3 from "@babel/traverse";
 import * as t from "@babel/types";
-function resolveTraverse2(module) {
+function resolveTraverse3(module) {
   if (typeof module === "function") {
     return module;
   }
@@ -1100,8 +1699,20 @@ function resolveGenerator(module) {
   }
   throw new Error("Failed to load @babel/generator");
 }
-var traverse2 = resolveTraverse2(babelTraverse2);
+var traverse3 = resolveTraverse3(babelTraverse3);
 var generate = resolveGenerator(babelGenerate);
+function isClassMergeCallee2(expression) {
+  if (expression.type === "Identifier") {
+    return CLASS_MERGE_CALLEES.has(expression.name);
+  }
+  if (expression.type === "MemberExpression" && expression.property.type === "Identifier") {
+    return CLASS_MERGE_CALLEES.has(expression.property.name);
+  }
+  return false;
+}
+function isClassMergeCall(expression) {
+  return expression.type === "CallExpression" && expression.callee.type !== "V8IntrinsicIdentifier" && isClassMergeCallee2(expression.callee);
+}
 function lookupReplacement(extraction, replacementMap) {
   if (extraction.isDynamic || extraction.classes.length === 0) {
     return null;
@@ -1112,6 +1723,126 @@ function lookupReplacement(extraction, replacementMap) {
 function setStringClassAttribute(attr, className) {
   attr.value = t.stringLiteral(className);
 }
+function tryReplaceMergeCall(call, replacementMap) {
+  const staticClasses = [];
+  const dynamicArgs = [];
+  for (const arg of call.arguments) {
+    if (arg.type === "SpreadElement" || arg.type === "ArgumentPlaceholder") {
+      dynamicArgs.push(arg);
+      continue;
+    }
+    const extracted = extractClassesFromExpression(arg);
+    if (extracted.isDynamic) {
+      dynamicArgs.push(arg);
+      continue;
+    }
+    staticClasses.push(...extracted.classes);
+  }
+  const combinedKey = normalizeClasses([...new Set(staticClasses)]);
+  const combinedReplacement = replacementMap.get(combinedKey);
+  if (combinedReplacement && staticClasses.length > 0) {
+    if (dynamicArgs.length === 0) {
+      return {
+        expression: t.stringLiteral(combinedReplacement),
+        from: combinedKey,
+        to: combinedReplacement,
+        partial: false
+      };
+    }
+    return {
+      expression: t.callExpression(call.callee, [
+        t.stringLiteral(combinedReplacement),
+        ...dynamicArgs
+      ]),
+      from: combinedKey,
+      to: combinedReplacement,
+      partial: true
+    };
+  }
+  let replaced = false;
+  let replacedTo = "";
+  let replacedFrom = "";
+  const newArgs = [...call.arguments];
+  for (let index = 0; index < call.arguments.length; index += 1) {
+    const arg = call.arguments[index];
+    if (arg === void 0 || arg.type === "SpreadElement" || arg.type === "ArgumentPlaceholder") {
+      continue;
+    }
+    const extracted = extractClassesFromExpression(arg);
+    if (extracted.isDynamic || extracted.classes.length === 0) {
+      continue;
+    }
+    const argKey = normalizeClasses(extracted.classes);
+    const replacement = replacementMap.get(argKey);
+    if (!replacement) {
+      continue;
+    }
+    newArgs[index] = t.stringLiteral(replacement);
+    if (!replaced) {
+      replacedFrom = argKey;
+      replacedTo = replacement;
+    }
+    replaced = true;
+  }
+  if (!replaced) {
+    return null;
+  }
+  return {
+    expression: t.callExpression(call.callee, newArgs),
+    from: replacedFrom,
+    to: replacedTo,
+    partial: true
+  };
+}
+function tryReplaceTemplateLiteral(attr, replacementMap, registry) {
+  const value = attr.value;
+  if (value?.type !== "JSXExpressionContainer") {
+    return null;
+  }
+  const expression = value.expression;
+  if (expression.type !== "TemplateLiteral" || expression.expressions.length === 0) {
+    return null;
+  }
+  const extracted = extractClassesFromExpression(expression, registry);
+  if (extracted.classes.length === 0) {
+    return null;
+  }
+  const key = normalizeClasses(extracted.classes);
+  const replacement = replacementMap.get(key);
+  if (!replacement) {
+    return null;
+  }
+  const newQuasis = expression.quasis.map((quasi, index) => {
+    if (index !== 0) {
+      return quasi;
+    }
+    const prefix = expression.expressions.length > 0 ? `${replacement} ` : replacement;
+    return t.templateElement(
+      { raw: prefix, cooked: prefix },
+      quasi.tail
+    );
+  });
+  return {
+    expression: t.templateLiteral(newQuasis, [...expression.expressions]),
+    from: key,
+    to: replacement,
+    partial: true
+  };
+}
+function tryReplaceClassAttribute(attr, replacementMap, registry) {
+  const value = attr.value;
+  if (value?.type !== "JSXExpressionContainer") {
+    return null;
+  }
+  const expression = value.expression;
+  if (expression.type === "JSXEmptyExpression") {
+    return null;
+  }
+  if (isClassMergeCall(expression)) {
+    return tryReplaceMergeCall(expression, replacementMap);
+  }
+  return tryReplaceTemplateLiteral(attr, replacementMap, registry);
+}
 function replaceClassNamesInSource(source, replacementMap, filePath) {
   const replacements = [];
   const skipped = [];
@@ -1125,15 +1856,36 @@ function replaceClassNamesInSource(source, replacementMap, filePath) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(`Failed to parse ${filePath}: ${message}`);
   }
-  traverse2(ast, {
-    JSXElement(path5) {
-      const opening = path5.node.openingElement;
+  const variantRegistry = collectVariantRegistry(ast);
+  traverse3(ast, {
+    JSXElement(path7) {
+      const opening = path7.node.openingElement;
       for (const attr of opening.attributes) {
         if (attr.type !== "JSXAttribute" || !isClassAttribute(attr)) {
           continue;
         }
-        const extraction = extractFromJSXAttribute(attr);
+        const extraction = extractFromJSXAttribute(attr, variantRegistry);
         if (!extraction) continue;
+        const mergeReplacement = tryReplaceClassAttribute(
+          attr,
+          replacementMap,
+          variantRegistry
+        );
+        if (mergeReplacement) {
+          if (mergeReplacement.expression.type === "StringLiteral") {
+            setStringClassAttribute(attr, mergeReplacement.expression.value);
+          } else {
+            attr.value = t.jsxExpressionContainer(mergeReplacement.expression);
+          }
+          replacements.push({
+            filePath,
+            line: extraction.line,
+            from: mergeReplacement.from,
+            to: mergeReplacement.to,
+            partial: mergeReplacement.partial
+          });
+          continue;
+        }
         const replacement = lookupReplacement(extraction, replacementMap);
         if (!replacement) {
           if (extraction.classes.length > 0) {
@@ -1192,10 +1944,15 @@ function withClassPrefix(baseName, prefix) {
 }
 
 // src/generator/cssGenerator.ts
+function resolveBaseClassName(classes, customNames) {
+  const key = normalizeClasses(classes);
+  return customNames.get(key) ?? suggestClassName(classes);
+}
 function assignComponentClassNames(combinations, options = {}) {
   const used = /* @__PURE__ */ new Set();
+  const customNames = normalizeNamesConfig(options.names);
   return combinations.map((combo) => {
-    const base = suggestClassName(combo.classes);
+    const base = resolveBaseClassName(combo.classes, customNames);
     let className = withClassPrefix(base, options.prefix);
     let suffix = 2;
     while (used.has(className)) {
@@ -1212,7 +1969,8 @@ function assignComponentClassNames(combinations, options = {}) {
 }
 function generateComponentCss(options) {
   const components = assignComponentClassNames(options.combinations, {
-    prefix: options.prefix
+    prefix: options.prefix,
+    names: options.names
   });
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
   const classPrefix = normalizeClassPrefix(options.prefix);
@@ -1258,7 +2016,22 @@ function buildComponents(occurrences, options) {
   const { css, components } = generateComponentCss({
     sourcePath: options.sourcePath,
     combinations,
-    prefix: options.prefix
+    prefix: options.prefix,
+    names: options.names
+  });
+  const replacementMap = /* @__PURE__ */ new Map();
+  for (const component of components) {
+    const key = [...component.classes].sort().join(" ");
+    replacementMap.set(key, component.className);
+  }
+  return { components, css, replacementMap };
+}
+function buildComponentsFromCombinations(combinations, options) {
+  const { css, components } = generateComponentCss({
+    sourcePath: options.sourcePath,
+    combinations,
+    prefix: options.prefix,
+    names: options.names
   });
   const replacementMap = /* @__PURE__ */ new Map();
   for (const component of components) {
@@ -1268,33 +2041,113 @@ function buildComponents(occurrences, options) {
   return { components, css, replacementMap };
 }
 
+// src/core/loadAnalyzeReport.ts
+import fs4 from "fs/promises";
+function isAnalysisReport(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const report = value;
+  return typeof report.targetPath === "string" && typeof report.stats === "object" && Array.isArray(report.stats.topCombinations);
+}
+async function loadExtractableCombinations(reportPath, options = {}) {
+  const raw = await fs4.readFile(reportPath, "utf-8");
+  const parsed = JSON.parse(raw);
+  if (!isAnalysisReport(parsed)) {
+    throw new Error(`Invalid analyze report: ${reportPath}`);
+  }
+  const combinations = parsed.stats.topCombinations.filter(
+    (combo) => options.extractableOnly === false ? true : combo.extractable === true
+  );
+  if (combinations.length === 0) {
+    throw new Error(
+      "No extractable combinations found in report. Re-run analyze or use --extractable-only=false."
+    );
+  }
+  return {
+    targetPath: parsed.targetPath,
+    combinations
+  };
+}
+
+// src/reporters/operationJsonReporter.ts
+function printGenerateJsonReport(report) {
+  console.log(JSON.stringify(report, null, 2));
+}
+function printApplyJsonReport(report) {
+  console.log(JSON.stringify(report, null, 2));
+}
+
 // src/commands/apply.ts
-import fs3 from "fs/promises";
-import path3 from "path";
+import fs5 from "fs/promises";
+import path5 from "path";
 import chalk3 from "chalk";
 async function applyCommand(targetPath, options) {
   let scanResult;
   try {
-    scanResult = await scanProject({ targetPath });
+    scanResult = await scanProject({
+      targetPath,
+      include: options.include,
+      exclude: options.exclude,
+      extractableMinOccurrences: options.minOccurrences ?? 3
+    });
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     console.error(chalk3.red(`Error: ${message}`));
     process.exit(1);
   }
   for (const warning of scanResult.warnings) {
-    console.warn(chalk3.yellow(`\u26A0 ${warning}`));
+    if (options.format !== "json") {
+      console.warn(chalk3.yellow(`\u26A0 ${warning}`));
+    }
   }
-  const { components, css, replacementMap } = buildComponents(
-    scanResult.occurrences,
-    {
-      sourcePath: scanResult.resolvedPath,
-      minOccurrences: options.minOccurrences ?? 3,
-      minSize: options.minSize,
-      maxSize: options.maxSize,
-      topLimit: options.top,
-      prefix: options.prefix
+  let components;
+  let css;
+  let replacementMap;
+  try {
+    if (options.fromReport) {
+      const loadedReport = await loadExtractableCombinations(options.fromReport, {
+        extractableOnly: options.extractableOnly ?? true
+      });
+      const built = buildComponentsFromCombinations(loadedReport.combinations, {
+        sourcePath: scanResult.resolvedPath,
+        prefix: options.prefix,
+        names: options.names
+      });
+      components = built.components;
+      css = built.css;
+      replacementMap = built.replacementMap;
+    } else if (options.extractableOnly) {
+      const combinations = scanResult.report.stats.topCombinations.filter(
+        (combo) => combo.extractable
+      );
+      const built = buildComponentsFromCombinations(combinations, {
+        sourcePath: scanResult.resolvedPath,
+        prefix: options.prefix,
+        names: options.names
+      });
+      components = built.components;
+      css = built.css;
+      replacementMap = built.replacementMap;
+    } else {
+      const built = buildComponents(scanResult.occurrences, {
+        sourcePath: scanResult.resolvedPath,
+        minOccurrences: options.minOccurrences ?? 3,
+        minSize: options.minSize,
+        maxSize: options.maxSize,
+        topLimit: options.top,
+        prefix: options.prefix,
+        names: options.names
+      });
+      components = built.components;
+      css = built.css;
+      replacementMap = built.replacementMap;
     }
-  );
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(chalk3.red(`Error: ${message}`));
+    process.exit(1);
+  }
   if (components.length === 0) {
     console.error(
       chalk3.yellow(
@@ -1303,29 +2156,71 @@ async function applyCommand(targetPath, options) {
     );
     process.exit(1);
   }
-  const outputPath = path3.resolve(options.output);
+  const outputPath = path5.resolve(options.output);
   let filesModified = 0;
   let replacementsTotal = 0;
   const allReplacements = [];
+  const allSkipped = [];
+  const modifiedSources = /* @__PURE__ */ new Map();
+  const modifiedFiles = [];
   for (const file of scanResult.files) {
-    const original = await fs3.readFile(file, "utf-8");
-    const result = replaceClassNamesInSource(
+    const original = await fs5.readFile(file, "utf-8");
+    const result2 = replaceClassNamesInSource(
       original,
       replacementMap,
       file
     );
-    replacementsTotal += result.replacements.length;
-    allReplacements.push(...result.replacements);
-    if (result.changed) {
+    replacementsTotal += result2.replacements.length;
+    allReplacements.push(...result2.replacements);
+    allSkipped.push(...result2.skipped);
+    if (result2.changed) {
       filesModified += 1;
-      if (!options.dryRun) {
-        await fs3.writeFile(file, result.source, "utf-8");
-      }
+      modifiedSources.set(file, result2.source);
+      modifiedFiles.push(file);
     }
   }
+  let prettierFormatted = [];
+  if (!options.dryRun && options.prettier && modifiedFiles.length > 0) {
+    const formatResult = await formatModifiedFiles(
+      modifiedFiles,
+      modifiedSources,
+      process.cwd()
+    );
+    prettierFormatted = formatResult.formatted;
+  }
   if (!options.dryRun) {
-    await fs3.mkdir(path3.dirname(outputPath), { recursive: true });
-    await fs3.writeFile(outputPath, css, "utf-8");
+    for (const file of modifiedFiles) {
+      const source = modifiedSources.get(file);
+      if (source) {
+        await fs5.writeFile(file, source, "utf-8");
+      }
+    }
+    await fs5.mkdir(path5.dirname(outputPath), { recursive: true });
+    await fs5.writeFile(outputPath, css, "utf-8");
+  }
+  const result = {
+    filesModified,
+    replacementsTotal,
+    outputPath,
+    componentsGenerated: components.length,
+    components,
+    replacements: allReplacements,
+    skipped: allSkipped,
+    prettierFormatted
+  };
+  if (options.format === "json") {
+    printApplyJsonReport({
+      command: "apply",
+      dryRun: Boolean(options.dryRun),
+      outputPath,
+      filesModified,
+      replacementsTotal,
+      componentsGenerated: components.length,
+      components,
+      replacements: allReplacements,
+      skipped: allSkipped
+    });
+    return result;
   }
   console.log("");
   if (options.dryRun) {
@@ -1343,13 +2238,30 @@ async function applyCommand(targetPath, options) {
   console.log(
     chalk3.gray(`   Replacements: `) + chalk3.white(String(replacementsTotal))
   );
+  if (prettierFormatted.length > 0) {
+    console.log(
+      chalk3.gray(`   Prettier formatted: `) + chalk3.white(String(prettierFormatted.length))
+    );
+  }
   if (allReplacements.length > 0) {
     console.log("");
     console.log(chalk3.bold("Replacements:"));
     for (const item of allReplacements) {
       const line = item.line ? `:${item.line}` : "";
+      const partialTag = item.partial ? chalk3.dim(" (partial)") : "";
+      console.log(
+        chalk3.gray(`  ${item.filePath}${line}`) + chalk3.white(` "${item.from}" `) + chalk3.cyan("\u2192") + chalk3.green(` "${item.to}"`) + partialTag
+      );
+    }
+  }
+  if (allSkipped.length > 0) {
+    console.log("");
+    console.log(chalk3.bold.yellow(`Skipped (${allSkipped.length}):`));
+    for (const item of allSkipped) {
+      const line = item.line ? `:${item.line}` : "";
+      const classes = item.classes.join(" ");
       console.log(
-        chalk3.gray(`  ${item.filePath}${line}`) + chalk3.white(` "${item.from}" `) + chalk3.cyan("\u2192") + chalk3.green(` "${item.to}"`)
+        chalk3.gray(`  ${item.filePath}${line}`) + chalk3.yellow(` [${item.reason}]`) + chalk3.dim(` "${classes}"`)
       );
     }
   }
@@ -1357,46 +2269,97 @@ async function applyCommand(targetPath, options) {
   if (!options.dryRun) {
     console.log(
       chalk3.cyan(
-        `Import ${path3.basename(outputPath)} in your global CSS if you haven't already.`
+        `Import ${path5.basename(outputPath)} in your global CSS if you haven't already.`
       )
     );
     console.log("");
   }
-  return {
-    filesModified,
-    replacementsTotal,
-    outputPath,
-    componentsGenerated: components.length
-  };
+  return result;
 }
 
 // src/commands/generate.ts
-import fs4 from "fs/promises";
-import path4 from "path";
+import fs6 from "fs/promises";
+import path6 from "path";
 import chalk4 from "chalk";
 async function generateCommand(targetPath, options) {
-  let scanResult;
+  let scanResult = null;
+  let components;
+  let css;
   try {
-    scanResult = await scanProject({ targetPath });
+    if (options.fromReport) {
+      const loadedReport = await loadExtractableCombinations(options.fromReport, {
+        extractableOnly: options.extractableOnly ?? true
+      });
+      const built = buildComponentsFromCombinations(loadedReport.combinations, {
+        sourcePath: loadedReport.targetPath || targetPath,
+        prefix: options.prefix,
+        names: options.names
+      });
+      components = built.components;
+      css = built.css;
+    } else {
+      scanResult = await scanProject({
+        targetPath,
+        include: options.include,
+        exclude: options.exclude,
+        extractableMinOccurrences: options.minOccurrences ?? 3
+      });
+      if (options.extractableOnly) {
+        const combinations = scanResult.report.stats.topCombinations.filter(
+          (combo) => combo.extractable
+        );
+        const built = buildComponentsFromCombinations(combinations, {
+          sourcePath: scanResult.resolvedPath,
+          prefix: options.prefix,
+          names: options.names
+        });
+        components = built.components;
+        css = built.css;
+      } else {
+        const built = buildComponents(scanResult.occurrences, {
+          sourcePath: scanResult.resolvedPath,
+          minOccurrences: options.minOccurrences ?? 3,
+          minSize: options.minSize,
+          maxSize: options.maxSize,
+          topLimit: options.top,
+          prefix: options.prefix,
+          names: options.names
+        });
+        components = built.components;
+        css = built.css;
+      }
+    }
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     console.error(chalk4.red(`Error: ${message}`));
     process.exit(1);
   }
-  for (const warning of scanResult.warnings) {
-    console.warn(chalk4.yellow(`\u26A0 ${warning}`));
+  if (scanResult) {
+    for (const warning of scanResult.warnings) {
+      if (options.format !== "json") {
+        console.warn(chalk4.yellow(`\u26A0 ${warning}`));
+      }
+    }
+  }
+  const outputPath = path6.resolve(options.output);
+  await fs6.mkdir(path6.dirname(outputPath), { recursive: true });
+  await fs6.writeFile(outputPath, css, "utf-8");
+  const result = {
+    outputPath,
+    componentsGenerated: components.length,
+    components,
+    report: scanResult?.report ?? null
+  };
+  if (options.format === "json") {
+    printGenerateJsonReport({
+      command: "generate",
+      outputPath,
+      componentsGenerated: components.length,
+      components,
+      cssWritten: true
+    });
+    return result;
   }
-  const { css, components } = buildComponents(scanResult.occurrences, {
-    sourcePath: scanResult.resolvedPath,
-    minOccurrences: options.minOccurrences ?? 3,
-    minSize: options.minSize,
-    maxSize: options.maxSize,
-    topLimit: options.top,
-    prefix: options.prefix
-  });
-  const outputPath = path4.resolve(options.output);
-  await fs4.mkdir(path4.dirname(outputPath), { recursive: true });
-  await fs4.writeFile(outputPath, css, "utf-8");
   console.log("");
   console.log(chalk4.bold.green("\u2705 CSS generated successfully"));
   console.log(chalk4.gray(`   Output: `) + chalk4.white(outputPath));
@@ -1425,14 +2388,13 @@ async function generateCommand(targetPath, options) {
     );
   }
   console.log("");
-  return {
-    outputPath,
-    componentsGenerated: components.length,
-    report: scanResult.report
-  };
+  return result;
 }
 
 export {
+  validateConfigFile,
+  normalizeNamesConfig,
+  loadCommandOptions,
   suggestClassName,
   isStrictSubset,
   dedupeSubsetCombinations,
@@ -1442,6 +2404,10 @@ export {
   findFrequentPatterns,
   findRepeatedClassSets,
   calculatePotentialReduction,
+  VARIANT_CALLEES,
+  isVariantCallee,
+  extractClassesFromVariantCall,
+  collectVariantRegistry,
   CLASS_MERGE_CALLEES,
   extractClassesFromExpression,
   isClassAttribute,
@@ -1456,6 +2422,8 @@ export {
   printConsoleReport,
   printJsonReport,
   analyzeCommand,
+  formatSource,
+  formatModifiedFiles,
   replaceClassNamesInSource,
   DEFAULT_CLASS_PREFIX,
   normalizeClassPrefix,
@@ -1463,7 +2431,11 @@ export {
   assignComponentClassNames,
   generateComponentCss,
   buildComponents,
+  buildComponentsFromCombinations,
+  loadExtractableCombinations,
+  printGenerateJsonReport,
+  printApplyJsonReport,
   applyCommand,
   generateCommand
 };
-//# sourceMappingURL=chunk-N7HD4T2I.js.map
+//# sourceMappingURL=chunk-4GXMK3NB.js.map