@tarojs/taro 3.4.0 → 3.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.4.0",
+  "version": "3.4.1",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -24,9 +24,9 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.4.0",
-    "@tarojs/runtime": "3.4.0",
-    "@tarojs/taro-h5": "3.4.0"
+    "@tarojs/api": "3.4.1",
+    "@tarojs/runtime": "3.4.1",
+    "@tarojs/taro-h5": "3.4.1"
   },
-  "gitHead": "a0e97bc937f878cc059f54748c9a3829fa3f4664"
+  "gitHead": "a2437215b1966fd0b6dd09311bcb4fd894a871d0"
 }

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

@@ -153,22 +153,16 @@ declare module '../../index' {
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/InnerAudioContext.html
    */
   interface InnerAudioContext {
+    /** 音频资源的地址，用于直接播放。 */
+    src: string
+    /** 开始播放的位置（单位：s）
+     * @default 0
+     */
+    startTime: number
     /** 是否自动开始播放
      * @default false
      */
     autoplay: boolean
-    /** 音频缓冲的时间点，仅保证当前播放时间点到此时间点内容已缓冲
-     * @readonly
-     */
-    buffered: number
-    /** 当前音频的播放位置（单位 s）。只有在当前有合法的 src 时返回，时间保留小数点后 6 位
-     * @readonly
-     */
-    currentTime: number
-    /** 当前音频的长度（单位 s）。只有在当前有合法的 src 时返回
-     * @readonly
-     */
-    duration: number
     /** 是否循环播放
      * @default false
      */
@@ -177,16 +171,6 @@ declare module '../../index' {
      * @default true
      */
     obeyMuteSwitch: boolean
-    /** 当前是是否暂停或停止状态
-     * @readonly
-     */
-    paused: boolean
-    /** 音频资源的地址，用于直接播放。 */
-    src: string
-    /** 开始播放的位置（单位：s）
-     * @default 0
-     */
-    startTime: number
     /** 音量。范围 0~1。
      * @default 1
      */
@@ -195,6 +179,24 @@ declare module '../../index' {
      * @default 1
      */
     playbackRate: number
+    /** 当前音频的长度（单位 s）。只有在当前有合法的 src 时返回
+     * @readonly
+     */
+    duration: number
+    /** 当前音频的播放位置（单位 s）。只有在当前有合法的 src 时返回，时间保留小数点后 6 位
+     * @readonly
+     */
+    currentTime: number
+    /** 当前是是否暂停或停止状态
+     * @readonly
+     */
+    paused: boolean
+    /** 音频缓冲的时间点，仅保证当前播放时间点到此时间点内容已缓冲
+     * @readonly
+     */
+    buffered: number
+    /** origin: 发送完整的 referrer; no-referrer: 不发送 */
+    referrerPolicy?: 'origin' | 'no-referrer' | string
     /** 播放 */
     play(): void
     /** 暂停 */

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

@@ -100,70 +100,76 @@ declare module '../../index' {
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/BackgroundAudioManager.html
    */
   interface BackgroundAudioManager {
-    /** 音频已缓冲的时间，仅保证当前播放时间点到此时间点内容已缓冲。
-     * @readonly
-     */
-    buffered: number
+    /** 音频的数据源（[2.2.3](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html) 开始支持云文件ID）。默认为空字符串，**当设置了新的 src 时，会自动开始播放**，目前支持的格式有 m4a, aac, mp3, wav。 */
+    src: string
+    /** 音频开始播放的位置（单位：s）。 */
+    startTime: number
+    /** 音频标题，用于原生音频播放器音频标题（必填）。原生音频播放器中的分享功能，分享出去的卡片标题，也将使用该值。 */
+    title: string
+    /** 专辑名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
+    epname: string
+    /** 歌手名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
+    singer: string
     /** 封面图 URL，用于做原生音频播放器背景图。原生音频播放器中的分享功能，分享出去的卡片配图及背景也将使用该图。 */
     coverImgUrl: string
-    /** 当前音频的播放位置（单位：s），只有在有合法 src 时返回。
-     * @readonly
+    /** 页面链接，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
+    webUrl: string
+    /** 音频协议。默认值为 'http'，设置 'hls' 可以支持播放 HLS 协议的直播音频。 */
+    protocol: string
+    /** 播放速度。范围 0.5-2.0。
+     * @default 1
      */
-    currentTime: number
+    playbackRate?: number
     /** 当前音频的长度（单位：s），只有在有合法 src 时返回。
      * @readonly
      */
     duration: number
-    /** 专辑名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
-    epname: string
+    /** 当前音频的播放位置（单位：s），只有在有合法 src 时返回。
+     * @readonly
+     */
+    currentTime: number
     /** 当前是否暂停或停止。
      * @readonly
      */
     paused: boolean
-    /** 音频协议。默认值为 'http'，设置 'hls' 可以支持播放 HLS 协议的直播音频。 */
-    protocol: string
-    /** 歌手名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
-    singer: string
-    /** 音频的数据源（[2.2.3](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html) 开始支持云文件ID）。默认为空字符串，**当设置了新的 src 时，会自动开始播放**，目前支持的格式有 m4a, aac, mp3, wav。 */
-    src: string
-    /** 音频开始播放的位置（单位：s）。 */
-    startTime: number
-    /** 音频标题，用于原生音频播放器音频标题（必填）。原生音频播放器中的分享功能，分享出去的卡片标题，也将使用该值。 */
-    title: string
-    /** 页面链接，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
-    webUrl: string
+    /** 音频已缓冲的时间，仅保证当前播放时间点到此时间点内容已缓冲。
+     * @readonly
+     */
+    buffered: number
+    /** origin: 发送完整的 referrer; no-referrer: 不发送 */
+    referrerPolicy?: 'origin' | 'no-referrer' | string
     /** 播放 */
     play(): void
     /** 暂停 */
     pause(): void
-    /** 停止 */
-    stop(): void
     /** 跳转到指定位置，单位 s */
     seek(position: any): void
+    /** 停止 */
+    stop(): void
     /** 背景音频进入可以播放状态，但不保证后面可以流畅播放 */
     onCanplay(callback?: () => void): void
+    /** 音频加载中事件，当音频因为数据不足，需要停下来加载时会触发 */
+    onWaiting(callback?: () => void): void
+    /** 背景音频播放错误事件 */
+    onError(callback?: () => void): void
     /** 背景音频播放事件 */
     onPlay(callback?: () => void): void
     /** 背景音频暂停事件 */
     onPause(callback?: () => void): void
-    /** 背景音频停止事件 */
-    onStop(callback?: () => void): void
+    /** 背景音频开始跳转操作事件 */
+    onSeeking(callback?: () => void): void
+    /** 背景音频完成跳转操作事件 */
+    onSeeked(callback?: () => void): void
     /** 背景音频自然播放结束事件 */
     onEnded(callback?: () => void): void
+    /** 背景音频停止事件 */
+    onStop(callback?: () => void): void
     /** 背景音频播放进度更新事件 */
     onTimeUpdate(callback?: () => void): void
     /** 用户在系统音乐播放面板点击上一曲事件（iOS only） */
     onPrev(callback?: () => void): void
     /** 用户在系统音乐播放面板点击下一曲事件（iOS only） */
     onNext(callback?: () => void): void
-    /** 背景音频播放错误事件 */
-    onError(callback?: () => void): void
-    /** 音频加载中事件，当音频因为数据不足，需要停下来加载时会触发 */
-    onWaiting(callback?: () => void): void
-    /** 背景音频开始跳转操作事件 */
-    onSeeking(callback?: () => void): void
-    /** 背景音频完成跳转操作事件 */
-    onSeeked(callback?: () => void): void
   }
 
   interface TaroStatic {

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

@@ -270,7 +270,7 @@ declare module '../../index' {
     previewImage(option: previewImage.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 预览图片和视频。
-     * @supported weapp 基础库 2.12.0 开始支持，低版本需做兼容处理。
+     * @supported weapp
      * @example
      * ```tsx
      * Taro.previewMedia({

package/types/api/open-api/customer-service.d.ts

@@ -29,7 +29,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 打开微信客服。了解更多信息，可以参考微信客服介绍：https://work.weixin.qq.com/kf/。
-     * @supported weapp 基础库 2.19.0 开始支持，低版本需做兼容处理。
+     * @supported weapp
      * @example
      * ```tsx
      * Taro.openCustomerServiceChat({

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

@@ -54,9 +54,7 @@ declare module '../../index' {
   }
 
   interface TaroStatic {
-    /**
-     * 退出当前小程序。必须有点击行为才能调用成功。
-     * 基础库 2.17.3 开始支持
+    /** 退出当前小程序。必须有点击行为才能调用成功。
      * @supported weapp
      * @example
      * ```tsx

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

@@ -141,6 +141,40 @@ declare module '../../index' {
     }
   }
 
+  /** `MediaQueryObserver` 对象，用于监听页面 media query 状态的变化，如界面的长宽是不是在某个指定的范围内。 */
+  interface MediaQueryObserver {
+    /** 开始监听页面 media query 变化情况 */
+    observe(descriptor: MediaQueryObserver.descriptor, callback: MediaQueryObserver.observeCallback): void
+    /** 停止监听。回调函数将不再触发 */
+    disconnect(): void
+  }
+
+  namespace MediaQueryObserver {
+    /** media query 描述符 */
+    interface descriptor {
+      /** 页面最小宽度 (单位: px) */
+      minWidth: number
+      /** 页面最大宽度 (单位: px) */
+      maxWidth: number
+      /** 页面宽度 (单位: px) */
+      width: number
+      /** 页面最小高度 (单位: px) */
+      minHeight: number
+      /** 页面最大高度（px 为单位） */
+      maxHeight: number
+      /** 页面高度（px 为单位） */
+      height: number
+      /** 屏幕方向 */
+      orientation: 'landscape' | 'portrait'
+    }
+
+    /** 监听 media query 状态变化的回调函数 */
+    type observeCallback = (res: {
+      /** 页面的当前状态是否满足所指定的 media query */
+      matches: boolean
+    }) => void
+  }
+
   /** 查询节点信息的对象
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.html
    */

package/types/taro.component.d.ts

@@ -23,29 +23,22 @@ declare module './index' {
     onTabItemTap?(obj: TabItemTapObject): void
     onResize?(obj: PageResizeObject): void
   }
-
   interface ComponentOptions {
     addGlobalClass?: boolean
     styleIsolation?: 'isolated' | 'apply-shared' | 'shared'
   }
-
   interface ComponentClass<P = {}, S = any> extends StaticLifecycle<P, S> {
     new (...args: any[]): Component<P, {}>
     propTypes?: any // TODO: Use prop-types type definition.
     defaultProps?: Partial<P>
     displayName?: string
   }
-
   // ref: packages/taro-runtime/src/current.ts
   interface RouterInfo<TParams extends Partial<Record<string, string>> = Partial<Record<string, string>>> {
-    /**
-     * 路由参数。
-     */
+    /** 路由参数 */
     params: TParams
 
-    /**
-     * 页面路径。
-     */
+    /** 页面路径 */
     path: string
 
     onReady: string
@@ -55,13 +48,10 @@ declare module './index' {
     shareTicket: string | undefined
     scene: number | undefined
   }
-
   interface Component<P = {}, S = {}, SS = any> extends ComponentLifecycle<P, S, SS> {
     $scope?: any
   }
-
   type PropsWithChildren<P> = P & { children?: React.ReactNode }
-
   interface FunctionComponent<P = {}> {
     (props: PropsWithChildren<P>, context?: any): React.ReactElement | null
     propTypes?: any // TODO: Use prop-types type definition.
@@ -70,13 +60,10 @@ declare module './index' {
     options?: ComponentOptions
     externalClasses?: string[]
   }
-
   type FC<P = {}> = FunctionComponent<P>
-
   interface StatelessFunctionComponent {
     (): JSX.Element
   }
-
   type SFC = StatelessFunctionComponent
 
   interface Show {
@@ -85,23 +72,19 @@ declare module './index' {
     onShow?(): void
     onHide?(): void
   }
-
   interface AppInstance extends Show {
     mount(component: React.ComponentClass | Vue.ComponentOptions<Vue>, id: string, cb: () => void): void
     componentDidShow?(options?: Record<string, unknown>): void
     onShow?(options?: Record<string, unknown>): void
     unmount(id: string, cb: () => void): void
   }
-
   type Target = Record<string, unknown> & { dataset: Record<string, unknown>; id: string }
-
   interface MpEvent {
     type: string
     detail: Record<string, unknown>
     target: Target
     currentTarget: Target
   }
-
   interface PageLifeCycle extends Show {
     onPullDownRefresh?(): void
     onReachBottom?(): void
@@ -117,50 +100,87 @@ declare module './index' {
     onLoad(options: Record<string, unknown>): void
     onUnload(): void
   }
-
-  interface PageInstance extends PageLifeCycle {
-    /**
-     * 页面配置。
-     */
+  interface ComponentInstance<
+    TData extends Record<string, unknown> = Record<string, unknown>,
+    TParams extends Record<string, string> = Record<string, string>
+  > {
+    /** 组件的文件路径 */
+    is?: string
+    /** 节点id */
+    id?: string
+    /** 节点dataset */
+    dataset?: string
+    /** 组件数据，包括内部数据和属性值 */
+    data?: TData
+    /** 组件数据，包括内部数据和属性值（与 data 一致） */
+    properties?: TData
+    /** 相对于当前自定义组件的 Router 对象 */
+    router?: RouterInfo<TParams>
+    /** 相对于当前自定义组件所在页面的 Router 对象 */
+    pageRouter?: RouterInfo<TParams>
+    /** 设置data并执行视图层渲染 */
+    setData?(newData: Partial<TData>): void
+    /** 检查组件是否具有 behavior （检查时会递归检查被直接或间接引入的所有behavior） */
+    hasBehavior?(behavior: unknown): boolean
+    /** 触发事件，参见[组件间通信与事件](https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/events.html) */
+    triggerEvent?(name: string, detail: Record<string, unknown>, options: {
+      /** 事件是否冒泡 */
+      bubbles?: boolean
+      /** 事件是否可以穿越组件边界，为 false 时，事件将只能在引用组件的节点树上触发，不进入其他任何组件内部 */
+      composed?: boolean
+      /** 事件是否拥有捕获阶段 */
+      capturePhase?: boolean
+    }): void
+    /** 创建一个 SelectorQuery 对象，选择器选取范围为这个组件实例内 */
+    createSelectorQuery?(): SelectorQuery
+    /** 创建一个 IntersectionObserver 对象，选择器选取范围为这个组件实例内 */
+    createIntersectionObserver?(): IntersectionObserver
+    /** 创建一个 MediaQueryObserver 对象 */
+    createMediaQueryObserver?(): MediaQueryObserver
+    /** 使用选择器选择组件实例节点，返回匹配到的第一个组件实例对象（会被 wx://component-export 影响） */
+    selectComponent?<
+      TD extends Record<string, unknown> = Record<string, unknown>,
+      TP extends Record<string, string> = Record<string, string>
+    >(selector: string): ComponentInstance<TD, TP>
+    /** 使用选择器选择组件实例节点，返回匹配到的全部组件实例对象组成的数组（会被 wx://component-export 影响） */
+    selectAllComponents?<
+      TD extends Record<string, unknown> = Record<string, unknown>,
+      TP extends Record<string, string> = Record<string, string>
+    >(selector: string): ComponentInstance<TD, TP>
+    /** 选取当前组件节点所在的组件实例（即组件的引用者），返回它的组件实例对象（会被 wx://component-export 影响） */
+    selectOwnerComponent?<
+      TD extends Record<string, unknown> = Record<string, unknown>,
+      TP extends Record<string, string> = Record<string, string>
+    >(): ComponentInstance<TD, TP>
+    /** 获取这个关系所对应的所有关联节点，参见[组件间关系](https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/relations.html) */
+    getRelationNodes?(relationKey: string): NodesRef[]
+    /** 立刻执行 callback ，其中的多个 setData 之间不会触发界面绘制（只有某些特殊场景中需要，如用于在不同组件同时 setData 时进行界面绘制同步） */
+    groupSetData?(callback: () => void): void
+    /** 返回当前页面的 custom-tab-bar 的组件实例，详见[自定义 tabBar](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/custom-tabbar.html) */
+    getTabBar?(): ComponentInstance
+    /** 返回页面标识符（一个字符串），可以用来判断几个自定义组件实例是不是在同一个页面内 */
+    getPageId?(): string
+    /** 执行关键帧动画，详见[动画](https://developers.weixin.qq.com/miniprogram/dev/framework/view/animation.html) */
+    animate?(selector: string, keyFrames: KeyFrame[], duration: number, callback: () => void): void
+    /** 清除关键帧动画，详见[动画](https://developers.weixin.qq.com/miniprogram/dev/framework/view/animation.html) */
+    clearAnimation?(selector: string, options: ClearAnimationOptions, callback: () => void): void
+    /** 清除关键帧动画，详见[动画](https://developers.weixin.qq.com/miniprogram/dev/framework/view/animation.html) */
+    setUpdatePerformanceListener?(options: {
+      /** 是否返回变更的 data 字段信息 */
+      withDataPaths?: boolean
+    }, listener: () => void): void
+  }
+  interface PageInstance extends PageLifeCycle, ComponentInstance {
+    /** 页面配置 */
     config?: PageConfig
     data?: Record<string, unknown>
     path?: string
     options?: Record<string, unknown>
-    /**
-     * 执行关键帧动画，详见[动画](https://developers.weixin.qq.com/miniprogram/dev/framework/view/animation.html)
-     *
-     * 最低基础库版本：[`2.9.0`](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html)
-     **/
-    animate?(selector: string, keyFrames: KeyFrame[], duration: number, callback: () => void): void
-    /**
-     * 执行关键帧动画，详见[动画](https://developers.weixin.qq.com/miniprogram/dev/framework/view/animation.html)
-     *
-     * 最低基础库版本：[`2.9.0`](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html)
-     **/
-    animate?(
-      selector: string,
-      keyFrames: ScrollTimelineKeyframe[],
-      duration: number,
-      scrollTimeline: ScrollTimelineOption
-    ): void
-    /**
-     * 清除关键帧动画，详见[动画](https://developers.weixin.qq.com/miniprogram/dev/framework/view/animation.html)
-     *
-     * 最低基础库版本：[`2.9.0`](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html)
-     **/
-    clearAnimation?(selector: string, callback: () => void): void
-    /**
-     * 清除关键帧动画，详见[动画](https://developers.weixin.qq.com/miniprogram/dev/framework/view/animation.html)
-     *
-     * 最低基础库版本：[`2.9.0`](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html)
-     **/
-    clearAnimation?(selector: string, options: ClearAnimationOptions, callback: () => void): void
   }
-
   interface TaroStatic {
     memo<P = {}>(
       FunctionComponent: FunctionComponent<P>,
-      compare?: (oldProps: P, newProps: P) => Boolean
+      compare?: (oldProps: P, newProps: P) => boolean
     ): FunctionComponent<P>
   }
 }

package/types/taro.config.d.ts

@@ -5,201 +5,174 @@ declare module './index' {
    * 微信小程序全局 Window 配置和页面配置的公共项目
    */
   interface CommonConfig {
-    /**
-     * 导航栏背景颜色，HexColor
-     * default: #000000
+    /** 导航栏背景颜色，HexColor
+     * @default: "#000000"
      */
     navigationBarBackgroundColor?: string
-    /**
-     * 导航栏标题颜色，仅支持 black/white
-     * default: 'white'
+    /** 导航栏标题颜色，仅支持 black/white
+     * @default: "white"
      */
     navigationBarTextStyle?: 'white' | 'black'
-    /**
-     * 导航栏标题文字内容
-     */
+    /** 导航栏标题文字内容 */
     navigationBarTitleText?: string
-    /**
-     * 导航栏样式，仅支持以下值：
-     * default 默认样式
-     * custom 自定义导航栏
+    /** 导航栏样式，仅支持以下值：
+     * - default 默认样式
+     * - custom 自定义导航栏
      */
     navigationStyle?: 'default' | 'custom'
-    /**
-     * 窗口的背景色， HexColor
-     * default: #ffffff
+    /** 窗口的背景色， HexColor
+     * @default: "#ffffff"
      */
     backgroundColor?: string
-    /**
-     * 下拉背景字体、loading 图的样式，仅支持 dark/light
-     * default: 'dark'
+    /** 下拉背景字体、loading 图的样式，仅支持 dark/light
+     * @default: "dark"
      */
     backgroundTextStyle?: 'dark' | 'light'
-    /**
-     * 顶部窗口的背景色，仅 iOS 支持
-     * default: #ffffff
+    /** 顶部窗口的背景色，仅 iOS 支持
+     * @default: "#ffffff"
      */
     backgroundColorTop?: string
-    /**
-     * 底部窗口的背景色，仅 iOS 支持
-     * default: #ffffff
+    /** 底部窗口的背景色，仅 iOS 支持
+     * @default: "#ffffff"
      */
     backgroundColorBottom?: string
-    /**
-     * 是否开启下拉刷新
-     * default: false
+    /** 是否开启下拉刷新
+     * @default: false
      */
     enablePullDownRefresh?: boolean
-    /**
-     * 页面上拉触底事件触发时距页面底部距离，单位为px
-     * default: 50
+    /** 页面上拉触底事件触发时距页面底部距离，单位为 px
+     * @default: 50
      */
     onReachBottomDistance?: number
+    /** 屏幕旋转设置
+     * @see https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html
+     */
+    pageOrientation?: 'auto' | 'portrait' | 'landscape'
+    /** 页面初始渲染缓存配置，支持 static / dynamic */
+    initialRenderingCache?: 'static' | 'dynamic'
+    /** 重新启动策略配置
+     * - homePage: 如果从这个页面退出小程序，下次将从首页冷启动
+     * - homePageAndLatestPage: 如果从这个页面退出小程序，下次冷启动后立刻加载这个页面，页面的参数保持不变（不可用于 tab 页）
+     * @default "homePage"
+     */
+    restartStrategy?: 'homePage' | 'homePageAndLatestPage'
   }
 
   interface PageConfig extends CommonConfig {
-    /**
-     * 设置为 true 则页面整体不能上下滚动；
+    /** 设置为 true 则页面整体不能上下滚动；
      * 只在页面配置中有效，无法在 app.json 中设置该项
-     * default: false
+     * @default: false
      */
     disableScroll?: boolean
-    /**
-     * 禁止页面右滑手势返回
-     * default: false
+    /** 禁止页面右滑手势返回
      *
      * **注意** 自微信客户端 7.0.5 开始，页面配置中的 disableSwipeBack 属性将不再生效，
      * 详情见[右滑手势返回能力调整](https://developers.weixin.qq.com/community/develop/doc/000868190489286620a8b27f156c01)公告
+     * @default: false
      * @since 微信客户端 7.0.0
      */
     disableSwipeBack?: boolean
-    /**
-     * 是否启用分享给好友。
-     *
+    /** 是否启用分享给好友。
      * @default false
      */
     enableShareAppMessage?: boolean
-    /**
-     * 是否启用分享到朋友圈。
-     *
+    /** 是否启用分享到朋友圈。
      * @default false
      */
     enableShareTimeline?: boolean
+    /** 页面自定义组件配置
+     * @see https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/
+     */
+    usingComponents?: Record<string, string>
+    /** 指定使用升级后的 weui 样式
+     * - v2: 可表明启用新版的组件样式
+     * @default default
+     */
+    style?: string
+    /** 单页模式相关配置 */
+    singlePage?: SinglePage
   }
 
   interface WindowConfig extends CommonConfig {
-    /**
-     * 屏幕旋转设置
-     * 支持 auto / portrait / landscape
-     * default: portrait
-     * 详见 [响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)
+    /** 切入系统后台时，隐藏页面内容，保护用户隐私。支持 hidden / none
+     * @default none
      */
-    pageOrientation?: 'auto' | 'portrait' | 'landscape'
-    /**
-     * 是否允许下拉刷新
-     * default: NO
+    visualEffectInBackground?: 'hidden' | 'none'
+    /** 是否允许下拉刷新
      * 备注：下拉刷新生效的前提是 allowsBounceVertical 值为 YES
+     * @default: "NO"
      */
     pullRefresh?: 'YES' | 'NO' | boolean
-    /**
-     * 是否允许向下拉拽
-     * default: YES
+    /** 是否允许向下拉拽
+     * @default: "YES"
      */
     allowsBounceVertical?: 'YES' | 'NO'
   }
 
   interface TabBarItem {
-    /**
-     * 页面路径，必须在 pages 中先定义
-     */
+    /** 页面路径，必须在 pages 中先定义 */
     pagePath: string
-    /**
-     * tab 上按钮文字
-     */
+    /** tab 上按钮文字 */
     text: string
-    /**
-     * 图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px，当 postion 为 top 时，此参数无效，不支持网络图片
-     */
+    /** 图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，当 position 为 top 时，此参数无效，不支持网络图片 */
     iconPath?: string
-    /**
-     * 选中时的图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px ，当 postion 为 top 时，此参数无效
-     */
+    /** 选中时的图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px ，当 position 为 top 时，此参数无效 */
     selectedIconPath?: string
   }
 
   interface TabBar {
-    /**
-     * tab 上的文字默认颜色
-     */
+    /** tab 上的文字默认颜色 */
     color?: string
-    /**
-     * tab 上的文字选中时的颜色
-     */
+    /** tab 上的文字选中时的颜色 */
     selectedColor?: string
-    /**
-     * tab 的背景色
-     */
+    /** tab 的背景色 */
     backgroundColor?: string
-    /**
-     * tabbar上边框的颜色， 仅支持 black/white
+    /** tabbar上边框的颜色， 仅支持 black/white
      * @default: black
      */
     borderStyle?: 'black' | 'white'
-    /**
-     * tabar 的位置，可选值 bottom、top
+    /** tab 的列表，详见 list 属性说明，最少 2 个、最多 5 个 tab */
+    list: TabBarItem[]
+    /** tabbar 的位置，可选值 bottom、top
      * @default: 'bottom'
      */
     position?: 'bottom' | 'top'
-    /**
-     * 自定义 tabBar，见[详情](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/custom-tabbar.html)
+    /** 自定义 tabBar，见[详情](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/custom-tabbar.html)
      * @default false
      * @since 2.1.0
      */
     custom?: boolean
-
-    list: TabBarItem[]
   }
 
   interface NetworkTimeout {
-    /**
-     * wx.request 的超时时间，单位毫秒。
+    /** Taro.request 的超时时间，单位毫秒。
      * @default 60000
      */
     request?: number
-    /**
-     * wx.connectSocket 的超时时间，单位毫秒。
+    /** Taro.connectSocket 的超时时间，单位毫秒。
      * @default 60000
      */
     connectSocket?: number
-    /**
-     * wx.uploadFile 的超时时间，单位毫秒。
+    /** Taro.uploadFile 的超时时间，单位毫秒。
      * @default 60000
      */
     uploadFile?: number
-    /**
-     * wx.downloadFile 的超时时间，单位毫秒。
+    /** Taro.downloadFile 的超时时间，单位毫秒。
      * @default 60000
      */
     downloadFile?: number
   }
 
   interface SubPackage {
-    /**
-     * 分包根路径
+    /** 分包根路径
      * - 注意：不能放在主包pages目录下
      */
     root: string
-    /**
-     * 分包路径下的所有页面配置
-     */
+    /** 分包路径下的所有页面配置 */
     pages: string[]
-    /**
-     * 分包别名，分包预下载时可以使用
-     */
+    /** 分包别名，分包预下载时可以使用 */
     name?: string
-    /**
-     * 分包是否是独立分包
-     */
+    /** 分包是否是独立分包 */
     independent?: boolean
   }
 
@@ -212,15 +185,12 @@ declare module './index' {
 
   interface PreloadRule {
     [key: string]: {
-      /**
-       *进入页面后预下载分包的 root 或 name。__APP__ 表示主包。
-       */
+      /** 进入页面后预下载分包的 root 或 name。__APP__ 表示主包。 */
       packages: string[]
-      /**
-       * 在指定网络下预下载，可选值为：
-       * all: 不限网络
-       * wifi: 仅wifi下预下载
-       * @default wifi
+      /** 在指定网络下预下载，可选值为：
+       * - all: 不限网络
+       * - wifi: 仅wifi下预下载
+       * @default "wifi"
        */
       network?: 'all' | 'wifi'
     }
@@ -228,55 +198,53 @@ declare module './index' {
 
   interface Permission {
     [key: string]: {
-      /**
-       * 小程序获取权限时展示的接口用途说明。最长30个字符
-       */
+      /** 小程序获取权限时展示的接口用途说明。最长30个字符 */
       desc: string
     }
   }
 
+  interface SinglePage {
+    /** 导航栏与页面的相交状态，值为 float 时表示导航栏浮在页面上，与页面相交；值为 squeezed 时表示页面被导航栏挤压，与页面不相交
+     * @default "默认自动调整，若原页面是自定义导航栏，则为 float，否则为 squeezed"
+     */
+    navigationBarFit?: string
+  }
+
   interface RouterAnimate {
-    /**
-     * 动画切换时间，单位毫秒
+    /** 动画切换时间，单位毫秒
      * @default 300
      */
     duration?: number
-    /**
-     * 动画切换时间，单位毫秒
+    /** 动画切换时间，单位毫秒
      * @default 50
      */
     delay?: number
   }
 
   interface AppConfig {
-    /**
-     * 小程序默认启动首页，未指定 entryPagePath 时，数组的第一项代表小程序的初始页面（首页）。
-     */
+    /** 小程序默认启动首页，未指定 entryPagePath 时，数组的第一项代表小程序的初始页面（首页）。 */
     entryPagePath?: string
-    /**
-     * 接受一个数组，每一项都是字符串，来指定小程序由哪些页面组成，数组的第一项代表小程序的初始页面
-     */
+    /** 接受一个数组，每一项都是字符串，来指定小程序由哪些页面组成，数组的第一项代表小程序的初始页面 */
     pages?: string[]
+    /** 全局的默认窗口表现 */
+    window?: WindowConfig
+    /** 底部 tab 栏的表现 */
     tabBar?: TabBar
-    /**
-     * 各类网络请求的超时时间，单位均为毫秒。
-     */
+    /** 各类网络请求的超时时间，单位均为毫秒。 */
     networkTimeout?: NetworkTimeout
-    /**
-     * 是否开启 debug 模式，默认关闭
+    /** 是否开启 debug 模式，默认关闭
      * @default false
      */
     debug?: boolean
-    /**
-     * 启用插件功能页时，插件所有者小程序需要设置其 functionalPages 为 true。
+    /** 启用插件功能页时，插件所有者小程序需要设置其 functionalPages 为 true。
      * @see https://developers.weixin.qq.com/miniprogram/dev/framework/plugin/functional-pages.html
      * @default false
      * @since 2.1.0
      */
     functionalPages?: boolean
-    /**
-     * 分包加载配置
-     * 示例:
+    /** 分包结构配置
+     * @example
+     * ```json
      * [
      *   {
      *     root: 'packages/module',
@@ -285,77 +253,118 @@ declare module './index' {
      *     ]
      *   }
      * ]
+     * ```
      * @since 1.7.3
      */
     subPackages?: SubPackage[]
     subpackages?: SubPackage[]
-    /**
-     * Worker 代码放置的目录
+    /** Worker 代码放置的目录
      * 使用 Worker 处理多线程任务时，设置 Worker 代码放置的目录
      * @since 1.9.90
      */
     workers?: string
-    /**
-     * 申明需要后台运行的能力，类型为数组。目前支持以下项目：
+    /** 申明需要后台运行的能力，类型为数组。目前支持以下项目：
+     * - audio: 后台音乐播放
+     * - location: 后台定位
      * @since 微信客户端 6.7.2 及以上版本支持
      */
-    requiredBackgroundModes?: ['audio']
-    /**
-     * 使用到的插件
+    requiredBackgroundModes?: ('audio' | 'location')[]
+    /** 使用到的插件
      * @since 1.9.6
      */
     plugins?: Plugins
-    /**
-     * 声明分包预下载的规则。
+    /** 声明分包预下载的规则。
      * preloadRule 中，key 是页面路径，value 是进入此页面的预下载配置
      * 注意: 分包预下载目前只支持通过配置方式使用，暂不支持通过调用API完成。
      *      vConsole 里有 preloadSubpackages 开头的日志信息，可以用来验证预下载的情况。
      * @since 2.3.0
      */
     preloadRule?: PreloadRule
-    /**
-     * iPad 小程序是否支持屏幕旋转
+    /** PC 小程序是否支持用户任意改变窗口大小（包括最大化窗口）；iPad 小程序是否支持屏幕旋转
      * @default false
      * @since 2.3.0
      */
     resizable?: boolean
-    /**
-     * 需要跳转的小程序列表
+    /** 需要跳转的小程序列表
      * @since 2.4.0
      */
     navigateToMiniProgramAppIdList?: string[]
-    /**
-     * 小程序接口权限相关设置
+    /** 全局自定义组件配置
+     * @see https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/
+     */
+    usingComponents?: Record<string, string>
+    /** 小程序接口权限相关设置
      * @since 微信客户端 7.0.0
      */
     permission?: Permission
-    /**
-     * 指定使用升级后的weui样式
-     * @since 2.8.0
-     */
-    style?: 'v2'
+    /** 指明 sitemap.json 的位置 */
+    sitemapLocation?: string
+    /** 指定使用升级后的 weui 样式
+     * - v2: 可表明启用新版的组件样式
+     * @default default
+     */
+    style?: string
+    /** 指定需要引用的扩展库
+     * 指定需要引用的扩展库。目前支持以下项目：
+     * - kbone: 多端开发框架
+     * - weui: WeUI 组件库
+     */
+    useExtendedLib?: Record<string, boolean>
+    /** 微信消息用小程序打开
+     * @see https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/location-message.html
+     */
+    entranceDeclare?: {
+      /** 声明“位置消息”场景进入小程序的启动页面 */
+      locationMessage?: {
+        /** 启动页路径，必须是在pages中已经定义 */
+        path?: string
+        /** 启动页参数 */
+        query?: string
+      }
+    }
     /**
      * 配置 darkMode 为 true，即表示当前小程序已适配 DarkMode
      * @since 2.11.0
      */
     darkmode?: boolean
-    /**
-     * 指定 darkMode 变量配置文件 theme.json 路径
+    /** 指明 theme.json 的位置，darkmode为true为必填
      * @since 2.11.0
      */
     themeLocation?: string
-    /**
-     * 接受一个数组，每一项都是字符串，来指定编译为原生小程序组件的组件入口
-     */
+    /** 配置自定义组件代码按需注入 */
+    lazyCodeLoading?: string
+    /** 单页模式相关配置 */
+    singlePage?: SinglePage
+    /** 聊天素材小程序打开相关配置
+     * @see https://developers.weixin.qq.com/miniprogram/dev/framework/material/support_material.html
+     */
+    supportedMaterials?: {
+      /** 支持文件类型的MimeType，音频，视频支持二级配置的通配模式，例如: video/*。通配模式配置和精确类型配置同时存在时，则优先使用精确类型的配置(例如video/*和video/mp4同时存在，会优先使用video/mp4的配置)。 */
+      materialType: string
+      /** 开发者配置的标题，在素材页面会展示该标题，配置中必须包含${nickname}, 代码包编译后会自动替换为小程序名称，如果声明了简称则会优先使用简称。除去${nickname}其余字数不得超过6个。 */
+      name: string
+      /** 用途描述，会在推荐列表展示该描述，限定字数不超过22个。 */
+      desc: string
+      /** 在该场景下打开小程序时跳转页面 */
+      path: string
+    }
+    /** 定制化型服务商票据 */
+    serviceProviderTicket?: string
+    /** 半屏小程序 appId */
+    embeddedAppIdList?: string[]
+    /** 视频号直播半屏场景设置 */
+    halfPage?: {
+      /** 视频号直播打开的第一个页面的全屏状态使用自定义顶部，支持 */
+      firstPageNavigationStyle?: 'default' | 'custom'
+    }
+    /** 接受一个数组，每一项都是字符串，来指定编译为原生小程序组件的组件入口 */
     components?: string[]
-    /**
-     * 渲染页面的容器 id
+    /** 渲染页面的容器 id
      * @default "app"
      * @since 3.3.18
      */
     appId?: string
-    /**
-     * 是否开启 h5 端路由动画功能，默认开启
+    /** 是否开启 h5 端路由动画功能，默认开启
      * @supported h5
      * @since 3.3.18
      */
@@ -363,12 +372,7 @@ declare module './index' {
   }
 
   interface Config extends PageConfig, AppConfig {
-    usingComponents?: {
-      [key: string]: string
-    }
-    window?: WindowConfig
     cloud?: boolean
-    pageOrientation?: 'auto' | 'portrait' | 'landscape'
   }
 
   interface TaroStatic {