@tarojs/taro 3.8.0-canary.0 → 4.0.0-beta.0

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
@@ -97,7 +97,7 @@ declare module '../index' {
     }): void
 
     /** 小程序获取和 Taro 相关的 App 信息
-     * @supported weapp, alipay, jd, qq, swan, tt, h5
+     * @supported weapp, alipay, jd, qq, swan, tt, h5, harmony
      */
     getAppInfo(): getAppInfo.AppInfo
 
@@ -127,7 +127,13 @@ declare module '../index' {
     /** 小程序引用插件 JS 接口
      * @supported weapp, alipay, h5, rn, jd, qq, swan, tt, quickapp
      */
-    requirePlugin(pluginName: string): any
+    requirePlugin: {
+      (pluginName: string): any
+      /** @supported weapp */
+      (pluginName: string, success?: (mod: any) => any, error?: (e: { mod: any; errMsg: string }) => any): any;
+      /** @supported weapp */
+      async?: (pluginName: string) => Promise<any>
+    }
 
     /** 获取当前页面实例
      * @supported global

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

@@ -410,7 +410,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 创建一个动画实例 [animation](../Animation)。调用实例的方法来描述动画。最后通过动画实例的 export 方法导出动画数据传递给组件的 animation 属性。
-     * @supported weapp, h5, tt
+     * @supported weapp, tt, h5, harmony
      * @example
      * ```tsx
      * var animation = Taro.createAnimation({

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/ui/interaction.d.ts

@@ -160,7 +160,7 @@ declare module '../../index' {
      * **注意**
      * - Taro.showLoading 和 Taro.showToast 同时只能显示一个
      * - Taro.showToast 应与 Taro.hideToast 配对使用
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @example
      * ```tsx
      * Taro.showToast({
@@ -177,7 +177,7 @@ declare module '../../index' {
      * **注意**
      * - Android 6.7.2 以下版本，点击取消或蒙层时，回调 fail, errMsg 为 "fail cancel"；
      * - Android 6.7.2 及以上版本 和 iOS 点击蒙层不会关闭模态弹窗，所以尽量避免使用「取消」分支中实现业务逻辑
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @example
      * ```tsx
      * Taro.showModal({
@@ -220,7 +220,7 @@ declare module '../../index' {
      * **注意**
      * - Android 6.7.2 以下版本，点击取消或蒙层时，回调 fail, errMsg 为 "fail cancel"；
      * - Android 6.7.2 及以上版本 和 iOS 点击蒙层不会关闭模态弹窗，所以尽量避免使用「取消」分支中实现业务逻辑
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @example
      * ```tsx
      * Taro.showActionSheet({
@@ -238,7 +238,7 @@ declare module '../../index' {
     showActionSheet(option: showActionSheet.Option): Promise<showActionSheet.SuccessCallbackResult>
 
     /** 隐藏消息提示框
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/interaction/wx.hideToast.html
      */
     hideToast(option?: hideToast.Option): void

package/types/api/ui/navigation-bar.d.ts

@@ -79,13 +79,13 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 在当前页面显示导航条加载动画
-     * @supported weapp, rn, tt
+     * @supported weapp, rn, tt, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/navigation-bar/wx.showNavigationBarLoading.html
      */
     showNavigationBarLoading(option?: showNavigationBarLoading.Option): void
 
     /** 动态设置当前页面的标题
-     * @supported weapp, alipay, h5, rn, tt
+     * @supported weapp, alipay, tt, h5, rn, harmony
      * @example
      * ```tsx
      * Taro.setNavigationBarTitle({
@@ -97,7 +97,7 @@ declare module '../../index' {
     setNavigationBarTitle(option: setNavigationBarTitle.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 设置页面导航条颜色
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, tt, h5, rn, harmony
      * @h5 不支持 animation 参数
      * @rn 不支持 animation 参数
      * @example
@@ -116,13 +116,13 @@ declare module '../../index' {
     setNavigationBarColor(option: setNavigationBarColor.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 在当前页面隐藏导航条加载动画
-     * @supported weapp, rn, tt
+     * @supported weapp, rn, tt, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/navigation-bar/wx.hideNavigationBarLoading.html
      */
     hideNavigationBarLoading(option?: hideNavigationBarLoading.Option): void
 
     /** 隐藏返回首页按钮。微信7.0.7版本起，当用户打开的小程序最底层页面是非首页时，默认展示“返回首页”按钮，开发者可在页面 onShow 中调用 hideHomeButton 进行隐藏。
-     * @supported weapp, tt
+     * @supported weapp, tt, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/navigation-bar/wx.hideHomeButton.html
      */
     hideHomeButton(option?: hideHomeButton.Option): Promise<TaroGeneral.CallbackResult>

package/types/api/ui/pull-down-refresh.d.ts

@@ -25,7 +25,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 停止当前页面下拉刷新。
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @example
      * ```tsx
      * onPullDownRefresh: function (){
@@ -37,7 +37,7 @@ declare module '../../index' {
     stopPullDownRefresh(option?: stopPullDownRefresh.Option): void
 
     /** 开始下拉刷新。调用后触发下拉刷新动画，效果与用户手动下拉刷新一致。
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @rn 无动画效果
      * @example
      * ```tsx

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

@@ -99,7 +99,7 @@ declare module '../../index' {
      *  - 后代选择器：.the-ancestor .the-descendant
      *  - 跨自定义组件的后代选择器：.the-ancestor >>> .the-descendant
      *  - 多选择器的并集：#a-node, .some-other-nodes
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @example
      * ```tsx
      * Taro.pageScrollTo({

package/types/api/ui/tab-bar.d.ts

@@ -121,13 +121,13 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 显示 tabBar 某一项的右上角的红点
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/tab-bar/wx.showTabBarRedDot.html
      */
     showTabBarRedDot(option: showTabBarRedDot.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 显示 tabBar
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/tab-bar/wx.showTabBar.html
      */
     showTabBar(option?: showTabBar.Option): Promise<TaroGeneral.CallbackResult>
@@ -148,7 +148,7 @@ declare module '../../index' {
     setTabBarStyle(option?: setTabBarStyle.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 动态设置 tabBar 某一项的内容，`2.7.0` 起图片支持临时文件和网络文件。
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @example
      * ```tsx
      * Taro.setTabBarItem({
@@ -163,7 +163,7 @@ declare module '../../index' {
     setTabBarItem(option: setTabBarItem.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 为 tabBar 某一项的右上角添加文本
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @example
      * ```tsx
      * Taro.setTabBarBadge({
@@ -176,19 +176,19 @@ declare module '../../index' {
     setTabBarBadge(option: setTabBarBadge.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 移除 tabBar 某一项右上角的文本
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/tab-bar/wx.removeTabBarBadge.html
      */
     removeTabBarBadge(option: removeTabBarBadge.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 隐藏 tabBar 某一项的右上角的红点
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/tab-bar/wx.hideTabBarRedDot.html
      */
     hideTabBarRedDot(option: hideTabBarRedDot.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 隐藏 tabBar
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/tab-bar/wx.hideTabBar.html
      */
     hideTabBar(option?: hideTabBar.Option): Promise<TaroGeneral.CallbackResult>

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

@@ -484,7 +484,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 返回一个 SelectorQuery 对象实例。在自定义组件或包含自定义组件的页面中，应使用 `this.createSelectorQuery()` 来代替。
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony
      * @example
      * ```tsx
      * const query = Taro.createSelectorQuery()
@@ -500,10 +500,10 @@ declare module '../../index' {
     createSelectorQuery(): SelectorQuery
 
     /** 创建并返回一个 IntersectionObserver 对象实例。在自定义组件或包含自定义组件的页面中，应使用 `this.createIntersectionObserver([options])` 来代替。
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony
      * @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'
+export type CompilerTypes = CompilerWebpackTypes | 'vite'
+
+export type CompilerWebpackTypes = 'webpack5' | 'webpack4'
 
 interface IPrebundle {
   enable?: boolean
@@ -17,9 +19,10 @@ interface IPrebundle {
   }
 }
 
-interface ICompiler {
-  type: CompilerTypes
+interface ICompiler<T> {
+  type: T
   prebundle?: IPrebundle
+  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>
 }

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

@@ -0,0 +1,77 @@
+import type Chain from 'webpack-chain'
+import type { IOption, IPostcssOption, IUrlLoaderOption } from './util'
+
+export interface IHarmonyConfig<T extends CompilerTypes = CompilerWebpackTypes>  {
+  /** Harmony 项目地址 */
+  projectPath: string
+
+  /** hap 名
+   * @default "entry"
+   */
+  hapName?: string
+
+  /** 应用名称
+   * @default "default"
+   */
+  name?: string
+
+  /** 用于告诉 Taro 编译器需要抽取的公共文件 */
+  commonChunks?: string[] | ((commonChunks: string[]) => string[])
+
+  /** Harmony 编译过程的相关配置 */
+  compile?: {
+    exclude?: any[]
+    include?: any[]
+    filter?: (filename: string) => boolean
+  }
+
+  /** 用于控制是否生成 js、css 对应的 sourceMap (默认值：watch 模式下为 true，否则为 false) */
+  enableSourceMap?: boolean
+
+  /** 默认值：'cheap-module-source-map'， 具体参考[Webpack devtool 配置](https://webpack.js.org/configuration/devtool/#devtool) */
+  sourceMapType?: string
+
+  /** 指定 React 框架相关的代码是否使用开发环境（未压缩）代码，默认使用生产环境（压缩后）代码 */
+  debugReact?: boolean
+
+  /**
+   * 自定义 Webpack 配置
+   * @param chain  [webpackChain](https://github.com/neutrinojs/webpack-chain) 对象
+   * @param webpack webpack 实例
+   */
+  webpackChain?: (chain: Chain, webpack: typeof Webpack) => void
+
+  /** 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<'harmony'>
+
+  /** [css-loader](https://github.com/webpack-contrib/css-loader) 的附加配置 */
+  cssLoaderOption?: IOption
+
+  /** [sass-loader](https://github.com/webpack-contrib/sass-loader) 的附加配置 */
+  sassLoaderOption?: IOption
+
+  /** [less-loader](https://github.com/webpack-contrib/less-loader) 的附加配置 */
+  lessLoaderOption?: IOption
+
+  /** [stylus-loader](https://github.com/shama/stylus-loader) 的附加配置 */
+  stylusLoaderOption?: IOption
+
+  /** 针对 mp4 | webm | ogg | mp3 | wav | flac | aac 文件的 [url-loader](https://github.com/webpack-contrib/url-loader) 配置 */
+  mediaUrlLoaderOption?: IUrlLoaderOption
+
+  /** 针对 woff | woff2 | eot | ttf | otf 文件的 [url-loader](https://github.com/webpack-contrib/url-loader) 配置 */
+  fontUrlLoaderOption?: IUrlLoaderOption
+
+  /** 针对 png | jpg | jpeg | gif | bpm | svg 文件的 [url-loader](https://github.com/webpack-contrib/url-loader) 配置 */
+  imageUrlLoaderOption?: IUrlLoaderOption
+
+  /** [mini-css-extract-plugin](https://github.com/webpack-contrib/mini-css-extract-plugin) 的附加配置 */
+  miniCssExtractPluginOption?: IOption
+}

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

@@ -1,4 +1,5 @@
 export * from './h5'
+export * from './harmony'
 export * from './mini'
 
 export * from './manifest'

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

@@ -1,18 +1,38 @@
 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 { Compiler, CompilerTypes, CompilerWebpackTypes } from '../compiler'
 
 interface Runtime {
-  enableInnerHTML: boolean
-  enableSizeAPIs: boolean
-  enableAdjacentHTML: boolean
-  enableTemplateContent: boolean
-  enableCloneNode: boolean
-  enableContains: boolean
-  enableMutationObserver: boolean
+  enableInnerHTML?: boolean
+  enableSizeAPIs?: boolean
+  enableAdjacentHTML?: boolean
+  enableTemplateContent?: boolean
+  enableCloneNode?: boolean
+  enableContains?: boolean
+  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,10 +105,27 @@ export interface IMiniAppConfig {
 
   /** 小程序编译过程的相关配置 */
   compile?: {
-    exclude?: any[]
-    include?: any[]
+    exclude?: (string | RegExp)[]
+    include?: (string | RegExp)[]
+    filter?: (filename: string) => boolean
   }
 
   /** 插件内部使用 */
   runtime?: Runtime
+
+  /** 使用的编译工具。可选值：webpack4、webpack5、vite */
+  compiler?: Compiler<T>
+
+  /** 体验式功能 */
+  experimental?: {
+    /** 是否开启编译模式 */
+    compileMode?: boolean
+  }
+}
+
+export interface IMiniFilesConfig {
+  [configName: string]: {
+    content: any
+    path: string
+  }
 }

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

@@ -0,0 +1,34 @@
+import type { CustomPluginOptions, ResolvedId, ResolveIdResult } from 'rollup'
+
+interface IRollupPluginResolveIdOptions {
+  assertions?: Record<string, string>
+  custom?: CustomPluginOptions
+  isEntry?: boolean
+  skipSelf?: boolean
+}
+
+export type TRollupResolveMethod = (
+  source: string,
+  importer?: string,
+  options?: IRollupPluginResolveIdOptions
+) => Promise<ResolvedId | null>
+
+export interface ILoaderMeta {
+  importFrameworkStatement: string
+  importFrameworkName: string
+  creator: string
+  creatorLocation: string
+  extraImportForWeb: string
+  execBeforeCreateWebApp: string
+  frameworkArgs: string
+  isNeedRawLoader?: boolean
+  mockAppStatement: string
+  modifyConfig?: (config: Record<string, any>, source: string) => void
+  modifyResolveId?: (res: {
+    source?: string
+    importer?: string
+    options?: IRollupPluginResolveIdOptions
+    name?: string
+    resolve: TRollupResolveMethod
+  }) => Promise<ResolveIdResult> | ResolveIdResult
+}