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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.5.0-beta.3",
+  "version": "3.5.0-beta.6",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -11,9 +11,6 @@
     "html.css",
     "html5.css"
   ],
-  "scripts": {
-    "test": "echo \"Error: run tests from root\" && exit 1"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/NervJS/taro.git"
@@ -24,8 +21,8 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.5.0-beta.3",
-    "@tarojs/runtime": "3.5.0-beta.3"
+    "@tarojs/api": "3.5.0-beta.6",
+    "@tarojs/runtime": "3.5.0-beta.6"
   },
   "peerDependenciesMeta": {
     "@types/react": {
@@ -41,5 +38,7 @@
       "optional": true
     }
   },
-  "gitHead": "bd1aa21707e51500eac9b16526e4ba4171fa8e5f"
-}
+  "scripts": {
+    "test": "echo \"Error: run tests from root\" && exit 1"
+  }
+}

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

@@ -4,7 +4,7 @@ declare module '../../index' {
   namespace canvasToTempFilePath {
     interface Option {
       /** 画布标识，传入 [canvas](/docs/components/canvas) 组件实例 （canvas type="2d" 时使用该属性）。 */
-      canvas?: CanvasProps
+      canvas?: Canvas
       /** 画布标识，传入 [canvas](/docs/components/canvas) 组件的 canvas-id */
       canvasId?: string
       /** 图片的质量，目前仅对 jpg 有效。取值范围为 (0, 1]，不在范围内时当作 1.0 处理。 */

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

@@ -3,6 +3,8 @@ import Taro from '../../index'
 declare module '../../index' {
   namespace vibrateShort {
     interface Option {
+      /** 震动强度类型，有效值为：heavy、medium、light */
+      type: 'heavy' | 'medium' | 'light'
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
@@ -25,6 +27,8 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 使手机发生较短时间的振动（15 ms）。仅在 iPhone `7 / 7 Plus` 以上及 Android 机型生效
+     * @h5 不支持 type 参数
+     * @rn 不支持 type 参数
      * @supported weapp, h5, rn, tt
      * @example
      * ```tsx

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

@@ -188,6 +188,26 @@ declare module '../../index' {
     }
   }
 
+  namespace getFuzzyLocation {
+    interface Option {
+      /** wgs84 返回 gps 坐标，gcj02 返回可用于 Taro.openLocation 的坐标 */
+      type?: 'wgs84' | 'gcj02'
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 纬度，范围为 -90~90，负数表示南纬 */
+      latitude: string
+      /** 经度，范围为 -180~180，负数表示西经 */
+      longitude: string
+    }
+  }
+
   interface TaroStatic {
     /** 关闭监听实时位置变化，前后台都停止消息接收
      * @supported weapp, rn, tt
@@ -329,5 +349,21 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.chooseLocation.html
      */
     chooseLocation(option: chooseLocation.Option): Promise<chooseLocation.SuccessCallbackResult>
+
+    /** 获取当前的模糊地理位置
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.getFuzzyLocation({
+     *   type: 'wgs84',
+     *   success (res) {
+     *     const latitude = res.latitude
+     *     const longitude = res.longitude
+     *   },
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.getFuzzyLocation.html
+     */
+    getFuzzyLocation(option: getFuzzyLocation.Option): Promise<getFuzzyLocation.SuccessCallbackResult>
   }
 }

package/types/compile.d.ts

@@ -388,6 +388,8 @@ interface ILogger {
 }
 
 export interface IProjectBaseConfig {
+  isWatch?: boolean
+  port?: number
   projectName?: string
   date?: string
   designWidth?: number
@@ -410,9 +412,17 @@ export interface IProjectBaseConfig {
   presets?: PluginItem[]
   baseLevel?: number
   framework?: string
+  frameworkExts?: string[]
   compiler?: Compiler
   cache?: ICache
   logger?: ILogger
+  enableSourceMap?: boolean
+  /** hooks */
+  modifyWebpackChain?: HookModifyWebpackChain
+  modifyMiniConfigs?: (configMap) => Promise<any>
+  modifyBuildAssets?: (assets, plugin?) => Promise<any>
+  onWebpackChainReady?: (webpackChain: Chain) => Promise<any>
+  onBuildFinish?: (res: { error, stats, isWatch }) => Promise<any>
 }
 
 export interface IProjectConfig extends IProjectBaseConfig {

package/types/taro.component.d.ts

@@ -15,13 +15,7 @@ declare module './index' {
     componentDidShow?(): void
     componentDidHide?(): void
     componentDidCatchError?(err: string): void
-    componentDidNotFound?(obj: PageNotFoundObject): void
-    onPullDownRefresh?(): void
-    onReachBottom?(): void
-    onPageScroll?(obj: PageScrollObject): void
-    onShareAppMessage?(obj: ShareAppMessageObject): ShareAppMessageReturn
-    onTabItemTap?(obj: TabItemTapObject): void
-    onResize?(obj: PageResizeObject): void
+    componentDidNotFound?(opt: PageNotFoundObject): void
   }
   interface ComponentOptions {
     addGlobalClass?: boolean
@@ -74,10 +68,10 @@ declare module './index' {
     onHide?(): void
   }
   interface AppInstance extends Show {
-    mount(component: React.Component | Vue.ComponentOptions<Vue>, id: string, cb: () => void): void
+    mount(component: React.Component | Vue.ComponentOptions<Vue>, id: string, cb: (...args: any[]) => void): void
     componentDidShow?(options?: Record<string, unknown>): void
     onShow?(options?: Record<string, unknown>): void
-    unmount(id: string, cb: () => void): void
+    unmount(id: string, cb?: () => void): void
   }
   type Target = Record<string, unknown> & { dataset: Record<string, unknown>; id: string }
   interface MpEvent {
@@ -87,18 +81,18 @@ declare module './index' {
     currentTarget: Target
   }
   interface PageLifeCycle extends Show {
-    onPullDownRefresh?(): void
-    onReachBottom?(): void
-    onPageScroll?(obj: { scrollTop: number }): void
-    onShareAppMessage?(obj: { from: string; target?: any; webViewUrl: string }): void
-    onResize?(options: unknown): void
-    onTabItemTap?(obj: { index: string; pagePath: string; text: string }): void
-    onTitleClick?(): void
+    eh?(event: MpEvent): void
+    onLoad(options: Record<string, unknown>): void
     onOptionMenuClick?(): void
+    onPageScroll?(opt: PageScrollObject): void
     onPopMenuClick?(): void
+    onPullDownRefresh?(): void
     onPullIntercept?(): void
-    eh?(event: MpEvent): void
-    onLoad(options: Record<string, unknown>): void
+    onReachBottom?(): void
+    onResize?(opt: PageResizeObject): void
+    onShareAppMessage?(opt: ShareAppMessageObject): ShareAppMessageReturn
+    onTabItemTap?(opt: TabItemTapObject): void
+    onTitleClick?(): void
     onUnload(): void
   }
   interface ComponentInstance<
@@ -185,10 +179,4 @@ declare module './index' {
     /** 页面的组件选项 */
     options?: Record<string, unknown>
   }
-  interface TaroStatic {
-    memo<P = {}>(
-      FunctionComponent: FunctionComponent<P>,
-      compare?: (oldProps: P, newProps: P) => boolean
-    ): FunctionComponent<P>
-  }
 }

package/types/taro.hooks.d.ts

@@ -4,57 +4,67 @@ declare module './index' {
   interface TaroStatic {
     /**
      * 页面展示时的回调。
+     * @supported global
      */
     useDidShow(callback: () => void): void
 
     /**
      * 页面隐藏时的回调。
+     * @supported global
      */
     useDidHide(callback: () => void): void
 
     /**
      * 下拉刷新时的回调。
+     * @supported global
      */
     usePullDownRefresh(callback: () => void): void
 
     /**
      * 上拉触底时的回调。
+     * @supported global
      */
     useReachBottom(callback: () => void): void
 
     /**
      * 页面滚动时的回调。
+     * @supported global
      */
     usePageScroll(callback: (payload: PageScrollObject) => void): void
 
     /**
      * 页面尺寸改变时的回调。
+     * @supported global
      */
     useResize(callback: (payload: PageResizeObject) => void): void
 
     /**
      * 页面转发时的回调。
+     * @supported weapp
      */
     useShareAppMessage(callback: (payload: ShareAppMessageObject) => ShareAppMessageReturn): void
 
     /**
      * 当前是 tab 页时，tab 被点击时的回调。
+     * @supported weapp, rn
      */
     useTabItemTap(callback: (payload: TabItemTapObject) => void): void
 
     /**
      * 用户点击右上角菜单“收藏”按钮时的回调。
+     * @supported weapp
      */
     useAddToFavorites(callback: (payload: AddToFavoritesObject) => AddToFavoritesReturnObject): void
 
     /**
      * 用户点击右上角菜单“分享到朋友圈”按钮时的回调。
+     * @supported weapp
      */
     useShareTimeline(callback: () => ShareTimelineReturnObject): void
 
     /**
      * 页面销毁前保留状态回调
-     * **仅微信小程序支持。**
+     * @supported weapp
      */
     useSaveExitState(callback: () => {
       data: Record<any, any>
@@ -63,55 +73,63 @@ declare module './index' {
 
     /**
      * 小程序初始化完成时的回调。
+     * @supported weapp, h5
      */
     useLaunch(callback: (options: getLaunchOptionsSync.LaunchOptions) => void): void
 
     /**
      * 小程序发生脚本错误或 API 调用报错时触发的回调。
+     * @supported weapp, h5
      */
     useError(callback: (error: string) => void): void
 
     /**
      * 小程序要打开的页面不存在时触发的回调。
+     * @supported weapp, h5
+     * @h5 多页面模式不支持该方法
      */
     usePageNotFound(callback: (res: { path: string, query: Record<any, any>, isEntryPage: boolean, [key: string]: any }) => void): void
 
     /**
      * 页面加载完成时的回调。
+     * @supported weapp, h5
      */
     useLoad(callback: () => void): void
 
     /**
      * 页面卸载时的回调。
+     * @supported weapp, h5
      */
     useUnload(callback: () => void): void
 
     /**
      * 页面初次渲染完成的回调。
      * 此时页面已经准备妥当，可以和视图层进行交互。
+     * @supported weapp, h5
      */
     useReady(callback: () => void): void
 
     /**
      * 获取当前路由参数。
+     * @supported global
      */
     useRouter<TParams extends Partial<Record<string, string>> = Partial<Record<string, string>>>(dynamic?: boolean): RouterInfo<TParams>
 
     /**
      * 导航栏的标题被点击时的回调。
-     * **仅支付宝小程序支持。**
+     * @supported alipay
      */
     useTitleClick(callback: () => void): void
 
     /**
      * 导航栏的额外图标被点击时的回调。
-     * **仅支付宝小程序支持。**
+     * @supported alipay
      */
     useOptionMenuClick(callback: () => void): void
 
     /**
      * 下拉中断时的回调。
-     * **仅支付宝小程序支持。**
+     * @supported alipay, h5
      */
     usePullIntercept(callback: () => void): void
   }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2018 
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.