@tarojs/taro 3.8.0-canary.0 → 4.0.0-alpha.2

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

@@ -18,12 +18,12 @@ declare module '../../index' {
    */
   interface IntersectionObserver {
     /** 停止监听。回调函数将不再触发
-     * @supported weapp, tt, h5
+     * @supported weapp, tt, h5, harmony_hybrid
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/IntersectionObserver.disconnect.html
      */
     disconnect(): void
     /** 指定目标节点并开始监听相交状态变化情况
-     * @supported weapp, tt, h5
+     * @supported weapp, tt, h5, harmony_hybrid
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/IntersectionObserver.observe.html
      */
     observe(
@@ -33,7 +33,7 @@ declare module '../../index' {
       callback: IntersectionObserver.ObserveCallback,
     ): void
     /** 使用选择器指定一个节点，作为参照区域之一。
-     * @supported weapp, tt, h5
+     * @supported weapp, tt, h5, harmony_hybrid
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/IntersectionObserver.relativeTo.html
      */
     relativeTo(
@@ -43,7 +43,7 @@ declare module '../../index' {
       margins?: IntersectionObserver.RelativeToMargins,
     ): IntersectionObserver
     /** 指定页面显示区域作为参照区域之一
-     * @supported weapp, tt, h5
+     * @supported weapp, tt, h5, harmony_hybrid
      * @example
      * 下面的示例代码中，如果目标节点（用选择器 .target-class 指定）进入显示区域以下 100px 时，就会触发回调函数。
      *
@@ -184,7 +184,7 @@ declare module '../../index' {
    */
   interface NodesRef {
     /** 添加节点的布局位置的查询请求。相对于显示区域，以像素为单位。其功能类似于 DOM 的 `getBoundingClientRect`。返回 `NodesRef` 对应的 `SelectorQuery`。
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony_hybrid
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('#the-id').boundingClientRect(function(rect){
@@ -220,7 +220,7 @@ declare module '../../index' {
       callback?: NodesRef.BoundingClientRectCallback,
     ): SelectorQuery
     /** 添加节点的 Context 对象查询请求。目前支持 [VideoContext](/docs/apis/media/video/VideoContext)、[CanvasContext](/docs/apis/canvas/CanvasContext)、[LivePlayerContext](/docs/apis/media/live/LivePlayerContext)、[EditorContext](/docs/apis/media/editor/EditorContext)和 [MapContext](/docs/apis/media/map/MapContext) 的获取。
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony_hybrid
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('.the-video-class').context(function (res) {
@@ -237,7 +237,7 @@ declare module '../../index' {
      *
      * **注意**
      * computedStyle 的优先级高于 size，当同时在 computedStyle 里指定了 width/height 和传入了 size: true，则优先返回 computedStyle 获取到的 width/height。
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony_hybrid
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('#the-id').fields({
@@ -269,7 +269,7 @@ declare module '../../index' {
       callback?: NodesRef.FieldsCallback,
     ): SelectorQuery
     /** 获取 Node 节点实例。目前支持 [Canvas](/docs/components/canvas) 的获取。
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony_hybrid
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('.canvas').node(function(res){
@@ -283,7 +283,7 @@ declare module '../../index' {
       callback?: NodesRef.NodeCallback,
     ): SelectorQuery
     /** 添加节点的滚动位置查询请求。以像素为单位。节点必须是 `scroll-view` 或者 `viewport`，返回 `NodesRef` 对应的 `SelectorQuery`。
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony_hybrid
      * @example
      * ```tsx
      * Taro.createSelectorQuery().selectViewport().scrollOffset(function(res){
@@ -384,7 +384,7 @@ declare module '../../index' {
    */
   interface SelectorQuery {
     /** 执行所有的请求。请求结果按请求次序构成数组，在callback的第一个参数中返回。
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony_hybrid
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.exec.html
      */
     exec(
@@ -392,7 +392,7 @@ declare module '../../index' {
       callback?: (...args: any[]) => any,
     ): NodesRef
     /** 将选择器的选取范围更改为自定义组件 `component` 内。（初始时，选择器仅选取页面范围的节点，不会选取任何自定义组件中的节点）。
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony_hybrid
      * @example
      * ```tsx
      * Component({
@@ -423,7 +423,7 @@ declare module '../../index' {
      * - 后代选择器：.the-ancestor .the-descendant
      * - 跨自定义组件的后代选择器：.the-ancestor >>> .the-descendant
      * - 多选择器的并集：#a-node, .some-other-nodes
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony_hybrid
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('#the-id').fields({
@@ -459,7 +459,7 @@ declare module '../../index' {
      * - 后代选择器：.the-ancestor .the-descendant
      * - 跨自定义组件的后代选择器：.the-ancestor >>> .the-descendant
      * - 多选择器的并集：#a-node, .some-other-nodes
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony_hybrid
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.selectAll.html
      */
     selectAll(
@@ -467,7 +467,7 @@ declare module '../../index' {
       selector: string,
     ): NodesRef
     /** 选择显示区域。可用于获取显示区域的尺寸、滚动位置等信息。
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony_hybrid
      * @example
      * ```tsx
      * Taro.createSelectorQuery().selectViewport().scrollOffset(function (res) {
@@ -484,7 +484,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 返回一个 SelectorQuery 对象实例。在自定义组件或包含自定义组件的页面中，应使用 `this.createSelectorQuery()` 来代替。
-     * @supported weapp, h5, tt
+     * @supported weapp, h5, tt, harmony, harmony_hybrid
      * @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, harmony_hybrid
      * @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
      */
@@ -515,7 +515,7 @@ declare module '../../index' {
     ): IntersectionObserver
 
     /** 创建并返回一个 MediaQueryObserver 对象实例。在自定义组件或包含自定义组件的页面中，应使用 `this.createMediaQueryObserver()` 来代替。
-     * @supported h5
+     * @supported h5, harmony_hybrid
      * @example
      * ```tsx
      * let createMediaQueryObserver
@@ -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,12 @@ interface IPrebundle {
   }
 }
 
-interface ICompiler {
-  type: CompilerTypes
+interface ICompiler<T> {
+  type: T
   prebundle?: IPrebundle
+  vitePlugins?: any
+  /** 错误处理级别。可选值：0、1 */
+  errorLevel?: number
 }
 
-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,82 @@
+import type Chain from 'webpack-chain'
+
+import type { IOption, IPostcssOption, IUrlLoaderOption } from './util'
+import type { Compiler, CompilerTypes, CompilerWebpackTypes } from '../compiler'
+
+export interface IHarmonyConfig<T extends CompilerTypes = CompilerWebpackTypes>  {
+  /** Harmony 编译方式 */
+  compiler?: Compiler
+
+  /** 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 | string
+  }
+}
+
+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
+}

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

@@ -1,12 +1,13 @@
 import type Webpack from 'webpack'
 import type Chain from 'webpack-chain'
-import { type Input } from 'postcss'
-import type { Compiler } from '../compiler'
+import type { Input } from 'postcss'
+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'
-import type { IMiniAppConfig } from './mini'
-import { IRNConfig } from './rn'
+import type { IHarmonyConfig } from './harmony'
+import type { IMiniAppConfig, IMiniFilesConfig } from './mini'
+import type { IRNConfig } from './rn'
 
 export type PluginItem<T = object> = string | [string, T] | [string, () => T | Promise<T>]
 
@@ -182,18 +183,28 @@ export interface IProjectBaseConfig {
   modifyWebpackChain?: (chain: Chain, webpack: typeof Webpack, data: IModifyChainData) => Promise<any>
 
   /**
-   * 修改编译过程中的页面组件配置
+   * 编译中修改 vite 配置
    */
-  modifyMiniConfigs?: (configMap: any) => Promise<any>
+  modifyViteConfig?: (viteConfig: any, data: IModifyChainData) => void
 
   /**
    * 修改编译后的结果
    */
   modifyBuildAssets?: (assets: any, miniPlugin?: any) => Promise<any>
+
+  /**
+   * 修改编译过程中的页面组件配置
+   */
+  modifyMiniConfigs?: (configMap: IMiniFilesConfig) => Promise<any>
+
+  /**
+   * 修改 Taro 编译配置
+   */
+  modifyRunnerOpts?: (opts: any) => Promise<any>
 }
 
 /** 暴露出来给 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
 
@@ -285,23 +296,25 @@ 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
 
+  harmony?: IHarmonyConfig<T>
+
   [key: string]: any
 }

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,35 @@ export interface IPxTransformOption {
   designWidth?: number | ((size?: string | number | Input) => number)
   /** 设计稿尺寸换算规则 */
   deviceRatio?: TaroGeneral.TDeviceRatio
+  /** 平台 */
+  platform?: 'weapp' | 'h5' | string
+  /** 启用的能力 Scope 默认为 ['platform', 'size'] */
+  methods?: 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' | 'harmony' | 'mini'> = T extends 'h5'
+  ? IBasePostcssOption & { url?: PostcssOption.url }
+  : IBasePostcssOption
+
+export type Config = ViteConfig | WebpackConfig
+
 export interface ICopyOptions {
   patterns: {
     from: string
     to: string
     ignore?: string[]
-    transform?: Function
+    transform?: Func
     watch?: boolean
   }[]
   options: {