weapp-tailwindcss 4.10.0 → 4.10.2

package/dist/core.js

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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 _chunkHFXMZGPWjs = require('./chunk-HFXMZGPW.js');
+var _chunkM2ATX5ZSjs = require('./chunk-M2ATX5ZS.js');
 
 
 
-var _chunkVTIOEDOKjs = require('./chunk-VTIOEDOK.js');
+var _chunkI35XJD75js = require('./chunk-I35XJD75.js');
 require('./chunk-5APD2MNV.js');
 require('./chunk-5U24PLVV.js');
 require('./chunk-DYLQ6UOI.js');
@@ -14,9 +14,9 @@ require('./chunk-DBAAU4LK.js');
 var _process = require('process'); var _process2 = _interopRequireDefault(_process);
 var _shared = require('@weapp-tailwindcss/shared');
 function createContext(options = {}) {
-  const opts = _chunkVTIOEDOKjs.getCompilerContext.call(void 0, options);
+  const opts = _chunkI35XJD75js.getCompilerContext.call(void 0, options);
   const { templateHandler, styleHandler, jsHandler, twPatcher: initialTwPatcher, refreshTailwindcssPatcher } = opts;
-  const patchRecorderState = _chunkHFXMZGPWjs.setupPatchRecorder.call(void 0, initialTwPatcher, opts.tailwindcssBasedir, {
+  const patchRecorderState = _chunkM2ATX5ZSjs.setupPatchRecorder.call(void 0, initialTwPatcher, opts.tailwindcssBasedir, {
     source: "runtime",
     cwd: _nullishCoalesce(opts.tailwindcssBasedir, () => ( _process2.default.cwd()))
   });
@@ -27,12 +27,25 @@ function createContext(options = {}) {
     refreshTailwindcssPatcher,
     onPatchCompleted: patchRecorderState.onPatchCompleted
   };
+  function withRuntimeTailwindMajorVersion(options2) {
+    const resolvedOptions = {
+      ..._nullishCoalesce(options2, () => ( {}))
+    };
+    if (typeof resolvedOptions.tailwindcssMajorVersion === "number") {
+      return resolvedOptions;
+    }
+    const majorVersion = runtimeState.twPatcher.majorVersion;
+    if (typeof majorVersion === "number") {
+      resolvedOptions.tailwindcssMajorVersion = majorVersion;
+    }
+    return resolvedOptions;
+  }
   async function transformWxss(rawCss, options2) {
     await runtimeState.patchPromise;
     const result = await styleHandler(rawCss, _shared.defuOverrideArray.call(void 0, options2, {
       isMainChunk: true
     }));
-    runtimeSet = await _chunkVTIOEDOKjs.ensureRuntimeClassSet.call(void 0, runtimeState, {
+    runtimeSet = await _chunkI35XJD75js.ensureRuntimeClassSet.call(void 0, runtimeState, {
       forceRefresh: true,
       forceCollect: true
     });
@@ -40,24 +53,19 @@ function createContext(options = {}) {
   }
   async function transformJs(rawJs, options2 = {}) {
     await runtimeState.patchPromise;
-    const hasRuntimeSetOption = Object.prototype.hasOwnProperty.call(options2, "runtimeSet");
     if (_optionalChain([options2, 'optionalAccess', _ => _.runtimeSet])) {
       runtimeSet = options2.runtimeSet;
     } else if (runtimeSet.size === 0) {
-      runtimeSet = await _chunkVTIOEDOKjs.ensureRuntimeClassSet.call(void 0, runtimeState, {
+      runtimeSet = await _chunkI35XJD75js.ensureRuntimeClassSet.call(void 0, runtimeState, {
         forceCollect: true
       });
     }
-    const useStaleClassNameFallback = _nullishCoalesce(options2.staleClassNameFallback, () => ( !(hasRuntimeSetOption && options2.runtimeSet instanceof Set && options2.runtimeSet.size === 0)));
-    return await jsHandler(rawJs, runtimeSet, {
-      staleClassNameFallback: useStaleClassNameFallback,
-      ...options2
-    });
+    return await jsHandler(rawJs, runtimeSet, withRuntimeTailwindMajorVersion(options2));
   }
   async function transformWxml(rawWxml, options2) {
     await runtimeState.patchPromise;
     if (!_optionalChain([options2, 'optionalAccess', _2 => _2.runtimeSet]) && runtimeSet.size === 0) {
-      runtimeSet = await _chunkVTIOEDOKjs.ensureRuntimeClassSet.call(void 0, runtimeState, {
+      runtimeSet = await _chunkI35XJD75js.ensureRuntimeClassSet.call(void 0, runtimeState, {
         forceCollect: true
       });
     }
@@ -65,10 +73,7 @@ function createContext(options = {}) {
     return templateHandler(rawWxml, _shared.defuOverrideArray.call(void 0, options2, {
       runtimeSet,
       jsHandler: (source, runtime, handlerOptions) => {
-        return runtimeJsHandler(source, runtime, {
-          staleClassNameFallback: true,
-          ...handlerOptions
-        });
+        return runtimeJsHandler(source, runtime, withRuntimeTailwindMajorVersion(handlerOptions));
       }
     }));
   }

package/dist/core.mjs

@@ -1,10 +1,10 @@
 import {
   setupPatchRecorder
-} from "./chunk-F6VHIO5B.mjs";
+} from "./chunk-BZCCVPSU.mjs";
 import {
   ensureRuntimeClassSet,
   getCompilerContext
-} from "./chunk-Q5IGGG5W.mjs";
+} from "./chunk-MPVAZKRB.mjs";
 import "./chunk-QOTLDKI4.mjs";
 import "./chunk-3WUHHFLF.mjs";
 import "./chunk-OOHJLO5M.mjs";
@@ -27,6 +27,19 @@ function createContext(options = {}) {
     refreshTailwindcssPatcher,
     onPatchCompleted: patchRecorderState.onPatchCompleted
   };
+  function withRuntimeTailwindMajorVersion(options2) {
+    const resolvedOptions = {
+      ...options2 ?? {}
+    };
+    if (typeof resolvedOptions.tailwindcssMajorVersion === "number") {
+      return resolvedOptions;
+    }
+    const majorVersion = runtimeState.twPatcher.majorVersion;
+    if (typeof majorVersion === "number") {
+      resolvedOptions.tailwindcssMajorVersion = majorVersion;
+    }
+    return resolvedOptions;
+  }
   async function transformWxss(rawCss, options2) {
     await runtimeState.patchPromise;
     const result = await styleHandler(rawCss, defuOverrideArray(options2, {
@@ -40,7 +53,6 @@ function createContext(options = {}) {
   }
   async function transformJs(rawJs, options2 = {}) {
     await runtimeState.patchPromise;
-    const hasRuntimeSetOption = Object.prototype.hasOwnProperty.call(options2, "runtimeSet");
     if (options2?.runtimeSet) {
       runtimeSet = options2.runtimeSet;
     } else if (runtimeSet.size === 0) {
@@ -48,11 +60,7 @@ function createContext(options = {}) {
         forceCollect: true
       });
     }
-    const useStaleClassNameFallback = options2.staleClassNameFallback ?? !(hasRuntimeSetOption && options2.runtimeSet instanceof Set && options2.runtimeSet.size === 0);
-    return await jsHandler(rawJs, runtimeSet, {
-      staleClassNameFallback: useStaleClassNameFallback,
-      ...options2
-    });
+    return await jsHandler(rawJs, runtimeSet, withRuntimeTailwindMajorVersion(options2));
   }
   async function transformWxml(rawWxml, options2) {
     await runtimeState.patchPromise;
@@ -65,10 +73,7 @@ function createContext(options = {}) {
     return templateHandler(rawWxml, defuOverrideArray(options2, {
       runtimeSet,
       jsHandler: (source, runtime, handlerOptions) => {
-        return runtimeJsHandler(source, runtime, {
-          staleClassNameFallback: true,
-          ...handlerOptions
-        });
+        return runtimeJsHandler(source, runtime, withRuntimeTailwindMajorVersion(handlerOptions));
       }
     }));
   }

package/dist/defaults.d.mts

@@ -1,4 +1,4 @@
-import { U as UserDefinedOptions } from './index-B6U7MoOM.mjs';
+import { U as UserDefinedOptions } from './index-t_VBjwYm.mjs';
 import '@babel/parser';
 import '@weapp-tailwindcss/postcss';
 import 'tailwindcss-patch';

package/dist/defaults.d.ts

@@ -1,4 +1,4 @@
-import { U as UserDefinedOptions } from './index-B6U7MoOM.js';
+import { U as UserDefinedOptions } from './index-t_VBjwYm.js';
 import '@babel/parser';
 import '@weapp-tailwindcss/postcss';
 import 'tailwindcss-patch';

package/dist/gulp.d.mts

@@ -1,6 +1,6 @@
 import { ITemplateHandlerOptions, CreateJsHandlerOptions } from './types.mjs';
 import stream from 'node:stream';
-import { U as UserDefinedOptions } from './index-B6U7MoOM.mjs';
+import { U as UserDefinedOptions } from './index-t_VBjwYm.mjs';
 import { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss';
 import '@babel/parser';
 import 'magic-string';

package/dist/gulp.d.ts

@@ -1,6 +1,6 @@
 import { ITemplateHandlerOptions, CreateJsHandlerOptions } from './types.js';
 import stream from 'node:stream';
-import { U as UserDefinedOptions } from './index-B6U7MoOM.js';
+import { U as UserDefinedOptions } from './index-t_VBjwYm.js';
 import { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss';
 import '@babel/parser';
 import 'magic-string';

package/dist/gulp.js

@@ -1,13 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkDA2K4ZIEjs = require('./chunk-DA2K4ZIE.js');
+var _chunkNPZ5QQC7js = require('./chunk-NPZ5QQC7.js');
 require('./chunk-LTJQUORK.js');
-require('./chunk-HFXMZGPW.js');
-require('./chunk-VTIOEDOK.js');
+require('./chunk-M2ATX5ZS.js');
+require('./chunk-I35XJD75.js');
 require('./chunk-5APD2MNV.js');
 require('./chunk-5U24PLVV.js');
 require('./chunk-DYLQ6UOI.js');
 require('./chunk-DBAAU4LK.js');
 
 
-exports.createPlugins = _chunkDA2K4ZIEjs.createPlugins;
+exports.createPlugins = _chunkNPZ5QQC7js.createPlugins;

package/dist/gulp.mjs

@@ -1,9 +1,9 @@
 import {
   createPlugins
-} from "./chunk-ZP6TLVZX.mjs";
+} from "./chunk-N6JOG5K3.mjs";
 import "./chunk-RRHPTTCP.mjs";
-import "./chunk-F6VHIO5B.mjs";
-import "./chunk-Q5IGGG5W.mjs";
+import "./chunk-BZCCVPSU.mjs";
+import "./chunk-MPVAZKRB.mjs";
 import "./chunk-QOTLDKI4.mjs";
 import "./chunk-3WUHHFLF.mjs";
 import "./chunk-OOHJLO5M.mjs";

package/dist/{index-B6U7MoOM.d.ts → index-t_VBjwYm.d.mts}

@@ -123,17 +123,24 @@ interface UserDefinedOptionsGeneralPart {
      */
     jsPreserveClass?: (keyword: string) => boolean | undefined;
     /**
-     * 运行时类集合可能滞后时，是否对未命中 `classNameSet` 的候选类名执行保守兜底转义。
+     * 兼容字段：不再参与 JS 候选判定。
      *
      * @group 3.一般配置
      * @remarks
-     * 适用于 Vite HMR / watch 增量场景中 class 集合暂时过期的情况。
-     *
-     * - `true`: 始终启用兜底转义（正确性优先，建议配合 `jsPreserveClass` 避免误伤）
-     * - `false`: 仅转换命中 `classNameSet` 的候选类名
-     * - 未配置：Vite `serve` / `build --watch` 默认启用，其它模式默认关闭
+     * JS 转译统一采用 `classNameSet` 精确匹配策略，仅转换 tailwindcss-patch 提供的类名集合。
      */
     staleClassNameFallback?: boolean;
+    /**
+     * 控制 JS 任意值类名在 classNameSet 异常时的受控兜底策略。
+     *
+     * @group 3.一般配置
+     * @remarks
+     * 为避免误伤业务字符串，兜底仅在 class 语义上下文生效。
+     * - `false`：关闭兜底；
+     * - `true`：始终开启受控兜底；
+     * - `'auto'`：仅 TailwindCSS v4 且 classNameSet 为空时启用。
+     */
+    jsArbitraryValueFallback?: boolean | 'auto';
     /**
      * 是否替换运行时依赖包名。
      *

package/dist/{index-B6U7MoOM.d.mts → index-t_VBjwYm.d.ts}

@@ -123,17 +123,24 @@ interface UserDefinedOptionsGeneralPart {
      */
     jsPreserveClass?: (keyword: string) => boolean | undefined;
     /**
-     * 运行时类集合可能滞后时，是否对未命中 `classNameSet` 的候选类名执行保守兜底转义。
+     * 兼容字段：不再参与 JS 候选判定。
      *
      * @group 3.一般配置
      * @remarks
-     * 适用于 Vite HMR / watch 增量场景中 class 集合暂时过期的情况。
-     *
-     * - `true`: 始终启用兜底转义（正确性优先，建议配合 `jsPreserveClass` 避免误伤）
-     * - `false`: 仅转换命中 `classNameSet` 的候选类名
-     * - 未配置：Vite `serve` / `build --watch` 默认启用，其它模式默认关闭
+     * JS 转译统一采用 `classNameSet` 精确匹配策略，仅转换 tailwindcss-patch 提供的类名集合。
      */
     staleClassNameFallback?: boolean;
+    /**
+     * 控制 JS 任意值类名在 classNameSet 异常时的受控兜底策略。
+     *
+     * @group 3.一般配置
+     * @remarks
+     * 为避免误伤业务字符串，兜底仅在 class 语义上下文生效。
+     * - `false`：关闭兜底；
+     * - `true`：始终开启受控兜底；
+     * - `'auto'`：仅 TailwindCSS v4 且 classNameSet 为空时启用。
+     */
+    jsArbitraryValueFallback?: boolean | 'auto';
     /**
      * 是否替换运行时依赖包名。
      *

package/dist/index.d.mts

@@ -2,7 +2,7 @@ export { createPlugins } from './gulp.mjs';
 export { CreateJsHandlerOptions, IBaseWebpackPlugin, ICommonReplaceOptions, IJsHandlerOptions, ITemplateHandlerOptions, InternalPatchResult, InternalPostcssOptions, InternalUserDefinedOptions, JsHandler, JsHandlerResult, JsModuleGraphOptions, LinkedJsModuleResult, RefreshTailwindcssPatcherOptions, TailwindcssPatcherLike } from './types.mjs';
 export { UnifiedViteWeappTailwindcssPlugin } from './vite.mjs';
 export { UnifiedWebpackPluginV5, weappTailwindcssPackageDir } from './webpack.mjs';
-export { A as AppType, D as DisabledOptions, I as IArbitraryValues, a as ICustomAttributes, b as ICustomAttributesEntities, c as ItemOrItemArray, U as UserDefinedOptions } from './index-B6U7MoOM.mjs';
+export { A as AppType, D as DisabledOptions, I as IArbitraryValues, a as ICustomAttributes, b as ICustomAttributesEntities, c as ItemOrItemArray, U as UserDefinedOptions } from './index-t_VBjwYm.mjs';
 export { CssPreflightOptions, IStyleHandlerOptions } from '@weapp-tailwindcss/postcss';
 import 'node:stream';
 import '@babel/parser';

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { createPlugins } from './gulp.js';
 export { CreateJsHandlerOptions, IBaseWebpackPlugin, ICommonReplaceOptions, IJsHandlerOptions, ITemplateHandlerOptions, InternalPatchResult, InternalPostcssOptions, InternalUserDefinedOptions, JsHandler, JsHandlerResult, JsModuleGraphOptions, LinkedJsModuleResult, RefreshTailwindcssPatcherOptions, TailwindcssPatcherLike } from './types.js';
 export { UnifiedViteWeappTailwindcssPlugin } from './vite.js';
 export { UnifiedWebpackPluginV5, weappTailwindcssPackageDir } from './webpack.js';
-export { A as AppType, D as DisabledOptions, I as IArbitraryValues, a as ICustomAttributes, b as ICustomAttributesEntities, c as ItemOrItemArray, U as UserDefinedOptions } from './index-B6U7MoOM.js';
+export { A as AppType, D as DisabledOptions, I as IArbitraryValues, a as ICustomAttributes, b as ICustomAttributesEntities, c as ItemOrItemArray, U as UserDefinedOptions } from './index-t_VBjwYm.js';
 export { CssPreflightOptions, IStyleHandlerOptions } from '@weapp-tailwindcss/postcss';
 import 'node:stream';
 import '@babel/parser';

package/dist/index.js

@@ -1,18 +1,18 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkJA6PNN27js = require('./chunk-JA6PNN27.js');
-require('./chunk-PDP4OIKN.js');
+var _chunk6VKE7EWVjs = require('./chunk-6VKE7EWV.js');
+require('./chunk-HJVZ4TO3.js');
 
 
-var _chunkDA2K4ZIEjs = require('./chunk-DA2K4ZIE.js');
+var _chunkNPZ5QQC7js = require('./chunk-NPZ5QQC7.js');
 
 
-var _chunkVZX2RV6Mjs = require('./chunk-VZX2RV6M.js');
+var _chunk3R7FDZJLjs = require('./chunk-3R7FDZJL.js');
 require('./chunk-IIDSY4XZ.js');
 require('./chunk-LTJQUORK.js');
-require('./chunk-HFXMZGPW.js');
-require('./chunk-VTIOEDOK.js');
+require('./chunk-M2ATX5ZS.js');
+require('./chunk-I35XJD75.js');
 require('./chunk-5APD2MNV.js');
 require('./chunk-5U24PLVV.js');
 require('./chunk-DYLQ6UOI.js');
@@ -22,4 +22,4 @@ require('./chunk-DBAAU4LK.js');
 
 
 
-exports.UnifiedViteWeappTailwindcssPlugin = _chunkVZX2RV6Mjs.UnifiedViteWeappTailwindcssPlugin; exports.UnifiedWebpackPluginV5 = _chunkJA6PNN27js.UnifiedWebpackPluginV5; exports.createPlugins = _chunkDA2K4ZIEjs.createPlugins; exports.weappTailwindcssPackageDir = _chunkJA6PNN27js.weappTailwindcssPackageDir;
+exports.UnifiedViteWeappTailwindcssPlugin = _chunk3R7FDZJLjs.UnifiedViteWeappTailwindcssPlugin; exports.UnifiedWebpackPluginV5 = _chunk6VKE7EWVjs.UnifiedWebpackPluginV5; exports.createPlugins = _chunkNPZ5QQC7js.createPlugins; exports.weappTailwindcssPackageDir = _chunk6VKE7EWVjs.weappTailwindcssPackageDir;

package/dist/index.mjs

@@ -1,18 +1,18 @@
 import {
   UnifiedWebpackPluginV5,
   weappTailwindcssPackageDir
-} from "./chunk-TNAPEHNW.mjs";
-import "./chunk-6QU7CMAG.mjs";
+} from "./chunk-LHBUALTK.mjs";
+import "./chunk-ACNOEKQI.mjs";
 import {
   createPlugins
-} from "./chunk-ZP6TLVZX.mjs";
+} from "./chunk-N6JOG5K3.mjs";
 import {
   UnifiedViteWeappTailwindcssPlugin
-} from "./chunk-D67CTJV5.mjs";
+} from "./chunk-WJU62RPV.mjs";
 import "./chunk-F2CKKG6Q.mjs";
 import "./chunk-RRHPTTCP.mjs";
-import "./chunk-F6VHIO5B.mjs";
-import "./chunk-Q5IGGG5W.mjs";
+import "./chunk-BZCCVPSU.mjs";
+import "./chunk-MPVAZKRB.mjs";
 import "./chunk-QOTLDKI4.mjs";
 import "./chunk-3WUHHFLF.mjs";
 import "./chunk-OOHJLO5M.mjs";

package/dist/presets.d.mts

@@ -1,5 +1,5 @@
 import { PackageResolvingOptions } from 'local-pkg';
-import { U as UserDefinedOptions } from './index-B6U7MoOM.mjs';
+import { U as UserDefinedOptions } from './index-t_VBjwYm.mjs';
 import '@babel/parser';
 import '@weapp-tailwindcss/postcss';
 import 'tailwindcss-patch';

package/dist/presets.d.ts

@@ -1,5 +1,5 @@
 import { PackageResolvingOptions } from 'local-pkg';
-import { U as UserDefinedOptions } from './index-B6U7MoOM.js';
+import { U as UserDefinedOptions } from './index-t_VBjwYm.js';
 import '@babel/parser';
 import '@weapp-tailwindcss/postcss';
 import 'tailwindcss-patch';

package/dist/types.d.mts

@@ -4,8 +4,8 @@ export { CssPreflightOptions, IStyleHandlerOptions } from '@weapp-tailwindcss/po
 import { SourceMap } from 'magic-string';
 import { Result, Root, Document } from 'postcss';
 import { ILengthUnitsPatchOptions, TailwindcssPatcher } from 'tailwindcss-patch';
-import { I as IArbitraryValues, U as UserDefinedOptions, b as ICustomAttributesEntities, d as ICreateCacheReturnType, A as AppType } from './index-B6U7MoOM.mjs';
-export { D as DisabledOptions, a as ICustomAttributes, c as ItemOrItemArray } from './index-B6U7MoOM.mjs';
+import { I as IArbitraryValues, U as UserDefinedOptions, b as ICustomAttributesEntities, d as ICreateCacheReturnType, A as AppType } from './index-t_VBjwYm.mjs';
+export { D as DisabledOptions, a as ICustomAttributes, c as ItemOrItemArray } from './index-t_VBjwYm.mjs';
 import 'node:buffer';
 import 'webpack';
 import 'lru-cache';
@@ -41,10 +41,23 @@ interface IJsHandlerOptions {
     escapeMap?: Record<string, string>;
     classNameSet?: Set<string>;
     /**
-     * 当 classNameSet 可能滞后（如热更新）时，允许对未命中集合的候选类名执行保守兜底转义。
-     * 默认关闭，避免在常规 JS 文本中出现误替换。
+     * 兼容字段：不再参与 JS 候选判定。
+     *
+     * JS 转译统一遵循 `classNameSet` 精确命中策略，仅转换 tailwindcss-patch 提供的类名集合。
      */
     staleClassNameFallback?: boolean;
+    /**
+     * 控制在 classNameSet 异常时的任意值兜底策略。
+     *
+     * - `false`：关闭兜底。
+     * - `true`：在 class 语义上下文中允许任意值兜底。
+     * - `'auto'`：仅在 TailwindCSS v4 且 classNameSet 为空时启用。
+     */
+    jsArbitraryValueFallback?: boolean | 'auto';
+    /**
+     * 当前 TailwindCSS 主版本号，用于自动兜底判定。
+     */
+    tailwindcssMajorVersion?: number;
     arbitraryValues?: IArbitraryValues;
     jsPreserveClass?: (keyword: string) => boolean | undefined;
     needEscaped?: boolean;

package/dist/types.d.ts

@@ -4,8 +4,8 @@ export { CssPreflightOptions, IStyleHandlerOptions } from '@weapp-tailwindcss/po
 import { SourceMap } from 'magic-string';
 import { Result, Root, Document } from 'postcss';
 import { ILengthUnitsPatchOptions, TailwindcssPatcher } from 'tailwindcss-patch';
-import { I as IArbitraryValues, U as UserDefinedOptions, b as ICustomAttributesEntities, d as ICreateCacheReturnType, A as AppType } from './index-B6U7MoOM.js';
-export { D as DisabledOptions, a as ICustomAttributes, c as ItemOrItemArray } from './index-B6U7MoOM.js';
+import { I as IArbitraryValues, U as UserDefinedOptions, b as ICustomAttributesEntities, d as ICreateCacheReturnType, A as AppType } from './index-t_VBjwYm.js';
+export { D as DisabledOptions, a as ICustomAttributes, c as ItemOrItemArray } from './index-t_VBjwYm.js';
 import 'node:buffer';
 import 'webpack';
 import 'lru-cache';
@@ -41,10 +41,23 @@ interface IJsHandlerOptions {
     escapeMap?: Record<string, string>;
     classNameSet?: Set<string>;
     /**
-     * 当 classNameSet 可能滞后（如热更新）时，允许对未命中集合的候选类名执行保守兜底转义。
-     * 默认关闭，避免在常规 JS 文本中出现误替换。
+     * 兼容字段：不再参与 JS 候选判定。
+     *
+     * JS 转译统一遵循 `classNameSet` 精确命中策略，仅转换 tailwindcss-patch 提供的类名集合。
      */
     staleClassNameFallback?: boolean;
+    /**
+     * 控制在 classNameSet 异常时的任意值兜底策略。
+     *
+     * - `false`：关闭兜底。
+     * - `true`：在 class 语义上下文中允许任意值兜底。
+     * - `'auto'`：仅在 TailwindCSS v4 且 classNameSet 为空时启用。
+     */
+    jsArbitraryValueFallback?: boolean | 'auto';
+    /**
+     * 当前 TailwindCSS 主版本号，用于自动兜底判定。
+     */
+    tailwindcssMajorVersion?: number;
     arbitraryValues?: IArbitraryValues;
     jsPreserveClass?: (keyword: string) => boolean | undefined;
     needEscaped?: boolean;

package/dist/vite.d.mts

@@ -1,5 +1,5 @@
 import { Plugin } from 'vite';
-import { U as UserDefinedOptions } from './index-B6U7MoOM.mjs';
+import { U as UserDefinedOptions } from './index-t_VBjwYm.mjs';
 import '@babel/parser';
 import '@weapp-tailwindcss/postcss';
 import 'tailwindcss-patch';

package/dist/vite.d.ts

@@ -1,5 +1,5 @@
 import { Plugin } from 'vite';
-import { U as UserDefinedOptions } from './index-B6U7MoOM.js';
+import { U as UserDefinedOptions } from './index-t_VBjwYm.js';
 import '@babel/parser';
 import '@weapp-tailwindcss/postcss';
 import 'tailwindcss-patch';

package/dist/vite.js

@@ -1,14 +1,14 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkVZX2RV6Mjs = require('./chunk-VZX2RV6M.js');
+var _chunk3R7FDZJLjs = require('./chunk-3R7FDZJL.js');
 require('./chunk-IIDSY4XZ.js');
 require('./chunk-LTJQUORK.js');
-require('./chunk-HFXMZGPW.js');
-require('./chunk-VTIOEDOK.js');
+require('./chunk-M2ATX5ZS.js');
+require('./chunk-I35XJD75.js');
 require('./chunk-5APD2MNV.js');
 require('./chunk-5U24PLVV.js');
 require('./chunk-DYLQ6UOI.js');
 require('./chunk-DBAAU4LK.js');
 
 
-exports.UnifiedViteWeappTailwindcssPlugin = _chunkVZX2RV6Mjs.UnifiedViteWeappTailwindcssPlugin;
+exports.UnifiedViteWeappTailwindcssPlugin = _chunk3R7FDZJLjs.UnifiedViteWeappTailwindcssPlugin;

package/dist/vite.mjs

@@ -1,10 +1,10 @@
 import {
   UnifiedViteWeappTailwindcssPlugin
-} from "./chunk-D67CTJV5.mjs";
+} from "./chunk-WJU62RPV.mjs";
 import "./chunk-F2CKKG6Q.mjs";
 import "./chunk-RRHPTTCP.mjs";
-import "./chunk-F6VHIO5B.mjs";
-import "./chunk-Q5IGGG5W.mjs";
+import "./chunk-BZCCVPSU.mjs";
+import "./chunk-MPVAZKRB.mjs";
 import "./chunk-QOTLDKI4.mjs";
 import "./chunk-3WUHHFLF.mjs";
 import "./chunk-OOHJLO5M.mjs";

package/dist/webpack.d.mts

@@ -1,6 +1,6 @@
 import { Compiler } from 'webpack';
 import { IBaseWebpackPlugin, InternalUserDefinedOptions } from './types.mjs';
-import { A as AppType, U as UserDefinedOptions } from './index-B6U7MoOM.mjs';
+import { A as AppType, U as UserDefinedOptions } from './index-t_VBjwYm.mjs';
 import '@babel/parser';
 import '@weapp-tailwindcss/postcss';
 import 'magic-string';

package/dist/webpack.d.ts

@@ -1,6 +1,6 @@
 import { Compiler } from 'webpack';
 import { IBaseWebpackPlugin, InternalUserDefinedOptions } from './types.js';
-import { A as AppType, U as UserDefinedOptions } from './index-B6U7MoOM.js';
+import { A as AppType, U as UserDefinedOptions } from './index-t_VBjwYm.js';
 import '@babel/parser';
 import '@weapp-tailwindcss/postcss';
 import 'magic-string';

package/dist/webpack.js

@@ -1,12 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkJA6PNN27js = require('./chunk-JA6PNN27.js');
-require('./chunk-PDP4OIKN.js');
+var _chunk6VKE7EWVjs = require('./chunk-6VKE7EWV.js');
+require('./chunk-HJVZ4TO3.js');
 require('./chunk-IIDSY4XZ.js');
 require('./chunk-LTJQUORK.js');
-require('./chunk-HFXMZGPW.js');
-require('./chunk-VTIOEDOK.js');
+require('./chunk-M2ATX5ZS.js');
+require('./chunk-I35XJD75.js');
 require('./chunk-5APD2MNV.js');
 require('./chunk-5U24PLVV.js');
 require('./chunk-DYLQ6UOI.js');
@@ -14,4 +14,4 @@ require('./chunk-DBAAU4LK.js');
 
 
 
-exports.UnifiedWebpackPluginV5 = _chunkJA6PNN27js.UnifiedWebpackPluginV5; exports.weappTailwindcssPackageDir = _chunkJA6PNN27js.weappTailwindcssPackageDir;
+exports.UnifiedWebpackPluginV5 = _chunk6VKE7EWVjs.UnifiedWebpackPluginV5; exports.weappTailwindcssPackageDir = _chunk6VKE7EWVjs.weappTailwindcssPackageDir;

package/dist/webpack.mjs

@@ -1,12 +1,12 @@
 import {
   UnifiedWebpackPluginV5,
   weappTailwindcssPackageDir
-} from "./chunk-TNAPEHNW.mjs";
-import "./chunk-6QU7CMAG.mjs";
+} from "./chunk-LHBUALTK.mjs";
+import "./chunk-ACNOEKQI.mjs";
 import "./chunk-F2CKKG6Q.mjs";
 import "./chunk-RRHPTTCP.mjs";
-import "./chunk-F6VHIO5B.mjs";
-import "./chunk-Q5IGGG5W.mjs";
+import "./chunk-BZCCVPSU.mjs";
+import "./chunk-MPVAZKRB.mjs";
 import "./chunk-QOTLDKI4.mjs";
 import "./chunk-3WUHHFLF.mjs";
 import "./chunk-OOHJLO5M.mjs";

package/dist/webpack4.d.mts

@@ -1,6 +1,6 @@
 import { Compiler } from 'webpack4';
 import { IBaseWebpackPlugin, InternalUserDefinedOptions } from './types.mjs';
-import { A as AppType, U as UserDefinedOptions } from './index-B6U7MoOM.mjs';
+import { A as AppType, U as UserDefinedOptions } from './index-t_VBjwYm.mjs';
 import '@babel/parser';
 import '@weapp-tailwindcss/postcss';
 import 'magic-string';

package/dist/webpack4.d.ts

@@ -1,6 +1,6 @@
 import { Compiler } from 'webpack4';
 import { IBaseWebpackPlugin, InternalUserDefinedOptions } from './types.js';
-import { A as AppType, U as UserDefinedOptions } from './index-B6U7MoOM.js';
+import { A as AppType, U as UserDefinedOptions } from './index-t_VBjwYm.js';
 import '@babel/parser';
 import '@weapp-tailwindcss/postcss';
 import 'magic-string';