tailwindcss-patch 8.2.2 → 8.2.4

package/dist/{chunk-SB2W2SQP.mjs → chunk-4BI6FMCK.mjs}

@@ -135,9 +135,20 @@ async function extractValidCandidates(options) {
   const { __unstable__loadDesignSystem } = await importNode();
   const designSystem = await __unstable__loadDesignSystem(css, { base });
   const candidates = await extractRawCandidates(sources);
-  const validCandidates = candidates.filter(
+  const parsedCandidates = candidates.filter(
     (rawCandidate) => designSystem.parseCandidate(rawCandidate).length > 0
   );
+  if (parsedCandidates.length === 0) {
+    return parsedCandidates;
+  }
+  const cssByCandidate = designSystem.candidatesToCss(parsedCandidates);
+  const validCandidates = [];
+  for (let index = 0; index < parsedCandidates.length; index++) {
+    const css2 = cssByCandidate[index];
+    if (typeof css2 === "string" && css2.trim().length > 0) {
+      validCandidates.push(parsedCandidates[index]);
+    }
+  }
   return validCandidates;
 }
 function normalizeSources(sources, cwd) {
@@ -468,9 +479,12 @@ function normalizeExtendLengthUnitsOptions(features) {
   };
 }
 function normalizeTailwindV4Options(v4, fallbackBase) {
-  const base = v4?.base ? path2.resolve(v4.base) : fallbackBase;
+  const configuredBase = v4?.base ? path2.resolve(v4.base) : void 0;
+  const base = configuredBase ?? fallbackBase;
   const cssEntries = Array.isArray(v4?.cssEntries) ? v4.cssEntries.filter((entry) => Boolean(entry)).map((entry) => path2.resolve(entry)) : [];
-  const sources = v4?.sources?.length ? v4.sources : [
+  const userSources = v4?.sources;
+  const hasUserDefinedSources = Boolean(userSources?.length);
+  const sources = hasUserDefinedSources ? userSources : [
     {
       base,
       pattern: "**/*",
@@ -479,9 +493,11 @@ function normalizeTailwindV4Options(v4, fallbackBase) {
   ];
   return {
     base,
+    configuredBase,
     css: v4?.css,
     cssEntries,
-    sources
+    sources,
+    hasUserDefinedSources
   };
 }
 function normalizeTailwindOptions(tailwind, projectRoot) {
@@ -587,13 +603,31 @@ async function collectClassesFromTailwindV4(options) {
   if (!v4Options) {
     return set;
   }
-  const sources = v4Options.sources?.map((source) => {
-    return {
-      base: source.base ?? v4Options.base ?? process3.cwd(),
+  const toAbsolute = (value) => {
+    if (!value) {
+      return void 0;
+    }
+    return path3.isAbsolute(value) ? value : path3.resolve(options.projectRoot, value);
+  };
+  const resolvedConfiguredBase = toAbsolute(v4Options.configuredBase);
+  const resolvedDefaultBase = toAbsolute(v4Options.base) ?? process3.cwd();
+  const resolveSources = (base) => {
+    if (!v4Options.sources?.length) {
+      return void 0;
+    }
+    if (!v4Options.hasUserDefinedSources && !resolvedConfiguredBase) {
+      return v4Options.sources.map((source) => ({
+        base,
+        pattern: source.pattern,
+        negated: source.negated
+      }));
+    }
+    return v4Options.sources.map((source) => ({
+      base: source.base ?? base,
       pattern: source.pattern,
       negated: source.negated
-    };
-  });
+    }));
+  };
   if (v4Options.cssEntries.length > 0) {
     for (const entry of v4Options.cssEntries) {
       const filePath = path3.isAbsolute(entry) ? entry : path3.resolve(options.projectRoot, entry);
@@ -601,9 +635,12 @@ async function collectClassesFromTailwindV4(options) {
         continue;
       }
       const css = await fs3.readFile(filePath, "utf8");
+      const entryDir = path3.dirname(filePath);
+      const baseForEntry = resolvedConfiguredBase ?? entryDir;
+      const sources = resolveSources(baseForEntry);
       const candidates = await extractValidCandidates({
         cwd: options.projectRoot,
-        base: v4Options.base,
+        base: baseForEntry,
         css,
         sources
       });
@@ -614,9 +651,11 @@ async function collectClassesFromTailwindV4(options) {
       }
     }
   } else {
+    const baseForCss = resolvedConfiguredBase ?? resolvedDefaultBase;
+    const sources = resolveSources(baseForCss);
     const candidates = await extractValidCandidates({
       cwd: options.projectRoot,
-      base: v4Options.base,
+      base: baseForCss,
       css: v4Options.css,
       sources
     });

package/dist/{chunk-5KFYHNFJ.js → chunk-OQKHXYAK.js}

@@ -1,5 +1,5 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } 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; } var _class;// ../../node_modules/.pnpm/tsup@8.5.0_jiti@2.6.1_postcss@8.5.6_tsx@4.20.6_typescript@5.9.3_yaml@2.8.1/node_modules/tsup/assets/cjs_shims.js
-var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.src || new URL("main.js", document.baseURI).href;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } 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; } var _class;// ../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_tsx@4.20.6_typescript@5.9.3_yaml@2.8.1/node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
 var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 
 // src/logger.ts
@@ -139,9 +139,20 @@ async function extractValidCandidates(options) {
   const { __unstable__loadDesignSystem } = await importNode();
   const designSystem = await __unstable__loadDesignSystem(css, { base });
   const candidates = await extractRawCandidates(sources);
-  const validCandidates = candidates.filter(
+  const parsedCandidates = candidates.filter(
     (rawCandidate) => designSystem.parseCandidate(rawCandidate).length > 0
   );
+  if (parsedCandidates.length === 0) {
+    return parsedCandidates;
+  }
+  const cssByCandidate = designSystem.candidatesToCss(parsedCandidates);
+  const validCandidates = [];
+  for (let index = 0; index < parsedCandidates.length; index++) {
+    const css2 = cssByCandidate[index];
+    if (typeof css2 === "string" && css2.trim().length > 0) {
+      validCandidates.push(parsedCandidates[index]);
+    }
+  }
   return validCandidates;
 }
 function normalizeSources(sources, cwd) {
@@ -472,9 +483,12 @@ function normalizeExtendLengthUnitsOptions(features) {
   };
 }
 function normalizeTailwindV4Options(v4, fallbackBase) {
-  const base = _optionalChain([v4, 'optionalAccess', _35 => _35.base]) ? _pathe2.default.resolve(v4.base) : fallbackBase;
+  const configuredBase = _optionalChain([v4, 'optionalAccess', _35 => _35.base]) ? _pathe2.default.resolve(v4.base) : void 0;
+  const base = _nullishCoalesce(configuredBase, () => ( fallbackBase));
   const cssEntries = Array.isArray(_optionalChain([v4, 'optionalAccess', _36 => _36.cssEntries])) ? v4.cssEntries.filter((entry) => Boolean(entry)).map((entry) => _pathe2.default.resolve(entry)) : [];
-  const sources = _optionalChain([v4, 'optionalAccess', _37 => _37.sources, 'optionalAccess', _38 => _38.length]) ? v4.sources : [
+  const userSources = _optionalChain([v4, 'optionalAccess', _37 => _37.sources]);
+  const hasUserDefinedSources = Boolean(_optionalChain([userSources, 'optionalAccess', _38 => _38.length]));
+  const sources = hasUserDefinedSources ? userSources : [
     {
       base,
       pattern: "**/*",
@@ -483,9 +497,11 @@ function normalizeTailwindV4Options(v4, fallbackBase) {
   ];
   return {
     base,
+    configuredBase,
     css: _optionalChain([v4, 'optionalAccess', _39 => _39.css]),
     cssEntries,
-    sources
+    sources,
+    hasUserDefinedSources
   };
 }
 function normalizeTailwindOptions(tailwind, projectRoot) {
@@ -591,13 +607,31 @@ async function collectClassesFromTailwindV4(options) {
   if (!v4Options) {
     return set;
   }
-  const sources = _optionalChain([v4Options, 'access', _49 => _49.sources, 'optionalAccess', _50 => _50.map, 'call', _51 => _51((source) => {
-    return {
-      base: _nullishCoalesce(_nullishCoalesce(source.base, () => ( v4Options.base)), () => ( _process2.default.cwd())),
+  const toAbsolute = (value) => {
+    if (!value) {
+      return void 0;
+    }
+    return _pathe2.default.isAbsolute(value) ? value : _pathe2.default.resolve(options.projectRoot, value);
+  };
+  const resolvedConfiguredBase = toAbsolute(v4Options.configuredBase);
+  const resolvedDefaultBase = _nullishCoalesce(toAbsolute(v4Options.base), () => ( _process2.default.cwd()));
+  const resolveSources = (base) => {
+    if (!_optionalChain([v4Options, 'access', _49 => _49.sources, 'optionalAccess', _50 => _50.length])) {
+      return void 0;
+    }
+    if (!v4Options.hasUserDefinedSources && !resolvedConfiguredBase) {
+      return v4Options.sources.map((source) => ({
+        base,
+        pattern: source.pattern,
+        negated: source.negated
+      }));
+    }
+    return v4Options.sources.map((source) => ({
+      base: _nullishCoalesce(source.base, () => ( base)),
       pattern: source.pattern,
       negated: source.negated
-    };
-  })]);
+    }));
+  };
   if (v4Options.cssEntries.length > 0) {
     for (const entry of v4Options.cssEntries) {
       const filePath = _pathe2.default.isAbsolute(entry) ? entry : _pathe2.default.resolve(options.projectRoot, entry);
@@ -605,9 +639,12 @@ async function collectClassesFromTailwindV4(options) {
         continue;
       }
       const css = await _fsextra2.default.readFile(filePath, "utf8");
+      const entryDir = _pathe2.default.dirname(filePath);
+      const baseForEntry = _nullishCoalesce(resolvedConfiguredBase, () => ( entryDir));
+      const sources = resolveSources(baseForEntry);
       const candidates = await extractValidCandidates({
         cwd: options.projectRoot,
-        base: v4Options.base,
+        base: baseForEntry,
         css,
         sources
       });
@@ -618,9 +655,11 @@ async function collectClassesFromTailwindV4(options) {
       }
     }
   } else {
+    const baseForCss = _nullishCoalesce(resolvedConfiguredBase, () => ( resolvedDefaultBase));
+    const sources = resolveSources(baseForCss);
     const candidates = await extractValidCandidates({
       cwd: options.projectRoot,
-      base: v4Options.base,
+      base: baseForCss,
       css: v4Options.css,
       sources
     });
@@ -769,7 +808,7 @@ function transformProcessTailwindFeaturesReturnContextV2(content) {
   traverse(ast, {
     FunctionDeclaration(path9) {
       const node = path9.node;
-      if (_optionalChain([node, 'access', _52 => _52.id, 'optionalAccess', _53 => _53.name]) !== "processTailwindFeatures" || node.body.body.length !== 1 || !t.isReturnStatement(node.body.body[0])) {
+      if (_optionalChain([node, 'access', _51 => _51.id, 'optionalAccess', _52 => _52.name]) !== "processTailwindFeatures" || node.body.body.length !== 1 || !t.isReturnStatement(node.body.body[0])) {
         return;
       }
       const returnStatement3 = node.body.body[0];
@@ -802,7 +841,7 @@ function transformPostcssPluginV2(content, options) {
     Program(path9) {
       const program = path9.node;
       const index = program.body.findIndex((statement) => {
-        return t.isFunctionDeclaration(statement) && _optionalChain([statement, 'access', _54 => _54.id, 'optionalAccess', _55 => _55.name]) === "_default";
+        return t.isFunctionDeclaration(statement) && _optionalChain([statement, 'access', _53 => _53.id, 'optionalAccess', _54 => _54.name]) === "_default";
       });
       if (index === -1) {
         return;
@@ -839,7 +878,7 @@ function transformPostcssPluginV2(content, options) {
         return;
       }
       const fn = path9.node;
-      if (_optionalChain([fn, 'access', _56 => _56.id, 'optionalAccess', _57 => _57.name]) !== "_default") {
+      if (_optionalChain([fn, 'access', _55 => _55.id, 'optionalAccess', _56 => _56.name]) !== "_default") {
         return;
       }
       if (fn.body.body.length !== 1 || !t.isReturnStatement(fn.body.body[0])) {
@@ -929,7 +968,7 @@ function transformProcessTailwindFeaturesReturnContext(content) {
   traverse(ast, {
     FunctionDeclaration(path9) {
       const node = path9.node;
-      if (_optionalChain([node, 'access', _58 => _58.id, 'optionalAccess', _59 => _59.name]) !== "processTailwindFeatures" || node.body.body.length !== 1) {
+      if (_optionalChain([node, 'access', _57 => _57.id, 'optionalAccess', _58 => _58.name]) !== "processTailwindFeatures" || node.body.body.length !== 1) {
         return;
       }
       const [returnStatement3] = node.body.body;
@@ -963,7 +1002,7 @@ function transformPostcssPlugin(content, { refProperty }) {
     Program(path9) {
       const program = path9.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) && _optionalChain([statement, 'access', _60 => _60.expression, 'access', _61 => _61.right, 'access', _62 => _62.id, 'optionalAccess', _63 => _63.name]) === "tailwindcss";
+        return t2.isExpressionStatement(statement) && t2.isAssignmentExpression(statement.expression) && t2.isMemberExpression(statement.expression.left) && t2.isFunctionExpression(statement.expression.right) && _optionalChain([statement, 'access', _59 => _59.expression, 'access', _60 => _60.right, 'access', _61 => _61.id, 'optionalAccess', _62 => _62.name]) === "tailwindcss";
       });
       if (index === -1) {
         return;
@@ -1004,7 +1043,7 @@ function transformPostcssPlugin(content, { refProperty }) {
         return;
       }
       const fn = path9.node;
-      if (_optionalChain([fn, 'access', _64 => _64.id, 'optionalAccess', _65 => _65.name]) !== "tailwindcss" || fn.body.body.length !== 1) {
+      if (_optionalChain([fn, 'access', _63 => _63.id, 'optionalAccess', _64 => _64.name]) !== "tailwindcss" || fn.body.body.length !== 1) {
         return;
       }
       const [returnStatement3] = fn.body.body;
@@ -1312,7 +1351,7 @@ function applyTailwindPatches(context) {
       majorVersion
     });
   }
-  if (_optionalChain([options, 'access', _66 => _66.features, 'access', _67 => _67.extendLengthUnits, 'optionalAccess', _68 => _68.enabled])) {
+  if (_optionalChain([options, 'access', _65 => _65.features, 'access', _66 => _66.extendLengthUnits, 'optionalAccess', _67 => _67.enabled])) {
     if (majorVersion === 3) {
       results.extendLengthUnits = applyExtendLengthUnitsPatchV3(
         packageInfo.rootPath,
@@ -1478,7 +1517,7 @@ var TailwindcssPatcher = (_class = class {
     return this.mergeWithCacheSync(set);
   }
   async extract(options) {
-    const shouldWrite = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _69 => _69.write]), () => ( this.options.output.enabled));
+    const shouldWrite = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _68 => _68.write]), () => ( this.options.output.enabled));
     const classSet = await this.getClassSet();
     const classList = Array.from(classSet);
     const result = {
@@ -1507,18 +1546,18 @@ var TailwindcssPatcher = (_class = class {
   __init() {this.extractValidCandidates = exports.extractValidCandidates = extractValidCandidates}
   async collectContentTokens(options) {
     return extractProjectCandidatesWithPositions({
-      cwd: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _70 => _70.cwd]), () => ( this.options.projectRoot)),
-      sources: _nullishCoalesce(_nullishCoalesce(_optionalChain([options, 'optionalAccess', _71 => _71.sources]), () => ( _optionalChain([this, 'access', _72 => _72.options, 'access', _73 => _73.tailwind, 'access', _74 => _74.v4, 'optionalAccess', _75 => _75.sources]))), () => ( []))
+      cwd: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _69 => _69.cwd]), () => ( this.options.projectRoot)),
+      sources: _nullishCoalesce(_nullishCoalesce(_optionalChain([options, 'optionalAccess', _70 => _70.sources]), () => ( _optionalChain([this, 'access', _71 => _71.options, 'access', _72 => _72.tailwind, 'access', _73 => _73.v4, 'optionalAccess', _74 => _74.sources]))), () => ( []))
     });
   }
   async collectContentTokensByFile(options) {
     const report = await this.collectContentTokens({
-      cwd: _optionalChain([options, 'optionalAccess', _76 => _76.cwd]),
-      sources: _optionalChain([options, 'optionalAccess', _77 => _77.sources])
+      cwd: _optionalChain([options, 'optionalAccess', _75 => _75.cwd]),
+      sources: _optionalChain([options, 'optionalAccess', _76 => _76.sources])
     });
     return groupTokensByFile(report, {
-      key: _optionalChain([options, 'optionalAccess', _78 => _78.key]),
-      stripAbsolutePaths: _optionalChain([options, 'optionalAccess', _79 => _79.stripAbsolutePaths])
+      key: _optionalChain([options, 'optionalAccess', _77 => _77.key]),
+      stripAbsolutePaths: _optionalChain([options, 'optionalAccess', _78 => _78.stripAbsolutePaths])
     });
   }
 }, _class);

package/dist/cli.js

@@ -4,7 +4,7 @@
 
 
 
-var _chunk5KFYHNFJjs = require('./chunk-5KFYHNFJ.js');
+var _chunkOQKHXYAKjs = require('./chunk-OQKHXYAK.js');
 
 // src/cli.ts
 var _process = require('process'); var _process2 = _interopRequireDefault(_process);
@@ -108,15 +108,15 @@ 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]) ? _chunk5KFYHNFJjs.fromUnifiedConfig.call(void 0, config.registry) : _optionalChain([legacyConfig, 'optionalAccess', _2 => _2.patch]) ? _chunk5KFYHNFJjs.fromLegacyOptions.call(void 0, { patch: legacyConfig.patch }) : {};
+  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, _chunk5KFYHNFJjs.TailwindcssPatcher)(options);
+  const patcher = new (0, _chunkOQKHXYAKjs.TailwindcssPatcher)(options);
   await patcher.patch();
-  _chunk5KFYHNFJjs.logger_default.success("Tailwind CSS runtime patched successfully.");
+  _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 = {};
@@ -134,18 +134,18 @@ cli.command("extract", "Collect generated class names into a cache file").option
     };
   }
   const options = await loadPatchOptions(args.cwd, overrides);
-  const patcher = new (0, _chunk5KFYHNFJjs.TailwindcssPatcher)(options);
+  const patcher = new (0, _chunkOQKHXYAKjs.TailwindcssPatcher)(options);
   const result = await patcher.extract({ write: args.write });
   if (result.filename) {
-    _chunk5KFYHNFJjs.logger_default.success(`Collected ${result.classList.length} classes \u2192 ${result.filename}`);
+    _chunkOQKHXYAKjs.logger_default.success(`Collected ${result.classList.length} classes \u2192 ${result.filename}`);
   } else {
-    _chunk5KFYHNFJjs.logger_default.success(`Collected ${result.classList.length} classes.`);
+    _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, _chunk5KFYHNFJjs.TailwindcssPatcher)(options);
+  const patcher = new (0, _chunkOQKHXYAKjs.TailwindcssPatcher)(options);
   const report = await patcher.collectContentTokens();
   const shouldWrite = _nullishCoalesce(args.write, () => ( true));
   let format = _nullishCoalesce(args.format, () => ( "json"));
@@ -154,7 +154,7 @@ cli.command("tokens", "Extract Tailwind tokens with file/position metadata").opt
   }
   const targetFile = _nullishCoalesce(args.output, () => ( ".tw-patch/tw-token-report.json"));
   const groupKey = args.groupKey === "absolute" ? "absolute" : "relative";
-  const buildGrouped = () => _chunk5KFYHNFJjs.groupTokensByFile.call(void 0, report, {
+  const buildGrouped = () => _chunkOQKHXYAKjs.groupTokensByFile.call(void 0, report, {
     key: groupKey,
     stripAbsolutePaths: groupKey !== "absolute"
   });
@@ -172,48 +172,48 @@ cli.command("tokens", "Extract Tailwind tokens with file/position metadata").opt
       await _fsextra2.default.writeFile(target, `${lines.join("\n")}
 `, "utf8");
     }
-    _chunk5KFYHNFJjs.logger_default.success(
+    _chunkOQKHXYAKjs.logger_default.success(
       `Collected ${report.entries.length} tokens (${format}) \u2192 ${target.replace(_process2.default.cwd(), ".")}`
     );
   } else {
-    _chunk5KFYHNFJjs.logger_default.success(`Collected ${report.entries.length} tokens from ${report.filesScanned} files.`);
+    _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) {
-        _chunk5KFYHNFJjs.logger_default.log("");
-        _chunk5KFYHNFJjs.logger_default.info(preview);
+        _chunkOQKHXYAKjs.logger_default.log("");
+        _chunkOQKHXYAKjs.logger_default.info(preview);
         if (report.entries.length > 5) {
-          _chunk5KFYHNFJjs.logger_default.info(`\u2026and ${report.entries.length - 5} more.`);
+          _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) {
-        _chunk5KFYHNFJjs.logger_default.log("");
-        _chunk5KFYHNFJjs.logger_default.info(preview);
+        _chunkOQKHXYAKjs.logger_default.log("");
+        _chunkOQKHXYAKjs.logger_default.info(preview);
         if (moreFiles > 0) {
-          _chunk5KFYHNFJjs.logger_default.info(`\u2026and ${moreFiles} more files.`);
+          _chunkOQKHXYAKjs.logger_default.info(`\u2026and ${moreFiles} more files.`);
         }
       }
     } else {
       const previewEntries = report.entries.slice(0, 3);
       if (previewEntries.length) {
-        _chunk5KFYHNFJjs.logger_default.log("");
-        _chunk5KFYHNFJjs.logger_default.info(JSON.stringify(previewEntries, null, 2));
+        _chunkOQKHXYAKjs.logger_default.log("");
+        _chunkOQKHXYAKjs.logger_default.info(JSON.stringify(previewEntries, null, 2));
       }
     }
   }
   if (report.skippedFiles.length) {
-    _chunk5KFYHNFJjs.logger_default.warn("Skipped files:");
+    _chunkOQKHXYAKjs.logger_default.warn("Skipped files:");
     for (const skipped of report.skippedFiles) {
-      _chunk5KFYHNFJjs.logger_default.warn(`  \u2022 ${skipped.file} (${skipped.reason})`);
+      _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);
-  _chunk5KFYHNFJjs.logger_default.success(`\u2728 ${_config.CONFIG_NAME}.config.ts initialized!`);
+  _chunkOQKHXYAKjs.logger_default.success(`\u2728 ${_config.CONFIG_NAME}.config.ts initialized!`);
 });
 cli.help();
 cli.parse();

package/dist/cli.mjs

@@ -4,7 +4,7 @@ import {
   fromUnifiedConfig,
   groupTokensByFile,
   logger_default
-} from "./chunk-SB2W2SQP.mjs";
+} from "./chunk-4BI6FMCK.mjs";
 
 // src/cli.ts
 import process from "process";

package/dist/index.d.mts

@@ -7,66 +7,131 @@ export { defineConfig } from '@tailwindcss-mangle/config';
 import * as consola from 'consola';
 
 type CacheStrategy = 'merge' | 'overwrite';
+/**
+ * Configures how the Tailwind class cache is stored and where it lives on disk.
+ */
 interface CacheUserOptions {
+    /** Whether caching is enabled. */
     enabled?: boolean;
+    /** Working directory used when resolving cache paths. */
     cwd?: string;
+    /** Directory where cache files are written. */
     dir?: string;
+    /**
+     * Cache filename. Defaults to `class-cache.json` inside the derived cache folder
+     * when omitted.
+     */
     file?: string;
+    /** Strategy used when merging new class lists with an existing cache. */
     strategy?: CacheStrategy;
 }
+/**
+ * Controls how extracted class lists are written to disk.
+ */
 interface OutputUserOptions {
+    /** Whether to produce an output file. */
     enabled?: boolean;
+    /** Optional absolute or relative path to the output file. */
     file?: string;
+    /** Output format, defaults to JSON when omitted. */
     format?: 'json' | 'lines';
+    /** Pretty-print spacing (truthy value enables indentation). */
     pretty?: number | boolean;
+    /** Whether to strip the universal selector (`*`) from the final list. */
     removeUniversalSelector?: boolean;
 }
+/**
+ * Options controlling how Tailwind contexts are exposed during runtime patching.
+ */
 interface ExposeContextUserOptions {
+    /** Name of the property used to reference an exposed context. */
     refProperty?: string;
 }
+/**
+ * Extends the built-in length-unit patch with custom defaults.
+ */
 interface ExtendLengthUnitsUserOptions extends Partial<ILengthUnitsPatchOptions> {
+    /** Enables or disables the length-unit patch. */
     enabled?: boolean;
 }
+/**
+ * Feature switches that toggle optional Tailwind patch capabilities.
+ */
 interface FeatureUserOptions {
+    /** Whether to expose runtime Tailwind contexts (or configure how they are exposed). */
     exposeContext?: boolean | ExposeContextUserOptions;
+    /** Extends the length-unit patch or disables it entirely. */
     extendLengthUnits?: false | ExtendLengthUnitsUserOptions;
 }
+/**
+ * Shared configuration used for Tailwind v2/v3 patching flows.
+ */
 interface TailwindConfigUserOptions {
+    /** Path to a Tailwind config file when auto-detection is insufficient. */
     config?: string;
+    /** Custom working directory used when resolving config-relative paths. */
     cwd?: string;
+    /** Optional PostCSS plugin name to use instead of the default. */
     postcssPlugin?: string;
 }
+/**
+ * Additional configuration specific to Tailwind CSS v4 extraction.
+ */
 interface TailwindV4UserOptions {
+    /** Base directory used when resolving v4 content sources and configs. */
     base?: string;
+    /** Raw CSS passed directly to the v4 design system. */
     css?: string;
+    /** Set of CSS entry files that should be scanned for `@config` directives. */
     cssEntries?: string[];
+    /** Overrides the content sources scanned by the oxide scanner. */
     sources?: SourceEntry[];
 }
+/**
+ * High-level Tailwind patch configuration shared across versions.
+ */
 interface TailwindUserOptions extends TailwindConfigUserOptions {
     /**
      * Optional hint for picking the patch strategy.
      * When omitted we infer from the installed Tailwind CSS package version.
      */
     version?: 2 | 3 | 4;
+    /** Tailwind package name if the project uses a fork. */
     packageName?: string;
+    /** Package resolution options forwarded to `local-pkg`. */
     resolve?: PackageResolvingOptions;
+    /** Overrides applied when patching Tailwind CSS v2. */
     v2?: TailwindConfigUserOptions;
+    /** Overrides applied when patching Tailwind CSS v3. */
     v3?: TailwindConfigUserOptions;
+    /** Options specific to Tailwind CSS v4 patching. */
     v4?: TailwindV4UserOptions;
 }
+/**
+ * Root configuration consumed by the Tailwind CSS patch runner.
+ */
 interface TailwindcssPatchOptions {
     /**
      * Base directory used when resolving Tailwind resources.
      * Defaults to `process.cwd()`.
      */
     cwd?: string;
+    /** Whether to overwrite generated artifacts (e.g., caches, outputs). */
     overwrite?: boolean;
+    /** Tailwind-specific configuration grouped by major version. */
     tailwind?: TailwindUserOptions;
+    /** Feature toggles for optional helpers. */
     features?: FeatureUserOptions;
+    /** Optional function that filters final class names. */
     filter?: (className: string) => boolean;
+    /** Cache configuration or boolean to enable/disable quickly. */
     cache?: boolean | CacheUserOptions;
+    /** Output configuration or boolean to inherits defaults. */
     output?: OutputUserOptions;
 }
+/**
+ * Stable shape for output configuration after normalization.
+ */
 interface NormalizedOutputOptions {
     enabled: boolean;
     file?: string;
@@ -74,6 +139,9 @@ interface NormalizedOutputOptions {
     pretty: number | false;
     removeUniversalSelector: boolean;
 }
+/**
+ * Stable cache configuration used internally after defaults are applied.
+ */
 interface NormalizedCacheOptions {
     enabled: boolean;
     cwd: string;
@@ -82,19 +150,27 @@ interface NormalizedCacheOptions {
     path: string;
     strategy: CacheStrategy;
 }
+/** Tracks whether runtime contexts should be exposed and via which property. */
 interface NormalizedExposeContextOptions {
     enabled: boolean;
     refProperty: string;
 }
+/** Normalized representation of the extend-length-units feature flag. */
 interface NormalizedExtendLengthUnitsOptions extends ILengthUnitsPatchOptions {
     enabled: boolean;
 }
+/** Normalized Tailwind v4 configuration consumed by runtime helpers. */
 interface NormalizedTailwindV4Options {
     base: string;
+    configuredBase?: string;
     css?: string;
     cssEntries: string[];
     sources: SourceEntry[];
+    hasUserDefinedSources: boolean;
 }
+/**
+ * Tailwind configuration ready for consumption by the runtime after normalization.
+ */
 interface NormalizedTailwindConfigOptions extends TailwindConfigUserOptions {
     packageName: string;
     versionHint?: 2 | 3 | 4;
@@ -103,10 +179,12 @@ interface NormalizedTailwindConfigOptions extends TailwindConfigUserOptions {
     v3?: TailwindConfigUserOptions;
     v4?: NormalizedTailwindV4Options;
 }
+/** Grouped normalized feature flags. */
 interface NormalizedFeatureOptions {
     exposeContext: NormalizedExposeContextOptions;
     extendLengthUnits: NormalizedExtendLengthUnitsOptions | null;
 }
+/** Final normalized shape consumed throughout the patch runtime. */
 interface NormalizedTailwindcssPatchOptions {
     projectRoot: string;
     overwrite: boolean;

package/dist/index.d.ts

@@ -7,66 +7,131 @@ export { defineConfig } from '@tailwindcss-mangle/config';
 import * as consola from 'consola';
 
 type CacheStrategy = 'merge' | 'overwrite';
+/**
+ * Configures how the Tailwind class cache is stored and where it lives on disk.
+ */
 interface CacheUserOptions {
+    /** Whether caching is enabled. */
     enabled?: boolean;
+    /** Working directory used when resolving cache paths. */
     cwd?: string;
+    /** Directory where cache files are written. */
     dir?: string;
+    /**
+     * Cache filename. Defaults to `class-cache.json` inside the derived cache folder
+     * when omitted.
+     */
     file?: string;
+    /** Strategy used when merging new class lists with an existing cache. */
     strategy?: CacheStrategy;
 }
+/**
+ * Controls how extracted class lists are written to disk.
+ */
 interface OutputUserOptions {
+    /** Whether to produce an output file. */
     enabled?: boolean;
+    /** Optional absolute or relative path to the output file. */
     file?: string;
+    /** Output format, defaults to JSON when omitted. */
     format?: 'json' | 'lines';
+    /** Pretty-print spacing (truthy value enables indentation). */
     pretty?: number | boolean;
+    /** Whether to strip the universal selector (`*`) from the final list. */
     removeUniversalSelector?: boolean;
 }
+/**
+ * Options controlling how Tailwind contexts are exposed during runtime patching.
+ */
 interface ExposeContextUserOptions {
+    /** Name of the property used to reference an exposed context. */
     refProperty?: string;
 }
+/**
+ * Extends the built-in length-unit patch with custom defaults.
+ */
 interface ExtendLengthUnitsUserOptions extends Partial<ILengthUnitsPatchOptions> {
+    /** Enables or disables the length-unit patch. */
     enabled?: boolean;
 }
+/**
+ * Feature switches that toggle optional Tailwind patch capabilities.
+ */
 interface FeatureUserOptions {
+    /** Whether to expose runtime Tailwind contexts (or configure how they are exposed). */
     exposeContext?: boolean | ExposeContextUserOptions;
+    /** Extends the length-unit patch or disables it entirely. */
     extendLengthUnits?: false | ExtendLengthUnitsUserOptions;
 }
+/**
+ * Shared configuration used for Tailwind v2/v3 patching flows.
+ */
 interface TailwindConfigUserOptions {
+    /** Path to a Tailwind config file when auto-detection is insufficient. */
     config?: string;
+    /** Custom working directory used when resolving config-relative paths. */
     cwd?: string;
+    /** Optional PostCSS plugin name to use instead of the default. */
     postcssPlugin?: string;
 }
+/**
+ * Additional configuration specific to Tailwind CSS v4 extraction.
+ */
 interface TailwindV4UserOptions {
+    /** Base directory used when resolving v4 content sources and configs. */
     base?: string;
+    /** Raw CSS passed directly to the v4 design system. */
     css?: string;
+    /** Set of CSS entry files that should be scanned for `@config` directives. */
     cssEntries?: string[];
+    /** Overrides the content sources scanned by the oxide scanner. */
     sources?: SourceEntry[];
 }
+/**
+ * High-level Tailwind patch configuration shared across versions.
+ */
 interface TailwindUserOptions extends TailwindConfigUserOptions {
     /**
      * Optional hint for picking the patch strategy.
      * When omitted we infer from the installed Tailwind CSS package version.
      */
     version?: 2 | 3 | 4;
+    /** Tailwind package name if the project uses a fork. */
     packageName?: string;
+    /** Package resolution options forwarded to `local-pkg`. */
     resolve?: PackageResolvingOptions;
+    /** Overrides applied when patching Tailwind CSS v2. */
     v2?: TailwindConfigUserOptions;
+    /** Overrides applied when patching Tailwind CSS v3. */
     v3?: TailwindConfigUserOptions;
+    /** Options specific to Tailwind CSS v4 patching. */
     v4?: TailwindV4UserOptions;
 }
+/**
+ * Root configuration consumed by the Tailwind CSS patch runner.
+ */
 interface TailwindcssPatchOptions {
     /**
      * Base directory used when resolving Tailwind resources.
      * Defaults to `process.cwd()`.
      */
     cwd?: string;
+    /** Whether to overwrite generated artifacts (e.g., caches, outputs). */
     overwrite?: boolean;
+    /** Tailwind-specific configuration grouped by major version. */
     tailwind?: TailwindUserOptions;
+    /** Feature toggles for optional helpers. */
     features?: FeatureUserOptions;
+    /** Optional function that filters final class names. */
     filter?: (className: string) => boolean;
+    /** Cache configuration or boolean to enable/disable quickly. */
     cache?: boolean | CacheUserOptions;
+    /** Output configuration or boolean to inherits defaults. */
     output?: OutputUserOptions;
 }
+/**
+ * Stable shape for output configuration after normalization.
+ */
 interface NormalizedOutputOptions {
     enabled: boolean;
     file?: string;
@@ -74,6 +139,9 @@ interface NormalizedOutputOptions {
     pretty: number | false;
     removeUniversalSelector: boolean;
 }
+/**
+ * Stable cache configuration used internally after defaults are applied.
+ */
 interface NormalizedCacheOptions {
     enabled: boolean;
     cwd: string;
@@ -82,19 +150,27 @@ interface NormalizedCacheOptions {
     path: string;
     strategy: CacheStrategy;
 }
+/** Tracks whether runtime contexts should be exposed and via which property. */
 interface NormalizedExposeContextOptions {
     enabled: boolean;
     refProperty: string;
 }
+/** Normalized representation of the extend-length-units feature flag. */
 interface NormalizedExtendLengthUnitsOptions extends ILengthUnitsPatchOptions {
     enabled: boolean;
 }
+/** Normalized Tailwind v4 configuration consumed by runtime helpers. */
 interface NormalizedTailwindV4Options {
     base: string;
+    configuredBase?: string;
     css?: string;
     cssEntries: string[];
     sources: SourceEntry[];
+    hasUserDefinedSources: boolean;
 }
+/**
+ * Tailwind configuration ready for consumption by the runtime after normalization.
+ */
 interface NormalizedTailwindConfigOptions extends TailwindConfigUserOptions {
     packageName: string;
     versionHint?: 2 | 3 | 4;
@@ -103,10 +179,12 @@ interface NormalizedTailwindConfigOptions extends TailwindConfigUserOptions {
     v3?: TailwindConfigUserOptions;
     v4?: NormalizedTailwindV4Options;
 }
+/** Grouped normalized feature flags. */
 interface NormalizedFeatureOptions {
     exposeContext: NormalizedExposeContextOptions;
     extendLengthUnits: NormalizedExtendLengthUnitsOptions | null;
 }
+/** Final normalized shape consumed throughout the patch runtime. */
 interface NormalizedTailwindcssPatchOptions {
     projectRoot: string;
     overwrite: boolean;

package/dist/index.js

@@ -12,7 +12,7 @@
 
 
 
-var _chunk5KFYHNFJjs = require('./chunk-5KFYHNFJ.js');
+var _chunkOQKHXYAKjs = require('./chunk-OQKHXYAK.js');
 
 // src/index.ts
 var _config = require('@tailwindcss-mangle/config');
@@ -31,4 +31,4 @@ var _config = require('@tailwindcss-mangle/config');
 
 
 
-exports.CacheStore = _chunk5KFYHNFJjs.CacheStore; exports.TailwindcssPatcher = _chunk5KFYHNFJjs.TailwindcssPatcher; exports.collectClassesFromContexts = _chunk5KFYHNFJjs.collectClassesFromContexts; exports.collectClassesFromTailwindV4 = _chunk5KFYHNFJjs.collectClassesFromTailwindV4; exports.defineConfig = _config.defineConfig; exports.extractProjectCandidatesWithPositions = _chunk5KFYHNFJjs.extractProjectCandidatesWithPositions; exports.extractRawCandidates = _chunk5KFYHNFJjs.extractRawCandidates; exports.extractRawCandidatesWithPositions = _chunk5KFYHNFJjs.extractRawCandidatesWithPositions; exports.extractValidCandidates = _chunk5KFYHNFJjs.extractValidCandidates; exports.groupTokensByFile = _chunk5KFYHNFJjs.groupTokensByFile; exports.loadRuntimeContexts = _chunk5KFYHNFJjs.loadRuntimeContexts; exports.logger = _chunk5KFYHNFJjs.logger_default; exports.normalizeOptions = _chunk5KFYHNFJjs.normalizeOptions; exports.runTailwindBuild = _chunk5KFYHNFJjs.runTailwindBuild;
+exports.CacheStore = _chunkOQKHXYAKjs.CacheStore; exports.TailwindcssPatcher = _chunkOQKHXYAKjs.TailwindcssPatcher; exports.collectClassesFromContexts = _chunkOQKHXYAKjs.collectClassesFromContexts; exports.collectClassesFromTailwindV4 = _chunkOQKHXYAKjs.collectClassesFromTailwindV4; exports.defineConfig = _config.defineConfig; exports.extractProjectCandidatesWithPositions = _chunkOQKHXYAKjs.extractProjectCandidatesWithPositions; exports.extractRawCandidates = _chunkOQKHXYAKjs.extractRawCandidates; exports.extractRawCandidatesWithPositions = _chunkOQKHXYAKjs.extractRawCandidatesWithPositions; exports.extractValidCandidates = _chunkOQKHXYAKjs.extractValidCandidates; exports.groupTokensByFile = _chunkOQKHXYAKjs.groupTokensByFile; exports.loadRuntimeContexts = _chunkOQKHXYAKjs.loadRuntimeContexts; exports.logger = _chunkOQKHXYAKjs.logger_default; exports.normalizeOptions = _chunkOQKHXYAKjs.normalizeOptions; exports.runTailwindBuild = _chunkOQKHXYAKjs.runTailwindBuild;

package/dist/index.mjs

@@ -12,7 +12,7 @@ import {
   logger_default,
   normalizeOptions,
   runTailwindBuild
-} from "./chunk-SB2W2SQP.mjs";
+} from "./chunk-4BI6FMCK.mjs";
 
 // src/index.ts
 import { defineConfig } from "@tailwindcss-mangle/config";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tailwindcss-patch",
-  "version": "8.2.2",
+  "version": "8.2.4",
   "description": "patch tailwindcss for exposing context and extract classes",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -54,7 +54,7 @@
     "@babel/parser": "^7.28.5",
     "@babel/traverse": "^7.28.5",
     "@babel/types": "^7.28.5",
-    "@tailwindcss/node": "^4.1.16",
+    "@tailwindcss/node": "^4.1.17",
     "cac": "^6.7.14",
     "consola": "^3.4.2",
     "fs-extra": "^11.3.2",
@@ -66,10 +66,10 @@
     "@tailwindcss-mangle/config": "6.1.0"
   },
   "devDependencies": {
-    "@tailwindcss/oxide": "^4.1.16",
-    "@tailwindcss/postcss": "^4.1.16",
-    "@tailwindcss/vite": "^4.1.16",
-    "tailwindcss": "^4.1.16",
+    "@tailwindcss/oxide": "^4.1.17",
+    "@tailwindcss/postcss": "^4.1.17",
+    "@tailwindcss/vite": "^4.1.17",
+    "tailwindcss": "^4.1.17",
     "tailwindcss-3": "npm:tailwindcss@^3.4.18",
     "tailwindcss-4": "npm:tailwindcss@^4.1.16"
   },