tailwindcss-patch 7.1.6 → 8.1.0

package/dist/chunk-IQ26TKX2.mjs

@@ -0,0 +1,1385 @@
+// src/logger.ts
+import { createConsola } from "consola";
+var logger = createConsola();
+var logger_default = logger;
+
+// src/cache/store.ts
+import fs from "fs-extra";
+var CacheStore = class {
+  constructor(options) {
+    this.options = options;
+  }
+  async ensureDir() {
+    await fs.ensureDir(this.options.dir);
+  }
+  ensureDirSync() {
+    fs.ensureDirSync(this.options.dir);
+  }
+  async write(data) {
+    if (!this.options.enabled) {
+      return void 0;
+    }
+    try {
+      await this.ensureDir();
+      await fs.writeJSON(this.options.path, Array.from(data));
+      return this.options.path;
+    } catch (error) {
+      logger_default.error("Unable to persist Tailwind class cache", error);
+      return void 0;
+    }
+  }
+  writeSync(data) {
+    if (!this.options.enabled) {
+      return void 0;
+    }
+    try {
+      this.ensureDirSync();
+      fs.writeJSONSync(this.options.path, Array.from(data));
+      return this.options.path;
+    } catch (error) {
+      logger_default.error("Unable to persist Tailwind class cache", error);
+      return void 0;
+    }
+  }
+  async read() {
+    if (!this.options.enabled) {
+      return /* @__PURE__ */ new Set();
+    }
+    try {
+      const exists = await fs.pathExists(this.options.path);
+      if (!exists) {
+        return /* @__PURE__ */ new Set();
+      }
+      const data = await fs.readJSON(this.options.path);
+      if (Array.isArray(data)) {
+        return new Set(data.filter((item) => typeof item === "string"));
+      }
+    } catch (error) {
+      logger_default.warn("Unable to read Tailwind class cache, removing invalid file.", error);
+      try {
+        await fs.remove(this.options.path);
+      } catch (cleanupError) {
+        logger_default.error("Failed to clean up invalid cache file", cleanupError);
+      }
+    }
+    return /* @__PURE__ */ new Set();
+  }
+  readSync() {
+    if (!this.options.enabled) {
+      return /* @__PURE__ */ new Set();
+    }
+    try {
+      const exists = fs.pathExistsSync(this.options.path);
+      if (!exists) {
+        return /* @__PURE__ */ new Set();
+      }
+      const data = fs.readJSONSync(this.options.path);
+      if (Array.isArray(data)) {
+        return new Set(data.filter((item) => typeof item === "string"));
+      }
+    } catch (error) {
+      logger_default.warn("Unable to read Tailwind class cache, removing invalid file.", error);
+      try {
+        fs.removeSync(this.options.path);
+      } catch (cleanupError) {
+        logger_default.error("Failed to clean up invalid cache file", cleanupError);
+      }
+    }
+    return /* @__PURE__ */ new Set();
+  }
+};
+
+// src/extraction/candidate-extractor.ts
+import process from "process";
+async function importNode() {
+  return import("@tailwindcss/node");
+}
+async function importOxide() {
+  return import("@tailwindcss/oxide");
+}
+async function extractRawCandidatesWithPositions(content, extension = "html") {
+  const { Scanner } = await importOxide();
+  const scanner = new Scanner({});
+  const result = scanner.getCandidatesWithPositions({ content, extension });
+  return result.map(({ candidate, position }) => ({
+    rawCandidate: candidate,
+    start: position,
+    end: position + candidate.length
+  }));
+}
+async function extractRawCandidates(sources) {
+  const { Scanner } = await importOxide();
+  const scanner = new Scanner({
+    sources
+  });
+  return scanner.scan();
+}
+async function extractValidCandidates(options) {
+  const providedOptions = options ?? {};
+  const defaultCwd = providedOptions.cwd ?? process.cwd();
+  const base = providedOptions.base ?? defaultCwd;
+  const css = providedOptions.css ?? '@import "tailwindcss";';
+  const sources = (providedOptions.sources ?? [
+    {
+      base: defaultCwd,
+      pattern: "**/*",
+      negated: false
+    }
+  ]).map((source) => ({
+    base: source.base ?? defaultCwd,
+    pattern: source.pattern,
+    negated: source.negated
+  }));
+  const { __unstable__loadDesignSystem } = await importNode();
+  const designSystem = await __unstable__loadDesignSystem(css, { base });
+  const candidates = await extractRawCandidates(sources);
+  const validCandidates = candidates.filter(
+    (rawCandidate) => designSystem.parseCandidate(rawCandidate).length > 0
+  );
+  return validCandidates;
+}
+
+// src/options/legacy.ts
+function normalizeLegacyFeatures(patch) {
+  const apply = patch?.applyPatches;
+  const extend = apply?.extendLengthUnits;
+  let extendOption = false;
+  if (extend && typeof extend === "object") {
+    extendOption = {
+      ...extend,
+      enabled: true
+    };
+  } else if (extend === true) {
+    extendOption = {
+      enabled: true,
+      units: ["rpx"],
+      overwrite: patch?.overwrite
+    };
+  }
+  return {
+    exposeContext: apply?.exportContext ?? true,
+    extendLengthUnits: extendOption
+  };
+}
+function fromLegacyOptions(options) {
+  if (!options) {
+    return {};
+  }
+  const patch = options.patch;
+  const features = normalizeLegacyFeatures(patch);
+  const output = patch?.output;
+  const tailwindConfig = patch?.tailwindcss;
+  const tailwindVersion = tailwindConfig?.version;
+  const tailwindV2 = tailwindConfig?.v2;
+  const tailwindV3 = tailwindConfig?.v3;
+  const tailwindV4 = tailwindConfig?.v4;
+  const tailwindConfigPath = tailwindV3?.config ?? tailwindV2?.config;
+  const tailwindCwd = tailwindV3?.cwd ?? tailwindV2?.cwd ?? patch?.cwd;
+  return {
+    cwd: patch?.cwd,
+    overwrite: patch?.overwrite,
+    filter: patch?.filter,
+    cache: typeof options.cache === "boolean" ? options.cache : options.cache ? {
+      ...options.cache,
+      enabled: options.cache.enabled ?? true
+    } : void 0,
+    output: output ? {
+      file: output.filename,
+      pretty: output.loose ? 2 : false,
+      removeUniversalSelector: output.removeUniversalSelector
+    } : void 0,
+    tailwind: {
+      packageName: patch?.packageName,
+      version: tailwindVersion,
+      resolve: patch?.resolve,
+      config: tailwindConfigPath,
+      cwd: tailwindCwd,
+      v2: tailwindV2,
+      v3: tailwindV3,
+      v4: tailwindV4
+    },
+    features: {
+      exposeContext: features.exposeContext,
+      extendLengthUnits: features.extendLengthUnits
+    }
+  };
+}
+function fromUnifiedConfig(registry) {
+  if (!registry) {
+    return {};
+  }
+  const tailwind = registry.tailwind;
+  const output = registry.output;
+  const pretty = (() => {
+    if (output?.pretty === void 0) {
+      return void 0;
+    }
+    if (typeof output.pretty === "boolean") {
+      return output.pretty ? 2 : false;
+    }
+    return output.pretty;
+  })();
+  return {
+    output: output ? {
+      file: output.file,
+      pretty,
+      removeUniversalSelector: output.stripUniversalSelector
+    } : void 0,
+    tailwind: tailwind ? {
+      version: tailwind.version,
+      packageName: tailwind.package,
+      resolve: tailwind.resolve,
+      config: tailwind.config,
+      cwd: tailwind.cwd,
+      v2: tailwind.legacy,
+      v3: tailwind.classic,
+      v4: tailwind.next
+    } : void 0
+  };
+}
+
+// src/options/normalize.ts
+import process2 from "process";
+import path from "pathe";
+
+// src/constants.ts
+var pkgName = "tailwindcss-patch";
+
+// src/options/normalize.ts
+function toPrettyValue(value) {
+  if (typeof value === "number") {
+    return value > 0 ? value : false;
+  }
+  if (value === true) {
+    return 2;
+  }
+  return false;
+}
+function normalizeCacheOptions(cache, projectRoot) {
+  let enabled = false;
+  let cwd = projectRoot;
+  let dir = path.resolve(cwd, "node_modules/.cache", pkgName);
+  let file = "class-cache.json";
+  let strategy = "merge";
+  if (typeof cache === "boolean") {
+    enabled = cache;
+  } else if (typeof cache === "object" && cache) {
+    enabled = cache.enabled ?? true;
+    cwd = cache.cwd ?? cwd;
+    dir = cache.dir ? path.resolve(cache.dir) : path.resolve(cwd, "node_modules/.cache", pkgName);
+    file = cache.file ?? file;
+    strategy = cache.strategy ?? strategy;
+  }
+  const filename = path.resolve(dir, file);
+  return {
+    enabled,
+    cwd,
+    dir,
+    file,
+    path: filename,
+    strategy
+  };
+}
+function normalizeOutputOptions(output) {
+  const enabled = output?.enabled ?? true;
+  const file = output?.file ?? ".tw-patch/tw-class-list.json";
+  const format = output?.format ?? "json";
+  const pretty = toPrettyValue(output?.pretty ?? true);
+  const removeUniversalSelector = output?.removeUniversalSelector ?? true;
+  return {
+    enabled,
+    file,
+    format,
+    pretty,
+    removeUniversalSelector
+  };
+}
+function normalizeExposeContextOptions(features) {
+  if (features?.exposeContext === false) {
+    return {
+      enabled: false,
+      refProperty: "contextRef"
+    };
+  }
+  if (typeof features?.exposeContext === "object" && features.exposeContext) {
+    return {
+      enabled: true,
+      refProperty: features.exposeContext.refProperty ?? "contextRef"
+    };
+  }
+  return {
+    enabled: true,
+    refProperty: "contextRef"
+  };
+}
+function normalizeExtendLengthUnitsOptions(features) {
+  const extend = features?.extendLengthUnits;
+  if (extend === false || extend === void 0) {
+    return null;
+  }
+  if (extend.enabled === false) {
+    return null;
+  }
+  const base = {
+    units: ["rpx"],
+    overwrite: true
+  };
+  return {
+    ...base,
+    ...extend,
+    enabled: extend.enabled ?? true,
+    units: extend.units ?? base.units,
+    overwrite: extend.overwrite ?? base.overwrite
+  };
+}
+function normalizeTailwindV4Options(v4, fallbackBase) {
+  const base = v4?.base ? path.resolve(v4.base) : fallbackBase;
+  const cssEntries = Array.isArray(v4?.cssEntries) ? v4.cssEntries.filter((entry) => Boolean(entry)).map((entry) => path.resolve(entry)) : [];
+  const sources = v4?.sources?.length ? v4.sources : [
+    {
+      base,
+      pattern: "**/*",
+      negated: false
+    }
+  ];
+  return {
+    base,
+    css: v4?.css,
+    cssEntries,
+    sources
+  };
+}
+function normalizeTailwindOptions(tailwind, projectRoot) {
+  const packageName = tailwind?.packageName ?? "tailwindcss";
+  const versionHint = tailwind?.version;
+  const resolve = tailwind?.resolve;
+  const cwd = tailwind?.cwd ?? projectRoot;
+  const config = tailwind?.config;
+  const postcssPlugin = tailwind?.postcssPlugin;
+  const v4 = normalizeTailwindV4Options(tailwind?.v4, cwd);
+  return {
+    packageName,
+    versionHint,
+    resolve,
+    cwd,
+    config,
+    postcssPlugin,
+    v2: tailwind?.v2,
+    v3: tailwind?.v3,
+    v4
+  };
+}
+function normalizeOptions(options = {}) {
+  const projectRoot = options.cwd ? path.resolve(options.cwd) : process2.cwd();
+  const overwrite = options.overwrite ?? true;
+  const output = normalizeOutputOptions(options.output);
+  const cache = normalizeCacheOptions(options.cache, projectRoot);
+  const tailwind = normalizeTailwindOptions(options.tailwind, projectRoot);
+  const exposeContext = normalizeExposeContextOptions(options.features);
+  const extendLengthUnits = normalizeExtendLengthUnitsOptions(options.features);
+  const filter = (className) => {
+    if (output.removeUniversalSelector && className === "*") {
+      return false;
+    }
+    if (typeof options.filter === "function") {
+      return options.filter(className) !== false;
+    }
+    return true;
+  };
+  return {
+    projectRoot,
+    overwrite,
+    tailwind,
+    features: {
+      exposeContext,
+      extendLengthUnits
+    },
+    output,
+    cache,
+    filter
+  };
+}
+
+// src/runtime/class-collector.ts
+import process3 from "process";
+import fs2 from "fs-extra";
+import path2 from "pathe";
+
+// src/utils.ts
+function isObject(val) {
+  return val !== null && typeof val === "object" && Array.isArray(val) === false;
+}
+function spliceChangesIntoString(str, changes) {
+  if (!changes[0]) {
+    return str;
+  }
+  changes.sort((a, b) => {
+    return a.end - b.end || a.start - b.start;
+  });
+  let result = "";
+  let previous = changes[0];
+  result += str.slice(0, previous.start);
+  result += previous.replacement;
+  for (let i = 1; i < changes.length; ++i) {
+    const change = changes[i];
+    result += str.slice(previous.end, change.start);
+    result += change.replacement;
+    previous = change;
+  }
+  result += str.slice(previous.end);
+  return result;
+}
+
+// src/runtime/class-collector.ts
+function collectClassesFromContexts(contexts, filter) {
+  const set = /* @__PURE__ */ new Set();
+  for (const context of contexts) {
+    if (!isObject(context) || !context.classCache) {
+      continue;
+    }
+    for (const key of context.classCache.keys()) {
+      const className = key.toString();
+      if (filter(className)) {
+        set.add(className);
+      }
+    }
+  }
+  return set;
+}
+async function collectClassesFromTailwindV4(options) {
+  const set = /* @__PURE__ */ new Set();
+  const v4Options = options.tailwind.v4;
+  if (!v4Options) {
+    return set;
+  }
+  const sources = v4Options.sources?.map((source) => {
+    return {
+      base: source.base ?? v4Options.base ?? process3.cwd(),
+      pattern: source.pattern,
+      negated: source.negated
+    };
+  });
+  if (v4Options.cssEntries.length > 0) {
+    for (const entry of v4Options.cssEntries) {
+      const filePath = path2.isAbsolute(entry) ? entry : path2.resolve(options.projectRoot, entry);
+      if (!await fs2.pathExists(filePath)) {
+        continue;
+      }
+      const css = await fs2.readFile(filePath, "utf8");
+      const candidates = await extractValidCandidates({
+        cwd: options.projectRoot,
+        base: v4Options.base,
+        css,
+        sources
+      });
+      for (const candidate of candidates) {
+        if (options.filter(candidate)) {
+          set.add(candidate);
+        }
+      }
+    }
+  } else {
+    const candidates = await extractValidCandidates({
+      cwd: options.projectRoot,
+      base: v4Options.base,
+      css: v4Options.css,
+      sources
+    });
+    for (const candidate of candidates) {
+      if (options.filter(candidate)) {
+        set.add(candidate);
+      }
+    }
+  }
+  return set;
+}
+
+// src/runtime/context-registry.ts
+import { createRequire } from "module";
+import fs3 from "fs-extra";
+import path3 from "pathe";
+var require2 = createRequire(import.meta.url);
+function resolveRuntimeEntry(packageInfo, majorVersion) {
+  const root = packageInfo.rootPath;
+  if (majorVersion === 2) {
+    const jitIndex = path3.join(root, "lib/jit/index.js");
+    if (fs3.existsSync(jitIndex)) {
+      return jitIndex;
+    }
+  } else if (majorVersion === 3) {
+    const plugin = path3.join(root, "lib/plugin.js");
+    const index = path3.join(root, "lib/index.js");
+    if (fs3.existsSync(plugin)) {
+      return plugin;
+    }
+    if (fs3.existsSync(index)) {
+      return index;
+    }
+  }
+  return void 0;
+}
+function loadRuntimeContexts(packageInfo, majorVersion, refProperty) {
+  if (majorVersion === 4) {
+    return [];
+  }
+  const entry = resolveRuntimeEntry(packageInfo, majorVersion);
+  if (!entry) {
+    return [];
+  }
+  const moduleExports = require2(entry);
+  if (!moduleExports) {
+    return [];
+  }
+  const ref = moduleExports[refProperty];
+  if (!ref) {
+    return [];
+  }
+  if (Array.isArray(ref)) {
+    return ref;
+  }
+  if (typeof ref === "object" && Array.isArray(ref.value)) {
+    return ref.value;
+  }
+  return [];
+}
+
+// src/runtime/process-tailwindcss.ts
+import { createRequire as createRequire2 } from "module";
+import path4 from "pathe";
+import postcss from "postcss";
+import { loadConfig } from "tailwindcss-config";
+var require3 = createRequire2(import.meta.url);
+async function resolveConfigPath(options) {
+  if (options.config && path4.isAbsolute(options.config)) {
+    return options.config;
+  }
+  const result = await loadConfig({ cwd: options.cwd });
+  if (!result) {
+    throw new Error(`Unable to locate Tailwind CSS config from ${options.cwd}`);
+  }
+  return result.filepath;
+}
+async function runTailwindBuild(options) {
+  const configPath = await resolveConfigPath(options);
+  const pluginName = options.postcssPlugin ?? (options.majorVersion === 4 ? "@tailwindcss/postcss" : "tailwindcss");
+  if (options.majorVersion === 4) {
+    return postcss([
+      require3(pluginName)({
+        config: configPath
+      })
+    ]).process("@import 'tailwindcss';", {
+      from: void 0
+    });
+  }
+  return postcss([
+    require3(pluginName)({
+      config: configPath
+    })
+  ]).process("@tailwind base;@tailwind components;@tailwind utilities;", {
+    from: void 0
+  });
+}
+
+// src/api/tailwindcss-patcher.ts
+import process4 from "process";
+import fs6 from "fs-extra";
+import { getPackageInfoSync } from "local-pkg";
+import path7 from "pathe";
+import { coerce } from "semver";
+
+// src/patching/operations/export-context/index.ts
+import fs4 from "fs-extra";
+import path5 from "pathe";
+
+// src/patching/operations/export-context/postcss-v2.ts
+import * as t from "@babel/types";
+
+// src/babel/index.ts
+import _babelGenerate from "@babel/generator";
+import _babelTraverse from "@babel/traverse";
+import { parse, parseExpression } from "@babel/parser";
+function _interopDefaultCompat(e) {
+  return e && typeof e === "object" && "default" in e ? e.default : e;
+}
+var generate = _interopDefaultCompat(_babelGenerate);
+var traverse = _interopDefaultCompat(_babelTraverse);
+
+// src/patching/operations/export-context/postcss-v2.ts
+var IDENTIFIER_RE = /^[A-Z_$][\w$]*$/i;
+function toIdentifierName(property) {
+  if (!property) {
+    return "contextRef";
+  }
+  const sanitized = property.replace(/[^\w$]/gu, "_");
+  if (/^\d/.test(sanitized)) {
+    return `_${sanitized}`;
+  }
+  return sanitized || "contextRef";
+}
+function createExportsMember(property) {
+  if (IDENTIFIER_RE.test(property)) {
+    return t.memberExpression(t.identifier("exports"), t.identifier(property));
+  }
+  return t.memberExpression(t.identifier("exports"), t.stringLiteral(property), true);
+}
+function transformProcessTailwindFeaturesReturnContextV2(content) {
+  const ast = parse(content, {
+    sourceType: "unambiguous"
+  });
+  let hasPatched = false;
+  traverse(ast, {
+    FunctionDeclaration(path8) {
+      const node = path8.node;
+      if (node.id?.name !== "processTailwindFeatures" || node.body.body.length !== 1 || !t.isReturnStatement(node.body.body[0])) {
+        return;
+      }
+      const returnStatement3 = node.body.body[0];
+      if (!t.isFunctionExpression(returnStatement3.argument)) {
+        return;
+      }
+      const body = returnStatement3.argument.body.body;
+      const lastStatement = body[body.length - 1];
+      const alreadyReturnsContext = Boolean(
+        t.isReturnStatement(lastStatement) && t.isIdentifier(lastStatement.argument) && lastStatement.argument.name === "context"
+      );
+      hasPatched = alreadyReturnsContext;
+      if (!alreadyReturnsContext) {
+        body.push(t.returnStatement(t.identifier("context")));
+      }
+    }
+  });
+  return {
+    code: hasPatched ? content : generate(ast).code,
+    hasPatched
+  };
+}
+function transformPostcssPluginV2(content, options) {
+  const refIdentifier = t.identifier(toIdentifierName(options.refProperty));
+  const exportMember = createExportsMember(options.refProperty);
+  const valueMember = t.memberExpression(refIdentifier, t.identifier("value"));
+  const ast = parse(content);
+  let hasPatched = false;
+  traverse(ast, {
+    Program(path8) {
+      const program = path8.node;
+      const index = program.body.findIndex((statement) => {
+        return t.isFunctionDeclaration(statement) && statement.id?.name === "_default";
+      });
+      if (index === -1) {
+        return;
+      }
+      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
+      );
+      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
+      );
+      hasPatched = alreadyHasVariable && alreadyAssignsExports;
+      if (!alreadyHasVariable) {
+        program.body.splice(
+          index,
+          0,
+          t.variableDeclaration("var", [
+            t.variableDeclarator(
+              refIdentifier,
+              t.objectExpression([
+                t.objectProperty(t.identifier("value"), t.arrayExpression())
+              ])
+            )
+          ]),
+          t.expressionStatement(
+            t.assignmentExpression("=", exportMember, refIdentifier)
+          )
+        );
+      }
+    },
+    FunctionDeclaration(path8) {
+      if (hasPatched) {
+        return;
+      }
+      const fn = path8.node;
+      if (fn.id?.name !== "_default") {
+        return;
+      }
+      if (fn.body.body.length !== 1 || !t.isReturnStatement(fn.body.body[0])) {
+        return;
+      }
+      const returnStatement3 = fn.body.body[0];
+      if (!t.isCallExpression(returnStatement3.argument) || !t.isMemberExpression(returnStatement3.argument.callee) || !t.isArrayExpression(returnStatement3.argument.callee.object)) {
+        return;
+      }
+      const fnExpression = returnStatement3.argument.callee.object.elements[1];
+      if (!fnExpression || !t.isFunctionExpression(fnExpression)) {
+        return;
+      }
+      const block = fnExpression.body;
+      const statements = block.body;
+      if (t.isExpressionStatement(statements[0]) && t.isAssignmentExpression(statements[0].expression) && t.isNumericLiteral(statements[0].expression.right)) {
+        hasPatched = true;
+        return;
+      }
+      const lastStatement = statements[statements.length - 1];
+      if (lastStatement && t.isExpressionStatement(lastStatement)) {
+        statements[statements.length - 1] = t.expressionStatement(
+          t.callExpression(
+            t.memberExpression(valueMember, t.identifier("push")),
+            [lastStatement.expression]
+          )
+        );
+      }
+      const index = statements.findIndex((statement) => t.isIfStatement(statement));
+      if (index > -1) {
+        const ifStatement = statements[index];
+        if (t.isBlockStatement(ifStatement.consequent) && ifStatement.consequent.body[1] && t.isForOfStatement(ifStatement.consequent.body[1])) {
+          const forOf = ifStatement.consequent.body[1];
+          if (t.isBlockStatement(forOf.body) && forOf.body.body.length === 1) {
+            const nestedIf = forOf.body.body[0];
+            if (nestedIf && t.isIfStatement(nestedIf) && t.isBlockStatement(nestedIf.consequent) && nestedIf.consequent.body.length === 1 && t.isExpressionStatement(nestedIf.consequent.body[0])) {
+              nestedIf.consequent.body[0] = t.expressionStatement(
+                t.callExpression(
+                  t.memberExpression(valueMember, t.identifier("push")),
+                  [nestedIf.consequent.body[0].expression]
+                )
+              );
+            }
+          }
+        }
+      }
+      statements.unshift(
+        t.expressionStatement(
+          t.assignmentExpression(
+            "=",
+            t.memberExpression(valueMember, t.identifier("length")),
+            t.numericLiteral(0)
+          )
+        )
+      );
+    }
+  });
+  return {
+    code: hasPatched ? content : generate(ast).code,
+    hasPatched
+  };
+}
+
+// src/patching/operations/export-context/postcss-v3.ts
+import * as t2 from "@babel/types";
+var IDENTIFIER_RE2 = /^[A-Z_$][\w$]*$/i;
+function toIdentifierName2(property) {
+  if (!property) {
+    return "contextRef";
+  }
+  const sanitized = property.replace(/[^\w$]/gu, "_");
+  if (/^\d/.test(sanitized)) {
+    return `_${sanitized}`;
+  }
+  return sanitized || "contextRef";
+}
+function createModuleExportsMember(property) {
+  const object = t2.memberExpression(t2.identifier("module"), t2.identifier("exports"));
+  if (IDENTIFIER_RE2.test(property)) {
+    return t2.memberExpression(object, t2.identifier(property));
+  }
+  return t2.memberExpression(object, t2.stringLiteral(property), true);
+}
+function transformProcessTailwindFeaturesReturnContext(content) {
+  const ast = parse(content);
+  let hasPatched = false;
+  traverse(ast, {
+    FunctionDeclaration(path8) {
+      const node = path8.node;
+      if (node.id?.name !== "processTailwindFeatures" || node.body.body.length !== 1) {
+        return;
+      }
+      const [returnStatement3] = node.body.body;
+      if (!t2.isReturnStatement(returnStatement3) || !t2.isFunctionExpression(returnStatement3.argument)) {
+        return;
+      }
+      const expression = returnStatement3.argument;
+      const body = expression.body.body;
+      const lastStatement = body[body.length - 1];
+      const alreadyReturnsContext = Boolean(
+        t2.isReturnStatement(lastStatement) && t2.isIdentifier(lastStatement.argument) && lastStatement.argument.name === "context"
+      );
+      hasPatched = alreadyReturnsContext;
+      if (!alreadyReturnsContext) {
+        body.push(t2.returnStatement(t2.identifier("context")));
+      }
+    }
+  });
+  return {
+    code: hasPatched ? content : generate(ast).code,
+    hasPatched
+  };
+}
+function transformPostcssPlugin(content, { refProperty }) {
+  const ast = parse(content);
+  const refIdentifier = t2.identifier(toIdentifierName2(refProperty));
+  const moduleExportsMember = createModuleExportsMember(refProperty);
+  const valueMember = t2.memberExpression(refIdentifier, t2.identifier("value"));
+  let hasPatched = false;
+  traverse(ast, {
+    Program(path8) {
+      const program = path8.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";
+      });
+      if (index === -1) {
+        return;
+      }
+      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
+      );
+      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
+      );
+      hasPatched = alreadyHasVariable && alreadyAssignsModuleExports;
+      if (!alreadyHasVariable) {
+        program.body.splice(
+          index,
+          0,
+          t2.variableDeclaration("const", [
+            t2.variableDeclarator(
+              refIdentifier,
+              t2.objectExpression([
+                t2.objectProperty(t2.identifier("value"), t2.arrayExpression())
+              ])
+            )
+          ])
+        );
+      }
+      if (!alreadyAssignsModuleExports) {
+        program.body.push(
+          t2.expressionStatement(
+            t2.assignmentExpression("=", moduleExportsMember, refIdentifier)
+          )
+        );
+      }
+    },
+    FunctionExpression(path8) {
+      if (hasPatched) {
+        return;
+      }
+      const fn = path8.node;
+      if (fn.id?.name !== "tailwindcss" || fn.body.body.length !== 1) {
+        return;
+      }
+      const [returnStatement3] = fn.body.body;
+      if (!returnStatement3 || !t2.isReturnStatement(returnStatement3) || !t2.isObjectExpression(returnStatement3.argument)) {
+        return;
+      }
+      const properties = returnStatement3.argument.properties;
+      if (properties.length !== 2) {
+        return;
+      }
+      const pluginsProperty = properties.find(
+        (prop) => t2.isObjectProperty(prop) && t2.isIdentifier(prop.key) && prop.key.name === "plugins"
+      );
+      if (!pluginsProperty || !t2.isObjectProperty(pluginsProperty) || !t2.isCallExpression(pluginsProperty.value) || !t2.isMemberExpression(pluginsProperty.value.callee) || !t2.isArrayExpression(pluginsProperty.value.callee.object)) {
+        return;
+      }
+      const pluginsArray = pluginsProperty.value.callee.object.elements;
+      const targetPlugin = pluginsArray[1];
+      if (!targetPlugin || !t2.isFunctionExpression(targetPlugin)) {
+        return;
+      }
+      const block = targetPlugin.body;
+      const statements = block.body;
+      const last = statements[statements.length - 1];
+      if (last && t2.isExpressionStatement(last)) {
+        statements[statements.length - 1] = t2.expressionStatement(
+          t2.callExpression(
+            t2.memberExpression(valueMember, t2.identifier("push")),
+            [last.expression]
+          )
+        );
+      }
+      const index = statements.findIndex((s) => t2.isIfStatement(s));
+      if (index > -1) {
+        const ifStatement = statements[index];
+        if (t2.isBlockStatement(ifStatement.consequent)) {
+          const [, second] = ifStatement.consequent.body;
+          if (second && t2.isForOfStatement(second) && t2.isBlockStatement(second.body)) {
+            const bodyStatement = second.body.body[0];
+            if (bodyStatement && t2.isIfStatement(bodyStatement) && t2.isBlockStatement(bodyStatement.consequent) && bodyStatement.consequent.body.length === 1 && t2.isExpressionStatement(bodyStatement.consequent.body[0])) {
+              bodyStatement.consequent.body[0] = t2.expressionStatement(
+                t2.callExpression(
+                  t2.memberExpression(valueMember, t2.identifier("push")),
+                  [bodyStatement.consequent.body[0].expression]
+                )
+              );
+            }
+          }
+        }
+      }
+      statements.unshift(
+        t2.expressionStatement(
+          t2.assignmentExpression(
+            "=",
+            t2.memberExpression(valueMember, t2.identifier("length")),
+            t2.numericLiteral(0)
+          )
+        )
+      );
+    }
+  });
+  return {
+    code: hasPatched ? content : generate(ast).code,
+    hasPatched
+  };
+}
+
+// src/patching/operations/export-context/index.ts
+function writeFileIfRequired(filePath, code, overwrite, successMessage) {
+  if (!overwrite) {
+    return;
+  }
+  fs4.writeFileSync(filePath, code, {
+    encoding: "utf8"
+  });
+  logger_default.success(successMessage);
+}
+function applyExposeContextPatch(params) {
+  const { rootDir, refProperty, overwrite, majorVersion } = params;
+  const result = {
+    applied: false,
+    files: {}
+  };
+  if (majorVersion === 3) {
+    const processFileRelative = "lib/processTailwindFeatures.js";
+    const processFilePath = path5.resolve(rootDir, processFileRelative);
+    if (fs4.existsSync(processFilePath)) {
+      const content = fs4.readFileSync(processFilePath, "utf8");
+      const { code, hasPatched } = transformProcessTailwindFeaturesReturnContext(content);
+      result.files[processFileRelative] = code;
+      if (!hasPatched) {
+        writeFileIfRequired(
+          processFilePath,
+          code,
+          overwrite,
+          "Patched Tailwind CSS processTailwindFeatures to expose runtime context."
+        );
+        result.applied = true;
+      }
+    }
+    const pluginCandidates = ["lib/plugin.js", "lib/index.js"];
+    const pluginRelative = pluginCandidates.find((candidate) => fs4.existsSync(path5.resolve(rootDir, candidate)));
+    if (pluginRelative) {
+      const pluginPath = path5.resolve(rootDir, pluginRelative);
+      const content = fs4.readFileSync(pluginPath, "utf8");
+      const { code, hasPatched } = transformPostcssPlugin(content, { refProperty });
+      result.files[pluginRelative] = code;
+      if (!hasPatched) {
+        writeFileIfRequired(
+          pluginPath,
+          code,
+          overwrite,
+          "Patched Tailwind CSS plugin entry to collect runtime contexts."
+        );
+        result.applied = true;
+      }
+    }
+  } else if (majorVersion === 2) {
+    const processFileRelative = "lib/jit/processTailwindFeatures.js";
+    const processFilePath = path5.resolve(rootDir, processFileRelative);
+    if (fs4.existsSync(processFilePath)) {
+      const content = fs4.readFileSync(processFilePath, "utf8");
+      const { code, hasPatched } = transformProcessTailwindFeaturesReturnContextV2(content);
+      result.files[processFileRelative] = code;
+      if (!hasPatched) {
+        writeFileIfRequired(
+          processFilePath,
+          code,
+          overwrite,
+          "Patched Tailwind CSS JIT processTailwindFeatures to expose runtime context."
+        );
+        result.applied = true;
+      }
+    }
+    const pluginRelative = "lib/jit/index.js";
+    const pluginPath = path5.resolve(rootDir, pluginRelative);
+    if (fs4.existsSync(pluginPath)) {
+      const content = fs4.readFileSync(pluginPath, "utf8");
+      const { code, hasPatched } = transformPostcssPluginV2(content, { refProperty });
+      result.files[pluginRelative] = code;
+      if (!hasPatched) {
+        writeFileIfRequired(
+          pluginPath,
+          code,
+          overwrite,
+          "Patched Tailwind CSS JIT entry to collect runtime contexts."
+        );
+        result.applied = true;
+      }
+    }
+  }
+  return result;
+}
+
+// src/patching/operations/extend-length-units.ts
+import * as t3 from "@babel/types";
+import fs5 from "fs-extra";
+import path6 from "pathe";
+function updateLengthUnitsArray(content, options) {
+  const { variableName = "lengthUnits", units } = options;
+  const ast = parse(content);
+  let arrayRef;
+  let changed = false;
+  traverse(ast, {
+    Identifier(path8) {
+      if (path8.node.name === variableName && t3.isVariableDeclarator(path8.parent) && t3.isArrayExpression(path8.parent.init)) {
+        arrayRef = path8.parent.init;
+        const existing = new Set(
+          path8.parent.init.elements.map((element) => t3.isStringLiteral(element) ? element.value : void 0).filter(Boolean)
+        );
+        for (const unit of units) {
+          if (!existing.has(unit)) {
+            path8.parent.init.elements = path8.parent.init.elements.map((element) => {
+              if (t3.isStringLiteral(element)) {
+                return t3.stringLiteral(element.value);
+              }
+              return element;
+            });
+            path8.parent.init.elements.push(t3.stringLiteral(unit));
+            changed = true;
+          }
+        }
+      }
+    }
+  });
+  return {
+    arrayRef,
+    changed
+  };
+}
+function applyExtendLengthUnitsPatchV3(rootDir, options) {
+  if (!options.enabled) {
+    return { changed: false, code: void 0 };
+  }
+  const opts = {
+    ...options,
+    lengthUnitsFilePath: options.lengthUnitsFilePath ?? "lib/util/dataTypes.js",
+    variableName: options.variableName ?? "lengthUnits"
+  };
+  const dataTypesFilePath = path6.resolve(rootDir, opts.lengthUnitsFilePath);
+  const exists = fs5.existsSync(dataTypesFilePath);
+  if (!exists) {
+    return { changed: false, code: void 0 };
+  }
+  const content = fs5.readFileSync(dataTypesFilePath, "utf8");
+  const { arrayRef, changed } = updateLengthUnitsArray(content, opts);
+  if (!arrayRef || !changed) {
+    return { changed: false, code: void 0 };
+  }
+  const { code } = generate(arrayRef, {
+    jsescOption: { quotes: "single" }
+  });
+  if (arrayRef.start != null && arrayRef.end != null) {
+    const nextCode = `${content.slice(0, arrayRef.start)}${code}${content.slice(arrayRef.end)}`;
+    if (opts.overwrite) {
+      const target = opts.destPath ? path6.resolve(opts.destPath) : dataTypesFilePath;
+      fs5.writeFileSync(target, nextCode, "utf8");
+      logger_default.success("Patched Tailwind CSS length unit list (v3).");
+    }
+    return {
+      changed: true,
+      code: nextCode
+    };
+  }
+  return {
+    changed: false,
+    code: void 0
+  };
+}
+function applyExtendLengthUnitsPatchV4(rootDir, options) {
+  if (!options.enabled) {
+    return { files: [], changed: false };
+  }
+  const opts = { ...options };
+  const distDir = path6.resolve(rootDir, "dist");
+  if (!fs5.existsSync(distDir)) {
+    return { files: [], changed: false };
+  }
+  const entries = fs5.readdirSync(distDir);
+  const chunkNames = entries.filter((entry) => entry.endsWith(".js") || entry.endsWith(".mjs"));
+  const pattern = /\[\s*["']cm["'],\s*["']mm["'],[\w,"']+\]/;
+  const candidates = chunkNames.map((chunkName) => {
+    const file = path6.join(distDir, chunkName);
+    const code = fs5.readFileSync(file, "utf8");
+    const match = pattern.exec(code);
+    if (!match) {
+      return null;
+    }
+    return {
+      file,
+      code,
+      match,
+      hasPatched: false
+    };
+  }).filter((candidate) => candidate !== null);
+  for (const item of candidates) {
+    const { code, file, match } = item;
+    const ast = parse(match[0], { sourceType: "unambiguous" });
+    traverse(ast, {
+      ArrayExpression(path8) {
+        for (const unit of opts.units) {
+          if (path8.node.elements.some((element) => t3.isStringLiteral(element) && element.value === unit)) {
+            item.hasPatched = true;
+            return;
+          }
+          path8.node.elements.push(t3.stringLiteral(unit));
+        }
+      }
+    });
+    if (item.hasPatched) {
+      continue;
+    }
+    const { code: replacement } = generate(ast, { minified: true });
+    const start = match.index ?? 0;
+    const end = start + match[0].length;
+    item.code = spliceChangesIntoString(code, [
+      {
+        start,
+        end,
+        replacement: replacement.endsWith(";") ? replacement.slice(0, -1) : replacement
+      }
+    ]);
+    if (opts.overwrite) {
+      fs5.writeFileSync(file, item.code, "utf8");
+    }
+  }
+  if (candidates.some((file) => !file.hasPatched)) {
+    logger_default.success("Patched Tailwind CSS length unit list (v4).");
+  }
+  return {
+    changed: candidates.some((file) => !file.hasPatched),
+    files: candidates
+  };
+}
+
+// src/patching/patch-runner.ts
+function applyTailwindPatches(context) {
+  const { packageInfo, options, majorVersion } = context;
+  const results = {};
+  if (options.features.exposeContext.enabled && (majorVersion === 2 || majorVersion === 3)) {
+    results.exposeContext = applyExposeContextPatch({
+      rootDir: packageInfo.rootPath,
+      refProperty: options.features.exposeContext.refProperty,
+      overwrite: options.overwrite,
+      majorVersion
+    });
+  }
+  if (options.features.extendLengthUnits?.enabled) {
+    if (majorVersion === 3) {
+      results.extendLengthUnits = applyExtendLengthUnitsPatchV3(
+        packageInfo.rootPath,
+        options.features.extendLengthUnits
+      );
+    } else if (majorVersion === 4) {
+      results.extendLengthUnits = applyExtendLengthUnitsPatchV4(
+        packageInfo.rootPath,
+        options.features.extendLengthUnits
+      );
+    }
+  }
+  return results;
+}
+
+// src/api/tailwindcss-patcher.ts
+function resolveMajorVersion(version, hint) {
+  if (hint && [2, 3, 4].includes(hint)) {
+    return hint;
+  }
+  if (version) {
+    const coerced = coerce(version);
+    if (coerced) {
+      const major = coerced.major;
+      if (major === 2 || major === 3 || major === 4) {
+        return major;
+      }
+      if (major >= 4) {
+        return 4;
+      }
+    }
+  }
+  return 3;
+}
+function resolveTailwindExecutionOptions(normalized, majorVersion) {
+  const base = normalized.tailwind;
+  if (majorVersion === 2 && base.v2) {
+    return {
+      cwd: base.v2.cwd ?? base.cwd ?? normalized.projectRoot,
+      config: base.v2.config ?? base.config,
+      postcssPlugin: base.v2.postcssPlugin ?? base.postcssPlugin
+    };
+  }
+  if (majorVersion === 3 && base.v3) {
+    return {
+      cwd: base.v3.cwd ?? base.cwd ?? normalized.projectRoot,
+      config: base.v3.config ?? base.config,
+      postcssPlugin: base.v3.postcssPlugin ?? base.postcssPlugin
+    };
+  }
+  return {
+    cwd: base.cwd ?? normalized.projectRoot,
+    config: base.config,
+    postcssPlugin: base.postcssPlugin
+  };
+}
+var TailwindcssPatcher = class {
+  options;
+  packageInfo;
+  majorVersion;
+  cacheStore;
+  constructor(options = {}) {
+    const resolvedOptions = options && typeof options === "object" && "patch" in options ? fromLegacyOptions(options) : options;
+    this.options = normalizeOptions(resolvedOptions);
+    const packageInfo = getPackageInfoSync(
+      this.options.tailwind.packageName,
+      this.options.tailwind.resolve
+    );
+    if (!packageInfo) {
+      throw new Error(`Unable to locate Tailwind CSS package "${this.options.tailwind.packageName}".`);
+    }
+    this.packageInfo = packageInfo;
+    this.majorVersion = resolveMajorVersion(
+      this.packageInfo.version,
+      this.options.tailwind.versionHint
+    );
+    this.cacheStore = new CacheStore(this.options.cache);
+  }
+  async patch() {
+    return applyTailwindPatches({
+      packageInfo: this.packageInfo,
+      options: this.options,
+      majorVersion: this.majorVersion
+    });
+  }
+  getContexts() {
+    return loadRuntimeContexts(
+      this.packageInfo,
+      this.majorVersion,
+      this.options.features.exposeContext.refProperty
+    );
+  }
+  async runTailwindBuildIfNeeded() {
+    if (this.majorVersion === 2 || this.majorVersion === 3) {
+      const executionOptions = resolveTailwindExecutionOptions(this.options, this.majorVersion);
+      await runTailwindBuild({
+        cwd: executionOptions.cwd,
+        config: executionOptions.config,
+        majorVersion: this.majorVersion,
+        postcssPlugin: executionOptions.postcssPlugin
+      });
+    }
+  }
+  async collectClassSet() {
+    if (this.majorVersion === 4) {
+      return collectClassesFromTailwindV4(this.options);
+    }
+    const contexts = this.getContexts();
+    return collectClassesFromContexts(contexts, this.options.filter);
+  }
+  collectClassSetSync() {
+    if (this.majorVersion === 4) {
+      throw new Error("getClassSetSync is not supported for Tailwind CSS v4 projects. Use getClassSet instead.");
+    }
+    const contexts = this.getContexts();
+    return collectClassesFromContexts(contexts, this.options.filter);
+  }
+  async mergeWithCache(set) {
+    if (!this.options.cache.enabled) {
+      return set;
+    }
+    const existing = await this.cacheStore.read();
+    if (this.options.cache.strategy === "merge") {
+      for (const value of existing) {
+        set.add(value);
+      }
+      await this.cacheStore.write(set);
+    } else {
+      if (set.size > 0) {
+        await this.cacheStore.write(set);
+      } else {
+        return existing;
+      }
+    }
+    return set;
+  }
+  mergeWithCacheSync(set) {
+    if (!this.options.cache.enabled) {
+      return set;
+    }
+    const existing = this.cacheStore.readSync();
+    if (this.options.cache.strategy === "merge") {
+      for (const value of existing) {
+        set.add(value);
+      }
+      this.cacheStore.writeSync(set);
+    } else {
+      if (set.size > 0) {
+        this.cacheStore.writeSync(set);
+      } else {
+        return existing;
+      }
+    }
+    return set;
+  }
+  async getClassSet() {
+    await this.runTailwindBuildIfNeeded();
+    const set = await this.collectClassSet();
+    return this.mergeWithCache(set);
+  }
+  getClassSetSync() {
+    const set = this.collectClassSetSync();
+    return this.mergeWithCacheSync(set);
+  }
+  async extract(options) {
+    const shouldWrite = options?.write ?? this.options.output.enabled;
+    const classSet = await this.getClassSet();
+    const classList = Array.from(classSet);
+    const result = {
+      classList,
+      classSet
+    };
+    if (!shouldWrite || !this.options.output.file) {
+      return result;
+    }
+    const target = path7.resolve(this.options.output.file);
+    await fs6.ensureDir(path7.dirname(target));
+    if (this.options.output.format === "json") {
+      const spaces = typeof this.options.output.pretty === "number" ? this.options.output.pretty : void 0;
+      await fs6.writeJSON(target, classList, { spaces });
+    } else {
+      await fs6.writeFile(target, `${classList.join("\n")}
+`, "utf8");
+    }
+    logger_default.success(`Tailwind CSS class list saved to ${target.replace(process4.cwd(), ".")}`);
+    return {
+      ...result,
+      filename: target
+    };
+  }
+  // Backwards compatibility helper used by tests and API consumers.
+  extractValidCandidates = extractValidCandidates;
+};
+
+export {
+  logger_default,
+  CacheStore,
+  extractRawCandidatesWithPositions,
+  extractRawCandidates,
+  extractValidCandidates,
+  fromLegacyOptions,
+  fromUnifiedConfig,
+  normalizeOptions,
+  collectClassesFromContexts,
+  collectClassesFromTailwindV4,
+  loadRuntimeContexts,
+  runTailwindBuild,
+  TailwindcssPatcher
+};