@tarojs/taro 3.7.0-beta.1 → 3.7.0-beta.4

package/types/api/storage/background-fetch.d.ts

@@ -25,6 +25,25 @@ declare module '../../index' {
       /** 接口调用成功的回调函数 */
       success?: (res: TaroGeneral.CallbackResult) => void
     }
+
+    type Callback = (
+      result: CallbackResult,
+    ) => void
+
+    interface CallbackResult {
+      /** 缓存数据类别，取值为 periodic 或 pre */
+      fetchType: string
+      /** 缓存数据 */
+      fetchedData: string
+      /** 客户端拿到缓存数据的时间戳 */
+      timeStamp: number
+      /** 小程序页面路径 */
+      path: string
+      /** 传给页面的 query 参数 */
+      query: string
+      /** 进入小程序的场景值 */
+      scene: number
+    }
   }
 
   namespace getBackgroundFetchToken {
@@ -34,46 +53,79 @@ declare module '../../index' {
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
-      success?: (res: TaroGeneral.CallbackResult) => void
+      success?: (res: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 自定义的登录态 */
+      token: string
+      /** 接口调用结果 */
+      errMsg: string
     }
   }
 
   namespace getBackgroundFetchData {
     interface Option {
-      /** 取值为 periodic */
+      /** 缓存数据类别
+       * @weapp 取值为 periodic
+       * @qq 取值为 periodic
+       * @alipay 取值为 pre: 数据预拉取; jsapiPre: API 预调用（目前仅支持地理位置预拉取）
+       */
       fetchType: string
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
-      success?: (res: TaroGeneral.CallbackResult) => void
+      success?: (res: SuccessCallbackResult) => void
+    }
+
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 缓存数据
+       *  @alipay Object
+       */
+      fetchedData: string | Object
+      /** 客户端拿到缓存数据的时间戳 ms。(iOS 时间戳存在异常，8.0.27 修复) */
+      timeStamp: number
+      /** 小程序页面路径 */
+      path: string
+      /** 传给页面的 query 参数 */
+      query: string
+      /** 进入小程序的场景值 */
+      scene: number
+      /** 缓存数据类型，与入参 fetchType 一致
+       * @supported alipay
+       */
+      fetchType?: string
+      /** 缓存数据的时间戳。单位：ms。
+       * @supported alipay
+       */
+      timestamp?: number
     }
   }
 
   interface TaroStatic {
     /** 设置自定义登录态，在周期性拉取数据时带上，便于第三方服务器验证请求合法性
-     * @supported weapp
+     * @supported weapp, qq
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/background-fetch/wx.setBackgroundFetchToken.html
      */
-    setBackgroundFetchToken(option: setBackgroundFetchToken.Option): void
+    setBackgroundFetchToken(option: setBackgroundFetchToken.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 收到 backgroundFetch 数据时的回调
-     * @supported weapp
+     * @supported weapp, qq
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/background-fetch/wx.onBackgroundFetchData.html
      */
-    onBackgroundFetchData(option?: onBackgroundFetchData.Option): void
+    onBackgroundFetchData(option?: onBackgroundFetchData.Option | onBackgroundFetchData.Callback): void
 
     /** 获取设置过的自定义登录态。若无，则返回 fail。
-     * @supported weapp
+     * @supported weapp, qq
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/background-fetch/wx.getBackgroundFetchToken.html
      */
-    getBackgroundFetchToken(option?: getBackgroundFetchToken.Option): void
+    getBackgroundFetchToken(option?: getBackgroundFetchToken.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 拉取 backgroundFetch 客户端缓存数据
-     * @supported weapp
+     * @supported weapp, alipay, qq
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/background-fetch/wx.getBackgroundFetchData.html
      */
-    getBackgroundFetchData(option: getBackgroundFetchData.Option): void
+    getBackgroundFetchData(option: getBackgroundFetchData.Option): Promise<getBackgroundFetchData.SuccessCallbackResult>
   }
 }

package/types/api/storage/cache-manager.d.ts

@@ -2,8 +2,42 @@ import Taro from '../../index'
 
 declare module '../../index' {
   interface CacheManager {
+    /** 当前缓存模式 */
+    mode: keyof CacheManager.Mode
+    /** 全局 origin */
+    origin: string
+    /** 全局缓存有效时间 */
+    maxAge: number
+    /** 当前缓存管理器状态 */
+    state: keyof CacheManager.State
     /** 添加规则
      * @supported weapp
+     * @example
+     * ```tsx
+     * const ruleId = cacheManager.addRule({
+     *   id: 'haha-rule',
+     *   method: 'GET',
+     *   url: '/haha',
+     *   maxAge: 123455,
+     *   dataSchema: [
+     *     // data 字段的匹配，默认为空，表示不匹配
+     *     // 类型可以是：string、number、boolean、null、object、any（表示任意类型均可），以及这些类型的数组表示方式
+     *     {name: 'aaa', schema: {type: 'string'}}, // 类型为 string
+     *     {name: 'bbb', schema: [{type: 'number'}, {type: 'string'}]}, // 类型为 number, string
+     *     {name: 'ccc', schema: {type: 'string', value: 'abc'}}, // 值为 abc
+     *     {name: 'ddd', schema: {type: 'string', value: /(abc|cba)/ig}}, // 值符合该正则匹配，如果该值不是字符串类型，则会被尝试转成字符串后再进行比较
+     *     {name: 'ddd', schema: {type: 'string', value: val => val === '123'}}, // 传入函数来校验值
+     *     {name: 'eee', schema: {type: 'object', value: [{ // 类型为对象，则通过嵌套的方式来逐层校验
+     *       name: 'aaa', schema: {type: 'string'},
+     *       // ...
+     *       // 嵌套 dataSchema，同上面的方式一样来匹配嵌套的对象
+     *     }]}},
+     *     {name: 'fff', schema: {type: 'string[]'}}, // 类型为 string 数组
+     *     {name: 'ggg', schema: {type: 'any'}}, // 类型为任意类型
+     *     {name: 'hhh', schema: {type: 'any[]'}}, // 类型为任意类型的数组
+     *   ]
+     * })
+     * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.addRule.html
      */
     addRule(option: CacheManager.AddRuleOption): string
@@ -26,7 +60,7 @@ declare module '../../index' {
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.deleteCache.html
      */
-    deleteCache( 
+    deleteCache(
       /** 缓存 id */
       id: string
     ): void
@@ -40,7 +74,7 @@ declare module '../../index' {
     ): void
     /** 删除规则，同时会删除对应规则下所有缓存
      * @supported weapp
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.deleteRule.html 
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.deleteRule.html
      */
     deleteRule(
       /** 规则 id */
@@ -67,17 +101,17 @@ declare module '../../index' {
       /** 事件名称 */
       eventName: string,
       /** 事件监听函数 */
-      handler: Function
+      handler: TaroGeneral.EventCallback
     ): void
     /** 监听事件
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.on.html
      */
-    on( 
+    on(
       /** 事件名称 */
       eventName: keyof CacheManager.OnEventName,
       /** 事件监听函数 */
-      handler: Function
+      handler: TaroGeneral.EventCallback
     ): void
     /** 开启缓存，仅在 mode 为 none 时生效，调用后缓存管理器的 state 会置为 1
      * @supported weapp
@@ -92,6 +126,22 @@ declare module '../../index' {
   }
 
   namespace CacheManager {
+    interface Mode {
+      /** 默认值，弱网/离线使用缓存返回 */
+      weakNetwork
+      /** 总是使用缓存返回 */
+      always
+      /** 不开启，后续可手动开启/停止使用缓存返回	*/
+      none
+    }
+    interface State {
+      /** 不使用缓存返回 */
+      0
+      /** 使用缓存返回 */
+      1
+      /** 未知 */
+      2
+    }
     interface DataSchema {
       /** 需要匹配的 data 对象的参数类型
        * string、number、boolean、null、object、any（表示任意类型），
@@ -117,7 +167,7 @@ declare module '../../index' {
       method: string
       /** uri 匹配规则，可参考规则字符串写法和正则写法 */
       url: any
-      /** 
+      /**
        * 缓存有效时间，单位为 ms，不填则默认取缓存管理器全局的缓存有效时间
        * @default 7 * 24 * 60 * 60 * 1000
        */
@@ -135,6 +185,7 @@ declare module '../../index' {
       rule: Rule
     }
     interface AddRulesOption {
+      /** 规则列表 */
       rules: Rule[]
     }
     interface MatchOption {
@@ -189,10 +240,10 @@ declare module '../../index' {
   }
 
   interface TaroStatic {
-    /** 拉起手机发送短信界面
-     * @supported weap
-     * @see declare module '../../index' 
+    /** 创建缓存管理器
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/wx.createCacheManager.html
      */
     createCacheManager(option: createCacheManager.Option): CacheManager
   }
-}
+}

package/types/api/storage/index.d.ts

@@ -49,6 +49,10 @@ declare module '../../index' {
       keys: string[]
       /** 限制的空间大小，单位 KB */
       limitSize: number
+      /** 是否执行成功
+       * @supported alipay
+       */
+      success?: boolean
     }
   }
 
@@ -102,9 +106,54 @@ declare module '../../index' {
     }
   }
 
+  namespace batchSetStorageSync {
+    interface Option {
+      /** [{ key, value }] */
+      kvList: kv[]
+    }
+    interface kv {
+      /** key 本地缓存中指定的 key */
+      key: string
+      /** data 需要存储的内容。只支持原生类型、Date、及能够通过JSON.stringify序列化的对象。*/
+      value: any
+    }
+  }
+
+  namespace batchSetStorage {
+    interface Option {
+      /** [{ key, value }] */
+      kvList: kv[]
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+    interface kv {
+      /** key 本地缓存中指定的 key */
+      key: string
+      /** data 需要存储的内容。只支持原生类型、Date、及能够通过JSON.stringify序列化的对象。*/
+      value: any
+    }
+  }
+
+  namespace batchGetStorage {
+    interface Option {
+      /** 本地缓存中指定的 keyList */
+      keyList: string[]
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+  }
+
   interface TaroStatic {
     /** Taro.setStorage 的同步版本
-     * @supported weapp, h5, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5
      * @example
      * ```tsx
      * Taro.setStorage({
@@ -128,7 +177,7 @@ declare module '../../index' {
     ): void
 
     /** 将数据存储在本地缓存中指定的 key 中。会覆盖掉原来该 key 对应的内容。除非用户主动删除或因存储空间原因被系统清理，否则数据都一直可用。单个 key 允许存储的最大数据长度为 1MB，所有数据存储上限为 10MB。
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
      * @example
      * ```tsx
      * Taro.setStorage({
@@ -155,7 +204,7 @@ declare module '../../index' {
     ): void
 
     /** Taro.removeStorage 的同步版本
-     * @supported weapp, h5, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5
      * @example
      * ```tsx
      * try {
@@ -172,7 +221,7 @@ declare module '../../index' {
     ): void
 
     /** 从本地缓存中移除指定 key
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
      * @example
      * ```tsx
      * Taro.removeStorage({
@@ -187,7 +236,7 @@ declare module '../../index' {
     removeStorage(option: removeStorage.Option): Promise<TaroGeneral.CallbackResult>
 
     /** Taro.getStorage 的同步版本
-     * @supported weapp, h5, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5
      * @example
      * ```tsx
      * try {
@@ -207,7 +256,7 @@ declare module '../../index' {
     ): T
 
     /** Taro.getStorageInfo 的同步版本
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
      * @example
      * ```tsx
      * try {
@@ -224,7 +273,7 @@ declare module '../../index' {
     getStorageInfoSync(): getStorageInfoSync.Option
 
     /** 异步获取当前storage的相关信息
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
      * @example
      * ```tsx
      * Taro.getStorageInfo({
@@ -240,7 +289,7 @@ declare module '../../index' {
     getStorageInfo(option?: getStorageInfo.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 从本地缓存中异步获取指定 key 的内容
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
      * @example
      * ```tsx
      * Taro.getStorage({
@@ -264,7 +313,7 @@ declare module '../../index' {
     ): void
 
     /** Taro.clearStorage 的同步版本
-     * @supported weapp, h5, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5
      * @example
      * ```tsx
      * try {
@@ -278,7 +327,7 @@ declare module '../../index' {
     clearStorageSync(): void
 
     /** 清理本地数据缓存
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
      * @example
      * ```tsx
      * Taro.clearStorage()
@@ -286,5 +335,71 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/wx.clearStorage.html
      */
     clearStorage(option?: clearStorage.Option): Promise<TaroGeneral.CallbackResult>
+
+    /** 将数据批量存储在本地缓存中指定的 key 中。
+     * 会覆盖掉原来该 key 对应的内容。除非用户主动删除或因存储空间原因被系统清理，否则数据都一直可用。
+     * 单个 key 允许存储的最大数据长度为 1MB，所有数据存储上限为 10MB。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * try {
+     *   Taro.batchSetStorageSync([{key: 'key', value: 'value'}])
+     * } catch (e) { }
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/wx.batchGetStorageSync.html
+     */
+    batchSetStorageSync(option: batchSetStorageSync.Option): void
+
+    /** 将数据批量存储在本地缓存中指定的 key 中。会覆盖掉原来该 key 对应的内容。
+     * 除非用户主动删除或因存储空间原因被系统清理，否则数据都一直可用。
+     * 单个 key 允许存储的最大数据长度为 1MB，所有数据存储上限为 10MB。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.batchGetStorage({
+     *   keyList: ['key']
+     *   success(res) {
+     *     console.log(res)
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/wx.batchGetStorage.html
+     */
+    batchSetStorage(option: batchSetStorage.Option): Promise<TaroGeneral.CallbackResult>
+
+    /** 从本地缓存中同步批量获取指定 key 的内容。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * try {
+     *   var valueList = Taro.batchGetStorageSync(['key'])
+     *   if (valueList) {
+     *     // Do something with return value
+     *   }
+     * } catch (e) {
+     *   // Do something when catch error
+     * }
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/wx.batchGetStorageSync.html
+     */
+    batchGetStorageSync<T = any>(
+      /** 本地缓存中指定的 key 数组 */
+      keyList: string[]
+    ): T[]
+
+    /** 从本地缓存中异步批量获取指定 key 的内容。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.batchGetStorage({
+     *   keyList: ['key'],
+     *   success(res) {
+     *     console.log(res)
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/wx.batchGetStorage.html
+     */
+    batchGetStorage(option: batchGetStorage.Option): Promise<TaroGeneral.CallbackResult>
   }
 }

package/types/api/taro.extend.d.ts

@@ -83,7 +83,7 @@ declare module '../index' {
     /** 尺寸转换
      * @supported global
      */
-    pxTransform(size: number, designWidth?: number): string
+    pxTransform(size: number): string
 
     /** 尺寸转换初始化
      * @supported global

package/types/api/ui/fonts.d.ts

@@ -54,13 +54,14 @@ declare module '../../index' {
     /** 动态加载网络字体。文件地址需为下载类型。iOS 仅支持 https 格式文件地址。
      *
      * 注意：
-     * 1. 字体文件返回的 contet-type 参考 [font](https://www.iana.org/assignments/media-types/media-types.xhtml#font)，格式不正确时会解析失败。
+     * 1. 字体文件返回的 context-type 参考 [font](https://www.iana.org/assignments/media-types/media-types.xhtml#font)，格式不正确时会解析失败。
      * 2. 字体链接必须是https（ios不支持http)
      * 3. 字体链接必须是同源下的，或开启了cors支持，小程序的域名是`servicewechat.com`
      * 4. canvas等原生组件不支持使用接口添加的字体
-     * 5. 工具里提示 Faild to load font可以忽略
-     * @supported weapp, h5
+     * 5. 工具里提示 Failed to load font 可以忽略
+     * @supported weapp, alipay, h5
      * @h5 不支持 global (默认全局加载)
+     * @alipay source 地址格式为 `url('https://...')`，而不是单纯 URL 地址
      * @example
      * ```tsx
      * Taro.loadFontFace({

package/types/api/wxml/index.d.ts

@@ -503,7 +503,7 @@ declare module '../../index' {
      * @supported weapp, h5, tt
      * @example
      * ```tsx
-     * const observer = Taro.createIntersectionObserver(this, { thresholds: [0], observeAll: true })
+     * const observer = Taro.createIntersectionObserver(this, { thresholds: [0], observeAll: true })
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/wx.createIntersectionObserver.html
      */
@@ -525,7 +525,7 @@ declare module '../../index' {
      * } else if (process.env.TARO_ENV === 'h5') {
      *    createMediaQueryObserver= Taro.createMediaQueryObserver
      * }
-     * const mediaQueryObserver = createMediaQueryObserver() 
+     * const mediaQueryObserver = createMediaQueryObserver()
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html#Media%20Query
      */

package/types/compile/compiler.d.ts

@@ -1,7 +1,9 @@
 import type { swc } from '@tarojs/helper'
 import type Webpack from 'webpack'
 
-type CompilerTypes = 'webpack4' | 'webpack5' | 'vite'
+export type CompilerTypes = CompilerWebpackTypes | 'vite'
+
+export type CompilerWebpackTypes = 'webpack5' | 'webpack4'
 
 interface IPrebundle {
   enable?: boolean
@@ -17,10 +19,10 @@ interface IPrebundle {
   }
 }
 
-interface ICompiler {
-  type: CompilerTypes
+interface ICompiler<T> {
+  type: T
   prebundle?: IPrebundle
-  vitePlugins?: any[]
+  vitePlugins?: any
 }
 
-export type Compiler = CompilerTypes | ICompiler
+export type Compiler<T extends CompilerTypes = CompilerWebpackTypes> = T | ICompiler<T>

package/types/compile/config/h5.d.ts

@@ -2,7 +2,9 @@ import type Webpack from 'webpack'
 import type Chain from 'webpack-chain'
 import type webpackDevServer from 'webpack-dev-server'
 import type HtmlWebpackPlugin from 'html-webpack-plugin'
-import type { IOption, IPostcssOption } from './util'
+import type { IOption, IPostcssOption, IUrlLoaderOption } from './util'
+import type { OutputOptions as RollupOutputOptions } from 'rollup'
+import type { Compiler, CompilerTypes, CompilerWebpackTypes } from '../compiler'
 
 export interface IH5RouterConfig {
   /** 配置路由模式 */
@@ -16,7 +18,7 @@ export interface IH5RouterConfig {
   forcePath?: string
 }
 
-export interface IH5Config {
+export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
   /** 设置输出解析文件的目录（默认值：'/'）*/
   publicPath?: string
 
@@ -35,8 +37,10 @@ export interface IH5Config {
    */
   webpackChain?: (chain: Chain, webpack: typeof Webpack) => void
 
-  /** 可用于修改、拓展 Webpack 的 output 选项，配置项参考[官方文档](https://webpack.js.org/configuration/output/) */
-  output?: Webpack.Configuration['output']
+  /** webpack 编译模式下，可用于修改、拓展 Webpack 的 output 选项，配置项参考[官方文档](https://webpack.js.org/configuration/output/)
+  * vite 编译模式下，用于修改、扩展 rollup 的 output，目前仅适配 chunkFileNames 和 assetFileNames 两个配置，修改其他配置请使用 vite 插件进行修改。配置想参考[官方文档](https://rollupjs.org/configuration-options/)
+  */
+  output?: T extends 'vite' ? Pick<RollupOutputOptions, 'chunkFileNames' | 'assetFileNames' > : Webpack.Configuration['output']
 
   /** 路由相关的配置 */
   router?: IH5RouterConfig
@@ -44,6 +48,9 @@ export interface IH5Config {
   /** 预览服务的配置，可以更改端口等参数。具体配置参考 [webpack-dev-server](https://webpack.js.org/configuration/dev-server) */
   devServer?: webpackDevServer.Configuration
 
+  /** 用于控制是否生成 js、css 对应的 sourceMap (默认值：watch 模式下为 true，否则为 false) */
+  enableSourceMap?: boolean
+
   /**  具体配置请参考 [Webpack devtool](https://webpack.js.org/configuration/devtool/#devtool) 配置 (默认值：'cheap-module-eval-source-map')*/
   sourceMapType?:
     | 'none'
@@ -79,13 +86,13 @@ export interface IH5Config {
   stylusLoaderOption?: IOption
 
   /** 针对 mp4 | webm | ogg | mp3 | wav | flac | aac 文件的 [url-loader](https://github.com/webpack-contrib/url-loader) 配置 */
-  mediaUrlLoaderOption?: IOption
+  mediaUrlLoaderOption?: IUrlLoaderOption
 
   /** 针对 woff | woff2 | eot | ttf | otf 文件的 [url-loader](https://github.com/webpack-contrib/url-loader) 配置 */
-  fontUrlLoaderOption?: IOption
+  fontUrlLoaderOption?: IUrlLoaderOption
 
   /** 针对 png | jpg | jpeg | gif | bpm | svg 文件的 [url-loader](https://github.com/webpack-contrib/url-loader) 配置 */
-  imageUrlLoaderOption?: IOption
+  imageUrlLoaderOption?: IUrlLoaderOption
 
   /** [mini-css-extract-plugin](https://github.com/webpack-contrib/mini-css-extract-plugin) 的附加配置 */
   miniCssExtractPluginOption?: IOption
@@ -100,14 +107,20 @@ export interface IH5Config {
   useDeprecatedAdapterComponent?: boolean
 
   /** 配置 postcss 相关插件 */
-  postcss?: IPostcssOption
+  postcss?: IPostcssOption<'h5'>
 
   /** html-webpack-plugin 的具体配置 */
   htmlPluginOption?: HtmlWebpackPlugin.Options
 
   /** Web 编译过程的相关配置 */
   compile?: {
-    exclude?: any[]
-    include?: any[]
+    exclude?: (string | RegExp)[]
+    include?: (string | RegExp)[]
+    filter?: (filename: string) => boolean
   }
+  /** 生成的代码是否要兼容旧版浏览器，值为 true 时，会去读取 package.json 的 browserslist 字段。只在 vite 编译模式下有效 */
+  legacy?: T extends 'vite' ? boolean : undefined
+  
+  /** 使用的编译工具。可选值：webpack4、webpack5、vite */
+  compiler?: Compiler<T>
 }