@tarojs/taro 4.0.0-canary.9 → 4.0.1-alpha.0

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@tarojs/taro",
-  "version": "4.0.0-canary.9",
+  "version": "4.0.1-alpha.0",
   "description": "Taro framework",
-  "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
+  "author": "O2Team",
+  "license": "MIT",
   "main": "index.js",
   "typings": "types/index.d.ts",
   "files": [
@@ -18,45 +19,60 @@
   "keywords": [
     "taro"
   ],
-  "author": "O2Team",
-  "license": "MIT",
+  "engines": {
+    "node": ">= 18"
+  },
   "dependencies": {
-    "@tarojs/api": "4.0.0-canary.9"
+    "@types/postcss-url": "^10.0.4",
+    "@tarojs/api": "4.0.1-alpha.0",
+    "@tarojs/runtime": "4.0.1-alpha.0"
   },
   "devDependencies": {
-    "@tarojs/helper": "4.0.0-canary.9",
-    "@tarojs/shared": "4.0.0-canary.9",
-    "@tarojs/runtime": "4.0.0-canary.9"
+    "@types/react": "^18.3.1",
+    "html-webpack-plugin": "^5.6.0",
+    "postcss": "^8.4.38",
+    "webpack": "5.91.0",
+    "webpack-chain": "^6.5.1",
+    "webpack-dev-server": "^4.15.2",
+    "rollup": "^3.29.4",
+    "@tarojs/helper": "4.0.1-alpha.0",
+    "@tarojs/shared": "4.0.1-alpha.0",
+    "@tarojs/components": "4.0.1-alpha.0"
   },
   "peerDependencies": {
-    "@tarojs/helper": "~4.0.0-canary.9",
-    "@tarojs/shared": "~4.0.0-canary.9",
-    "@tarojs/runtime": "~4.0.0-canary.9"
+    "@types/react": "^18",
+    "html-webpack-plugin": "^5",
+    "rollup": "^3",
+    "postcss": "^8",
+    "vue": "^3",
+    "webpack": "^5",
+    "webpack-chain": "^6",
+    "webpack-dev-server": "^4",
+    "@tarojs/components": "4.0.1-alpha.0",
+    "@tarojs/helper": "4.0.1-alpha.0",
+    "@tarojs/shared": "4.0.1-alpha.0"
   },
   "peerDependenciesMeta": {
     "@types/react": {
       "optional": true
     },
-    "@types/webpack": {
+    "html-webpack-plugin": {
       "optional": true
     },
-    "@types/webpack-dev-server": {
+    "rollup": {
       "optional": true
     },
-    "@types/postcss-url": {
+    "vue": {
       "optional": true
     },
-    "postcss": {
+    "webpack": {
       "optional": true
     },
-    "vue": {
+    "webpack-chain": {
       "optional": true
     },
-    "rollup": {
+    "webpack-dev-server": {
       "optional": true
     }
-  },
-  "scripts": {
-    "test": "echo \"Error: run tests from root\" && exit 1"
   }
 }

package/types/api/base/env.d.ts

@@ -9,7 +9,7 @@ declare module '../../index' {
     env: {
       [key: string]: string | undefined
       /** 框架 */
-      FRAMEWORK: 'react' | 'preact' | 'nerv' | 'vue' | 'vue3'
+      FRAMEWORK: 'react' | 'preact' | 'solid' | 'vue3'
       /** Taro 环境变量 */
       TARO_ENV: 'weapp' | 'h5' | 'rn' | 'swan' | 'alipay' | 'tt' | 'qq' | 'jd' | 'quickapp'
       /** 文件系统中的用户目录路径 (本地路径) */

package/types/api/base/performance.d.ts

@@ -191,7 +191,7 @@ declare module '../../index' {
       src: string
     }
     interface Option {
-      data: AssetsObjectType[]
+      data: AssetsObject[]
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */

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

@@ -800,6 +800,15 @@ declare module '../../index' {
     setPosition(...args: any[]): void
   }
 
+  namespace createInnerAudioContext {
+    interface Option {
+      /** 是否使用 WebAudio 作为底层音频驱动，默认关闭。对于短音频、播放频繁的音频建议开启此选项，开启后将获得更优的性能表现。由于开启此选项后也会带来一定的内存增长，因此对于长音频建议关闭此选项。
+       * @supported weapp
+       */
+      useWebAudioImplement: boolean
+    }
+  }
+
   interface TaroStatic {
     /** 结束播放语音。
      * **注意：1.6.0 版本开始，本接口不再维护。建议使用能力更强的 [Taro.createInnerAudioContext](./createInnerAudioContext) 接口**
@@ -979,7 +988,7 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.createInnerAudioContext.html
      */
-    createInnerAudioContext(): InnerAudioContext
+    createInnerAudioContext(option?: createInnerAudioContext.Option): InnerAudioContext
 
     /** 创建 audio 上下文 AudioContext 对象。
      * **注意：1.6.0 版本开始，本接口不再维护。建议使用能力更强的 [Taro.createInnerAudioContext](./createInnerAudioContext) 接口**

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

@@ -221,7 +221,7 @@ declare module '../../index' {
       /** 压缩后图片的宽度，单位为px，若不填写则默认以 compressedHeight 为准等比缩放。 */
       compressedWidth?: number
       /** 压缩后图片的高度，单位为px，若不填写则默认以 compressedWidth 为准等比缩放。 */
-      compressHeight?: number
+      compressedHeight?: number
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult) => void
     }
@@ -315,10 +315,10 @@ declare module '../../index' {
       '4:5'
       /** 宽高比为5比4 */
       '5:4'
-      /** 宽高比为6比19 */
-      '6:19'
-      /** 宽高比为19比6 */
-      '19:6'
+      /** 宽高比为9比16 */
+      '9:16'
+      /** 宽高比为16比9 */
+      '16:9'
     }
   }
 

package/types/api/network/request.d.ts

@@ -13,8 +13,8 @@ declare module '../../index' {
        */
       header?: TaroGeneral.IAnyObject
       /** 超时时间，单位为毫秒
-       * @default 2000
-       * @supported weapp, h5, tt, alipay
+       * @default 60000
+       * @supported weapp, h5, tt, alipay, rn
        */
       timeout?: number
       /** HTTP 请求方法
@@ -78,7 +78,7 @@ declare module '../../index' {
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: TaroGeneral.CallbackResult) => void
+      complete?: (res: Partial<SuccessCallbackResult> & TaroGeneral.CallbackResult) => void
       /** 设置是否使用 jsonp 方式获取数据
        * @default false
        * @supported h5

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

@@ -256,7 +256,7 @@ declare module '../../index' {
     ): T
 
     /** Taro.getStorageInfo 的同步版本
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony_hybrid
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, harmony_hybrid
      * @example
      * ```tsx
      * try {

package/types/api/{open-api → swan}/bookshelf.d.ts

@@ -43,7 +43,7 @@ declare module '../../index' {
       1
     }
   }
-  
+
   namespace deleteBookshelf {
     interface Option {
       /** 要删除的内容分类 */
@@ -115,13 +115,13 @@ declare module '../../index' {
       1
     }
   }
-  
+
   namespace updateBookshelfReadTime {
     interface Option {
       /** 添加的内容分类 */
       category: keyof Category | string
       /** 要更新内容的 id；注释：contentId 为内容 id，内容的唯一标识，自定义，最长 22 字符（不能含有空格、中文字符） */
-      contentIds: string[] 
+      contentIds: string[]
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
@@ -278,7 +278,7 @@ declare module '../../index' {
      * @see https://smartprogram.baidu.com/docs/develop/api/open/swan-queryBookshelf/
      */
     updateBookshelfReadTime(option: updateBookshelfReadTime.Option): void
-    
+
     /** 跳转到宿主书架
      * @supported swan
      * @swan （需宿主支持书架入口）
@@ -304,4 +304,4 @@ declare module '../../index' {
      */
     navigateToBookshelf(option: navigateToBookshelf.Option): void
   }
-}
+}

package/types/api/swan/pay.d.ts

@@ -1,4 +1,4 @@
-import { Interface } from 'readline'
+import { Interface } from 'node:readline'
 import Taro from '../../index'
 
 declare module '../../index'  {
@@ -117,12 +117,12 @@ declare module '../../index'  {
   }
 
   interface TaroStatic {
-    /** 
+    /**
      * 1）百度收银台，聚合了主流的百度钱包、微信、支付宝、网银等多种支付渠道，方便开发者一站式快速接入多种支付渠道，让百度用户能在智能小程序场景下，直接完成支付、交易闭环，提升用户支付体验的同时，提高智能小程序的订单转化率。
      * 2）上述支付渠道在 C 端收银台有两种展示方式，开发者可以选择其中一种实现。
      * 方式一：将支付渠道内嵌在小程序提单页面中，实现方式参考文档[inline-payment-panel内嵌支付组件](https://smartprogram.baidu.com/docs/develop/component/inline_payment_panel/)。
      * 方式二：在用户确认订单后，调起收银台半屏面板承载支付渠道，实现方式参考文档调起[百度收银台](https://smartprogram.baidu.com/docs/develop/function/tune_up_2.0/#%E7%99%BE%E5%BA%A6%E6%94%B6%E9%93%B6%E5%8F%B0%E6%8E%A5%E5%8F%A32-0-%E8%AF%B4%E6%98%8E)。
-     * 
+     *
      * Web 态说明：为了保证用户交易行为全流程闭环体验，在 Web 态下调用该方法会做打开百度 App 对应小程序页面的降级处理。
      * @supported swan
      * @see https://smartprogram.baidu.com/docs/develop/api/open/payment_swan-requestPolymerPayment/
@@ -136,4 +136,4 @@ declare module '../../index'  {
      */
     getOptimalPriceInfo(option: getOptimalPriceInfo.Option): void
   }
-}
+}

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

@@ -147,7 +147,7 @@ declare module '../index' {
     Current: getCurrentInstance.Current
 
     /** Vue3 插件，用于设置 `getApp()` 中的全局变量
-     * @supported weapp, alipay, h5, rn, jd, qq, swan, tt, quickapp
+     * @supported weapp, alipay, h5, rn, jd, qq, swan, tt, quickapp, harmony_hybrid
      * @example
      * ```js
      * // 使用插件

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

@@ -238,7 +238,7 @@ declare module '../../index' {
     showActionSheet(option: showActionSheet.Option): Promise<showActionSheet.SuccessCallbackResult>
 
     /** 隐藏消息提示框
-     * @supported weapp, h5, rn, tt, harmony, harmony_hybrid
+     * @supported weapp, h5, rn, tt, harmony_hybrid
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/interaction/wx.hideToast.html
      */
     hideToast(option?: hideToast.Option): void

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 {

package/types/compile/compiler.d.ts

@@ -1,9 +1,11 @@
 import type { swc } from '@tarojs/helper'
 import type Webpack from 'webpack'
 
-export type CompilerTypes = CompilerWebpackTypes | 'vite'
+export type CompilerViteTypes = 'vite'
 
-export type CompilerWebpackTypes = 'webpack5' | 'webpack4'
+export type CompilerWebpackTypes = 'webpack5'
+
+export type CompilerTypes = CompilerWebpackTypes | CompilerViteTypes
 
 interface IPrebundle {
   enable?: boolean

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

@@ -5,6 +5,7 @@ import type HtmlWebpackPlugin from 'html-webpack-plugin'
 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 {
   /** 配置路由模式 */
@@ -16,6 +17,8 @@ export interface IH5RouterConfig {
   lazyload?: boolean | ((pagename: string) => boolean)
   renamePagename?: (pagename: string) => string
   forcePath?: string
+  /** 加上这个参数，可以解决返回页面的时候白屏的问题，但是某些不支持 :has() 选择器的浏览器会有问题 */
+  enhanceAnimation?: boolean
 }
 
 export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
@@ -40,7 +43,9 @@ export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
   /** 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']
+  output?: T extends 'vite'
+    ? Pick<RollupOutputOptions, 'chunkFileNames' | 'assetFileNames'>  & OutputExt
+    : Webpack.Configuration['output']
 
   /** 路由相关的配置 */
   router?: IH5RouterConfig
@@ -100,7 +105,7 @@ export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
   /** 配置需要额外的经由 Taro 预设的 postcss 编译的模块 */
   esnextModules?: string[]
 
-  /** 用于控制在 H5 端是否使用兼容性组件库，详情请看 [React 兼容性组件库](https://taro-docs.jd.com/docs/next/h5#react-兼容性组件库)。(默认值：false) */
+  /** 用于控制在 H5 端是否使用兼容性组件库，详情请看 [React 兼容性组件库](https://taro-docs.jd.com/docs/h5#react-兼容性组件库)。(默认值：false) */
   useHtmlComponents?: boolean
 
   /** 用于控制在 H5 端是否使用旧版本适配器，旧版本采用全局注册组件，懒加载组件相关依赖；新版本适配器会自动注册相关组件，不再需要引入 @tarojs/components/loader 中的全局 defineCustomElements 方法。(默认值：false) */
@@ -120,7 +125,7 @@ export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
   }
   /** 生成的代码是否要兼容旧版浏览器，值为 true 时，会去读取 package.json 的 browserslist 字段。只在 vite 编译模式下有效 */
   legacy?: T extends 'vite' ? boolean : undefined
-  
-  /** 使用的编译工具。可选值：webpack4、webpack5、vite */
+
+  /** 使用的编译工具。可选值：webpack5、vite */
   compiler?: Compiler<T>
 }

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

@@ -1,12 +1,17 @@
+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 { Compiler, CompilerTypes, CompilerWebpackTypes } from '../compiler'
+import type { CompilerTypes, CompilerWebpackTypes } from '../compiler'
+import type { OutputExt } from './project'
 
-export interface IHarmonyConfig<T extends CompilerTypes = CompilerWebpackTypes>  {
-  /** Harmony 编译方式 */
-  compiler?: Compiler
+export interface IHarmonyRouterConfig {
+  /** 配置自定义路由 */
+  customRoutes?: IOption
+}
 
+export interface IHarmonyConfig<T extends CompilerTypes = 'vite'> {
   /** Harmony 项目地址 */
   projectPath: string
 
@@ -20,6 +25,24 @@ export interface IHarmonyConfig<T extends CompilerTypes = CompilerWebpackTypes>
    */
   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[])
 
@@ -30,6 +53,16 @@ export interface IHarmonyConfig<T extends CompilerTypes = CompilerWebpackTypes>
     filter?: (filename: string) => boolean
   }
 
+  /** 用于配置半编译模式下的选项 */
+  compileModeSetting?: {
+    componentReplace?: {
+      [key: string]: {
+        current_init: string
+        dependency_define: string
+      }
+    }
+  }
+
   /** 用于控制是否生成 js、css 对应的 sourceMap (默认值：watch 模式下为 true，否则为 false) */
   enableSourceMap?: boolean
 
@@ -47,12 +80,15 @@ export interface IHarmonyConfig<T extends CompilerTypes = CompilerWebpackTypes>
   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/)
-  */
+   * vite 编译模式下，用于修改、扩展 rollup 的 output，目前仅适配 chunkFileNames 和 assetFileNames 两个配置，修改其他配置请使用 vite 插件进行修改。配置想参考[官方文档](https://rollupjs.org/configuration-options/)
+   */
   output?: T extends 'vite'
-    ? Pick<RollupOutputOptions, 'chunkFileNames'>  & OutputExt
+    ? Pick<RollupOutputOptions, 'chunkFileNames'> & OutputExt
     : Webpack.Configuration['output'] & OutputExt
 
+  /** 路由相关的配置 */
+  router?: IHarmonyRouterConfig
+
   /** 配置 postcss 相关插件 */
   postcss?: IPostcssOption<'harmony'>
 

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

@@ -1,6 +1,7 @@
 export * from './h5'
 export * from './harmony'
 export * from './mini'
+export * from './rn'
 
 export * from './manifest'
 export * from './project'

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

@@ -3,6 +3,7 @@ import type Chain from 'webpack-chain'
 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
@@ -14,21 +15,6 @@ interface Runtime {
   enableMutationObserver?: boolean
 }
 
-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
@@ -113,7 +99,7 @@ export interface IMiniAppConfig<T extends CompilerTypes = CompilerWebpackTypes>
   /** 插件内部使用 */
   runtime?: Runtime
 
-  /** 使用的编译工具。可选值：webpack4、webpack5、vite */
+  /** 使用的编译工具。可选值：webpack5、vite */
   compiler?: Compiler<T>
 
   /** 体验式功能 */

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

@@ -1,6 +1,7 @@
 import type Webpack from 'webpack'
 import type Chain from 'webpack-chain'
 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'
@@ -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) */
@@ -177,6 +178,8 @@ export interface IProjectBaseConfig {
 
   onWebpackChainReady?: (webpackChain: Chain) => Promise<any>
 
+  modifyAppConfig?: (appConfig: AppConfig) => Promise<any>
+
   /**
    * 编译中修改 webpack 配置，在这个钩子中，你可以对 webpackChain 作出想要的调整，等同于配置 [`webpackChain`](./config-detail#miniwebpackchain)
    */
@@ -274,7 +277,7 @@ export interface IProjectConfig<T extends CompilerTypes = CompilerWebpackTypes>
   jsMinimizer?: 'terser' | 'esbuild'
 
   /** 配置 CSS 压缩工具 (默认 csso) */
-  cssMinimizer?: 'csso' | 'esbuild' | 'parcelCss'
+  cssMinimizer?: 'csso' | 'esbuild' | 'lightningcss'
 
   /** 配置 csso 工具以压缩 CSS 代码 */
   csso?: TogglableOptions
@@ -293,8 +296,8 @@ export interface IProjectConfig<T extends CompilerTypes = CompilerWebpackTypes>
   /** 一个 preset 是一系列 Taro 插件的集合，配置语法同 plugins */
   presets?: PluginItem[]
 
-  /** 使用的开发框架。可选值：react、preact、nerv、vue、vue3 */
-  framework?: 'react' | 'preact' | 'nerv' | 'vue' | 'vue3'
+  /** 使用的开发框架。可选值：react、preact、solid、vue3、 none */
+  framework?: 'react' | 'preact' | 'solid' | 'vue3' | 'none'
 
   /** Webpack5 持久化缓存配置。具体配置请参考 [WebpackConfig.cache](https://webpack.js.org/configuration/cache/#cache) */
   cache?: ICache
@@ -302,7 +305,7 @@ export interface IProjectConfig<T extends CompilerTypes = CompilerWebpackTypes>
   /** 控制 Taro 编译日志的输出方式 */
   logger?: ILogger
 
-  /** 使用的编译工具。可选值：webpack4、webpack5、vite */
+  /** 使用的编译工具。可选值：webpack5、vite */
   compiler?: Compiler<T>
 
   /** 专属于 H5 的配置 */
@@ -318,3 +321,18 @@ export interface IProjectConfig<T extends CompilerTypes = CompilerWebpackTypes>
 
   [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/rn.d.ts

@@ -2,6 +2,7 @@ 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 { RollupOptions } from 'rollup'
 import type { IOption, IPostcssOption } from './util'
 
 export interface IRNConfig {
@@ -20,7 +21,7 @@ export interface IRNConfig {
   /** [less](https://lesscss.org/usage/#less-options) 相关配置 */
   less?: IOption
 
-  /** [stylus](https://github.com/NervJS/taro/blob/next/packages/taro-rn-style-transformer/README.md#rnstylus) 相关配置 */
+  /** [stylus](https://github.com/NervJS/taro/blob/main/packages/taro-rn-style-transformer/README.md#rnstylus) 相关配置 */
   stylus?: IOption
 
   /** 配置 postcss 相关插件 */
@@ -61,4 +62,24 @@ export interface IRNConfig {
 
   /** 设计稿尺寸换算规则 */
   deviceRatio?: TaroGeneral.TDeviceRatio
+
+  /** 原生组件编译配置 */
+  nativeComponents?: {
+    /**
+     * 外部依赖
+     */
+    external?: Array<string | RegExp> | ((arr: Array<string | RegExp>) => Array<string | RegExp>)
+    /**
+     * 设置外部依赖，如果返回 string, 则将该值作为 external， 我们默认将 node_modules 路径下的文件设置为外部依赖
+     */
+    exteranlResolve?: (importee: string, importer: string) => string
+    /**
+     * 组件输出路径，默认值为 'dist'
+     */
+    output?: string
+    /**
+     * 修改 Rollup 打包配置
+     */
+    modifyRollupConfig?: (config: RollupOptions, innerPlugins: { taroResolver: typeof taroResolver, styleTransformer: typeof styleTransformer }) => RollupOptions
+  }
 }

package/types/compile/index.d.ts

@@ -1,3 +1,11 @@
 export { Current } from '@tarojs/runtime'
 
+export interface IFileType {
+  style: string
+  script: string
+  templ: string
+  config: string
+  xs?: string
+}
+
 export * from './config'

package/types/compile/viteCompilerContext.d.ts

@@ -1,9 +1,11 @@
 import type { RecursiveTemplate, UnRecursiveTemplate } from '@tarojs/shared/dist/template'
+
 import type { PluginContext } from 'rollup'
-import type { AppConfig, PageConfig } from '../index'
 import type { IMiniFilesConfig, IH5Config, IHarmonyConfig, IMiniAppConfig } from './config'
 import type { IProjectConfig } from './config/project'
 import type { IComponentConfig } from './hooks'
+import type { IFileType } from './index'
+import type { AppConfig, PageConfig } from '../index'
 
 export interface ViteNativeCompMeta {
   name: string
@@ -13,6 +15,7 @@ export interface ViteNativeCompMeta {
   isNative: true
   templatePath: string
   cssPath?: string
+  isPackage?: boolean
 }
 
 export interface ViteFileType {
@@ -41,7 +44,6 @@ export interface VitePageMeta {
   cssPath?: string
 }
 
-
 export interface ViteH5BuildConfig extends CommonBuildConfig, IH5Config<'vite'> {
   entryFileName?: string
   runtimePath?: string | string[]
@@ -53,6 +55,7 @@ export interface ViteHarmonyBuildConfig extends CommonBuildConfig, IHarmonyConfi
   useJSON5?: boolean
   blended?: boolean
   runtimePath?: string | string[]
+  isPure?: boolean
   taroComponentsPath: string
 }
 
@@ -132,10 +135,11 @@ export interface ViteHarmonyCompilerContext extends ViteCompilerContext<ViteHarm
   nativeExt: string[]
   fileType: ViteFileType
   commonChunks: string[]
+  extraComponents: string[]
   nativeComponents : Map<string, ViteNativeCompMeta>
   getCommonChunks: () => string[]
   modifyHarmonyConfig: (config: Partial<AppConfig>) => void
-  modifyHostPackageDep: (outDir: string, deps?: Record<string, string>, devDeps?: Record<string, string>) => void
+  modifyHostPackage: (deps?: Record<string, string>, devDeps?: Record<string, string>) => Exclude<IHarmonyConfig['ohPackage'], void>
   collectNativeComponents: (meta: ViteAppMeta | VitePageMeta | ViteNativeCompMeta) => void
   getScriptPath: (filePath: string) => string
   getStylePath: (filePath: string) => string

package/types/index.d.ts

@@ -3,53 +3,64 @@
  *
  * 目录结构
  * ├── api                                  小程序端能力 API
- * │   ├── ad
+ * │   ├── ad
  * │   │   └── index.d.ts                   广告 API
- * │   ├── alipay
+ * │   ├── ai
+ * │   │   ├── face.d.ts                    人脸检测 API
+ * │   │   ├── inference.d.ts               AI 推理 API
+ * │   │   └── visionkit.d.ts               视觉算法 API
+ * │   ├── alipay
  * │   │   └── index.d.ts                   支付宝小程序 API
- * │   ├── base
+ * │   ├── base
  * │   │   ├── index.d.ts                   基础 API
+ * │   │   ├── crypto.d.ts                  基础 -> 加密 API
  * │   │   ├── debug.d.ts                   基础 -> 调试 API
+ * │   │   ├── env.d.ts                     基础 -> ENV
+ * │   │   ├── performance.d.ts
  * │   │   ├── system.d.ts                  基础 -> 系统 API
- * │   │   ├── update.d.ts                  基础 -> 更新 API
- * │   │   ├── weapp                        基础 -> 小程序 API
- * │   │   │   ├── life-cycle.d.ts          基础 -> 小程序 API -> 生命周期
- * │   │   │   └── app-event.d.ts           基础 -> 小程序 API -> 应用级事件
- * │   │   └── env.d.ts                     基础 -> ENV
- * │   ├── canvas
+ * │   │   ├── update.d.ts                  基础 -> 更新 API
+ * │   │   └── weapp                        基础 -> 小程序 API
+ * │   │       ├── app-event.d.ts           基础 -> 小程序 API -> 应用级事件
+ * │   │       └── life-cycle.d.ts          基础 -> 小程序 API -> 生命周期
+ * │   ├── canvas
  * │   │   └── index.d.ts                   画布 API
- * │   ├── cloud
+ * │   ├── cloud
  * │   │   └── index.d.ts                   微信小程序云开发 API
- * │   ├── data-analysis
+ * │   ├── data-analysis
  * │   │   └── index.d.ts                   数据分析 API
- * │   ├── device
+ * │   ├── device
  * │   │   ├── accelerometer.d.ts           设备 -> 加速计 API
+ * │   │   ├── accessibility.d.ts           设备 -> 无障碍 API
  * │   │   ├── battery.d.ts                 设备 -> 电量 API
- * │   │   ├── ble.d.ts                     设备 -> 低功耗蓝牙 API
- * │   │   ├── bluetooth.d.                 设备 -> 蓝牙 API
+ * │   │   ├── bluetooth-ble.d.ts           设备 -> 蓝牙-低功耗中心设备 API
+ * │   │   ├── bluetooth-peripheral.d.ts    设备 -> 蓝牙-低功耗外围设备 API
+ * │   │   ├── bluetooth.d.ts               设备 -> 蓝牙-通用 API
+ * │   │   ├── calendar.d.ts                设备 -> 日历 API
  * │   │   ├── clipboard.d.ts               设备 -> 剪贴板 API
  * │   │   ├── compass.d.ts                 设备 -> 罗盘 API
  * │   │   ├── contact.d.ts                 设备 -> 联系人 API
- * │   │   ├── motion.d.ts                  设备 -> 设备方向 API
  * │   │   ├── gyroscope.d.ts               设备 -> 陀螺仪 API
  * │   │   ├── iBeacon.d.ts                 设备 -> iBeacon API
- * │   │   ├── network.d.ts                 设备 -> 网络 API
- * │   │   ├── nfc.d.ts                     设备 -> NFC API
- * │   │   ├── performance.d.ts             设备 -> 性能 API
+ * │   │   ├── keyboard.d.ts                设备 -> 键盘 API
+ * │   │   ├── memory.d.ts                  设备 -> 内存 API
+ * │   │   ├── motion.d.ts                  设备 -> 设备方向 API
+ * │   │   ├── network.d.ts                 设备 -> 网络 API
+ * │   │   ├── nfc.d.ts                     设备 -> NFC 读写 API
  * │   │   ├── phone.d.ts                   设备 -> 电话 API
  * │   │   ├── scan.d.ts                    设备 -> 扫码 API
  * │   │   ├── screen.d.ts                  设备 -> 屏幕 API
+ * │   │   ├── sms.d.ts                     设备 -> 短信 API
  * │   │   ├── vibrate.d.ts                 设备 -> 振动 API
  * │   │   └── wifi.d.ts                    设备 -> Wi-Fi API
- * │   ├── ext
+ * │   ├── ext
  * │   │   └── index.d.ts                   第三方平台 API
- * │   ├── files
+ * │   ├── files
  * │   │   └── index.d.ts                   文件 API
- * │   ├── framework
+ * │   ├── framework
  * │   │   └── index.d.ts                   小程序框架 API
- * │   ├── location
+ * │   ├── location
  * │   │   └── index.d.ts                   位置 API
- * │   ├── media
+ * │   ├── media
  * │   │   ├── audio.d.ts                   媒体 -> 音频 API
  * │   │   ├── background-audio.d.ts        媒体 -> 背景音频 API
  * │   │   ├── camera.d.ts                  媒体 -> 相机 API
@@ -57,21 +68,26 @@
  * │   │   ├── image.d.ts                   媒体 -> 图片 API
  * │   │   ├── live.d.ts                    媒体 -> 实时音视频 API
  * │   │   ├── map.d.ts                     媒体 -> 地图 API
+ * │   │   ├── media-recorder.d.ts          媒体 -> 画面录制器 API
  * │   │   ├── recorder.d.ts                媒体 -> 录音 API
- * │   │   ├── video.d.ts                   媒体 -> 视频 API
+ * │   │   ├── video-decoder.d.ts           媒体 -> 视频解码器 API
  * │   │   └── video-processing.d.ts        媒体 -> 音视频合成 API
- * │   ├── network
+ * │   │   ├── video.d.ts                   媒体 -> 视频 API
+ * │   │   └── voip.d.ts                    媒体 -> 实时语音 API
+ * │   ├── navigate
+ * │   │   └── index.d.ts                   跳转 API
+ * │   ├── network
  * │   │   ├── download.d.ts                网络 -> 下载 API
  * │   │   ├── mdns.d.ts                    网络 -> mDNS API
  * │   │   ├── request.d.ts                 网络 -> 发起请求 API
+ * │   │   ├── tcp.d.ts                     网络 -> TCP 通信 API
  * │   │   ├── udp.d.ts                     网络 -> UDP 通信 API
  * │   │   ├── upload.d.ts                  网络 -> 上传 API
  * │   │   └── websocket.d.ts               网络 -> WebSocket API
- * │   ├── open-api
+ * │   ├── open-api
  * │   │   ├── account.d.ts                 开放接口 -> 账号信息 API
  * │   │   ├── address.d.ts                 开放接口 -> 收货地址 API
  * │   │   ├── authorize.d.ts               开放接口 -> 授权 API
- * │   │   ├── bookshelf.d.ts               开放接口 -> 书架 API
  * │   │   ├── card.d.ts                    开放接口 -> 卡券 API
  * |   |   ├── channels.d.ts                开放接口 -> 视频号 API
  * |   |   ├── customer-service.d.ts        开放接口 -> 微信客服 API
@@ -80,11 +96,10 @@
  * │   │   ├── favorites.d.ts               开放接口 -> 收藏 API
  * │   │   ├── group.d.ts                   开放接口 -> 微信群 API
  * │   │   ├── invoice.d.ts                 开放接口 -> 发票 API
- * │   │   ├── licence-plate.d.ts           开放接口 -> 车牌 API
+ * │   │   ├── license-plate.d.ts           开放接口 -> 车牌 API
  * │   │   ├── login.d.ts                   开放接口 -> 登录 API
  * │   │   ├── my-miniprogram.d.ts          开放接口 -> 我的小程序 API
  * │   │   ├── privacy.d.ts                 开放接口 -> 隐私信息授权 API
- * │   │   ├── payment.d.ts                 开放接口 -> 支付 API
  * │   │   ├── redpackage.d.ts              开放接口 -> 微信红包 API
  * │   │   ├── settings.d.ts                开放接口 -> 设置 API
  * │   │   ├── soter.d.ts                   开放接口 -> 生物认证 API
@@ -92,23 +107,33 @@
  * |   |   ├── subscribe-message.d.ts       开放接口 -> 订阅消息 API
  * │   │   ├── user-info.d.ts               开放接口 -> 用户信息 API
  * │   │   └── werun.d.ts                   开放接口 -> 微信运动 API
- * │   ├── route
+ * │   ├── payment
+ * │   │   └── index.d.ts                   支付 API
+ * │   ├── qq
+ * │   │   └── index.d.ts                   QQ 小程序 API
+ * │   ├── route
  * │   │   └── index.d.ts                   路由 API
- * │   ├── share
+ * │   ├── share
  * │   │   └── index.d.ts                   转发 API
- * │   ├── skyline
+ * │   ├── skyline
  * │   │   └── index.d.ts                   微信 Skyline API
- * │   ├── storage
+ * │   ├── storage
  * │   │   ├── background-fetch.d.ts        数据缓存 -> 后台获取 API
- * │   │   └── index.d.ts                   数据缓存 API
- * │   ├── swan
+ * │   │   ├── cache-manager.d.ts           数据缓存 -> 缓存管理 API
+ * │   │   └── index.d.ts                   数据缓存 API
+ * │   ├── swan
+ * │   │   ├── bookshelf.d.ts               百度小程序 -> 书架 API
+ * │   │   ├── download-package.d.ts        百度小程序 -> 下载包 API
  * │   │   └── index.d.ts                   百度小程序 API
- * │   ├── ui
+ * │   │   └── pay.d.ts                     百度小程序 -> 支付 API
+ * │   ├── taro.extend.d.ts                 Taro 扩展 API 类型定义
+ * │   ├── taro.hooks.d.ts                  Taro Hooks 类型定义
+ * │   ├── ui
  * │   │   ├── animation.d.ts               界面 -> 动画 API
  * │   │   ├── background.d.ts              界面 -> 背景 API
  * │   │   ├── custom-component.d.ts        界面 -> 自定义组件 API
  * │   │   ├── fonts.d.ts                   界面 -> 字体 API
- * │   │   ├── keyboard.d.ts                界面 -> 键盘 API
+ * │   │   ├── interaction.d.ts             界面 -> 交互 API
  * │   │   ├── menu.d.ts                    界面 -> 菜单 API
  * │   │   ├── navigation-bar.d.ts          界面 -> 导航栏 API
  * │   │   ├── pull-down-refresh.d.ts       界面 -> 下拉刷新 API
@@ -116,14 +141,25 @@
  * │   │   ├── sticky.d.ts                  界面 -> 置顶 API
  * │   │   ├── tab-bar.d.ts                 界面 -> TabBar API
  * │   │   ├── window.d.ts                  界面 -> 窗口 API
- * │   │   └── interaction.d.ts             界面 -> 交互 API
- * │   ├── worker
+ * │   ├── worker
  * │   │   └── index.d.ts                   Worker API
- * │   ├── wxml
+ * │   └── wxml
  * │   │   └── index.d.ts                   WXML API
- * │   ├── taro.extend.d.ts                 Taro 扩展 API 类型定义
- * │   └── taro.hooks.d.ts                  Taro Hooks 类型定义
+ * ├── compile
+ * │   ├── compiler.d.ts
+ * │   ├── config
+ * │   │   ├── h5.d.ts
+ * │   │   ├── index.d.ts
+ * │   │   ├── manifest.d.ts
+ * │   │   ├── mini.d.ts
+ * │   │   ├── project.d.ts
+ * │   │   ├── rn.d.ts
+ * │   │   └── util.d.ts
+ * │   ├── hooks.d.ts                       Taro Hooks 类型定义
+ * │   └── index.d.ts
+ * ├── global.d.ts
  * ├── index.d.ts                           此文件
+ * ├── taro.api.d.ts
  * ├── taro.component.d.ts                  Taro Component 类型定义
  * ├── taro.config.d.ts                      Taro 小程序 App 与 Window 设置类型定义
  * └── taro.lifecycle.d.ts                  Taro 生命周期类型定义
@@ -135,6 +171,7 @@
 /// <reference path="taro.component.d.ts" />
 /// <reference path="taro.config.d.ts" />
 /// <reference path="taro.lifecycle.d.ts" />
+/// <reference path="taro.runtime.d.ts" />
 
 /// <reference types="@tarojs/plugin-platform-alipay/types/shims-alipay" />
 /// <reference types="@tarojs/plugin-platform-jd/types/shims-jd" />
@@ -150,10 +187,9 @@ export as namespace Taro
 declare const Taro: Taro.TaroStatic
 
 declare namespace Taro {
-  // eslint-disable-next-line @typescript-eslint/no-empty-interface
   interface TaroStatic {}
 }
 declare global {
-  const defineAppConfig: (config: Taro.Config) => Taro.Config
-  const definePageConfig: (config: Taro.Config) => Taro.Config
+  const defineAppConfig: (config: Taro.AppConfig) => Taro.AppConfig
+  const definePageConfig: (config: Taro.PageConfig) => Taro.Config
 }

package/types/taro.api.d.ts

@@ -63,7 +63,6 @@
 /// <reference path="api/open-api/account.d.ts" />
 /// <reference path="api/open-api/address.d.ts" />
 /// <reference path="api/open-api/authorize.d.ts" />
-/// <reference path="api/open-api/bookshelf.d.ts" />
 /// <reference path="api/open-api/card.d.ts" />
 /// <reference path="api/open-api/channels.d.ts" />
 /// <reference path="api/open-api/customer-service.d.ts" />
@@ -121,6 +120,7 @@
 /// <reference path="api/alipay/index.d.ts" />
 /// <reference path="api/qq/index.d.ts" />
 
+/// <reference path="api/swan/bookshelf.d.ts" />
 /// <reference path="api/swan/download-package.d.ts" />
 /// <reference path="api/swan/index.d.ts" />
 /// <reference path="api/swan/pay.d.ts" />

package/types/taro.component.d.ts

@@ -19,6 +19,7 @@ declare module './index' {
     shareTicket: string | undefined
     scene: number | undefined
     exitState?: any
+    $taroPath?: string
   }
 
   interface Show {
@@ -139,5 +140,7 @@ declare module './index' {
     path?: string
     /** 页面的组件选项 */
     options?: Record<string, unknown>
+    /** 获得一个 EventChannel 对象，用于页面间通讯 */
+    getOpenerEventChannel?(): Record<string, any>
   }
 }

package/types/taro.config.d.ts

@@ -32,9 +32,14 @@ declare module './index' {
      * @default: "#ffffff"
      */
     backgroundColor?: string
+    /** 页面容器背景色， HexColor
+     * @see: https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/custom-route.html#%E8%AE%BE%E7%BD%AE%E9%A1%B5%E9%9D%A2%E9%80%8F%E6%98%8E
+     * @default: "#ffffff"
+     */
+    backgroundColorContent?: string
     /** 下拉背景字体、loading 图的样式，仅支持 dark/light
      * 当 app.json 中配置 darkmode 为 true 时可通过变量的形式配置
-     * @see: https://developers.weixin.qq.com/miniprogram/dev/framework/ability/darkmode.html 
+     * @see: https://developers.weixin.qq.com/miniprogram/dev/framework/ability/darkmode.html
      * @default: "dark"
      */
     backgroundTextStyle?: 'dark' | 'light' | string
@@ -424,7 +429,7 @@ declare module './index' {
     decodeQuery?: 'disable'
   }
 
-  interface AppConfig {
+  export interface AppConfig {
     /** 小程序默认启动首页，未指定 entryPagePath 时，数组的第一项代表小程序的初始页面（首页）。 */
     entryPagePath?: string
     /** 接受一个数组，每一项都是字符串，来指定小程序由哪些页面组成，数组的第一项代表小程序的初始页面 */
@@ -561,7 +566,7 @@ declare module './index' {
      */
     themeLocation?: string
     /** 配置自定义组件代码按需注入 */
-    lazyCodeLoading?: string
+    lazyCodeLoading?: 'requiredComponents' | string
     /** 单页模式相关配置 */
     singlePage?: SinglePage
     /** 聊天素材小程序打开相关配置

package/types/taro.lifecycle.d.ts

@@ -56,9 +56,12 @@ declare module './index' {
   }
 
   interface PageResizeObject {
+    deviceOrientation?: 'portrait' | 'landscape'
     size: {
       windowWidth: number
       windowHeight: number
+      screenWidth?: number
+      screenHeight?: number
     }
   }
 

package/types/taro.runtime.d.ts

@@ -0,0 +1,9 @@
+import type { options } from '@tarojs/runtime'
+
+import Taro from './index'
+
+declare module './index' {
+  interface TaroStatic {
+    options: typeof options
+  }
+}