tailwindcss-patch 9.0.0-alpha.1 → 9.0.0-alpha.3

package/dist/{chunk-SWLOK2S6.mjs → chunk-D6ICWMM4.mjs}

@@ -20,10 +20,13 @@ import path from "pathe";
 // package.json
 var package_default = {
   name: "tailwindcss-patch",
-  version: "9.0.0-alpha.1",
+  version: "9.0.0-alpha.3",
   description: "patch tailwindcss for exposing context and extract classes",
   author: "ice breaker <1324318532@qq.com>",
   license: "MIT",
+  engines: {
+    node: ">=18.0.0"
+  },
   homepage: "https://mangle.icebreaker.top/",
   repository: {
     type: "git",
@@ -59,18 +62,23 @@ var package_default = {
   files: [
     "bin",
     "dist",
-    "schema"
+    "schema",
+    "src"
   ],
   scripts: {
     dev: "tsup --watch --sourcemap",
     build: "tsup",
     test: "vitest run",
+    "test:types": "pnpm build && tsd --typings dist/index.d.mts --files test-d/**/*.test-d.ts",
     "test:dev": "vitest",
     "bench:cold-start": "node --import tsx bench/cold-start.ts",
     patch: "tsx dev/bin.ts install",
     r0: "tsx dev/bin.ts extract",
     r1: "tsx dev/bin.ts extract --css index.css"
   },
+  tsd: {
+    directory: "test-d"
+  },
   publishConfig: {
     access: "public",
     registry: "https://registry.npmjs.org/",
@@ -2099,14 +2107,12 @@ function groupTokensByFile(report, options) {
   const stripAbsolute = options?.stripAbsolutePaths ?? key !== "absolute";
   return report.entries.reduce((acc, entry) => {
     const bucketKey = key === "absolute" ? entry.file : entry.relativeFile;
-    if (!acc[bucketKey]) {
-      acc[bucketKey] = [];
-    }
+    const bucket = acc[bucketKey] ?? (acc[bucketKey] = []);
     const value = stripAbsolute ? {
       ...entry,
       file: entry.relativeFile
     } : entry;
-    acc[bucketKey].push(value);
+    bucket.push(value);
     return acc;
   }, {});
 }
@@ -2121,18 +2127,22 @@ function isObject(val) {
   return val !== null && typeof val === "object" && Array.isArray(val) === false;
 }
 function spliceChangesIntoString(str, changes) {
-  if (!changes[0]) {
+  const firstChange = changes[0];
+  if (!firstChange) {
     return str;
   }
   changes.sort((a, b) => {
     return a.end - b.end || a.start - b.start;
   });
   let result = "";
-  let previous = changes[0];
+  let previous = firstChange;
   result += str.slice(0, previous.start);
   result += previous.replacement;
   for (let i = 1; i < changes.length; ++i) {
     const change = changes[i];
+    if (!change) {
+      continue;
+    }
     result += str.slice(previous.end, change.start);
     result += change.replacement;
     previous = change;
@@ -2398,8 +2408,8 @@ function transformProcessTailwindFeaturesReturnContextV2(content) {
   });
   let hasPatched = false;
   traverse(ast, {
-    FunctionDeclaration(path18) {
-      const node = path18.node;
+    FunctionDeclaration(path15) {
+      const node = path15.node;
       if (node.id?.name !== "processTailwindFeatures" || node.body.body.length !== 1 || !t.isReturnStatement(node.body.body[0])) {
         return;
       }
@@ -2430,8 +2440,8 @@ function transformPostcssPluginV2(content, options) {
   const ast = parse(content);
   let hasPatched = false;
   traverse(ast, {
-    Program(path18) {
-      const program = path18.node;
+    Program(path15) {
+      const program = path15.node;
       const index = program.body.findIndex((statement) => {
         return t.isFunctionDeclaration(statement) && statement.id?.name === "_default";
       });
@@ -2441,7 +2451,12 @@ function transformPostcssPluginV2(content, options) {
       const previous = program.body[index - 1];
       const beforePrevious = program.body[index - 2];
       const alreadyHasVariable = Boolean(
-        previous && t.isVariableDeclaration(previous) && previous.declarations.length === 1 && t.isIdentifier(previous.declarations[0].id) && previous.declarations[0].id.name === refIdentifier.name
+        previous && t.isVariableDeclaration(previous) && previous.declarations.length === 1 && (() => {
+          const declaration = previous.declarations[0];
+          return Boolean(
+            declaration && t.isIdentifier(declaration.id) && declaration.id.name === refIdentifier.name
+          );
+        })()
       );
       const alreadyAssignsExports = Boolean(
         beforePrevious && t.isExpressionStatement(beforePrevious) && t.isAssignmentExpression(beforePrevious.expression) && t.isMemberExpression(beforePrevious.expression.left) && t.isIdentifier(beforePrevious.expression.right) && beforePrevious.expression.right.name === refIdentifier.name && generate(beforePrevious.expression.left).code === generate(exportMember).code
@@ -2465,11 +2480,11 @@ function transformPostcssPluginV2(content, options) {
         );
       }
     },
-    FunctionDeclaration(path18) {
+    FunctionDeclaration(path15) {
       if (hasPatched) {
         return;
       }
-      const fn = path18.node;
+      const fn = path15.node;
       if (fn.id?.name !== "_default") {
         return;
       }
@@ -2558,8 +2573,8 @@ function transformProcessTailwindFeaturesReturnContext(content) {
   const ast = parse(content);
   let hasPatched = false;
   traverse(ast, {
-    FunctionDeclaration(path18) {
-      const node = path18.node;
+    FunctionDeclaration(path15) {
+      const node = path15.node;
       if (node.id?.name !== "processTailwindFeatures" || node.body.body.length !== 1) {
         return;
       }
@@ -2591,8 +2606,8 @@ function transformPostcssPlugin(content, { refProperty }) {
   const valueMember = t2.memberExpression(refIdentifier, t2.identifier("value"));
   let hasPatched = false;
   traverse(ast, {
-    Program(path18) {
-      const program = path18.node;
+    Program(path15) {
+      const program = path15.node;
       const index = program.body.findIndex((statement) => {
         return t2.isExpressionStatement(statement) && t2.isAssignmentExpression(statement.expression) && t2.isMemberExpression(statement.expression.left) && t2.isFunctionExpression(statement.expression.right) && statement.expression.right.id?.name === "tailwindcss";
       });
@@ -2602,7 +2617,12 @@ function transformPostcssPlugin(content, { refProperty }) {
       const previousStatement = program.body[index - 1];
       const lastStatement = program.body[program.body.length - 1];
       const alreadyHasVariable = Boolean(
-        previousStatement && t2.isVariableDeclaration(previousStatement) && previousStatement.declarations.length === 1 && t2.isIdentifier(previousStatement.declarations[0].id) && previousStatement.declarations[0].id.name === refIdentifier.name
+        previousStatement && t2.isVariableDeclaration(previousStatement) && previousStatement.declarations.length === 1 && (() => {
+          const declaration = previousStatement.declarations[0];
+          return Boolean(
+            declaration && t2.isIdentifier(declaration.id) && declaration.id.name === refIdentifier.name
+          );
+        })()
       );
       const alreadyAssignsModuleExports = Boolean(
         t2.isExpressionStatement(lastStatement) && t2.isAssignmentExpression(lastStatement.expression) && t2.isMemberExpression(lastStatement.expression.left) && t2.isIdentifier(lastStatement.expression.right) && lastStatement.expression.right.name === refIdentifier.name && generate(lastStatement.expression.left).code === generate(moduleExportsMember).code
@@ -2630,11 +2650,11 @@ function transformPostcssPlugin(content, { refProperty }) {
         );
       }
     },
-    FunctionExpression(path18) {
+    FunctionExpression(path15) {
       if (hasPatched) {
         return;
       }
-      const fn = path18.node;
+      const fn = path15.node;
       if (fn.id?.name !== "tailwindcss" || fn.body.body.length !== 1) {
         return;
       }
@@ -2713,21 +2733,21 @@ function updateLengthUnitsArray(content, options) {
   let arrayRef;
   let changed = false;
   traverse(ast, {
-    Identifier(path18) {
-      if (path18.node.name === variableName && t3.isVariableDeclarator(path18.parent) && t3.isArrayExpression(path18.parent.init)) {
-        arrayRef = path18.parent.init;
+    Identifier(path15) {
+      if (path15.node.name === variableName && t3.isVariableDeclarator(path15.parent) && t3.isArrayExpression(path15.parent.init)) {
+        arrayRef = path15.parent.init;
         const existing = new Set(
-          path18.parent.init.elements.map((element) => t3.isStringLiteral(element) ? element.value : void 0).filter(Boolean)
+          path15.parent.init.elements.map((element) => t3.isStringLiteral(element) ? element.value : void 0).filter(Boolean)
         );
         for (const unit of units) {
           if (!existing.has(unit)) {
-            path18.parent.init.elements = path18.parent.init.elements.map((element) => {
+            path15.parent.init.elements = path15.parent.init.elements.map((element) => {
               if (t3.isStringLiteral(element)) {
                 return t3.stringLiteral(element.value);
               }
               return element;
             });
-            path18.parent.init.elements.push(t3.stringLiteral(unit));
+            path15.parent.init.elements.push(t3.stringLiteral(unit));
             changed = true;
           }
         }
@@ -2808,13 +2828,13 @@ function applyExtendLengthUnitsPatchV4(rootDir, options) {
     const { code, file, match } = item;
     const ast = parse(match[0], { sourceType: "unambiguous" });
     traverse(ast, {
-      ArrayExpression(path18) {
+      ArrayExpression(path15) {
         for (const unit of opts.units) {
-          if (path18.node.elements.some((element) => t3.isStringLiteral(element) && element.value === unit)) {
+          if (path15.node.elements.some((element) => t3.isStringLiteral(element) && element.value === unit)) {
             item.hasPatched = true;
             return;
           }
-          path18.node.elements.push(t3.stringLiteral(unit));
+          path15.node.elements.push(t3.stringLiteral(unit));
         }
       }
     });
@@ -2850,14 +2870,14 @@ function inspectLengthUnitsArray(content, variableName, units) {
   let found = false;
   let missingUnits = [];
   traverse(ast, {
-    Identifier(path18) {
-      if (path18.node.name === variableName && t4.isVariableDeclarator(path18.parent) && t4.isArrayExpression(path18.parent.init)) {
+    Identifier(path15) {
+      if (path15.node.name === variableName && t4.isVariableDeclarator(path15.parent) && t4.isArrayExpression(path15.parent.init)) {
         found = true;
         const existing = new Set(
-          path18.parent.init.elements.map((element) => t4.isStringLiteral(element) ? element.value : void 0).filter(Boolean)
+          path15.parent.init.elements.map((element) => t4.isStringLiteral(element) ? element.value : void 0).filter(Boolean)
         );
         missingUnits = units.filter((unit) => !existing.has(unit));
-        path18.stop();
+        path15.stop();
       }
     }
   });
@@ -4261,6 +4281,9 @@ async function restoreConfigFiles(options) {
   };
 }
 
+// src/commands/types.ts
+var tailwindcssPatchCommands = ["install", "extract", "tokens", "init", "migrate", "restore", "validate", "status"];
+
 // src/commands/validate.ts
 var VALIDATE_EXIT_CODES = {
   OK: 0,
@@ -4319,707 +4342,12 @@ var ValidateCommandError = class extends Error {
   }
 };
 
-// src/commands/types.ts
-var tailwindcssPatchCommands = ["install", "extract", "tokens", "init", "migrate", "restore", "validate", "status"];
-
-// src/commands/cli.ts
-import cac from "cac";
-
-// src/commands/command-definitions.ts
-import process7 from "process";
-
-// src/commands/token-output.ts
-var TOKEN_FORMATS = ["json", "lines", "grouped-json"];
-var DEFAULT_TOKEN_REPORT = ".tw-patch/tw-token-report.json";
-function formatTokenLine(entry) {
-  return `${entry.relativeFile}:${entry.line}:${entry.column} ${entry.rawCandidate} (${entry.start}-${entry.end})`;
-}
-function formatGroupedPreview(map, limit = 3) {
-  const files = Object.keys(map);
-  if (!files.length) {
-    return { preview: "", moreFiles: 0 };
-  }
-  const lines = files.slice(0, limit).map((file) => {
-    const tokens = map[file] ?? [];
-    const sample = tokens.slice(0, 3).map((token) => token.rawCandidate).join(", ");
-    const suffix = tokens.length > 3 ? ", \u2026" : "";
-    return `${file}: ${tokens.length} tokens (${sample}${suffix})`;
-  });
-  return {
-    preview: lines.join("\n"),
-    moreFiles: Math.max(0, files.length - limit)
-  };
-}
-
-// src/commands/command-definitions.ts
-function createCwdOptionDefinition(description = "Working directory") {
-  return {
-    flags: "--cwd <dir>",
-    description,
-    config: { default: process7.cwd() }
-  };
-}
-function buildDefaultCommandDefinitions() {
-  return {
-    install: {
-      description: "Apply Tailwind CSS runtime patches",
-      optionDefs: [createCwdOptionDefinition()]
-    },
-    extract: {
-      description: "Collect generated class names into a cache file",
-      optionDefs: [
-        createCwdOptionDefinition(),
-        { flags: "--output <file>", description: "Override output file path" },
-        { flags: "--format <format>", description: "Output format (json|lines)" },
-        { flags: "--css <file>", description: "Tailwind CSS entry CSS when using v4" },
-        { flags: "--no-write", description: "Skip writing to disk" }
-      ]
-    },
-    tokens: {
-      description: "Extract Tailwind tokens with file/position metadata",
-      optionDefs: [
-        createCwdOptionDefinition(),
-        { flags: "--output <file>", description: "Override output file path", config: { default: DEFAULT_TOKEN_REPORT } },
-        {
-          flags: "--format <format>",
-          description: "Output format (json|lines|grouped-json)",
-          config: { default: "json" }
-        },
-        {
-          flags: "--group-key <key>",
-          description: "Grouping key for grouped-json output (relative|absolute)",
-          config: { default: "relative" }
-        },
-        { flags: "--no-write", description: "Skip writing to disk" }
-      ]
-    },
-    init: {
-      description: "Generate a tailwindcss-patch config file",
-      optionDefs: [createCwdOptionDefinition()]
-    },
-    migrate: {
-      description: "Migrate deprecated config fields to modern options",
-      optionDefs: [
-        createCwdOptionDefinition(),
-        { flags: "--config <file>", description: "Migrate a specific config file path" },
-        { flags: "--workspace", description: "Scan workspace recursively for config files" },
-        { flags: "--max-depth <n>", description: "Maximum recursion depth for --workspace", config: { default: 6 } },
-        { flags: "--include <glob>", description: "Only migrate files that match this glob (repeatable)" },
-        { flags: "--exclude <glob>", description: "Skip files that match this glob (repeatable)" },
-        { flags: "--report-file <file>", description: "Write migration report JSON to a file" },
-        { flags: "--backup-dir <dir>", description: "Write pre-migration backups into this directory" },
-        { flags: "--check", description: "Exit with an error when migration changes are required" },
-        { flags: "--json", description: "Print the migration report as JSON" },
-        { flags: "--dry-run", description: "Preview changes without writing files" }
-      ]
-    },
-    restore: {
-      description: "Restore config files from a previous migration report backup snapshot",
-      optionDefs: [
-        createCwdOptionDefinition(),
-        { flags: "--report-file <file>", description: "Migration report file generated by migrate" },
-        { flags: "--dry-run", description: "Preview restore targets without writing files" },
-        { flags: "--strict", description: "Fail when any backup file is missing" },
-        { flags: "--json", description: "Print the restore result as JSON" }
-      ]
-    },
-    validate: {
-      description: "Validate migration report compatibility without modifying files",
-      optionDefs: [
-        createCwdOptionDefinition(),
-        { flags: "--report-file <file>", description: "Migration report file to validate" },
-        { flags: "--strict", description: "Fail when any backup file is missing" },
-        { flags: "--json", description: "Print validation result as JSON" }
-      ]
-    },
-    status: {
-      description: "Check which Tailwind patches are applied",
-      optionDefs: [
-        createCwdOptionDefinition(),
-        { flags: "--json", description: "Print a JSON report of patch status" }
-      ]
-    }
-  };
-}
-
-// src/commands/command-metadata.ts
-function addPrefixIfMissing(value, prefix) {
-  if (!prefix || value.startsWith(prefix)) {
-    return value;
-  }
-  return `${prefix}${value}`;
-}
-function resolveCommandNames(command, mountOptions, prefix) {
-  const override = mountOptions.commandOptions?.[command];
-  const baseName = override?.name ?? command;
-  const name = addPrefixIfMissing(baseName, prefix);
-  const aliases = (override?.aliases ?? []).map((alias) => addPrefixIfMissing(alias, prefix));
-  return { name, aliases };
-}
-function resolveOptionDefinitions(defaults, override) {
-  if (!override) {
-    return defaults;
-  }
-  const appendDefaults = override.appendDefaultOptions ?? true;
-  const customDefs = override.optionDefs ?? [];
-  if (!appendDefaults) {
-    return customDefs;
-  }
-  if (customDefs.length === 0) {
-    return defaults;
-  }
-  return [...defaults, ...customDefs];
-}
-function resolveCommandMetadata(command, mountOptions, prefix, defaults) {
-  const names = resolveCommandNames(command, mountOptions, prefix);
-  const definition = defaults[command];
-  const override = mountOptions.commandOptions?.[command];
-  const description = override?.description ?? definition.description;
-  const optionDefs = resolveOptionDefinitions(definition.optionDefs, override);
-  return { ...names, description, optionDefs };
-}
-function applyCommandOptions(command, optionDefs) {
-  for (const option of optionDefs) {
-    command.option(option.flags, option.description ?? "", option.config);
-  }
-}
-
-// src/commands/command-context.ts
-import process8 from "process";
-import path15 from "pathe";
-function resolveCommandCwd(rawCwd) {
-  if (!rawCwd) {
-    return process8.cwd();
-  }
-  return path15.resolve(rawCwd);
-}
-function createMemoizedPromiseRunner(factory) {
-  let promise;
-  return () => {
-    if (!promise) {
-      promise = factory();
-    }
-    return promise;
-  };
-}
-function createTailwindcssPatchCommandContext(cli, command, commandName, args, cwd) {
-  const loadCachedConfig = createMemoizedPromiseRunner(
-    () => loadWorkspaceConfigModule().then((mod) => mod.getConfig(cwd))
-  );
-  const loadCachedPatchOptions = createMemoizedPromiseRunner(
-    () => loadPatchOptionsForWorkspace(cwd)
-  );
-  const createCachedPatcher = createMemoizedPromiseRunner(async () => {
-    const patchOptions = await loadCachedPatchOptions();
-    return new TailwindcssPatcher(patchOptions);
-  });
-  const loadPatchOptionsForContext = (overrides) => {
-    if (overrides) {
-      return loadPatchOptionsForWorkspace(cwd, overrides);
-    }
-    return loadCachedPatchOptions();
-  };
-  const createPatcherForContext = async (overrides) => {
-    if (overrides) {
-      const patchOptions = await loadPatchOptionsForWorkspace(cwd, overrides);
-      return new TailwindcssPatcher(patchOptions);
-    }
-    return createCachedPatcher();
-  };
-  return {
-    cli,
-    command,
-    commandName,
-    args,
-    cwd,
-    logger: logger_default,
-    loadConfig: loadCachedConfig,
-    loadPatchOptions: loadPatchOptionsForContext,
-    createPatcher: createPatcherForContext
-  };
-}
-
-// src/commands/command-runtime.ts
-function runWithCommandHandler(cli, command, commandName, args, handler, defaultHandler) {
-  const cwd = resolveCommandCwd(args.cwd);
-  const context = createTailwindcssPatchCommandContext(cli, command, commandName, args, cwd);
-  const runDefault = createMemoizedPromiseRunner(() => defaultHandler(context));
-  if (!handler) {
-    return runDefault();
-  }
-  return handler(context, runDefault);
-}
-
-// src/commands/basic-handlers.ts
-import process9 from "process";
-import fs15 from "fs-extra";
-import path16 from "pathe";
-var DEFAULT_CONFIG_NAME = "tailwindcss-mangle";
-async function installCommandDefaultHandler(_ctx) {
-  const patcher = await _ctx.createPatcher();
-  await patcher.patch();
-  logger_default.success("Tailwind CSS runtime patched successfully.");
-}
-async function extractCommandDefaultHandler(ctx) {
-  const { args } = ctx;
-  const overrides = {};
-  let hasOverrides = false;
-  if (args.output || args.format) {
-    overrides.extract = {
-      ...args.output === void 0 ? {} : { file: args.output },
-      ...args.format === void 0 ? {} : { format: args.format }
-    };
-    hasOverrides = true;
-  }
-  if (args.css) {
-    overrides.tailwindcss = {
-      v4: {
-        cssEntries: [args.css]
-      }
-    };
-    hasOverrides = true;
-  }
-  const patcher = await ctx.createPatcher(hasOverrides ? overrides : void 0);
-  const extractOptions = args.write === void 0 ? {} : { write: args.write };
-  const result = await patcher.extract(extractOptions);
-  if (result.filename) {
-    logger_default.success(`Collected ${result.classList.length} classes \u2192 ${result.filename}`);
-  } else {
-    logger_default.success(`Collected ${result.classList.length} classes.`);
-  }
-  return result;
-}
-async function tokensCommandDefaultHandler(ctx) {
-  const { args } = ctx;
-  const patcher = await ctx.createPatcher();
-  const report = await patcher.collectContentTokens();
-  const shouldWrite = args.write ?? true;
-  let format = args.format ?? "json";
-  if (!TOKEN_FORMATS.includes(format)) {
-    format = "json";
-  }
-  const targetFile = args.output ?? DEFAULT_TOKEN_REPORT;
-  const groupKey = args.groupKey === "absolute" ? "absolute" : "relative";
-  const buildGrouped = () => groupTokensByFile(report, {
-    key: groupKey,
-    stripAbsolutePaths: groupKey !== "absolute"
-  });
-  const grouped = format === "grouped-json" ? buildGrouped() : null;
-  const resolveGrouped = () => grouped ?? buildGrouped();
-  if (shouldWrite) {
-    const target = path16.resolve(targetFile);
-    await fs15.ensureDir(path16.dirname(target));
-    if (format === "json") {
-      await fs15.writeJSON(target, report, { spaces: 2 });
-    } else if (format === "grouped-json") {
-      await fs15.writeJSON(target, resolveGrouped(), { spaces: 2 });
-    } else {
-      const lines = report.entries.map(formatTokenLine);
-      await fs15.writeFile(target, `${lines.join("\n")}
-`, "utf8");
-    }
-    logger_default.success(`Collected ${report.entries.length} tokens (${format}) \u2192 ${target.replace(process9.cwd(), ".")}`);
-  } else {
-    logger_default.success(`Collected ${report.entries.length} tokens from ${report.filesScanned} files.`);
-    if (format === "lines") {
-      const preview = report.entries.slice(0, 5).map(formatTokenLine).join("\n");
-      if (preview) {
-        logger_default.log("");
-        logger_default.info(preview);
-        if (report.entries.length > 5) {
-          logger_default.info(`\u2026and ${report.entries.length - 5} more.`);
-        }
-      }
-    } else if (format === "grouped-json") {
-      const map = resolveGrouped();
-      const { preview, moreFiles } = formatGroupedPreview(map);
-      if (preview) {
-        logger_default.log("");
-        logger_default.info(preview);
-        if (moreFiles > 0) {
-          logger_default.info(`\u2026and ${moreFiles} more files.`);
-        }
-      }
-    } else {
-      const previewEntries = report.entries.slice(0, 3);
-      if (previewEntries.length) {
-        logger_default.log("");
-        logger_default.info(JSON.stringify(previewEntries, null, 2));
-      }
-    }
-  }
-  if (report.skippedFiles.length) {
-    logger_default.warn("Skipped files:");
-    for (const skipped of report.skippedFiles) {
-      logger_default.warn(`  \u2022 ${skipped.file} (${skipped.reason})`);
-    }
-  }
-  return report;
-}
-async function initCommandDefaultHandler(ctx) {
-  const configModule = await loadWorkspaceConfigModule();
-  await configModule.initConfig(ctx.cwd);
-  const configName = configModule.CONFIG_NAME || DEFAULT_CONFIG_NAME;
-  logger_default.success(`\u2728 ${configName}.config.ts initialized!`);
-}
-
-// src/commands/migration-args.ts
-function normalizePatternArgs(value) {
-  if (!value) {
-    return void 0;
-  }
-  const raw = Array.isArray(value) ? value : [value];
-  const values = raw.flatMap((item) => item.split(",")).map((item) => item.trim()).filter(Boolean);
-  return values.length > 0 ? values : void 0;
-}
-function parseMaxDepth(value) {
-  if (value === void 0) {
-    return {
-      maxDepth: void 0,
-      hasInvalidMaxDepth: false
-    };
-  }
-  const parsed = Number(value);
-  if (!Number.isFinite(parsed) || parsed < 0) {
-    return {
-      maxDepth: void 0,
-      hasInvalidMaxDepth: true
-    };
-  }
-  return {
-    maxDepth: Math.floor(parsed),
-    hasInvalidMaxDepth: false
-  };
-}
-function resolveMigrateCommandArgs(args) {
-  const include = normalizePatternArgs(args.include);
-  const exclude = normalizePatternArgs(args.exclude);
-  const { maxDepth, hasInvalidMaxDepth } = parseMaxDepth(args.maxDepth);
-  const checkMode = args.check ?? false;
-  const dryRun = args.dryRun ?? checkMode;
-  return {
-    include,
-    exclude,
-    maxDepth,
-    checkMode,
-    dryRun,
-    hasInvalidMaxDepth
-  };
-}
-function resolveRestoreCommandArgs(args) {
-  return {
-    reportFile: args.reportFile ?? ".tw-patch/migrate-report.json",
-    dryRun: args.dryRun ?? false,
-    strict: args.strict ?? false
-  };
-}
-function resolveValidateCommandArgs(args) {
-  return {
-    reportFile: args.reportFile ?? ".tw-patch/migrate-report.json",
-    strict: args.strict ?? false
-  };
-}
-
-// src/commands/migration-output.ts
-import process10 from "process";
-import fs16 from "fs-extra";
-import path17 from "pathe";
-function formatPathForLog(file) {
-  return file.replace(process10.cwd(), ".");
-}
-function createMigrationCheckFailureError(changedFiles) {
-  return new Error(`Migration check failed: ${changedFiles} file(s) still need migration.`);
-}
-async function writeMigrationReportFile(cwd, reportFile, report) {
-  const reportPath = path17.resolve(cwd, reportFile);
-  await fs16.ensureDir(path17.dirname(reportPath));
-  await fs16.writeJSON(reportPath, report, { spaces: 2 });
-  logger_default.info(`Migration report written: ${formatPathForLog(reportPath)}`);
-}
-function logMigrationReportAsJson(report) {
-  logger_default.log(JSON.stringify(report, null, 2));
-}
-function logNoMigrationConfigFilesWarning() {
-  logger_default.warn("No config files found for migration.");
-}
-function logMigrationEntries(report, dryRun) {
-  for (const entry of report.entries) {
-    const fileLabel = formatPathForLog(entry.file);
-    if (!entry.changed) {
-      logger_default.info(`No changes: ${fileLabel}`);
-      continue;
-    }
-    if (dryRun) {
-      logger_default.info(`[dry-run] ${fileLabel}`);
-    } else {
-      logger_default.success(`Migrated: ${fileLabel}`);
-    }
-    for (const change of entry.changes) {
-      logger_default.info(`  - ${change}`);
-    }
-    if (entry.backupFile) {
-      logger_default.info(`  - backup: ${formatPathForLog(entry.backupFile)}`);
-    }
-  }
-}
-function logMigrationSummary(report) {
-  logger_default.info(
-    `Migration summary: scanned=${report.scannedFiles}, changed=${report.changedFiles}, written=${report.writtenFiles}, backups=${report.backupsWritten}, missing=${report.missingFiles}, unchanged=${report.unchangedFiles}`
-  );
-}
-function logRestoreResultAsJson(result) {
-  logger_default.log(JSON.stringify(result, null, 2));
-}
-function logRestoreSummary(result) {
-  logger_default.info(
-    `Restore summary: scanned=${result.scannedEntries}, restorable=${result.restorableEntries}, restored=${result.restoredFiles}, missingBackups=${result.missingBackups}, skipped=${result.skippedEntries}`
-  );
-  if (result.restored.length > 0) {
-    const preview = result.restored.slice(0, 5);
-    for (const file of preview) {
-      logger_default.info(`  - ${formatPathForLog(file)}`);
-    }
-    if (result.restored.length > preview.length) {
-      logger_default.info(`  ...and ${result.restored.length - preview.length} more`);
-    }
-  }
-}
-function logValidateSuccessAsJson(result) {
-  const payload = {
-    ok: true,
-    ...result
-  };
-  logger_default.log(JSON.stringify(payload, null, 2));
-}
-function logValidateSuccessSummary(result) {
-  logger_default.success(
-    `Migration report validated: scanned=${result.scannedEntries}, restorable=${result.restorableEntries}, missingBackups=${result.missingBackups}, skipped=${result.skippedEntries}`
-  );
-  if (result.reportKind || result.reportSchemaVersion !== void 0) {
-    const kind = result.reportKind ?? "unknown";
-    const schema = result.reportSchemaVersion === void 0 ? "unknown" : String(result.reportSchemaVersion);
-    logger_default.info(`  metadata: kind=${kind}, schema=${schema}`);
-  }
-}
-function logValidateFailureAsJson(summary) {
-  const payload = {
-    ok: false,
-    reason: summary.reason,
-    exitCode: summary.exitCode,
-    message: summary.message
-  };
-  logger_default.log(JSON.stringify(payload, null, 2));
-}
-function logValidateFailureSummary(summary) {
-  logger_default.error(`Validation failed [${summary.reason}] (exit ${summary.exitCode}): ${summary.message}`);
-}
-
-// src/commands/migrate-handler.ts
-async function migrateCommandDefaultHandler(ctx) {
-  const { args } = ctx;
-  const {
-    include,
-    exclude,
-    maxDepth,
-    checkMode,
-    dryRun,
-    hasInvalidMaxDepth
-  } = resolveMigrateCommandArgs(args);
-  if (args.workspace && hasInvalidMaxDepth) {
-    logger_default.warn(`Invalid --max-depth value "${String(args.maxDepth)}", fallback to default depth.`);
-  }
-  const report = await migrateConfigFiles({
-    cwd: ctx.cwd,
-    dryRun,
-    ...args.config ? { files: [args.config] } : {},
-    ...args.workspace ? { workspace: true } : {},
-    ...args.workspace && maxDepth !== void 0 ? { maxDepth } : {},
-    ...args.backupDir ? { backupDir: args.backupDir } : {},
-    ...include ? { include } : {},
-    ...exclude ? { exclude } : {}
-  });
-  if (args.reportFile) {
-    await writeMigrationReportFile(ctx.cwd, args.reportFile, report);
-  }
-  if (args.json) {
-    logMigrationReportAsJson(report);
-    if (checkMode && report.changedFiles > 0) {
-      throw createMigrationCheckFailureError(report.changedFiles);
-    }
-    if (report.scannedFiles === 0) {
-      logNoMigrationConfigFilesWarning();
-    }
-    return report;
-  }
-  if (report.scannedFiles === 0) {
-    logNoMigrationConfigFilesWarning();
-    return report;
-  }
-  logMigrationEntries(report, dryRun);
-  logMigrationSummary(report);
-  if (checkMode && report.changedFiles > 0) {
-    throw createMigrationCheckFailureError(report.changedFiles);
-  }
-  return report;
-}
-
-// src/commands/restore-handler.ts
-async function restoreCommandDefaultHandler(ctx) {
-  const { args } = ctx;
-  const restoreArgs = resolveRestoreCommandArgs(args);
-  const result = await restoreConfigFiles({
-    cwd: ctx.cwd,
-    reportFile: restoreArgs.reportFile,
-    dryRun: restoreArgs.dryRun,
-    strict: restoreArgs.strict
-  });
-  if (args.json) {
-    logRestoreResultAsJson(result);
-    return result;
-  }
-  logRestoreSummary(result);
-  return result;
-}
-
-// src/commands/status-output.ts
-function formatFilesHint(entry) {
-  if (!entry.files.length) {
-    return "";
-  }
-  return ` (${entry.files.join(", ")})`;
-}
-function formatPackageLabel(report) {
-  return `${report.package.name ?? "tailwindcss"}@${report.package.version ?? "unknown"}`;
-}
-function partitionStatusEntries(report) {
-  return {
-    applied: report.entries.filter((entry) => entry.status === "applied"),
-    pending: report.entries.filter((entry) => entry.status === "not-applied"),
-    skipped: report.entries.filter((entry) => entry.status === "skipped" || entry.status === "unsupported")
-  };
-}
-function logStatusReportAsJson(report) {
-  logger_default.log(JSON.stringify(report, null, 2));
-}
-function logStatusReportSummary(report) {
-  const {
-    applied,
-    pending,
-    skipped
-  } = partitionStatusEntries(report);
-  logger_default.info(`Patch status for ${formatPackageLabel(report)} (v${report.majorVersion})`);
-  if (applied.length) {
-    logger_default.success("Applied:");
-    applied.forEach((entry) => logger_default.success(`  \u2022 ${entry.name}${formatFilesHint(entry)}`));
-  }
-  if (pending.length) {
-    logger_default.warn("Needs attention:");
-    pending.forEach((entry) => {
-      const details = entry.reason ? ` - ${entry.reason}` : "";
-      logger_default.warn(`  \u2022 ${entry.name}${formatFilesHint(entry)}${details}`);
-    });
-  } else {
-    logger_default.success("All applicable patches are applied.");
-  }
-  if (skipped.length) {
-    logger_default.info("Skipped:");
-    skipped.forEach((entry) => {
-      const details = entry.reason ? ` - ${entry.reason}` : "";
-      logger_default.info(`  \u2022 ${entry.name}${details}`);
-    });
-  }
-}
-
-// src/commands/status-handler.ts
-async function statusCommandDefaultHandler(ctx) {
-  const patcher = await ctx.createPatcher();
-  const report = await patcher.getPatchStatus();
-  if (ctx.args.json) {
-    logStatusReportAsJson(report);
-    return report;
-  }
-  logStatusReportSummary(report);
-  return report;
-}
-
-// src/commands/validate-handler.ts
-async function validateCommandDefaultHandler(ctx) {
-  const { args } = ctx;
-  const validateArgs = resolveValidateCommandArgs(args);
-  try {
-    const result = await restoreConfigFiles({
-      cwd: ctx.cwd,
-      reportFile: validateArgs.reportFile,
-      dryRun: true,
-      strict: validateArgs.strict
-    });
-    if (args.json) {
-      logValidateSuccessAsJson(result);
-      return result;
-    }
-    logValidateSuccessSummary(result);
-    return result;
-  } catch (error) {
-    const summary = classifyValidateError(error);
-    if (args.json) {
-      logValidateFailureAsJson(summary);
-    } else {
-      logValidateFailureSummary(summary);
-    }
-    throw new ValidateCommandError(summary, { cause: error });
-  }
-}
-
-// src/commands/default-handler-map.ts
-var defaultCommandHandlers = {
-  install: installCommandDefaultHandler,
-  extract: extractCommandDefaultHandler,
-  tokens: tokensCommandDefaultHandler,
-  init: initCommandDefaultHandler,
-  migrate: migrateCommandDefaultHandler,
-  restore: restoreCommandDefaultHandler,
-  validate: validateCommandDefaultHandler,
-  status: statusCommandDefaultHandler
-};
-
-// src/commands/command-registrar.ts
-function registerTailwindcssPatchCommand(cli, commandName, options, prefix, defaultDefinitions) {
-  const metadata = resolveCommandMetadata(commandName, options, prefix, defaultDefinitions);
-  const command = cli.command(metadata.name, metadata.description);
-  applyCommandOptions(command, metadata.optionDefs);
-  command.action(async (args) => {
-    return runWithCommandHandler(
-      cli,
-      command,
-      commandName,
-      args,
-      options.commandHandlers?.[commandName],
-      defaultCommandHandlers[commandName]
-    );
-  });
-  metadata.aliases.forEach((alias) => command.alias(alias));
-}
-
-// src/commands/cli.ts
-function mountTailwindcssPatchCommands(cli, options = {}) {
-  const prefix = options.commandPrefix ?? "";
-  const selectedCommands = options.commands ?? tailwindcssPatchCommands;
-  const defaultDefinitions = buildDefaultCommandDefinitions();
-  for (const name of selectedCommands) {
-    registerTailwindcssPatchCommand(cli, name, options, prefix, defaultDefinitions);
-  }
-  return cli;
-}
-function createTailwindcssPatchCli(options = {}) {
-  const cli = cac(options.name ?? "tw-patch");
-  mountTailwindcssPatchCommands(cli, options.mountOptions);
-  return cli;
-}
-
 export {
   logger_default,
   CacheStore,
   normalizeOptions,
+  loadWorkspaceConfigModule,
+  loadPatchOptionsForWorkspace,
   extractRawCandidatesWithPositions,
   extractRawCandidates,
   extractValidCandidates,
@@ -5035,10 +4363,9 @@ export {
   MIGRATION_REPORT_SCHEMA_VERSION,
   migrateConfigFiles,
   restoreConfigFiles,
+  tailwindcssPatchCommands,
   VALIDATE_EXIT_CODES,
   VALIDATE_FAILURE_REASONS,
-  ValidateCommandError,
-  tailwindcssPatchCommands,
-  mountTailwindcssPatchCommands,
-  createTailwindcssPatchCli
+  classifyValidateError,
+  ValidateCommandError
 };