@tarojs/taro 3.7.0-canary.6 → 4.0.0-alpha.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.7.0-canary.6",
+  "version": "4.0.0-alpha.0",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -21,12 +21,12 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.7.0-canary.6",
-    "@tarojs/runtime": "3.7.0-canary.6"
+    "@tarojs/api": "4.0.0-alpha.0",
+    "@tarojs/runtime": "4.0.0-alpha.0"
   },
   "devDependencies": {
-    "@tarojs/shared": "3.7.0-canary.6",
-    "@tarojs/helper": "3.7.0-canary.6"
+    "@tarojs/shared": "4.0.0-alpha.0",
+    "@tarojs/helper": "4.0.0-alpha.0"
   },
   "peerDependenciesMeta": {
     "@types/react": {

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

@@ -546,7 +546,7 @@ declare module '../../index' {
     getSystemSetting(): getSystemSetting.Result
 
     /** [Taro.getSystemInfo](./getSystemInfo) 的同步版本
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @h5 不支持 version、statusBarHeight、fontSizeSetting、SDKVersion
      * @weapp 小程序可以在微信和企业微信中调用此接口，但是在企业微信中调用此接口时，会额外返回一个 environment 字段（微信中不返回），如此字段值为 wxwork，则表示当前小程序运行在企业微信环境中。
      * @example
@@ -591,7 +591,7 @@ declare module '../../index' {
     getSystemInfoAsync(res?: getSystemInfoAsync.Option): Promise<getSystemInfo.Result>
 
     /** 获取系统信息，支持 `Promise` 化使用。
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @h5 不支持 version、statusBarHeight、fontSizeSetting、SDKVersion
      * @weapp 小程序可以在微信和企业微信中调用此接口，但是在企业微信中调用此接口时，会额外返回一个 environment 字段（微信中不返回），如此字段值为 wxwork，则表示当前小程序运行在企业微信环境中。
      * @example

package/types/api/base/weapp/app-event.d.ts

@@ -113,7 +113,7 @@ declare module '../../../index' {
      *
      * **注意**
      *  - 所有的 unhandledRejection 都可以被这一监听捕获，但只有 Error 类型的才会在小程序后台触发报警。
-     * @supported weapp, tt, h5
+     * @supported weapp, tt, h5, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/app/app-event/wx.onUnhandledRejection.html
      */
     onUnhandledRejection<T = any>(callback: onUnhandledRejection.Callback<T>): void
@@ -137,7 +137,7 @@ declare module '../../../index' {
     onPageNotFound(callback: onPageNotFound.Callback): void
 
     /** 监听小程序错误事件。如脚本错误或 API 调用报错等。该事件与 [`App.onError`](https://developers.weixin.qq.com/miniprogram/dev/reference/api/App.html#onerrorstring-error) 的回调时机与参数一致。
-     * @supported weapp, tt, h5
+     * @supported weapp, tt, h5, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/app/app-event/wx.onError.html
      */
     onError(callback: onError.Callback): void
@@ -196,7 +196,7 @@ declare module '../../../index' {
     ): void
 
     /** 取消监听未处理的 Promise 拒绝事件
-     * @supported weapp, tt, h5
+     * @supported weapp, tt, h5, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/app/app-event/wx.offUnhandledRejection.html
      */
     offUnhandledRejection<T = any>(callback: onUnhandledRejection.Callback<T>): void
@@ -217,7 +217,7 @@ declare module '../../../index' {
     ): void
 
     /** 取消监听音频播放错误事件
-     * @supported weapp, tt, h5
+     * @supported weapp, tt, h5, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/InnerAudioContext.offError.html
      */
 

package/types/api/device/accelerometer.d.ts

@@ -56,7 +56,7 @@ declare module '../../index' {
      * ```tsx
      * Taro.startAccelerometer({ interval: 'game' })
      * ```
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/accelerometer/wx.startAccelerometer.html
      */
     startAccelerometer (res?: startAccelerometer.Option): Promise<TaroGeneral.CallbackResult>
@@ -67,14 +67,14 @@ declare module '../../index' {
      * ```tsx
      * Taro.stopAccelerometer()
      * ```
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/accelerometer/wx.stopAccelerometer.html
      */
     stopAccelerometer (res?: stopAccelerometer.Option): Promise<TaroGeneral.CallbackResult>
 
     /**
      * 监听加速度数据，频率：5次/秒，接口调用后会自动开始监听，可使用 `Taro.stopAccelerometer` 停止监听。
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony
      * @example
      * ```tsx
      * Taro.onAccelerometerChange(res => {
@@ -91,7 +91,7 @@ declare module '../../index' {
 
     /**
      * 取消监听加速度数据事件，参数为空，则取消所有的事件监听。
-     * @supported weapp, alipay, swan, jd, tt, h5, rn
+     * @supported weapp, alipay, swan, jd, tt, h5, rn, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/accelerometer/wx.offAccelerometerChange.html
      */
     offAccelerometerChange(

package/types/api/device/battery.d.ts

@@ -32,13 +32,13 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** Taro.getBatteryInfo 的同步版本
-     * @supported weapp, alipay, swan, jd, qq
+     * @supported weapp, alipay, swan, jd, qq, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/battery/wx.getBatteryInfoSync.html
      */
     getBatteryInfoSync(): getBatteryInfoSync.Result
 
     /** 获取设备电量。同步 API Taro.getBatteryInfoSync 在 iOS 上不可用。
-     * @supported weapp, alipay, swan, jd, qq, h5
+     * @supported weapp, alipay, swan, jd, qq, h5, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/battery/wx.getBatteryInfo.html
      */
     getBatteryInfo(option?: getBatteryInfo.Option): Promise<getBatteryInfo.SuccessCallbackResult>

package/types/api/device/clipboard.d.ts

@@ -43,7 +43,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 设置系统剪贴板的内容。调用成功后，会弹出 toast 提示"内容已复制"，持续 1.5s
-     * @supported weapp, swan, jd, qq, tt, h5, rn
+     * @supported weapp, swan, jd, qq, tt, h5, rn, harmony
      * @h5 部分实现
      * @example
      * ```tsx
@@ -64,7 +64,7 @@ declare module '../../index' {
 
     /**
      * 获取系统剪贴板内容
-     * @supported weapp, swan, jd, qq, tt, h5, rn
+     * @supported weapp, swan, jd, qq, tt, h5, rn, harmony
      * @h5 部分实现
      * @example
      * ```tsx

package/types/api/device/keyboard.d.ts

@@ -71,7 +71,7 @@ declare module '../../index' {
     getSelectedTextRange(option?: getSelectedTextRange.Option): Promise<getSelectedTextRange.SuccessCallbackResult>
 
     /** 监听键盘高度变化
-     * @supported weapp, swan, jd, qq, rn
+     * @supported weapp, swan, jd, qq, rn, harmony
      * @example
      * ```tsx
      * Taro.onKeyboardHeightChange(res => {
@@ -86,7 +86,7 @@ declare module '../../index' {
 
     /**
      * 取消监听键盘高度变化事件。
-     * @supported weapp, swan, jd, rn
+     * @supported weapp, swan, jd, rn, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/keyboard/wx.offKeyboardHeightChange.html
      */
     offKeyboardHeightChange(

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

@@ -107,7 +107,7 @@ declare module '../../index' {
     ): void
 
     /** 监听网络状态变化。
-     * @supported weapp, swan, h5, rn, tt
+     * @supported weapp, swan, h5, rn, tt, harmony
      * @example
      * ```tsx
      * Taro.onNetworkStatusChange(function (res) {
@@ -132,7 +132,7 @@ declare module '../../index' {
     ): void
 
     /** 取消监听网络状态变化事件，参数为空，则取消所有的事件监听。
-     * @supported weapp, swan, h5, rn
+     * @supported weapp, swan, h5, rn, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/network/wx.offNetworkStatusChange.html
      */
     offNetworkStatusChange(
@@ -141,7 +141,7 @@ declare module '../../index' {
     ): void
 
     /** 获取网络类型。
-     * @supported weapp, swan, qq, h5, rn, tt
+     * @supported weapp, swan, qq, h5, rn, tt, harmony
      * @example
      * ```tsx
      * Taro.getNetworkType({

package/types/api/device/phone.d.ts

@@ -16,7 +16,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 拨打电话
-     * @supported weapp, swan, jd, qq, tt, h5, rn
+     * @supported weapp, swan, jd, qq, tt, h5, rn, harmony
      * @example
      * ```tsx
      * Taro.makePhoneCall({

package/types/api/device/screen.d.ts

@@ -207,7 +207,7 @@ declare module '../../index' {
      *
      * **说明**
      * - 若安卓系统设置中开启了自动调节亮度功能，则屏幕亮度会根据光线自动调整，该接口仅能获取自动调节亮度之前的值，而非实时的亮度值。
-     * @supported weapp, alipay, swan, jd, qq, rn
+     * @supported weapp, alipay, swan, jd, qq, rn, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/screen/wx.getScreenBrightness.html
      */
     getScreenBrightness(

package/types/api/device/vibrate.d.ts

@@ -29,7 +29,7 @@ declare module '../../index' {
     /** 使手机发生较短时间的振动（15 ms）。仅在 iPhone `7 / 7 Plus` 以上及 Android 机型生效
      *
      * 仅微信小程序平台支持 type 参数
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony
      * @example
      * ```tsx
      * Taro.vibrateShort(params).then(...)
@@ -39,7 +39,7 @@ declare module '../../index' {
     vibrateShort(option?: vibrateShort.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 使手机发生较长时间的振动（400ms）
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony
      * @example
      * ```tsx
      * Taro.vibrateLong(params).then(...)

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

@@ -361,7 +361,7 @@ declare module '../../index' {
     previewImage(option: previewImage.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 获取图片信息。网络图片需先配置download域名才能生效。
-     * @supported weapp, alipay, swan, tt, h5, rn
+     * @supported weapp, alipay, swan, tt, h5, rn, harmony
      * @example
      * ```tsx
      * Taro.getImageInfo({

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

@@ -400,7 +400,7 @@ declare module '../../index' {
      * - 对于 `GET` 方法的数据，会将数据转换成 query string（`encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)...`）
      * - 对于 `POST` 方法且 `header['content-type']` 为 `application/json` 的数据，会对数据进行 JSON 序列化
      * - 对于 `POST` 方法且 `header['content-type']` 为 `application/x-www-form-urlencoded` 的数据，会将数据转换成 query string `（encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)...）`
-     * @supported weapp, h5, rn, alipay, swan, tt, qq
+     * @supported weapp, h5, rn, alipay, swan, tt, qq, harmony
      * @example
      * ```tsx
      * Taro.request({

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

@@ -117,7 +117,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @example
      * ```json
      * {
@@ -143,7 +143,7 @@ declare module '../../index' {
     switchTab(option: switchTab.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 关闭所有页面，打开到应用内的某个页面
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @example
      * ```tsx
      * Taro.reLaunch({
@@ -155,7 +155,7 @@ declare module '../../index' {
     reLaunch(option: reLaunch.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 关闭当前页面，跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面。
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @h5 未针对 tabbar 页面做限制处理
      * @example
      * ```tsx
@@ -168,7 +168,7 @@ declare module '../../index' {
     redirectTo(option: redirectTo.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 保留当前页面，跳转到应用内的某个页面。但是不能跳到 tabbar 页面。使用 Taro.navigateBack 可以返回到原页面。小程序中页面栈最多十层。
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @h5 未针对 tabbar 页面做限制处理
      * @example
      * ```tsx
@@ -195,7 +195,7 @@ declare module '../../index' {
     navigateTo(option: navigateTo.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 关闭当前页面，返回上一页面或多级页面。可通过 getCurrentPages 获取当前的页面栈，决定需要返回几层。
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, h5, rn, tt, harmony
      * @h5 若入参 delta 大于现有页面数时，返回应用打开的第一个页面（如果想要返回首页请使用 reLaunch 方法）。
      * @example
      * ```tsx

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

@@ -177,7 +177,7 @@ declare module '../../index' {
     ): void
 
     /** 将数据存储在本地缓存中指定的 key 中。会覆盖掉原来该 key 对应的内容。除非用户主动删除或因存储空间原因被系统清理，否则数据都一直可用。单个 key 允许存储的最大数据长度为 1MB，所有数据存储上限为 10MB。
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony
      * @example
      * ```tsx
      * Taro.setStorage({
@@ -221,7 +221,7 @@ declare module '../../index' {
     ): void
 
     /** 从本地缓存中移除指定 key
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony
      * @example
      * ```tsx
      * Taro.removeStorage({
@@ -289,7 +289,7 @@ declare module '../../index' {
     getStorageInfo(option?: getStorageInfo.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 从本地缓存中异步获取指定 key 的内容
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony
      * @example
      * ```tsx
      * Taro.getStorage({
@@ -327,7 +327,7 @@ declare module '../../index' {
     clearStorageSync(): void
 
     /** 清理本地数据缓存
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony
      * @example
      * ```tsx
      * Taro.clearStorage()

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

@@ -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/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,7 +500,7 @@ 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 })

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

@@ -115,6 +115,12 @@ export interface IMiniAppConfig<T extends CompilerTypes = CompilerWebpackTypes>
 
   /** 使用的编译工具。可选值：webpack4、webpack5、vite */
   compiler?: Compiler<T>
+
+  /** 体验式功能 */
+  experimental?: {
+    /** 是否开启编译模式 */
+    compileMode?: boolean
+  }
 }
 
 export interface IMiniFilesConfig {

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

@@ -1,10 +1,11 @@
 import type Webpack from 'webpack'
 import type Chain from 'webpack-chain'
-import { type Input } from 'postcss'
+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 { IHarmonyConfig } from './harmony'
 import type { IMiniAppConfig, IMiniFilesConfig } from './mini'
 import type { IRNConfig } from './rn'
 
@@ -313,5 +314,7 @@ export interface IProjectConfig<T extends CompilerTypes = CompilerWebpackTypes>
   /** 专属于 RN 的配置 */
   rn?: IRNConfig
 
+  harmony?: IHarmonyConfig<T>
+
   [key: string]: any
 }

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

@@ -77,6 +77,8 @@ export interface IPxTransformOption {
   deviceRatio?: TaroGeneral.TDeviceRatio
   /** 平台 */
   platform?: 'weapp' | 'h5' | string
+  /** 启用的能力 Scope 默认为 ['platform', 'size'] */
+  methods?: string[]
   /** filter 回调函数，可 exclude 不处理的文件 */
   exclude?: (fileName: string) => boolean
 }
@@ -90,7 +92,7 @@ interface IBasePostcssOption {
   [key: string]: any
 }
 
-export type IPostcssOption<T = 'h5' | 'mini'> = T extends 'h5'
+export type IPostcssOption<T = 'h5' | 'harmony' | 'mini'> = T extends 'h5'
   ? IBasePostcssOption & { url?: PostcssOption.url }
   : IBasePostcssOption
 

package/types/compile/viteCompilerContext.d.ts

@@ -1,7 +1,7 @@
 import type { RecursiveTemplate, UnRecursiveTemplate } from '@tarojs/shared/dist/template'
 import type { PluginContext } from 'rollup'
 import type { AppConfig, PageConfig } from '../index'
-import type { IMiniFilesConfig, IH5Config, IMiniAppConfig } from './config'
+import type { IMiniFilesConfig, IH5Config, IHarmonyConfig, IMiniAppConfig } from './config'
 import type { IProjectConfig } from './config/project'
 import type { IComponentConfig } from './hooks'
 
@@ -47,6 +47,14 @@ export interface ViteH5BuildConfig extends CommonBuildConfig, IH5Config<'vite'>
   runtimePath?: string | string[]
 }
 
+export interface ViteHarmonyBuildConfig extends CommonBuildConfig, IHarmonyConfig {
+  fileType: IFileType
+  useETS?: boolean
+  useJSON5?: boolean
+  runtimePath?: string | string[]
+  taroComponentsPath: string
+}
+
 export interface CommonBuildConfig extends IProjectConfig<'vite'> {
   entry: {
     app: string | string[]
@@ -117,6 +125,17 @@ export interface ViteH5CompilerContext extends ViteCompilerContext<ViteH5BuildCo
   browserslist: string[]
 }
 
+export interface ViteHarmonyCompilerContext extends ViteCompilerContext<ViteHarmonyBuildConfig> {
+  fileType: ViteFileType
+  commonChunks: string[]
+  getCommonChunks: () => string[]
+  modifyHarmonyConfig: (config: Partial<AppConfig>) => void
+  modifyHostPackageDep: (outDir: string, deps?: Record<string, string>, devDeps?: Record<string, string>) => void
+  getScriptPath: (filePath: string) => string
+  getStylePath: (filePath: string) => string
+  getConfigPath: (filePath: string) => string
+}
+
 export interface ViteMiniCompilerContext extends ViteCompilerContext<ViteMiniBuildConfig> {
   fileType: ViteFileType
   commonChunks: string[]