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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "4.0.8-beta.1",
+  "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.1",
-    "@tarojs/runtime": "4.0.8-beta.1"
+    "@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.1",
-    "@tarojs/helper": "4.0.8-beta.1",
-    "@tarojs/shared": "4.0.8-beta.1"
+    "@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/shared": "4.0.8-beta.1",
-    "@tarojs/components": "4.0.8-beta.1",
-    "@tarojs/helper": "4.0.8-beta.1"
+    "@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

@@ -220,7 +220,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面
-     * @supported weapp, h5, rn, tt, harmony, harmony_hybrid
+     * @supported weapp, h5, rn, tt, harmony_hybrid
      * @example
      * ```json
      * {

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

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

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 */