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

package/dist/commands/cli-runtime.mjs

@@ -0,0 +1,1331 @@
+import {
+  TailwindcssPatcher,
+  VALIDATE_EXIT_CODES,
+  VALIDATE_FAILURE_REASONS,
+  ValidateCommandError,
+  classifyValidateError,
+  groupTokensByFile,
+  loadPatchOptionsForWorkspace,
+  loadWorkspaceConfigModule,
+  logger_default,
+  migrateConfigFiles,
+  restoreConfigFiles,
+  tailwindcssPatchCommands
+} from "../chunk-D6ICWMM4.mjs";
+import "../chunk-A67ABH3M.mjs";
+
+// ../../node_modules/.pnpm/cac@7.0.0/node_modules/cac/dist/index.js
+function toArr(any) {
+  return any == null ? [] : Array.isArray(any) ? any : [any];
+}
+function toVal(out, key, val, opts) {
+  var x, old = out[key], nxt = !!~opts.string.indexOf(key) ? val == null || val === true ? "" : String(val) : typeof val === "boolean" ? val : !!~opts.boolean.indexOf(key) ? val === "false" ? false : val === "true" || (out._.push((x = +val, x * 0 === 0) ? x : val), !!val) : (x = +val, x * 0 === 0) ? x : val;
+  out[key] = old == null ? nxt : Array.isArray(old) ? old.concat(nxt) : [old, nxt];
+}
+function lib_default(args, opts) {
+  args = args || [];
+  opts = opts || {};
+  var k, arr, arg, name, val, out = { _: [] };
+  var i = 0, j = 0, idx = 0, len = args.length;
+  const alibi = opts.alias !== void 0;
+  const strict = opts.unknown !== void 0;
+  const defaults = opts.default !== void 0;
+  opts.alias = opts.alias || {};
+  opts.string = toArr(opts.string);
+  opts.boolean = toArr(opts.boolean);
+  if (alibi) for (k in opts.alias) {
+    arr = opts.alias[k] = toArr(opts.alias[k]);
+    for (i = 0; i < arr.length; i++) (opts.alias[arr[i]] = arr.concat(k)).splice(i, 1);
+  }
+  for (i = opts.boolean.length; i-- > 0; ) {
+    arr = opts.alias[opts.boolean[i]] || [];
+    for (j = arr.length; j-- > 0; ) opts.boolean.push(arr[j]);
+  }
+  for (i = opts.string.length; i-- > 0; ) {
+    arr = opts.alias[opts.string[i]] || [];
+    for (j = arr.length; j-- > 0; ) opts.string.push(arr[j]);
+  }
+  if (defaults) for (k in opts.default) {
+    name = typeof opts.default[k];
+    arr = opts.alias[k] = opts.alias[k] || [];
+    if (opts[name] !== void 0) {
+      opts[name].push(k);
+      for (i = 0; i < arr.length; i++) opts[name].push(arr[i]);
+    }
+  }
+  const keys = strict ? Object.keys(opts.alias) : [];
+  for (i = 0; i < len; i++) {
+    arg = args[i];
+    if (arg === "--") {
+      out._ = out._.concat(args.slice(++i));
+      break;
+    }
+    for (j = 0; j < arg.length; j++) if (arg.charCodeAt(j) !== 45) break;
+    if (j === 0) out._.push(arg);
+    else if (arg.substring(j, j + 3) === "no-") {
+      name = arg.substring(j + 3);
+      if (strict && !~keys.indexOf(name)) return opts.unknown(arg);
+      out[name] = false;
+    } else {
+      for (idx = j + 1; idx < arg.length; idx++) if (arg.charCodeAt(idx) === 61) break;
+      name = arg.substring(j, idx);
+      val = arg.substring(++idx) || i + 1 === len || ("" + args[i + 1]).charCodeAt(0) === 45 || args[++i];
+      arr = j === 2 ? [name] : name;
+      for (idx = 0; idx < arr.length; idx++) {
+        name = arr[idx];
+        if (strict && !~keys.indexOf(name)) return opts.unknown("-".repeat(j) + name);
+        toVal(out, name, idx + 1 < arr.length || val, opts);
+      }
+    }
+  }
+  if (defaults) {
+    for (k in opts.default) if (out[k] === void 0) out[k] = opts.default[k];
+  }
+  if (alibi) for (k in out) {
+    arr = opts.alias[k] || [];
+    while (arr.length > 0) out[arr.shift()] = out[k];
+  }
+  return out;
+}
+function removeBrackets(v) {
+  return v.replace(/[<[].+/, "").trim();
+}
+function findAllBrackets(v) {
+  const ANGLED_BRACKET_RE_GLOBAL = /<([^>]+)>/g;
+  const SQUARE_BRACKET_RE_GLOBAL = /\[([^\]]+)\]/g;
+  const res = [];
+  const parse = (match) => {
+    let variadic = false;
+    let value = match[1];
+    if (value.startsWith("...")) {
+      value = value.slice(3);
+      variadic = true;
+    }
+    return {
+      required: match[0].startsWith("<"),
+      value,
+      variadic
+    };
+  };
+  let angledMatch;
+  while (angledMatch = ANGLED_BRACKET_RE_GLOBAL.exec(v)) res.push(parse(angledMatch));
+  let squareMatch;
+  while (squareMatch = SQUARE_BRACKET_RE_GLOBAL.exec(v)) res.push(parse(squareMatch));
+  return res;
+}
+function getMriOptions(options) {
+  const result = {
+    alias: {},
+    boolean: []
+  };
+  for (const [index, option] of options.entries()) {
+    if (option.names.length > 1) result.alias[option.names[0]] = option.names.slice(1);
+    if (option.isBoolean) if (option.negated) {
+      if (!options.some((o, i) => {
+        return i !== index && o.names.some((name) => option.names.includes(name)) && typeof o.required === "boolean";
+      })) result.boolean.push(option.names[0]);
+    } else result.boolean.push(option.names[0]);
+  }
+  return result;
+}
+function findLongest(arr) {
+  return arr.sort((a, b) => {
+    return a.length > b.length ? -1 : 1;
+  })[0];
+}
+function padRight(str, length) {
+  return str.length >= length ? str : `${str}${" ".repeat(length - str.length)}`;
+}
+function camelcase(input) {
+  return input.replaceAll(/([a-z])-([a-z])/g, (_, p1, p2) => {
+    return p1 + p2.toUpperCase();
+  });
+}
+function setDotProp(obj, keys, val) {
+  let current = obj;
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
+    if (i === keys.length - 1) {
+      current[key] = val;
+      return;
+    }
+    if (current[key] == null) {
+      const nextKeyIsArrayIndex = +keys[i + 1] > -1;
+      current[key] = nextKeyIsArrayIndex ? [] : {};
+    }
+    current = current[key];
+  }
+}
+function setByType(obj, transforms) {
+  for (const key of Object.keys(transforms)) {
+    const transform = transforms[key];
+    if (transform.shouldTransform) {
+      obj[key] = [obj[key]].flat();
+      if (typeof transform.transformFunction === "function") obj[key] = obj[key].map(transform.transformFunction);
+    }
+  }
+}
+function getFileName(input) {
+  const m = /([^\\/]+)$/.exec(input);
+  return m ? m[1] : "";
+}
+function camelcaseOptionName(name) {
+  return name.split(".").map((v, i) => {
+    return i === 0 ? camelcase(v) : v;
+  }).join(".");
+}
+var CACError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CACError";
+    if (typeof Error.captureStackTrace !== "function") this.stack = new Error(message).stack;
+  }
+};
+var Option = class {
+  rawName;
+  description;
+  /** Option name */
+  name;
+  /** Option name and aliases */
+  names;
+  isBoolean;
+  required;
+  config;
+  negated;
+  constructor(rawName, description, config) {
+    this.rawName = rawName;
+    this.description = description;
+    this.config = Object.assign({}, config);
+    rawName = rawName.replaceAll(".*", "");
+    this.negated = false;
+    this.names = removeBrackets(rawName).split(",").map((v) => {
+      let name = v.trim().replace(/^-{1,2}/, "");
+      if (name.startsWith("no-")) {
+        this.negated = true;
+        name = name.replace(/^no-/, "");
+      }
+      return camelcaseOptionName(name);
+    }).sort((a, b) => a.length > b.length ? 1 : -1);
+    this.name = this.names.at(-1);
+    if (this.negated && this.config.default == null) this.config.default = true;
+    if (rawName.includes("<")) this.required = true;
+    else if (rawName.includes("[")) this.required = false;
+    else this.isBoolean = true;
+  }
+};
+var runtimeProcessArgs;
+var runtimeInfo;
+if (typeof process !== "undefined") {
+  let runtimeName;
+  if (typeof Deno !== "undefined" && typeof Deno.version?.deno === "string") runtimeName = "deno";
+  else if (typeof Bun !== "undefined" && typeof Bun.version === "string") runtimeName = "bun";
+  else runtimeName = "node";
+  runtimeInfo = `${process.platform}-${process.arch} ${runtimeName}-${process.version}`;
+  runtimeProcessArgs = process.argv;
+} else if (typeof navigator === "undefined") runtimeInfo = `unknown`;
+else runtimeInfo = `${navigator.platform} ${navigator.userAgent}`;
+var Command = class {
+  rawName;
+  description;
+  config;
+  cli;
+  options;
+  aliasNames;
+  name;
+  args;
+  commandAction;
+  usageText;
+  versionNumber;
+  examples;
+  helpCallback;
+  globalCommand;
+  constructor(rawName, description, config = {}, cli) {
+    this.rawName = rawName;
+    this.description = description;
+    this.config = config;
+    this.cli = cli;
+    this.options = [];
+    this.aliasNames = [];
+    this.name = removeBrackets(rawName);
+    this.args = findAllBrackets(rawName);
+    this.examples = [];
+  }
+  usage(text) {
+    this.usageText = text;
+    return this;
+  }
+  allowUnknownOptions() {
+    this.config.allowUnknownOptions = true;
+    return this;
+  }
+  ignoreOptionDefaultValue() {
+    this.config.ignoreOptionDefaultValue = true;
+    return this;
+  }
+  version(version, customFlags = "-v, --version") {
+    this.versionNumber = version;
+    this.option(customFlags, "Display version number");
+    return this;
+  }
+  example(example) {
+    this.examples.push(example);
+    return this;
+  }
+  /**
+  * Add a option for this command
+  * @param rawName Raw option name(s)
+  * @param description Option description
+  * @param config Option config
+  */
+  option(rawName, description, config) {
+    const option = new Option(rawName, description, config);
+    this.options.push(option);
+    return this;
+  }
+  alias(name) {
+    this.aliasNames.push(name);
+    return this;
+  }
+  action(callback) {
+    this.commandAction = callback;
+    return this;
+  }
+  /**
+  * Check if a command name is matched by this command
+  * @param name Command name
+  */
+  isMatched(name) {
+    return this.name === name || this.aliasNames.includes(name);
+  }
+  get isDefaultCommand() {
+    return this.name === "" || this.aliasNames.includes("!");
+  }
+  get isGlobalCommand() {
+    return this instanceof GlobalCommand;
+  }
+  /**
+  * Check if an option is registered in this command
+  * @param name Option name
+  */
+  hasOption(name) {
+    name = name.split(".")[0];
+    return this.options.find((option) => {
+      return option.names.includes(name);
+    });
+  }
+  outputHelp() {
+    const { name, commands } = this.cli;
+    const { versionNumber, options: globalOptions, helpCallback } = this.cli.globalCommand;
+    let sections = [{ body: `${name}${versionNumber ? `/${versionNumber}` : ""}` }];
+    sections.push({
+      title: "Usage",
+      body: `  $ ${name} ${this.usageText || this.rawName}`
+    });
+    if ((this.isGlobalCommand || this.isDefaultCommand) && commands.length > 0) {
+      const longestCommandName = findLongest(commands.map((command) => command.rawName));
+      sections.push({
+        title: "Commands",
+        body: commands.map((command) => {
+          return `  ${padRight(command.rawName, longestCommandName.length)}  ${command.description}`;
+        }).join("\n")
+      }, {
+        title: `For more info, run any command with the \`--help\` flag`,
+        body: commands.map((command) => `  $ ${name}${command.name === "" ? "" : ` ${command.name}`} --help`).join("\n")
+      });
+    }
+    let options = this.isGlobalCommand ? globalOptions : [...this.options, ...globalOptions || []];
+    if (!this.isGlobalCommand && !this.isDefaultCommand) options = options.filter((option) => option.name !== "version");
+    if (options.length > 0) {
+      const longestOptionName = findLongest(options.map((option) => option.rawName));
+      sections.push({
+        title: "Options",
+        body: options.map((option) => {
+          return `  ${padRight(option.rawName, longestOptionName.length)}  ${option.description} ${option.config.default === void 0 ? "" : `(default: ${option.config.default})`}`;
+        }).join("\n")
+      });
+    }
+    if (this.examples.length > 0) sections.push({
+      title: "Examples",
+      body: this.examples.map((example) => {
+        if (typeof example === "function") return example(name);
+        return example;
+      }).join("\n")
+    });
+    if (helpCallback) sections = helpCallback(sections) || sections;
+    console.info(sections.map((section) => {
+      return section.title ? `${section.title}:
+${section.body}` : section.body;
+    }).join("\n\n"));
+  }
+  outputVersion() {
+    const { name } = this.cli;
+    const { versionNumber } = this.cli.globalCommand;
+    if (versionNumber) console.info(`${name}/${versionNumber} ${runtimeInfo}`);
+  }
+  checkRequiredArgs() {
+    const minimalArgsCount = this.args.filter((arg) => arg.required).length;
+    if (this.cli.args.length < minimalArgsCount) throw new CACError(`missing required args for command \`${this.rawName}\``);
+  }
+  /**
+  * Check if the parsed options contain any unknown options
+  *
+  * Exit and output error when true
+  */
+  checkUnknownOptions() {
+    const { options, globalCommand } = this.cli;
+    if (!this.config.allowUnknownOptions) {
+      for (const name of Object.keys(options)) if (name !== "--" && !this.hasOption(name) && !globalCommand.hasOption(name)) throw new CACError(`Unknown option \`${name.length > 1 ? `--${name}` : `-${name}`}\``);
+    }
+  }
+  /**
+  * Check if the required string-type options exist
+  */
+  checkOptionValue() {
+    const { options: parsedOptions, globalCommand } = this.cli;
+    const options = [...globalCommand.options, ...this.options];
+    for (const option of options) {
+      const value = parsedOptions[option.name.split(".")[0]];
+      if (option.required) {
+        const hasNegated = options.some((o) => o.negated && o.names.includes(option.name));
+        if (value === true || value === false && !hasNegated) throw new CACError(`option \`${option.rawName}\` value is missing`);
+      }
+    }
+  }
+  /**
+  * Check if the number of args is more than expected
+  */
+  checkUnusedArgs() {
+    const maximumArgsCount = this.args.some((arg) => arg.variadic) ? Infinity : this.args.length;
+    if (maximumArgsCount < this.cli.args.length) throw new CACError(`Unused args: ${this.cli.args.slice(maximumArgsCount).map((arg) => `\`${arg}\``).join(", ")}`);
+  }
+};
+var GlobalCommand = class extends Command {
+  constructor(cli) {
+    super("@@global@@", "", {}, cli);
+  }
+};
+var CAC = class extends EventTarget {
+  /** The program name to display in help and version message */
+  name;
+  commands;
+  globalCommand;
+  matchedCommand;
+  matchedCommandName;
+  /**
+  * Raw CLI arguments
+  */
+  rawArgs;
+  /**
+  * Parsed CLI arguments
+  */
+  args;
+  /**
+  * Parsed CLI options, camelCased
+  */
+  options;
+  showHelpOnExit;
+  showVersionOnExit;
+  /**
+  * @param name The program name to display in help and version message
+  */
+  constructor(name = "") {
+    super();
+    this.name = name;
+    this.commands = [];
+    this.rawArgs = [];
+    this.args = [];
+    this.options = {};
+    this.globalCommand = new GlobalCommand(this);
+    this.globalCommand.usage("<command> [options]");
+  }
+  /**
+  * Add a global usage text.
+  *
+  * This is not used by sub-commands.
+  */
+  usage(text) {
+    this.globalCommand.usage(text);
+    return this;
+  }
+  /**
+  * Add a sub-command
+  */
+  command(rawName, description, config) {
+    const command = new Command(rawName, description || "", config, this);
+    command.globalCommand = this.globalCommand;
+    this.commands.push(command);
+    return command;
+  }
+  /**
+  * Add a global CLI option.
+  *
+  * Which is also applied to sub-commands.
+  */
+  option(rawName, description, config) {
+    this.globalCommand.option(rawName, description, config);
+    return this;
+  }
+  /**
+  * Show help message when `-h, --help` flags appear.
+  *
+  */
+  help(callback) {
+    this.globalCommand.option("-h, --help", "Display this message");
+    this.globalCommand.helpCallback = callback;
+    this.showHelpOnExit = true;
+    return this;
+  }
+  /**
+  * Show version number when `-v, --version` flags appear.
+  *
+  */
+  version(version, customFlags = "-v, --version") {
+    this.globalCommand.version(version, customFlags);
+    this.showVersionOnExit = true;
+    return this;
+  }
+  /**
+  * Add a global example.
+  *
+  * This example added here will not be used by sub-commands.
+  */
+  example(example) {
+    this.globalCommand.example(example);
+    return this;
+  }
+  /**
+  * Output the corresponding help message
+  * When a sub-command is matched, output the help message for the command
+  * Otherwise output the global one.
+  *
+  */
+  outputHelp() {
+    if (this.matchedCommand) this.matchedCommand.outputHelp();
+    else this.globalCommand.outputHelp();
+  }
+  /**
+  * Output the version number.
+  *
+  */
+  outputVersion() {
+    this.globalCommand.outputVersion();
+  }
+  setParsedInfo({ args, options }, matchedCommand, matchedCommandName) {
+    this.args = args;
+    this.options = options;
+    if (matchedCommand) this.matchedCommand = matchedCommand;
+    if (matchedCommandName) this.matchedCommandName = matchedCommandName;
+    return this;
+  }
+  unsetMatchedCommand() {
+    this.matchedCommand = void 0;
+    this.matchedCommandName = void 0;
+  }
+  /**
+  * Parse argv
+  */
+  parse(argv, { run = true } = {}) {
+    if (!argv) {
+      if (!runtimeProcessArgs) throw new Error("No argv provided and runtime process argv is not available.");
+      argv = runtimeProcessArgs;
+    }
+    this.rawArgs = argv;
+    if (!this.name) this.name = argv[1] ? getFileName(argv[1]) : "cli";
+    let shouldParse = true;
+    for (const command of this.commands) {
+      const parsed = this.mri(argv.slice(2), command);
+      const commandName = parsed.args[0];
+      if (command.isMatched(commandName)) {
+        shouldParse = false;
+        const parsedInfo = {
+          ...parsed,
+          args: parsed.args.slice(1)
+        };
+        this.setParsedInfo(parsedInfo, command, commandName);
+        this.dispatchEvent(new CustomEvent(`command:${commandName}`, { detail: command }));
+      }
+    }
+    if (shouldParse) {
+      for (const command of this.commands) if (command.isDefaultCommand) {
+        shouldParse = false;
+        const parsed = this.mri(argv.slice(2), command);
+        this.setParsedInfo(parsed, command);
+        this.dispatchEvent(new CustomEvent("command:!", { detail: command }));
+      }
+    }
+    if (shouldParse) {
+      const parsed = this.mri(argv.slice(2));
+      this.setParsedInfo(parsed);
+    }
+    if (this.options.help && this.showHelpOnExit) {
+      this.outputHelp();
+      run = false;
+      this.unsetMatchedCommand();
+    }
+    if (this.options.version && this.showVersionOnExit && this.matchedCommandName == null) {
+      this.outputVersion();
+      run = false;
+      this.unsetMatchedCommand();
+    }
+    const parsedArgv = {
+      args: this.args,
+      options: this.options
+    };
+    if (run) this.runMatchedCommand();
+    if (!this.matchedCommand && this.args[0]) this.dispatchEvent(new CustomEvent("command:*", { detail: this.args[0] }));
+    return parsedArgv;
+  }
+  mri(argv, command) {
+    const cliOptions = [...this.globalCommand.options, ...command ? command.options : []];
+    const mriOptions = getMriOptions(cliOptions);
+    let argsAfterDoubleDashes = [];
+    const doubleDashesIndex = argv.indexOf("--");
+    if (doubleDashesIndex !== -1) {
+      argsAfterDoubleDashes = argv.slice(doubleDashesIndex + 1);
+      argv = argv.slice(0, doubleDashesIndex);
+    }
+    let parsed = lib_default(argv, mriOptions);
+    parsed = Object.keys(parsed).reduce((res, name) => {
+      return {
+        ...res,
+        [camelcaseOptionName(name)]: parsed[name]
+      };
+    }, { _: [] });
+    const args = parsed._;
+    const options = { "--": argsAfterDoubleDashes };
+    const ignoreDefault = command && command.config.ignoreOptionDefaultValue ? command.config.ignoreOptionDefaultValue : this.globalCommand.config.ignoreOptionDefaultValue;
+    const transforms = /* @__PURE__ */ Object.create(null);
+    for (const cliOption of cliOptions) {
+      if (!ignoreDefault && cliOption.config.default !== void 0) for (const name of cliOption.names) options[name] = cliOption.config.default;
+      if (Array.isArray(cliOption.config.type) && transforms[cliOption.name] === void 0) {
+        transforms[cliOption.name] = /* @__PURE__ */ Object.create(null);
+        transforms[cliOption.name].shouldTransform = true;
+        transforms[cliOption.name].transformFunction = cliOption.config.type[0];
+      }
+    }
+    for (const key of Object.keys(parsed)) if (key !== "_") {
+      setDotProp(options, key.split("."), parsed[key]);
+      setByType(options, transforms);
+    }
+    return {
+      args,
+      options
+    };
+  }
+  runMatchedCommand() {
+    const { args, options, matchedCommand: command } = this;
+    if (!command || !command.commandAction) return;
+    command.checkUnknownOptions();
+    command.checkOptionValue();
+    command.checkRequiredArgs();
+    command.checkUnusedArgs();
+    const actionArgs = [];
+    command.args.forEach((arg, index) => {
+      if (arg.variadic) actionArgs.push(args.slice(index));
+      else actionArgs.push(args[index]);
+    });
+    actionArgs.push(options);
+    return command.commandAction.apply(this, actionArgs);
+  }
+};
+var cac = (name = "") => new CAC(name);
+
+// src/commands/command-definitions.ts
+import process2 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: process2.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 process3 from "process";
+import path from "pathe";
+function resolveCommandCwd(rawCwd) {
+  if (!rawCwd) {
+    return process3.cwd();
+  }
+  return path.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 process4 from "process";
+import fs from "fs-extra";
+import path2 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 = path2.resolve(targetFile);
+    await fs.ensureDir(path2.dirname(target));
+    if (format === "json") {
+      await fs.writeJSON(target, report, { spaces: 2 });
+    } else if (format === "grouped-json") {
+      await fs.writeJSON(target, resolveGrouped(), { spaces: 2 });
+    } else {
+      const lines = report.entries.map(formatTokenLine);
+      await fs.writeFile(target, `${lines.join("\n")}
+`, "utf8");
+    }
+    logger_default.success(`Collected ${report.entries.length} tokens (${format}) \u2192 ${target.replace(process4.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 process5 from "process";
+import fs2 from "fs-extra";
+import path3 from "pathe";
+function formatPathForLog(file) {
+  return file.replace(process5.cwd(), ".");
+}
+function createMigrationCheckFailureError(changedFiles) {
+  return new Error(`Migration check failed: ${changedFiles} file(s) still need migration.`);
+}
+async function writeMigrationReportFile(cwd, reportFile, report) {
+  const reportPath = path3.resolve(cwd, reportFile);
+  await fs2.ensureDir(path3.dirname(reportPath));
+  await fs2.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) => {
+    const defaultHandler = defaultCommandHandlers[commandName];
+    return runWithCommandHandler(
+      cli,
+      command,
+      commandName,
+      args,
+      options.commandHandlers?.[commandName],
+      defaultHandler
+    );
+  });
+  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 {
+  VALIDATE_EXIT_CODES,
+  VALIDATE_FAILURE_REASONS,
+  ValidateCommandError,
+  createTailwindcssPatchCli,
+  mountTailwindcssPatchCommands,
+  tailwindcssPatchCommands
+};