@tarojs/taro 3.5.0-alpha.14 → 3.5.0-alpha.17

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

@@ -18,12 +18,12 @@ declare module '../../index' {
    */
   interface IntersectionObserver {
     /** 停止监听。回调函数将不再触发
-     * @supported weapp
+     * @supported weapp, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/IntersectionObserver.disconnect.html
      */
     disconnect(): void
     /** 指定目标节点并开始监听相交状态变化情况
-     * @supported weapp
+     * @supported weapp, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/IntersectionObserver.observe.html
      */
     observe(
@@ -33,7 +33,7 @@ declare module '../../index' {
       callback: IntersectionObserver.ObserveCallback,
     ): void
     /** 使用选择器指定一个节点，作为参照区域之一。
-     * @supported weapp
+     * @supported weapp, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/IntersectionObserver.relativeTo.html
      */
     relativeTo(
@@ -43,7 +43,7 @@ declare module '../../index' {
       margins?: IntersectionObserver.RelativeToMargins,
     ): IntersectionObserver
     /** 指定页面显示区域作为参照区域之一
-     * @supported weapp
+     * @supported weapp, tt
      * @example
      * 下面的示例代码中，如果目标节点（用选择器 .target-class 指定）进入显示区域以下 100px 时，就会触发回调函数。
      *
@@ -184,7 +184,7 @@ declare module '../../index' {
    */
   interface NodesRef {
     /** 添加节点的布局位置的查询请求。相对于显示区域，以像素为单位。其功能类似于 DOM 的 `getBoundingClientRect`。返回 `NodesRef` 对应的 `SelectorQuery`。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('#the-id').boundingClientRect(function(rect){
@@ -220,7 +220,7 @@ declare module '../../index' {
       callback?: NodesRef.BoundingClientRectCallback,
     ): SelectorQuery
     /** 添加节点的 Context 对象查询请求。目前支持 [VideoContext](/docs/apis/media/video/VideoContext)、[CanvasContext](/docs/apis/canvas/CanvasContext)、[LivePlayerContext](/docs/apis/media/live/LivePlayerContext)、[EditorContext](/docs/apis/media/editor/EditorContext)和 [MapContext](/docs/apis/media/map/MapContext) 的获取。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('.the-video-class').context(function (res) {
@@ -237,7 +237,7 @@ declare module '../../index' {
      *
      * **注意**
      * computedStyle 的优先级高于 size，当同时在 computedStyle 里指定了 width/height 和传入了 size: true，则优先返回 computedStyle 获取到的 width/height。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('#the-id').fields({
@@ -269,7 +269,7 @@ declare module '../../index' {
       callback?: NodesRef.FieldsCallback,
     ): SelectorQuery
     /** 获取 Node 节点实例。目前支持 [Canvas](/docs/components/canvas) 的获取。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('.canvas').node(function(res){
@@ -283,7 +283,7 @@ declare module '../../index' {
       callback?: NodesRef.NodeCallback,
     ): SelectorQuery
     /** 添加节点的滚动位置查询请求。以像素为单位。节点必须是 `scroll-view` 或者 `viewport`，返回 `NodesRef` 对应的 `SelectorQuery`。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Taro.createSelectorQuery().selectViewport().scrollOffset(function(res){
@@ -384,7 +384,7 @@ declare module '../../index' {
    */
   interface SelectorQuery {
     /** 执行所有的请求。请求结果按请求次序构成数组，在callback的第一个参数中返回。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.exec.html
      */
     exec(
@@ -392,7 +392,7 @@ declare module '../../index' {
       callback?: (...args: any[]) => any,
     ): NodesRef
     /** 将选择器的选取范围更改为自定义组件 `component` 内。（初始时，选择器仅选取页面范围的节点，不会选取任何自定义组件中的节点）。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Component({
@@ -423,7 +423,7 @@ declare module '../../index' {
      * - 后代选择器：.the-ancestor .the-descendant
      * - 跨自定义组件的后代选择器：.the-ancestor >>> .the-descendant
      * - 多选择器的并集：#a-node, .some-other-nodes
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('#the-id').fields({
@@ -459,7 +459,7 @@ declare module '../../index' {
      * - 后代选择器：.the-ancestor .the-descendant
      * - 跨自定义组件的后代选择器：.the-ancestor >>> .the-descendant
      * - 多选择器的并集：#a-node, .some-other-nodes
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.selectAll.html
      */
     selectAll(
@@ -467,7 +467,7 @@ declare module '../../index' {
       selector: string,
     ): NodesRef
     /** 选择显示区域。可用于获取显示区域的尺寸、滚动位置等信息。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Taro.createSelectorQuery().selectViewport().scrollOffset(function (res) {
@@ -484,7 +484,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 返回一个 SelectorQuery 对象实例。在自定义组件或包含自定义组件的页面中，应使用 `this.createSelectorQuery()` 来代替。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * const query = Taro.createSelectorQuery()
@@ -500,7 +500,7 @@ declare module '../../index' {
     createSelectorQuery(): SelectorQuery
 
     /** 创建并返回一个 IntersectionObserver 对象实例。在自定义组件或包含自定义组件的页面中，应使用 `this.createIntersectionObserver([options])` 来代替。
-     * @supported weapp
+     * @supported weapp, tt
      * @example
      * ```tsx
      * const observer = Taro.createIntersectionObserver(this, { thresholds: [0], observeAll: true })

package/types/compile.d.ts

@@ -1,6 +1,8 @@
+import swc from '@swc/core'
 export { Current } from '@tarojs/runtime'
 import webpack from 'webpack'
 import webpackDevServer from 'webpack-dev-server'
+import HtmlWebpackPlugin from 'html-webpack-plugin'
 
 export const enum TEMPLATE_TYPES {
   WEAPP = '.wxml',
@@ -119,7 +121,6 @@ interface Runtime {
 
 export interface IMiniAppConfig {
   appOutput?: boolean
-  enableSourceMap?: boolean
   sourceMapType?: string
   debugReact?: boolean
   minifyXML?: {
@@ -127,7 +128,6 @@ export interface IMiniAppConfig {
   }
 
   webpackChain?: (chain: any, webpack: any, PARSE_AST_TYPE: any) => void
-  entry?: webpack.EntryObject
   output?: webpack.Output
   postcss?: IPostcssOption
   cssLoaderOption?: IOption
@@ -177,11 +177,9 @@ export interface IH5Config {
 
   webpackChain?: (chain: any, webpack: any) => void
 
-  entry?: webpack.EntryObject
   output?: webpack.Output
   router?: IH5RouterConfig
   devServer?: webpackDevServer.Configuration
-  enableSourceMap?: boolean
   sourceMapType?: 'none' | 'eval' | 'cheap-eval-source-map' | 'cheap-module-eval-source-map' | 'eval-source-map' | 'cheap-source-map' | 'cheap-module-source-map' | 'inline-cheap-source-map' | 'inline-cheap-module-source-map' | 'source-map' | 'inline-source-map' | 'hidden-source-map' | 'nosources-source-map'
   enableExtract?: boolean
   transformOnly?: boolean
@@ -199,6 +197,7 @@ export interface IH5Config {
   useHtmlComponents?: boolean
 
   postcss?: IPostcssOption
+  htmlPluginOption?: HtmlWebpackPlugin.Options
 }
 
 type FeatureItem = {
@@ -371,6 +370,11 @@ interface IPrebundle {
   force?: boolean
   include?: string[]
   exclude?: string[]
+  esbuild?: Record<string, any>
+  swc?: swc.Config
+  webpack?: {
+    provide?: any[]
+  }
 }
 interface ICompiler {
   type: CompilerTypes
@@ -384,6 +388,8 @@ interface ILogger {
 }
 
 export interface IProjectBaseConfig {
+  isWatch?: boolean
+  port?: number
   projectName?: string
   date?: string
   designWidth?: number
@@ -406,9 +412,17 @@ export interface IProjectBaseConfig {
   presets?: PluginItem[]
   baseLevel?: number
   framework?: string
+  frameworkExts?: string[]
   compiler?: Compiler
   cache?: ICache
   logger?: ILogger
+  enableSourceMap?: boolean
+  /** hooks */
+  modifyWebpackChain?: HookModifyWebpackChain
+  modifyMiniConfigs?: (configMap) => Promise<any>
+  modifyBuildAssets?: (assets, plugin?) => Promise<any>
+  onWebpackChainReady?: (webpackChain: Chain) => Promise<any>
+  onBuildFinish?: (res: { error, stats, isWatch }) => Promise<any>
 }
 
 export interface IProjectConfig extends IProjectBaseConfig {

package/types/global.d.ts

@@ -215,7 +215,7 @@ declare namespace TaroGeneral {
      * @illustrate 正常
      */
     0
-    /** unsupport
+    /** nonsupport
      * @illustrate 系统或设备不支持
      */
     11000

package/types/taro.component.d.ts

@@ -4,35 +4,6 @@ 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.Component | 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<
@@ -184,10 +139,4 @@ declare module './index' {
     /** 页面的组件选项 */
     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

@@ -271,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
      */
@@ -359,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,6 +1,6 @@
 import React from 'react'
 
-import Taro, { Component } from './index'
+import Taro from './index'
 
 declare module './index' {
   type MessageType = 'info' | 'success' | 'error' | 'warning'
@@ -11,7 +11,7 @@ declare module './index' {
     duration?: number
   }
 
-  interface RequestParams<T> extends request.Option<T, any> {
+  interface RequestParams<T=any> extends request.Option<T, any> {
     [propName: string]: any
   }
 
@@ -49,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
      * // 使用插件
@@ -92,9 +97,8 @@ declare module './index' {
      */
     setGlobalDataPlugin: SetGlobalDataPlugin
 
-    /**
+    /** 获取自定义 TabBar 对应的 React 或 Vue 组件实例
      * @supported weapp
-     * @desc 获取自定义 TabBar 对应的 React 或 Vue 组件实例
      * @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