@tarojs/taro 3.4.0-beta.0 → 3.4.0-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.4.0-beta.0",
+  "version": "3.4.0-beta.1",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -26,9 +26,9 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.4.0-beta.0",
-    "@tarojs/runtime": "3.4.0-beta.0",
-    "@tarojs/taro-h5": "3.4.0-beta.0"
+    "@tarojs/api": "3.4.0-beta.1",
+    "@tarojs/runtime": "3.4.0-beta.1",
+    "@tarojs/taro-h5": "3.4.0-beta.1"
   },
-  "gitHead": "107670bc2360ee9136a0e558e6d5fad1db640fba"
+  "gitHead": "bd7b3674278d22f71e2658b530cc0be24bf9964e"
 }

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

@@ -69,7 +69,7 @@ declare module '../../../index' {
      * - 开发者可以在回调中进行页面重定向，但必须在回调中**同步**处理，异步处理（例如 `setTimeout` 异步执行）无效。
      * - 若开发者没有调用 [Taro.onPageNotFound](https://developers.weixin.qq.com/miniprogram/dev/api/base/app/app-event/wx.onPageNotFound.html) 绑定监听，也没有声明 `App.onPageNotFound`，当跳转页面不存在时，将推入微信客户端原生的页面不存在提示页面。
      * - 如果回调中又重定向到另一个不存在的页面，将推入微信客户端原生的页面不存在提示页面，并且不再第二次回调。
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/app/app-event/wx.onPageNotFound.html
      */
     onPageNotFound(callback: onPageNotFound.Callback): void

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

@@ -1374,7 +1374,7 @@ declare module '../../index' {
     /** 阴影的模糊级别 */
     shadowBlur: number
     /** 阴影的颜色 */
-    shadowColor: number
+    shadowColor: string
     /** 阴影相对于形状在水平方向的偏移 */
     shadowOffsetX: number
     /** 阴影相对于形状在竖直方向的偏移 */

package/types/api/device/compass.d.ts

@@ -94,7 +94,7 @@ declare module '../../index' {
     ): void
 
     /** 取消监听罗盘数据变化事件，参数为空，则取消所有的事件监听。
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/compass/wx.offCompassChange.html
      */
     offCompassChange(

package/types/api/media/image.d.ts

@@ -122,6 +122,8 @@ declare module '../../index' {
       sourceType?: Array<keyof sourceType>
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult) => void
+      /** 用来上传的input元素ID（仅h5端）@supported h5 */
+      imageId?: string
     }
     /** 图片的尺寸 */
     interface sizeType {

package/types/api/media/video.d.ts

@@ -191,6 +191,6 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.chooseVideo.html
      */
-    chooseVideo(option: chooseVideo.Option): Promise<void>
+    chooseVideo(option: chooseVideo.Option): Promise<chooseVideo.SuccessCallbackResult>
   }
 }

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

@@ -58,6 +58,12 @@ declare module '../../index' {
       /** 已经下载的数据长度，单位 Bytes */
       totalBytesWritten: number
     }
+
+    type DownloadTaskPromise = Promise<DownloadTask> & {
+      headersReceive: DownloadTask['onHeadersReceived'],
+      progress: DownloadTask['onProgressUpdate'],
+      abort: DownloadTask['abort']
+    }
   }
 
   interface DownloadTask {
@@ -121,6 +127,6 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/download/wx.downloadFile.html
      */
-    downloadFile(option: downloadFile.Option): DownloadTask
+    downloadFile(option: downloadFile.Option): DownloadTask.DownloadTaskPromise
   }
 }

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

@@ -67,6 +67,12 @@ declare module '../../index' {
       /** 已经上传的数据长度，单位 Bytes */
       totalBytesSent: number
     }
+
+    type UploadTaskPromise = Promise<UploadTask> & {
+      headersReceive: UploadTask['onHeadersReceived'],
+      progress: UploadTask['onProgressUpdate'],
+      abort: UploadTask['abort']
+    }
   }
 
   /** 一个可以监听上传进度变化事件，以及取消上传任务的对象
@@ -166,6 +172,6 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/network/upload/wx.uploadFile.html
      */
-    uploadFile(option: uploadFile.Option): Promise<uploadFile.SuccessCallbackResult & UploadTask> & UploadTask
+    uploadFile(option: uploadFile.Option): UploadTask.UploadTaskPromise
   }
 }

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

@@ -10,6 +10,11 @@ declare module '../../index' {
       /** 动画的效果 */
       timingFunction?: keyof timingFunction
       transformOrigin?: string
+      /**
+       * 单位
+       * @supported h5
+       */
+      unit?: string
     }
     interface timingFunction {
       /** 动画从头到尾的速度是相同的 */
@@ -31,14 +36,14 @@ declare module '../../index' {
 
   interface Animation {
     /** 导出动画队列。**export 方法每次调用后会清掉之前的动画操作。**
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.export.html
      */
     export(): {
       actions: TaroGeneral.IAnyObject[]
     }
     /** 设置背景色
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.backgroundColor.html
      */
     backgroundColor(
@@ -46,7 +51,7 @@ declare module '../../index' {
       value: string,
     ): Animation
     /** 设置 bottom 值
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.bottom.html
      */
     bottom(
@@ -54,7 +59,7 @@ declare module '../../index' {
       value: number | string,
     ): Animation
     /** 设置高度
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.height.html
      */
     height(
@@ -62,7 +67,7 @@ declare module '../../index' {
       value: number | string,
     ): Animation
     /** 设置 left 值
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.left.html
      */
     left(
@@ -70,17 +75,17 @@ declare module '../../index' {
       value: number | string,
     ): Animation
     /** 同 [transform-function matrix](https://developer.mozilla.org/en-US/docs/Web/CSS/transform-function/matrix)
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.matrix.html
      */
-    matrix(): Animation
+    matrix(a: number, b: number, c: number, d: number, tx: number, ty: number): Animation
     /** 同 [transform-function matrix3d](https://developer.mozilla.org/en-US/docs/Web/CSS/transform-function/matrix3d)
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.matrix3d.html
      */
-    matrix3d(): Animation
+    matrix3d(a1: number, b1: number, c1: number, d1: number, a2: number, b2: number, c2: number, d2: number, a3: number, b3: number, c3: number, d3: number, a4: number, b4: number, c4: number, d4: number): Animation
     /** 设置透明度
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.opacity.html
      */
     opacity(
@@ -88,7 +93,7 @@ declare module '../../index' {
       value: number,
     ): Animation
     /** 设置 right 值
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.right.html
      */
     right(
@@ -96,7 +101,7 @@ declare module '../../index' {
       value: number | string,
     ): Animation
     /** 从原点顺时针旋转一个角度
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.rotate.html
      */
     rotate(
@@ -104,21 +109,21 @@ declare module '../../index' {
       angle: number,
     ): Animation
     /** 从 固定 轴顺时针旋转一个角度
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.rotate3d.html
      */
     rotate3d(
       /** 旋转轴的 x 坐标 */
       x: number,
       /** 旋转轴的 y 坐标 */
-      y: number,
+      y?: number,
       /** 旋转轴的 z 坐标 */
-      z: number,
+      z?: number,
       /** 旋转的角度。范围 [-180, 180] */
-        angle: number,
+      angle?: number,
     ): Animation
     /** 从 X 轴顺时针旋转一个角度
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.rotateX.html
      */
     rotateX(
@@ -126,7 +131,7 @@ declare module '../../index' {
       angle: number,
     ): Animation
     /** 从 Y 轴顺时针旋转一个角度
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.rotateY.html
      */
     rotateY(
@@ -134,7 +139,7 @@ declare module '../../index' {
       angle: number,
     ): Animation
     /** 从 Z 轴顺时针旋转一个角度
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.rotateZ.html
      */
     rotateZ(
@@ -142,7 +147,7 @@ declare module '../../index' {
       angle: number,
     ): Animation
     /** 缩放
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.scale.html
      */
     scale(
@@ -152,7 +157,7 @@ declare module '../../index' {
       sy?: number,
     ): Animation
     /** 缩放
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.scale3d.html
      */
     scale3d(
@@ -164,7 +169,7 @@ declare module '../../index' {
       sz: number,
     ): Animation
     /** 缩放 X 轴
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.scaleX.html
      */
     scaleX(
@@ -172,7 +177,7 @@ declare module '../../index' {
       scale: number,
     ): Animation
     /** 缩放 Y 轴
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.scaleY.html
      */
     scaleY(
@@ -180,7 +185,7 @@ declare module '../../index' {
       scale: number,
     ): Animation
     /** 缩放 Z 轴
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.scaleZ.html
      */
     scaleZ(
@@ -198,7 +203,7 @@ declare module '../../index' {
       ay: number,
     ): Animation
     /** 对 X 轴坐标进行倾斜
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.skewX.html
      */
     skewX(
@@ -214,12 +219,12 @@ declare module '../../index' {
       angle: number,
     ): Animation
     /** 表示一组动画完成。可以在一组动画中调用任意多个动画方法，一组动画中的所有动画会同时开始，一组动画完成后才会进行下一组动画。
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.step.html
      */
     step(option?: Animation.StepOption): Animation
     /** 设置 top 值
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.top.html
      */
     top(
@@ -227,7 +232,7 @@ declare module '../../index' {
       value: number | string,
     ): Animation
     /** 平移变换
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.translate.html
      */
     translate(
@@ -237,7 +242,7 @@ declare module '../../index' {
       ty?: number,
     ): Animation
     /** 对 xyz 坐标进行平移变换
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.translate3d.html
      */
     translate3d(
@@ -249,7 +254,7 @@ declare module '../../index' {
       tz?: number,
     ): Animation
     /** 对 X 轴平移
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.translateX.html
      */
     translateX(
@@ -257,7 +262,7 @@ declare module '../../index' {
       translation: number,
     ): Animation
     /** 对 Y 轴平移
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.translateY.html
      */
     translateY(
@@ -265,7 +270,7 @@ declare module '../../index' {
       translation: number,
     ): Animation
     /** 对 Z 轴平移
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.translateZ.html
      */
     translateZ(
@@ -273,7 +278,7 @@ declare module '../../index' {
       translation: number,
     ): Animation
     /** 设置宽度
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.width.html
      */
     width(

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

@@ -15,9 +15,10 @@ declare module '../../index' {
        *
        * 可选值：
        * - 'success': 显示成功图标，此时 title 文本最多显示 7 个汉字长度;
+       * - 'error': 显示失败图标，此时 title 文本最多显示 7 个汉字长度;
        * - 'loading': 显示加载图标，此时 title 文本最多显示 7 个汉字长度;
        * - 'none': 不显示图标，此时 title 文本最多可显示两行 */
-      icon?: 'success' | 'loading' | 'none'
+      icon?: 'success' | 'error' | 'loading' | 'none'
       /** 自定义图标的本地路径，image 的优先级高于 icon */
       image?: string
       /** 是否显示透明蒙层，防止触摸穿透 */
@@ -78,6 +79,8 @@ declare module '../../index' {
 
   namespace showActionSheet {
     interface Option {
+      /** 警示文案 */
+      alertText?: string
       /** 按钮的文字数组，数组长度最大为 6 */
       itemList: string[]
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
@@ -121,6 +124,8 @@ declare module '../../index' {
 
   namespace enableAlertBeforeUnload {
     interface Option {
+      /** 询问对话框内容 */
+      message: string
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
@@ -257,7 +262,7 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/interaction/wx.enableAlertBeforeUnload.html
      */
-    enableAlertBeforeUnload(option?: enableAlertBeforeUnload.Option): void
+    enableAlertBeforeUnload(option: enableAlertBeforeUnload.Option): void
 
     /** 关闭小程序页面返回询问对话框
      * @supported weapp

package/types/compile.d.ts

@@ -209,10 +209,6 @@ declare enum LogLevel {
   DEBUG = 'debug'
 }
 
-export interface IDeviceRatio {
-  [key: string]: number
-}
-
 export type SystemConfig = {
   /**
    * 打印日志等级，分为 off,error,warn,info,log,debug
@@ -361,7 +357,7 @@ export interface IProjectBaseConfig {
   date?: string,
   designWidth?: number,
   watcher?: any[],
-  deviceRatio?: IDeviceRatio,
+  deviceRatio?: TaroGeneral.TDeviceRatio,
   sourceRoot?: string,
   outputRoot?: string,
   env?: IOption,

package/types/global.d.ts

@@ -387,4 +387,6 @@ declare namespace TaroGeneral {
     QQ = 'QQ',
     JD = 'JD'
   }
+
+  type TDeviceRatio = Record<string, number>
 }

package/types/index.d.ts

@@ -136,3 +136,7 @@ declare namespace Taro {
   // eslint-disable-next-line @typescript-eslint/no-empty-interface
   interface TaroStatic {}
 }
+declare global {
+  const defineAppConfig: (config: Taro.Config) => Taro.Config
+  const definePageConfig: (config: Taro.Config) => Taro.Config
+}

package/types/taro.component.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="react" />
 /// <reference types="vue" />
 
-import Taro, { ComponentOptions, Config, RouterInfo } from './index'
+import Taro, { Config } from './index'
 
 declare module './index' {
   // Components

package/types/taro.config.d.ts

@@ -235,7 +235,24 @@ declare module './index' {
     }
   }
 
+  interface RouterAnimate {
+    /**
+     * 动画切换时间，单位毫秒
+     * @default 300
+     */
+    duration?: number
+    /**
+     * 动画切换时间，单位毫秒
+     * @default 50
+     */
+    delay?: number
+  }
+
   interface AppConfig {
+    /**
+     * 小程序默认启动首页，未指定 entryPagePath 时，数组的第一项代表小程序的初始页面（首页）。
+     */
+    entryPagePath?: string
     /**
      * 接受一个数组，每一项都是字符串，来指定小程序由哪些页面组成，数组的第一项代表小程序的初始页面
      */
@@ -331,6 +348,18 @@ declare module './index' {
      * 接受一个数组，每一项都是字符串，来指定编译为原生小程序组件的组件入口
      */
     components?: string[]
+    /**
+     * 渲染页面的容器 id
+     * @default "app"
+     * @since 3.3.18
+     */
+    appId?: string
+    /**
+     * 是否开启h5端路由动画功能，默认关闭
+     * @supported h5
+     * @since 3.3.18
+     */
+    animation?: RouterAnimate | boolean
   }
 
   interface Config extends PageConfig, AppConfig {
@@ -354,6 +383,7 @@ declare module './index' {
     PreloadRule: PreloadRule
     Permission: Permission
     AppConfig: AppConfig
+    RouterAnimate: RouterAnimate
     Config: Config
   }
 }

package/types/taro.extend.d.ts

@@ -46,10 +46,27 @@ declare module './index' {
     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
+    }
+
     // eventCenter
     eventCenter: TaroGeneral.Events
 
+    ENV_TYPE: TARO_ENV_TYPE
+
     getEnv(): TaroGeneral.ENV_TYPE
 
     render(component: Component | JSX.Element, element: Element | null): any
@@ -60,7 +77,7 @@ declare module './index' {
     atMessage(options: AtMessageOptions): void
 
     pxTransform(size: number, designWidth?: number): string
-    initPxTransform(config: { designWidth: number; deviceRatio: object }): void
+    initPxTransform(config: { designWidth: number; deviceRatio: TaroGeneral.TDeviceRatio }): void
 
     addInterceptor(interceptor: interceptor): any