@tarojs/taro 3.6.6-alpha.0 → 3.6.6-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.6.6-alpha.0",
+  "version": "3.6.6-alpha.2",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -21,8 +21,11 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.6.6-alpha.0",
-    "@tarojs/runtime": "3.6.6-alpha.0"
+    "@tarojs/api": "3.6.6-alpha.2",
+    "@tarojs/runtime": "3.6.6-alpha.2"
+  },
+  "devDependencies": {
+    "@tarojs/helper": "3.6.6-alpha.2"
   },
   "peerDependenciesMeta": {
     "@types/react": {
@@ -37,8 +40,5 @@
     "vue": {
       "optional": true
     }
-  },
-  "scripts": {
-    "test": "echo \"Error: run tests from root\" && exit 1"
   }
 }

package/types/api/base/crypto.d.ts

@@ -26,7 +26,7 @@ declare module '../../index' {
      * @supported weapp
      * @example
      * ```tsx
-     * Taro.getRandomValues({
+     * Taro.getUserCryptoManager().getRandomValues({
      *   length: 6 // 生成 6 个字节长度的随机数,
      *   success: res => {
      *     console.log(Taro.arrayBufferToBase64(res.randomValues)) // 转换为 base64 字符串后打印
@@ -35,7 +35,7 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/crypto/UserCryptoManager.getRandomValues.html
      */
-    getRandomValues(option: UserCryptoManager.getRandomValues.Option): Promise<UserCryptoManager.getRandomValues.SuccessCallbackResult>
+    getRandomValues(option: UserCryptoManager.getRandomValues.Option): void
   }
 
   namespace UserCryptoManager {
@@ -66,7 +66,7 @@ declare module '../../index' {
         /** 整数，生成随机数的字节数，最大 1048576 */
         length: number
         /** 接口调用成功的回调函数 */
-        success?: (res: TaroGeneral.CallbackResult) => void
+        success?: (res: SuccessCallbackResult) => void
         /** 接口调用失败的回调函数 */
         fail?: (res: TaroGeneral.CallbackResult) => void
         /** 接口调用结束的回调函数（调用成功、失败都会执行） */
@@ -86,5 +86,19 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/crypto/wx.getUserCryptoManager.html
      */
     getUserCryptoManager(): UserCryptoManager
+
+    /** 获取密码学安全随机数
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.getRandomValues({
+     *   length: 6 // 生成 6 个字节长度的随机数
+     * }).then(res => {
+     *   console.log(Taro.arrayBufferToBase64(res.randomValues)) // 转换为 base64 字符串后打印
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/crypto/UserCryptoManager.getRandomValues.html
+     */
+    getRandomValues(option: UserCryptoManager.getRandomValues.Option): Promise<UserCryptoManager.getRandomValues.SuccessCallbackResult>
   }
 }

package/types/api/taro.extend.d.ts

@@ -0,0 +1,203 @@
+import React from 'react'
+
+import Taro from '../index'
+
+declare module '../index' {
+  namespace getAppInfo {
+    /** 应用信息 */
+    interface AppInfo {
+      platform: string
+      taroVersion: string
+      designWidth: number | ((size?: string | number) => number)
+    }
+  }
+
+  namespace getCurrentInstance {
+    interface Current {
+      app: AppInstance | null
+      router: RouterInfo | null
+      page: PageInstance | null
+      onReady: string
+      onHide: string
+      onShow: string
+      preloadData?: Record<any, any>
+      /**
+       * RN 私有对象navigationRef，用于使用底层接口控制路由
+       */
+      rnNavigationRef?: React.RefObject<any>
+    }
+  }
+
+  namespace setGlobalDataPlugin {
+    /** Vue3 插件，用于设置 `getApp()` 中的全局变量 */
+    interface Plugin {
+      install (app: any, data: any): void
+    }
+  }
+
+    /** @ignore */
+  interface TARO_ENV_TYPE {
+    [TaroGeneral.ENV_TYPE.WEAPP]: TaroGeneral.ENV_TYPE.WEAPP
+    [TaroGeneral.ENV_TYPE.WEB]: TaroGeneral.ENV_TYPE.WEB
+    [TaroGeneral.ENV_TYPE.RN]: TaroGeneral.ENV_TYPE.RN
+    [TaroGeneral.ENV_TYPE.SWAN]: TaroGeneral.ENV_TYPE.SWAN
+    [TaroGeneral.ENV_TYPE.ALIPAY]: TaroGeneral.ENV_TYPE.ALIPAY
+    [TaroGeneral.ENV_TYPE.TT]: TaroGeneral.ENV_TYPE.TT
+    [TaroGeneral.ENV_TYPE.QQ]: TaroGeneral.ENV_TYPE.QQ
+    [TaroGeneral.ENV_TYPE.JD]: TaroGeneral.ENV_TYPE.JD
+  }
+
+  namespace interceptorify {
+    type promiseifyApi<T, R> = (requestParams: T) => Promise<R>
+    interface InterceptorifyChain<T, R> {
+      requestParams: T
+      proceed: promiseifyApi<T, R>
+    }
+    type InterceptorifyInterceptor<T, R> = (chain: InterceptorifyChain<T, R>) => Promise<R>
+    interface Interceptorify<T, R> {
+      request(requestParams: T): Promise<R>
+      addInterceptor( interceptor: InterceptorifyInterceptor<T, R>): void
+      cleanInterceptors(): void
+    }
+  }
+
+  interface TaroStatic {
+    /** @ignore */
+    Events: {
+      new (): TaroGeneral.Events
+    }
+
+    /** 事件中心
+     * @supported global
+     */
+    eventCenter: TaroGeneral.Events
+
+    /** @ignore */
+    ENV_TYPE: TARO_ENV_TYPE
+
+    /** 获取环境变量
+     * @supported global
+     */
+    getEnv(): TaroGeneral.ENV_TYPE
+
+    /** 尺寸转换
+     * @supported global
+     */
+    pxTransform(size: number, designWidth?: number): string
+
+    /** 尺寸转换初始化
+     * @supported global
+     */
+    initPxTransform(config: {
+      baseFontSize?: number
+      deviceRatio?: TaroGeneral.TDeviceRatio
+      designWidth?: number | ((size?: string | number) => number)
+      targetUnit?: string
+      unitPrecision?: number
+    }): void
+
+    /** @ignore */
+    initAppInfo(appInfo: getAppInfo.AppInfo): void
+
+    /** 小程序获取和 Taro 相关的 App 信息
+     * @supported weapp, alipay, jd, qq, swan, tt, h5
+     */
+    getAppInfo(): getAppInfo.AppInfo
+
+    /** 小程序引用插件 JS 接口
+     * @supported weapp, alipay, h5, rn, jd, qq, swan, tt, quickapp
+     */
+    requirePlugin(pluginName: string): any
+
+    /** 获取当前页面实例
+     * @supported global
+     */
+    getCurrentInstance(): getCurrentInstance.Current
+
+    /** @ignore */
+    Current: getCurrentInstance.Current
+
+    /** Vue3 插件，用于设置 `getApp()` 中的全局变量
+     * @supported weapp, alipay, h5, rn, jd, qq, swan, tt, quickapp
+     * @example
+     * ```js
+     * // 使用插件
+     * const App = createApp(...)
+     * App.use(setGlobalDataPlugin, {
+     *   xxx: 999
+     * })
+     * // 获取全局变量
+     * Taro.getApp().xxx
+     * ```
+     */
+    setGlobalDataPlugin: setGlobalDataPlugin.Plugin
+
+    /** 获取自定义 TabBar 对应的 React 或 Vue 组件实例
+     * @supported weapp
+     * @param page 小程序页面对象，可以通过 Taro.getCurrentInstance().page 获取
+     */
+    getTabBar<T>(page: getCurrentInstance.Current['page']): T | undefined
+
+    /** 获取当前页面渲染引擎类型
+     * @supported weapp
+     */
+    getRenderer(): 'webview' | 'skyline'
+
+    /**
+     * 包裹 promiseify api 的洋葱圈模型
+     * @supported global
+     * @param promiseifyApi
+     * @example
+     * ```tsx
+     * // 创建实例
+     * const modalInterceptorify = interceptorify(taro.showModal)
+     * // 添加拦截器
+     * modalInterceptorify.addInterceptor(async function (chain) {
+     *   const res = await chain.proceed({
+     *     ...chain.requestParams,
+     *     title: 'interceptor1'
+     *   })
+     *   return res
+     * })
+     * modalInterceptorify.addInterceptor(async function (chain) {
+     *   const res = await chain.proceed({
+     *     ...chain.requestParams,
+     *     content: 'interceptor2'
+     *   })
+     *   return res
+     * })
+     * // 使用
+     * modalInterceptorify.request({})
+     * ```
+     * @example
+     * ```tsx
+     * // 创建实例
+     * const fetchDataInterceptorify = interceptorify(taro.request)
+     * // 添加拦截器
+     * fetchDataInterceptorify.addInterceptor(async function (chain) {
+     *   taro.showLoading({
+     *     title: 'Loading...'
+     *   })
+     *   const res = await chain.proceed(chain.requestParams)
+     *   taro.hideLoading()
+     *   return res
+     * })
+     * fetchDataInterceptorify.addInterceptor(async function (chain) {
+     *   const params = chain.requestParams
+     *   const res = await chain.proceed({
+     *     url: 'http://httpbin.org' + params.url,
+     *   })
+     *   return res.data
+     * })
+     * // 使用
+     * fetchDataInterceptorify.request({
+     *   url: '/ip'
+     * }).then((res) => {
+     *   // log my ip
+     *   console.log(res.origin)
+     * })
+     * ```
+     */
+    interceptorify<T, R>(promiseifyApi: interceptorify.promiseifyApi<T, R>): interceptorify.Interceptorify<T, R>
+  }
+}

package/types/{taro.hooks.d.ts → api/taro.hooks.d.ts}

@@ -1,6 +1,6 @@
-import Taro from './index'
+import Taro from '../index'
 
-declare module './index' {
+declare module '../index' {
   interface TaroStatic {
     /**
      * 页面展示时的回调。
@@ -46,7 +46,7 @@ declare module './index' {
 
     /**
      * 当前是 tab 页时，tab 被点击时的回调。
-     * @supported weapp, rn
+     * @supported weapp, h5, rn
      */
     useTabItemTap(callback: (payload: TabItemTapObject) => void): void
 

package/types/compile/compiler.d.ts

@@ -1,4 +1,4 @@
-import type swc from '@swc/core'
+import type { swc } from '@tarojs/helper'
 import type Webpack from 'webpack'
 
 type CompilerTypes = 'webpack4' | 'webpack5'

package/types/compile/config/project.d.ts

@@ -24,7 +24,7 @@ export interface IProjectBaseConfig {
   port?: number
   projectName?: string
   date?: string
-  designWidth?: number | ((size: number) => number)
+  designWidth?: number | ((size?: string | number) => number)
   deviceRatio?: TaroGeneral.TDeviceRatio
   watcher?: any[]
   sourceRoot?: string

package/types/index.d.ts

@@ -108,13 +108,13 @@
  * │   │   └── interaction.d.ts             界面 -> 交互 API
  * │   ├── worker
  * │   │   └── index.d.ts                   Worker API
- * │   └── wxml
- * │       └── index.d.ts                   WXML API
+ * │   ├── wxml
+ * │   │   └── index.d.ts                   WXML API
+ * │   ├── taro.extend.d.ts                 Taro 扩展 API 类型定义
+ * │   └── taro.hooks.d.ts                  Taro Hooks 类型定义
  * ├── index.d.ts                           此文件
  * ├── taro.component.d.ts                  Taro Component 类型定义
- * ├── taro.config.d.ts                     Taro 小程序 App 与 Window 设置类型定义
- * ├── taro.extend.d.ts                     Taro 扩展 API 类型定义
- * ├── taro.hooks.d.ts                      Taro Hooks 类型定义
+ * ├── taro.config.d.ts                      Taro 小程序 App 与 Window 设置类型定义
  * └── taro.lifecycle.d.ts                  Taro 生命周期类型定义
  */
 
@@ -123,8 +123,6 @@
 /// <reference path="taro.api.d.ts" />
 /// <reference path="taro.component.d.ts" />
 /// <reference path="taro.config.d.ts" />
-/// <reference path="taro.extend.d.ts" />
-/// <reference path="taro.hooks.d.ts" />
 /// <reference path="taro.lifecycle.d.ts" />
 
 /// <reference types="@tarojs/plugin-platform-alipay/types/shims-alipay" />

package/types/taro.api.d.ts

@@ -2,7 +2,7 @@
  *
  * 微信端能力
  * original code from: https://github.com/wx-minapp/minapp-wx/blob/master/typing/wx.d.ts
- * Lincenced under MIT license: https://github.com/qiu8310/minapp/issues/69
+ * Licensed under MIT license: https://github.com/qiu8310/minapp/issues/69
  * thanks for the great work by @qiu8310 👍👍👍
  *
  */
@@ -110,3 +110,6 @@
 /// <reference path="api/alipay/index.d.ts" />
 /// <reference path="api/qq/index.d.ts" />
 /// <reference path="api/swan/index.d.ts" />
+
+/// <reference path="api/taro.extend.d.ts" />
+/// <reference path="api/taro.hooks.d.ts" />

package/types/taro.component.d.ts

@@ -1,7 +1,7 @@
 import React from 'react'
 import Vue from 'vue'
 
-import Taro, { Config } from './index'
+import Taro from './index'
 
 declare module './index' {
   // ref: packages/taro-runtime/src/current.ts

package/types/taro.extend.d.ts

@@ -1,122 +0,0 @@
-import React from 'react'
-
-import Taro from './index'
-
-declare module './index' {
-  type MessageType = 'info' | 'success' | 'error' | 'warning'
-
-  interface AtMessageOptions {
-    message: string
-    type?: MessageType
-    duration?: number
-  }
-
-  interface AppInfo {
-    platform: string,
-    taroVersion: string
-    designWidth: number
-  }
-
-  interface RequestParams<T=any> extends request.Option<T, any> {
-    [propName: string]: any
-  }
-
-  interface Current {
-    app: AppInstance | null
-    router: RouterInfo | null
-    page: PageInstance | null
-    onReady: string
-    onHide: string
-    onShow: string
-    preloadData?: Record<any, any>
-    /**
-     * RN 私有对象navigationRef，用于使用底层接口控制路由
-     */
-    rnNavigationRef?: React.RefObject<any>
-  }
-
-  interface SetGlobalDataPlugin {
-    install (app: any, data: any): void
-  }
-
-  interface TARO_ENV_TYPE {
-    [TaroGeneral.ENV_TYPE.WEAPP]: TaroGeneral.ENV_TYPE.WEAPP
-    [TaroGeneral.ENV_TYPE.WEB]: TaroGeneral.ENV_TYPE.WEB
-    [TaroGeneral.ENV_TYPE.RN]: TaroGeneral.ENV_TYPE.RN
-    [TaroGeneral.ENV_TYPE.SWAN]: TaroGeneral.ENV_TYPE.SWAN
-    [TaroGeneral.ENV_TYPE.ALIPAY]: TaroGeneral.ENV_TYPE.ALIPAY
-    [TaroGeneral.ENV_TYPE.TT]: TaroGeneral.ENV_TYPE.TT
-    [TaroGeneral.ENV_TYPE.QQ]: TaroGeneral.ENV_TYPE.QQ
-    [TaroGeneral.ENV_TYPE.JD]: TaroGeneral.ENV_TYPE.JD
-  }
-
-  interface TaroStatic {
-    Events: {
-      new (): TaroGeneral.Events
-    }
-
-    /** 事件中心
-     * @supported global
-     */
-    eventCenter: TaroGeneral.Events
-
-    ENV_TYPE: TARO_ENV_TYPE
-
-    /** 获取环境变量
-     * @supported global
-     */
-    getEnv(): TaroGeneral.ENV_TYPE
-
-    /** 尺寸转换
-     * @supported global
-     */
-    pxTransform(size: number, designWidth?: number): string
-
-    /** 尺寸转换初始化
-     * @supported global
-     */
-    initPxTransform(config: {
-      baseFontSize?: number
-      deviceRatio?: TaroGeneral.TDeviceRatio
-      designWidth?: number
-      targetUnit?: string
-      unitPrecision?: number
-    }): void
-
-    initAppInfo(appInfo: AppInfo): void
-
-    getAppInfo(): AppInfo
-
-    /** 小程序引用插件 JS 接口
-     * @supported weapp, alipay, h5, rn, jd, qq, swan, tt, quickapp
-     */
-    requirePlugin(pluginName: string): any
-
-    /** 获取当前页面实例
-     * @supported global
-     */
-    getCurrentInstance(): Current
-    Current: Current
-
-    /** Vue3 插件，用于设置 `getApp()` 中的全局变量
-     * @supported weapp, alipay, h5, rn, jd, qq, swan, tt, quickapp
-     * @example
-     * ```js
-     * // 使用插件
-     * const App = createApp(...)
-     * App.use(setGlobalDataPlugin, {
-     *   xxx: 999
-     * })
-     * // 获取全局变量
-     * Taro.getApp().xxx
-     * ```
-     */
-    setGlobalDataPlugin: SetGlobalDataPlugin
-
-    /** 获取自定义 TabBar 对应的 React 或 Vue 组件实例
-     * @supported weapp
-     * @param page 小程序页面对象，可以通过 Taro.getCurrentInstance().page 获取
-     */
-    getTabBar<T>(page: Current['page']): T | undefined
-  }
-}