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

package/package.json

@@ -1,14 +1,12 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.4.0-beta.2",
+  "version": "3.4.0-beta.3",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
-  "main:h5": "h5.js",
   "typings": "types/index.d.ts",
   "files": [
     "index.js",
-    "h5.js",
     "types",
     "html.css",
     "html5.css"
@@ -26,9 +24,9 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.4.0-beta.2",
-    "@tarojs/runtime": "3.4.0-beta.2",
-    "@tarojs/taro-h5": "3.4.0-beta.2"
+    "@tarojs/api": "3.4.0-beta.3",
+    "@tarojs/runtime": "3.4.0-beta.3",
+    "@tarojs/taro-h5": "3.4.0-beta.3"
   },
-  "gitHead": "ac3eb29f11aec15d25e061775d9e970efabc2c98"
+  "gitHead": "2ef7e8c10c9e5784e98bb1ad3a803d5fd6a46c8b"
 }

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

@@ -130,7 +130,7 @@ declare module '../../../index' {
      */
     onAppHide(
       /** 小程序切后台事件的回调函数 */
-      callback: (res: TaroGeneral.CallbackResult) => void,
+      callback: (res: onAppShow.CallbackResult) => void,
     ): void
 
     /** 取消监听小程序要打开的页面不存在事件
@@ -139,7 +139,7 @@ declare module '../../../index' {
      */
     offPageNotFound(
       /** 小程序要打开的页面不存在事件的回调函数 */
-      callback: (res: TaroGeneral.CallbackResult) => void,
+      callback: (res: onPageNotFound.Callback) => void,
     ): void
 
     /** 取消监听音频播放错误事件
@@ -149,7 +149,7 @@ declare module '../../../index' {
 
     offError(
       /** 音频播放错误事件的回调函数 */
-      callback: (res: TaroGeneral.CallbackResult) => void,
+      callback: (res: onError.Callback) => void,
     ): void
 
     /** 取消监听音频中断结束事件

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

@@ -1698,6 +1698,27 @@ declare module '../../index' {
      *
      * **Tip**: 需要指定 canvasId，该绘图上下文只作用于对应的 `<canvas/>`
      * @supported weapp, h5
+     * @example
+     * ```tsx
+     * const context = Taro.createCanvasContext('canvas')
+     *
+     * context.setStrokeStyle("#00ff00")
+     * context.setLineWidth(5)
+     * context.rect(0, 0, 200, 200)
+     * context.stroke()
+     * context.setStrokeStyle("#ff0000")
+     * context.setLineWidth(2)
+     * context.moveTo(160, 100)
+     * context.arc(100, 100, 60, 0, 2 * Math.PI, true)
+     * context.moveTo(140, 100)
+     * context.arc(100, 100, 40, 0, Math.PI, false)
+     * context.moveTo(85, 80)
+     * context.arc(80, 80, 5, 0, 2 * Math.PI, true)
+     * context.moveTo(125, 80)
+     * context.arc(120, 80, 5, 0, 2 * Math.PI, true)
+     * context.stroke()
+     * context.draw()
+     * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/canvas/wx.createCanvasContext.html
      */
     createCanvasContext(

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

@@ -243,66 +243,6 @@ declare module '../../index' {
     }
   }
 
-  namespace chooseMedia {
-    interface Option {
-      /** 最多可以选择的文件个数 */
-      count?: number
-      /** 文件类型 */
-      mediaType?: Array<keyof mediaType>
-      /** 图片和视频选择的来源 */
-      sourceType?: Array<keyof sourceType>
-      /** 拍摄视频最长拍摄时间，单位秒。时间范围为 3s 至 30s 之间 */
-      maxDuration?: number
-      /** 仅对 mediaType 为 image 时有效，是否压缩所选文件 */
-      sizeType?: Array<'original' | 'compressed'>
-      /** 仅在 sourceType 为 camera 时生效，使用前置或后置摄像头 */
-      camera?: string
-      /** 接口调用失败的回调函数 */
-      fail?: (res: TaroGeneral.CallbackResult) => void
-      /** 接口调用成功的回调函数 */
-      success?: (result: SuccessCallbackResult) => void
-    }
-    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
-      /** 本地临时文件列表 */
-      tempFiles: ChooseMedia[]
-      /** 文件类型，有效值有 image 、video */
-      type: string
-    }
-    /** 本地临时文件列表 */
-    interface ChooseMedia {
-      /** 本地临时文件路径 (本地路径) */
-      tempFilePath: string
-      /** 本地临时文件大小，单位 B */
-      size: number
-      /** 视频的时间长度 */
-      duration: number
-      /** 视频的高度 */
-      height: number
-      /** 视频的宽度 */
-      width: number
-      /** 视频缩略图临时文件路径 */
-      thumbTempFilePath: string
-    }
-    interface mediaType {
-      /** 只能拍摄视频或从相册选择视频 */
-      video
-      /** 只能拍摄图片或从相册选择图片 */
-      image
-    }
-    interface sourceType {
-      /** 从相册选择 */
-      album
-      /** 使用相机拍摄 */
-      camera
-    }
-    interface camera {
-      /** 使用后置摄像头 */
-      back
-      /** 使用前置摄像头 */
-      front
-    }
-  }
-
   interface TaroStatic {
     /** 保存图片到系统相册。需要[用户授权](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html) scope.writePhotosAlbum
      * @supported weapp, rn, alipay, swan
@@ -416,25 +356,5 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseMessageFile.html
      */
     chooseMessageFile(option: chooseMessageFile.Option): Promise<chooseMessageFile.SuccessCallbackResult>
-
-    /** 拍摄或从手机相册中选择图片或视频。
-     * @supported weapp, rn
-     * @example
-     * ```tsx
-     * Taro.chooseMedia({
-     *   count: 9,
-     *   mediaType: ['image','video'],
-     *   sourceType: ['album', 'camera'],
-     *   maxDuration: 30,
-     *   camera: 'back',
-     *   success: (res) => {
-     *     console.log(res.tempFiles)
-     *     console.log(res.type)
-     *   }
-     * })
-     * ```
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.chooseMedia.html
-     */
-    chooseMedia(option: chooseMedia.Option): Promise<chooseMedia.SuccessCallbackResult>
   }
 }

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

@@ -14,48 +14,75 @@ declare module '../../index' {
     }
   }
 
-  namespace chooseVideo {
+  namespace openVideoEditor {
     interface Option {
-      /** 默认拉起的是前置或者后置摄像头。部分 Android 手机下由于系统 ROM 不支持无法生效 */
-      camera?: keyof camera
-      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: TaroGeneral.CallbackResult) => void
-      /** 是否压缩所选择的视频文件 */
-      compressed?: boolean
+      /** 视频源的路径，只支持本地路径 */
+      filePath: string
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
-      /** 拍摄视频最长拍摄时间，单位秒 */
-      maxDuration?: number
-      /** 视频选择的来源 */
-      sourceType?: Array<keyof sourceType>
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 剪辑后生成的视频文件的时长，单位毫秒（ms） */
+      duration: number
+      /** 剪辑后生成的视频文件大小，单位字节数（byte） */
+      size: number
+      /** 编辑后生成的视频文件的临时路径 */
+      tempFilePath: string
+      /** 编辑后生成的缩略图文件的临时路径 */
+      tempThumbPath: string
+    }
+  }
+
+  namespace getVideoInfo {
+    interface Option {
+      /** 视频文件路径，可以是临时文件路径也可以是永久文件路径 */
+      src: string
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
     }
     interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
-      /** 选定视频的时间长度 */
+      /** 画面方向 */
+      orientation: keyof orientation
+      /** 视频格式 */
+      type: string
+      /** 视频长度 */
       duration: number
-      /** 返回选定视频的高度 */
-      height: number
-      /** 选定视频的数据量大小 */
+      /** 视频大小，单位 kB */
       size: number
-      /** 选定视频的临时文件路径 */
-      tempFilePath: string
-      /** 返回选定视频的宽度 */
+      /** 视频的长，单位 px */
+      height: number
+      /** 视频的宽，单位 px */
       width: number
-      /** 调用结果 */
-      errMsg: string
-    }
-    interface camera {
-      /** 默认拉起后置摄像头 */
-      back
-      /** 默认拉起前置摄像头 */
-      front
+      /** 视频帧率 */
+      fps: number
+      /** 视频码率，单位 kbps */
+      bitrate: number
     }
-    interface sourceType {
-      /** 从相册选择视频 */
-      album
-      /** 使用相机拍摄视频 */
-      camera
+    interface orientation {
+      /** 默认 */
+      up
+      /** 180 度旋转 */
+      down
+      /** 逆时针旋转 90 度 */
+      left
+      /** 顺时针旋转 90 度 */
+      right
+      /** 同 up，但水平翻转 */
+      'up-mirrored'
+      /** 同 down，但水平翻转 */
+      'down-mirrored'
+      /** 同 left，但垂直翻转 */
+      'left-mirrored'
+      /** 同 right，但垂直翻转 */
+      'right-mirrored'
     }
   }
 
@@ -140,6 +167,147 @@ declare module '../../index' {
     }
   }
 
+  namespace compressVideo {
+    interface Option {
+      /** 视频文件路径，可以是临时文件路径也可以是永久文件路径 */
+      src: string
+      /** 压缩质量 */
+      quality: keyof quality
+      /** 码率，单位 kbps */
+      bitrate: number
+      /** 帧率 */
+      fps: number
+      /** 相对于原视频的分辨率比例，取值范围(0, 1] */
+      resolution: number
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 压缩后的临时文件地址 */
+      tempFilePath: string
+      /** 压缩后的大小，单位 kB */
+      size: number
+    }
+    interface quality {
+      /** 低 */
+      low
+      /** 中 */
+      medium
+      /** 高 */
+      high
+    }
+  }
+
+  namespace chooseVideo {
+    interface Option {
+      /** 默认拉起的是前置或者后置摄像头。部分 Android 手机下由于系统 ROM 不支持无法生效 */
+      camera?: keyof camera
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 是否压缩所选择的视频文件 */
+      compressed?: boolean
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 拍摄视频最长拍摄时间，单位秒 */
+      maxDuration?: number
+      /** 视频选择的来源 */
+      sourceType?: Array<keyof sourceType>
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 选定视频的时间长度 */
+      duration: number
+      /** 返回选定视频的高度 */
+      height: number
+      /** 选定视频的数据量大小 */
+      size: number
+      /** 选定视频的临时文件路径 */
+      tempFilePath: string
+      /** 返回选定视频的宽度 */
+      width: number
+      /** 调用结果 */
+      errMsg: string
+    }
+    interface camera {
+      /** 默认拉起后置摄像头 */
+      back
+      /** 默认拉起前置摄像头 */
+      front
+    }
+    interface sourceType {
+      /** 从相册选择视频 */
+      album
+      /** 使用相机拍摄视频 */
+      camera
+    }
+  }
+
+
+  namespace chooseMedia {
+    interface Option {
+      /** 最多可以选择的文件个数 */
+      count?: number
+      /** 文件类型 */
+      mediaType?: Array<keyof mediaType>
+      /** 图片和视频选择的来源 */
+      sourceType?: Array<keyof sourceType>
+      /** 拍摄视频最长拍摄时间，单位秒。时间范围为 3s 至 30s 之间 */
+      maxDuration?: number
+      /** 仅对 mediaType 为 image 时有效，是否压缩所选文件 */
+      sizeType?: Array<'original' | 'compressed'>
+      /** 仅在 sourceType 为 camera 时生效，使用前置或后置摄像头 */
+      camera?: string
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 本地临时文件列表 */
+      tempFiles: ChooseMedia[]
+      /** 文件类型，有效值有 image 、video */
+      type: string
+    }
+    /** 本地临时文件列表 */
+    interface ChooseMedia {
+      /** 本地临时文件路径 (本地路径) */
+      tempFilePath: string
+      /** 本地临时文件大小，单位 B */
+      size: number
+      /** 视频的时间长度 */
+      duration: number
+      /** 视频的高度 */
+      height: number
+      /** 视频的宽度 */
+      width: number
+      /** 视频缩略图临时文件路径 */
+      thumbTempFilePath: string
+    }
+    interface mediaType {
+      /** 只能拍摄视频或从相册选择视频 */
+      video
+      /** 只能拍摄图片或从相册选择图片 */
+      image
+    }
+    interface sourceType {
+      /** 从相册选择 */
+      album
+      /** 使用相机拍摄 */
+      camera
+    }
+    interface camera {
+      /** 使用后置摄像头 */
+      back
+      /** 使用前置摄像头 */
+      front
+    }
+  }
+
   interface TaroStatic {
     /**
      * 保存视频到系统相册。支持mp4视频格式。需要[用户授权](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html) scope.writePhotosAlbum
@@ -161,6 +329,46 @@ declare module '../../index' {
      */
     saveVideoToPhotosAlbum(option: saveVideoToPhotosAlbum.Option): Promise<TaroGeneral.CallbackResult>
 
+    /** 打开视频编辑器
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.openVideoEditor({
+     *  filePath: ''
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.openVideoEditor.html
+     */
+    openVideoEditor(option: openVideoEditor.Option): Promise<openVideoEditor.SuccessCallbackResult>
+
+    /** 获取视频详细信息
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.downloadFile({
+     *   url: 'https://mock.taro.org/mock_video.mp4',
+     *   success(res) {
+     *     Taro.getVideoInfo({
+     *       src: res.tempFilePath,
+     *       success (res) {
+     *         console.log('获取文件地址成功')
+     *         console.log(res)
+     *       },
+     *       fail (res) {
+     *         console.log('获取文件地址失败')
+     *         console.log(res)
+     *       },
+     *       complete (res) {
+     *         console.log('获取文件地址')
+     *       }
+     *     })
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.getVideoInfo.html
+     */
+    getVideoInfo(option: getVideoInfo.Option): Promise<getVideoInfo.SuccessCallbackResult>
+
     /** 创建 video 上下文 VideoContext 对象。
      * @supported weapp, h5
      * @example
@@ -176,6 +384,37 @@ declare module '../../index' {
       component?: TaroGeneral.IAnyObject,
     ): VideoContext
 
+    /** 压缩视频接口。
+     * 开发者可指定压缩质量 `quality` 进行压缩。当需要更精细的控制时，可指定 `bitrate`、`fps`、和 `resolution`，当 `quality` 传入时，这三个参数将被忽略。原视频的相关信息可通过 [getVideoInfo](https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.getVideoInfo.html) 获取。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.chooseVideo({
+     *   sourceType: ['album', 'camera'],
+     *   maxDuration: 60,
+     *   camera: 'back',
+     *   compressed: false,
+     *   success (res) {
+     *     Taro.compressVideo({
+     *       src: res.tempFilePath,
+     *       quality: quality,
+     *       bitrate: 1032,
+     *       fps: 24,
+     *       resolution:0.5,
+     *       success (res) {
+     *         console.log("压缩成功")
+     *       },
+     *       fail (err) {
+     *         console.log("压缩失败")
+     *       }
+     *     })
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.compressVideo.html
+     */
+     compressVideo(option: compressVideo.Option): Promise<compressVideo.SuccessCallbackResult>
+
     /** 拍摄视频或从手机相册中选视频。
      * @supported weapp, rn
      * @example
@@ -192,5 +431,25 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.chooseVideo.html
      */
     chooseVideo(option: chooseVideo.Option): Promise<chooseVideo.SuccessCallbackResult>
+
+    /** 拍摄或从手机相册中选择图片或视频。
+     * @supported weapp, rn
+     * @example
+     * ```tsx
+     * Taro.chooseMedia({
+     *   count: 9,
+     *   mediaType: ['image','video'],
+     *   sourceType: ['album', 'camera'],
+     *   maxDuration: 30,
+     *   camera: 'back',
+     *   success: (res) => {
+     *     console.log(res.tempFiles)
+     *     console.log(res.type)
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.chooseMedia.html
+     */
+    chooseMedia(option: chooseMedia.Option): Promise<chooseMedia.SuccessCallbackResult>
   }
 }

package/types/compile.d.ts

@@ -53,12 +53,12 @@ export type IOption = Record<string, any>
 
 export interface ICopyOptions {
   patterns: {
-    from: string,
-    to: string,
-    ignore?: string[],
-    transform?: Function,
+    from: string
+    to: string
+    ignore?: string[]
+    transform?: Function
     watch?: boolean
-  }[],
+  }[]
   options: {
     ignore?: string[]
   }
@@ -68,11 +68,11 @@ export interface ISassOptions {
   /**
    * 引入的全局 sass 文件，如果要引入多个文件，支持数组形式传入
    */
-  resource?: string | string[],
+  resource?: string | string[]
   /**
    * 项目根目录的绝对地址(若为小程序云开发模板，则应该是client目录)
    */
-  projectDirectory?: string,
+  projectDirectory?: string
   /**
    * 全局 scss 变量，若 data 与 resource 中设置了同样的变量，则 data 的优先级高于 resource
    */
@@ -89,21 +89,21 @@ export namespace PostcssOption {
     generateScopedName: string | ((localName: string, absoluteFilePath: string) => string)
   }>
   export type url = TogglableOptions<{
-    limit: number,
+    limit: number
     basePath?: string | string[]
   }>
 }
 
 export interface IPostcssOption {
-  autoprefixer?: TogglableOptions,
-  pxtransform?: TogglableOptions,
-  cssModules?: PostcssOption.cssModules,
-  url?: PostcssOption.url,
+  autoprefixer?: TogglableOptions
+  pxtransform?: TogglableOptions
+  cssModules?: PostcssOption.cssModules
+  url?: PostcssOption.url
   [key: string]: any
 }
 
 export interface ICompileOption {
-  exclude?: string[],
+  exclude?: string[]
   include?: string[]
 }
 
@@ -113,85 +113,85 @@ interface Runtime {
 }
 
 export interface IMiniAppConfig {
-  appOutput?: boolean,
-  enableSourceMap?: boolean,
-  sourceMapType?: string,
-  debugReact?: boolean,
+  appOutput?: boolean
+  enableSourceMap?: boolean
+  sourceMapType?: string
+  debugReact?: boolean
   minifyXML?: {
     collapseWhitespace?: boolean
-  },
-
-  webpackChain?: (chain: any, webpack: any, PARSE_AST_TYPE: any) => void,
-  entry?: webpack.Entry,
-  output?: webpack.Output,
-  postcss?: IPostcssOption,
-  cssLoaderOption?: IOption,
-  sassLoaderOption?: IOption,
-  lessLoaderOption?: IOption,
-  stylusLoaderOption?: IOption,
-  mediaUrlLoaderOption?: IOption,
-  fontUrlLoaderOption?: IOption,
-  imageUrlLoaderOption?: IOption,
-  miniCssExtractPluginOption?: IOption,
-
-  customFilesTypes?: IMINI_APP_FILE_TYPE,
-  commonChunks?: string[] | ((commonChunks: string[]) => string[]),
-  addChunkPages?: ((pages: Map<string, string[]>, pagesNames?: string[]) => void),
+  }
+
+  webpackChain?: (chain: any, webpack: any, PARSE_AST_TYPE: any) => void
+  entry?: webpack.Entry
+  output?: webpack.Output
+  postcss?: IPostcssOption
+  cssLoaderOption?: IOption
+  sassLoaderOption?: IOption
+  lessLoaderOption?: IOption
+  stylusLoaderOption?: IOption
+  mediaUrlLoaderOption?: IOption
+  fontUrlLoaderOption?: IOption
+  imageUrlLoaderOption?: IOption
+  miniCssExtractPluginOption?: IOption
+
+  customFilesTypes?: IMINI_APP_FILE_TYPE
+  commonChunks?: string[] | ((commonChunks: string[]) => string[])
+  addChunkPages?: ((pages: Map<string, string[]>, pagesNames?: string[]) => void)
   optimizeMainPackage?: {
-    enable?: boolean,
+    enable?: boolean
     exclude?: any[]
-  },
+  }
 
   compile?: {
-    exclude?: any[],
+    exclude?: any[]
     include?: any[]
   }
   runtime?: Runtime
 }
 
 export type TogglableOptions<T = IOption> = {
-  enable?: boolean,
+  enable?: boolean
   config?: T
 }
 
 export interface IH5RouterConfig {
-  mode?: 'hash' | 'browser' | 'multi',
-  customRoutes?: IOption,
-  basename?: string,
-  lazyload?: boolean | ((pagename: string) => boolean),
+  mode?: 'hash' | 'browser' | 'multi'
+  customRoutes?: IOption
+  basename?: string
+  lazyload?: boolean | ((pagename: string) => boolean)
   renamePagename?: (pagename: string) => string
   forcePath?: string
 }
 
 export interface IH5Config {
-  publicPath?: string,
-  staticDirectory?: string,
-  chunkDirectory?: string,
+  publicPath?: string
+  staticDirectory?: string
+  chunkDirectory?: string
 
   webpack?: ((webpackConfig: webpack.Configuration, webpack) => webpack.Configuration) | webpack.Configuration
 
-  webpackChain?: (chain: any, webpack: any) => void,
-
-  entry?: webpack.Entry,
-  output?: webpack.Output,
-  router?: IH5RouterConfig,
-  devServer?: webpackDevServer.Configuration,
-  enableSourceMap?: boolean,
-  sourceMapType?: 'none' | 'eval' | 'cheap-eval-source-map' | 'cheap-module-eval-source-map' | 'eval-source-map' | 'cheap-source-map' | 'cheap-module-source-map' | 'inline-cheap-source-map' | 'inline-cheap-module-source-map' | 'source-map' | 'inline-source-map' | 'hidden-source-map' | 'nosources-source-map',
-  enableExtract?: boolean,
-  transformOnly?: boolean,
-
-  cssLoaderOption?: IOption,
-  styleLoaderOption?: IOption,
-  sassLoaderOption?: IOption,
-  lessLoaderOption?: IOption,
-  stylusLoaderOption?: IOption,
-  mediaUrlLoaderOption?: IOption,
-  fontUrlLoaderOption?: IOption,
-  imageUrlLoaderOption?: IOption,
-  miniCssExtractPluginOption?: IOption,
-  esnextModules?: string[],
-  useHtmlComponents?: boolean,
+  webpackChain?: (chain: any, webpack: any) => void
+
+  entry?: webpack.Entry
+  output?: webpack.Output
+  router?: IH5RouterConfig
+  devServer?: webpackDevServer.Configuration
+  enableSourceMap?: boolean
+  sourceMapType?: 'none' | 'eval' | 'cheap-eval-source-map' | 'cheap-module-eval-source-map' | 'eval-source-map' | 'cheap-source-map' | 'cheap-module-source-map' | 'inline-cheap-source-map' | 'inline-cheap-module-source-map' | 'source-map' | 'inline-source-map' | 'hidden-source-map' | 'nosources-source-map'
+  enableExtract?: boolean
+  transformOnly?: boolean
+
+  cssLoaderOption?: IOption
+  styleLoaderOption?: IOption
+  sassLoaderOption?: IOption
+  lessLoaderOption?: IOption
+  stylusLoaderOption?: IOption
+  mediaUrlLoaderOption?: IOption
+  fontUrlLoaderOption?: IOption
+  imageUrlLoaderOption?: IOption
+  miniCssExtractPluginOption?: IOption
+  esnextModules?: string[]
+  useHtmlComponents?: boolean
 
   postcss?: IPostcssOption
 }
@@ -213,11 +213,11 @@ export type SystemConfig = {
   /**
    * 打印日志等级，分为 off,error,warn,info,log,debug
    */
-  logLevel?: LogLevel,
+  logLevel?: LogLevel
   /**
    * 页面设计基准宽度，根据实际设备宽度来缩放元素大小
    */
-  designWidth?: number,
+  designWidth?: number
   /**
    * 全局数据对象，属性名不能以$或_开头，在页面中可通过 this 进行访问;如果全局数据属性与页面的数据属性重名，则页面初始化时，全局数据会覆盖页面中对应的属性值
    */
@@ -228,7 +228,7 @@ type RouterConfig = {
   /**
    * 首页名称
    */
-  entry: string,
+  entry: string
   /**
    * 页面配置列表，key 值为页面名称（对应页面目录名，例如 Hello 对应'Hello'目录），value 为页面详细配置 page
    */
@@ -238,14 +238,14 @@ type RouterPage = {
   /**
    * 页面对应的组件名，与 ux 文件名保持一致，例如'hello' 对应 'hello.ux'
    */
-  component: string,
+  component: string
   /**
    * 页面路径，例如“/user”,不填则默认为/<页面名称>。
    * path 必须唯一,不能和其他 page 的 path 相同。
    * 下面 page 的 path 因为缺失,会被设置为“/Index”：
    * "Index": {"component": "index"}
    */
-  path?: string,
+  path?: string
   /**
    * 声明页面可以处理某种请求
    */
@@ -260,31 +260,31 @@ interface IDefaultDisplayConfig {
   /**
    * 窗口背景颜色
    */
-  backgroundColor?: string,
+  backgroundColor?: string
   /**
    * 是否是全屏模式，默认不会同时作用于 titleBar，titleBar 需要继续通过 titleBar 控制
    */
-  fullScreen?: boolean,
+  fullScreen?: boolean
   /**
    * 是否显示 titleBar
    */
-  titleBar?: boolean,
+  titleBar?: boolean
   /**
    * 标题栏背景色
    */
-  titleBarBackgroundColor?: string,
+  titleBarBackgroundColor?: string
   /**
    * 标题栏文字颜色
    */
-  titleBarTextColor?: string,
+  titleBarTextColor?: string
   /**
    * 标题栏文字(也可通过页面跳转传递参数(titleBarText)设置)
    */
-  titleBarText?: string,
+  titleBarText?: string
   /**
    * 是否显示标题栏右上角菜单按钮，点击菜单按钮调用页面生命周期 onMenuPress 方法，如果该方法未实现则显示系统默认菜单
    */
-  menu?: boolean,
+  menu?: boolean
   /**
    * 软键盘弹出时为保证输入框可见，页面的调整方式。　adjustPan:上移页面; adjustResize:压缩页面显示区域，当页面全屏时，此设置不生效
    */
@@ -304,31 +304,31 @@ export interface ITaroManifestConfig {
   /**
    * 应用包名，确认与原生应用的包名不一致，推荐采用 com.company.module 的格式，如：com.example.demo
    */
-  package: string,
+  package: string
   /**
    * 应用名称，6 个汉字以内，与应用商店保存的名称一致，用于在桌面图标、弹窗等处显示应用名称
    */
-  name: string,
+  name: string
   /**
    * 应用图标，提供 192x192 大小的即可
    */
-  icon: string,
+  icon: string
   /**
    * 应用版本名称，如："1.0"
    */
-  versionName?: string,
+  versionName?: string
   /**
    * 应用版本号，从1自增，推荐每次重新上传包时versionCode+1
    */
-  versionCode: number,
+  versionCode: number
   /**
    * 支持的最小平台版本号，兼容性检查，避免上线后在低版本平台运行并导致不兼容；如果不填按照内测版本处理
    */
-  minPlatformVersion?: string,
+  minPlatformVersion?: string
   /**
    * 接口列表，绝大部分接口都需要在这里声明，否则不能调用，详见每个接口的文档说明
    */
-  features?: FeatureItem[],
+  features?: FeatureItem[]
   /**
    *
    */
@@ -339,11 +339,11 @@ export interface IManifestConfig extends ITaroManifestConfig {
   /**
    * 系统配置信息
    */
-  config: SystemConfig,
+  config: SystemConfig
   /**
    * 路由信息
    */
-  router: RouterConfig,
+  router: RouterConfig
   /**
    * UI 显示相关配置
    */
@@ -353,24 +353,24 @@ export interface IManifestConfig extends ITaroManifestConfig {
 export type PluginItem = string | [string, object]
 
 export interface IProjectBaseConfig {
-  projectName?: string,
-  date?: string,
-  designWidth?: number,
-  watcher?: any[],
-  deviceRatio?: TaroGeneral.TDeviceRatio,
-  sourceRoot?: string,
-  outputRoot?: string,
-  env?: IOption,
-  alias?: IOption,
-  defineConstants?: IOption,
-  copy?: ICopyOptions,
-  csso?: TogglableOptions,
-  terser?: TogglableOptions,
-  uglify?: TogglableOptions,
-  sass?: ISassOptions,
-  plugins?: PluginItem[],
+  projectName?: string
+  date?: string
+  designWidth?: number
+  watcher?: any[]
+  deviceRatio?: TaroGeneral.TDeviceRatio
+  sourceRoot?: string
+  outputRoot?: string
+  env?: IOption
+  alias?: IOption
+  defineConstants?: IOption
+  copy?: ICopyOptions
+  csso?: TogglableOptions
+  terser?: TogglableOptions
+  uglify?: TogglableOptions
+  sass?: ISassOptions
+  plugins?: PluginItem[]
   presets?: PluginItem[]
-  baseLevel?: number,
+  baseLevel?: number
   framework?: string
 }
 

package/types/taro.component.d.ts

@@ -21,7 +21,7 @@ declare module './index' {
     onPageScroll?(obj: PageScrollObject): void
     onShareAppMessage?(obj: ShareAppMessageObject): ShareAppMessageReturn
     onTabItemTap?(obj: TabItemTapObject): void
-    onResize?(obj: any): void
+    onResize?(obj: PageResizeObject): void
   }
 
   interface ComponentOptions {
@@ -80,14 +80,16 @@ declare module './index' {
   type SFC = StatelessFunctionComponent
 
   interface Show {
-    componentDidShow?(options?: unknown): void
-    componentDidHide?(options?: unknown): void
-    onShow?(options?: unknown): void
-    onHide?(options?: unknown): void
+    componentDidShow?(): void
+    componentDidHide?(): void
+    onShow?(): void
+    onHide?(): void
   }
 
   interface AppInstance extends Show {
     mount(component: React.ComponentClass | Vue.ComponentOptions<Vue>, id: string, cb: () => void): void
+    componentDidShow?(options?: Record<string, unknown>): void
+    onShow?(options?: Record<string, unknown>): void
     unmount(id: string, cb: () => void): void
   }
 

package/types/taro.config.d.ts

@@ -309,7 +309,7 @@ declare module './index' {
      * 声明分包预下载的规则。
      * preloadRule 中，key 是页面路径，value 是进入此页面的预下载配置
      * 注意: 分包预下载目前只支持通过配置方式使用，暂不支持通过调用API完成。
-     *      vConsole 里有preloadSubpackages开头的日志信息，可以用来验证预下载的情况。
+     *      vConsole 里有 preloadSubpackages 开头的日志信息，可以用来验证预下载的情况。
      * @since 2.3.0
      */
     preloadRule?: PreloadRule
@@ -335,12 +335,12 @@ declare module './index' {
      */
     style?: 'v2'
     /**
-     * 配置 darkmode 为 true，即表示当前小程序已适配 DarkMode
+     * 配置 darkMode 为 true，即表示当前小程序已适配 DarkMode
      * @since 2.11.0
      */
     darkmode?: boolean
     /**
-     * 指定 darkmode 变量配置文件 theme.json 路径
+     * 指定 darkMode 变量配置文件 theme.json 路径
      * @since 2.11.0
      */
     themeLocation?: string
@@ -355,7 +355,7 @@ declare module './index' {
      */
     appId?: string
     /**
-     * 是否开启h5端路由动画功能，默认关闭
+     * 是否开启 h5 端路由动画功能，默认开启
      * @supported h5
      * @since 3.3.18
      */

package/types/taro.hooks.d.ts

@@ -5,32 +5,32 @@ declare module './index' {
     /**
      * 页面展示时的回调。
      */
-    useDidShow(callback: () => any): void
+    useDidShow(callback: () => void): void
 
     /**
      * 页面隐藏时的回调。
      */
-    useDidHide(callback: () => any): void
+    useDidHide(callback: () => void): void
 
     /**
      * 下拉刷新时的回调。
      */
-    usePullDownRefresh(callback: () => any): void
+    usePullDownRefresh(callback: () => void): void
 
     /**
      * 上拉触底时的回调。
      */
-    useReachBottom(callback: () => any): void
+    useReachBottom(callback: () => void): void
 
     /**
      * 页面滚动时的回调。
      */
-    usePageScroll(callback: (payload: PageScrollObject) => any): void
+    usePageScroll(callback: (payload: PageScrollObject) => void): void
 
     /**
      * 页面尺寸改变时的回调。
      */
-    useResize(callback: () => any): void
+    useResize(callback: (payload: PageResizeObject) => void): void
 
     /**
      * 页面转发时的回调。
@@ -40,12 +40,12 @@ declare module './index' {
     /**
      * 当前是 tab 页时，tab 被点击时的回调。
      */
-    useTabItemTap(callback: (payload: TabItemTapObject) => any): void
+    useTabItemTap(callback: (payload: TabItemTapObject) => void): void
 
     /**
      * 用户点击右上角菜单“收藏”按钮时的回调。
      */
-    useAddToFavorites(callback: (paload: AddToFavoritesObject) => AddToFavoritesReturnObject): void
+    useAddToFavorites(callback: (payload: AddToFavoritesObject) => AddToFavoritesReturnObject): void
 
     /**
      * 用户点击右上角菜单“分享到朋友圈”按钮时的回调。
@@ -56,7 +56,7 @@ declare module './index' {
      * 页面初次渲染完成的回调。
      * 此时页面已经准备妥当，可以和视图层进行交互。
      */
-    useReady(callback: () => any): void
+    useReady(callback: () => void): void
 
     /**
      * 获取当前路由参数。
@@ -67,18 +67,18 @@ declare module './index' {
      * 导航栏的标题被点击时的回调。
      * **仅支付宝小程序支持。**
      */
-    useTitleClick(callback: () => any): void
+    useTitleClick(callback: () => void): void
 
     /**
      * 导航栏的额外图标被点击时的回调。
      * **仅支付宝小程序支持。**
      */
-    useOptionMenuClick(callback: () => any): void
+    useOptionMenuClick(callback: () => void): void
 
     /**
      * 下拉中断时的回调。
      * **仅支付宝小程序支持。**
      */
-    usePullIntercept(callback: () => any): void
+    usePullIntercept(callback: () => void): void
   }
 }

package/types/taro.lifecycle.d.ts

@@ -55,6 +55,13 @@ declare module './index' {
     scrollTop: number
   }
 
+  interface PageResizeObject {
+    size: {
+      windowWidth: number
+      windowHeight: number
+    }
+  }
+
   interface ShareAppMessageObject {
     /**
      * 转发事件来源

package/h5.js

@@ -1,4 +0,0 @@
-import Taro from '@tarojs/taro-h5'
-export * from '@tarojs/taro-h5'
-
-export default Taro