@tarojs/taro 3.5.0-canary.1 → 3.5.0

package/types/taro.api.d.ts

@@ -6,89 +6,106 @@
  * thanks for the great work by @qiu8310 👍👍👍
  *
  */
-/// <reference path="api/ad/index.d.ts" />
+/// <reference path="api/framework/index.d.ts" />
 /// <reference path="api/base/index.d.ts" />
-/// <reference path="api/base/debug.d.ts" />
 /// <reference path="api/base/system.d.ts" />
 /// <reference path="api/base/update.d.ts" />
 /// <reference path="api/base/weapp/life-cycle.d.ts" />
 /// <reference path="api/base/weapp/app-event.d.ts" />
+/// <reference path="api/base/debug.d.ts" />
+/// <reference path="api/base/performance.d.ts" />
+/// <reference path="api/base/crypto.d.ts" />
 /// <reference path="api/base/env.d.ts" />
-/// <reference path="api/canvas/index.d.ts" />
-/// <reference path="api/cloud/index.d.ts" />
+/// <reference path="api/route/index.d.ts" />
+/// <reference path="api/navigate/index.d.ts" />
+/// <reference path="api/share/index.d.ts" />
+/// <reference path="api/ui/interaction.d.ts" />
+/// <reference path="api/ui/navigation-bar.d.ts" />
+/// <reference path="api/ui/background.d.ts" />
+/// <reference path="api/ui/tab-bar.d.ts" />
+/// <reference path="api/ui/fonts.d.ts" />
+/// <reference path="api/ui/pull-down-refresh.d.ts" />
+/// <reference path="api/ui/scroll.d.ts" />
+/// <reference path="api/ui/animation.d.ts" />
+/// <reference path="api/ui/sticky.d.ts" />
+/// <reference path="api/ui/custom-component.d.ts" />
+/// <reference path="api/ui/menu.d.ts" />
+/// <reference path="api/ui/window.d.ts" />
+/// <reference path="api/network/request.d.ts" />
+/// <reference path="api/network/download.d.ts" />
+/// <reference path="api/network/upload.d.ts" />
+/// <reference path="api/network/websocket.d.ts" />
+/// <reference path="api/network/mdns.d.ts" />
+/// <reference path="api/network/tcp.d.ts" />
+/// <reference path="api/network/udp.d.ts" />
+/// <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/data-analysis/index.d.ts" />
-/// <reference path="api/device/accelerometer.d.ts" />
-/// <reference path="api/device/battery.d.ts" />
-/// <reference path="api/device/ble.d.ts" />
-/// <reference path="api/device/bluetooth.d.ts" />
-/// <reference path="api/device/clipboard.d.ts" />
-/// <reference path="api/device/compass.d.ts" />
-/// <reference path="api/device/contact.d.ts" />
-/// <reference path="api/device/gyroscope.d.ts" />
-/// <reference path="api/device/iBeacon.d.ts" />
-/// <reference path="api/device/motion.d.ts" />
-/// <reference path="api/device/network.d.ts" />
-/// <reference path="api/device/nfc.d.ts" />
-/// <reference path="api/device/performance.d.ts" />
-/// <reference path="api/device/phone.d.ts" />
-/// <reference path="api/device/scan.d.ts" />
-/// <reference path="api/device/screen.d.ts" />
-/// <reference path="api/device/vibrate.d.ts" />
-/// <reference path="api/device/wifi.d.ts" />
-/// <reference path="api/ext/index.d.ts" />
-/// <reference path="api/files/index.d.ts" />
-/// <reference path="api/framework/index.d.ts" />
-/// <reference path="api/location/index.d.ts" />
+/// <reference path="api/canvas/index.d.ts" />
+/// <reference path="api/media/map.d.ts" />
+/// <reference path="api/media/image.d.ts" />
+/// <reference path="api/media/video.d.ts" />
 /// <reference path="api/media/audio.d.ts" />
 /// <reference path="api/media/background-audio.d.ts" />
-/// <reference path="api/media/camera.d.ts" />
-/// <reference path="api/media/editor.d.ts" />
-/// <reference path="api/media/image.d.ts" />
 /// <reference path="api/media/live.d.ts" />
-/// <reference path="api/media/map.d.ts" />
 /// <reference path="api/media/recorder.d.ts" />
-/// <reference path="api/media/video.d.ts" />
+/// <reference path="api/media/camera.d.ts" />
+/// <reference path="api/media/editor.d.ts" />
 /// <reference path="api/media/video-processing.d.ts" />
-/// <reference path="api/network/download.d.ts" />
-/// <reference path="api/network/mdns.d.ts" />
-/// <reference path="api/network/request.d.ts" />
-/// <reference path="api/network/udp.d.ts" />
-/// <reference path="api/network/upload.d.ts" />
-/// <reference path="api/network/websocket.d.ts" />
+/// <reference path="api/media/voip.d.ts" />
+/// <reference path="api/media/media-recorder.d.ts" />
+/// <reference path="api/media/video-decoder.d.ts" />
+/// <reference path="api/location/index.d.ts" />
+/// <reference path="api/files/index.d.ts" />
+/// <reference path="api/open-api/login.d.ts" />
 /// <reference path="api/open-api/account.d.ts" />
-/// <reference path="api/open-api/address.d.ts" />
+/// <reference path="api/open-api/user-info.d.ts" />
 /// <reference path="api/open-api/authorize.d.ts" />
+/// <reference path="api/open-api/settings.d.ts" />
+/// <reference path="api/open-api/address.d.ts" />
 /// <reference path="api/open-api/card.d.ts" />
-/// <reference path="api/open-api/facial.d.ts" />
 /// <reference path="api/open-api/invoice.d.ts" />
-/// <reference path="api/open-api/login.d.ts" />
-/// <reference path="api/open-api/navigate.d.ts" />
-/// <reference path="api/open-api/payment.d.ts" />
-/// <reference path="api/open-api/settings.d.ts" />
 /// <reference path="api/open-api/soter.d.ts" />
-/// <reference path="api/open-api/subscribe-message.d.ts" />
-/// <reference path="api/open-api/user-info.d.ts" />
 /// <reference path="api/open-api/werun.d.ts" />
+/// <reference path="api/open-api/subscribe-message.d.ts" />
+/// <reference path="api/open-api/redpackage.d.ts" />
+/// <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/group.d.ts" />
 /// <reference path="api/open-api/customer-service.d.ts" />
-/// <reference path="api/route/index.d.ts" />
-/// <reference path="api/share/index.d.ts" />
-/// <reference path="api/storage/background-fetch.d.ts" />
-/// <reference path="api/storage/index.d.ts" />
-/// <reference path="api/ui/animation.d.ts" />
-/// <reference path="api/ui/background.d.ts" />
-/// <reference path="api/ui/custom-component.d.ts" />
-/// <reference path="api/ui/fonts.d.ts" />
-/// <reference path="api/ui/keyboard.d.ts" />
-/// <reference path="api/ui/menu.d.ts" />
-/// <reference path="api/ui/navigation-bar.d.ts" />
-/// <reference path="api/ui/pull-down-refresh.d.ts" />
-/// <reference path="api/ui/scroll.d.ts" />
-/// <reference path="api/ui/sticky.d.ts" />
-/// <reference path="api/ui/tab-bar.d.ts" />
-/// <reference path="api/ui/window.d.ts" />
-/// <reference path="api/ui/interaction.d.ts" />
+/// <reference path="api/device/bluetooth.d.ts" />
+/// <reference path="api/device/bluetooth-ble.d.ts" />
+/// <reference path="api/device/bluetooth-peripheral.d.ts" />
+/// <reference path="api/device/iBeacon.d.ts" />
+/// <reference path="api/device/nfc.d.ts" />
+/// <reference path="api/device/wifi.d.ts" />
+/// <reference path="api/device/calendar.d.ts" />
+/// <reference path="api/device/contact.d.ts" />
+/// <reference path="api/device/accessibility.d.ts" />
+/// <reference path="api/device/battery.d.ts" />
+/// <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/keyboard.d.ts" />
+/// <reference path="api/device/phone.d.ts" />
+/// <reference path="api/device/accelerometer.d.ts" />
+/// <reference path="api/device/compass.d.ts" />
+/// <reference path="api/device/motion.d.ts" />
+/// <reference path="api/device/gyroscope.d.ts" />
+/// <reference path="api/device/memory.d.ts" />
+/// <reference path="api/device/scan.d.ts" />
+/// <reference path="api/device/vibrate.d.ts" />
+/// <reference path="api/ai/visionkit.d.ts" />
+/// <reference path="api/ai/face.d.ts" />
 /// <reference path="api/worker/index.d.ts" />
 /// <reference path="api/wxml/index.d.ts" />
+/// <reference path="api/ext/index.d.ts" />
+/// <reference path="api/ad/index.d.ts" />
+
+/// <reference path="api/cloud/index.d.ts" />
+/// <reference path="api/open-api/facial.d.ts" />
 
 /// <reference path="api/alipay/index.d.ts" />
 /// <reference path="api/swan/index.d.ts" />

package/types/taro.component.d.ts

@@ -1,38 +1,9 @@
-/// <reference types="react" />
-/// <reference types="vue" />
+import React from 'react'
+import Vue from 'vue'
 
 import Taro, { Config } from './index'
 
 declare module './index' {
-  // Components
-  interface ComponentLifecycle<P, S, SS = any> extends NewLifecycle<P, S, SS> {
-    componentWillMount?(): void
-    componentDidMount?(): void
-    componentWillReceiveProps?(nextProps: Readonly<P>, nextContext: any): void
-    shouldComponentUpdate?(nextProps: Readonly<P>, nextState: Readonly<S>, nextContext: any): boolean
-    componentWillUpdate?(nextProps: Readonly<P>, nextState: Readonly<S>, nextContext: any): void
-    componentWillUnmount?(): void
-    componentDidShow?(): void
-    componentDidHide?(): void
-    componentDidCatchError?(err: string): void
-    componentDidNotFound?(obj: PageNotFoundObject): void
-    onPullDownRefresh?(): void
-    onReachBottom?(): void
-    onPageScroll?(obj: PageScrollObject): void
-    onShareAppMessage?(obj: ShareAppMessageObject): ShareAppMessageReturn
-    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>>> {
     /** 路由参数 */
@@ -47,24 +18,8 @@ declare module './index' {
 
     shareTicket: string | undefined
     scene: number | undefined
+    exitState?: any
   }
-  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.
-    defaultProps?: Partial<P>
-    config?: Config
-    options?: ComponentOptions
-    externalClasses?: string[]
-  }
-  type FC<P = {}> = FunctionComponent<P>
-  interface StatelessFunctionComponent {
-    (): JSX.Element
-  }
-  type SFC = StatelessFunctionComponent
 
   interface Show {
     componentDidShow?(): void
@@ -73,10 +28,10 @@ declare module './index' {
     onHide?(): void
   }
   interface AppInstance extends Show {
-    mount(component: React.ComponentClass | Vue.ComponentOptions<Vue>, id: string, cb: () => void): void
+    mount(component: React.Component | Vue.ComponentOptions<Vue>, id: string, cb: (...args: any[]) => void): void
     componentDidShow?(options?: Record<string, unknown>): void
     onShow?(options?: Record<string, unknown>): void
-    unmount(id: string, cb: () => void): void
+    unmount(id: string, cb?: () => void): void
   }
   type Target = Record<string, unknown> & { dataset: Record<string, unknown>; id: string }
   interface MpEvent {
@@ -86,18 +41,18 @@ declare module './index' {
     currentTarget: Target
   }
   interface PageLifeCycle extends Show {
-    onPullDownRefresh?(): void
-    onReachBottom?(): void
-    onPageScroll?(obj: { scrollTop: number }): void
-    onShareAppMessage?(obj: { from: string; target?: any; webViewUrl: string }): void
-    onResize?(options: unknown): void
-    onTabItemTap?(obj: { index: string; pagePath: string; text: string }): void
-    onTitleClick?(): void
+    eh?(event: MpEvent): void
+    onLoad(options: Record<string, unknown>): void
     onOptionMenuClick?(): void
+    onPageScroll?(opt: PageScrollObject): void
     onPopMenuClick?(): void
+    onPullDownRefresh?(): void
     onPullIntercept?(): void
-    eh?(event: MpEvent): void
-    onLoad(options: Record<string, unknown>): void
+    onReachBottom?(): void
+    onResize?(opt: PageResizeObject): void
+    onShareAppMessage?(opt: ShareAppMessageObject): ShareAppMessageReturn
+    onTabItemTap?(opt: TabItemTapObject): void
+    onTitleClick?(): void
     onUnload(): void
   }
   interface ComponentInstance<
@@ -162,6 +117,10 @@ declare module './index' {
     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) */
+    animate?(selector: string, keyFrames: KeyFrame[], duration: number, scrollTimeline: ScrollTimelineOption): void
+    /** 清除关键帧动画，详见[动画](https://developers.weixin.qq.com/miniprogram/dev/framework/view/animation.html) */
+    clearAnimation?(selector: string, 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) */
@@ -173,14 +132,11 @@ declare module './index' {
   interface PageInstance extends PageLifeCycle, ComponentInstance {
     /** 页面配置 */
     config?: PageConfig
+    /** 页面的初始数据 */
     data?: Record<string, unknown>
+    /** 页面路径 */
     path?: string
+    /** 页面的组件选项 */
     options?: Record<string, unknown>
   }
-  interface TaroStatic {
-    memo<P = {}>(
-      FunctionComponent: FunctionComponent<P>,
-      compare?: (oldProps: P, newProps: P) => boolean
-    ): FunctionComponent<P>
-  }
 }

package/types/taro.config.d.ts

@@ -174,6 +174,8 @@ declare module './index' {
     name?: string
     /** 分包是否是独立分包 */
     independent?: boolean
+    /** 分包支持引用独立的插件 */
+    plugins?: Plugins
   }
 
   interface Plugins {
@@ -269,6 +271,19 @@ declare module './index' {
      * @since 微信客户端 6.7.2 及以上版本支持
      */
     requiredBackgroundModes?: ('audio' | 'location')[]
+    /** 申明需要使用的地理位置相关接口，类型为数组。目前支持以下项目：
+     * 自 2022 年 7 月 14 日后发布的小程序，使用以下8个地理位置相关接口时，需要声明该字段，否则将无法正常使用。2022 年 7 月 14 日前发布的小程序不受影响。
+     * - getFuzzyLocation: 获取模糊地理位置
+     * - getLocation: 获取精确地理位置
+     * - onLocationChange: 监听试试地理位置变化事件
+     * - startLocationUpdate: 接收位置消息（前台）
+     * - startLocationUpdateBackground: 接收位置消息（前后台）
+     * - chooseLocation: 打开地图选择位置
+     * - choosePoi: 打开 POI 列表选择位置
+     * - chooseAddress: 获取用户地址信息
+     *  @see https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html#requiredPrivateInfos
+     */
+    requiredPrivateInfos?: ('getFuzzyLocation' | 'getLocation' | 'onLocationChange' | 'startLocationUpdate' | 'startLocationUpdateBackground' | 'chooseLocation' | 'choosePoi' | 'chooseAddress')[] 
     /** 使用到的插件
      * @since 1.9.6
      */
@@ -357,6 +372,22 @@ declare module './index' {
       /** 视频号直播打开的第一个页面的全屏状态使用自定义顶部，支持 */
       firstPageNavigationStyle?: 'default' | 'custom'
     }
+    /** 小程序调试相关配置项 */
+    debugOptions?: {
+      /** 是否开启 FPS 面板，默认false */
+      enableFPSPanel?: boolean
+    }
+    /** touch 事件监听是否为 passive，默认false */
+    enablePassiveEvent?: boolean | {
+      /** 是否设置 touchstart 事件为 passive，默认false */
+      touchstart?: boolean
+      /** 是否设置 touchmove 事件为 passive，默认false */
+      touchmove?: boolean
+      /** 是否设置 wheel 事件为 passive，默认false */
+      wheel?: boolean
+    }
+    /** 自定义模块映射规则 */
+    resolveAlias?: Record<string, string>
     /** 接受一个数组，每一项都是字符串，来指定编译为原生小程序组件的组件入口 */
     components?: string[]
     /** 渲染页面的容器 id

package/types/taro.extend.d.ts

@@ -1,4 +1,6 @@
-import Taro, { Component } from './index'
+import React from 'react'
+
+import Taro from './index'
 
 declare module './index' {
   type MessageType = 'info' | 'success' | 'error' | 'warning'
@@ -9,7 +11,7 @@ declare module './index' {
     duration?: number
   }
 
-  interface RequestParams extends request.Option<any> {
+  interface RequestParams<T=any> extends request.Option<T, any> {
     [propName: string]: any
   }
 
@@ -47,36 +49,41 @@ declare module './index' {
       new (): TaroGeneral.Events
     }
 
-    // eventCenter
+    /** 事件中心
+     * @supported global
+     */
     eventCenter: TaroGeneral.Events
 
     ENV_TYPE: TARO_ENV_TYPE
 
+    /** 获取环境变量
+     * @supported global
+     */
     getEnv(): TaroGeneral.ENV_TYPE
 
-    render(component: Component | JSX.Element, element: Element | null): any
-
-    internal_safe_set(...arg: any[]): any
-    internal_safe_get(...arg: any[]): any
-
-    atMessage(options: AtMessageOptions): void
-
+    /** 尺寸转换
+     * @supported global
+     */
     pxTransform(size: number, designWidth?: number): string
+
+    /** 尺寸转换初始化
+     * @supported global
+     */
     initPxTransform(config: { designWidth: number; deviceRatio: TaroGeneral.TDeviceRatio }): void
 
-    /**
-     * 小程序引用插件 JS 接口
+    /** 小程序引用插件 JS 接口
+     * @supported weapp, alipay, h5, rn, jd, qq, swan, tt, quickapp
      */
     requirePlugin(pluginName: string): any
 
-    setIsUsingDiff (flag: boolean)
-
-    Current: Current
-
+    /** 获取当前页面实例
+     * @supported global
+     */
     getCurrentInstance(): Current
+    Current: Current
 
-    /**
-     * @desc Vue3 插件，用于设置 `getApp()` 中的全局变量
+    /** Vue3 插件，用于设置 `getApp()` 中的全局变量
+     * @supported weapp, alipay, h5, rn, jd, qq, swan, tt, quickapp
      * @example
      * ```js
      * // 使用插件
@@ -89,5 +96,11 @@ declare module './index' {
      * ```
      */
     setGlobalDataPlugin: SetGlobalDataPlugin
+
+    /** 获取自定义 TabBar 对应的 React 或 Vue 组件实例
+     * @supported weapp
+     * @param page 小程序页面对象，可以通过 Taro.getCurrentInstance().page 获取
+     */
+    getTabBar<T>(page: Current['page']): T | undefined
   }
 }

package/types/taro.hooks.d.ts

@@ -4,80 +4,132 @@ declare module './index' {
   interface TaroStatic {
     /**
      * 页面展示时的回调。
+     * @supported global
      */
     useDidShow(callback: () => void): void
 
     /**
      * 页面隐藏时的回调。
+     * @supported global
      */
     useDidHide(callback: () => void): void
 
     /**
      * 下拉刷新时的回调。
+     * @supported global
      */
     usePullDownRefresh(callback: () => void): void
 
     /**
      * 上拉触底时的回调。
+     * @supported global
      */
     useReachBottom(callback: () => void): void
 
     /**
      * 页面滚动时的回调。
+     * @supported global
      */
     usePageScroll(callback: (payload: PageScrollObject) => void): void
 
     /**
      * 页面尺寸改变时的回调。
+     * @supported global
      */
     useResize(callback: (payload: PageResizeObject) => void): void
 
     /**
      * 页面转发时的回调。
+     * @supported weapp
      */
     useShareAppMessage(callback: (payload: ShareAppMessageObject) => ShareAppMessageReturn): void
 
     /**
      * 当前是 tab 页时，tab 被点击时的回调。
+     * @supported weapp, rn
      */
     useTabItemTap(callback: (payload: TabItemTapObject) => void): void
 
     /**
      * 用户点击右上角菜单“收藏”按钮时的回调。
+     * @supported weapp
      */
     useAddToFavorites(callback: (payload: AddToFavoritesObject) => AddToFavoritesReturnObject): void
 
     /**
      * 用户点击右上角菜单“分享到朋友圈”按钮时的回调。
+     * @supported weapp
      */
     useShareTimeline(callback: () => ShareTimelineReturnObject): void
 
+    /**
+     * 页面销毁前保留状态回调
+     * @supported weapp
+     */
+    useSaveExitState(callback: () => {
+      data: Record<any, any>
+      expireTimeStamp?: number
+    }): void
+
+    /**
+     * 小程序初始化完成时的回调。
+     * @supported weapp, h5
+     */
+    useLaunch(callback: (options: getLaunchOptionsSync.LaunchOptions) => void): void
+
+    /**
+     * 小程序发生脚本错误或 API 调用报错时触发的回调。
+     * @supported weapp, h5
+     */
+    useError(callback: (error: string) => void): void
+
+    /**
+     * 小程序要打开的页面不存在时触发的回调。
+     * @supported weapp, h5
+     * @h5 多页面模式不支持该方法
+     */
+    usePageNotFound(callback: (res: { path: string, query: Record<any, any>, isEntryPage: boolean, [key: string]: any }) => void): void
+
+    /**
+     * 页面加载完成时的回调。
+     * @supported weapp, h5
+     */
+    useLoad(callback: () => void): void
+
+    /**
+     * 页面卸载时的回调。
+     * @supported weapp, h5
+     */
+    useUnload(callback: () => void): void
+
     /**
      * 页面初次渲染完成的回调。
      * 此时页面已经准备妥当，可以和视图层进行交互。
+     * @supported weapp, h5
      */
     useReady(callback: () => void): void
 
     /**
      * 获取当前路由参数。
+     * @supported global
      */
     useRouter<TParams extends Partial<Record<string, string>> = Partial<Record<string, string>>>(dynamic?: boolean): RouterInfo<TParams>
 
     /**
      * 导航栏的标题被点击时的回调。
-     * **仅支付宝小程序支持。**
+     * @supported alipay
      */
     useTitleClick(callback: () => void): void
 
     /**
      * 导航栏的额外图标被点击时的回调。
-     * **仅支付宝小程序支持。**
+     * @supported alipay
      */
     useOptionMenuClick(callback: () => void): void
 
     /**
      * 下拉中断时的回调。
-     * **仅支付宝小程序支持。**
+     * @supported alipay, h5
      */
     usePullIntercept(callback: () => void): void
   }

package/types/taro.lifecycle.d.ts

@@ -1,15 +1,15 @@
 import Taro from './index'
 
 type TaroGetDerivedStateFromProps<P, S> =
-/**
- * Returns an update to a component's state based on its new props and old state.
- *
- * Note: its presence prevents any of the deprecated lifecycle methods from being invoked
- */
-(nextProps: Readonly<P>, prevState: S) => Partial<S> | null;
+  /**
+   * Returns an update to a component's state based on its new props and old state.
+   *
+   * Note: its presence prevents any of the deprecated lifecycle methods from being invoked
+   */
+  (nextProps: Readonly<P>, prevState: S) => Partial<S> | null
 
 interface TaroStaticLifecycle<P, S> {
-  getDerivedStateFromProps?: TaroGetDerivedStateFromProps<P, S>;
+  getDerivedStateFromProps?: TaroGetDerivedStateFromProps<P, S>
 }
 
 interface TaroNewLifecycle<P, S, SS> {
@@ -21,13 +21,13 @@ interface TaroNewLifecycle<P, S, SS> {
    * Note: the presence of getSnapshotBeforeUpdate prevents any of the deprecated
    * lifecycle events from running.
    */
-  getSnapshotBeforeUpdate?(prevProps: Readonly<P>, prevState: Readonly<S>): SS | null;
+  getSnapshotBeforeUpdate?(prevProps: Readonly<P>, prevState: Readonly<S>): SS | null
   /**
    * Called immediately after updating occurs. Not called for the initial render.
    *
    * The snapshot is only present if getSnapshotBeforeUpdate is present and returns non-null.
    */
-  componentDidUpdate?(prevProps: Readonly<P>, prevState: Readonly<S>, snapshot?: SS): void;
+  componentDidUpdate?(prevProps: Readonly<P>, prevState: Readonly<S>, snapshot?: SS): void
 }
 
 declare module './index' {
@@ -165,11 +165,18 @@ declare module './index' {
     imageUrl?: string
   }
 
-  type GetDerivedStateFromProps<P, S> = TaroGetDerivedStateFromProps<P, S>
-
-  type StaticLifecycle<P, S> = TaroStaticLifecycle<P, S>
-
-  type NewLifecycle<P, S, SS> = TaroNewLifecycle<P, S, SS>
+  interface ComponentLifecycle<P, S, SS = any> extends TaroNewLifecycle<P, S, SS> {
+    componentWillMount?(): void
+    componentDidMount?(): void
+    componentWillReceiveProps?(nextProps: Readonly<P>, nextContext: any): void
+    shouldComponentUpdate?(nextProps: Readonly<P>, nextState: Readonly<S>, nextContext: any): boolean
+    componentWillUpdate?(nextProps: Readonly<P>, nextState: Readonly<S>, nextContext: any): void
+    componentWillUnmount?(): void
+    componentDidShow?(): void
+    componentDidHide?(): void
+    componentDidCatchError?(err: string): void
+    componentDidNotFound?(opt: PageNotFoundObject): void
+  }
 
   interface TaroStatic {
     PageNotFoundObject: PageNotFoundObject