tailwindcss-patch 8.2.4 → 8.4.0

package/dist/cli.js

@@ -1,238 +1,8 @@
-"use strict"; function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+"use strict";
 
-
-
-
-
-var _chunkOQKHXYAKjs = require('./chunk-OQKHXYAK.js');
-
-// src/cli.ts
-var _process = require('process'); var _process2 = _interopRequireDefault(_process);
-var _config = require('@tailwindcss-mangle/config');
-
-// ../../node_modules/.pnpm/defu@6.1.4/node_modules/defu/dist/defu.mjs
-function isPlainObject(value) {
-  if (value === null || typeof value !== "object") {
-    return false;
-  }
-  const prototype = Object.getPrototypeOf(value);
-  if (prototype !== null && prototype !== Object.prototype && Object.getPrototypeOf(prototype) !== null) {
-    return false;
-  }
-  if (Symbol.iterator in value) {
-    return false;
-  }
-  if (Symbol.toStringTag in value) {
-    return Object.prototype.toString.call(value) === "[object Module]";
-  }
-  return true;
-}
-function _defu(baseObject, defaults, namespace = ".", merger) {
-  if (!isPlainObject(defaults)) {
-    return _defu(baseObject, {}, namespace, merger);
-  }
-  const object = Object.assign({}, defaults);
-  for (const key in baseObject) {
-    if (key === "__proto__" || key === "constructor") {
-      continue;
-    }
-    const value = baseObject[key];
-    if (value === null || value === void 0) {
-      continue;
-    }
-    if (merger && merger(object, key, value, namespace)) {
-      continue;
-    }
-    if (Array.isArray(value) && Array.isArray(object[key])) {
-      object[key] = [...value, ...object[key]];
-    } else if (isPlainObject(value) && isPlainObject(object[key])) {
-      object[key] = _defu(
-        value,
-        object[key],
-        (namespace ? `${namespace}.` : "") + key.toString(),
-        merger
-      );
-    } else {
-      object[key] = value;
-    }
-  }
-  return object;
-}
-function createDefu(merger) {
-  return (...arguments_) => (
-    // eslint-disable-next-line unicorn/no-array-reduce
-    arguments_.reduce((p, c) => _defu(p, c, "", merger), {})
-  );
-}
-var defu = createDefu();
-var defuFn = createDefu((object, key, currentValue) => {
-  if (object[key] !== void 0 && typeof currentValue === "function") {
-    object[key] = currentValue(object[key]);
-    return true;
-  }
-});
-var defuArrayFn = createDefu((object, key, currentValue) => {
-  if (Array.isArray(object[key]) && typeof currentValue === "function") {
-    object[key] = currentValue(object[key]);
-    return true;
-  }
-});
-
-// ../shared/src/utils.ts
-var defuOverrideArray = createDefu((obj, key, value) => {
-  if (Array.isArray(obj[key]) && Array.isArray(value)) {
-    obj[key] = value;
-    return true;
-  }
-});
-var preserveClassNames = [
-  // https://tailwindcss.com/docs/transition-timing-function start
-  // https://github.com/sonofmagic/tailwindcss-mangle/issues/21
-  "ease-out",
-  "ease-linear",
-  "ease-in",
-  "ease-in-out"
-  // https://tailwindcss.com/docs/transition-timing-function end
-];
-var preserveClassNamesMap = preserveClassNames.reduce((acc, cur) => {
-  acc[cur] = true;
-  return acc;
-}, {});
-var acceptChars = [..."abcdefghijklmnopqrstuvwxyz"];
+var _chunkPF5ZTTYMjs = require('./chunk-PF5ZTTYM.js');
 
 // src/cli.ts
-var _cac = require('cac'); var _cac2 = _interopRequireDefault(_cac);
-var _fsextra = require('fs-extra'); var _fsextra2 = _interopRequireDefault(_fsextra);
-var _pathe = require('pathe'); var _pathe2 = _interopRequireDefault(_pathe);
-var cli = _cac2.default.call(void 0, "tw-patch");
-async function loadPatchOptions(cwd, overrides) {
-  const { config } = await _config.getConfig.call(void 0, cwd);
-  const legacyConfig = config;
-  const base = _optionalChain([config, 'optionalAccess', _ => _.registry]) ? _chunkOQKHXYAKjs.fromUnifiedConfig.call(void 0, config.registry) : _optionalChain([legacyConfig, 'optionalAccess', _2 => _2.patch]) ? _chunkOQKHXYAKjs.fromLegacyOptions.call(void 0, { patch: legacyConfig.patch }) : {};
-  const merged = defu(_nullishCoalesce(overrides, () => ( {})), base);
-  return merged;
-}
-cli.command("install", "Apply Tailwind CSS runtime patches").option("--cwd <dir>", "Working directory", { default: _process2.default.cwd() }).action(async (args) => {
-  const options = await loadPatchOptions(args.cwd);
-  const patcher = new (0, _chunkOQKHXYAKjs.TailwindcssPatcher)(options);
-  await patcher.patch();
-  _chunkOQKHXYAKjs.logger_default.success("Tailwind CSS runtime patched successfully.");
-});
-cli.command("extract", "Collect generated class names into a cache file").option("--cwd <dir>", "Working directory", { default: _process2.default.cwd() }).option("--output <file>", "Override output file path").option("--format <format>", "Output format (json|lines)").option("--css <file>", "Tailwind CSS entry CSS when using v4").option("--no-write", "Skip writing to disk").action(async (args) => {
-  const overrides = {};
-  if (args.output || args.format) {
-    overrides.output = {
-      file: args.output,
-      format: args.format
-    };
-  }
-  if (args.css) {
-    overrides.tailwind = {
-      v4: {
-        cssEntries: [args.css]
-      }
-    };
-  }
-  const options = await loadPatchOptions(args.cwd, overrides);
-  const patcher = new (0, _chunkOQKHXYAKjs.TailwindcssPatcher)(options);
-  const result = await patcher.extract({ write: args.write });
-  if (result.filename) {
-    _chunkOQKHXYAKjs.logger_default.success(`Collected ${result.classList.length} classes \u2192 ${result.filename}`);
-  } else {
-    _chunkOQKHXYAKjs.logger_default.success(`Collected ${result.classList.length} classes.`);
-  }
-});
-var TOKEN_FORMATS = ["json", "lines", "grouped-json"];
-cli.command("tokens", "Extract Tailwind tokens with file/position metadata").option("--cwd <dir>", "Working directory", { default: _process2.default.cwd() }).option("--output <file>", "Override output file path", { default: ".tw-patch/tw-token-report.json" }).option("--format <format>", "Output format (json|lines|grouped-json)", { default: "json" }).option("--group-key <key>", "Grouping key for grouped-json output (relative|absolute)", { default: "relative" }).option("--no-write", "Skip writing to disk").action(async (args) => {
-  const options = await loadPatchOptions(args.cwd);
-  const patcher = new (0, _chunkOQKHXYAKjs.TailwindcssPatcher)(options);
-  const report = await patcher.collectContentTokens();
-  const shouldWrite = _nullishCoalesce(args.write, () => ( true));
-  let format = _nullishCoalesce(args.format, () => ( "json"));
-  if (!TOKEN_FORMATS.includes(format)) {
-    format = "json";
-  }
-  const targetFile = _nullishCoalesce(args.output, () => ( ".tw-patch/tw-token-report.json"));
-  const groupKey = args.groupKey === "absolute" ? "absolute" : "relative";
-  const buildGrouped = () => _chunkOQKHXYAKjs.groupTokensByFile.call(void 0, report, {
-    key: groupKey,
-    stripAbsolutePaths: groupKey !== "absolute"
-  });
-  const grouped = format === "grouped-json" ? buildGrouped() : null;
-  const resolveGrouped = () => _nullishCoalesce(grouped, () => ( buildGrouped()));
-  if (shouldWrite) {
-    const target = _pathe2.default.resolve(targetFile);
-    await _fsextra2.default.ensureDir(_pathe2.default.dirname(target));
-    if (format === "json") {
-      await _fsextra2.default.writeJSON(target, report, { spaces: 2 });
-    } else if (format === "grouped-json") {
-      await _fsextra2.default.writeJSON(target, resolveGrouped(), { spaces: 2 });
-    } else {
-      const lines = report.entries.map(formatTokenLine);
-      await _fsextra2.default.writeFile(target, `${lines.join("\n")}
-`, "utf8");
-    }
-    _chunkOQKHXYAKjs.logger_default.success(
-      `Collected ${report.entries.length} tokens (${format}) \u2192 ${target.replace(_process2.default.cwd(), ".")}`
-    );
-  } else {
-    _chunkOQKHXYAKjs.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) {
-        _chunkOQKHXYAKjs.logger_default.log("");
-        _chunkOQKHXYAKjs.logger_default.info(preview);
-        if (report.entries.length > 5) {
-          _chunkOQKHXYAKjs.logger_default.info(`\u2026and ${report.entries.length - 5} more.`);
-        }
-      }
-    } else if (format === "grouped-json") {
-      const map = resolveGrouped();
-      const { preview, moreFiles } = formatGroupedPreview(map);
-      if (preview) {
-        _chunkOQKHXYAKjs.logger_default.log("");
-        _chunkOQKHXYAKjs.logger_default.info(preview);
-        if (moreFiles > 0) {
-          _chunkOQKHXYAKjs.logger_default.info(`\u2026and ${moreFiles} more files.`);
-        }
-      }
-    } else {
-      const previewEntries = report.entries.slice(0, 3);
-      if (previewEntries.length) {
-        _chunkOQKHXYAKjs.logger_default.log("");
-        _chunkOQKHXYAKjs.logger_default.info(JSON.stringify(previewEntries, null, 2));
-      }
-    }
-  }
-  if (report.skippedFiles.length) {
-    _chunkOQKHXYAKjs.logger_default.warn("Skipped files:");
-    for (const skipped of report.skippedFiles) {
-      _chunkOQKHXYAKjs.logger_default.warn(`  \u2022 ${skipped.file} (${skipped.reason})`);
-    }
-  }
-});
-cli.command("init", "Generate a tailwindcss-patch config file").option("--cwd <dir>", "Working directory", { default: _process2.default.cwd() }).action(async (args) => {
-  await _config.initConfig.call(void 0, args.cwd);
-  _chunkOQKHXYAKjs.logger_default.success(`\u2728 ${_config.CONFIG_NAME}.config.ts initialized!`);
-});
+var cli = _chunkPF5ZTTYMjs.createTailwindcssPatchCli.call(void 0, );
 cli.help();
 cli.parse();
-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)
-  };
-}

package/dist/cli.mjs

@@ -1,238 +1,8 @@
 import {
-  TailwindcssPatcher,
-  fromLegacyOptions,
-  fromUnifiedConfig,
-  groupTokensByFile,
-  logger_default
-} from "./chunk-4BI6FMCK.mjs";
+  createTailwindcssPatchCli
+} from "./chunk-SHYTHM5B.mjs";
 
 // src/cli.ts
-import process from "process";
-import { CONFIG_NAME, getConfig, initConfig } from "@tailwindcss-mangle/config";
-
-// ../../node_modules/.pnpm/defu@6.1.4/node_modules/defu/dist/defu.mjs
-function isPlainObject(value) {
-  if (value === null || typeof value !== "object") {
-    return false;
-  }
-  const prototype = Object.getPrototypeOf(value);
-  if (prototype !== null && prototype !== Object.prototype && Object.getPrototypeOf(prototype) !== null) {
-    return false;
-  }
-  if (Symbol.iterator in value) {
-    return false;
-  }
-  if (Symbol.toStringTag in value) {
-    return Object.prototype.toString.call(value) === "[object Module]";
-  }
-  return true;
-}
-function _defu(baseObject, defaults, namespace = ".", merger) {
-  if (!isPlainObject(defaults)) {
-    return _defu(baseObject, {}, namespace, merger);
-  }
-  const object = Object.assign({}, defaults);
-  for (const key in baseObject) {
-    if (key === "__proto__" || key === "constructor") {
-      continue;
-    }
-    const value = baseObject[key];
-    if (value === null || value === void 0) {
-      continue;
-    }
-    if (merger && merger(object, key, value, namespace)) {
-      continue;
-    }
-    if (Array.isArray(value) && Array.isArray(object[key])) {
-      object[key] = [...value, ...object[key]];
-    } else if (isPlainObject(value) && isPlainObject(object[key])) {
-      object[key] = _defu(
-        value,
-        object[key],
-        (namespace ? `${namespace}.` : "") + key.toString(),
-        merger
-      );
-    } else {
-      object[key] = value;
-    }
-  }
-  return object;
-}
-function createDefu(merger) {
-  return (...arguments_) => (
-    // eslint-disable-next-line unicorn/no-array-reduce
-    arguments_.reduce((p, c) => _defu(p, c, "", merger), {})
-  );
-}
-var defu = createDefu();
-var defuFn = createDefu((object, key, currentValue) => {
-  if (object[key] !== void 0 && typeof currentValue === "function") {
-    object[key] = currentValue(object[key]);
-    return true;
-  }
-});
-var defuArrayFn = createDefu((object, key, currentValue) => {
-  if (Array.isArray(object[key]) && typeof currentValue === "function") {
-    object[key] = currentValue(object[key]);
-    return true;
-  }
-});
-
-// ../shared/src/utils.ts
-var defuOverrideArray = createDefu((obj, key, value) => {
-  if (Array.isArray(obj[key]) && Array.isArray(value)) {
-    obj[key] = value;
-    return true;
-  }
-});
-var preserveClassNames = [
-  // https://tailwindcss.com/docs/transition-timing-function start
-  // https://github.com/sonofmagic/tailwindcss-mangle/issues/21
-  "ease-out",
-  "ease-linear",
-  "ease-in",
-  "ease-in-out"
-  // https://tailwindcss.com/docs/transition-timing-function end
-];
-var preserveClassNamesMap = preserveClassNames.reduce((acc, cur) => {
-  acc[cur] = true;
-  return acc;
-}, {});
-var acceptChars = [..."abcdefghijklmnopqrstuvwxyz"];
-
-// src/cli.ts
-import cac from "cac";
-import fs from "fs-extra";
-import path from "pathe";
-var cli = cac("tw-patch");
-async function loadPatchOptions(cwd, overrides) {
-  const { config } = await getConfig(cwd);
-  const legacyConfig = config;
-  const base = config?.registry ? fromUnifiedConfig(config.registry) : legacyConfig?.patch ? fromLegacyOptions({ patch: legacyConfig.patch }) : {};
-  const merged = defu(overrides ?? {}, base);
-  return merged;
-}
-cli.command("install", "Apply Tailwind CSS runtime patches").option("--cwd <dir>", "Working directory", { default: process.cwd() }).action(async (args) => {
-  const options = await loadPatchOptions(args.cwd);
-  const patcher = new TailwindcssPatcher(options);
-  await patcher.patch();
-  logger_default.success("Tailwind CSS runtime patched successfully.");
-});
-cli.command("extract", "Collect generated class names into a cache file").option("--cwd <dir>", "Working directory", { default: process.cwd() }).option("--output <file>", "Override output file path").option("--format <format>", "Output format (json|lines)").option("--css <file>", "Tailwind CSS entry CSS when using v4").option("--no-write", "Skip writing to disk").action(async (args) => {
-  const overrides = {};
-  if (args.output || args.format) {
-    overrides.output = {
-      file: args.output,
-      format: args.format
-    };
-  }
-  if (args.css) {
-    overrides.tailwind = {
-      v4: {
-        cssEntries: [args.css]
-      }
-    };
-  }
-  const options = await loadPatchOptions(args.cwd, overrides);
-  const patcher = new TailwindcssPatcher(options);
-  const result = await patcher.extract({ write: args.write });
-  if (result.filename) {
-    logger_default.success(`Collected ${result.classList.length} classes \u2192 ${result.filename}`);
-  } else {
-    logger_default.success(`Collected ${result.classList.length} classes.`);
-  }
-});
-var TOKEN_FORMATS = ["json", "lines", "grouped-json"];
-cli.command("tokens", "Extract Tailwind tokens with file/position metadata").option("--cwd <dir>", "Working directory", { default: process.cwd() }).option("--output <file>", "Override output file path", { default: ".tw-patch/tw-token-report.json" }).option("--format <format>", "Output format (json|lines|grouped-json)", { default: "json" }).option("--group-key <key>", "Grouping key for grouped-json output (relative|absolute)", { default: "relative" }).option("--no-write", "Skip writing to disk").action(async (args) => {
-  const options = await loadPatchOptions(args.cwd);
-  const patcher = new TailwindcssPatcher(options);
-  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 ?? ".tw-patch/tw-token-report.json";
-  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 = path.resolve(targetFile);
-    await fs.ensureDir(path.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(process.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})`);
-    }
-  }
-});
-cli.command("init", "Generate a tailwindcss-patch config file").option("--cwd <dir>", "Working directory", { default: process.cwd() }).action(async (args) => {
-  await initConfig(args.cwd);
-  logger_default.success(`\u2728 ${CONFIG_NAME}.config.ts initialized!`);
-});
+var cli = createTailwindcssPatchCli();
 cli.help();
 cli.parse();
-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)
-  };
-}

package/dist/index.d.mts

@@ -2,8 +2,9 @@ import { SourceEntry } from '@tailwindcss/oxide';
 import postcss, { Node, Rule } from 'postcss';
 import { Config } from 'tailwindcss';
 import { PackageResolvingOptions, PackageInfo } from 'local-pkg';
-import { TailwindLocatorOptions, TailwindNextOptions } from '@tailwindcss-mangle/config';
+import { TailwindLocatorOptions, TailwindNextOptions, getConfig } from '@tailwindcss-mangle/config';
 export { defineConfig } from '@tailwindcss-mangle/config';
+import { Command, CAC } from 'cac';
 import * as consola from 'consola';
 
 type CacheStrategy = 'merge' | 'overwrite';
@@ -424,6 +425,82 @@ declare class CacheStore {
 
 declare const logger: consola.ConsolaInstance;
 
+type TailwindcssPatchCommand = 'install' | 'extract' | 'tokens' | 'init';
+declare const tailwindcssPatchCommands: TailwindcssPatchCommand[];
+type TokenOutputFormat = 'json' | 'lines' | 'grouped-json';
+type TokenGroupKey = 'relative' | 'absolute';
+type CacOptionConfig = Parameters<Command['option']>[2];
+interface TailwindcssPatchCommandOptionDefinition {
+    flags: string;
+    description?: string;
+    config?: CacOptionConfig;
+}
+interface TailwindcssPatchCommandOptions {
+    name?: string;
+    aliases?: string[];
+    description?: string;
+    optionDefs?: TailwindcssPatchCommandOptionDefinition[];
+    appendDefaultOptions?: boolean;
+}
+interface BaseCommandArgs {
+    cwd: string;
+}
+interface InstallCommandArgs extends BaseCommandArgs {
+}
+interface ExtractCommandArgs extends BaseCommandArgs {
+    output?: string;
+    format?: 'json' | 'lines';
+    css?: string;
+    write?: boolean;
+}
+interface TokensCommandArgs extends BaseCommandArgs {
+    output?: string;
+    format?: TokenOutputFormat;
+    groupKey?: TokenGroupKey;
+    write?: boolean;
+}
+interface InitCommandArgs extends BaseCommandArgs {
+}
+interface TailwindcssPatchCommandArgMap {
+    install: InstallCommandArgs;
+    extract: ExtractCommandArgs;
+    tokens: TokensCommandArgs;
+    init: InitCommandArgs;
+}
+interface TailwindcssPatchCommandResultMap {
+    install: void;
+    extract: ExtractResult;
+    tokens: TailwindTokenReport;
+    init: void;
+}
+interface TailwindcssPatchCommandContext<TCommand extends TailwindcssPatchCommand> {
+    cli: CAC;
+    command: Command;
+    commandName: TCommand;
+    args: TailwindcssPatchCommandArgMap[TCommand];
+    cwd: string;
+    logger: typeof logger;
+    loadConfig: () => ReturnType<typeof getConfig>;
+    loadPatchOptions: (overrides?: TailwindcssPatchOptions) => Promise<TailwindcssPatchOptions>;
+    createPatcher: (overrides?: TailwindcssPatchOptions) => Promise<TailwindcssPatcher>;
+}
+type TailwindcssPatchCommandHandler<TCommand extends TailwindcssPatchCommand> = (context: TailwindcssPatchCommandContext<TCommand>, next: () => Promise<TailwindcssPatchCommandResultMap[TCommand]>) => Promise<TailwindcssPatchCommandResultMap[TCommand]> | TailwindcssPatchCommandResultMap[TCommand];
+type TailwindcssPatchCommandHandlerMap = Partial<{
+    [K in TailwindcssPatchCommand]: TailwindcssPatchCommandHandler<K>;
+}>;
+interface TailwindcssPatchCliMountOptions {
+    commandPrefix?: string;
+    commands?: TailwindcssPatchCommand[];
+    commandOptions?: Partial<Record<TailwindcssPatchCommand, TailwindcssPatchCommandOptions>>;
+    commandHandlers?: TailwindcssPatchCommandHandlerMap;
+}
+interface TailwindcssPatchCliOptions {
+    name?: string;
+    mountOptions?: TailwindcssPatchCliMountOptions;
+}
+declare function mountTailwindcssPatchCommands(cli: CAC, options?: TailwindcssPatchCliMountOptions): CAC;
+declare function createTailwindcssPatchCli(options?: TailwindcssPatchCliOptions): CAC;
+
 declare function normalizeOptions(options?: TailwindcssPatchOptions): NormalizedTailwindcssPatchOptions;
 
 declare function collectClassesFromContexts(contexts: TailwindcssRuntimeContext[], filter: (className: string) => boolean): Set<string>;
@@ -439,4 +516,4 @@ interface TailwindBuildOptions {
 }
 declare function runTailwindBuild(options: TailwindBuildOptions): Promise<postcss.Result<postcss.Root>>;
 
-export { CacheStore, type CacheStrategy, type ExtractResult, type ILengthUnitsPatchOptions, type NormalizedTailwindcssPatchOptions, type TailwindPatchRuntime, type TailwindTokenByFileMap, type TailwindTokenFileKey, type TailwindTokenLocation, type TailwindTokenReport, type TailwindcssClassCache, type TailwindcssPatchOptions, TailwindcssPatcher, type TailwindcssRuntimeContext, collectClassesFromContexts, collectClassesFromTailwindV4, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, groupTokensByFile, loadRuntimeContexts, logger, normalizeOptions, runTailwindBuild };
+export { CacheStore, type CacheStrategy, type ExtractResult, type ILengthUnitsPatchOptions, type NormalizedTailwindcssPatchOptions, type TailwindPatchRuntime, type TailwindTokenByFileMap, type TailwindTokenFileKey, type TailwindTokenLocation, type TailwindTokenReport, type TailwindcssClassCache, type TailwindcssPatchCliMountOptions, type TailwindcssPatchCliOptions, type TailwindcssPatchCommand, type TailwindcssPatchCommandContext, type TailwindcssPatchCommandHandler, type TailwindcssPatchCommandHandlerMap, type TailwindcssPatchCommandOptionDefinition, type TailwindcssPatchCommandOptions, type TailwindcssPatchOptions, TailwindcssPatcher, type TailwindcssRuntimeContext, collectClassesFromContexts, collectClassesFromTailwindV4, createTailwindcssPatchCli, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, groupTokensByFile, loadRuntimeContexts, logger, mountTailwindcssPatchCommands, normalizeOptions, runTailwindBuild, tailwindcssPatchCommands };

package/dist/index.d.ts

@@ -2,8 +2,9 @@ import { SourceEntry } from '@tailwindcss/oxide';
 import postcss, { Node, Rule } from 'postcss';
 import { Config } from 'tailwindcss';
 import { PackageResolvingOptions, PackageInfo } from 'local-pkg';
-import { TailwindLocatorOptions, TailwindNextOptions } from '@tailwindcss-mangle/config';
+import { TailwindLocatorOptions, TailwindNextOptions, getConfig } from '@tailwindcss-mangle/config';
 export { defineConfig } from '@tailwindcss-mangle/config';
+import { Command, CAC } from 'cac';
 import * as consola from 'consola';
 
 type CacheStrategy = 'merge' | 'overwrite';
@@ -424,6 +425,82 @@ declare class CacheStore {
 
 declare const logger: consola.ConsolaInstance;
 
+type TailwindcssPatchCommand = 'install' | 'extract' | 'tokens' | 'init';
+declare const tailwindcssPatchCommands: TailwindcssPatchCommand[];
+type TokenOutputFormat = 'json' | 'lines' | 'grouped-json';
+type TokenGroupKey = 'relative' | 'absolute';
+type CacOptionConfig = Parameters<Command['option']>[2];
+interface TailwindcssPatchCommandOptionDefinition {
+    flags: string;
+    description?: string;
+    config?: CacOptionConfig;
+}
+interface TailwindcssPatchCommandOptions {
+    name?: string;
+    aliases?: string[];
+    description?: string;
+    optionDefs?: TailwindcssPatchCommandOptionDefinition[];
+    appendDefaultOptions?: boolean;
+}
+interface BaseCommandArgs {
+    cwd: string;
+}
+interface InstallCommandArgs extends BaseCommandArgs {
+}
+interface ExtractCommandArgs extends BaseCommandArgs {
+    output?: string;
+    format?: 'json' | 'lines';
+    css?: string;
+    write?: boolean;
+}
+interface TokensCommandArgs extends BaseCommandArgs {
+    output?: string;
+    format?: TokenOutputFormat;
+    groupKey?: TokenGroupKey;
+    write?: boolean;
+}
+interface InitCommandArgs extends BaseCommandArgs {
+}
+interface TailwindcssPatchCommandArgMap {
+    install: InstallCommandArgs;
+    extract: ExtractCommandArgs;
+    tokens: TokensCommandArgs;
+    init: InitCommandArgs;
+}
+interface TailwindcssPatchCommandResultMap {
+    install: void;
+    extract: ExtractResult;
+    tokens: TailwindTokenReport;
+    init: void;
+}
+interface TailwindcssPatchCommandContext<TCommand extends TailwindcssPatchCommand> {
+    cli: CAC;
+    command: Command;
+    commandName: TCommand;
+    args: TailwindcssPatchCommandArgMap[TCommand];
+    cwd: string;
+    logger: typeof logger;
+    loadConfig: () => ReturnType<typeof getConfig>;
+    loadPatchOptions: (overrides?: TailwindcssPatchOptions) => Promise<TailwindcssPatchOptions>;
+    createPatcher: (overrides?: TailwindcssPatchOptions) => Promise<TailwindcssPatcher>;
+}
+type TailwindcssPatchCommandHandler<TCommand extends TailwindcssPatchCommand> = (context: TailwindcssPatchCommandContext<TCommand>, next: () => Promise<TailwindcssPatchCommandResultMap[TCommand]>) => Promise<TailwindcssPatchCommandResultMap[TCommand]> | TailwindcssPatchCommandResultMap[TCommand];
+type TailwindcssPatchCommandHandlerMap = Partial<{
+    [K in TailwindcssPatchCommand]: TailwindcssPatchCommandHandler<K>;
+}>;
+interface TailwindcssPatchCliMountOptions {
+    commandPrefix?: string;
+    commands?: TailwindcssPatchCommand[];
+    commandOptions?: Partial<Record<TailwindcssPatchCommand, TailwindcssPatchCommandOptions>>;
+    commandHandlers?: TailwindcssPatchCommandHandlerMap;
+}
+interface TailwindcssPatchCliOptions {
+    name?: string;
+    mountOptions?: TailwindcssPatchCliMountOptions;
+}
+declare function mountTailwindcssPatchCommands(cli: CAC, options?: TailwindcssPatchCliMountOptions): CAC;
+declare function createTailwindcssPatchCli(options?: TailwindcssPatchCliOptions): CAC;
+
 declare function normalizeOptions(options?: TailwindcssPatchOptions): NormalizedTailwindcssPatchOptions;
 
 declare function collectClassesFromContexts(contexts: TailwindcssRuntimeContext[], filter: (className: string) => boolean): Set<string>;
@@ -439,4 +516,4 @@ interface TailwindBuildOptions {
 }
 declare function runTailwindBuild(options: TailwindBuildOptions): Promise<postcss.Result<postcss.Root>>;
 
-export { CacheStore, type CacheStrategy, type ExtractResult, type ILengthUnitsPatchOptions, type NormalizedTailwindcssPatchOptions, type TailwindPatchRuntime, type TailwindTokenByFileMap, type TailwindTokenFileKey, type TailwindTokenLocation, type TailwindTokenReport, type TailwindcssClassCache, type TailwindcssPatchOptions, TailwindcssPatcher, type TailwindcssRuntimeContext, collectClassesFromContexts, collectClassesFromTailwindV4, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, groupTokensByFile, loadRuntimeContexts, logger, normalizeOptions, runTailwindBuild };
+export { CacheStore, type CacheStrategy, type ExtractResult, type ILengthUnitsPatchOptions, type NormalizedTailwindcssPatchOptions, type TailwindPatchRuntime, type TailwindTokenByFileMap, type TailwindTokenFileKey, type TailwindTokenLocation, type TailwindTokenReport, type TailwindcssClassCache, type TailwindcssPatchCliMountOptions, type TailwindcssPatchCliOptions, type TailwindcssPatchCommand, type TailwindcssPatchCommandContext, type TailwindcssPatchCommandHandler, type TailwindcssPatchCommandHandlerMap, type TailwindcssPatchCommandOptionDefinition, type TailwindcssPatchCommandOptions, type TailwindcssPatchOptions, TailwindcssPatcher, type TailwindcssRuntimeContext, collectClassesFromContexts, collectClassesFromTailwindV4, createTailwindcssPatchCli, extractProjectCandidatesWithPositions, extractRawCandidates, extractRawCandidatesWithPositions, extractValidCandidates, groupTokensByFile, loadRuntimeContexts, logger, mountTailwindcssPatchCommands, normalizeOptions, runTailwindBuild, tailwindcssPatchCommands };