@tarojs/taro 3.6.2 → 3.6.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.6.2",
+  "version": "3.6.4",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -21,8 +21,8 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.6.2",
-    "@tarojs/runtime": "3.6.2"
+    "@tarojs/api": "3.6.4",
+    "@tarojs/runtime": "3.6.4"
   },
   "peerDependenciesMeta": {
     "@types/react": {

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

@@ -4,7 +4,7 @@ declare module '../../index' {
   namespace openEmbeddedMiniProgram {
     interface Option {
       /** 要打开的小程序 appId */
-      appId: string
+      appId?: string
       /** 打开的页面路径，如果为空则打开首页。path 中 ? 后面的部分会成为 query，在小程序的 `App.onLaunch`、`App.onShow` 和 `Page.onLoad` 的回调函数或小游戏的 [Taro.onShow](#) 回调函数、[Taro.getLaunchOptionsSync](/docs/apis/base/weapp/life-cycle/getLaunchOptionsSync) 中可以获取到 query 数据。对于小游戏，可以只传入 query 部分，来实现传参效果，如：传入 "?foo=bar"。 */
       path?: string
       /** 需要传递给目标小程序的数据，目标小程序可在 `App.onLaunch`，`App.onShow` 中获取到这份数据。如果跳转的是小游戏，可以在 [Taro.onShow](#)、[Taro.getLaunchOptionsSync](/docs/apis/base/weapp/life-cycle/getLaunchOptionsSync) 中可以获取到这份数据数据。 */
@@ -45,7 +45,7 @@ declare module '../../index' {
   namespace navigateToMiniProgram {
     interface Option {
       /** 要打开的小程序 appId */
-      appId: string
+      appId?: string
       /** 打开的页面路径，如果为空则打开首页。path 中 ? 后面的部分会成为 query，在小程序的 `App.onLaunch`、`App.onShow` 和 `Page.onLoad` 的回调函数或小游戏的 [Taro.onShow](#) 回调函数、[Taro.getLaunchOptionsSync](/docs/apis/base/weapp/life-cycle/getLaunchOptionsSync) 中可以获取到 query 数据。对于小游戏，可以只传入 query 部分，来实现传参效果，如：传入 "?foo=bar"。 */
       path?: string
       /** 需要传递给目标小程序的数据，目标小程序可在 `App.onLaunch`，`App.onShow` 中获取到这份数据。如果跳转的是小游戏，可以在 [Taro.onShow](#)、[Taro.getLaunchOptionsSync](/docs/apis/base/weapp/life-cycle/getLaunchOptionsSync) 中可以获取到这份数据数据。 */

package/types/api/network/request.d.ts

@@ -150,6 +150,8 @@ declare module '../../index' {
       POST
       /** HTTP 请求 PUT */
       PUT
+      /** HTTP 请求 PATCH */
+      PATCH
       /** HTTP 请求 DELETE */
       DELETE
       /** HTTP 请求 TRACE */
@@ -304,12 +306,8 @@ declare module '../../index' {
     namespace onChunkReceived {
       /** Transfer-Encoding Chunk Received 事件的回调函数 */
       type Callback = (result: CallbackResult) => void
-      interface CallbackResult {
-        /** 开发者服务器每次返回新 chunk 时的 Response */
-        res: Response
-      }
       /** 开发者服务器每次返回新 chunk 时的 Response */
-      interface Response {
+      interface CallbackResult {
         /** 返回的chunk buffer */
         data: ArrayBuffer
       }

package/types/api/ui/window.d.ts

@@ -60,5 +60,12 @@ declare module '../../index' {
       /** 窗口尺寸变化事件的回调函数 */
       callback: offWindowResize.Callback,
     ): void
+
+    /**
+     * 返回当前是否存在小窗播放（小窗在 video/live-player/live-pusher 下可用）
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/window/wx.checkIsPictureInPictureActive.html
+     */
+    checkIsPictureInPictureActive(): boolean
   }
 }

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

@@ -304,7 +304,7 @@ declare module '../../index' {
   namespace NodesRef {
     /** 回调函数，在执行 `SelectorQuery.exec` 方法后，节点信息会在 `callback` 中返回。 */
     type BoundingClientRectCallback = (
-      result: BoundingClientRectCallbackResult,
+      result: BoundingClientRectCallbackResult | BoundingClientRectCallbackResult[],
     ) => void
     interface BoundingClientRectCallbackResult {
       /** 节点的下边界坐标 */

package/types/compile/compiler.d.ts

@@ -19,7 +19,7 @@ interface IPrebundle {
 
 interface ICompiler {
   type: CompilerTypes
-  prebundle: IPrebundle
+  prebundle?: IPrebundle
 }
 
 export type Compiler = CompilerTypes | ICompiler

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

@@ -40,6 +40,7 @@ export interface IH5Config {
   miniCssExtractPluginOption?: IOption
   esnextModules?: string[]
   useHtmlComponents?: boolean
+  useDeprecatedAdapterComponent?: boolean
 
   postcss?: IPostcssOption
   htmlPluginOption?: HtmlWebpackPlugin.Options

package/types/compile/hooks.d.ts

@@ -1,7 +1,7 @@
 type Tagname = string
 type Attrs = Set<string>
 
-interface IComponentConfig {
+export interface IComponentConfig {
   includes: Set<string>
   exclude: Set<string>
   thirdPartyComponents: Map<Tagname, Attrs>

package/types/global.d.ts

@@ -410,13 +410,15 @@ declare namespace TaroGeneral {
   // ENV_TYPE
   enum ENV_TYPE {
     WEAPP = 'WEAPP',
-    WEB = 'WEB',
-    RN = 'RN',
     SWAN = 'SWAN',
     ALIPAY = 'ALIPAY',
     TT = 'TT',
     QQ = 'QQ',
-    JD = 'JD'
+    JD = 'JD',
+    WEB = 'WEB',
+    RN = 'RN',
+    HARMONY = 'HARMONY',
+    QUICKAPP = 'QUICKAPP'
   }
 
   type TDeviceRatio = Record<string, number>

package/types/taro.extend.d.ts

@@ -69,7 +69,13 @@ declare module './index' {
     /** 尺寸转换初始化
      * @supported global
      */
-    initPxTransform(config: { designWidth: number; deviceRatio: TaroGeneral.TDeviceRatio }): void
+    initPxTransform(config: {
+      baseFontSize?: number
+      deviceRatio?: TaroGeneral.TDeviceRatio
+      designWidth?: number
+      targetUnit?: string
+      unitPrecision?: number
+    }): void
 
     /** 小程序引用插件 JS 接口
      * @supported weapp, alipay, h5, rn, jd, qq, swan, tt, quickapp

package/types/taro.lifecycle.d.ts

@@ -67,25 +67,19 @@ declare module './index' {
      * 转发事件来源
      * `button`：页面内转发按钮
      * `menu`：右上角转发菜单
-     *
-     * @since 1.2.4
      */
     from?: 'button' | 'menu' | string
     /**
      * 如果 `from` 值是 `button`，则 `target` 是触发这次转发事件的 `button`，否则为 `undefined`
-     *
-     * @since 1.2.4
      */
     target?: object
     /**
      * 页面中包含 `<web-view>` 组件时，返回当前 `<web-view>` 的 url
-     *
-     * @since 1.6.4
      */
     webViewUrl?: string
   }
 
-  interface ShareAppMessageReturn {
+  interface ShareAppMessageReturnObject {
     /**
      * 	转发标题，默认为当前小程序名称
      */
@@ -101,12 +95,44 @@ declare module './index' {
      * 支持PNG及JPG
      * 显示图片长宽比是 5:4
      * 默认使用截图
-     *
-     * @since 1.5.0
      */
     imageUrl?: string
   }
 
+  interface WeappShareAppMessageReturnObject extends ShareAppMessageReturnObject {
+    /**
+     * 如果该参数存在，则以 resolve 结果为准，如果三秒内不 resolve，分享会使用上面传入的默认参数
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/reference/api/Page.html#onShareAppMessage-Object-object
+     * @example
+     * ```tsx
+     * import { ShareAppMessageReturnObject, useShareAppMessage } from "@tarojs/taro";
+     * // ... else code
+     * useShareAppMessage(() => {
+     *   const p = new Promise<ShareAppMessageReturnObject>(resolve => {
+     *     setTimeout(() => {
+     *       resolve({
+     *         title: "",
+     *         imageUrl: "",
+     *         path: ""
+     *       })
+     *     }, 2000)
+     *   })
+     *   return {
+     *     title: "",
+     *     imageUrl: "",
+     *     path: "",
+     *     promise: p
+     *   }
+     * });
+     * ```
+     *
+     */
+    promise: Promise<ShareAppMessageReturnObject>
+  }
+
+  type ShareAppMessageReturn = ShareAppMessageReturnObject | Promise<ShareAppMessageReturnObject> | WeappShareAppMessageReturnObject
+
   interface TabItemTapObject {
     /**
      * 被点击tabItem的序号，从 0 开始