@tarojs/taro 3.3.13 → 3.3.14

package/types/taro.config.d.ts

@@ -1,8 +1,10 @@
-declare namespace Taro {
+import Taro from './index'
+
+declare module './index' {
   /**
    * 微信小程序全局 Window 配置和页面配置的公共项目
    */
-  interface CommonPageConfig {
+  interface CommonConfig {
     /**
      * 导航栏背景颜色，HexColor
      * default: #000000
@@ -55,7 +57,7 @@ declare namespace Taro {
     onReachBottomDistance?: number
   }
 
-  interface PageConfig extends CommonPageConfig {
+  interface PageConfig extends CommonConfig {
     /**
      * 设置为 true 则页面整体不能上下滚动；
      * 只在页面配置中有效，无法在 app.json 中设置该项
@@ -85,7 +87,7 @@ declare namespace Taro {
     enableShareTimeline?: boolean
   }
 
-  interface WindowConfig extends CommonPageConfig {
+  interface WindowConfig extends CommonConfig {
     /**
      * 屏幕旋转设置
      * 支持 auto / portrait / landscape
@@ -106,7 +108,7 @@ declare namespace Taro {
     allowsBounceVertical?: 'YES' | 'NO'
   }
 
-  interface TarbarList {
+  interface TabBarItem {
     /**
      * 页面路径，必须在 pages 中先定义
      */
@@ -155,7 +157,7 @@ declare namespace Taro {
      */
     custom?: boolean
 
-    list: TarbarList[]
+    list: TabBarItem[]
   }
 
   interface NetworkTimeout {
@@ -339,4 +341,20 @@ declare namespace Taro {
     cloud?: boolean
     pageOrientation?: 'auto' | 'portrait' | 'landscape'
   }
+
+  interface TaroStatic {
+    CommonConfig: CommonConfig
+    PageConfig: PageConfig
+    WindowConfig: WindowConfig
+    TarBarList: TabBarItem
+    TabBar: TabBar
+    NetworkTimeout: NetworkTimeout
+    SubPackage: SubPackage
+    Plugins: Plugins
+    PreloadRule: PreloadRule
+    Permission: Permission
+    AppConfig: AppConfig
+    Config: Config
+  }
 }
+

package/types/taro.extend.d.ts

@@ -1,59 +1,50 @@
-/// <reference types="react" />
-/// <reference path="taro.component.d.ts" />
-/// <reference path="api/network/request.d.ts" />
+import Taro, { Component } from './index'
 
-declare namespace Taro {
-  // Events
-  class Events {
-    /**
-     * 监听一个事件，接受参数
-     */
-    on(eventName: string, listener: (...args: any[]) => void): this
-
-    /**
-     * 添加一个事件监听，并在事件触发完成之后移除Callbacks链
-     */
-    once(eventName: string, listener: (...args: any[]) => void): this
-
-    /**
-     * 取消监听一个事件
-     */
-    off(eventName: string, listener?: (...args: any[]) => void): this
-
-    /**
-     * 取消监听的所有事件
-     */
-    off(): this
-
-    /**
-     * 触发一个事件，传参
-     */
-    trigger(eventName: string, ...args: any[]): boolean
-  }
+// Events
+export class TaroEvents {
+  /**
+   * 监听一个事件，接受参数
+   */
+  on(eventName: string, listener: (...args: any[]) => void): this
 
-  // eventCenter
+  /**
+   * 添加一个事件监听，并在事件触发完成之后移除Callbacks链
+   */
+  once(eventName: string, listener: (...args: any[]) => void): this
 
-  const eventCenter: Events
+  /**
+   * 取消监听一个事件
+   */
+  off(eventName: string, listener?: (...args: any[]) => void): this
 
-  // ENV_TYPE
+  /**
+   * 取消监听的所有事件
+   */
+  off(): this
 
-  enum ENV_TYPE {
-    WEAPP = 'WEAPP',
-    WEB = 'WEB',
-    RN = 'RN',
-    SWAN = 'SWAN',
-    ALIPAY = 'ALIPAY',
-    TT = 'TT',
-    QQ = 'QQ',
-    JD = 'JD'
-  }
+  /**
+   * 触发一个事件，传参
+   */
+  trigger(eventName: string, ...args: any[]): boolean
+}
 
-  function getEnv(): ENV_TYPE
+// ENV_TYPE
+
+export enum TARO_ENV_TYPE {
+  WEAPP = 'WEAPP',
+  WEB = 'WEB',
+  RN = 'RN',
+  SWAN = 'SWAN',
+  ALIPAY = 'ALIPAY',
+  TT = 'TT',
+  QQ = 'QQ',
+  JD = 'JD'
+}
 
-  function render(component: Component | JSX.Element, element: Element | null): any
+declare module './index' {
+  type Events = TaroEvents
 
-  function internal_safe_set(...arg: any[]): any
-  function internal_safe_get(...arg: any[]): any
+  type ENV_TYPE = TARO_ENV_TYPE
 
   type MessageType = 'info' | 'success' | 'error' | 'warning'
 
@@ -63,11 +54,6 @@ declare namespace Taro {
     duration?: number
   }
 
-  function atMessage(options: AtMessageOptions): void
-
-  function pxTransform(size: number, designWidth?: number): string
-  function initPxTransform(config: { designWidth: number; deviceRatio: object }): void
-
   interface RequestParams extends request.Option<any> {
     [propName: string]: any
   }
@@ -81,21 +67,12 @@ declare namespace Taro {
     proceed(requestParams: RequestParams): any
   }
 
-  namespace interceptors {
-    function logInterceptor(chain: Chain): Promise<any>
+  interface interceptors {
+    logInterceptor(chain: Chain): Promise<any>
 
-    function timeoutInterceptor(chain: Chain): Promise<any>
+    timeoutInterceptor(chain: Chain): Promise<any>
   }
 
-  function addInterceptor(interceptor: interceptor): any
-
-  /**
-   * 小程序引用插件 JS 接口
-   */
-  function requirePlugin(pluginName: string): any
-
-  function setIsUsingDiff (flag: boolean)
-
   interface Current {
     app: AppInstance | null
     router: RouterInfo | null
@@ -110,7 +87,33 @@ declare namespace Taro {
     rnNavigationRef?: React.RefObject<any>
   }
 
-  const Current: Current
+  interface TaroStatic {
+    // eventCenter
+    eventCenter: TaroEvents
+
+    getEnv(): ENV_TYPE
 
-  function getCurrentInstance(): Current
+    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
+
+    pxTransform(size: number, designWidth?: number): string
+    initPxTransform(config: { designWidth: number; deviceRatio: object }): void
+
+    addInterceptor(interceptor: interceptor): any
+
+    /**
+     * 小程序引用插件 JS 接口
+     */
+    requirePlugin(pluginName: string): any
+
+    setIsUsingDiff (flag: boolean)
+
+    Current: Current
+
+    getCurrentInstance(): Current
+  }
 }

package/types/taro.hooks.d.ts

@@ -1,83 +1,84 @@
-/// <reference path="taro.lifecycle.d.ts" />
-/// <reference path="taro.component.d.ts" />
+import Taro from './index'
 
-declare namespace Taro {
-  /**
-   * 页面展示时的回调。
-   */
-  function useDidShow(callback: () => any): void
+declare module './index' {
+  interface TaroStatic {
+    /**
+     * 页面展示时的回调。
+     */
+    useDidShow(callback: () => any): void
 
-  /**
-   * 页面隐藏时的回调。
-   */
-  function useDidHide(callback: () => any): void
+    /**
+     * 页面隐藏时的回调。
+     */
+    useDidHide(callback: () => any): void
 
-  /**
-   * 下拉刷新时的回调。
-   */
-  function usePullDownRefresh(callback: () => any): void
+    /**
+     * 下拉刷新时的回调。
+     */
+    usePullDownRefresh(callback: () => any): void
 
-  /**
-   * 上拉触底时的回调。
-   */
-  function useReachBottom(callback: () => any): void
+    /**
+     * 上拉触底时的回调。
+     */
+    useReachBottom(callback: () => any): void
 
-  /**
-   * 页面滚动时的回调。
-   */
-  function usePageScroll(callback: (payload: PageScrollObject) => any): void
+    /**
+     * 页面滚动时的回调。
+     */
+    usePageScroll(callback: (payload: PageScrollObject) => any): void
 
-  /**
-   * 页面尺寸改变时的回调。
-   */
-  function useResize(callback: () => any): void
+    /**
+     * 页面尺寸改变时的回调。
+     */
+    useResize(callback: () => any): void
 
-  /**
-   * 页面转发时的回调。
-   */
-  function useShareAppMessage(callback: (payload: ShareAppMessageObject) => ShareAppMessageReturn): void
+    /**
+     * 页面转发时的回调。
+     */
+    useShareAppMessage(callback: (payload: ShareAppMessageObject) => ShareAppMessageReturn): void
 
-  /**
-   * 当前是 tab 页时，tab 被点击时的回调。
-   */
-  function useTabItemTap(callback: (payload: TabItemTapObject) => any): void
+    /**
+     * 当前是 tab 页时，tab 被点击时的回调。
+     */
+    useTabItemTap(callback: (payload: TabItemTapObject) => any): void
 
-  /**
-   * 用户点击右上角菜单“收藏”按钮时的回调。
-   */
-  function useAddToFavorites(callback: (paload: AddToFavoritesObject) => AddToFavoritesReturnObject): void
+    /**
+     * 用户点击右上角菜单“收藏”按钮时的回调。
+     */
+    useAddToFavorites(callback: (paload: AddToFavoritesObject) => AddToFavoritesReturnObject): void
 
-  /**
-   * 用户点击右上角菜单“分享到朋友圈”按钮时的回调。
-   */
-  function useShareTimeline(callback: () => ShareTimelineReturnObject): void
+    /**
+     * 用户点击右上角菜单“分享到朋友圈”按钮时的回调。
+     */
+    useShareTimeline(callback: () => ShareTimelineReturnObject): void
 
-  /**
-   * 页面初次渲染完成的回调。
-   * 此时页面已经准备妥当，可以和视图层进行交互。
-   */
-  function useReady(callback: () => any): void
+    /**
+     * 页面初次渲染完成的回调。
+     * 此时页面已经准备妥当，可以和视图层进行交互。
+     */
+    useReady(callback: () => any): void
 
-  /**
-   * 获取当前路由参数。
-   */
-  function useRouter<TParams extends Partial<Record<string, string>> = Partial<Record<string, string>>>(dynamic?: boolean): RouterInfo<TParams>
+    /**
+     * 获取当前路由参数。
+     */
+    useRouter<TParams extends Partial<Record<string, string>> = Partial<Record<string, string>>>(dynamic?: boolean): RouterInfo<TParams>
 
-  /**
-   * 导航栏的标题被点击时的回调。
-   * **仅支付宝小程序支持。**
-   */
-  function useTitleClick(callback: () => any): void
+    /**
+     * 导航栏的标题被点击时的回调。
+     * **仅支付宝小程序支持。**
+     */
+    useTitleClick(callback: () => any): void
 
-  /**
-   * 导航栏的额外图标被点击时的回调。
-   * **仅支付宝小程序支持。**
-   */
-  function useOptionMenuClick(callback: () => any): void
+    /**
+     * 导航栏的额外图标被点击时的回调。
+     * **仅支付宝小程序支持。**
+     */
+    useOptionMenuClick(callback: () => any): void
 
-  /**
-   * 下拉中断时的回调。
-   * **仅支付宝小程序支持。**
-   */
-  function usePullIntercept(callback: () => any): void
+    /**
+     * 下拉中断时的回调。
+     * **仅支付宝小程序支持。**
+     */
+    usePullIntercept(callback: () => any): void
+  }
 }

package/types/taro.lifecycle.d.ts

@@ -1,4 +1,36 @@
-declare namespace Taro {
+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;
+
+interface TaroStaticLifecycle<P, S> {
+  getDerivedStateFromProps?: TaroGetDerivedStateFromProps<P, S>;
+}
+
+interface TaroNewLifecycle<P, S, SS> {
+  /**
+   * Runs before React applies the result of `render` to the document, and
+   * returns an object to be given to componentDidUpdate. Useful for saving
+   * things such as scroll position before `render` causes changes to it.
+   *
+   * Note: the presence of getSnapshotBeforeUpdate prevents any of the deprecated
+   * lifecycle events from running.
+   */
+  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;
+}
+
+declare module './index' {
   interface PageNotFoundObject {
     /**
      * 不存在页面的路径
@@ -8,7 +40,7 @@ declare namespace Taro {
     /**
      * 打开不存在页面的 query
      */
-    query: object
+    query: Record<string, unknown>
 
     /**
      * 是否本次启动的首个页面（例如从分享等入口进来，首个页面是开发者配置的分享页面）
@@ -126,33 +158,20 @@ declare namespace Taro {
     imageUrl?: string
   }
 
-  type GetDerivedStateFromProps<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;
+  type GetDerivedStateFromProps<P, S> = TaroGetDerivedStateFromProps<P, S>
 
-  interface StaticLifecycle<P, S> {
-    getDerivedStateFromProps?: GetDerivedStateFromProps<P, S>;
-  }
+  type StaticLifecycle<P, S> = TaroStaticLifecycle<P, S>
 
-  interface NewLifecycle<P, S, SS> {
-    /**
-     * Runs before React applies the result of `render` to the document, and
-     * returns an object to be given to componentDidUpdate. Useful for saving
-     * things such as scroll position before `render` causes changes to it.
-     *
-     * Note: the presence of getSnapshotBeforeUpdate prevents any of the deprecated
-     * lifecycle events from running.
-     */
-    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;
+  type NewLifecycle<P, S, SS> = TaroNewLifecycle<P, S, SS>
+
+  interface TaroStatic {
+    PageNotFoundObject: PageNotFoundObject
+    PageScrollObject: PageScrollObject
+    ShareAppMessageObject: ShareAppMessageObject
+    ShareAppMessageReturn: ShareAppMessageReturn
+    TabItemTapObject: TabItemTapObject
+    AddToFavoritesObject: AddToFavoritesObject
+    AddToFavoritesReturnObject: AddToFavoritesReturnObject
+    ShareTimelineReturnObject: ShareTimelineReturnObject
   }
 }

package/types/api/ad/index.ts

@@ -1,6 +0,0 @@
-declare namespace Taro {
-  // TODO: wx.createRewardedVideoAd
-  // TODO: wx.createInterstitialAd
-  // TODO: InterstitialAd
-  // TODO: RewardedVideoAd
-}

package/types/api/alipay/index.ts

@@ -1,7 +0,0 @@
-declare namespace Taro {
-  /**
-   * @since 10.1.35
-   * 此接口可获取支付宝会员的基础信息
-   */
-  function getOpenUserInfo(): Promise<string>
-}