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

package/types/api/media/camera.d.ts

@@ -90,15 +90,15 @@ declare module '../../index' {
        * @supported alipay
        */
       height: string
-       /** 视频文件的宽度。
+      /** 视频文件的宽度。
        * @supported alipay
        */
       width: string
-       /** 视频文件的尺寸。
+      /** 视频文件的尺寸。
        * @supported alipay
        */
       size: string
-       /** 录制的持续时间。
+      /** 录制的持续时间。
        * @supported alipay
        */
       duration: string
@@ -152,6 +152,8 @@ declare module '../../index' {
       normal
       /** 低质量 */
       low
+      /** 原图 */
+      original
     }
   }
 
@@ -192,6 +194,10 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 创建 camera 上下文 CameraContext 对象。
+     *
+     * ****
+     *
+     * 注：支付宝小程序需指定 camera 组件中的 id 属性
      * @supported weapp, rn, tt, alipay
      * @example
      * ```tsx

package/types/api/open-api/device-voip.d.ts

@@ -20,7 +20,7 @@ declare module '../../index' {
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
-      success?: (result: SuccessCallbackResult) => void
+      success?: (result: TaroGeneral.CallbackResult) => void
     }
   }
 
@@ -60,4 +60,4 @@ declare module '../../index' {
      */
     getDeviceVoIPList(option: getDeviceVoIPList.Option): Promise<getDeviceVoIPList.SuccessCallbackResult>
   }
-}
+}

package/types/api/open-api/login.d.ts

@@ -81,7 +81,7 @@ declare module '../../index' {
      *
      * 通过 Taro.login 接口获得的用户登录态拥有一定的时效性。用户越久未使用小程序，用户登录态越有可能失效。反之如果用户一直在使用小程序，则用户登录态一直保持有效。具体时效逻辑由微信维护，对开发者透明。开发者只需要调用 Taro.checkSession 接口检测当前用户登录态是否有效。
      *
-     * 登录态过期后开发者可以再调用 Taro.login 获取新的用户登录态。调用成功说明当前 session_key 未过期，调用失败说明 session_key 已过期。更多使用方法详见 [小程序登录](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html)。
+     * 登录态过期后开发者可以再调用 Taro.login 获取新的用户登录态。调用 Taro.checkSession 成功说明当前 session_key 未过期，调用失败说明 session_key 已过期。更多使用方法详见 [小程序登录](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html)。
      * @supported weapp
      * @example
      * ```tsx

package/types/api/open-api/my-miniprogram.d.ts

@@ -8,7 +8,7 @@ declare module '../../index' {
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
-      success?: (res: TaroGeneral.CallbackResult) => void
+      success?: (res: SuccessCallbackResult) => void
     }
 
     interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
@@ -23,6 +23,6 @@ declare module '../../index' {
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/my-miniprogram/wx.checkIsAddedToMyMiniProgram.html
      */
-    checkIsAddedToMyMiniProgram(option?: checkIsAddedToMyMiniProgram.Option):Promise<checkIsAddedToMyMiniProgram.SuccessCallbackResult>
+    checkIsAddedToMyMiniProgram(option?: checkIsAddedToMyMiniProgram.Option): void
   }
 }

package/types/api/open-api/privacy.d.ts

@@ -0,0 +1,99 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace getPrivacySetting {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 是否需要用户授权隐私协议（如果开发者没有在[mp后台-设置-服务内容声明-用户隐私保护指引]中声明隐私收集类型则会返回false；如果开发者声明了隐私收集，且用户之前同意过隐私协议则会返回false；如果开发者声明了隐私收集，且用户还没同意过则返回true；如果用户之前同意过、但后来小程序又新增了隐私收集类型也会返回true） */
+      needAuthorization: boolean
+      /** 隐私授权协议的名称 */
+      privacyContractName: string
+    }
+  }
+
+  namespace requirePrivacyAuthorize {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  namespace openPrivacyContract {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  namespace onNeedPrivacyAuthorization {
+    /**
+     * resolve 是 onNeedPrivacyAuthorization 的回调参数，是一个接口函数。
+     * 当触发 needPrivacyAuthorization 事件时，触发该事件的隐私接口或组件会处于 pending 状态。
+     * 如果调用 resolve({ buttonId: 'disagree-btn'， event:'agree' })，则触发当前 needPrivacyAuthorization 事件的原隐私接口或组件会继续执行。其中 buttonId 为隐私同意授权按钮的id，为确保用户有同意的操作，基础库会检查对应的同意按钮是否被点击过。
+     * 如果调用 resolve({ event: 'disagree' })，则触发当前 needPrivacyAuthorization 事件的原隐私接口或组件会失败并返回 API:fail privacy permission is not authorized 的错误信息。
+     * 在调用 resolve({ event: 'agree'/'disagree' }) 之前，开发者可以调用 resolve({ event: 'exposureAuthorization' }) 把隐私弹窗曝光告知平台。
+     */
+    interface ResolveOption {
+      /** 用户操作类型 */
+      event: 'exposureAuthorization' | 'agree' | 'disagree'
+      /** 同意授权按钮的id （仅event=agree时必填） */
+      buttonId?: string
+    }
+    /**
+     * 触发本次 onNeedPrivacyAuthorization 事件的关联信息
+     */
+    interface EventInfo {
+      referrer: string
+    }
+
+    /** 隐私授权监听函数 */
+    type Listener = (
+      /** 事件回调函数 */
+      resolve: (option: ResolveOption) => void,
+      /** 关联事件信息 */
+      eventInfo: EventInfo
+    ) => void
+  }
+
+  interface TaroStatic {
+    /**
+     * 查询隐私授权情况。隐私合规开发指南详情可见《小程序隐私协议开发指南》
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/privacy/wx.getPrivacySetting.html
+     */
+    getPrivacySetting(option?: getPrivacySetting.Option): void
+    /**
+     * 跳转至隐私协议页面。隐私合规开发指南详情可见《小程序隐私协议开发指南》
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/privacy/wx.openPrivacyContract.html
+     */
+    openPrivacyContract(option?: openPrivacyContract.Option): void
+    /**
+     * 模拟隐私接口调用，并触发隐私弹窗逻辑。隐私合规开发指南详情可见《小程序隐私协议开发指南》
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/privacy/wx.requirePrivacyAuthorize.html
+     */
+    requirePrivacyAuthorize(option?: requirePrivacyAuthorize.Option): void
+    /**
+     * 监听隐私接口需要用户授权事件。当需要用户进行隐私授权时会触发。触发该事件时，开发者需要弹出隐私协议说明，并在用户同意或拒绝授权后调用回调接口 resolve 触发原隐私接口或组件继续执行。隐私合规开发指南详情可见《小程序隐私协议开发指南》
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/privacy/wx.onNeedPrivacyAuthorization.html
+     */
+    onNeedPrivacyAuthorization(listener: onNeedPrivacyAuthorization.Listener): void
+  }
+}

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

@@ -196,6 +196,7 @@ declare module '../../index' {
 
     /** 关闭当前页面，返回上一页面或多级页面。可通过 getCurrentPages 获取当前的页面栈，决定需要返回几层。
      * @supported weapp, h5, rn, tt
+     * @h5 若入参 delta 大于现有页面数时，返回应用打开的第一个页面（如果想要返回首页请使用 reLaunch 方法）。
      * @example
      * ```tsx
      * // 注意：调用 navigateTo 跳转时，调用该方法的页面会被加入堆栈，而 redirectTo 方法则不会。见下方示例代码

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

@@ -0,0 +1,59 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  /**
+   * Snapshot 实例，可通过 SelectorQuery 获取。
+   *
+   * Snapshot 通过 id 跟一个 snapshot 组件绑定，操作对应的 snapshot 组件。
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/skyline/Snapshot.html
+   */
+  interface Snapshot {
+    /**
+     * 画布宽度
+     */
+    width: number
+    /**
+     * 画布高度
+     */
+    height: number
+    /**
+     * 对 snapshot 组件子树进行截图
+     * @param option
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/skyline/Snapshot.takeSnapshot.html
+     */
+    takeSnapshot(option: Snapshot.TakeSnapshot.Option): Promise<TaroGeneral.CallbackResult>
+  }
+
+  namespace Snapshot {
+    namespace TakeSnapshot {
+      interface Option {
+        /**
+         * 截图导出类型，'file' 保存到临时文件目录或 'arraybuffer' 返回图片二进制数据，默认值为 'file'
+         */
+        type: string
+        /**
+         * 截图文件格式，'rgba' 或 'png'，默认值为 'png'
+         */
+        format: string
+        /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+        complete?: (res: TaroGeneral.CallbackResult) => void
+        /** 接口调用失败的回调函数 */
+        fail?: (res: TaroGeneral.CallbackResult) => void
+        /** 接口调用成功的回调函数 */
+        success?: (res: SuccessCallbackResult) => void
+      }
+
+      interface SuccessCallbackResult {
+        /**
+         * 截图保存的临时文件路径，当 type 为 file 该字段生效
+         */
+        tempFilePath: string
+        /**
+         * 截图对应的二进制数据，当 type 为 arraybuffer 该字段生效
+         */
+        data: string
+      }
+    }
+  }
+}

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

@@ -26,7 +26,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 +40,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 +67,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
@@ -117,7 +117,7 @@ declare module '../../index' {
       method: string
       /** uri 匹配规则，可参考规则字符串写法和正则写法 */
       url: any
-      /** 
+      /**
        * 缓存有效时间，单位为 ms，不填则默认取缓存管理器全局的缓存有效时间
        * @default 7 * 24 * 60 * 60 * 1000
        */
@@ -189,10 +189,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/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/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 { 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,17 @@ 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
 }

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

@@ -1,6 +1,8 @@
 import type Webpack from 'webpack'
 import type Chain from 'webpack-chain'
-import type { IOption, IPostcssOption } from './util'
+import type { IOption, IPostcssOption, IUrlLoaderOption } from './util'
+import type { OutputOptions as RollupOutputOptions } from 'rollup'
+import type { CompilerTypes, CompilerWebpackTypes } from '../compiler'
 
 interface Runtime {
   enableInnerHTML: boolean
@@ -12,7 +14,25 @@ interface Runtime {
   enableMutationObserver: boolean
 }
 
-export interface IMiniAppConfig {
+interface OutputExt {
+  /**
+   * 编译前清空输出目录
+   * @since Taro v3.6.9
+   * @description
+   * - 默认清空输出目录，可设置 clean: false 不清空
+   * - 可设置 clean: { keep: ['project.config.json'] } 保留指定文件
+   * - 注意 clean.keep 不支持函数
+   */
+  clean?: boolean | {
+    /** 保留指定文件不删除 */
+    keep?: Array<string | RegExp> | string | RegExp
+  }
+}
+
+export interface IMiniAppConfig<T extends CompilerTypes = CompilerWebpackTypes> {
+  /** 用于控制是否生成 js、css 对应的 sourceMap (默认值：watch 模式下为 true，否则为 false) */
+  enableSourceMap?: boolean
+
   /** 默认值：'cheap-module-source-map'， 具体参考[Webpack devtool 配置](https://webpack.js.org/configuration/devtool/#devtool) */
   sourceMapType?: string
 
@@ -37,24 +57,15 @@ export interface IMiniAppConfig {
    */
   webpackChain?: (chain: Chain, webpack: typeof Webpack, PARSE_AST_TYPE: any) => void
 
-  /** 可用于修改、拓展 Webpack 的 [output](https://webpack.js.org/configuration/output/) 选项 */
-  output?: Webpack.Configuration['output'] & {
-    /**
-     * 编译前清空输出目录
-     * @since Taro v3.6.9
-     * @description
-     * - 默认清空输出目录，可设置 clean: false 不清空
-     * - 可设置 clean: { keep: ['project.config.json'] } 保留指定文件
-     * - 注意 clean.keep 不支持函数
-     */
-    clean?: boolean | {
-      /** 保留指定文件不删除 */
-      keep?: Array<string | RegExp> | string | RegExp
-    }
-  }
+  /** 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'>  & OutputExt
+    : Webpack.Configuration['output'] & OutputExt
 
   /** 配置 postcss 相关插件 */
-  postcss?: IPostcssOption
+  postcss?: IPostcssOption<'mini'>
 
   /** [css-loader](https://github.com/webpack-contrib/css-loader) 的附加配置 */
   cssLoaderOption?: IOption
@@ -69,13 +80,13 @@ export interface IMiniAppConfig {
   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
@@ -94,8 +105,9 @@ export interface IMiniAppConfig {
 
   /** 小程序编译过程的相关配置 */
   compile?: {
-    exclude?: any[]
-    include?: any[]
+    exclude?: (string | RegExp)[]
+    include?: (string | RegExp)[]
+    filter?: (filename: string) => boolean
   }
 
   /** 插件内部使用 */
@@ -104,7 +116,7 @@ export interface IMiniAppConfig {
 
 export interface IMiniFilesConfig {
   [configName: string]: {
-    content: Config
+    content: any
     path: string
   }
 }

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

@@ -1,7 +1,7 @@
 import type Webpack from 'webpack'
 import type Chain from 'webpack-chain'
 import { type Input } from 'postcss'
-import type { Compiler } from '../compiler'
+import type { Compiler, CompilerTypes, CompilerWebpackTypes } from '../compiler'
 import type { IModifyChainData } from '../hooks'
 import type { ICopyOptions, IOption, ISassOptions, TogglableOptions } from './util'
 import type { IH5Config } from './h5'
@@ -203,7 +203,7 @@ export interface IProjectBaseConfig {
 }
 
 /** 暴露出来给 config/index 使用的配置类型，参考 https://github.com/NervJS/taro-doctor/blob/main/assets/config_schema.json */
-export interface IProjectConfig {
+export interface IProjectConfig<T extends CompilerTypes = CompilerWebpackTypes> {
   /** 项目名称 */
   projectName?: string
 
@@ -295,20 +295,20 @@ export interface IProjectConfig {
   /** 使用的开发框架。可选值：react、preact、nerv、vue、vue3 */
   framework?: 'react' | 'preact' | 'nerv' | 'vue' | 'vue3'
 
-  /** 使用的编译工具。可选值：webpack4、webpack5 */
-  compiler?: Compiler
-
   /** Webpack5 持久化缓存配置。具体配置请参考 [WebpackConfig.cache](https://webpack.js.org/configuration/cache/#cache) */
   cache?: ICache
 
   /** 控制 Taro 编译日志的输出方式 */
   logger?: ILogger
 
-  /** 专属于小程序的配置 */
-  mini?: IMiniAppConfig
+  /** 使用的编译工具。可选值：webpack4、webpack5、vite */
+  compiler?: Compiler<T>
 
   /** 专属于 H5 的配置 */
-  h5?: IH5Config
+  h5?: IH5Config<T>
+
+  /** 专属于小程序的配置 */
+  mini?: IMiniAppConfig<T>
 
   /** 专属于 RN 的配置 */
   rn?: IRNConfig

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

@@ -1,4 +1,5 @@
-import { type Input } from 'postcss'
+import type { Input } from 'postcss'
+import type { Options as PostcssUrlOption } from 'postcss-url'
 
 export type Func = (...args: any[]) => any
 
@@ -9,6 +10,11 @@ export type TogglableOptions<T = IOption> = {
   config?: T
 }
 
+export interface IUrlLoaderOption extends IOption {
+  limit?: number | boolean
+  name?: ((moduleId: string) => string) | string
+}
+
 export namespace PostcssOption {
   export type cssModules = TogglableOptions<{
     /** 转换模式，取值为 global/module */
@@ -16,10 +22,7 @@ export namespace PostcssOption {
     /** 自定义生成的class名称规则 */
     generateScopedName: string | ((localName: string, absoluteFilePath: string) => string)
   }>
-  export type url = TogglableOptions<{
-    limit: number
-    basePath?: string | string[]
-  }>
+  export type url = TogglableOptions<PostcssUrlOption>
 }
 
 export interface IHtmlTransformOption {
@@ -72,24 +75,31 @@ export interface IPxTransformOption {
   designWidth?: number | ((size?: string | number | Input) => number)
   /** 设计稿尺寸换算规则 */
   deviceRatio?: TaroGeneral.TDeviceRatio
+  /** 平台 */
+  platform?: 'weapp' | 'h5' | string
+  /** filter 回调函数，可 exclude 不处理的文件 */
+  exclude?: (fileName: string) => boolean
 }
 
-export interface IPostcssOption {
+interface IBasePostcssOption {
   autoprefixer?: TogglableOptions
   pxtransform?: TogglableOptions<IPxTransformOption>
   cssModules?: PostcssOption.cssModules
-  url?: PostcssOption.url
   /** 插件 postcss-html-transform 相关配置, 一般启用了 @tarojs/plugin-html 插件才配置 */
   htmltransform?: IHtmlTransformOption
   [key: string]: any
 }
 
+export type IPostcssOption<T = 'h5' | 'mini'> = T extends 'h5'
+  ? IBasePostcssOption & { url?: PostcssOption.url }
+  : IBasePostcssOption
+
 export interface ICopyOptions {
   patterns: {
     from: string
     to: string
     ignore?: string[]
-    transform?: Function
+    transform?: Func
     watch?: boolean
   }[]
   options: {