@tarojs/taro 4.0.1 → 4.0.3-alpha.0

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

@@ -121,13 +121,13 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 显示 tabBar 某一项的右上角的红点
-     * @supported weapp, h5, rn, tt, harmony_hybrid
+     * @supported weapp, h5, rn, tt, harmony, harmony_hybrid
      * @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, harmony_hybrid
+     * @supported weapp, h5, rn, tt, harmony, harmony_hybrid
      * @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, harmony_hybrid
+     * @supported weapp, h5, rn, tt, harmony, harmony_hybrid
      * @example
      * ```tsx
      * Taro.setTabBarItem({
@@ -163,7 +163,7 @@ declare module '../../index' {
     setTabBarItem(option: setTabBarItem.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 为 tabBar 某一项的右上角添加文本
-     * @supported weapp, h5, rn, tt, harmony_hybrid
+     * @supported weapp, h5, rn, tt, harmony, harmony_hybrid
      * @example
      * ```tsx
      * Taro.setTabBarBadge({
@@ -176,19 +176,19 @@ declare module '../../index' {
     setTabBarBadge(option: setTabBarBadge.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 移除 tabBar 某一项右上角的文本
-     * @supported weapp, h5, rn, tt, harmony_hybrid
+     * @supported weapp, h5, rn, tt, harmony, harmony_hybrid
      * @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, harmony_hybrid
+     * @supported weapp, h5, rn, tt, harmony, harmony_hybrid
      * @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, harmony_hybrid
+     * @supported weapp, h5, rn, tt, harmony, harmony_hybrid
      * @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

@@ -66,19 +66,25 @@ declare module '../../index' {
   }
 
   namespace IntersectionObserver {
-    /** 监听相交状态变化的回调函数 */
+    /** 监听相交状态变化的回调函数
+     * @description Harmony 找不到对应元素时，回调会返回一个 Error 对象
+     */
     type ObserveCallback = (result: ObserveCallbackResult) => void
-    interface ObserveCallbackResult {
+    interface ObserveCallbackResult extends TaroGeneral.CallbackResult {
+      /** 错误信息，会在找不到对应元素时返回
+       * @supported harmony
+       */
+      errMsg?: string
       /** 目标边界 */
-      boundingClientRect: BoundingClientRectResult
+      boundingClientRect?: BoundingClientRectResult
       /** 相交比例 */
-      intersectionRatio: number
+      intersectionRatio?: number
       /** 相交区域的边界 */
-      intersectionRect: IntersectionRectResult
+      intersectionRect?: IntersectionRectResult
       /** 参照区域的边界 */
-      relativeRect: RelativeRectResult
+      relativeRect?: RelativeRectResult
       /** 相交检测时的时间戳 */
-      time: number
+      time?: number
     }
     /** 参照区域的边界 */
     interface RelativeRectResult {
@@ -484,7 +490,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 返回一个 SelectorQuery 对象实例。在自定义组件或包含自定义组件的页面中，应使用 `this.createSelectorQuery()` 来代替。
-     * @supported weapp, h5, tt, harmony_hybrid
+     * @supported weapp, h5, tt, harmony, harmony_hybrid
      * @example
      * ```tsx
      * const query = Taro.createSelectorQuery()
@@ -500,7 +506,7 @@ declare module '../../index' {
     createSelectorQuery(): SelectorQuery
 
     /** 创建并返回一个 IntersectionObserver 对象实例。在自定义组件或包含自定义组件的页面中，应使用 `this.createIntersectionObserver([options])` 来代替。
-     * @supported weapp, h5, tt, harmony_hybrid
+     * @supported weapp, h5, tt, harmony, harmony_hybrid
      * @example
      * ```tsx
      * const observer = Taro.createIntersectionObserver(this, { thresholds: [0], observeAll: true })

package/types/compile/compiler.d.ts

@@ -1,7 +1,11 @@
 import type { swc } from '@tarojs/helper'
 import type Webpack from 'webpack'
 
-type CompilerTypes = 'webpack4' | 'webpack5'
+export type CompilerViteTypes = 'vite'
+
+export type CompilerWebpackTypes = 'webpack5'
+
+export type CompilerTypes = CompilerWebpackTypes | CompilerViteTypes
 
 interface IPrebundle {
   enable?: boolean
@@ -17,11 +21,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,10 @@ 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'
+import type { OutputExt } from './project'
 
 export interface IH5RouterConfig {
   /** 配置路由模式 */
@@ -18,7 +21,7 @@ export interface IH5RouterConfig {
   enhanceAnimation?: boolean
 }
 
-export interface IH5Config {
+export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
   /** 设置输出解析文件的目录（默认值：'/'）*/
   publicPath?: string
 
@@ -37,8 +40,12 @@ 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'>  & OutputExt
+    : Webpack.Configuration['output']
 
   /** 路由相关的配置 */
   router?: IH5RouterConfig
@@ -84,13 +91,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
@@ -105,14 +112,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
+
+  /** 使用的编译工具。可选值：webpack5、vite */
+  compiler?: Compiler<T>
 }

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

@@ -0,0 +1,118 @@
+import type { OutputOptions as RollupOutputOptions } from 'rollup'
+import type Webpack from 'webpack'
+import type Chain from 'webpack-chain'
+
+import type { IOption, IPostcssOption, IUrlLoaderOption } from './util'
+import type { CompilerTypes, CompilerWebpackTypes } from '../compiler'
+import type { OutputExt } from './project'
+
+export interface IHarmonyRouterConfig {
+  /** 配置自定义路由 */
+  customRoutes?: IOption
+}
+
+export interface IHarmonyConfig<T extends CompilerTypes = 'vite'> {
+  /** Harmony 项目地址 */
+  projectPath: string
+
+  /** hap 名
+   * @default "entry"
+   */
+  hapName?: string
+
+  /** 应用名称
+   * @default "default"
+   */
+  name?: string
+
+  /** oh-package.json 配置 */
+  ohPackage?: {
+    dependencies?: { [name: string]: string }
+    devDependencies?: { [name: string]: string }
+    main?: string
+    [k: string]: any
+  }
+
+  /** ohpm-cli
+   * @default "~/Library/Huawei/ohpm/bin/ohpm"
+   */
+  ohpm?: string
+
+  /** 核心依赖前缀
+   * @description 用于告诉编译内容如何解析核心依赖，传入时将直接使用依赖前缀，同时不会为工程导入核心依赖
+   */
+  chorePackagePrefix?: string
+
+  /** 用于告诉 Taro 编译器需要抽取的公共文件 */
+  commonChunks?: string[] | ((commonChunks: string[]) => string[])
+
+  /** Harmony 编译过程的相关配置 */
+  compile?: {
+    exclude?: any[]
+    include?: any[]
+    filter?: (filename: string) => boolean
+  }
+
+  /** 用于配置半编译模式下的选项 */
+  compileModeSetting?: {
+    componentReplace?: {
+      [key: string]: {
+        current_init: string
+        dependency_define: string
+      }
+    }
+  }
+
+  /** 用于控制是否生成 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
+
+  /** 路由相关的配置 */
+  router?: IHarmonyRouterConfig
+
+  /** 配置 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 './rn'
 

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

@@ -1,6 +1,9 @@
 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'
+import type { OutputExt } from './project'
 
 interface Runtime {
   enableInnerHTML?: boolean
@@ -12,7 +15,7 @@ interface Runtime {
   enableMutationObserver?: boolean
 }
 
-export interface IMiniAppConfig {
+export interface IMiniAppConfig<T extends CompilerTypes = CompilerWebpackTypes> {
   /** 用于控制是否生成 js、css 对应的 sourceMap (默认值：watch 模式下为 true，否则为 false) */
   enableSourceMap?: boolean
 
@@ -40,24 +43,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
@@ -72,13 +66,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
@@ -97,16 +91,27 @@ export interface IMiniAppConfig {
 
   /** 小程序编译过程的相关配置 */
   compile?: {
-    exclude?: any[]
-    include?: any[]
+    exclude?: (string | RegExp)[]
+    include?: (string | RegExp)[]
+    filter?: (filename: string) => boolean
   }
 
   /** 插件内部使用 */
   runtime?: Runtime
 
+  /** 使用的编译工具。可选值：webpack5、vite */
+  compiler?: Compiler<T>
+
   /** 体验式功能 */
   experimental?: {
     /** 是否开启编译模式 */
-    compileMode?: boolean
+    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,13 +1,14 @@
 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 { AppConfig } from '../../index'
+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 { AppConfig } from '../..'
+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>]
 
@@ -115,7 +116,7 @@ export interface IProjectBaseConfig {
   jsMinimizer?: 'terser' | 'esbuild'
 
   /** 配置 CSS 压缩工具 (默认 csso) */
-  cssMinimizer?: 'csso' | 'esbuild' | 'parcelCss'
+  cssMinimizer?: 'csso' | 'esbuild' | 'lightningcss'
 
   /** 配置 csso 工具以压缩 CSS 代码 */
   csso?: TogglableOptions
@@ -139,11 +140,11 @@ export interface IProjectBaseConfig {
   /** 模板循环次数 */
   baseLevel?: number
 
-  /** 使用的开发框架。可选值：react、preact、nerv、vue、vue3 */
-  framework?: 'react' | 'preact' | 'nerv' | 'vue' | 'vue3'
+  /** 使用的开发框架。可选值：react、preact、vue3 */
+  framework?: 'react' | 'preact' | 'solid' | 'vue3'
   frameworkExts?: string[]
 
-  /** 使用的编译工具。可选值：webpack4、webpack5 */
+  /** 使用的编译工具。可选值：webpack5 */
   compiler?: Compiler
 
   /** Webpack5 持久化缓存配置。具体配置请参考 [WebpackConfig.cache](https://webpack.js.org/configuration/cache/#cache) */
@@ -185,18 +186,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
 
@@ -266,7 +277,7 @@ export interface IProjectConfig {
   jsMinimizer?: 'terser' | 'esbuild'
 
   /** 配置 CSS 压缩工具 (默认 csso) */
-  cssMinimizer?: 'csso' | 'esbuild' | 'parcelCss'
+  cssMinimizer?: 'csso' | 'esbuild' | 'lightningcss'
 
   /** 配置 csso 工具以压缩 CSS 代码 */
   csso?: TogglableOptions
@@ -285,11 +296,8 @@ export interface IProjectConfig {
   /** 一个 preset 是一系列 Taro 插件的集合，配置语法同 plugins */
   presets?: PluginItem[]
 
-  /** 使用的开发框架。可选值：react、preact、nerv、vue、vue3 */
-  framework?: 'react' | 'preact' | 'nerv' | 'vue' | 'vue3'
-
-  /** 使用的编译工具。可选值：webpack4、webpack5 */
-  compiler?: Compiler
+  /** 使用的开发框架。可选值：react、preact、solid、vue3、 none */
+  framework?: 'react' | 'preact' | 'solid' | 'vue3' | 'none'
 
   /** Webpack5 持久化缓存配置。具体配置请参考 [WebpackConfig.cache](https://webpack.js.org/configuration/cache/#cache) */
   cache?: ICache
@@ -297,14 +305,34 @@ export interface IProjectConfig {
   /** 控制 Taro 编译日志的输出方式 */
   logger?: ILogger
 
-  /** 专属于小程序的配置 */
-  mini?: IMiniAppConfig
+  /** 使用的编译工具。可选值：webpack5、vite */
+  compiler?: Compiler<T>
 
   /** 专属于 H5 的配置 */
-  h5?: IH5Config
+  h5?: IH5Config<T>
+
+  /** 专属于小程序的配置 */
+  mini?: IMiniAppConfig<T>
 
   /** 专属于 RN 的配置 */
   rn?: IRNConfig
 
+  harmony?: IHarmonyConfig<T>
+
   [key: string]: any
 }
+
+export 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
+  }
+}

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,18 +75,29 @@ 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