@tarojs/taro 3.5.0-beta.2 → 3.5.0-beta.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.5.0-beta.2",
+  "version": "3.5.0-beta.3",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -24,8 +24,8 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.5.0-beta.2",
-    "@tarojs/runtime": "3.5.0-beta.2"
+    "@tarojs/api": "3.5.0-beta.3",
+    "@tarojs/runtime": "3.5.0-beta.3"
   },
   "peerDependenciesMeta": {
     "@types/react": {
@@ -41,5 +41,5 @@
       "optional": true
     }
   },
-  "gitHead": "c85adaa45959e6cafc15e6531f4735a7dfa2aab0"
+  "gitHead": "bd1aa21707e51500eac9b16526e4ba4171fa8e5f"
 }

package/types/api/base/weapp/app-event.d.ts

@@ -28,19 +28,58 @@ declare module '../../../index' {
       path: string
       /** 小程序切前台的 query 参数 */
       query: TaroGeneral.IAnyObject
-      /** 来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 `{}`。(参见后文注意) */
-      referrerInfo: ResultReferrerInfo
-      /** 小程序切前台的[场景值](https://developers.weixin.qq.com/miniprogram/dev/framework/app-service/scene.html) */
-      scene: number
       /** shareTicket，详见[获取更多转发信息](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/share.html) */
       shareTicket: string
+      /** 小程序切前台的[场景值](https://developers.weixin.qq.com/miniprogram/dev/framework/app-service/scene.html) */
+      scene: number
+      /** 来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 `{}`。(参见后文注意) */
+      referrerInfo: ResultReferrerInfo
+      /** 打开的文件信息数组，只有从聊天素材场景打开（scene为1173）才会携带该参数 */
+      forwardMaterials?: ForwardMaterial[]
+      /** 从微信群聊/单聊打开小程序时，chatType 表示具体微信群聊/单聊类型 */
+      chatType?: keyof ChatType
+      /** API 类别 */
+      apiCategory?: keyof ApiCategory
     }
     /** 来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 `{}`。(参见后文注意) */
     interface ResultReferrerInfo {
       /** 来源小程序、公众号或 App 的 appId */
-      appId: string
+      appId?: string
       /** 来源小程序传过来的数据，scene=1037或1038时支持 */
-      extraData: TaroGeneral.IAnyObject
+      extraData?: TaroGeneral.IAnyObject
+    }
+    /** ChatType 类型合法值 */
+    interface ForwardMaterial {
+      /** 文件的mimetype类型 */
+      type: string
+      /** 文件名 */
+      name: string
+      /** 文件路径（如果是webview则是url） */
+      path: string
+      /** 文件大小 */
+      size: number
+    }
+    /** ChatType 类型合法值 */
+    interface ChatType {
+      /** 微信联系人单聊 */
+      1
+      /** 企业微信联系人单聊 */
+      2
+      /** 普通微信群聊 */
+      3
+      /** 企业微信互通群聊 */
+      4
+    }
+    /** API 类别合法值 */
+    interface ApiCategory {
+      /** 默认类别 */
+      default
+      /** 原生功能化，视频号直播商品、商品橱窗等场景打开的小程序 */
+      nativeFunctionalized
+      /** 仅浏览，朋友圈快照页等场景打开的小程序 */
+      browseOnly
+      /** 内嵌，通过打开半屏小程序能力打开的小程序 */
+      embedded
     }
   }
 
@@ -71,7 +110,7 @@ declare module '../../../index' {
 
   interface TaroStatic {
     /** 监听未处理的 Promise 拒绝事件。该事件与 [`App.onUnhandledRejection`](https://developers.weixin.qq.com/miniprogram/dev/reference/api/App.html#onUnhandledRejection-Object-object) 的回调时机与参数一致。
-     * 
+     *
      * **注意**
      *  - 所有的 unhandledRejection 都可以被这一监听捕获，但只有 Error 类型的才会在小程序后台触发报警。
      * @supported weapp, tt
@@ -139,7 +178,7 @@ declare module '../../../index' {
      * **注意**
      *
      * 部分版本在无`referrerInfo`的时候会返回 `undefined`，建议使用 `options.referrerInfo && options.referrerInfo.appId` 进行判断。
-     * @supported weapp, tt
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/app/app-event/wx.onAppShow.html
      */
     onAppShow(
@@ -148,7 +187,7 @@ declare module '../../../index' {
     ): void
 
     /** 监听小程序切后台事件。该事件与 [`App.onHide`](https://developers.weixin.qq.com/miniprogram/dev/reference/api/App.html#onhide) 的回调时机一致。
-     * @supported weapp, tt
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/app/app-event/wx.onAppHide.html
      */
     onAppHide(
@@ -206,7 +245,7 @@ declare module '../../../index' {
     ): void
 
     /** 取消监听小程序切前台事件
-     * @supported weapp, tt
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/app/app-event/wx.offAppShow.html
      */
     offAppShow(
@@ -215,7 +254,7 @@ declare module '../../../index' {
     ): void
 
     /** 取消监听小程序切后台事件
-     * @supported weapp, tt
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/app/app-event/wx.offAppHide.html
      */
     offAppHide(

package/types/api/base/weapp/life-cycle.d.ts

@@ -21,14 +21,14 @@ declare module '../../../index' {
       /** API 类别 */
       apiCategory?: keyof LaunchOptions.ApiCategory
     }
-  
+
     namespace LaunchOptions {
       /** 来源信息 */
       interface ReferrerInfo {
         /** 来源小程序、公众号或 App 的 appId */
-        appId: string
+        appId?: string
         /** 来源小程序传过来的数据，scene=1037或1038时支持 */
-        extraData: TaroGeneral.IAnyObject
+        extraData?: TaroGeneral.IAnyObject
       }
       /** ChatType 类型合法值 */
       interface ForwardMaterial {
@@ -86,14 +86,14 @@ declare module '../../../index' {
       /** API 类别 */
       apiCategory?: keyof EnterOptions.ApiCategory
     }
-  
+
     namespace EnterOptions {
       /** 来源信息 */
       interface ReferrerInfo {
         /** 来源小程序、公众号或 App 的 appId */
-        appId: string
+        appId?: string
         /** 来源小程序传过来的数据，scene=1037或1038时支持 */
-        extraData: TaroGeneral.IAnyObject
+        extraData?: TaroGeneral.IAnyObject
       }
       /** ChatType 类型合法值 */
       interface ForwardMaterial {

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',
@@ -195,6 +197,7 @@ export interface IH5Config {
   useHtmlComponents?: boolean
 
   postcss?: IPostcssOption
+  htmlPluginOption?: HtmlWebpackPlugin.Options
 }
 
 type FeatureItem = {
@@ -368,6 +371,7 @@ interface IPrebundle {
   include?: string[]
   exclude?: string[]
   esbuild?: Record<string, any>
+  swc?: swc.Config
   webpack?: {
     provide?: any[]
   }

package/types/global.d.ts

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

package/types/taro.component.d.ts

@@ -47,6 +47,7 @@ declare module './index' {
 
     shareTicket: string | undefined
     scene: number | undefined
+    exitState?: any
   }
   interface Component<P = {}, S = {}, SS = any> extends ComponentLifecycle<P, S, SS> {
     $scope?: any

package/types/taro.config.d.ts

@@ -359,6 +359,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.hooks.d.ts

@@ -52,6 +52,30 @@ declare module './index' {
      */
     useShareTimeline(callback: () => ShareTimelineReturnObject): void
 
+    /**
+     * 页面销毁前保留状态回调
+     * **仅微信小程序支持。**
+     */
+    useSaveExitState(callback: () => {
+      data: Record<any, any>
+      expireTimeStamp?: number
+    }): void
+
+    /**
+     * 小程序初始化完成时的回调。
+     */
+    useLaunch(callback: (options: getLaunchOptionsSync.LaunchOptions) => void): void
+
+    /**
+     * 小程序发生脚本错误或 API 调用报错时触发的回调。
+     */
+    useError(callback: (error: string) => void): void
+
+    /**
+     * 小程序要打开的页面不存在时触发的回调。
+     */
+    usePageNotFound(callback: (res: { path: string, query: Record<any, any>, isEntryPage: boolean, [key: string]: any }) => void): void
+
     /**
      * 页面加载完成时的回调。
      */