@tarojs/taro 4.0.8-beta.0 → 4.0.8-beta.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "4.0.8-beta.0",
+  "version": "4.0.8-beta.3",
   "description": "Taro framework",
   "author": "O2Team",
   "license": "MIT",
@@ -24,20 +24,19 @@
   },
   "dependencies": {
     "@types/postcss-url": "^10.0.4",
-    "@tarojs/api": "4.0.8-beta.0",
-    "@tarojs/runtime": "4.0.8-beta.0"
+    "@tarojs/api": "4.0.8-beta.3",
+    "@tarojs/runtime": "4.0.8-beta.3"
   },
   "devDependencies": {
-    "@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/components": "4.0.8-beta.0",
-    "@tarojs/helper": "4.0.8-beta.0",
-    "@tarojs/shared": "4.0.8-beta.0"
+    "@tarojs/helper": "4.0.8-beta.3",
+    "@tarojs/components": "4.0.8-beta.3",
+    "@tarojs/shared": "4.0.8-beta.3"
   },
   "peerDependencies": {
     "@types/react": "^18",
@@ -48,9 +47,9 @@
     "webpack": "^5",
     "webpack-chain": "^6",
     "webpack-dev-server": "^4",
-    "@tarojs/helper": "4.0.8-beta.0",
-    "@tarojs/shared": "4.0.8-beta.0",
-    "@tarojs/components": "4.0.8-beta.0"
+    "@tarojs/components": "4.0.8-beta.3",
+    "@tarojs/shared": "4.0.8-beta.3",
+    "@tarojs/helper": "4.0.8-beta.3"
   },
   "peerDependenciesMeta": {
     "@types/react": {

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

@@ -2048,7 +2048,7 @@ declare module '../../index' {
     /** 创建 canvas 的绘图上下文 [CanvasContext](/docs/apis/canvas/CanvasContext) 对象
      *
      * **Tip**: 需要指定 canvasId，该绘图上下文只作用于对应的 `<canvas/>`；另外，Web 端需要在 `useReady` 回调中执行它，否则会因为底层 canvas 渲染出来之前而去获取 CanvasContext，导致其底层的 context 为 `undefined`，从而不能正常绘图。
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, harmony_hybrid
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, harmony_hybrid, harmony
      * @example
      * ```tsx
      * import { useReady } from '@tarojs/taro'

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

@@ -1,4 +1,4 @@
-import Taro, { DownloadTask, UploadTask } from "../../index"
+import Taro from "../../index"
 
 declare module '../../index' {
   namespace cloud {
@@ -212,6 +212,10 @@ declare module '../../index' {
 
     /** 调用云托管参数 */
     interface CallContainerParam < P extends string | TaroGeneral.IAnyObject | ArrayBuffer = any | any > {
+      config?:{
+        /** 微信云托管的环境ID, 如果在 Taro.cloud.init 中配置了env, 则可以不配置。 */
+        env: string, 
+      }
       /** 服务路径 */
       path: string
       /** HTTP请求方法，默认 GET */

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

@@ -43,7 +43,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 在input、textarea等focus拉起键盘之后，手动调用此接口收起键盘
-     * @supported weapp, alipay, swan, jd, tt, rn, harmony_hybrid
+     * @supported weapp, alipay, swan, jd, tt, rn, harmony_hybrid, harmony
      * @example
      * ```tsx
      * Taro.hideKeyboard({

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

@@ -26,7 +26,7 @@ declare module '../../index' {
     /** 监听内存不足告警事件。
      *
      * 当 iOS/Android 向小程序进程发出内存警告时，触发该事件。触发该事件不意味小程序被杀，大部分情况下仅仅是告警，开发者可在收到通知后回收一些不必要资源避免进一步加剧内存紧张。
-     * @supported weapp, alipay, swan, jd, tt
+     * @supported weapp, alipay, swan, jd, tt, harmony
      * @example
      * ```tsx
      * Taro.onMemoryWarning(function () {
@@ -41,7 +41,7 @@ declare module '../../index' {
     ): void
 
     /** 取消监听内存不足告警事件。
-     * @supported weapp, alipay, swan
+     * @supported weapp, alipay, swan, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/memory/wx.offMemoryWarning.html
      */
     offMemoryWarning(

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

@@ -1464,7 +1464,7 @@ declare module '../../index' {
     getFileInfo(option: getFileInfo.Option): Promise<getFileInfo.SuccessCallbackResult | getFileInfo.FailCallbackResult>
 
     /** 获取全局唯一的文件管理器
-     * @supported weapp, alipay, swan, jd, qq, tt, harmony_hybrid
+     * @supported weapp, alipay, swan, jd, qq, tt, harmony_hybrid, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/file/wx.getFileSystemManager.html
      */
     getFileSystemManager(): FileSystemManager

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

@@ -455,7 +455,7 @@ declare module '../../index' {
      * **注意**
      * - 工具中定位模拟使用IP定位，可能会有一定误差。且工具目前仅支持 gcj02 坐标。
      * - 使用第三方服务进行逆地址解析时，请确认第三方服务默认的坐标系，正确进行坐标转换。
-     * @supported weapp, swan, jd, qq, tt, rn, harmony_hybrid
+     * @supported weapp, swan, jd, qq, tt, rn, harmony_hybrid, harmony
      * @example
      *  ```tsx
      * Taro.getLocation({

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

@@ -740,7 +740,11 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/WebAudioContext.decodeAudioData.html
      */
-    decodeAudioData(): AudioBuffer
+    decodeAudioData(
+      audioData: ArrayBuffer,
+      successCallback: (buffer: AudioBuffer) => void,
+      errorCallback: (error: any) => void
+    ): Promise<AudioBuffer>
   }
 
   namespace WebAudioContext {

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

@@ -442,7 +442,7 @@ declare module '../../index' {
     getVideoInfo(option: getVideoInfo.Option): Promise<getVideoInfo.SuccessCallbackResult>
 
     /** 创建 video 上下文 VideoContext 对象。
-     * @supported weapp, h5, rn, harmony_hybrid
+     * @supported weapp, h5, rn, harmony_hybrid, harmony
      * @example
      * ```tsx
      * videoContext = Taro.createVideoContext('myVideo')
@@ -505,7 +505,7 @@ declare module '../../index' {
     chooseVideo(option: chooseVideo.Option): Promise<chooseVideo.SuccessCallbackResult>
 
     /** 拍摄或从手机相册中选择图片或视频。
-     * @supported weapp, h5, harmony_hybrid
+     * @supported weapp, h5, harmony_hybrid, harmony
      * @example
      * ```tsx
      * Taro.chooseMedia({

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

@@ -320,7 +320,7 @@ declare module '../../index' {
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/voip/wx.setEnable1v1Chat.html
      */
-    setEnable1v1Chat(option: subscribeVoIPVideoMembers.Option): Promise<TaroGeneral.CallbackResult>
+    setEnable1v1Chat(option: setEnable1v1Chat.Option): Promise<TaroGeneral.CallbackResult>
     /** 监听实时语音通话成员视频状态变化事件
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/voip/wx.onVoIPVideoMembersChanged.html
@@ -373,7 +373,7 @@ declare module '../../index' {
      */
     offVoIPChatInterrupted(callback: onVoIPChatInterrupted.Callback): void
     /** 加入 (创建) 实时语音通话，更多信息可见 [实时语音指南](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/voip-chat.html)
-     * 
+     *
      * 调用前需要用户授权 `scope.record`，若房间类型为视频房间需要用户授权 `scope.camera`。
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/voip/wx.joinVoIPChat.html

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

@@ -151,7 +151,7 @@ declare module '../../index' {
     /** 下载文件资源到本地。客户端直接发起一个 HTTPS GET 请求，返回文件的本地临时路径，单次下载允许的最大文件为 50MB。使用前请注意阅读[相关说明](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/network.html)。
      *
      * 注意：请在服务端响应的 header 中指定合理的 `Content-Type` 字段，以保证客户端正确处理文件类型。
-     * @supported weapp, h5, alipay, swan, rn, tt, harmony_hybrid
+     * @supported weapp, h5, alipay, swan, rn, tt, harmony_hybrid, harmony
      * @example
      * ```tsx
      * Taro.downloadFile({

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

@@ -152,7 +152,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 将本地资源上传到服务器。客户端发起一个 HTTPS POST 请求，其中 `content-type` 为 `multipart/form-data`。使用前请注意阅读[相关说明](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/network.html)。
-     * @supported weapp, swan, alipay, h5, rn, tt, harmony_hybrid
+     * @supported weapp, swan, alipay, h5, rn, tt, harmony_hybrid, harmony
      * @example
      * ```tsx
      * Taro.chooseImage({

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

@@ -44,10 +44,16 @@ declare module '../../index' {
     interface Option {
       /** 需要跳转的应用内非 tabBar 的页面的路径, 路径后可以带参数。参数与路径之间使用 `?` 分隔，参数键与参数值用 `=` 相连，不同参数用 `&` 分隔；如 'path?key=value&key2=value2' */
       url: string
-      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 页面间通信接口，用于监听被打开页面发送到当前页面的数据。 */
       events?: TaroGeneral.IAnyObject
+      /** 2.29.2 自定义路由类型 */
+      routeType?: string
+      /** 3.4.0 自定义路由配置 */
+      routeConfig?: TaroGeneral.IAnyObject
+      /** 3.4.0 自定义路由参数 */
+      routeOptions?: TaroGeneral.IAnyObject
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
@@ -115,9 +121,106 @@ declare module '../../index' {
     ): void
   }
 
+  namespace router {
+    type CustomRouteBuilder = (routeContext: CustomRouteContext, routeOptions: Record<string, any>) => CustomRouteConfig
+
+    interface SharedValue<T> {
+      value: T
+    }
+
+    interface CustomRouteContext {
+      // 动画控制器，影响推入页面的进入和退出过渡效果
+      primaryAnimation: SharedValue<number>
+      // 动画控制器状态
+      primaryAnimationStatus: SharedValue<number>
+      // 动画控制器，影响栈顶页面的推出过渡效果
+      secondaryAnimation: SharedValue<number>
+      // 动画控制器状态
+      secondaryAnimationStatus: SharedValue<number>
+      // 当前路由进度由手势控制
+      userGestureInProgress: SharedValue<number>
+      // 手势开始控制路由
+      startUserGesture: () => void
+      // 手势不再控制路由
+      stopUserGesture: () => void
+      // 返回上一级，效果同 wx.navigateBack
+      didPop: () => void
+    }
+
+    interface CustomRouteConfig {
+      // 下一个页面推入后，不显示前一个页面
+      opaque?: boolean
+      // 是否保持前一个页面状态
+      maintainState?: boolean
+      // 页面推入动画时长，单位 ms
+      transitionDuration?: number
+      // 页面推出动画时长，单位 ms
+      reverseTransitionDuration?: number
+      // 遮罩层背景色，支持 rgba() 和 #RRGGBBAA 写法
+      barrierColor?: string
+      // 点击遮罩层返回上一页
+      barrierDismissible?: boolean
+      // 无障碍语义
+      barrierLabel?: string
+      // 是否与下一个页面联动，决定当前页 secondaryAnimation 是否生效
+      canTransitionTo?: boolean
+      // 是否与前一个页面联动，决定前一个页 secondaryAnimation 是否生效
+      canTransitionFrom?: boolean
+      // 处理当前页的进入/退出动画，返回 StyleObject
+      handlePrimaryAnimation?: RouteAnimationHandler
+      // 处理当前页的压入/压出动画，返回 StyleObject
+      handleSecondaryAnimation?: RouteAnimationHandler
+      // 处理上一级页面的压入/压出动画，返回 StyleObject 基础库 <3.0.0> 起支持
+      handlePreviousPageAnimation?: RouteAnimationHandler
+      // 页面进入时是否采用 snapshot 模式优化动画性能 基础库 <3.2.0> 起支持
+      allowEnterRouteSnapshotting?: boolean
+      // 页面退出时是否采用 snapshot 模式优化动画性能 基础库 <3.2.0> 起支持
+      allowExitRouteSnapshotting?: boolean
+      // 右滑返回时，可拖动范围是否撑满屏幕，基础库 <3.2.0> 起支持，常用于半屏弹窗
+      fullscreenDrag?: boolean
+      // 返回手势方向 基础库 <3.4.0> 起支持
+      popGestureDirection?: 'horizontal' | 'vertical' | 'multi'
+    }
+
+    type RouteAnimationHandler = () => { [key: string] : any}
+
+    /** 自定义路由
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/route/router/wx.router.html
+     */
+    interface router {
+      /** 添加自定义路由配置
+       * @supported weapp
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/route/router/base/router.addRouteBuilder.html
+       */
+      addRouteBuilder(
+        /** 路由类型 */
+        routeType: string,
+        /** 路由动画定义函数 */
+        routeBuilder: CustomRouteBuilder
+      ): void
+      /** 获取页面对应的自定义路由上下文对象
+       * @supported weapp
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/route/router/base/router.getRouteContext.html
+       */
+      getRouteContext(
+        /** 页面/自定义组件实例 */
+        instance: TaroGeneral.IAnyObject
+      ): CustomRouteContext
+      /** 移除自定义路由配置
+       * @supported weapp
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/route/router/base/router.removeRouteBuilder.html
+       */
+      removeRouteBuilder(
+        /** 路由类型 */
+        routeType: string,
+      ): void
+    }
+  }
+
   interface TaroStatic {
     /** 跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面
-     * @supported weapp, h5, rn, tt, harmony, harmony_hybrid
+     * @supported weapp, h5, rn, tt, harmony_hybrid
      * @example
      * ```json
      * {
@@ -216,5 +319,6 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.navigateBack.html
      */
     navigateBack(option?: navigateBack.Option): Promise<TaroGeneral.CallbackResult>
+    router: router.router
   }
 }

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

@@ -56,4 +56,290 @@ declare module '../../index' {
       }
     }
   }
+
+  /**
+   * DraggableSheet 实例，可通过 Taro.createSelectorQuery 的 NodesRef.node 方法获取。
+   *
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/skyline/DraggableSheetContext.html
+   */
+  interface DraggableSheetContext {
+    /**
+     * 滚动到指定位置。size 取值 [0, 1]，size = 1 时表示撑满 draggable-sheet 组件。size 和 pixels 同时传入时，仅 size 生效。
+     * @param option
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/skyline/DraggableSheetContext.scrollTo.html
+     */
+    scrollTo(option: DraggableSheetContext.scrollTo.Option): void
+  }
+
+  namespace DraggableSheetContext {
+    namespace scrollTo {
+      interface Option {
+        /** 相对目标位置 */
+        size?: number
+        /** 绝对目标位置 */
+        pixels?: number
+        /**
+         * 是否启用滚动动画
+         * @default true
+         */
+        animated?: boolean
+        /**
+         * 滚动动画时长（ms)
+         * @default 300
+         */
+        duration?: number
+        /**
+         * 缓动函数
+         * @default ease
+         */
+        easingFunction?: string
+      }
+    }
+  }
+
+  /**
+   * worklet 对象，可以通过 wx.worklet 获取
+   *
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/wx.worklet.html
+   */
+  interface worklet {
+    /**
+     * 取消由 SharedValue 驱动的动画
+     * @param SharedValue
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/base/worklet.cancelAnimation.html
+     */
+    cancelAnimation(SharedValue: worklet.SharedValue): void
+    /**
+     * 衍生值 DerivedValue，可基于已有的 SharedValue 生成其它共享变量。
+     * @param updaterWorklet
+     * @returns 返回 DerivedValue 类型值，可被 worklet 函数捕获。DerivedValue 也是 SharedValue 类型。
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/base/worklet.derived.html
+     */
+    derived(updaterWorklet: worklet.WorkletFunction): worklet.DerivedValue
+    /**
+     * ScrollView 实例，可在 worklet 函数内操作 scroll-view 组件。
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/base/worklet.scrollViewContext.html
+     */
+    scrollViewContext: {
+      /**
+       * 滚动至指定位置
+       * @param object
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/base/worklet.scrollViewContext.scrollTo.html
+       */
+      scrollTo(NodesRef: TaroGeneral.IAnyObject, object: worklet.scrollViewContext.Option): void
+    }
+    /**
+     * 创建共享变量 SharedValue，用于跨线程共享数据和驱动动画。
+     * @param initialValue
+     * @returns 返回 SharedValue 类型值，可被 worklet 函数捕获。
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/base/worklet.shared.html
+     */
+    shared(initialValue: number | string | bool | null | undefined | Object | Array | Function): worklet.SharedValue
+    /**
+     * 基于滚动衰减的动画。
+     * @param options 动画配置
+     * @param callback 动画完成回调。动画被取消时，返回 fasle，正常完成时返回 true。
+     * @returns 返回 AnimationObject 类型值，可直接赋值给 SharedValue。
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.decay.html
+     */
+    decay(options?: worklet.decay.Option, callback?: (flag: boolean) => void): worklet.AnimationObject
+    Easing: worklet.Easing
+    /**
+     * 基于物理的动画。
+     * @param toValue 目标值
+     * @param options 动画配置
+     * @param callback 动画完成回调。动画被取消时，返回 fasle，正常完成时返回 true。
+     * @returns 返回 AnimationObject 类型值，可直接赋值给 SharedValue。
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.spring.html
+     */
+    spring(toValue: number | string, options?: worklet.spring.Option, callback?: (flag: boolean) => void): worklet.AnimationObject
+    /**
+     * 基于时间的动画。
+     * @param toValue 目标值
+     * @param options 动画配置
+     * @param callback 动画完成回调。动画被取消时，返回 fasle，正常完成时返回 true。
+     * @returns 返回 AnimationObject 类型值，可直接赋值给 SharedValue。
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.timing.html
+     */
+    timing(toValue: number | string, options?: worklet.timing.Option, callback?: (flag: boolean) => void): worklet.AnimationObject
+    /**
+     * 延迟执行动画。
+     * @param delayMS 动画开始前等待的时间，单位：毫秒
+     * @param delayedAnimation 动画对象
+     * @returns 返回 AnimationObject 类型值，可直接赋值给 SharedValue。
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/combine-animation/worklet.delay.html
+     */
+    delay(delayMS: number, delayedAnimation: worklet.AnimationObject): worklet.AnimationObject
+    /**
+     * 重复执行动画。
+     * @param animation 动画对象
+     * @param numberOfReps 重复次数。为负值时一直循环，直到被取消动画。
+     * @param reverse 反向运行动画，每周期结束动画由尾到头运行。该字段仅对 timing 和 spring 返回的动画对象生效。
+     * @param callback 动画完成回调。动画被取消时，返回 fasle，正常完成时返回 true。
+     * @returns 返回 AnimationObject 类型值，可直接赋值给 SharedValue。
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/combine-animation/worklet.repeat.html
+     */
+    repeat(delayedAnimation: worklet.AnimationObject, numberOfReps: number, reverse?: boolean, callback?: (flag: boolean) => void): worklet.AnimationObject
+    /**
+     * 组合动画序列，依次执行传入的动画。
+     * @param animation 动画对象
+     * @returns 返回 AnimationObject 类型值，可直接赋值给 SharedValue。
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/combine-animation/worklet.sequence.html
+     */
+    sequence(...delayedAnimation: worklet.AnimationObject): worklet.AnimationObject
+    /**
+     * worklet 函数运行在 UI 线程时，捕获的外部函数可能为 worklet 类型或普通函数，为了更明显的对其区分，要求必须使用 runOnJS 调回 JS 线程的普通函数。 有这样的要求是因为，调用其它 worklet 函数时是同步调用，但在 UI 线程执行 JS 线程的函数只能是异步，开发者容易混淆，试图同步获取 JS 线程的返回值。
+     * @param fn worklet 类型函数
+     * @returns runOnJS 为高阶函数，返回一个函数，执行时运行在 JS 线程
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/tool-function/worklet.runOnJS.html
+     */
+    runOnJS(fn: TaroGeneral.TFunc): TaroGeneral.TFunc
+    /**
+     * 在 UI 线程执行 worklet 函数
+     * @param fn worklet 类型函数
+     * @returns runOnUI 为高阶函数，返回一个函数，执行时运行在 UI 线程
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/tool-function/worklet.runOnUI.html
+     */
+    runOnUI(fn: TaroGeneral.TFunc): TaroGeneral.TFunc
+  }
+
+  namespace worklet {
+    type SharedValue = TaroGeneral.IAnyObject
+    type DerivedValue = worklet.SharedValue
+    type AnimationObject = TaroGeneral.IAnyObject
+    type WorkletFunction = TaroGeneral.TFunc
+
+    namespace scrollViewContext {
+      interface Option {
+        /** 顶部距离 */
+        top?: number
+        /** 左边界距离 */
+        left?: number
+        /** 滚动动画时长 */
+        duration?: number
+        /** 是否启用滚动动画 */
+        animated?: boolean
+        /** 动画曲线 */
+        easingFunction?: string
+      }
+    }
+
+    namespace decay {
+      interface Option {
+        /** 初速度 */
+        velocity?: number
+        /** 衰减速率 */
+        deceleration?: number
+        /** 边界值，长度为 2 的数组 */
+        clamp?: Array<number>
+      }
+    }
+
+    interface Easing {
+      /**
+       * 简单的反弹效果
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      bounce(t: number): any;
+      /**
+       * 简单的惯性动画
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      ease(t: number): any;
+      /**
+       * 简单的弹性动画，类似弹簧来回摆动，高阶函数。默认弹性为 1，会稍微超出一次。弹性为 0 时 不会过冲
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      elastic(bounciness?: number): any;
+      /**
+       * 线性函数
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      linear(t: number): any;
+      /**
+       * 二次方函数
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      quad(t: number): any;
+      /**
+       * 立方函数
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      cubic(t: number): any;
+      /**
+       * 高阶函数，返回幂函数
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      poly(n: number): any;
+      /**
+       * 三次贝塞尔曲线，效果同 css transition-timing-function
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      bezier(x1: number, y1: number, x2: number, y2: number): any;
+      /**
+       * 圆形曲线
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      circle(t: number): any;
+      /**
+       * 正弦函数
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      sin(t: number): any;
+      /**
+       * 指数函数
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      exp(t: number): any;
+      /**
+       * 正向运行 easing function，高阶函数。
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      in(easing: (t: number) => any): any;
+      /**
+       * 反向运行 easing function，高阶函数。
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      out(easing: (t: number) => any): any;
+      /**
+       * 前半程正向，后半程反向，高阶函数。
+       * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/worklet/animation/worklet.Easing.html
+       */
+      inOut(easing: (t: number) => any): any;
+    }
+
+    namespace spring {
+      interface Option {
+        /** 阻尼系数 */
+        damping?: number
+        /** 重量系数，值越大移动越慢 */
+        mass?: number
+        /** 弹性系数 */
+        stiffness?: number
+        /** 动画是否可以在指定值上反弹 */
+        overshootClamping?: boolean
+        /** 弹簧静止时的位移 */
+        restDisplacementThreshold?: number
+        /** 弹簧静止的速度 */
+        restSpeedThreshold?: number
+        /** 速度 */
+        velocity?: number
+      }
+    }
+
+    namespace timing {
+      interface Option {
+        /** 动画时长 */
+        duration?: number
+        /** 动画曲线 */
+        easing?: (t: number) => number
+      }
+    }
+  }
+
+  interface TaroStatic {
+    worklet: worklet
+  }
 }

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

@@ -310,7 +310,7 @@ declare module '../../index' {
     createBufferURL(
       /** 需要存入内存的二进制数据 */
       buffer: ArrayBuffer | TypedArray
-    ): void
+    ): string
 
     /** Taro.clearStorage 的同步版本
      * @supported weapp, alipay, swan, jd, qq, tt, h5, harmony_hybrid
@@ -327,7 +327,7 @@ declare module '../../index' {
     clearStorageSync(): void
 
     /** 清理本地数据缓存
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony, harmony_hybrid
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony_hybrid
      * @example
      * ```tsx
      * Taro.clearStorage()

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

@@ -22,7 +22,7 @@ declare module '../index' {
       onShow: string
       preloadData?: Record<any, any>
       /**
-       * RN 私有对象navigationRef，用于使用底层接口控制路由
+       * RN 私有对象 navigationRef，用于使用底层接口控制路由
        */
       rnNavigationRef?: React.RefObject<any>
     }
@@ -48,13 +48,14 @@ declare module '../index' {
     [TaroGeneral.ENV_TYPE.HARMONY]: TaroGeneral.ENV_TYPE.HARMONY
     [TaroGeneral.ENV_TYPE.QUICKAPP]: TaroGeneral.ENV_TYPE.QUICKAPP
     [TaroGeneral.ENV_TYPE.HARMONYHYBRID]: TaroGeneral.ENV_TYPE.HARMONYHYBRID
+    [TaroGeneral.ENV_TYPE.ASCF]: TaroGeneral.ENV_TYPE.ASCF
   }
 
   namespace interceptorify {
-    type promiseifyApi<T, R> = (requestParams: T) => Promise<R>
+    type promisifyApi<T, R> = (requestParams: T) => Promise<R>
     interface InterceptorifyChain<T, R> {
       requestParams: T
-      proceed: promiseifyApi<T, R>
+      proceed: promisifyApi<T, R>
     }
     type InterceptorifyInterceptor<T, R> = (chain: InterceptorifyChain<T, R>) => Promise<R>
     interface Interceptorify<T, R> {
@@ -111,7 +112,7 @@ declare module '../index' {
         mpVersion: string
         /** 小程序环境 */
         envType: string
-        /** 小程序appId */
+        /** 小程序 appId */
         appId: string
       }
       /** 插件信息 */
@@ -120,7 +121,7 @@ declare module '../index' {
       common: {
         /** 用户数据存储的路径 */
         USER_DATA_PATH: string
-        /** 校验白名单属性中的appInfoLaunchFrom后返回额外信息 */
+        /** 校验白名单属性中的 appInfoLaunchFrom 后返回额外信息 */
         location: string | undefined
         launchFrom: string | undefined
         schema: string | undefined
@@ -173,9 +174,9 @@ declare module '../index' {
     getRenderer(): 'webview' | 'skyline'
 
     /**
-     * 包裹 promiseify api 的洋葱圈模型
+     * 包裹 promisify api 的洋葱圈模型
      * @supported global
-     * @param promiseifyApi
+     * @param promisifyApi
      * @example
      * ```tsx
      * // 创建实例
@@ -227,6 +228,6 @@ declare module '../index' {
      * })
      * ```
      */
-    interceptorify<T, R>(promiseifyApi: interceptorify.promiseifyApi<T, R>): interceptorify.Interceptorify<T, R>
+    interceptorify<T, R>(api: interceptorify.promisifyApi<T, R>): interceptorify.Interceptorify<T, R>
   }
 }

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

@@ -98,20 +98,20 @@ declare module '../index' {
 
     /**
      * 页面加载完成时的回调。
-     * @supported weapp, h5, harmony_hybrid
+     * @supported weapp, h5, harmony_hybrid, harmony
      */
     useLoad<T extends {} = Record<string, any>>(callback: (param: T) => void): void
 
     /**
      * 页面卸载时的回调。
-     * @supported weapp, h5, harmony_hybrid
+     * @supported weapp, h5, harmony_hybrid, harmony
      */
     useUnload(callback: () => void): void
 
     /**
      * 页面初次渲染完成的回调。
      * 此时页面已经准备妥当，可以和视图层进行交互。
-     * @supported weapp, h5, harmony_hybrid
+     * @supported weapp, h5, harmony_hybrid, harmony
      */
     useReady(callback: () => void): void
 
@@ -133,6 +133,12 @@ declare module '../index' {
      */
     useOptionMenuClick(callback: () => void): void
 
+    /**
+     * 键盘高度变化时的回调。
+     * @supported alipay
+     */
+    useKeyboardHeight(callback: (payload: { height: number }) => void): void
+
     /**
      * 下拉中断时的回调。
      * @supported alipay, h5, harmony_hybrid

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

@@ -121,13 +121,13 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 显示 tabBar 某一项的右上角的红点
-     * @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/tab-bar/wx.showTabBarRedDot.html
      */
     showTabBarRedDot(option: showTabBarRedDot.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 显示 tabBar
-     * @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/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, harmony_hybrid
+     * @supported weapp, h5, rn, tt, 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, harmony_hybrid
+     * @supported weapp, h5, rn, tt, 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, harmony_hybrid
+     * @supported weapp, h5, rn, tt, 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, harmony_hybrid
+     * @supported weapp, h5, rn, tt, 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, harmony_hybrid
+     * @supported weapp, h5, rn, tt, 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/compile/config/h5.d.ts

@@ -6,6 +6,7 @@ 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'
+import type { ServerOptions as ViteServerOptions } from 'vite'
 
 export interface IH5RouterConfig {
   /** 配置路由模式 */
@@ -51,7 +52,8 @@ export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
   router?: IH5RouterConfig
 
   /** 预览服务的配置，可以更改端口等参数。具体配置参考 [webpack-dev-server](https://webpack.js.org/configuration/dev-server) */
-  devServer?: webpackDevServer.Configuration
+  // 修改后：同时支持 Webpack 和 Vite
+  devServer?: T extends 'vite' ? ViteServerOptions : webpackDevServer.Configuration
 
   /** 用于控制是否生成 js、css 对应的 sourceMap (默认值：watch 模式下为 true，否则为 false) */
   enableSourceMap?: boolean
@@ -119,8 +121,9 @@ export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
 
   /** Web 编译过程的相关配置 */
   compile?: {
-    exclude?: (string | RegExp)[]
-    include?: (string | RegExp)[]
+    exclude?: any[]
+    include?: any[]
+    /** 对应 @rollup/plugin-babel 插件的 filter 配置。只在 vite 编译模式下有效 */
     filter?: (filename: string) => boolean
   }
   /** 生成的代码是否要兼容旧版浏览器，值为 true 时，会去读取 package.json 的 browserslist 字段。只在 vite 编译模式下有效 */

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

@@ -91,8 +91,9 @@ export interface IMiniAppConfig<T extends CompilerTypes = CompilerWebpackTypes>
 
   /** 小程序编译过程的相关配置 */
   compile?: {
-    exclude?: (string | RegExp)[]
-    include?: (string | RegExp)[]
+    exclude?: any[]
+    include?: any[]
+    /** 对应 @rollup/plugin-babel 插件的 filter 配置。只在 vite 编译模式下有效 */
     filter?: (filename: string) => boolean
   }
 

package/types/compile/viteCompilerContext.d.ts

@@ -9,6 +9,7 @@ import type { AppConfig, PageConfig } from '../index'
 
 export interface ViteNativeCompMeta {
   name: string
+  exportName: string
   scriptPath: string
   configPath: string
   config: PageConfig
@@ -16,6 +17,7 @@ export interface ViteNativeCompMeta {
   templatePath: string
   cssPath?: string
   isPackage?: boolean
+  isGenerated?: boolean
 }
 
 export interface ViteFileType {
@@ -57,6 +59,7 @@ export interface ViteHarmonyBuildConfig extends CommonBuildConfig, IHarmonyConfi
   runtimePath?: string | string[]
   isPure?: boolean
   taroComponentsPath: string
+  cssVariables?: boolean  // 是否动态解析css变量
 }
 
 export interface CommonBuildConfig extends IProjectConfig<'vite'> {
@@ -109,6 +112,7 @@ export interface ViteCompilerContext<T> {
   configFileList: string[]
   compilePage: (pageName: string) => VitePageMeta
   watchConfigFile: (rollupCtx: PluginContext) => void
+  collectedDeps: (rollupCtx: PluginContext, id: string, filter, cache: Set<string> = new Set()) => Promise<Set<string>>
   getAppScriptPath: () => string
   getApp: () => ViteAppMeta
   getPages: () => VitePageMeta[]
@@ -140,7 +144,9 @@ export interface ViteHarmonyCompilerContext extends ViteCompilerContext<ViteHarm
   getCommonChunks: () => string[]
   modifyHarmonyConfig: (config: Partial<AppConfig>) => void
   modifyHostPackage: (deps?: Record<string, string>, devDeps?: Record<string, string>) => Exclude<IHarmonyConfig['ohPackage'], void>
-  collectNativeComponents: (meta: ViteAppMeta | VitePageMeta | ViteNativeCompMeta) => void
+  resolvePageImportPath: (scriptPath: string, pageName: string) => string
+  collectNativeComponents: (meta: ViteAppMeta | VitePageMeta | ViteNativeCompMeta) => ViteNativeCompMeta[]
+  generateNativeComponent: (rollupCtx: PluginContext, meta: ViteNativeCompMeta, implicitlyLoadedAfterOneOf: string[] = []) => void
   getScriptPath: (filePath: string) => string
   getStylePath: (filePath: string) => string
   getConfigPath: (filePath: string) => string
@@ -151,7 +157,9 @@ export interface ViteMiniCompilerContext extends ViteCompilerContext<ViteMiniBui
   commonChunks: string[]
   nativeComponents : Map<string, ViteNativeCompMeta>
   getCommonChunks: () => string[]
-  collectNativeComponents: (meta: ViteAppMeta | VitePageMeta | ViteNativeCompMeta) => void
+  resolvePageImportPath: (scriptPath: string, pageName: string) => string
+  collectNativeComponents: (meta: ViteAppMeta | VitePageMeta | ViteNativeCompMeta) => ViteNativeCompMeta[]
+  generateNativeComponent: (rollupCtx: PluginContext, meta: ViteNativeCompMeta, implicitlyLoadedAfterOneOf: string[] = []) => void
   getScriptPath: (filePath: string) => string
   getTemplatePath: (filePath: string) => string
   getStylePath: (filePath: string) => string

package/types/global.d.ts

@@ -410,6 +410,7 @@ declare namespace TaroGeneral {
 
   // ENV_TYPE
   enum ENV_TYPE {
+    ASCF = 'ASCF',
     WEAPP = 'WEAPP',
     SWAN = 'SWAN',
     ALIPAY = 'ALIPAY',

package/types/index.d.ts

@@ -192,4 +192,5 @@ declare namespace Taro {
 declare global {
   const defineAppConfig: (config: Taro.AppConfig) => Taro.AppConfig
   const definePageConfig: (config: Taro.PageConfig) => Taro.Config
+  const importNativeComponent: <T> (path: string, name = '', exportName = 'default') => Awaited<T>
 }

package/types/taro.component.d.ts

@@ -45,6 +45,8 @@ declare module './index' {
     eh?(event: MpEvent): void
     onLoad(options: Record<string, unknown>): void
     onOptionMenuClick?(): void
+    /** 键盘高度变化时触发 @supported alipay */
+    onKeyboardHeight?(opt: { height: number; }): void
     onPageScroll?(opt: PageScrollObject): void
     onPopMenuClick?(): void
     onPullDownRefresh?(): void
@@ -130,6 +132,26 @@ declare module './index' {
       /** 是否返回变更的 data 字段信息 */
       withDataPaths?: boolean
     }, listener: () => void): void
+    /**
+     * 绑定由 worklet 驱动的样式到相应的节点
+     * @param selector 节点选择器
+     * @param updater worklet 样式更新函数
+     * @param config 配置项
+     * @param callback 完成样式绑定的回调
+     * */
+    applyAnimatedStyle?(selector: string, updater: TaroGeneral.TFunc, config?: {
+      /** 是否立即执行一次 updater 函数 */
+      immediate?: boolean
+      /** 刷新时机，枚举值 async / sync */
+      flush?: string
+    }, callback?: TaroGeneral.TFunc): void
+    /**
+     * 清除节点上 worklet 驱动样式的绑定关系
+     * @param selector 节点选择器
+     * @param styleIds 需要清除的 styleId 集合
+     * @param callback 清除样式绑定的回调
+     * */
+    clearAnimatedStyle?(selector: string, styleIds: Array<Number>, callback?: TaroGeneral.TFunc): void
   }
   interface PageInstance extends PageLifeCycle, ComponentInstance {
     /** 页面配置 */

package/types/taro.config.d.ts

@@ -193,7 +193,7 @@ declare module './index' {
     /** 页面自定义组件配置
      * @see https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/
      */
-    usingComponents?: Record<string, string>
+    usingComponents?: Record<string, string | [string, string]>
     /** 指定使用升级后的 weui 样式
      * - v2: 可表明启用新版的组件样式
      * @default default
@@ -581,7 +581,7 @@ declare module './index' {
       desc: string
       /** 在该场景下打开小程序时跳转页面 */
       path: string
-    }
+    }[]
     /** 定制化型服务商票据 */
     serviceProviderTicket?: string
     /** 半屏小程序 appId */