weapp-tailwindcss 4.0.0-alpha.8 → 4.0.0

package/dist/index.js

@@ -1,22 +1,22 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-FXPGR372.js');
 
 
-var _chunkW3O6VH4Hjs = require('./chunk-W3O6VH4H.js');
+var _chunkDXVFKGNLjs = require('./chunk-DXVFKGNL.js');
 
 
-var _chunk3CGOYSLCjs = require('./chunk-3CGOYSLC.js');
+var _chunkPZFXLVE2js = require('./chunk-PZFXLVE2.js');
 
 
-var _chunkLQTX4UOGjs = require('./chunk-LQTX4UOG.js');
+var _chunkAHF73IRBjs = require('./chunk-AHF73IRB.js');
 require('./chunk-HBQASQKY.js');
 require('./chunk-N62XM3T3.js');
-require('./chunk-5CLZ2D6F.js');
-require('./chunk-RFNUATFD.js');
-require('./chunk-6LFESXEB.js');
+require('./chunk-P3IRFH3E.js');
+require('./chunk-WGQLZ5K4.js');
+require('./chunk-YUXG2EJF.js');
 require('./chunk-35CYTBPM.js');
 require('./chunk-6FNC3XMI.js');
 
 
 
 
-exports.UnifiedViteWeappTailwindcssPlugin = _chunkLQTX4UOGjs.UnifiedViteWeappTailwindcssPlugin; exports.UnifiedWebpackPluginV5 = _chunkW3O6VH4Hjs.UnifiedWebpackPluginV5; exports.createPlugins = _chunk3CGOYSLCjs.createPlugins;
+exports.UnifiedViteWeappTailwindcssPlugin = _chunkAHF73IRBjs.UnifiedViteWeappTailwindcssPlugin; exports.UnifiedWebpackPluginV5 = _chunkDXVFKGNLjs.UnifiedWebpackPluginV5; exports.createPlugins = _chunkPZFXLVE2js.createPlugins;

package/dist/index.mjs

@@ -1,18 +1,18 @@
 import "./chunk-LOLJLZCX.mjs";
 import {
   UnifiedWebpackPluginV5
-} from "./chunk-ULHA32LG.mjs";
+} from "./chunk-UJFSOSOM.mjs";
 import {
   createPlugins
-} from "./chunk-NOJXTM75.mjs";
+} from "./chunk-M5OLCGMK.mjs";
 import {
   UnifiedViteWeappTailwindcssPlugin
-} from "./chunk-M46SZJAU.mjs";
+} from "./chunk-HI4MB6DS.mjs";
 import "./chunk-75EWCRQW.mjs";
 import "./chunk-HL6Y5PYZ.mjs";
-import "./chunk-HRK65AE5.mjs";
-import "./chunk-U7O2XXYR.mjs";
-import "./chunk-Y4EU4S4H.mjs";
+import "./chunk-W3GZOMW4.mjs";
+import "./chunk-PCBSAFQF.mjs";
+import "./chunk-RHTRRSP3.mjs";
 import "./chunk-MUJ65IQ3.mjs";
 import "./chunk-AXBFBHS2.mjs";
 export {

package/dist/types.d.mts

@@ -1,5 +1,5 @@
-import { ParseError, ParserOptions } from '@babel/parser';
-import { IMangleScopeContext, IMangleOptions } from '@weapp-tailwindcss/mangle';
+import { ParserOptions, ParseError } from '@babel/parser';
+import { IMangleOptions, IMangleScopeContext } from '@weapp-tailwindcss/mangle';
 export { IMangleScopeContext } from '@weapp-tailwindcss/mangle';
 import { CssPreflightOptions, LoadedPostcssOptions, CustomRuleCallback, IStyleHandlerOptions } from '@weapp-tailwindcss/postcss';
 export { CssPreflightOptions, IStyleHandlerOptions } from '@weapp-tailwindcss/postcss';
@@ -9,6 +9,7 @@ import { ILengthUnitsPatchOptions, TailwindcssPatcher } from 'tailwindcss-patch'
 import { Buffer } from 'node:buffer';
 import { sources } from 'webpack';
 import { LRUCache } from 'lru-cache';
+import { pluginOptions } from 'postcss-preset-env';
 
 interface HashMapValue {
     hash: string;
@@ -36,51 +37,164 @@ interface ICreateCacheReturnType {
     }>) => void | Promise<void>;
 }
 
-type ItemOrItemArray<T> = T | T[];
-
-type AppType = 'uni-app' | 'uni-app-vite' | 'taro' | 'remax' | 'rax' | 'native' | 'kbone' | 'mpx' | 'weapp-vite';
-interface InternalCssSelectorReplacerOptions {
-    mangleContext?: IMangleScopeContext;
-    escapeMap?: Record<string, string>;
-}
-interface JsHandlerResult {
-    code: string;
-    map?: SourceMap;
-    error?: ParseError;
-}
-type ICustomAttributes = Record<string, ItemOrItemArray<string | RegExp>> | Map<string | RegExp, ItemOrItemArray<string | RegExp>>;
-type ICustomAttributesEntities = [string | RegExp, ItemOrItemArray<string | RegExp>][];
-interface IJsHandlerOptions {
-    escapeMap?: Record<string, string>;
-    classNameSet?: Set<string>;
-    arbitraryValues?: IArbitraryValues;
-    mangleContext?: IMangleScopeContext;
-    jsPreserveClass?: (keyword: string) => boolean | undefined;
-    needEscaped?: boolean;
-    generateMap?: boolean;
-    alwaysEscape?: boolean;
+interface UserDefinedOptions {
+    /**
+     * @group 0.重要配置
+     * @description 是否禁用此插件，一般用于构建到多平台时使用，比如小程序时不传，非小程序环境(h5,app)传入一个 `true`
+     */
+    disabled?: boolean;
+    /**
+     * @group 0.重要配置
+     * @description **这是一个重要的配置!**
+  
+  它可以自定义`wxml`标签上的`attr`转化属性。默认转化所有的`class`和`hover-class`，这个`Map`的 `key`为匹配标签，`value`为属性字符串或者匹配正则数组。
+  
+  如果你想要增加，对于所有标签都生效的转化的属性，你可以添加 `*`: `(string | Regexp)[]` 这样的键值对。(`*` 是一个特殊值，代表所有标签)
+  
+  更复杂的情况，可以传一个 `Map<string | Regex, (string | Regex)[]>`实例。
+  
+  假如你要把 `className` 通过组件的`prop`传递给子组件，又或者想要自定义转化的标签属性时，需要用到此配置，案例详见：[issue#129](https://github.com/sonofmagic/weapp-tailwindcss/issues/129#issuecomment-1340914688),[issue#134](https://github.com/sonofmagic/weapp-tailwindcss/issues/134#issuecomment-1351288238)
+  
+  @example
+  
+  ```js
+  const customAttributes = {
+      // 匹配所有带 Class / class 相关的标签，比如某个组件上的 `a-class`, `testClass` , `custom-class` 里面的值
+      '*': [ /[A-Za-z]?[A-Za-z-]*[Cc]lass/ ],
+      // 额外匹配转化 `van-image` 标签上属性为 `custom-class` 的值
+      'van-image': ['custom-class'],
+      // 转化所有 `ice-button` 标签上属性为 `testClass` 的值
+      'ice-button': ['testClass']
+  }
+  ```
+  
+  当然你可以根据自己的需求，定义单个或者多个正则/字符串。
+  
+  甚至有可能你编写正则表达式，它们匹配的范围，直接包括了插件里自带默认的 `class`/`hover-class`，那么这种情况下，你完全可以取代插件的默认模板转化器，开启 [disabledDefaultTemplateHandler](/docs/api/interfaces/UserDefinedOptions#disableddefaulttemplatehandler) 配置项,禁用默认的模版匹配转化器。
+     */
+    customAttributes?: ICustomAttributes;
+    /**
+     * @group 0.重要配置
+     * @description 自定义转化class名称字典，这个配置项用来自定义转化`class`名称字典,你可以使用这个选项来简化生成的`class`
+  - 默认模式: 把小程序中不允许的字符串，转义为**相等长度**的代替字符串，这种情况不追求转化目标字符串的一比一绝对等价，即无法从生成结果，反推原先的`class`
+  
+  当然，你也可以自定义，传一个 `Record<string, string>` 类型，只需保证转化后 css 中的 `class` 选择器，不会和自己定义的 `class` 产生冲突即可，示例见[dic.ts](https://github.com/sonofmagic/weapp-core/blob/main/packages/escape/src/dic.ts)
+     * @default MappingChars2String
+     */
+    customReplaceDictionary?: Record<string, string>;
+    /**
+     * @version `^3.1.0`
+     * @group 0.重要配置
+     * @description 对解析 js 使用的 ast 工具，默认情况使用 `babel`，可以通过安装 `@ast-grep/napi`，同时启用 `ast-grep` 配置项，来启用 `ast-grep` 来处理 `js`，速度会是 `babel` 的 `2` 倍左右
+     */
     jsAstTool?: 'babel' | 'ast-grep';
-    unescapeUnicode?: boolean;
-    babelParserOptions?: ParserOptions;
+    /**
+     * @version `^4.0.0`
+     * @group 0.重要配置
+     * @description js 忽略标签模板表达式中的标识符，这样使用标识符包裹的模板字符串不会被转义
+     * @default ['weappTwIgnore']
+     */
     ignoreTaggedTemplateExpressionIdentifiers?: (string | RegExp)[];
+    /**
+     * @version `^4.0.0`
+     * @group 0.重要配置
+     * @description js 忽略调用表达式中的标识符，这样使用这个方法，包裹的模板字符串和字符串字面量不会被转义，一般用来配合 `@weapp-tailwindcss/merge` 使用，比如设置为 `['twMerge', 'twJoin', 'cva']`
+     */
     ignoreCallExpressionIdentifiers?: (string | RegExp)[];
-}
-interface IArbitraryValues {
     /**
-     * 是否允许在类名里，使用双引号。
-     * 建议不要开启，因为有些框架，比如 `vue3` 它针对有些静态模板会直接编译成 `html` 字符串，此时开启这个配置很有可能导致转义出错
-     *
-     * @example
-     * ```html
-     * <!-- 开启前默认只允许单引号 -->
-     * <view class="after:content-['对酒当歌，人生几何']"></view>
-     * <!-- 开启后 -->
-     * <view class="after:content-[\"对酒当歌，人生几何\"]"></view>
+     * @group 0.重要配置
+     * @issue https://github.com/sonofmagic/weapp-tailwindcss/issues/7
+     * @description 在所有 view节点添加的 css 预设，可根据情况自由的禁用原先的规则，或者添加新的规则。默认预置 `css` 同 `tailwindcss` 类似，详细用法如下:
+     * ```js
+     * // default 默认，这代表会添加给所有的 view / text 元素, 受到 cssPreflightRange 配置项影响 :
+      cssPreflight: {
+        'box-sizing': 'border-box',
+        'border-width': '0',
+        'border-style': 'solid',
+        'border-color': 'currentColor'
+      }
+      // result
+      // box-sizing: border-box;
+      // border-width: 0;
+      // border-style: solid;
+      // border-color: currentColor
+  
+      // case 禁用所有
+      cssPreflight: false
+      // result
+      // none
+  
+      // case 禁用单个属性
+      cssPreflight: {
+        'box-sizing': false
+      }
+      // border-width: 0;
+      // border-style: solid;
+      // border-color: currentColor
+  
+      // case 更改和添加单个属性
+      cssPreflight: {
+        'box-sizing': 'content-box',
+        'background': 'black'
+      }
+      // result
+      // box-sizing: content-box;
+      // border-width: 0;
+      // border-style: solid;
+      // border-color: currentColor;
+      // background: black
      * ```
+     */
+    cssPreflight?: CssPreflightOptions;
+    /**
+     * @group 0.重要配置
+     * @issue https://github.com/sonofmagic/weapp-tailwindcss/pull/62
+     * @description 全局`dom`选择器，只有在这个选择器作用范围内的`dom`会被注入 `cssPreflight` 的变量和默认样式。只对所有的 `view`,`text` 和伪元素生效，想要对所有的元素生效，可切换为 `'all'`,此时需要自行处理和客户端默认样式的冲突
+     */
+    cssPreflightRange?: 'all';
+    /**
+     * @group 0.重要配置
+     * @version `^2.6.0`
+     * @description  是否注入额外的 `tailwindcss css var scope` 区域，这个选项用于这样的场景
      *
-     * @default `false`
+     * 比如 `taro vue3` 使用 [NutUI](https://nutui.jd.com), 需要使用 `@tarojs/plugin-html`，而这个插件会启用 `postcss-html-transform` 从而移除所有带 `*` 选择器
+     *
+     * 这会导致 `tailwindcss css var scope` 区域被移除导致一些样式，比如渐变等等功能失效
+     *
+     * 这种场景下，启用这个选项会再次重新注入整个 `tailwindcss css var scope`
+     *
+     * @default false
      */
-    allowDoubleQuotes?: boolean;
+    injectAdditionalCssVarScope?: boolean;
+    /**
+     * @group 0.重要配置
+     * @description 用于处理 css 选择器的替换规则
+     */
+    cssSelectorReplacement?: {
+        /**
+         * @default `'page'` <br/>
+         * @description 把`css`中的全局选择器 **`:root`** 替换为指定值，默认替换为 `'page'`，设置为 `false` 时不进行替换
+         */
+        root?: string | string[] | false;
+        /**
+         * @issue https://github.com/sonofmagic/weapp-tailwindcss/issues/81 <br/>
+         * @default `['view','text']` <br/>
+         * @description 把`css`中的全局选择器 **`*`** 替换为指定值，默认替换为 `'view','text'`，设置为 `false` 时不进行替换，此时小程序会由于不认识`*`选择器而报错
+         */
+        universal?: string | string[] | false;
+    };
+    /**
+     * @version `^3.0.0`
+     * @group 0.重要配置
+     * @description rem 转 rpx 配置，默认为 `undefined` 不开启，可传入 `true` 启用默认配置项，也可传入自定义配置项，配置项列表见 [postcss-rem-to-responsive-pixel](https://www.npmjs.com/package/postcss-rem-to-responsive-pixel)
+     */
+    rem2rpx?: boolean | UserDefinedOptions;
+    /**
+     * @version `^4.0.0`
+     * @group 0.重要配置
+     * @description postcss-preset-env 的入参数
+     */
+    cssPresetEnv?: pluginOptions;
 }
 interface UserDefinedOptions {
     /**
@@ -105,10 +219,37 @@ interface UserDefinedOptions {
      */
     mainCssChunkMatcher?: (name: string, appType?: AppType) => boolean;
     /**
-     * @group 0.重要配置
-     * @description 是否禁用此插件，一般用于构建到多平台时使用，比如小程序时不传，非小程序环境(h5,app)传入一个 `true`
+     * @group 1.文件匹配
+     * @experiment 实验性质，有可能会改变
+     * @description 各个平台 `wxs` 文件的匹配方法,可以设置为包括微信的 .wxs,支付宝的 .sjs 和 百度小程序的 .filter.js
+     * > tip: 记得在 `tailwind.config.js` 中，把 `wxs` 这个格式加入 `content` 配置项，不然不会生效
+     * @default ()=>false
      */
-    disabled?: boolean;
+    wxsMatcher?: (name: string) => boolean;
+    /**
+     * @group 1.文件匹配
+     * @experiment 实验性质，有可能会改变
+     * @description 是否转义 `wxml` 中内联的 `wxs`
+     * > tip: 记得在 `tailwind.config.js` 中，把 `wxs` 这个格式加入 `content` 配置项，不然不会生效
+     * @example
+     * ```html
+     * <!-- index.wxml -->
+     * <wxs module="inline">
+  // 我是内联wxs
+  // 下方的类名会被转义
+    var className = "after:content-['我是className']"
+    module.exports = {
+      className: className
+    }
+  </wxs>
+  <wxs src="./index.wxs" module="outside"/>
+  <view><view class="{{inline.className}}"></view><view class="{{outside.className}}"></view></view>
+     * ```
+     * @default false
+     */
+    inlineWxs?: boolean;
+}
+interface UserDefinedOptions {
     /**
      * @group 2.生命周期
      * @description plugin apply 初调用
@@ -132,45 +273,8 @@ interface UserDefinedOptions {
      * @description 结束处理时调用
      */
     onEnd?: () => void;
-    /**
-     * @group 0.重要配置
-     * @description **这是一个重要的配置!**
-  
-  它可以自定义`wxml`标签上的`attr`转化属性。默认转化所有的`class`和`hover-class`，这个`Map`的 `key`为匹配标签，`value`为属性字符串或者匹配正则数组。
-  
-  如果你想要增加，对于所有标签都生效的转化的属性，你可以添加 `*`: `(string | Regexp)[]` 这样的键值对。(`*` 是一个特殊值，代表所有标签)
-  
-  更复杂的情况，可以传一个 `Map<string | Regex, (string | Regex)[]>`实例。
-  
-  假如你要把 `className` 通过组件的`prop`传递给子组件，又或者想要自定义转化的标签属性时，需要用到此配置，案例详见：[issue#129](https://github.com/sonofmagic/weapp-tailwindcss/issues/129#issuecomment-1340914688),[issue#134](https://github.com/sonofmagic/weapp-tailwindcss/issues/134#issuecomment-1351288238)
-  
-  @example
-  
-  ```js
-  const customAttributes = {
-      // 匹配所有带 Class / class 相关的标签，比如某个组件上的 `a-class`, `testClass` , `custom-class` 里面的值
-      '*': [ /[A-Za-z]?[A-Za-z-]*[Cc]lass/ ],
-      // 额外匹配转化 `van-image` 标签上属性为 `custom-class` 的值
-      'van-image': ['custom-class'],
-      // 转化所有 `ice-button` 标签上属性为 `testClass` 的值
-      'ice-button': ['testClass']
-  }
-  ```
-  
-  当然你可以根据自己的需求，定义单个或者多个正则/字符串。
-  
-  甚至有可能你编写正则表达式，它们匹配的范围，直接包括了插件里自带默认的 `class`/`hover-class`，那么这种情况下，你完全可以取代插件的默认模板转化器，开启 [disabledDefaultTemplateHandler](/docs/api/interfaces/UserDefinedOptions#disableddefaulttemplatehandler) 配置项,禁用默认的模版匹配转化器。
-     */
-    customAttributes?: ICustomAttributes;
-    /**
-     * @group 0.重要配置
-     * @description 自定义转化class名称字典，这个配置项用来自定义转化`class`名称字典,你可以使用这个选项来简化生成的`class`
-  - 默认模式: 把小程序中不允许的字符串，转义为**相等长度**的代替字符串，这种情况不追求转化目标字符串的一比一绝对等价，即无法从生成结果，反推原先的`class`
-  
-  当然，你也可以自定义，传一个 `Record<string, string>` 类型，只需保证转化后 css 中的 `class` 选择器，不会和自己定义的 `class` 产生冲突即可，示例见[dic.ts](https://github.com/sonofmagic/weapp-core/blob/main/packages/escape/src/dic.ts)
-     * @default SimpleMappingChars2String
-     */
-    customReplaceDictionary?: Record<string, string>;
+}
+interface UserDefinedOptions {
     /**
      * @group 3.一般配置
      * @issue https://github.com/sonofmagic/weapp-tailwindcss/issues/110
@@ -202,36 +306,6 @@ interface UserDefinedOptions {
      * @description 针对 tailwindcss arbitrary values 的一些配置
      */
     arbitraryValues?: IArbitraryValues;
-    /**
-     * @group 1.文件匹配
-     * @experiment 实验性质，有可能会改变
-     * @description 各个平台 `wxs` 文件的匹配方法,可以设置为包括微信的 .wxs,支付宝的 .sjs 和 百度小程序的 .filter.js
-     * > tip: 记得在 `tailwind.config.js` 中，把 `wxs` 这个格式加入 `content` 配置项，不然不会生效
-     * @default ()=>false
-     */
-    wxsMatcher?: (name: string) => boolean;
-    /**
-     * @group 1.文件匹配
-     * @experiment 实验性质，有可能会改变
-     * @description 是否转义 `wxml` 中内联的 `wxs`
-     * > tip: 记得在 `tailwind.config.js` 中，把 `wxs` 这个格式加入 `content` 配置项，不然不会生效
-     * @example
-     * ```html
-     * <!-- index.wxml -->
-     * <wxs module="inline">
-  // 我是内联wxs
-  // 下方的类名会被转义
-    var className = "after:content-['我是className']"
-    module.exports = {
-      className: className
-    }
-  </wxs>
-  <wxs src="./index.wxs" module="outside"/>
-  <view><view class="{{inline.className}}"></view><view class="{{outside.className}}"></view></view>
-     * ```
-     * @default false
-     */
-    inlineWxs?: boolean;
     /**
      * @group 3.一般配置
      * @version `^2.6.1`
@@ -265,82 +339,12 @@ interface UserDefinedOptions {
      * @description 缓存策略
      */
     cache?: boolean | ICreateCacheReturnType;
-    /**
-     * @version `^3.1.0`
-     * @group 0.重要配置
-     * @description 对解析 js 使用的 ast 工具，默认情况使用 `babel`，可以通过安装 `@ast-grep/napi`，同时启用 `ast-grep` 配置项，来启用 `ast-grep` 来处理 `js`，速度会是 `babel` 的 `2` 倍左右
-     */
-    jsAstTool?: 'babel' | 'ast-grep';
     /**
      * @version `^3.2.0`
      * @group 3.一般配置
      * @description 对解析 js 使用的 `@babel/parser` 工具的配置
      */
     babelParserOptions?: ParserOptions;
-    /**
-     * @version `^4.0.0`
-     * @group 0.重要配置
-     * @description js 忽略标签模板表达式中的标识符，这样使用标识符包裹的模板字符串不会被转义
-     * @default ['weappTwIgnore']
-     */
-    ignoreTaggedTemplateExpressionIdentifiers?: (string | RegExp)[];
-    /**
-     * @version `^4.0.0`
-     * @group 0.重要配置
-     * @description js 忽略调用表达式中的标识符，这样使用这个方法，包裹的模板字符串和字符串字面量不会被转义，一般用来配合 `@weapp-tailwindcss/merge` 使用，比如设置为 `['twMerge', 'twJoin', 'cva']`
-     */
-    ignoreCallExpressionIdentifiers?: (string | RegExp)[];
-    /**
-     * @group 0.重要配置
-     * @issue https://github.com/sonofmagic/weapp-tailwindcss/issues/7
-     * @description 在所有 view节点添加的 css 预设，可根据情况自由的禁用原先的规则，或者添加新的规则。默认预置 `css` 同 `tailwindcss` 类似，详细用法如下:
-     * ```js
-     * // default 默认，这代表会添加给所有的 view / text 元素, 受到 cssPreflightRange 配置项影响 :
-      cssPreflight: {
-        'box-sizing': 'border-box',
-        'border-width': '0',
-        'border-style': 'solid',
-        'border-color': 'currentColor'
-      }
-      // result
-      // box-sizing: border-box;
-      // border-width: 0;
-      // border-style: solid;
-      // border-color: currentColor
-  
-      // case 禁用所有
-      cssPreflight: false
-      // result
-      // none
-  
-      // case 禁用单个属性
-      cssPreflight: {
-        'box-sizing': false
-      }
-      // border-width: 0;
-      // border-style: solid;
-      // border-color: currentColor
-  
-      // case 更改和添加单个属性
-      cssPreflight: {
-        'box-sizing': 'content-box',
-        'background': 'black'
-      }
-      // result
-      // box-sizing: content-box;
-      // border-width: 0;
-      // border-style: solid;
-      // border-color: currentColor;
-      // background: black
-     * ```
-     */
-    cssPreflight?: CssPreflightOptions;
-    /**
-     * @group 0.重要配置
-     * @issue https://github.com/sonofmagic/weapp-tailwindcss/pull/62
-     * @description 全局`dom`选择器，只有在这个选择器作用范围内的`dom`会被注入 `cssPreflight` 的变量和默认样式。只对所有的 `view`,`text` 和伪元素生效，想要对所有的元素生效，可切换为 `'all'`,此时需要自行处理和客户端默认样式的冲突
-     */
-    cssPreflightRange?: 'all';
     /**
      * @group 3.一般配置
      * @description 用于控制 tailwindcss 子组合器的生效标签范围, 这里我们用一个例子来说明这个配置是干啥用的.
@@ -370,43 +374,6 @@ interface UserDefinedOptions {
      * @default 'view + view'
      */
     cssChildCombinatorReplaceValue?: string | string[];
-    /**
-     * @group 0.重要配置
-     * @version `^2.6.0`
-     * @description  是否注入额外的 `tailwindcss css var scope` 区域，这个选项用于这样的场景
-     *
-     * 比如 `taro vue3` 使用 [NutUI](https://nutui.jd.com), 需要使用 `@tarojs/plugin-html`，而这个插件会启用 `postcss-html-transform` 从而移除所有带 `*` 选择器
-     *
-     * 这会导致 `tailwindcss css var scope` 区域被移除导致一些样式，比如渐变等等功能失效
-     *
-     * 这种场景下，启用这个选项会再次重新注入整个 `tailwindcss css var scope`
-     *
-     * @default false
-     */
-    injectAdditionalCssVarScope?: boolean;
-    /**
-     * @group 0.重要配置
-     * @description 用于处理 css 选择器的替换规则
-     */
-    cssSelectorReplacement?: {
-        /**
-         * @default `'page'` <br/>
-         * @description 把`css`中的全局选择器 **`:root`** 替换为指定值，默认替换为 `'page'`，设置为 `false` 时不进行替换
-         */
-        root?: string | string[] | false;
-        /**
-         * @issue https://github.com/sonofmagic/weapp-tailwindcss/issues/81 <br/>
-         * @default `['view','text']` <br/>
-         * @description 把`css`中的全局选择器 **`*`** 替换为指定值，默认替换为 `'view','text'`，设置为 `false` 时不进行替换，此时小程序会由于不认识`*`选择器而报错
-         */
-        universal?: string | string[] | false;
-    };
-    /**
-     * @version `^3.0.0`
-     * @group 0.重要配置
-     * @description rem 转 rpx 配置，默认为 `undefined` 不开启，可传入 `true` 启用默认配置项，也可传入自定义配置项，配置项列表见 [postcss-rem-to-responsive-pixel](https://www.npmjs.com/package/postcss-rem-to-responsive-pixel)
-     */
-    rem2rpx?: boolean | UserDefinedOptions;
     /**
      * @version `^3.2.0`
      * @group 3.一般配置
@@ -427,6 +394,53 @@ interface UserDefinedOptions {
      */
     customRuleCallback?: CustomRuleCallback;
 }
+
+type ItemOrItemArray<T> = T | T[];
+
+type AppType = 'uni-app' | 'uni-app-vite' | 'taro' | 'remax' | 'rax' | 'native' | 'kbone' | 'mpx' | 'weapp-vite';
+interface InternalCssSelectorReplacerOptions {
+    mangleContext?: IMangleScopeContext;
+    escapeMap?: Record<string, string>;
+}
+interface JsHandlerResult {
+    code: string;
+    map?: SourceMap;
+    error?: ParseError;
+}
+type ICustomAttributes = Record<string, ItemOrItemArray<string | RegExp>> | Map<string | RegExp, ItemOrItemArray<string | RegExp>>;
+type ICustomAttributesEntities = [string | RegExp, ItemOrItemArray<string | RegExp>][];
+interface IJsHandlerOptions {
+    escapeMap?: Record<string, string>;
+    classNameSet?: Set<string>;
+    arbitraryValues?: IArbitraryValues;
+    mangleContext?: IMangleScopeContext;
+    jsPreserveClass?: (keyword: string) => boolean | undefined;
+    needEscaped?: boolean;
+    generateMap?: boolean;
+    alwaysEscape?: boolean;
+    jsAstTool?: 'babel' | 'ast-grep';
+    unescapeUnicode?: boolean;
+    babelParserOptions?: ParserOptions;
+    ignoreTaggedTemplateExpressionIdentifiers?: (string | RegExp)[];
+    ignoreCallExpressionIdentifiers?: (string | RegExp)[];
+}
+interface IArbitraryValues {
+    /**
+     * 是否允许在类名里，使用双引号。
+     * 建议不要开启，因为有些框架，比如 `vue3` 它针对有些静态模板会直接编译成 `html` 字符串，此时开启这个配置很有可能导致转义出错
+     *
+     * @example
+     * ```html
+     * <!-- 开启前默认只允许单引号 -->
+     * <view class="after:content-['对酒当歌，人生几何']"></view>
+     * <!-- 开启后 -->
+     * <view class="after:content-[\"对酒当歌，人生几何\"]"></view>
+     * ```
+     *
+     * @default `false`
+     */
+    allowDoubleQuotes?: boolean;
+}
 interface JsHandler {
     (rawSource: string, set: Set<string>, options?: CreateJsHandlerOptions): JsHandlerResult | Promise<JsHandlerResult>;
     sync: (rawSource: string, set: Set<string>, options?: CreateJsHandlerOptions) => JsHandlerResult;