@tarojs/taro 3.6.9-alpha.3 → 3.6.9-alpha.5

package/package.json

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

package/types/api/ai/inference.d.ts

@@ -0,0 +1,133 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace getInferenceEnvInfo {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** AI推理引擎版本*/
+      ver: string
+    }
+  }
+
+  namespace createInferenceSession {
+    interface Option {
+      /** 模型文件路径，目前只执行后缀为.onnx格式(支持代码包路径，和本地文件系统路径） */
+      model: string
+      /** 推理精度，有效值为 0 - 4。
+       * 一般来说，使用的precesionLevel等级越低，推理速度越快，但可能会损失精度。
+       * 推荐开发者在开发时，在效果满足需求时优先使用更低精度以提高推理速度，节约能耗。
+       */
+      precesionLevel?: PrecesionLevel
+      /** 是否生成量化模型推理 */
+      allowQuantize?: boolean
+      /** 是否使用NPU推理，仅对IOS有效 */
+      allowNPU?: boolean
+      /** 输入典型分辨率 */
+      typicalShape?: boolean
+    }
+
+    interface PrecesionLevel {
+      /** 使用fp16 存储浮点，fp16计算，Winograd 算法也采取fp16 计算，开启近似math计算 */
+      0
+      /** 使用fp16 存储浮点，fp16计算，禁用 Winograd 算法，开启近似math计算 */
+      1
+      /** 使用fp16 存储浮点，fp32计算，开启 Winograd，开启近似math计算 */
+      2
+      /** 使用fp32 存储浮点，fp32计算，开启 Winograd，开启近似math计算 */
+      3
+      /** 使用fp32 存储浮点，fp32计算，开启 Winograd，关闭近似math计算 */
+      4
+    }
+  }
+
+  interface InferenceSession {
+    /** 销毁 InferenceSession 实例
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/inference/InferenceSession.destroy.html
+     */
+    destroy(): void
+    /** 取消监听模型加载失败事件. 传入指定回调函数则只取消指定回调，不传则取消所有回调
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/inference/InferenceSession.offError.html
+     */
+    offError(callback?: InferenceSession.OffErrorCallback): void
+    /** 取消监听模型加载完成事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/inference/InferenceSession.offLoad.html
+     */
+    offLoad(callback?: InferenceSession.OffLoadCallback): void
+    /** 监听模型加载失败事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/inference/InferenceSession.onError.html
+     */
+    onError(callback: InferenceSession.OnLoadCallback): void
+    /** 监听模型加载完成事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/inference/InferenceSession.onLoad.html
+     */
+    onLoad(callback: InferenceSession.OnLoadCallback): void
+    /** 运行推断
+     * 需要在 session.onLoad 回调后使用。接口参数为 Tensors 对象，返回 Promise。
+     * 一个 InferenceSession 被创建完成后可以重复多次调用 InferenceSession.run(), 直到调用 session.destroy() 进行销毁。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/inference/InferenceSession.destroy.html
+     */
+    run(option: InferenceSession.Tensors): Promise<InferenceSession.Tensors>
+  }
+
+  namespace InferenceSession {
+    interface Type {
+      'uint8'
+      'int8'
+      'uint32'
+      'int32'
+      'float32'
+    }
+    interface Tensor {
+      /** Tensor shape （Tensor 形状，例如 [1, 3, 224, 224] 即表示一个4唯Tensor，每个维度的长度分别为1, 3, 224, 224） */
+      shape: number[]
+      /** Tensor 值，一段 ArrayBuffer */
+      data: ArrayBuffer
+      /** ArrayBuffer 值的类型，合法值有 uint8, int8, uint32, int32, float32 */
+      type: keyof Type
+    }
+
+    interface Tensors  {
+      [key: string]: Tensor
+    }
+
+    /** 模型加载失败回调函数。*/
+    type OffErrorCallback = (res: TaroGeneral.CallbackResult) => void
+    /** 模型加载完成回调函数 */
+    type OffLoadCallback = (res: TaroGeneral.CallbackResult) => void
+    /** 模型加载失败回调函数 */
+    type OnLoadCallback = (res: TaroGeneral.CallbackResult) => void
+    /** 模型加载完成回调函数 */
+    type OnLoadCallback = (res: TaroGeneral.CallbackResult) => void
+  }
+
+  interface TaroStatic {
+    /** 获取通用AI推理引擎版本
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/inference/wx.getInferenceEnvInfo.html
+     */
+    getInferenceEnvInfo(
+      option: getInferenceEnvInfo.Option
+    ): void
+
+    /** 创建 AI 推理 Session
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/inference/wx.createInferenceSession.html
+     */
+    createInferenceSession(
+      option: createInferenceSession.Option
+    ): InferenceSession
+  }
+}

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

@@ -155,6 +155,52 @@ declare module '../../index' {
     }
   }
 
+  namespace preloadWebview {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  namespace preloadSkylineView {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  namespace preloadAssets {
+    interface AssetsObjectType {
+      /** 字体 */
+      font
+      /** 图片 */
+      image
+    }
+    interface AssetsObject {
+      /** 类型 */
+      type: keyof AssetsObjectType
+      /** 资源地址 */
+      src: string
+    }
+    interface Option {
+      data: AssetsObjectType[]
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+  }
+
   interface TaroStatic {
     /** 小程序测速上报。使用前，需要在小程序管理后台配置。 详情参见[小程序测速](https://developers.weixin.qq.com/miniprogram/dev/framework/performanceReport/index.html)指南。
      * @supported weapp
@@ -174,6 +220,23 @@ declare module '../../index' {
       dimensions?: string | string[],
     ): void
 
+    /** 预加载下个页面的 WebView
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadWebview.html 
+     */
+    preloadWebview(option: preloadWebview.Option): Promise<TaroGeneral.CallbackResult>
+
+    /**预加载下个页面所需要的 Skyline 运行环境
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadSkylineView.html 
+     */
+    preloadSkylineView(option: preloadSkylineView.Option): Promise<TaroGeneral.CallbackResult>
+
+    /** 为视图层预加载媒体资源文件, 目前支持：font，image
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadAssets.html 
+     */
+    preloadAssets(option: preloadAssets.Option): Promise<TaroGeneral.CallbackResult>
     /** 小程序测速上报。使用前，需要在小程序管理后台配置。 详情参见[小程序测速](https://developers.weixin.qq.com/miniprogram/dev/framework/performanceReport/index.html)指南。
      * 
      * **注意**

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

@@ -351,6 +351,50 @@ declare module '../../index' {
     }
   }
 
+  namespace getSkylineInfoSync {
+    interface Result {
+      /** 当前运行环境是否支持 Skyline 渲染引擎 */
+      isSupported: boolean
+      /** 当前运行环境 Skyline 渲染引擎 的版本号，形如 0.9.7 */
+      version: string
+      /** 当前运行环境不支持 Skyline 渲染引擎 的原因，仅在 isSupported 为 false 时出现  */
+      reason?: string
+    }
+  }
+
+  namespace getSkylineInfo {
+    interface Option {
+      /** 接口调用成功的回调函数 */
+      success?: (res: Result) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult | Result) => void
+    }
+    interface Result {
+      /** 当前运行环境是否支持 Skyline 渲染引擎 */
+      isSupported: boolean
+      /** 当前运行环境 Skyline 渲染引擎 的版本号，形如 0.9.7 */
+      version: string
+      /** 当前运行环境不支持 Skyline 渲染引擎 的原因，仅在 isSupported 为 false 时出现  */
+      reason?: string
+    }
+  }
+
+  namespace getRendererUserAgent {
+    interface Option {
+      /** 接口调用成功的回调函数 */
+      success?: (res: Result) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult | Result) => void
+    }
+    interface Result {
+      userAgent: string
+    }
+  }
+
   namespace getDeviceInfo {
     interface Result {
       /** 应用二进制接口类型（仅 Android 支持） */
@@ -575,6 +619,27 @@ declare module '../../index' {
      */
     getSystemInfo(res?: getSystemInfo.Option): Promise<getSystemInfo.Result>
 
+    /** 获取当前运行环境对于 Skyline 渲染引擎 的支持情况
+     *  基础库 2.26.2 开始支持
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/system/wx.getSkylineInfoSync.html
+     */
+    getSkylineInfoSync(): getSkylineInfoSync.Result
+
+    /** 获取当前运行环境对于 Skyline 渲染引擎 的支持情况
+     *  基础库 2.26.2 开始支持
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/system/wx.getSkylineInfo.html
+     */
+    getSkylineInfo(option?: getSkylineInfo.Option): Promise<getSkylineInfo.Result>
+
+    /** 获取 Webview 小程序的 UserAgent
+     *  基础库 2.26.3 开始支持
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/system/wx.getRendererUserAgent.html
+     */
+    getRendererUserAgent(option?: getRendererUserAgent.Option): Promise<getRendererUserAgent.Result>
+
     /** 获取设备基础信息
      * @supported weapp, h5
      * @h5 不支持 abi、benchmarkLevel

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

@@ -53,6 +53,41 @@ declare module '../../index' {
     ) => void
   }
 
+  namespace onScreenRecordingStateChanged {
+    interface ScreenRecordingState {
+      /** 开始录屏 */
+      start
+      /** 结束录屏 */
+      stop
+    }
+    /** 用户录屏事件的监听函数 */
+    type Callback = (
+      /** 录屏状态 */
+      state: keyof ScreenRecordingState,
+    ) => void
+  }
+
+  namespace getScreenRecordingState {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (option: SuccessCallbackResult) => void
+    }
+    interface ScreenRecordingState {
+      /** 开始录屏 */
+      start
+      /** 结束录屏 */
+      stop
+    }
+    interface SuccessCallbackResult {
+      /** 录屏状态 */
+      state: keyof ScreenRecordingState
+    }
+  }
+
   namespace getScreenBrightness {
     interface Option {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
@@ -116,6 +151,15 @@ declare module '../../index' {
       callback: onUserCaptureScreen.Callback,
     ): void
 
+    /** 监听用户录屏事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/screen/wx.onScreenRecordingStateChanged.html
+     */
+    onScreenRecordingStateChanged(
+      /** 用户录屏事件的监听函数 */
+      callback: onScreenRecordingStateChanged.Callback
+    ): void
+
     /** 用户主动截屏事件。取消事件监听。
      * @supported weapp, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/screen/wx.offUserCaptureScreen.html
@@ -125,6 +169,23 @@ declare module '../../index' {
       callback: onUserCaptureScreen.Callback,
     ): void
 
+    /** 取消用户录屏事件的监听函数
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/screen/wx.offScreenRecordingStateChanged.html 
+     */
+    offScreenRecordingStateChanged(
+      /** 用户录屏事件的监听函数 */
+      callback: onScreenRecordingStateChanged.Callback
+    ): void
+
+    /** 查询用户是否在录屏
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/screen/wx.getScreenRecordingState.html
+     */
+    getScreenRecordingState(
+      option?: getScreenRecordingState.Option
+    ): Promise<getScreenRecordingState.SuccessCallbackResult>
+
     /**
      * 获取屏幕亮度。
      *

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

@@ -0,0 +1,26 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace sendSms {
+    interface Option {
+      /** 预填到发送短信面板的手机号 */
+      phoneNumber?: string
+      /** 预填到发送短信面板的内容 */
+      content?: string
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  interface TaroStatic {
+    /** 拉起手机发送短信界面
+     * @supported weap
+     * @see declare module '../../index' 
+     */
+    sendSms(option: sendSms.Option): Promise<TaroGeneral.CallbackResul>
+  }
+}

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

@@ -202,6 +202,98 @@ declare module '../../index' {
     }
   }
 
+  namespace join1v1Chat {
+    interface Caller {
+      /** 昵称 */
+      nickname: string
+      /** 头像 */
+      headImage?: string
+      /** 小程序内 openid */
+      openid: string
+    }
+    interface Listener {
+      /** 昵称 */
+      nickname: string
+      /** 头像 */
+      headImage?: string
+      /** 小程序内 openid */
+      openid: string
+    }
+    interface RoomType {
+      /** 语音通话 */
+      voice
+      /** 视频通话 */
+      video
+    }
+    interface Option {
+      /** 呼叫方信息 */
+      caller: Caller
+      /** 接听方信息 */
+      listener: Listener
+      /** 窗口背景色
+       * @default 0
+       */
+      backgroundType?: keyof setEnable1v1Chat.ColorType
+      /** 通话类型 */
+      roomType?: keyof RoomType
+      /** 小窗样式
+       * @default 1
+       */
+      minWindowType?: keyof setEnable1v1Chat.ColorType
+      /** 不允许切换到语音通话
+       * @default false
+       */
+      disableSwitchVoice?: boolean
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+    interface ChatErrCode {
+      /** 未开通双人通话 */
+      [-20000]
+      /** 当前设备不支持 */
+      [-20001]
+      /** 正在通话中 */
+      [-20002]
+      /** 其它小程序正在通话中 */
+      [-20003]
+      /** 内部系统错误 */
+      [-30000]
+      /** 微信缺失相机权限 */
+      [-30001]
+      /** 微信缺失录音权限  */
+      [-30002]
+      /** 小程序缺失录音权限 */
+      [-30003]
+      /** 小程序缺失相机权限 */
+      [-30004]
+      /** 当前已在房间内 */
+      [-1]
+      /** 录音设备被占用，可能是当前正在使用微信内语音通话或系统通话 */
+      [-2]
+      /** 加入会话期间退出（可能是用户主动退出，或者退后台、来电等原因），因此加入失败 */
+      [-3]
+      /** 系统错误 */
+      [-1000]
+    }
+    interface FailCallbackResult extends TaroGeneral.CallbackResult {
+      /** 错误信息 */
+      errMsg: string
+      /** 错误码 */
+      errCode: keyof ChatErrCode
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 错误码 */
+      errCode: number
+      /** 调用结果 */
+      errMsg: string
+    }
+    type Promised = FailCallbackResult | SuccessCallbackResult
+  }
+
   namespace exitVoIPChat {
     interface Option {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
@@ -264,6 +356,12 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/voip/wx.offVoIPChatStateChanged.html
      */
     offVoIPChatStateChanged(callback: onVoIPChatStateChanged.Callback): void
+    /**
+     * 取消监听实时语音通话成员通话状态变化事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/voip/wx.offVoIPChatSpeakersChanged.html
+     */
+    offVoIPChatSpeakersChanged(callback: onVoIPChatSpeakersChanged.Callback): void
     /** 取消监听实时语音通话成员在线状态变化事件
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/voip/wx.offVoIPChatMembersChanged.html
@@ -281,6 +379,11 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/voip/wx.joinVoIPChat.html
      */
     joinVoIPChat(option: joinVoIPChat.Option): Promise<joinVoIPChat.Promised>
+    /**加入（创建）双人通话
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/voip/wx.join1v1Chat.html
+     */
+    join1v1Chat(option: join1v1Chat.Option): Promise<join1v1Chat.Promised>
     /** 退出（销毁）实时语音通话
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/voip/wx.exitVoIPChat.html

package/types/api/open-api/channels.d.ts

@@ -68,6 +68,31 @@ declare module '../../index' {
     }
   }
 
+  namespace getChannelsShareKey {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 分享者 openid  */
+      sharerOpenId: string
+      /** 推广员 */
+      promoter: Promoter
+    }
+    interface Promoter {
+      /** 推广员昵称 */
+      finderNickname: string
+      /** 推广员id */
+      promoterId: string
+      /** 推广员openid */
+      promoterOpenId: string
+    }
+  }
+
   namespace getChannelsLiveNoticeInfo {
     interface Option {
       /** 视频号 id，以“sph”开头的id，可在视频号助手获取 */
@@ -164,6 +189,12 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/channels/wx.openChannelsActivity.html
      */
     openChannelsActivity(option?: openChannelsActivity.Option): Promise<TaroGeneral.CallbackResult>
+    /** 获取视频号直播卡片/视频卡片的分享来源，
+     * 仅当卡片携带了分享信息、同时用户已授权该小程序获取视频号分享信息且启动场景值为 1177、1184、1195、1208 时可用
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/channels/wx.getChannelsShareKey.html
+     */
+    getChannelsShareKey(option?: getChannelsShareKey.Option): Promise<getChannelsShareKey.SuccessCallbackResult>
     /** 获取视频号直播预告信息
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/channels/wx.getChannelsLiveNoticeInfo.html

package/types/api/open-api/device-voip.d.ts

@@ -0,0 +1,63 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace requestDeviceVoIP {
+    interface Option {
+      /** 设备唯一序列号。由厂商分配，长度不能超过128字节。字符只接受数字，大小写字母，下划线（_）和连字符（-） */
+      sn: string
+      /** 设备票据，5分钟内有效 */
+      snTicket: string
+      /** 设备型号 id。通过微信公众平台注册设备获得。 */
+      modelId: string
+      /** 设备名称，将显示在授权弹窗内（长度不超过13）。授权框中「设备名字」= 「deviceName」 + 「modelId 对应设备型号」 */
+      deviceName: string
+      /** 是否为授权设备组，默认 false */
+      isGroup?: boolean
+      /** 设备组的唯一标识 id 。isGroup 为 true 时只需要传该参数，isGroup 为 false 时不需要传该参数，但需要传 sn、snTicket、modelId、deviceName 。 */
+      groupId: string
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+  }
+
+  namespace getDeviceVoIPList {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      list: DeviceVoIP[]
+    }
+    interface DeviceVoIP {
+      /** 设备唯一序列号。（仅单台设备时） */
+      sn: string
+      /** 设备型号 id。通过微信公众平台注册设备获得。（仅单台设备时）	 */
+      model_id: string
+      /** 设备组的唯一标识 id（仅设备组时）  */
+      group_id: string
+      /** 设备（组）授权状态。0：未授权；1：已授权  */
+      status: number
+    }
+  }
+
+  interface TaroStatic {
+    /** 请求用户授权与设备（组）间进行音视频通话
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/device-voip/wx.requestDeviceVoIP.html
+     */
+    requestDeviceVoIP(option: requestDeviceVoIP.Option): Promise<TaroGeneral.CallbackResult>
+    /** 查询当前用户授权的音视频通话设备（组）信息
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/open-api/device-voip/wx.getDeviceVoIPList.html
+     */
+    getDeviceVoIPList(option: getDeviceVoIPList.Option): Promise<getDeviceVoIPList.SuccessCallbackResult>
+  }
+}

package/types/api/storage/cache-manager.d.ts

@@ -0,0 +1,198 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  interface CacheManager {
+    /** 添加规则
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.addRule.html
+     */
+    addRule(option: CacheManager.AddRuleOption): string
+    /** 批量添加规则
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.addRules.html
+     */
+    addRules(option: CacheManager.AddRulesOption): string[]
+    /** 清空所有缓存
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.clearCaches.html
+     */
+    clearCaches(): void
+    /** 清空所有规则，同时会删除对应规则下所有缓存
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.clearRules.html
+     */
+    clearRules(): void
+    /** 删除缓存
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.deleteCache.html
+     */
+    deleteCache( 
+      /** 缓存 id */
+      id: string
+    ): void
+    /** 批量删除缓存
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.deleteCaches.html
+     */
+    deleteCaches(
+      /** 缓存 id 列表 */
+      ids: string[]
+    ): void
+    /** 删除规则，同时会删除对应规则下所有缓存
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.deleteRule.html 
+     */
+    deleteRule(
+      /** 规则 id */
+      id: string
+    ): void
+    /** 批量删除规则，同时会删除对应规则下所有缓存
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.deleteRules.html
+     */
+    deleteRules(
+      /** 规则 id 列表 */
+      ids: string[]
+    ): void
+    /** 匹配命中的缓存规则，一般需要和 request 事件搭配使用
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.match.html
+     */
+    match(option: CacheManager.MatchOption): CacheManager.MatchResult
+    /** 取消事件监听
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.off.html
+     */
+    off(
+      /** 事件名称 */
+      eventName: string,
+      /** 事件监听函数 */
+      handler: Function
+    ): void
+    /** 监听事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.on.html
+     */
+    on( 
+      /** 事件名称 */
+      eventName: keyof CacheManager.OnEventName,
+      /** 事件监听函数 */
+      handler: Function
+    ): void
+    /** 开启缓存，仅在 mode 为 none 时生效，调用后缓存管理器的 state 会置为 1
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.start.html
+     */
+    start(): void
+    /** 关闭缓存，仅在 mode 为 none 时生效，调用后缓存管理器的 state 会置为 0
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.stop.html
+     */
+    stop(): void
+  }
+
+  namespace CacheManager {
+    interface DataSchema {
+      /** 需要匹配的 data 对象的参数类型
+       * string、number、boolean、null、object、any（表示任意类型），
+       * 同时支持数组模式（数组模式则在类型后面加 []，如 string[] 表示字符串数组）
+       */
+      type: string
+      /** 需要匹配的 data 对象的参数值
+       * 当 type 为基本类型时，可以用 string/regexp 来匹配固定的值，
+       * 也可以通过 function 来确定值是否匹配，
+       * 如果传入的 type 是 object，那么表示需要嵌套匹配值是否正确，可以传入 Array
+       */
+      value?: string | RegExp | Function | DataRule[]
+    }
+    interface DataRule {
+      /** 需要匹配的参数名 */
+      name: string
+      schema: DataSchema | DataSchema[]
+    }
+    interface RuleObject {
+      /** 规则 id，如果不填则会由基础库生成  */
+      id: string
+      /** 请求方法，可选值 GET/POST/PATCH/PUT/DELETE，如果为空则表示前面提到的所有方法都能被匹配到  */
+      method: string
+      /** uri 匹配规则，可参考规则字符串写法和正则写法 */
+      url: any
+      /** 
+       * 缓存有效时间，单位为 ms，不填则默认取缓存管理器全局的缓存有效时间
+       * @default 7 * 24 * 60 * 60 * 1000
+       */
+      maxAge: number
+      /**
+       * 匹配请求参数
+       */
+      dataSchema: DataRule[]
+    }
+
+    type Rule = string | RegExp | RuleObject
+
+    interface AddRuleOption {
+      /** 规则 */
+      rule: Rule
+    }
+    interface AddRulesOption {
+      rules: Rule[]
+    }
+    interface MatchOption {
+      /** request 事件对象  */
+      evt: any
+    }
+    interface MatchResult {
+      /** 命中的规则id */
+      ruleId: string
+      /** 缓存id */
+      cacheId: string
+      /** 缓存内容，会带有 fromCache 标记，方便开发者区分内容是否来自缓存 */
+      data: any
+      /** 缓存创建时间 */
+      createTime: number
+      /** 缓存有效时间 */
+      maxAge: number
+    }
+    interface OnEventName {
+      /** 发生 wx.request 请求，只在缓存管理器开启阶段会触发 */
+      request
+      /** 进入弱网/离线状态 */
+      enterWeakNetwork
+      /** 离开弱网/离线状态	 */
+      exitWeakNetwork
+    }
+  }
+
+  namespace createCacheManager {
+    interface Mode {
+      /** 弱网/离线使用缓存返回 */
+      weakNetwork
+      /** 总是使用缓存返回 */
+      always
+      /** 不开启，后续可手动开启/停止使用缓存返回 */
+      none
+    }
+    interface Extra {
+      /** 需要缓存的 wx api 接口，不传则表示支持缓存的接口全都做缓存处理。返回的如果是缓存数据，开发者可通过 fromCache 标记区分 */
+      apiList?: string[]
+    }
+    interface Option {
+      /** 全局 origin */
+      origin?: string
+      /** 缓存模式 */
+      mode?: keyof Mode
+      /** 全局缓存有效时间，单位为毫秒，默认为 7 天，最长不超过 30 天  */
+      maxAge?: number
+      /** 额外的缓存处理 */
+      extra?: Extra
+    }
+  }
+
+  interface TaroStatic {
+    /** 拉起手机发送短信界面
+     * @supported weap
+     * @see declare module '../../index' 
+     */
+    createCacheManager(option: createCacheManager.Option): CacheManager
+  }
+}

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

@@ -11,13 +11,32 @@ import { IRNConfig } from './rn'
 export type PluginItem = string | [string, object] | [string, () => object | Promise<object>]
 
 interface ICache {
+  /**
+   * 是否开启持久化缓存 (默认值 false)
+   * @description ```
+   * 值为 false 时：开发模式下 WebpackConfig.cache.type = 'memory'，而生产模式下 WebpackConfig.cache = false;
+   * 值为 true 时：开发模式和生产模式下均为 WebpackConfig.cache.type = 'filesystem'
+   * ```
+   */
   enable?: boolean
+
+  /**
+   * 当依赖的文件或该文件的依赖改变时，使缓存失效。
+   * @description  详详情请参考 [WebpackConfig.cache.buildDependencies](https://webpack.js.org/configuration/cache/#cachebuilddependencies)。
+   */
   buildDependencies?: Record<string, any>
+
+  /**
+   * 缓存子目录的名称 (默认值 process.env.NODE_ENV-process.env.TARO_ENV)
+   * @description  详情请参考 [WebpackConfig.cache.name](https://webpack.js.org/configuration/cache/#cachename)
+   */
   name?: string
 }
 
 interface ILogger {
+  /** 是否简化输出日志 (默认值 true)*/
   quiet: boolean
+  /** 是否输出 Webpack Stats 信息 (默认值 false) */
   stats: boolean
 }
 
@@ -44,13 +63,48 @@ export interface IProjectBaseConfig {
   /** 代码编译后的生产目录 (默认值：'dist') */
   outputRoot?: string
 
-  /** 用于设置环境变量 (除了NODE_ENV以外，其他环境变量建议在根目录下的.env文件中) */
+  /**
+   * 用于配置`process.env.xxxx`相关的环境变量
+   * @deprecated 建议使用根目录下的 .env 文件替代
+   * @description 注意：这里的环境变量只能在业务代码中使用，编译时的 node 环境中无法使用
+   * @example
+   * ```ts
+   * // config/index.ts
+   * export default defineConfig({
+   *    env: {
+   *      xxxx: '"测试"'
+   *    }
+   * })
+   *
+   * // src/app.ts
+   * onShow() {
+   *   console.log(process.env.xxxx) // 打印 "测试"
+   * }
+   * ```
+   */
   env?: IOption
 
   /** 用于配置目录别名，从而方便书写代码引用路径 */
   alias?: IOption
 
-  /** 用于配置一些全局变量供代码中进行使用（建议放在根目录下的.env文件中） */
+  /**
+   * 用于配置一些常量供代码中进行全局替换使用
+   * @description 注意：这里的环境变量只能在业务代码中使用，编译时的 node 环境中无法使用
+   * @example
+   * ```ts
+   * // config/index.ts
+   * export default defineConfig({
+   *    defineConstants: {
+   *        __TEST__: JSON.stringify('test')
+   *    }
+   * })
+   *
+   * // src/app.ts
+   * onShow() {
+   *   console.log(__TEST__) // 打印 "test"
+   * }
+   * ```
+   */
   defineConstants?: IOption
 
   /** 用于把文件从源码目录直接拷贝到编译后的生产目录 */
@@ -158,13 +212,48 @@ export interface IProjectConfig {
   /** 代码编译后的生产目录 (默认值：'dist') */
   outputRoot?: string
 
-  /** 用于设置环境变量 (除了NODE_ENV以外，其他环境变量建议在根目录下的.env文件中) */
+  /**
+   * 用于配置`process.env.xxxx`相关的环境变量
+   * @deprecated 建议使用根目录下的 .env 文件替代
+   * @description 注意：这里的环境变量只能在业务代码中使用，编译时的 node 环境中无法使用
+   * @example
+   * ```ts
+   * // config/index.ts
+   * export default defineConfig({
+   *    env: {
+   *      xxxx: '"测试"'
+   *    }
+   * })
+   *
+   * // src/app.ts
+   * onShow() {
+   *   console.log(process.env.xxxx) // 打印 "测试"
+   * }
+   * ```
+   */
   env?: IOption
 
   /** 用于配置目录别名，从而方便书写代码引用路径 */
   alias?: IOption
 
-  /** 用于配置一些全局变量供代码中进行使用（建议放在根目录下的.env文件中） */
+  /**
+   * 用于配置一些常量供代码中进行全局替换使用
+   * @description 注意：这里的环境变量只能在业务代码中使用，编译时的 node 环境中无法使用
+   * @example
+   * ```ts
+   * // config/index.ts
+   * export default defineConfig({
+   *    defineConstants: {
+   *        __TEST__: JSON.stringify('test')
+   *    }
+   * })
+   *
+   * // src/app.ts
+   * onShow() {
+   *   console.log(__TEST__) // 打印 "test"
+   * }
+   * ```
+   */
   defineConstants?: IOption
 
   /** 用于把文件从源码目录直接拷贝到编译后的生产目录 */

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

@@ -32,11 +32,15 @@ export interface IRNConfig {
     pxtransform?: {
       enable?: boolean
       /** 插件 pxtransform 配置项 */
-      config: ?{
+      config?: {
         additionalProperties?: boolean
         [key: string]: any
       }
-    }
+    },
+    cssModules?: {
+      enable: boolean
+    },
+    [key: string]: any
   }
 
   resolve?: any

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

@@ -1,3 +1,5 @@
+import { type Input } from 'postcss'
+
 export type Func = (...args: any[]) => any
 
 export type IOption = Record<string, any>
@@ -9,7 +11,9 @@ export type TogglableOptions<T = IOption> = {
 
 export namespace PostcssOption {
   export type cssModules = TogglableOptions<{
+    /** 转换模式，取值为 global/module */
     namingPattern: 'global' | string
+    /** 自定义生成的class名称规则 */
     generateScopedName: string | ((localName: string, absoluteFilePath: string) => string)
   }>
   export type url = TogglableOptions<{
@@ -18,11 +22,65 @@ export namespace PostcssOption {
   }>
 }
 
+export interface IHtmlTransformOption {
+  /** 是否启用 postcss-html-transform 插件 */
+  enable?: boolean
+  config?: {
+    /** 当前编译平台 (此选项插件内部根据编译平台自行生成，无需传入) */
+    readonly platform?: string
+    /** 设置是否去除 cursor 相关样式 (h5默认值：true) */
+    removeCursorStyle: boolean
+  }
+}
+
+export interface IPxTransformOption {
+  /** 设置 1px 是否需要被转换 */
+  onePxTransform?: boolean
+  /** REM 单位允许的小数位 */
+  unitPrecision?: number
+  /** 允许转换的属性列表 (默认 [*]) */
+  propList?: string[]
+  /** 黑名单里的选择器将会被忽略 */
+  selectorBlackList?: Array<string | RegExp>
+  /** 直接替换而不是追加一条进行覆盖 */
+  replace?: boolean
+  /** 允许媒体查询里的 px 单位转换 */
+  mediaQuery?: boolean
+  /** 设置一个可被转换的最小 px 值 */
+  minPixelValue?: number
+  /**
+   * 转换后的单位，可选值为 rpx、vw、rem，当前仅支持小程序 (默认 rpx) 和 Web 端 (默认 rem)
+   * @description Web 端使用 rem 单位时会注入脚本用于设置 body 上的 font-size 属性，其他单位无该操作
+   */
+  targetUnit?: 'rpx' | 'vw' | 'rem'
+  /**
+   * H5 字体尺寸大小基准值，开发者可以自行调整单位换算的基准值(默认20)
+   * @supported h5
+   */
+  baseFontSize?: number
+  /**
+   * H5 根节点 font-size 的最大值 (默认 40)
+   * @supported h5
+   */
+  maxRootSize?: number
+  /**
+   * H5 根节点 font-size 的最小值(默认 20)
+   * @supported h5
+   */
+  minRootSize?: number
+  /** 设计稿尺寸 */
+  designWidth?: number | ((size?: string | number | Input) => number)
+  /** 设计稿尺寸换算规则 */
+  deviceRatio?: TaroGeneral.TDeviceRatio
+}
+
 export interface IPostcssOption {
   autoprefixer?: TogglableOptions
-  pxtransform?: TogglableOptions
+  pxtransform?: TogglableOptions<IPxTransformOption>
   cssModules?: PostcssOption.cssModules
   url?: PostcssOption.url
+  /** 插件 postcss-html-transform 相关配置, 一般启用了 @tarojs/plugin-html 插件才配置 */
+  htmltransform?: IHtmlTransformOption
   [key: string]: any
 }
 
@@ -96,9 +154,9 @@ export const enum CONFIG_TYPES {
 }
 
 export type IMINI_APP_FILE_TYPE = {
-  TEMPL: TEMPLATE_TYPES,
-  STYLE: STYLE_TYPES,
-  SCRIPT: SCRIPT_TYPES,
+  TEMPL: TEMPLATE_TYPES
+  STYLE: STYLE_TYPES
+  SCRIPT: SCRIPT_TYPES
   CONFIG: CONFIG_TYPES
 }
 

package/types/index.d.ts

@@ -130,6 +130,8 @@
 /// <reference types="@tarojs/plugin-platform-swan/types/shims-swan" />
 /// <reference types="@tarojs/plugin-platform-tt/types/shims-tt" />
 /// <reference types="@tarojs/plugin-platform-weapp/types/shims-weapp" />
+/// <reference types="@tarojs/taro-h5/types/overlay" />
+/// <reference types="@tarojs/taro-rn/types/overlay" />
 
 export = Taro
 export as namespace Taro

package/types/taro.api.d.ts

@@ -41,6 +41,7 @@
 /// <reference path="api/payment/index.d.ts" />
 /// <reference path="api/storage/index.d.ts" />
 /// <reference path="api/storage/background-fetch.d.ts" />
+/// <reference path="api/storage/cache-manager.d.ts" />
 /// <reference path="api/data-analysis/index.d.ts" />
 /// <reference path="api/canvas/index.d.ts" />
 /// <reference path="api/media/map.d.ts" />
@@ -73,6 +74,7 @@
 /// <reference path="api/open-api/favorites.d.ts" />
 /// <reference path="api/open-api/license-plate.d.ts" />
 /// <reference path="api/open-api/channels.d.ts" />
+/// <reference path="api/open-api/device-voip.d.ts" />
 /// <reference path="api/open-api/group.d.ts" />
 /// <reference path="api/open-api/customer-service.d.ts" />
 /// <reference path="api/device/bluetooth.d.ts" />
@@ -88,6 +90,7 @@
 /// <reference path="api/device/clipboard.d.ts" />
 /// <reference path="api/device/network.d.ts" />
 /// <reference path="api/device/screen.d.ts" />
+/// <reference path="api/device/sms.d.ts" />
 /// <reference path="api/device/keyboard.d.ts" />
 /// <reference path="api/device/phone.d.ts" />
 /// <reference path="api/device/accelerometer.d.ts" />
@@ -99,6 +102,7 @@
 /// <reference path="api/device/vibrate.d.ts" />
 /// <reference path="api/ai/visionkit.d.ts" />
 /// <reference path="api/ai/face.d.ts" />
+/// <reference path="api/ai/inference.d.ts" />
 /// <reference path="api/worker/index.d.ts" />
 /// <reference path="api/wxml/index.d.ts" />
 /// <reference path="api/ext/index.d.ts" />