@tarojs/taro-h5 3.3.20 → 3.4.0-beta.3

package/dist/index.cjs.js

@@ -2,12 +2,15 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-function _interopDefault (ex) { return (ex && (typeof ex === 'object') && 'default' in ex) ? ex['default'] : ex; }
-
-var Taro = _interopDefault(require('@tarojs/api'));
+var Taro = require('@tarojs/api');
 var router = require('@tarojs/router');
 var runtime = require('@tarojs/runtime');
 
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var Taro__default = /*#__PURE__*/_interopDefaultLegacy(Taro);
+
+/* eslint-disable prefer-promise-reject-errors */
 function shouldBeObject(target) {
     if (target && typeof target === 'object')
         return { flag: true };
@@ -69,7 +72,7 @@ function setTransform(el, val) {
     el.style.webkitTransform = val;
     el.style.transform = val;
 }
-function serializeParams(params) {
+function serializeParams$1(params) {
     if (!params) {
         return '';
     }
@@ -106,7 +109,7 @@ function permanentlyNotSupport(apiName) {
         });
     };
 }
-function isFunction(obj) {
+function isFunction$1(obj) {
     return typeof obj === 'function';
 }
 const VALID_COLOR_REG = /^#[0-9a-fA-F]{6}$/;
@@ -114,6 +117,7 @@ const isValidColor = (color) => {
     return VALID_COLOR_REG.test(color);
 };
 function processOpenApi(apiName, defaultOptions, formatResult = res => res, formatParams = options => options) {
+    // @ts-ignore
     if (!window.wx) {
         return weixinCorpSupport(apiName);
     }
@@ -133,11 +137,16 @@ function processOpenApi(apiName, defaultOptions, formatResult = res => res, form
                     }
                 };
             });
+            // @ts-ignore
             wx[apiName](formatParams(obj));
         });
         return p;
     };
 }
+/**
+ * ease-in-out的函数
+ * @param t 0-1的数字
+ */
 const easeInOut = (t) => t < 0.5 ? 4 * t * t * t : (t - 1) * (2 * t - 2) * (2 * t - 2) + 1;
 const getTimingFunc = (easeFunc, frameCnt) => {
     return x => {
@@ -149,20 +158,58 @@ const getTimingFunc = (easeFunc, frameCnt) => {
     };
 };
 
+// 广告
 const createRewardedVideoAd = temporarilyNotSupport('createRewardedVideoAd');
 const createInterstitialAd = temporarilyNotSupport('createInterstitialAd');
 
+// 人脸识别
 const stopFaceDetect = temporarilyNotSupport('stopFaceDetect');
 const initFaceDetect = temporarilyNotSupport('initFaceDetect');
 const faceDetect = temporarilyNotSupport('faceDetect');
 
+// 视觉算法
 const createVKSession = temporarilyNotSupport('createVKSession');
 
+var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
+
+function getDefaultExportFromCjs (x) {
+	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
+}
+
+function getDefaultExportFromNamespaceIfPresent (n) {
+	return n && Object.prototype.hasOwnProperty.call(n, 'default') ? n['default'] : n;
+}
+
+function getDefaultExportFromNamespaceIfNotNamed (n) {
+	return n && Object.prototype.hasOwnProperty.call(n, 'default') && Object.keys(n).length === 1 ? n['default'] : n;
+}
+
+function getAugmentedNamespace(n) {
+	if (n.__esModule) return n;
+	var a = Object.defineProperty({}, '__esModule', {value: true});
+	Object.keys(n).forEach(function (k) {
+		var d = Object.getOwnPropertyDescriptor(n, k);
+		Object.defineProperty(a, k, d.get ? d : {
+			enumerable: true,
+			get: function () {
+				return n[k];
+			}
+		});
+	});
+	return a;
+}
+
+function commonjsRequire (path) {
+	throw new Error('Could not dynamically require "' + path + '". Please configure the dynamicRequireTargets or/and ignoreDynamicRequires option of @rollup/plugin-commonjs appropriately for this require call to work.');
+}
+
+var base64Js = {};
+
 'use strict';
 
-var byteLength_1 = byteLength;
-var toByteArray_1 = toByteArray;
-var fromByteArray_1 = fromByteArray;
+var byteLength_1 = base64Js.byteLength = byteLength;
+var toByteArray_1 = base64Js.toByteArray = toByteArray;
+var fromByteArray_1 = base64Js.fromByteArray = fromByteArray;
 var lookup = [];
 var revLookup = [];
 var Arr = typeof Uint8Array !== 'undefined' ? Uint8Array : Array;
@@ -278,31 +325,9 @@ function fromByteArray(uint8) {
   return parts.join('');
 }
 
-var base64Js = {
-	byteLength: byteLength_1,
-	toByteArray: toByteArray_1,
-	fromByteArray: fromByteArray_1
-};
-
-var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
-
-function commonjsRequire () {
-	throw new Error('Dynamic requires are not currently supported by rollup-plugin-commonjs');
-}
-
-function unwrapExports (x) {
-	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
-}
-
-function createCommonjsModule(fn, module) {
-	return module = { exports: {} }, fn(module, module.exports), module.exports;
-}
-
-function getCjsExportFromNamespace (n) {
-	return n && n['default'] || n;
-}
+var mobileDetect = {exports: {}};
 
-var mobileDetect = createCommonjsModule(function (module) {
+(function (module) {
 // THIS FILE IS GENERATED - DO NOT EDIT!
 
 /*!mobile-detect v1.4.5 2021-03-13*/
@@ -847,27 +872,16 @@ var mobileDetect = createCommonjsModule(function (module) {
       var $isMobile = t.mobile() !== null;
 
       if ( // Apple iOS 3.2-5.1 - Tested on the original iPad (4.3 / 5.0), iPad 2 (4.3), iPad 3 (5.1), original iPhone (3.1), iPhone 3 (3.2), 3GS (4.3), 4 (4.3 / 5.0), and 4S (5.1)
-      t.os('iOS') && t.version('iPad') >= 4.3 || t.os('iOS') && t.version('iPhone') >= 3.1 || t.os('iOS') && t.version('iPod') >= 3.1 || // Android 2.1-2.3 - Tested on the HTC Incredible (2.2), original Droid (2.2), HTC Aria (2.1), Google Nexus S (2.3). Functional on 1.5 & 1.6 but performance may be sluggish, tested on Google G1 (1.5)
-      // Android 3.1 (Honeycomb)  - Tested on the Samsung Galaxy Tab 10.1 and Motorola XOOM
-      // Android 4.0 (ICS)  - Tested on a Galaxy Nexus. Note: transition performance can be poor on upgraded devices
-      // Android 4.1 (Jelly Bean)  - Tested on a Galaxy Nexus and Galaxy 7
-      t.version('Android') > 2.1 && t.is('Webkit') || // Windows Phone 7-7.5 - Tested on the HTC Surround (7.0) HTC Trophy (7.5), LG-E900 (7.5), Nokia Lumia 800
+      t.os('iOS') && t.version('iPad') >= 4.3 || t.os('iOS') && t.version('iPhone') >= 3.1 || t.os('iOS') && t.version('iPod') >= 3.1 || t.version('Android') > 2.1 && t.is('Webkit') || // Windows Phone 7-7.5 - Tested on the HTC Surround (7.0) HTC Trophy (7.5), LG-E900 (7.5), Nokia Lumia 800
       t.version('Windows Phone OS') >= 7.0 || // Blackberry 7 - Tested on BlackBerry Torch 9810
       // Blackberry 6.0 - Tested on the Torch 9800 and Style 9670
       t.is('BlackBerry') && t.version('BlackBerry') >= 6.0 || // Blackberry Playbook (1.0-2.0) - Tested on PlayBook
-      t.match('Playbook.*Tablet') || // Palm WebOS (1.4-2.0) - Tested on the Palm Pixi (1.4), Pre (1.4), Pre 2 (2.0)
-      t.version('webOS') >= 1.4 && t.match('Palm|Pre|Pixi') || // Palm WebOS 3.0  - Tested on HP TouchPad
-      t.match('hp.*TouchPad') || // Firefox Mobile (12 Beta) - Tested on Android 2.3 device
-      t.is('Firefox') && t.version('Firefox') >= 12 || // Chrome for Android - Tested on Android 4.0, 4.1 device
-      t.is('Chrome') && t.is('AndroidOS') && t.version('Android') >= 4.0 || // Skyfire 4.1 - Tested on Android 2.3 device
-      t.is('Skyfire') && t.version('Skyfire') >= 4.1 && t.is('AndroidOS') && t.version('Android') >= 2.3 || // Opera Mobile 11.5-12: Tested on Android 2.3
-      t.is('Opera') && t.version('Opera Mobi') > 11 && t.is('AndroidOS') || // Meego 1.2 - Tested on Nokia 950 and N9
+      t.match('Playbook.*Tablet') || t.version('webOS') >= 1.4 && t.match('Palm|Pre|Pixi') || // Palm WebOS 3.0  - Tested on HP TouchPad
+      t.match('hp.*TouchPad') || t.is('Firefox') && t.version('Firefox') >= 12 || t.is('Chrome') && t.is('AndroidOS') && t.version('Android') >= 4.0 || t.is('Skyfire') && t.version('Skyfire') >= 4.1 && t.is('AndroidOS') && t.version('Android') >= 2.3 || t.is('Opera') && t.version('Opera Mobi') > 11 && t.is('AndroidOS') || // Meego 1.2 - Tested on Nokia 950 and N9
       t.is('MeeGoOS') || // Tizen (pre-release) - Tested on early hardware
       t.is('Tizen') || // Samsung Bada 2.0 - Tested on a Samsung Wave 3, Dolphin browser
       // @todo: more tests here!
-      t.is('Dolfin') && t.version('Bada') >= 2.0 || // UC Browser - Tested on Android 2.3 device
-      (t.is('UC Browser') || t.is('Dolfin')) && t.version('Android') >= 2.3 || // Kindle 3 and Fire  - Tested on the built-in WebKit browser for each
-      t.match('Kindle Fire') || t.is('Kindle') && t.version('Kindle') >= 3.0 || // Nook Color 1.4.1 - Tested on original Nook Color, not Nook Tablet
+      t.is('Dolfin') && t.version('Bada') >= 2.0 || (t.is('UC Browser') || t.is('Dolfin')) && t.version('Android') >= 2.3 || t.match('Kindle Fire') || t.is('Kindle') && t.version('Kindle') >= 3.0 || // Nook Color 1.4.1 - Tested on original Nook Color, not Nook Tablet
       t.is('AndroidOS') && t.is('NookTablet') || // Chrome Desktop 11-21 - Tested on OS X 10.7 and Windows 7
       t.version('Chrome') >= 11 && !$isMobile || // Safari Desktop 4-5 - Tested on OS X 10.7 and Windows 7
       t.version('Safari') >= 5.0 && !$isMobile || // Firefox Desktop 4-13 - Tested on OS X 10.7 and Windows 7
@@ -879,8 +893,7 @@ var mobileDetect = createCommonjsModule(function (module) {
       }
 
       if (t.os('iOS') && t.version('iPad') < 4.3 || t.os('iOS') && t.version('iPhone') < 3.1 || t.os('iOS') && t.version('iPod') < 3.1 || // Blackberry 5.0: Tested on the Storm 2 9550, Bold 9770
-      t.is('Blackberry') && t.version('BlackBerry') >= 5 && t.version('BlackBerry') < 6 || //Opera Mini (5.0-6.5) - Tested on iOS 3.2/4.3 and Android 2.3
-      t.version('Opera Mini') >= 5.0 && t.version('Opera Mini') <= 6.5 && (t.version('Android') >= 2.3 || t.is('iOS')) || // Nokia Symbian^3 - Tested on Nokia N8 (Symbian^3), C7 (Symbian^3), also works on N97 (Symbian^1)
+      t.is('Blackberry') && t.version('BlackBerry') >= 5 && t.version('BlackBerry') < 6 || t.version('Opera Mini') >= 5.0 && t.version('Opera Mini') <= 6.5 && (t.version('Android') >= 2.3 || t.is('iOS')) || // Nokia Symbian^3 - Tested on Nokia N8 (Symbian^3), C7 (Symbian^3), also works on N97 (Symbian^1)
       t.match('NokiaN8|NokiaC7|N97.*Series60|Symbian/3') || // @todo: report this (tested on Nokia N71)
       t.version('Opera Mobi') >= 11 && t.is('SymbianOS')) {
         return 'B';
@@ -1253,7 +1266,9 @@ var mobileDetect = createCommonjsModule(function (module) {
     throw new Error('unknown environment');
   }
 }());
-});
+}(mobileDetect));
+
+var MobileDetect = mobileDetect.exports;
 
 class MethodHandler {
     constructor({ name, success, fail, complete }) {
@@ -1287,10 +1302,18 @@ class CallbackManager {
     constructor() {
         this.callbacks = [];
     }
+    /**
+     * 添加回调
+     * @param {{ callback: function, ctx: any } | function} opt
+     */
     add(opt) {
         if (opt)
             this.callbacks.push(opt);
     }
+    /**
+     * 移除回调
+     * @param {{ callback: function, ctx: any } | function} opt
+     */
     remove(opt) {
         if (opt) {
             let pos = -1;
@@ -1304,9 +1327,17 @@ class CallbackManager {
             }
         }
     }
+    /**
+     * 获取回调函数数量
+     * @return {number}
+     */
     count() {
         return this.callbacks.length;
     }
+    /**
+     * 触发回调
+     * @param  {...any} args 回调的调用参数
+     */
     trigger(...args) {
         this.callbacks.forEach(opt => {
             if (typeof opt === 'function') {
@@ -1321,7 +1352,7 @@ class CallbackManager {
 }
 
 const getSystemInfoSync = () => {
-    const md = new mobileDetect(navigator.userAgent);
+    const md = new MobileDetect(navigator.userAgent);
     const info = {
         brand: md.mobile() || '',
         model: md.mobile() || '',
@@ -1337,6 +1368,7 @@ const getSystemInfoSync = () => {
         language: navigator.language,
         fontSizeSetting: NaN,
         SDKVersion: '',
+        // TODO
         albumAuthorized: false,
         benchmarkLevel: 0,
         bluetoothEnabled: false,
@@ -1376,6 +1408,7 @@ const getSystemInfo = async (options = {}) => {
 };
 
 function getConnection() {
+    // @ts-ignore
     return navigator.connection || navigator.mozConnection || navigator.webkitConnection || navigator.msConnection;
 }
 const getNetworkType = (options = {}) => {
@@ -1383,28 +1416,38 @@ const getNetworkType = (options = {}) => {
     const { success, fail, complete } = options;
     const handle = new MethodHandler({ name: 'getNetworkType', success, fail, complete });
     let networkType = 'unknown';
+    // 浏览器不支持获取网络状态
     if (!connection) {
         return handle.success({ networkType });
     }
+    // Supports only the navigator.connection.type value which doesn't match the latest spec.
+    // https://www.davidbcalhoun.com/2010/using-navigator-connection-android/
     if (!isNaN(Number(connection.type))) {
         switch (connection.type) {
+            // @ts-ignore
             case connection.WIFI:
                 networkType = 'wifi';
                 break;
+            // @ts-ignore
             case connection.CELL_3G:
                 networkType = '3g';
                 break;
+            // @ts-ignore
             case connection.CELL_2G:
                 networkType = '2g';
                 break;
             default:
+                // ETHERNET, UNKNOWN
                 networkType = 'unknown';
         }
     }
     else if (connection.type) {
-        networkType = connection.type;
+        // @ts-ignore
+        networkType = connection.type; // Only supports the type value.
+        // @ts-ignore
     }
     else if (connection.effectiveType) {
+        // @ts-ignore
         networkType = connection.effectiveType;
     }
     return handle.success({ networkType });
@@ -1426,12 +1469,15 @@ const onNetworkStatusChange = (cb) => {
 const offNetworkStatusChange = temporarilyNotSupport('offNetworkStatusChange');
 const getLocalIPAddress = temporarilyNotSupport('getLocalIPAddress');
 
+// 更新
 const updateWeChatApp = temporarilyNotSupport('updateWeChatApp');
 const getUpdateManager = temporarilyNotSupport('getUpdateManager');
 
+// 生命周期
 const getLaunchOptionsSync = temporarilyNotSupport('getLaunchOptionsSync');
 const getEnterOptionsSync = temporarilyNotSupport('getEnterOptionsSync');
 
+// 应用级事件
 const onUnhandledRejection = temporarilyNotSupport('onUnhandledRejection');
 const onThemeChange = temporarilyNotSupport('onThemeChange');
 const onPageNotFound = temporarilyNotSupport('onPageNotFound');
@@ -1453,11 +1499,14 @@ const setEnableDebug = temporarilyNotSupport('setEnableDebug');
 const getRealtimeLogManager = temporarilyNotSupport('getRealtimeLogManager');
 const getLogManager = temporarilyNotSupport('getLogManager');
 
+// 性能
 const reportPerformance = temporarilyNotSupport('reportPerformance');
 const getPerformance = temporarilyNotSupport('getPerformance');
 
+// 加密
 const getUserCryptoManager = temporarilyNotSupport('getUserCryptoManager');
 
+// TODO env 环境变量
 const canIUse = temporarilyNotSupport('canIUse');
 function arrayBufferToBase64(arrayBuffer) {
     return fromByteArray_1(arrayBuffer);
@@ -1521,6 +1570,7 @@ class CanvasContext {
     get shadowOffsetY() { return this.ctx.shadowOffsetY; }
     set strokeStyle(e) { this.enqueueActions(() => { this.ctx.strokeStyle = e; }); }
     get strokeStyle() { return this.ctx.strokeStyle; }
+    /** 小程序文档中不包括 ↓↓↓ */
     set textAlign(e) { this.ctx.textAlign = e; }
     get textAlign() { return this.ctx.textAlign; }
     set textBaseline(e) { this.ctx.textBaseline = e; }
@@ -1533,6 +1583,7 @@ class CanvasContext {
     get imageSmoothingQuality() { return this.ctx.imageSmoothingQuality; }
     set filter(e) { this.enqueueActions(() => { this.ctx.filter = e; }); }
     get filter() { return this.ctx.filter; }
+    /** 小程序文档中不包括 ↑↑↑ */
     arc(...args) { return this.enqueueActions(this.ctx.arc, ...args); }
     arcTo(...args) { return this.enqueueActions(this.ctx.arcTo, ...args); }
     beginPath(...args) { return this.enqueueActions(this.ctx.beginPath, ...args); }
@@ -1543,11 +1594,16 @@ class CanvasContext {
     createPattern(image, repetition) {
         return this.createPattern(image, repetition);
     }
+    /**
+     * 将之前在绘图上下文中的描述（路径、变形、样式）画到 canvas 中。
+     * @todo 每次 draw 都会读取 width 和 height
+     */
     async draw(reserve, callback) {
         try {
             if (!reserve) {
                 this.ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);
             }
+            // 部分 action 是异步的
             for (const { func, args } of this.actions) {
                 await func.apply(this.ctx, args);
             }
@@ -1555,6 +1611,7 @@ class CanvasContext {
             callback && callback();
         }
         catch (e) {
+            /* eslint-disable no-throw-literal */
             throw {
                 errMsg: e.message
             };
@@ -1562,6 +1619,7 @@ class CanvasContext {
     }
     drawImage(imageResource, ...extra) {
         this.enqueueActions(() => {
+            // 需要转换为 Image
             if (typeof imageResource === 'string') {
                 const img = new Image();
                 img.src = imageResource;
@@ -1649,6 +1707,9 @@ class CanvasContext {
     }
 }
 
+/**
+ * 创建 canvas 的绘图上下文 CanvasContext 对象
+ */
 const createCanvasContext = (canvasId, inst) => {
     const el = findDOM(inst);
     const canvas = el === null || el === void 0 ? void 0 : el.querySelector(`canvas[canvas-id="${canvasId}"]`);
@@ -1661,6 +1722,10 @@ const createCanvasContext = (canvasId, inst) => {
     return context;
 };
 
+/**
+ * 把当前画布指定区域的内容导出生成指定大小的图片。在 draw() 回调里调用该方法才能保证图片导出成功。
+ * @todo 暂未支持尺寸相关功能
+ */
 const canvasToTempFilePath = ({ canvasId, fileType, quality, success, fail, complete }, inst) => {
     const handle = new MethodHandler({ name: 'canvasToTempFilePath', success, fail, complete });
     const el = findDOM(inst);
@@ -1678,12 +1743,17 @@ const canvasToTempFilePath = ({ canvasId, fileType, quality, success, fail, comp
     }
 };
 
+/**
+ * 将像素数据绘制到画布。在自定义组件下，第二个参数传入自定义组件实例 this，以操作组件内 <canvas> 组件
+ * @todo 暂未支持尺寸相关功能
+ */
 const canvasPutImageData = ({ canvasId, data, x, y, success, fail, complete }, inst) => {
     const handle = new MethodHandler({ name: 'canvasPutImageData', success, fail, complete });
     const el = findDOM(inst);
     const canvas = el === null || el === void 0 ? void 0 : el.querySelector(`canvas[canvas-id="${canvasId}"]`);
     try {
         const ctx = canvas.getContext('2d');
+        // TODO Uint8ClampedArray => ImageData
         ctx === null || ctx === void 0 ? void 0 : ctx.putImageData(data, x, y);
         return handle.success();
     }
@@ -1694,12 +1764,16 @@ const canvasPutImageData = ({ canvasId, data, x, y, success, fail, complete }, i
     }
 };
 
+/**
+ * 获取 canvas 区域隐含的像素数据。
+ */
 const canvasGetImageData = ({ canvasId, success, fail, complete, x, y, width, height }, inst) => {
     const handle = new MethodHandler({ name: 'canvasGetImageData', success, fail, complete });
     const el = findDOM(inst);
     const canvas = el === null || el === void 0 ? void 0 : el.querySelector(`canvas[canvas-id="${canvasId}"]`);
     try {
         const ctx = canvas === null || canvas === void 0 ? void 0 : canvas.getContext('2d');
+        // TODO ImageData => Uint8ClampedArray
         const data = ctx === null || ctx === void 0 ? void 0 : ctx.getImageData(x, y, width, height);
         return handle.success({
             width,
@@ -1714,6 +1788,7 @@ const canvasGetImageData = ({ canvasId, success, fail, complete, x, y, width, he
     }
 };
 
+// 画布
 const createOffscreenCanvas = temporarilyNotSupport('createOffscreenCanvas');
 const drawCanvas = temporarilyNotSupport('drawCanvas');
 
@@ -1722,10 +1797,13 @@ class cloud {
         this.init = temporarilyNotSupport('cloud.init');
         this.CloudID = temporarilyNotSupport('cloud.CloudID');
         this.callFunction = temporarilyNotSupport('cloud.callFunction');
+        // @ts-ignore
         this.uploadFile = temporarilyNotSupport('cloud.uploadFile');
+        // @ts-ignore
         this.downloadFile = temporarilyNotSupport('cloud.downloadFile');
         this.getTempFileURL = temporarilyNotSupport('cloud.getTempFileURL');
         this.deleteFile = temporarilyNotSupport('cloud.deleteFile');
+        // @ts-ignore
         this.database = temporarilyNotSupport('cloud.database');
         this.callContainer = temporarilyNotSupport('cloud.callContainer');
     }
@@ -1736,8 +1814,11 @@ const reportAnalytics = temporarilyNotSupport('reportAnalytics');
 const reportEvent = temporarilyNotSupport('reportEvent');
 const getExptInfoSync = temporarilyNotSupport('getExptInfoSync');
 
-const callbackManager = new CallbackManager();
+const callbackManager$3 = new CallbackManager();
 let devicemotionListener;
+/**
+ * 停止监听加速度数据。
+ */
 const stopAccelerometer = ({ success, fail, complete } = {}) => {
     const res = {};
     const handle = new MethodHandler({ name: 'stopAccelerometer', success, fail, complete });
@@ -1750,7 +1831,7 @@ const stopAccelerometer = ({ success, fail, complete } = {}) => {
         return handle.fail(res);
     }
 };
-const INTERVAL_MAP = {
+const INTERVAL_MAP$1 = {
     game: {
         interval: 20,
         frequency: 50
@@ -1772,7 +1853,7 @@ const getDevicemotionListener = interval => {
             return;
         lock = true;
         timer && clearTimeout(timer);
-        callbackManager.trigger({
+        callbackManager$3.trigger({
             x: evt.acceleration.x || 0,
             y: evt.acceleration.y || 0,
             z: evt.acceleration.z || 0
@@ -1780,11 +1861,14 @@ const getDevicemotionListener = interval => {
         timer = setTimeout(() => { lock = false; }, interval);
     };
 };
+/**
+ * 开始监听加速度数据。
+ */
 const startAccelerometer = ({ interval = 'normal', success, fail, complete } = {}) => {
     const handle = new MethodHandler({ name: 'startAccelerometer', success, fail, complete });
     try {
         if (window.DeviceMotionEvent) {
-            const intervalObj = INTERVAL_MAP[interval];
+            const intervalObj = INTERVAL_MAP$1[interval];
             if (devicemotionListener) {
                 stopAccelerometer();
             }
@@ -1800,18 +1884,27 @@ const startAccelerometer = ({ interval = 'normal', success, fail, complete } = {
         return handle.fail({ errMsg: e.message });
     }
 };
+/**
+ * 监听加速度数据事件。频率根据 Taro.startAccelerometer() 的 interval 参数。可使用 Taro.stopAccelerometer() 停止监听。
+ */
 const onAccelerometerChange = callback => {
-    callbackManager.add(callback);
+    callbackManager$3.add(callback);
 };
+/**
+ * 取消监听加速度数据事件，参数为空，则取消所有的事件监听
+ */
 const offAccelerometerChange = callback => {
-    callbackManager.remove(callback);
+    callbackManager$3.remove(callback);
 };
 
+// 无障碍
 const checkIsOpenAccessibility = temporarilyNotSupport('checkIsOpenAccessibility');
 
+// 电量
 const getBatteryInfoSync = temporarilyNotSupport('getBatteryInfoSync');
 const getBatteryInfo = temporarilyNotSupport('getBatteryInfo');
 
+// 蓝牙-通用
 const stopBluetoothDevicesDiscovery = temporarilyNotSupport('stopBluetoothDevicesDiscovery');
 const startBluetoothDevicesDiscovery = temporarilyNotSupport('startBluetoothDevicesDiscovery');
 const openBluetoothAdapter = temporarilyNotSupport('openBluetoothAdapter');
@@ -1826,6 +1919,7 @@ const getBluetoothDevices = temporarilyNotSupport('getBluetoothDevices');
 const getBluetoothAdapterState = temporarilyNotSupport('getBluetoothAdapterState');
 const closeBluetoothAdapter = temporarilyNotSupport('closeBluetoothAdapter');
 
+// 蓝牙-低功耗中心设备
 const writeBLECharacteristicValue = temporarilyNotSupport('writeBLECharacteristicValue');
 const setBLEMTU = temporarilyNotSupport('setBLEMTU');
 const readBLECharacteristicValue = temporarilyNotSupport('readBLECharacteristicValue');
@@ -1843,13 +1937,16 @@ const getBLEDeviceCharacteristics = temporarilyNotSupport('getBLEDeviceCharacter
 const createBLEConnection = temporarilyNotSupport('createBLEConnection');
 const closeBLEConnection = temporarilyNotSupport('closeBLEConnection');
 
+// 蓝牙-低功耗外围设备
 const onBLEPeripheralConnectionStateChanged = temporarilyNotSupport('onBLEPeripheralConnectionStateChanged');
 const offBLEPeripheralConnectionStateChanged = temporarilyNotSupport('offBLEPeripheralConnectionStateChanged');
 const createBLEPeripheralServer = temporarilyNotSupport('createBLEPeripheralServer');
 
+// 日历
 const addPhoneRepeatCalendar = temporarilyNotSupport('addPhoneRepeatCalendar');
 const addPhoneCalendar = temporarilyNotSupport('addPhoneCalendar');
 
+// 周期性更新
 const setBackgroundFetchToken = temporarilyNotSupport('setBackgroundFetchToken');
 const onBackgroundFetchData = temporarilyNotSupport('onBackgroundFetchData');
 const getBackgroundFetchToken = temporarilyNotSupport('getBackgroundFetchToken');
@@ -1861,6 +1958,7 @@ function getItem(key) {
         item = JSON.parse(localStorage.getItem(key) || '');
     }
     catch (e) { }
+    // 只返回使用 Taro.setStorage API 存储的数据
     if (item && typeof item === 'object' && item.hasOwnProperty('data')) {
         return { result: true, data: item.data };
     }
@@ -1868,6 +1966,7 @@ function getItem(key) {
         return { result: false };
     }
 }
+// 数据缓存
 const setStorageSync = (key, data = '') => {
     if (typeof key !== 'string') {
         console.error(getParameterError({
@@ -1888,6 +1987,7 @@ const setStorageSync = (key, data = '') => {
     localStorage.setItem(key, JSON.stringify(obj));
 };
 const setStorage = (options) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `setStorage:fail ${isObject.msg}` };
@@ -1921,6 +2021,7 @@ const removeStorageSync = (key) => {
     localStorage.removeItem(key);
 };
 const removeStorage = (options) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `removeStorage:fail ${isObject.msg}` };
@@ -1968,6 +2069,7 @@ const getStorageInfo = ({ success, fail, complete } = {}) => {
     return handle.success(getStorageInfoSync());
 };
 const getStorage = (options) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `getStorage:fail ${isObject.msg}` };
@@ -2005,6 +2107,12 @@ const clearStorage = ({ success, fail, complete } = {}) => {
     return handle.success();
 };
 
+/**
+ * 剪贴板部分的api参考了Chameleon项目的实现：
+ *
+ * setClipboardData: https://github.com/chameleon-team/chameleon-api/tree/master/src/interfaces/setClipBoardData
+ * getClipboardData: https://github.com/chameleon-team/chameleon-api/tree/master/src/interfaces/getClipBoardData
+ */
 const CLIPBOARD_STORAGE_NAME = 'taro_clipboard';
 document.addEventListener('copy', () => {
     var _a;
@@ -2015,10 +2123,18 @@ document.addEventListener('copy', () => {
         console.error(e);
     });
 });
+/**
+ * 设置系统剪贴板的内容
+ */
 const setClipboardData = async ({ data, success, fail, complete }) => {
     const handle = new MethodHandler({ name: 'setClipboardData', success, fail, complete });
     try {
         setStorageSync(CLIPBOARD_STORAGE_NAME, data);
+        /**
+         * 已于 iPhone 6s Plus iOS 13.1.3 上的 Safari 测试通过
+         * iOS < 10 的系统可能无法使用编程方式访问剪贴板，参考：
+         * https://stackoverflow.com/questions/34045777/copy-to-clipboard-using-javascript-in-ios/34046084
+         */
         if (typeof document.execCommand === 'function') {
             const textarea = document.createElement('textarea');
             textarea.readOnly = true;
@@ -2041,6 +2157,9 @@ const setClipboardData = async ({ data, success, fail, complete }) => {
         return handle.fail({ errMsg: e.message });
     }
 };
+/**
+ * 获取系统剪贴板的内容
+ */
 const getClipboardData = async ({ success, fail, complete } = {}) => {
     const handle = new MethodHandler({ name: 'getClipboardData', success, fail, complete });
     try {
@@ -2052,8 +2171,11 @@ const getClipboardData = async ({ success, fail, complete } = {}) => {
     }
 };
 
-const callbackManager$1 = new CallbackManager();
+const callbackManager$2 = new CallbackManager();
 let compassListener;
+/**
+ * 停止监听罗盘数据
+ */
 const stopCompass = ({ success, fail, complete } = {}) => {
     const handle = new MethodHandler({ name: 'stopCompass', success, fail, complete });
     try {
@@ -2064,7 +2186,7 @@ const stopCompass = ({ success, fail, complete } = {}) => {
         return handle.fail({ errMsg: e.message });
     }
 };
-const getDeviceOrientationListener = interval => {
+const getDeviceOrientationListener$1 = interval => {
     let lock;
     let timer;
     return evt => {
@@ -2072,12 +2194,15 @@ const getDeviceOrientationListener = interval => {
             return;
         lock = true;
         timer && clearTimeout(timer);
-        callbackManager$1.trigger({
+        callbackManager$2.trigger({
             direction: 360 - evt.alpha
         });
         timer = setTimeout(() => { lock = false; }, interval);
     };
 };
+/**
+ * 开始监听罗盘数据
+ */
 const startCompass = ({ success, fail, complete } = {}) => {
     const handle = new MethodHandler({ name: 'startCompass', success, fail, complete });
     try {
@@ -2085,7 +2210,7 @@ const startCompass = ({ success, fail, complete } = {}) => {
             if (compassListener) {
                 stopCompass();
             }
-            compassListener = getDeviceOrientationListener(200);
+            compassListener = getDeviceOrientationListener$1(200);
             window.addEventListener('deviceorientation', compassListener, true);
         }
         else {
@@ -2097,23 +2222,33 @@ const startCompass = ({ success, fail, complete } = {}) => {
         return handle.fail({ errMsg: e.message });
     }
 };
+/**
+ * 监听罗盘数据变化事件。频率：5 次/秒，接口调用后会自动开始监听，可使用 wx.stopCompass 停止监听。
+ */
 const onCompassChange = callback => {
-    callbackManager$1.add(callback);
+    callbackManager$2.add(callback);
 };
+/**
+ * 取消监听罗盘数据变化事件，参数为空，则取消所有的事件监听。
+ */
 const offCompassChange = callback => {
-    callbackManager$1.remove(callback);
+    callbackManager$2.remove(callback);
 };
 
+// 联系人
 const chooseContact = temporarilyNotSupport('chooseContact');
 const addPhoneContact = temporarilyNotSupport('addPhoneContact');
 
+// 加密
 const getRandomValues = temporarilyNotSupport('getRandomValues');
 
+// 陀螺仪
 const stopGyroscope = temporarilyNotSupport('stopGyroscope');
 const startGyroscope = temporarilyNotSupport('startGyroscope');
 const onGyroscopeChange = temporarilyNotSupport('onGyroscopeChange');
 const offGyroscopeChange = temporarilyNotSupport('offGyroscopeChange');
 
+// 蓝牙-信标(Beacon)
 const stopBeaconDiscovery = temporarilyNotSupport('stopBeaconDiscovery');
 const startBeaconDiscovery = temporarilyNotSupport('startBeaconDiscovery');
 const onBeaconUpdate = temporarilyNotSupport('onBeaconUpdate');
@@ -2122,17 +2257,19 @@ const offBeaconUpdate = temporarilyNotSupport('offBeaconUpdate');
 const offBeaconServiceChange = temporarilyNotSupport('offBeaconServiceChange');
 const getBeacons = temporarilyNotSupport('getBeacons');
 
+// 键盘
 const onKeyboardHeightChange = temporarilyNotSupport('onKeyboardHeightChange');
 const offKeyboardHeightChange = temporarilyNotSupport('offKeyboardHeightChange');
 const hideKeyboard = temporarilyNotSupport('hideKeyboard');
 const getSelectedTextRange = temporarilyNotSupport('getSelectedTextRange');
 
+// 内存
 const onMemoryWarning = temporarilyNotSupport('onMemoryWarning');
 const offMemoryWarning = temporarilyNotSupport('offMemoryWarning');
 
-const callbackManager$2 = new CallbackManager();
+const callbackManager$1 = new CallbackManager();
 let deviceMotionListener;
-const INTERVAL_MAP$1 = {
+const INTERVAL_MAP = {
     game: {
         interval: 20,
         frequency: 50
@@ -2146,6 +2283,9 @@ const INTERVAL_MAP$1 = {
         frequency: 5
     }
 };
+/**
+ * 停止监听设备方向的变化。
+ */
 const stopDeviceMotionListening = ({ success, fail, complete } = {}) => {
     const handle = new MethodHandler({ name: 'stopDeviceMotionListening', success, fail, complete });
     try {
@@ -2156,7 +2296,7 @@ const stopDeviceMotionListening = ({ success, fail, complete } = {}) => {
         return handle.fail({ errMsg: e.message });
     }
 };
-const getDeviceOrientationListener$1 = interval => {
+const getDeviceOrientationListener = interval => {
     let lock;
     let timer;
     return evt => {
@@ -2164,7 +2304,7 @@ const getDeviceOrientationListener$1 = interval => {
             return;
         lock = true;
         timer && clearTimeout(timer);
-        callbackManager$2.trigger({
+        callbackManager$1.trigger({
             alpha: evt.alpha,
             beta: evt.beta,
             gamma: evt.gamma
@@ -2172,15 +2312,18 @@ const getDeviceOrientationListener$1 = interval => {
         timer = setTimeout(() => { lock = false; }, interval);
     };
 };
+/**
+ * 开始监听设备方向的变化。
+ */
 const startDeviceMotionListening = ({ interval = 'normal', success, fail, complete } = {}) => {
     const handle = new MethodHandler({ name: 'startDeviceMotionListening', success, fail, complete });
     try {
-        const intervalObj = INTERVAL_MAP$1[interval];
+        const intervalObj = INTERVAL_MAP[interval];
         if (window.DeviceOrientationEvent) {
             if (deviceMotionListener) {
                 stopDeviceMotionListening();
             }
-            deviceMotionListener = getDeviceOrientationListener$1(intervalObj.interval);
+            deviceMotionListener = getDeviceOrientationListener(intervalObj.interval);
             window.addEventListener('deviceorientation', deviceMotionListener, true);
         }
         else {
@@ -2192,13 +2335,20 @@ const startDeviceMotionListening = ({ interval = 'normal', success, fail, comple
         return handle.fail({ errMsg: e.message });
     }
 };
+/**
+ * 监听设备方向变化事件。
+ */
 const onDeviceMotionChange = callback => {
-    callbackManager$2.add(callback);
+    callbackManager$1.add(callback);
 };
+/**
+ * 取消监听设备方向变化事件，参数为空，则取消所有的事件监听。
+ */
 const offDeviceMotionChange = callback => {
-    callbackManager$2.remove(callback);
+    callbackManager$1.remove(callback);
 };
 
+// NFC
 const stopHCE = temporarilyNotSupport('stopHCE');
 const startHCE = temporarilyNotSupport('startHCE');
 const sendHCEMessage = temporarilyNotSupport('sendHCEMessage');
@@ -2208,6 +2358,7 @@ const getNFCAdapter = temporarilyNotSupport('getNFCAdapter');
 const getHCEState = temporarilyNotSupport('getHCEState');
 
 const makePhoneCall = (options) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `makePhoneCall:fail ${isObject.msg}` };
@@ -2229,11 +2380,13 @@ const makePhoneCall = (options) => {
     return handle.success();
 };
 
+// 扫码
 const scanCode = processOpenApi('scanQRCode', { needResult: 1 }, res => ({
     errMsg: res.errMsg === 'scanQRCode:ok' ? 'scanCode:ok' : res.errMsg,
     result: res.resultStr
 }));
 
+// 屏幕
 const setVisualEffectOnCapture = temporarilyNotSupport('setVisualEffectOnCapture');
 const setScreenBrightness = temporarilyNotSupport('setScreenBrightness');
 const setKeepScreenOn = temporarilyNotSupport('setKeepScreenOn');
@@ -2249,6 +2402,9 @@ const vibrator = function vibrator(mm) {
         console.warn('当前浏览器不支持vibrate');
     }
 };
+/**
+ * 使手机发生较短时间的振动（15 ms）。仅在 iPhone 7 / 7 Plus 以上及 Android 机型生效
+ */
 const vibrateShort = ({ success, fail, complete } = {}) => {
     const handle = new MethodHandler({ name: 'vibrateShort', success, fail, complete });
     if (vibrator) {
@@ -2259,6 +2415,9 @@ const vibrateShort = ({ success, fail, complete } = {}) => {
         return handle.fail();
     }
 };
+/**
+ * 使手机发生较长时间的振动（400 ms)
+ */
 const vibrateLong = ({ success, fail, complete } = {}) => {
     const handle = new MethodHandler({ name: 'vibrateLong', success, fail, complete });
     if (vibrator) {
@@ -2270,6 +2429,7 @@ const vibrateLong = ({ success, fail, complete } = {}) => {
     }
 };
 
+// Wi-Fi
 const stopWifi = temporarilyNotSupport('stopWifi');
 const startWifi = temporarilyNotSupport('startWifi');
 const setWifiList = temporarilyNotSupport('setWifiList');
@@ -2281,9 +2441,11 @@ const getWifiList = temporarilyNotSupport('getWifiList');
 const getConnectedWifi = temporarilyNotSupport('getConnectedWifi');
 const connectWifi = temporarilyNotSupport('connectWifi');
 
+// 第三方平台
 const getExtConfigSync = temporarilyNotSupport('getExtConfigSync');
 const getExtConfig = temporarilyNotSupport('getExtConfig');
 
+// 文件
 const saveFileToDisk = temporarilyNotSupport('saveFileToDisk');
 const saveFile = temporarilyNotSupport('saveFile');
 const removeSavedFile = temporarilyNotSupport('removeSavedFile');
@@ -2294,9 +2456,10 @@ const getFileSystemManager = temporarilyNotSupport('getFileSystemManager');
 const getFileInfo = temporarilyNotSupport('getFileInfo');
 
 const getApp = function () {
-    return Taro.getCurrentInstance().app;
+    return Taro__default['default'].getCurrentInstance().app;
 };
-const getCurrentInstance = Taro.getCurrentInstance;
+// 自定义组件
+const getCurrentInstance = Taro__default['default'].getCurrentInstance;
 
 function styleInject(css, ref) {
   if (ref === void 0) ref = {};
@@ -2328,7 +2491,7 @@ function styleInject(css, ref) {
 }
 
 var css_248z = ".taro_choose_location {\r\n  position: fixed;\r\n  display: flex;\r\n  flex-direction: column;\r\n  width: 100%;\r\n  height: 100%;\r\n  top: 100%;\r\n  background-color: #fff;\r\n  transition: ease top .3s;\r\n  z-index: 1;\r\n}\r\n\r\n.taro_choose_location_bar {\r\n  display: flex;\r\n  flex: 0 95px;\r\n  height: 95px;\r\n  background-color: #ededed;\r\n  color: #090909;\r\n}\r\n\r\n.taro_choose_location_back {\r\n  flex: 0 45px;\r\n  position: relative;\r\n  width: 33px;\r\n  height: 30px;\r\n  margin-top: 30px;\r\n}\r\n\r\n.taro_choose_location_back::before {\r\n  content: '';\r\n  position: absolute;\r\n  top: 0;\r\n  left: 0;\r\n  display: block;\r\n  width: 0;\r\n  height: 0;\r\n  border: solid 15px;\r\n  border-top-color: transparent;\r\n  border-right-color: #090909;\r\n  border-bottom-color: transparent;\r\n  border-left-color: transparent;\r\n}\r\n\r\n.taro_choose_location_back::after {\r\n  content: '';\r\n  position: absolute;\r\n  display: block;\r\n  width: 0;\r\n  height: 0;\r\n  top: 0;\r\n  left: 3px;\r\n  border: solid 15px;\r\n  border-top-color: transparent;\r\n  border-right-color: #ededed;\r\n  border-bottom-color: transparent;\r\n  border-left-color: transparent;\r\n}\r\n\r\n.taro_choose_location_title {\r\n  flex: 1;\r\n  line-height: 95px;\r\n  padding-left: 30px;\r\n}\r\n\r\n.taro_choose_location_submit {\r\n  width: 110px;\r\n  height: 60px;\r\n  color: #fff;\r\n  background-color: #08bf62;\r\n  border: none;\r\n  font-size: 28px;\r\n  line-height: 60px;\r\n  padding: 0;\r\n  margin: 18px 30px 0 0;\r\n}\r\n\r\n.taro_choose_location_frame {\r\n  flex: 1;\r\n}";
-const stylesheet=".taro_choose_location {\r\n  position: fixed;\r\n  display: flex;\r\n  flex-direction: column;\r\n  width: 100%;\r\n  height: 100%;\r\n  top: 100%;\r\n  background-color: #fff;\r\n  transition: ease top .3s;\r\n  z-index: 1;\r\n}\r\n\r\n.taro_choose_location_bar {\r\n  display: flex;\r\n  flex: 0 95px;\r\n  height: 95px;\r\n  background-color: #ededed;\r\n  color: #090909;\r\n}\r\n\r\n.taro_choose_location_back {\r\n  flex: 0 45px;\r\n  position: relative;\r\n  width: 33px;\r\n  height: 30px;\r\n  margin-top: 30px;\r\n}\r\n\r\n.taro_choose_location_back::before {\r\n  content: '';\r\n  position: absolute;\r\n  top: 0;\r\n  left: 0;\r\n  display: block;\r\n  width: 0;\r\n  height: 0;\r\n  border: solid 15px;\r\n  border-top-color: transparent;\r\n  border-right-color: #090909;\r\n  border-bottom-color: transparent;\r\n  border-left-color: transparent;\r\n}\r\n\r\n.taro_choose_location_back::after {\r\n  content: '';\r\n  position: absolute;\r\n  display: block;\r\n  width: 0;\r\n  height: 0;\r\n  top: 0;\r\n  left: 3px;\r\n  border: solid 15px;\r\n  border-top-color: transparent;\r\n  border-right-color: #ededed;\r\n  border-bottom-color: transparent;\r\n  border-left-color: transparent;\r\n}\r\n\r\n.taro_choose_location_title {\r\n  flex: 1;\r\n  line-height: 95px;\r\n  padding-left: 30px;\r\n}\r\n\r\n.taro_choose_location_submit {\r\n  width: 110px;\r\n  height: 60px;\r\n  color: #fff;\r\n  background-color: #08bf62;\r\n  border: none;\r\n  font-size: 28px;\r\n  line-height: 60px;\r\n  padding: 0;\r\n  margin: 18px 30px 0 0;\r\n}\r\n\r\n.taro_choose_location_frame {\r\n  flex: 1;\r\n}";
+var stylesheet=".taro_choose_location {\r\n  position: fixed;\r\n  display: flex;\r\n  flex-direction: column;\r\n  width: 100%;\r\n  height: 100%;\r\n  top: 100%;\r\n  background-color: #fff;\r\n  transition: ease top .3s;\r\n  z-index: 1;\r\n}\r\n\r\n.taro_choose_location_bar {\r\n  display: flex;\r\n  flex: 0 95px;\r\n  height: 95px;\r\n  background-color: #ededed;\r\n  color: #090909;\r\n}\r\n\r\n.taro_choose_location_back {\r\n  flex: 0 45px;\r\n  position: relative;\r\n  width: 33px;\r\n  height: 30px;\r\n  margin-top: 30px;\r\n}\r\n\r\n.taro_choose_location_back::before {\r\n  content: '';\r\n  position: absolute;\r\n  top: 0;\r\n  left: 0;\r\n  display: block;\r\n  width: 0;\r\n  height: 0;\r\n  border: solid 15px;\r\n  border-top-color: transparent;\r\n  border-right-color: #090909;\r\n  border-bottom-color: transparent;\r\n  border-left-color: transparent;\r\n}\r\n\r\n.taro_choose_location_back::after {\r\n  content: '';\r\n  position: absolute;\r\n  display: block;\r\n  width: 0;\r\n  height: 0;\r\n  top: 0;\r\n  left: 3px;\r\n  border: solid 15px;\r\n  border-top-color: transparent;\r\n  border-right-color: #ededed;\r\n  border-bottom-color: transparent;\r\n  border-left-color: transparent;\r\n}\r\n\r\n.taro_choose_location_title {\r\n  flex: 1;\r\n  line-height: 95px;\r\n  padding-left: 30px;\r\n}\r\n\r\n.taro_choose_location_submit {\r\n  width: 110px;\r\n  height: 60px;\r\n  color: #fff;\r\n  background-color: #08bf62;\r\n  border: none;\r\n  font-size: 28px;\r\n  line-height: 60px;\r\n  padding: 0;\r\n  margin: 18px 30px 0 0;\r\n}\r\n\r\n.taro_choose_location_frame {\r\n  flex: 1;\r\n}";
 styleInject(css_248z,{"insertAt":"top"});
 
 function createLocationChooser(handler, key = LOCATION_APIKEY) {
@@ -2375,6 +2538,9 @@ function createLocationChooser(handler, key = LOCATION_APIKEY) {
         container
     };
 }
+/**
+ * 打开地图选择位置。
+ */
 const chooseLocation = ({ success, fail, complete } = {}) => {
     const key = LOCATION_APIKEY;
     const handle = new MethodHandler({ name: 'chooseLocation', success, fail, complete });
@@ -2387,7 +2553,9 @@ const chooseLocation = ({ success, fail, complete } = {}) => {
             }, reject);
         }
         const onMessage = event => {
+            // 接收位置信息，用户选择确认位置点后选点组件会触发该事件，回传用户的位置信息
             const loc = event.data;
+            // 防止其他应用也会向该页面 post 信息，需判断 module 是否为'locationPicker'
             if (!loc || loc.module !== 'locationPicker')
                 return;
             chooseLocation.name = loc.poiname;
@@ -2418,6 +2586,7 @@ const chooseLocation = ({ success, fail, complete } = {}) => {
     });
 };
 
+// 位置
 const stopLocationUpdate = temporarilyNotSupport('stopLocationUpdate');
 const startLocationUpdateBackground = temporarilyNotSupport('startLocationUpdateBackground');
 const startLocationUpdate = temporarilyNotSupport('startLocationUpdate');
@@ -2429,6 +2598,7 @@ const offLocationChange = temporarilyNotSupport('offLocationChange');
 const getLocation = processOpenApi('getLocation');
 const choosePoi = temporarilyNotSupport('choosePoi');
 
+// 音频
 class InnerAudioContext {
     constructor() {
         this.play = () => { var _a; return (_a = this.Instance) === null || _a === void 0 ? void 0 : _a.play(); };
@@ -2443,6 +2613,9 @@ class InnerAudioContext {
                 this.Instance.currentTime = position;
             }
         };
+        /**
+         * @TODO destroy得并不干净
+         */
         this.destroy = () => {
             this.stop();
             if (this.Instance) {
@@ -2473,7 +2646,7 @@ class InnerAudioContext {
         this.Instance = new Audio();
         this.errorStack = new CallbackManager();
         this.stopStack = new CallbackManager();
-        Taro.eventCenter.on('__taroRouterChange', () => { this.stop(); });
+        Taro__default['default'].eventCenter.on('__taroRouterChange', () => { this.stop(); });
     }
     set autoplay(e) { this.setProperty('autoplay', e); }
     get autoplay() { var _a; return ((_a = this.Instance) === null || _a === void 0 ? void 0 : _a.autoplay) || false; }
@@ -2505,9 +2678,13 @@ const pauseVoice = temporarilyNotSupport('pauseVoice');
 const getAvailableAudioSources = temporarilyNotSupport('getAvailableAudioSources');
 const createWebAudioContext = temporarilyNotSupport('createWebAudioContext');
 const createMediaAudioPlayer = temporarilyNotSupport('createMediaAudioPlayer');
+/**
+ * 创建内部 audio 上下文 InnerAudioContext 对象。
+ */
 const createInnerAudioContext = () => new InnerAudioContext();
 const createAudioContext = temporarilyNotSupport('createAudioContext');
 
+// 背景音频
 const stopBackgroundAudio = temporarilyNotSupport('stopBackgroundAudio');
 const seekBackgroundAudio = temporarilyNotSupport('seekBackgroundAudio');
 const playBackgroundAudio = temporarilyNotSupport('playBackgroundAudio');
@@ -2518,8 +2695,10 @@ const onBackgroundAudioPause = temporarilyNotSupport('onBackgroundAudioPause');
 const getBackgroundAudioPlayerState = temporarilyNotSupport('getBackgroundAudioPlayerState');
 const getBackgroundAudioManager = temporarilyNotSupport('getBackgroundAudioManager');
 
+// 相机
 const createCameraContext = temporarilyNotSupport('createCameraContext');
 
+// 富文本
 class EditorContext {
     constructor() {
         this.blur = temporarilyNotSupport('EditorContext.blur');
@@ -2537,6 +2716,12 @@ class EditorContext {
     }
 }
 
+/**
+ * previewImage api基于开源的React组件[react-wx-images-viewer](https://github.com/react-ld/react-wx-images-viewer)开发，感谢！
+ */
+/**
+ * 在新页面中全屏预览图片。预览的过程中用户可以进行保存图片、发送给朋友等操作。
+ */
 const previewImage = async (options) => {
     function loadImage(url, loadFail) {
         return new Promise((resolve) => {
@@ -2549,6 +2734,7 @@ const previewImage = async (options) => {
             div.style.cssText = 'display:flex;align-items:center;justify-content:center;max-width:100%;min-height:100%;';
             div.appendChild(image);
             item.appendChild(div);
+            // Note: 等待图片加载完后返回，会导致轮播被卡住
             resolve(item);
             if (typeof loadFail === 'function') {
                 image.addEventListener('error', (err) => {
@@ -2557,6 +2743,7 @@ const previewImage = async (options) => {
             }
         });
     }
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `previewImage:fail ${isObject.msg}` };
@@ -2572,6 +2759,7 @@ const previewImage = async (options) => {
         container.remove();
     });
     const swiper = document.createElement('taro-swiper-core');
+    // @ts-ignore
     swiper.full = true;
     let children = [];
     try {
@@ -2587,13 +2775,18 @@ const previewImage = async (options) => {
         swiper.appendChild(child);
     }
     const currentIndex = urls.indexOf(current);
+    // @ts-ignore
     swiper.current = currentIndex;
     container.appendChild(swiper);
     document.body.appendChild(container);
     return handle.success();
 };
 
+/**
+ * 获取图片信息。网络图片需先配置download域名才能生效。
+ */
 const getImageInfo = (options) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `getImageInfo:fail ${isObject.msg}` };
@@ -2619,7 +2812,11 @@ const getImageInfo = (options) => {
     });
 };
 
+/**
+ * 从本地相册选择图片或使用相机拍照。
+ */
 const chooseImage = function (options) {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `chooseImage:fail ${isObject.msg}` };
@@ -2688,31 +2885,45 @@ const chooseImage = function (options) {
     });
 };
 
+// 图片
 const saveImageToPhotosAlbum = temporarilyNotSupport('saveImageToPhotosAlbum');
 const previewMedia = temporarilyNotSupport('previewMedia');
 const compressImage = temporarilyNotSupport('compressImage');
 const chooseMessageFile = temporarilyNotSupport('chooseMessageFile');
 
+// 实时音视频
 const createLivePusherContext = temporarilyNotSupport('createLivePusherContext');
 const createLivePlayerContext = temporarilyNotSupport('createLivePlayerContext');
 
+// 地图
 const createMapContext = temporarilyNotSupport('createMapContext');
 
+// 画面录制器
 const createMediaRecorder = temporarilyNotSupport('createMediaRecorder');
 
+// 录音
 const stopRecord = temporarilyNotSupport('stopRecord');
 const startRecord = temporarilyNotSupport('startRecord');
 const getRecorderManager = temporarilyNotSupport('getRecorderManager');
 
+// 视频
 const saveVideoToPhotosAlbum = temporarilyNotSupport('saveVideoToPhotosAlbum');
 const openVideoEditor = temporarilyNotSupport('openVideoEditor');
 const getVideoInfo = temporarilyNotSupport('getVideoInfo');
+/**
+ * 创建 video 上下文 VideoContext 对象。
+ */
 const createVideoContext = (id, inst) => {
     const el = findDOM(inst);
+    // TODO HTMLVideoElement to VideoContext
     return el === null || el === void 0 ? void 0 : el.querySelector(`taro-video-core[id=${id}]`);
 };
 const compressVideo = temporarilyNotSupport('compressVideo');
+/**
+ * 拍摄视频或从手机相册中选视频。
+ */
 const chooseVideo = (options) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `chooseVideo:fail ${isObject.msg}` };
@@ -2768,10 +2979,13 @@ const chooseVideo = (options) => {
 };
 const chooseMedia = temporarilyNotSupport('chooseMedia');
 
+// 视频解码器
 const createVideoDecoder = temporarilyNotSupport('createVideoDecoder');
 
+// 音视频合成
 const createMediaContainer = temporarilyNotSupport('createMediaContainer');
 
+// 实时语音
 const updateVoIPChatMuteConfig = temporarilyNotSupport('updateVoIPChatMuteConfig');
 const subscribeVoIPVideoMembers = temporarilyNotSupport('subscribeVoIPVideoMembers');
 const setEnable1v1Chat = temporarilyNotSupport('setEnable1v1Chat');
@@ -2787,25 +3001,60 @@ const offVoIPChatInterrupted = temporarilyNotSupport('offVoIPChatInterrupted');
 const joinVoIPChat = temporarilyNotSupport('joinVoIPChat');
 const exitVoIPChat = temporarilyNotSupport('exitVoIPChat');
 
+// 跳转
 const openEmbeddedMiniProgram = temporarilyNotSupport('openEmbeddedMiniProgram');
 const navigateToMiniProgram = temporarilyNotSupport('navigateToMiniProgram');
 const navigateBackMiniProgram = temporarilyNotSupport('navigateBackMiniProgram');
 const exitMiniProgram = temporarilyNotSupport('exitMiniProgram');
 
+/**
+ * HTTP Response Header 事件回调函数的参数
+ * @typedef {Object} HeadersReceivedParam
+ * @property {Object} header 开发者服务器返回的 HTTP Response Header
+ */
+/**
+ * HTTP Response Header 事件的回调函数
+ * @callback HeadersReceivedCallback
+ * @param {HeadersReceivedParam} res 参数
+ */
+/**
+ * 进度变化回调函数的参数
+ * @typedef {Object} ProgressUpdateParam
+ * @property {number} progress 进度百分比
+ * @property {number} [totalBytesWritten] 已经下载的数据长度，单位 Bytes
+ * @property {number} [totalBytesSent] 已经上传的数据长度，单位 Bytes
+ * @property {number} [totalBytesExpectedToWrite] 预期需要下载的数据总长度，单位 Bytes
+ * @property {number} [totalBytesExpectedToSend] 预期需要上传的数据总长度，单位 Bytes
+ */
+/**
+ * 进度变化事件的回调函数
+ * @callback ProgressUpdateCallback
+ * @param {ProgressUpdateParam} res 参数
+ */
 const NETWORK_TIMEOUT = 60000;
 const XHR_STATS = {
     UNSENT: 0,
     OPENED: 1,
     HEADERS_RECEIVED: 2,
     LOADING: 3,
-    DONE: 4
+    DONE: 4 // The operation is complete.
 };
+/**
+ * 设置xhr的header
+ * @param {XMLHttpRequest} xhr
+ * @param {Object} header
+ */
 const setHeader = (xhr, header) => {
     let headerKey;
     for (headerKey in header) {
         xhr.setRequestHeader(headerKey, header[headerKey]);
     }
 };
+/**
+ * 将 blob url 转化为文件
+ * @param {string} url 要转换的 blob url
+ * @returns {Promise<File>}
+ */
 const convertObjectUrlToBlob = url => {
     return new Promise((resolve, reject) => {
         const xhr = new XMLHttpRequest();
@@ -2816,6 +3065,7 @@ const convertObjectUrlToBlob = url => {
                 resolve(this.response);
             }
             else {
+                /* eslint-disable prefer-promise-reject-errors */
                 reject({ status: this.status });
             }
         };
@@ -2869,6 +3119,9 @@ const createDownloadTask = ({ url, header, success, error }) => {
             errMsg: `${apiName}:fail ${e.message}`
         });
     };
+    /**
+     * 中断任务
+     */
     const abort = () => {
         xhr.abort();
     };
@@ -2887,9 +3140,25 @@ const createDownloadTask = ({ url, header, success, error }) => {
         }, NETWORK_TIMEOUT);
     };
     send();
+    /**
+     * 监听 HTTP Response Header 事件。会比请求完成事件更早
+     * @param {HeadersReceivedCallback} callback HTTP Response Header 事件的回调函数
+     */
     const onHeadersReceived = callbackManager.headersReceived.add;
+    /**
+     * 取消监听 HTTP Response Header 事件
+     * @param {HeadersReceivedCallback} callback HTTP Response Header 事件的回调函数
+     */
     const offHeadersReceived = callbackManager.headersReceived.remove;
+    /**
+     * 监听进度变化事件
+     * @param {ProgressUpdateCallback} callback HTTP Response Header 事件的回调函数
+     */
     const onProgressUpdate = callbackManager.progressUpdate.add;
+    /**
+     * 取消监听进度变化事件
+     * @param {ProgressUpdateCallback} callback HTTP Response Header 事件的回调函数
+     */
     const offProgressUpdate = callbackManager.progressUpdate.remove;
     return {
         abort,
@@ -2899,6 +3168,10 @@ const createDownloadTask = ({ url, header, success, error }) => {
         offProgressUpdate
     };
 };
+/**
+ * 下载文件资源到本地。客户端直接发起一个 HTTPS GET 请求，返回文件的本地临时路径。使用前请注意阅读相关说明。
+ * 注意：请在服务端响应的 header 中指定合理的 Content-Type 字段，以保证客户端正确处理文件类型。
+ */
 const downloadFile = ({ url, header, success, fail, complete }) => {
     let task;
     const result = new Promise((resolve, reject) => {
@@ -2923,6 +3196,7 @@ const downloadFile = ({ url, header, success, fail, complete }) => {
     return result;
 };
 
+// mDNS
 const stopLocalServiceDiscovery = temporarilyNotSupport('stopLocalServiceDiscovery');
 const startLocalServiceDiscovery = temporarilyNotSupport('startLocalServiceDiscovery');
 const onLocalServiceResolveFail = temporarilyNotSupport('onLocalServiceResolveFail');
@@ -3020,20 +3294,20 @@ function _objectSpread2(target) {
   return target;
 }
 
-function _typeof(obj) {
+function _typeof$1(obj) {
   "@babel/helpers - typeof";
 
   if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") {
-    _typeof = function (obj) {
+    _typeof$1 = function (obj) {
       return typeof obj;
     };
   } else {
-    _typeof = function (obj) {
+    _typeof$1 = function (obj) {
       return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj;
     };
   }
 
-  return _typeof(obj);
+  return _typeof$1(obj);
 }
 
 function _wrapRegExp() {
@@ -3652,6 +3926,8 @@ function _assertThisInitialized(self) {
 function _possibleConstructorReturn(self, call) {
   if (call && (typeof call === "object" || typeof call === "function")) {
     return call;
+  } else if (call !== void 0) {
+    throw new TypeError("Derived constructors may only return object or undefined");
   }
 
   return _assertThisInitialized(self);
@@ -5167,7 +5443,7 @@ function fetch$1(input, init) {
       }
     }
 
-    if (init && _typeof(init.headers) === 'object' && !(init.headers instanceof Headers)) {
+    if (init && _typeof$1(init.headers) === 'object' && !(init.headers instanceof Headers)) {
       Object.getOwnPropertyNames(init.headers).forEach(function (name) {
         xhr.setRequestHeader(name, normalizeValue(init.headers[name]));
       });
@@ -5295,7 +5571,7 @@ var objectAssign$1 = shouldUseNative() ? Object.assign : function (target, sourc
 };
 var enc = encodeURIComponent;
 
-function serializeParams$1(params) {
+function serializeParams(params) {
   if (!params) {
     return '';
   }
@@ -5305,7 +5581,7 @@ function serializeParams$1(params) {
   }).join('&');
 }
 
-function isFunction$1(fn) {
+function isFunction(fn) {
   return typeof fn === 'function';
 }
 
@@ -5410,19 +5686,19 @@ try {
 
 store.enabled = !store.disabled;
 
-var _typeof$1 = typeof Symbol === "function" && _typeof(Symbol.iterator) === "symbol" ? function (obj) {
-  return _typeof(obj);
+var _typeof = typeof Symbol === "function" && _typeof$1(Symbol.iterator) === "symbol" ? function (obj) {
+  return _typeof$1(obj);
 } : function (obj) {
-  return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : _typeof(obj);
+  return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : _typeof$1(obj);
 };
 
 var win = typeof window !== 'undefined' ? window : global;
 
 var canUsePromise = function () {
-  return 'Promise' in win && _typeof$1(isFunction$1(Promise));
+  return 'Promise' in win && _typeof(isFunction(Promise));
 }();
 
-var noop = function noop() {};
+var noop$1 = function noop() {};
 
 var encodeC = encodeURIComponent;
 var doc = win.document;
@@ -5446,16 +5722,16 @@ var defaultConfig = {
 var timestamp = new Date().getTime();
 
 function jsonp$1(url, opts, cb) {
-  if (isFunction$1(url)) {
+  if (isFunction(url)) {
     cb = url;
     opts = {};
-  } else if (url && (typeof url === 'undefined' ? 'undefined' : _typeof$1(url)) === 'object') {
+  } else if (url && (typeof url === 'undefined' ? 'undefined' : _typeof(url)) === 'object') {
     cb = opts;
     opts = url || {};
     url = opts.url;
   }
 
-  if (isFunction$1(opts)) {
+  if (isFunction(opts)) {
     cb = opts;
     opts = {};
   }
@@ -5466,7 +5742,7 @@ function jsonp$1(url, opts, cb) {
 
   opts = objectAssign$1({}, defaultConfig, opts);
   url = url || opts.url;
-  cb = cb || noop;
+  cb = cb || noop$1;
 
   if (!url || typeof url !== 'string') {
     cb(new Error('Param url is needed!'));
@@ -5523,7 +5799,7 @@ function jsonp$1(url, opts, cb) {
 }
 
 function generateJsonpUrlWithParams(url, params) {
-  params = typeof params === 'string' ? params : serializeParams$1(params);
+  params = typeof params === 'string' ? params : serializeParams(params);
   url += (~url.indexOf('?') ? '&' : '?') + ('' + params);
   url = url.replace('?&', '?');
   return url;
@@ -5609,7 +5885,7 @@ function fetchData(url, opts, cb) {
       script.parentNode.removeChild(script);
     }
 
-    win[funcId] = noop;
+    win[funcId] = noop$1;
     clearTimeout(win['timer_' + funcId]);
   }
 }
@@ -5730,15 +6006,17 @@ function appendScriptTagToHead(_ref4) {
   return script;
 }
 
-const { Link } = Taro;
+// @ts-ignore
+const { Link: Link$1 } = Taro__default['default'];
 function generateRequestUrlWithParams(url, params) {
-    params = typeof params === 'string' ? params : serializeParams(params);
+    params = typeof params === 'string' ? params : serializeParams$1(params);
     if (params) {
         url += (~url.indexOf('?') ? '&' : '?') + params;
     }
     url = url.replace('?&', '?');
     return url;
 }
+// FIXME 移除 any 标注
 function _request(options) {
     options = options || {};
     if (typeof options === 'string') {
@@ -5789,7 +6067,7 @@ function _request(options) {
             params.body = JSON.stringify(options.data);
         }
         else if (contentType.indexOf('application/x-www-form-urlencoded') >= 0) {
-            params.body = serializeParams(options.data);
+            params.body = serializeParams$1(options.data);
         }
         else {
             params.body = options.data;
@@ -5846,12 +6124,14 @@ function _request(options) {
 function taroInterceptor(chain) {
     return _request(chain.requestParams);
 }
-const link = new Link(taroInterceptor);
+const link = new Link$1(taroInterceptor);
 const request = link.request.bind(link);
 const addInterceptor = link.addInterceptor.bind(link);
 
+// TCP 通信
 const createTCPSocket = temporarilyNotSupport('createTCPSocket');
 
+// UDP 通信
 const createUDPSocket = temporarilyNotSupport('createUDPSocket');
 
 const createUploadTask = ({ url, filePath, formData, name, header, timeout, fileName, success, error }) => {
@@ -5905,6 +6185,9 @@ const createUploadTask = ({ url, filePath, formData, name, header, timeout, file
             errMsg: `${apiName}:fail ${e.message}`
         });
     };
+    /**
+     * 中断任务
+     */
     const abort = () => {
         clearTimeout(timeoutInter);
         xhr.abort();
@@ -5936,9 +6219,25 @@ const createUploadTask = ({ url, filePath, formData, name, header, timeout, file
             errMsg: `${apiName}:fail ${e.message}`
         });
     });
+    /**
+     * 监听 HTTP Response Header 事件。会比请求完成事件更早
+     * @param {HeadersReceivedCallback} callback HTTP Response Header 事件的回调函数
+     */
     const onHeadersReceived = callbackManager.headersReceived.add;
+    /**
+     * 取消监听 HTTP Response Header 事件
+     * @param {HeadersReceivedCallback} callback HTTP Response Header 事件的回调函数
+     */
     const offHeadersReceived = callbackManager.headersReceived.remove;
+    /**
+     * 监听进度变化事件
+     * @param {ProgressUpdateCallback} callback HTTP Response Header 事件的回调函数
+     */
     const onProgressUpdate = callbackManager.progressUpdate.add;
+    /**
+     * 取消监听进度变化事件
+     * @param {ProgressUpdateCallback} callback HTTP Response Header 事件的回调函数
+     */
     const offProgressUpdate = callbackManager.progressUpdate.remove;
     const headersReceived = temporarilyNotSupport('UploadTask.headersReceived');
     const progress = temporarilyNotSupport('UploadTask.progress');
@@ -5952,6 +6251,9 @@ const createUploadTask = ({ url, filePath, formData, name, header, timeout, file
         progress
     };
 };
+/**
+ * 将本地资源上传到服务器。客户端发起一个 HTTPS POST 请求，其中 content-type 为 multipart/form-data。使用前请注意阅读相关说明。
+ */
 const uploadFile = ({ url, filePath, name, header, formData, timeout, fileName, success, fail, complete }) => {
     let task;
     const result = new Promise((resolve, reject) => {
@@ -6019,6 +6321,7 @@ class SocketTask {
             opts = {};
         const { code = 1000, reason = 'server complete,close', success, complete } = opts;
         this.closeDetail = { code, reason };
+        // 主动断开时需要重置链接数
         this._destroyWhenClose && this._destroyWhenClose();
         this.ws.close();
         const res = { errMsg: 'closeSocket:ok' };
@@ -6034,6 +6337,7 @@ class SocketTask {
     }
     onClose(func) {
         this.ws.onclose = () => {
+            // 若服务器方断掉也需要重置链接数
             this._destroyWhenClose && this._destroyWhenClose();
             func(this.closeDetail || { code: 1006, reason: 'abnormal closure' });
         };
@@ -6063,6 +6367,7 @@ function onSocketClose() {
 function connectSocket(options) {
     const name = 'connectSocket';
     return new Promise((resolve, reject) => {
+        // options must be an Object
         const isObject = shouldBeObject(options);
         if (!isObject.flag) {
             const res = { errMsg: `${name}:fail ${isObject.msg}` };
@@ -6071,6 +6376,7 @@ function connectSocket(options) {
         }
         const { url, protocols, success, fail, complete } = options;
         const handle = new MethodHandler({ name, success, fail, complete });
+        // options.url must be String
         if (typeof url !== 'string') {
             return handle.fail({
                 errMsg: getParameterError({
@@ -6080,12 +6386,15 @@ function connectSocket(options) {
                 })
             }, reject);
         }
+        // options.url must be invalid
         if (!url.startsWith('ws://') && !url.startsWith('wss://')) {
             return handle.fail({
                 errMsg: `request:fail invalid url "${url}"`
             }, reject);
         }
+        // protocols must be array
         const _protocols = Array.isArray(protocols) ? protocols : null;
+        // 2 connection at most
         if (socketTasks.length > 1) {
             return handle.fail({
                 errMsg: '同时最多发起 2 个 socket 请求，更多请参考文档。'
@@ -6106,16 +6415,21 @@ function closeSocket() {
     console.warn('Deprecated.Please use socketTask.close instead.');
 }
 
+// 帐号信息
 const getAccountInfoSync = temporarilyNotSupport('getAccountInfoSync');
 
+// 收货地址
 const chooseAddress = temporarilyNotSupport('chooseAddress');
 
+// 授权
 const authorizeForMiniProgram = temporarilyNotSupport('authorizeForMiniProgram');
 const authorize = temporarilyNotSupport('authorize');
 
+// 卡券
 const openCard = temporarilyNotSupport('openCard');
 const addCard = temporarilyNotSupport('addCard');
 
+// 视频号
 const reserveChannelsLive = temporarilyNotSupport('reserveChannelsLive');
 const openChannelsLive = temporarilyNotSupport('openChannelsLive');
 const openChannelsEvent = temporarilyNotSupport('openChannelsEvent');
@@ -6123,47 +6437,65 @@ const openChannelsActivity = temporarilyNotSupport('openChannelsActivity');
 const getChannelsLiveNoticeInfo = temporarilyNotSupport('getChannelsLiveNoticeInfo');
 const getChannelsLiveInfo = temporarilyNotSupport('getChannelsLiveInfo');
 
+// 微信客服
 const openCustomerServiceChat = temporarilyNotSupport('openCustomerServiceChat');
 
+// 过往接口
 const checkIsSupportFacialRecognition = temporarilyNotSupport('checkIsSupportFacialRecognition');
 const startFacialRecognitionVerify = temporarilyNotSupport('startFacialRecognitionVerify');
 const startFacialRecognitionVerifyAndUploadVideo = temporarilyNotSupport('startFacialRecognitionVerifyAndUploadVideo');
 const faceVerifyForPay = temporarilyNotSupport('faceVerifyForPay');
 
+// 收藏
 const addVideoToFavorites = temporarilyNotSupport('addVideoToFavorites');
 const addFileToFavorites = temporarilyNotSupport('addFileToFavorites');
 
+// 微信群
 const getGroupEnterInfo = temporarilyNotSupport('getGroupEnterInfo');
 
+// 发票
 const chooseInvoiceTitle = temporarilyNotSupport('chooseInvoiceTitle');
 const chooseInvoice = temporarilyNotSupport('chooseInvoice');
 
+// 车牌
 const chooseLicensePlate = temporarilyNotSupport('chooseLicensePlate');
 
+// 帐号信息
 const pluginLogin = temporarilyNotSupport('pluginLogin');
 const login = temporarilyNotSupport('login');
 const checkSession = temporarilyNotSupport('checkSession');
 
+// 微信红包
 const showRedPackage = temporarilyNotSupport('showRedPackage');
 
+// 设置
 const openSetting = temporarilyNotSupport('openSetting');
 const getSetting = temporarilyNotSupport('getSetting');
 
+// 生物认证
 const startSoterAuthentication = temporarilyNotSupport('startSoterAuthentication');
 const checkIsSupportSoterAuthentication = temporarilyNotSupport('checkIsSupportSoterAuthentication');
 const checkIsSoterEnrolledInDevice = temporarilyNotSupport('checkIsSoterEnrolledInDevice');
 
+// 订阅消息
 const requestSubscribeMessage = temporarilyNotSupport('requestSubscribeMessage');
 
+// 用户信息
 const getUserProfile = temporarilyNotSupport('getUserProfile');
 const getUserInfo = temporarilyNotSupport('getUserInfo');
 
+// 微信运动
 const shareToWeRun = temporarilyNotSupport('shareToWeRun');
 const getWeRunData = temporarilyNotSupport('getWeRunData');
 
+// 支付
 const requestPayment = temporarilyNotSupport('requestPayment');
 const requestOrderPayment = temporarilyNotSupport('requestOrderPayment');
 
+// 路由
+// FIXME 方法导出类型未对齐，后续修复
+
+// 转发
 const updateShareMenu = temporarilyNotSupport('updateShareMenu');
 const showShareMenu = temporarilyNotSupport('showShareMenu');
 const showShareImageMenu = temporarilyNotSupport('showShareImageMenu');
@@ -6175,6 +6507,10 @@ const hideShareMenu = temporarilyNotSupport('hideShareMenu');
 const getShareInfo = temporarilyNotSupport('getShareInfo');
 const authPrivateMessage = temporarilyNotSupport('authPrivateMessage');
 
+/**
+ * H5 下的 styleSheet 操作
+ * @author leeenx
+ */
 class StyleSheet {
     constructor() {
         this.appendStyleSheet = () => {
@@ -6187,9 +6523,11 @@ class StyleSheet {
                 console.warn('当前浏览器不支持 stylesheet.insertRule 接口');
             }
         };
+        // 添加样式命令
         this.add = (cssText, index = 0) => {
             var _a;
             if (this.sheet === null) {
+                // $style 未插入到 DOM
                 this.appendStyleSheet();
             }
             (_a = this.sheet) === null || _a === void 0 ? void 0 : _a.insertRule(cssText, index);
@@ -6198,55 +6536,73 @@ class StyleSheet {
     }
 }
 const styleSheet = new StyleSheet();
+// 监听事件
 let TRANSITION_END = 'transitionend';
 let TRANSFORM = 'transform';
 const $detect = document.createElement('div');
 $detect.style.cssText = '-webkit-animation-name:webkit;-moz-animation-name:moz;-ms-animation-name:ms;animation-name:standard;';
 if ($detect.style['animation-name'] === 'standard') {
+    // 支持标准写法
     TRANSITION_END = 'transitionend';
     TRANSFORM = 'transform';
 }
 else if ($detect.style['-webkit-animation-name'] === 'webkit') {
+    // webkit 前缀
     TRANSITION_END = 'webkitTransitionEnd';
     TRANSFORM = '-webkit-transform';
 }
 else if ($detect.style['-moz-animation-name'] === 'moz') {
+    // moz 前缀
     TRANSITION_END = 'mozTransitionEnd';
     TRANSFORM = '-moz-transform';
 }
 else if ($detect.style['-ms-animation-name'] === 'ms') {
+    // ms 前缀
     TRANSITION_END = 'msTransitionEnd';
     TRANSFORM = '-ms-transform';
 }
 let animId = 0;
 class Animation {
     constructor({ duration = 400, delay = 0, timingFunction = 'linear', transformOrigin = '50% 50% 0', unit = 'px' } = {}) {
+        // 属性组合
         this.rules = [];
+        // transform 对象
         this.transform = [`${TRANSFORM}:`];
+        // 组合动画
         this.steps = [];
+        // 动画 map ----- 永久保留
         this.animationMap = {};
+        // animationMap 的长度
         this.animationMapCount = 0;
+        // 默认值
         this.setDefault(duration, delay, timingFunction, transformOrigin);
         this.unit = unit;
+        // atom 环境下，animation 属性不会显示，所以要改成 data-animation
         let animAttr = 'animation';
+        // 动画 id
         this.id = ++animId;
+        // 监听事件
         document.body.addEventListener(TRANSITION_END, (e) => {
             const target = e.target;
             if (target.getAttribute(animAttr) === null) {
                 animAttr = 'data-animation';
             }
             const animData = target.getAttribute(animAttr);
+            // 没有动画存在
             if (animData === null)
                 return;
             const [animName, animPath] = animData.split('__');
             if (animName === `taro-h5-poly-fill/${this.id}/create-animation`) {
                 const [animIndex, __stepIndex = 0] = animPath.split('--');
                 const stepIndex = Number(__stepIndex);
+                // 动画总的关键帧
                 const animStepsCount = this.animationMap[`${animName}__${animIndex}`];
                 const animStepsMaxIndex = animStepsCount - 1;
                 if (stepIndex < animStepsMaxIndex) {
+                    // 播放下一个关键帧（因为 nerv 和 react 有差异所以 animation & data-animation 都需要写）
                     target.setAttribute(animAttr, `${animName}__${animIndex}--${stepIndex + 1}`);
                     if (animAttr === 'animation') {
+                        // Nerv 环境，animation & data-animation 双重保险
                         target.setAttribute('data-animation', `${animName}__${animIndex}--${stepIndex + 1}`);
                     }
                 }
@@ -6260,6 +6616,7 @@ class Animation {
         });
         return ret;
     }
+    // 设置默认值
     setDefault(duration, delay, timingFunction, transformOrigin) {
         this.DEFAULT = { duration, delay, timingFunction, transformOrigin };
     }
@@ -6391,9 +6748,11 @@ class Animation {
         this.rules.push(`left: ${value}`);
         return this;
     }
+    // 关键帧载入
     step(arg = {}) {
         const { DEFAULT } = this;
         const { duration = DEFAULT.duration, delay = DEFAULT.delay, timingFunction = DEFAULT.timingFunction, transformOrigin = DEFAULT.transformOrigin } = arg;
+        // 生成一条 transition 动画
         this.steps.push([
             this.rules.map(rule => `${rule}!important`).join(';'),
             `${this.transform.join(' ')}!important`,
@@ -6402,41 +6761,54 @@ class Animation {
         ]
             .filter(item => item !== '' && item !== `${TRANSFORM}:`)
             .join(';'));
+        // 清空 rules 和 transform
         this.rules = [];
         this.transform = [`${TRANSFORM}:`];
         return this;
     }
+    // 创建底层数据
     createAnimationData() {
         const animIndex = `taro-h5-poly-fill/${this.id}/create-animation__${this.animationMapCount++}`;
+        // 记录动画分几个 step
         this.animationMap[animIndex] = this.steps.length;
+        // 吐出 step
         this.steps.forEach((step, index) => {
             const selector = index === 0
                 ? `[animation="${animIndex}"], [data-animation="${animIndex}"]`
                 : `[animation="${animIndex}--${index}"], [data-animation="${animIndex}--${index}"]`;
             styleSheet.add(`${selector} { ${step} }`);
         });
+        // 清空 steps
         this.steps = [];
         return animIndex;
     }
+    // 动画数据产出
     export() {
         return this.createAnimationData();
     }
 }
+// h5 的 createAnimation
 const createAnimation = (option) => {
     return new Animation(option);
 };
 
+// 背景
 const setBackgroundTextStyle = temporarilyNotSupport('setBackgroundTextStyle');
 const setBackgroundColor = temporarilyNotSupport('setBackgroundColor');
 
-const nextTick = Taro.nextTick;
+// 自定义组件
+const nextTick = Taro__default['default'].nextTick;
 
+// 字体
 const loadFontFace = temporarilyNotSupport('loadFontFace');
 
+// 菜单
 const getMenuButtonBoundingClientRect = temporarilyNotSupport('getMenuButtonBoundingClientRect');
 
+// 导航栏
 const showNavigationBarLoading = temporarilyNotSupport('showNavigationBarLoading');
 function setNavigationBarTitle(options) {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `setNavigationBarTitle:fail ${isObject.msg}` };
@@ -6459,6 +6831,9 @@ function setNavigationBarTitle(options) {
     }
     return handle.success();
 }
+/**
+ * 设置页面导航条颜色
+ */
 const setNavigationBarColor = (options) => {
     const { backgroundColor, success, fail, complete } = options;
     const handle = new MethodHandler({ name: 'setNavigationBarColor', success, fail, complete });
@@ -6471,19 +6846,25 @@ const setNavigationBarColor = (options) => {
 const hideNavigationBarLoading = temporarilyNotSupport('hideNavigationBarLoading');
 const hideHomeButton = temporarilyNotSupport('hideHomeButton');
 
+/**
+ * 开始下拉刷新。调用后触发下拉刷新动画，效果与用户手动下拉刷新一致。
+ */
 const startPullDownRefresh = function ({ success, fail, complete } = {}) {
     const handle = new MethodHandler({ name: 'startPullDownRefresh', success, fail, complete });
     return new Promise((resolve, reject) => {
-        Taro.eventCenter.trigger('__taroStartPullDownRefresh', {
+        Taro__default['default'].eventCenter.trigger('__taroStartPullDownRefresh', {
             successHandler: (res = {}) => handle.success(res, resolve),
             errorHandler: (res = {}) => handle.fail(res, reject)
         });
     });
 };
+/**
+ * 停止当前页面下拉刷新。
+ */
 const stopPullDownRefresh = function ({ success, fail, complete } = {}) {
     const handle = new MethodHandler({ name: 'stopPullDownRefresh', success, fail, complete });
     return new Promise((resolve, reject) => {
-        Taro.eventCenter.trigger('__taroStopPullDownRefresh', {
+        Taro__default['default'].eventCenter.trigger('__taroStopPullDownRefresh', {
             successHandler: (res = {}) => handle.success(res, resolve),
             errorHandler: (res = {}) => handle.fail(res, reject)
         });
@@ -6492,6 +6873,9 @@ const stopPullDownRefresh = function ({ success, fail, complete } = {}) {
 
 let timer;
 const FRAME_DURATION = 17;
+/**
+ * 将页面滚动到目标位置
+ */
 const pageScrollTo = ({ scrollTop, selector = '', duration = 300, success, fail, complete }) => {
     let scrollFunc;
     const handle = new MethodHandler({ name: 'pageScrollTo', success, fail, complete });
@@ -6568,13 +6952,18 @@ const pageScrollTo = ({ scrollTop, selector = '', duration = 300, success, fail,
     });
 };
 
+// 置顶
 const setTopBarText = temporarilyNotSupport('setTopBarText');
 
 let tabConf;
 function initTabBarApis(config = {}) {
     tabConf = config.tabBar;
 }
+/**
+ * 显示 tabBar 某一项的右上角的红点
+ */
 const showTabBarRedDot = (options) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `showTabBarRedDot:fail ${isObject.msg}` };
@@ -6593,14 +6982,18 @@ const showTabBarRedDot = (options) => {
         });
     }
     return new Promise((resolve, reject) => {
-        Taro.eventCenter.trigger('__taroShowTabBarRedDotHandler', {
+        Taro__default['default'].eventCenter.trigger('__taroShowTabBarRedDotHandler', {
             index,
             successHandler: (res = {}) => handle.success(res, resolve),
             errorHandler: (res = {}) => handle.fail(res, reject)
         });
     });
 };
+/**
+ * 显示 tabBar
+ */
 const showTabBar = (options = {}) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `showTabBar:fail ${isObject.msg}` };
@@ -6619,14 +7012,18 @@ const showTabBar = (options = {}) => {
         });
     }
     return new Promise((resolve, reject) => {
-        Taro.eventCenter.trigger('__taroShowTabBar', {
+        Taro__default['default'].eventCenter.trigger('__taroShowTabBar', {
             animation,
             successHandler: (res = {}) => handle.success(res, resolve),
             errorHandler: (res = {}) => handle.fail(res, reject)
         });
     });
 };
+/**
+ * 动态设置 tabBar 的整体样式
+ */
 const setTabBarStyle = (options = {}) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `setTabBarStyle:fail ${isObject.msg}` };
@@ -6664,7 +7061,7 @@ const setTabBarStyle = (options = {}) => {
     if (borderStyle)
         obj.borderStyle = borderStyle;
     return new Promise((resolve, reject) => {
-        Taro.eventCenter.trigger('__taroSetTabBarStyle', {
+        Taro__default['default'].eventCenter.trigger('__taroSetTabBarStyle', {
             color,
             selectedColor,
             backgroundColor,
@@ -6674,7 +7071,11 @@ const setTabBarStyle = (options = {}) => {
         });
     });
 };
+/**
+ * 动态设置 tabBar 某一项的内容
+ */
 const setTabBarItem = (options) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `setTabBarItem:fail ${isObject.msg}` };
@@ -6693,7 +7094,7 @@ const setTabBarItem = (options) => {
         });
     }
     return new Promise((resolve, reject) => {
-        Taro.eventCenter.trigger('__taroSetTabBarItem', {
+        Taro__default['default'].eventCenter.trigger('__taroSetTabBarItem', {
             index,
             text,
             iconPath,
@@ -6703,7 +7104,11 @@ const setTabBarItem = (options) => {
         });
     });
 };
+/**
+ * 为 tabBar 某一项的右上角添加文本
+ */
 const setTabBarBadge = (options) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `setTabBarBadge:fail ${isObject.msg}` };
@@ -6731,7 +7136,7 @@ const setTabBarBadge = (options) => {
         });
     }
     return new Promise((resolve, reject) => {
-        Taro.eventCenter.trigger('__taroSetTabBarBadge', {
+        Taro__default['default'].eventCenter.trigger('__taroSetTabBarBadge', {
             index,
             text,
             successHandler: (res = {}) => handle.success(res, resolve),
@@ -6739,7 +7144,11 @@ const setTabBarBadge = (options) => {
         });
     });
 };
+/**
+ * 移除 tabBar 某一项右上角的文本
+ */
 const removeTabBarBadge = (options) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `removeTabBarBadge:fail ${isObject.msg}` };
@@ -6758,14 +7167,18 @@ const removeTabBarBadge = (options) => {
         });
     }
     return new Promise((resolve, reject) => {
-        Taro.eventCenter.trigger('__taroRemoveTabBarBadge', {
+        Taro__default['default'].eventCenter.trigger('__taroRemoveTabBarBadge', {
             index,
             successHandler: (res = {}) => handle.success(res, resolve),
             errorHandler: (res = {}) => handle.fail(res, reject)
         });
     });
 };
+/**
+ * 隐藏 tabBar 某一项的右上角的红点
+ */
 const hideTabBarRedDot = (options) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `hideTabBarRedDot:fail ${isObject.msg}` };
@@ -6784,14 +7197,18 @@ const hideTabBarRedDot = (options) => {
         });
     }
     return new Promise((resolve, reject) => {
-        Taro.eventCenter.trigger('__taroHideTabBarRedDotHandler', {
+        Taro__default['default'].eventCenter.trigger('__taroHideTabBarRedDotHandler', {
             index,
             successHandler: (res = {}) => handle.success(res, resolve),
             errorHandler: (res = {}) => handle.fail(res, reject)
         });
     });
 };
+/**
+ * 隐藏 tabBar
+ */
 const hideTabBar = (options = {}) => {
+    // options must be an Object
     const isObject = shouldBeObject(options);
     if (!isObject.flag) {
         const res = { errMsg: `hideTabBar:fail ${isObject.msg}` };
@@ -6810,7 +7227,7 @@ const hideTabBar = (options = {}) => {
         });
     }
     return new Promise((resolve, reject) => {
-        Taro.eventCenter.trigger('__taroHideTabBar', {
+        Taro__default['default'].eventCenter.trigger('__taroHideTabBar', {
             animation,
             successHandler: (res = {}) => handle.success(res, resolve),
             errorHandler: (res = {}) => handle.fail(res, reject)
@@ -6818,23 +7235,32 @@ const hideTabBar = (options = {}) => {
     });
 };
 
-const callbackManager$3 = new CallbackManager();
+const callbackManager = new CallbackManager();
 const resizeListener = () => {
-    callbackManager$3.trigger({
+    callbackManager.trigger({
         windowWidth: window.screen.width,
         windowHeight: window.screen.height
     });
 };
+/**
+ * 设置窗口大小，该接口仅适用于 PC 平台，使用细则请参见指南
+ */
 const setWindowSize = temporarilyNotSupport('setWindowSize');
+/**
+ * 监听窗口尺寸变化事件
+ */
 const onWindowResize = callback => {
-    callbackManager$3.add(callback);
-    if (callbackManager$3.count() === 1) {
+    callbackManager.add(callback);
+    if (callbackManager.count() === 1) {
         window.addEventListener('resize', resizeListener);
     }
 };
+/**
+ * 取消监听窗口尺寸变化事件
+ */
 const offWindowResize = callback => {
-    callbackManager$3.remove(callback);
-    if (callbackManager$3.count() === 0) {
+    callbackManager.remove(callback);
+    if (callbackManager.count() === 0) {
         window.removeEventListener('resize', resizeListener);
     }
 };
@@ -6915,19 +7341,24 @@ class Toast {
         };
     }
     create(options = {}, _type = 'toast') {
+        // style
         const { maskStyle, toastStyle, successStyle, errrorStyle, loadingStyle, imageStyle, textStyle } = this.style;
+        // configuration
         const config = {
             ...this.options,
             ...options,
             _type
         };
+        // wrapper
         this.el = document.createElement('div');
         this.el.className = 'taro__toast';
         this.el.style.opacity = '0';
         this.el.style.transition = 'opacity 0.1s linear';
+        // mask
         this.mask = document.createElement('div');
         this.mask.setAttribute('style', inlineStyle(maskStyle));
         this.mask.style.display = config.mask ? 'block' : 'none';
+        // icon
         this.icon = document.createElement('p');
         if (config.image) {
             this.icon.setAttribute('style', inlineStyle({
@@ -6942,6 +7373,7 @@ class Toast {
                 ...(config.icon === 'none' ? { display: 'none' } : {})
             }));
         }
+        // toast
         this.toast = document.createElement('div');
         this.toast.setAttribute('style', inlineStyle({
             ...toastStyle,
@@ -6950,16 +7382,20 @@ class Toast {
                 padding: '10px 15px'
             } : {})
         }));
+        // title
         this.title = document.createElement('p');
         this.title.setAttribute('style', inlineStyle(textStyle));
         this.title.textContent = config.title;
+        // result
         this.toast.appendChild(this.icon);
         this.toast.appendChild(this.title);
         this.el.appendChild(this.mask);
         this.el.appendChild(this.toast);
+        // show immediately
         document.body.appendChild(this.el);
         setTimeout(() => { this.el.style.opacity = '1'; }, 0);
         this.type = config._type;
+        // disappear after duration
         config.duration >= 0 && this.hide(config.duration, this.type);
         return '';
     }
@@ -6973,8 +7409,11 @@ class Toast {
             clearTimeout(this.hideOpacityTimer);
         if (this.hideDisplayTimer)
             clearTimeout(this.hideDisplayTimer);
+        // title
         this.title.textContent = config.title || '';
+        // mask
         this.mask.style.display = config.mask ? 'block' : 'none';
+        // image
         const { toastStyle, successStyle, errrorStyle, loadingStyle, imageStyle } = this.style;
         if (config.image) {
             this.icon.setAttribute('style', inlineStyle({
@@ -6991,6 +7430,7 @@ class Toast {
                 }));
             }
         }
+        // toast
         this.toast.setAttribute('style', inlineStyle({
             ...toastStyle,
             ...(config.icon === 'none' ? {
@@ -6998,9 +7438,11 @@ class Toast {
                 padding: '10px 15px'
             } : {})
         }));
+        // show
         this.el.style.display = 'block';
         setTimeout(() => { this.el.style.opacity = '1'; }, 0);
         this.type = config._type;
+        // disappear after duration
         config.duration >= 0 && this.hide(config.duration, this.type);
         return '';
     }
@@ -7080,21 +7522,27 @@ class Modal {
     }
     create(options = {}) {
         return new Promise((resolve) => {
+            // style
             const { maskStyle, modalStyle, titleStyle, textStyle, footStyle, btnStyle } = this.style;
+            // configuration
             const config = {
                 ...this.options,
                 ...options
             };
+            // wrapper
             this.el = document.createElement('div');
             this.el.className = 'taro__modal';
             this.el.style.opacity = '0';
             this.el.style.transition = 'opacity 0.2s linear';
+            // mask
             const mask = document.createElement('div');
             mask.className = 'taro-modal__mask';
             mask.setAttribute('style', inlineStyle(maskStyle));
+            // modal
             const modal = document.createElement('div');
             modal.className = 'taro-modal__content';
             modal.setAttribute('style', inlineStyle(modalStyle));
+            // title
             const titleCSS = config.title ? titleStyle : {
                 ...titleStyle,
                 display: 'none'
@@ -7103,6 +7551,7 @@ class Modal {
             this.title.className = 'taro-modal__title';
             this.title.setAttribute('style', inlineStyle(titleCSS));
             this.title.textContent = config.title;
+            // text
             const textCSS = config.title ? textStyle : {
                 ...textStyle,
                 padding: '40px 20px 26px',
@@ -7112,9 +7561,11 @@ class Modal {
             this.text.className = 'taro-modal__text';
             this.text.setAttribute('style', inlineStyle(textCSS));
             this.text.textContent = config.content;
+            // foot
             const foot = document.createElement('div');
             foot.className = 'taro-modal__foot';
             foot.setAttribute('style', inlineStyle(footStyle));
+            // cancel button
             const cancelCSS = {
                 ...btnStyle,
                 color: config.cancelColor,
@@ -7128,6 +7579,7 @@ class Modal {
                 this.hide();
                 resolve('cancel');
             };
+            // confirm button
             this.confirm = document.createElement('div');
             this.confirm.className = 'taro-model__btn taro-model__confirm';
             this.confirm.setAttribute('style', inlineStyle(btnStyle));
@@ -7137,6 +7589,7 @@ class Modal {
                 this.hide();
                 resolve('confirm');
             };
+            // result
             foot.appendChild(this.cancel);
             foot.appendChild(this.confirm);
             modal.appendChild(this.title);
@@ -7144,6 +7597,7 @@ class Modal {
             modal.appendChild(foot);
             this.el.appendChild(mask);
             this.el.appendChild(modal);
+            // show immediately
             document.body.appendChild(this.el);
             setTimeout(() => { this.el.style.opacity = '1'; }, 0);
         });
@@ -7158,13 +7612,16 @@ class Modal {
                 clearTimeout(this.hideOpacityTimer);
             if (this.hideDisplayTimer)
                 clearTimeout(this.hideDisplayTimer);
+            // title & text
             const { textStyle } = this.style;
             if (config.title) {
                 this.title.textContent = config.title;
+                // none => block
                 this.title.style.display = 'block';
                 this.text.setAttribute('style', inlineStyle(textStyle));
             }
             else {
+                // block => none
                 this.title.style.display = 'none';
                 const textCSS = {
                     ...textStyle,
@@ -7174,11 +7631,17 @@ class Modal {
                 this.text.setAttribute('style', inlineStyle(textCSS));
             }
             this.text.textContent = config.content || '';
+            // showCancel
             this.cancel.style.display = config.showCancel ? 'block' : 'none';
+            // cancelText
             this.cancel.textContent = config.cancelText || '';
+            // cancelColor
             this.cancel.style.color = config.cancelColor || '';
+            // confirmText
             this.confirm.textContent = config.confirmText || '';
+            // confirmColor
             this.confirm.style.color = config.confirmColor || '';
+            // cbs
             this.cancel.onclick = () => {
                 this.hide();
                 resolve('cancel');
@@ -7187,6 +7650,7 @@ class Modal {
                 this.hide();
                 resolve('confirm');
             };
+            // show
             this.el.style.display = 'block';
             setTimeout(() => { this.el.style.opacity = '1'; }, 0);
         });
@@ -7203,15 +7667,15 @@ class Modal {
     }
 }
 
-const noop$1 = function () { };
+const noop = function () { };
 class ActionSheet {
     constructor() {
         this.options = {
             itemList: [],
             itemColor: '#000000',
-            success: noop$1,
-            fail: noop$1,
-            complete: noop$1
+            success: noop,
+            fail: noop,
+            complete: noop
         };
         this.style = {
             maskStyle: {
@@ -7258,25 +7722,32 @@ class ActionSheet {
     }
     create(options = {}) {
         return new Promise((resolve) => {
+            // style
             const { maskStyle, actionSheetStyle, menuStyle, cellStyle, cancelStyle } = this.style;
+            // configuration
             const config = {
                 ...this.options,
                 ...options
             };
             this.lastConfig = config;
+            // wrapper
             this.el = document.createElement('div');
             this.el.className = 'taro__actionSheet';
             this.el.style.opacity = '0';
             this.el.style.transition = 'opacity 0.2s linear';
+            // mask
             const mask = document.createElement('div');
             mask.setAttribute('style', inlineStyle(maskStyle));
+            // actionSheet
             this.actionSheet = document.createElement('div');
             this.actionSheet.setAttribute('style', inlineStyle(actionSheetStyle));
+            // menu
             this.menu = document.createElement('div');
             this.menu.setAttribute('style', inlineStyle({
                 ...menuStyle,
                 color: config.itemColor
             }));
+            // cells
             this.cells = config.itemList.map((item, index) => {
                 const cell = document.createElement('div');
                 cell.className = 'taro-actionsheet__cell';
@@ -7291,20 +7762,24 @@ class ActionSheet {
                 };
                 return cell;
             });
+            // cancel
             this.cancel = document.createElement('div');
             this.cancel.setAttribute('style', inlineStyle(cancelStyle));
             this.cancel.textContent = '取消';
+            // result
             this.cells.forEach(item => this.menu.appendChild(item));
             this.actionSheet.appendChild(this.menu);
             this.actionSheet.appendChild(this.cancel);
             this.el.appendChild(mask);
             this.el.appendChild(this.actionSheet);
+            // callbacks
             const cb = () => {
                 this.hide();
                 resolve('cancel');
             };
             mask.onclick = cb;
             this.cancel.onclick = cb;
+            // show immediately
             document.body.appendChild(this.el);
             setTimeout(() => {
                 this.el.style.opacity = '1';
@@ -7323,15 +7798,19 @@ class ActionSheet {
                 clearTimeout(this.hideOpacityTimer);
             if (this.hideDisplayTimer)
                 clearTimeout(this.hideDisplayTimer);
+            // itemColor
             if (config.itemColor)
                 this.menu.style.color = config.itemColor;
+            // cells
             const { cellStyle } = this.style;
             config.itemList.forEach((item, index) => {
                 let cell;
                 if (this.cells[index]) {
+                    // assign new content
                     cell = this.cells[index];
                 }
                 else {
+                    // create new cell
                     cell = document.createElement('div');
                     cell.className = 'taro-actionsheet__cell';
                     cell.setAttribute('style', inlineStyle(cellStyle));
@@ -7355,6 +7834,7 @@ class ActionSheet {
                 }
                 this.cells.splice(itemListLen);
             }
+            // show
             this.el.style.display = 'block';
             setTimeout(() => {
                 this.el.style.opacity = '1';
@@ -7375,7 +7855,9 @@ class ActionSheet {
     }
 }
 
+// 交互
 let status = 'default';
+// inject necessary style
 function init(doc) {
     if (status === 'ready')
         return;
@@ -7553,14 +8035,16 @@ const showModal = async (options = {}) => {
         });
     }
     options.showCancel = !!options.showCancel;
-    let errMsg = '';
+    let result = '';
     if (!modal.el) {
-        errMsg = await modal.create(options);
+        result = await modal.create(options);
     }
     else {
-        errMsg = await modal.show(options);
+        result = await modal.show(options);
     }
-    return handle.success({ errMsg });
+    const res = { cancel: !1, confirm: !1 };
+    res[result] = !0;
+    return handle.success(res);
 };
 function hideModal() {
     if (!modal.el)
@@ -7575,6 +8059,7 @@ const showActionSheet = async (options = { itemList: [] }) => {
     }, options);
     const { success, fail, complete } = options;
     const handle = new MethodHandler({ name: 'showActionSheet', success, fail, complete });
+    // list item String
     if (!Array.isArray(options.itemList)) {
         return handle.fail({
             errMsg: getParameterError({
@@ -7624,7 +8109,7 @@ const showActionSheet = async (options = { itemList: [] }) => {
         return handle.success(({ tapIndex: result }));
     }
 };
-Taro.eventCenter.on('__taroRouterChange', () => {
+Taro__default['default'].eventCenter.on('__taroRouterChange', () => {
     hideToast();
     hideLoading();
     hideModal();
@@ -7632,6 +8117,7 @@ Taro.eventCenter.on('__taroRouterChange', () => {
 const enableAlertBeforeUnload = temporarilyNotSupport('enableAlertBeforeUnload');
 const disableAlertBeforeUnload = temporarilyNotSupport('disableAlertBeforeUnload');
 
+// Worker
 const createWorker = temporarilyNotSupport('createWorker');
 
 class NodesRef {
@@ -7701,6 +8187,8 @@ function filter(fields, dom, selector) {
             }
         }
         else {
+            // TODO https://developers.weixin.qq.com/miniprogram/dev/component/scroll-view.html
+            // if (/^taro-scroll-view-core/i.test(tagName))
             res.nodeCanvasType = '';
             res.node = dom;
         }
@@ -7709,6 +8197,7 @@ function filter(fields, dom, selector) {
     if (context) {
         const tagName = dom.tagName;
         if (/^taro-video-core/i.test(tagName)) {
+            // TODO HTMLVideoElement to VideoContext
             return { context: dom };
         }
         else if (/^taro-canvas-core/i.test(tagName)) {
@@ -7780,14 +8269,22 @@ function filter(fields, dom, selector) {
     }
     return res;
 }
+/**
+ * WXML节点信息API
+ * @return {Object} SelectorQuery 对象实例
+ */
 function queryBat(queue, cb) {
     const result = [];
     queue.forEach(item => {
         var _a;
         const { selector, single, fields, component } = item;
+        // selector 的容器节点
+        /* eslint-disable */
         const container = (component !== null ?
             (findDOM(component) || document) :
             document);
+        /* eslint-enable */
+        // 特殊处理 ---- 选自己
         let selectSelf = false;
         if (container !== document) {
             const $nodeList = (_a = container.parentNode) === null || _a === void 0 ? void 0 : _a.querySelectorAll(selector);
@@ -7829,11 +8326,13 @@ class SelectorQuery {
         return this;
     }
     select(selector) {
+        // 小程序里跨自定义组件的后代选择器 '>>>' 在 h5 替换为普通后代选择器 '>'
         if (typeof selector === 'string')
             selector = selector.replace('>>>', '>');
         return new NodesRef(selector, this, true);
     }
     selectAll(selector) {
+        // 小程序里跨自定义组件的后代选择器 '>>>' 在 h5 替换为普通后代选择器 '>'
         if (typeof selector === 'string')
             selector = selector.replace('>>>', '>');
         return new NodesRef(selector, this, false);
@@ -7868,9 +8367,11 @@ const createSelectorQuery = () => {
 };
 const createIntersectionObserver = temporarilyNotSupport('createIntersectionObserver');
 
+// AliPay
 const getOpenUserInfo = temporarilyNotSupport('getOpenUserInfo');
 
 const setPageInfo = temporarilyNotSupport('setPageInfo');
+// 百度小程序 AI 相关
 const ocrIdCard = temporarilyNotSupport('ocrIdCard');
 const ocrBankCard = temporarilyNotSupport('ocrBankCard');
 const ocrDrivingLicense = temporarilyNotSupport('ocrDrivingLicense');
@@ -7885,19 +8386,23 @@ const dishClassify = temporarilyNotSupport('dishClassify');
 const logoClassify = temporarilyNotSupport('logoClassify');
 const animalClassify = temporarilyNotSupport('animalClassify');
 const plantClassify = temporarilyNotSupport('plantClassify');
+// 用户信息
 const getSwanId = temporarilyNotSupport('getSwanId');
+// 百度收银台支付
 const requestPolymerPayment = temporarilyNotSupport('requestPolymerPayment');
+// 打开小程序
 const navigateToSmartGameProgram = temporarilyNotSupport('navigateToSmartGameProgram');
 const navigateToSmartProgram = temporarilyNotSupport('navigateToSmartProgram');
 const navigateBackSmartProgram = temporarilyNotSupport('navigateBackSmartProgram');
 const preloadSubPackage = temporarilyNotSupport('preloadSubPackage');
 
-const { Behavior, getEnv, ENV_TYPE, Link: Link$1, interceptors, getInitPxTransform, Current, options, eventCenter, Events, preload, useDidShow, useDidHide, usePullDownRefresh, useReachBottom, usePageScroll, useResize, useShareAppMessage, useTabItemTap, useTitleClick, useOptionMenuClick, usePullIntercept, useShareTimeline, useAddToFavorites, useReady, useRouter } = Taro;
+const { Behavior, getEnv, ENV_TYPE, Link, interceptors, getInitPxTransform, Current, options, eventCenter, Events, preload } = Taro__default['default'];
 const taro = {
+    // @ts-ignore
     Behavior,
     getEnv,
     ENV_TYPE,
-    Link: Link$1,
+    Link,
     interceptors,
     Current,
     getCurrentInstance,
@@ -7913,26 +8418,12 @@ const taro = {
     reLaunch: router.reLaunch,
     redirectTo: router.redirectTo,
     getCurrentPages: router.getCurrentPages,
-    switchTab: router.switchTab,
-    useDidShow,
-    useDidHide,
-    usePullDownRefresh,
-    useReachBottom,
-    usePageScroll,
-    useResize,
-    useShareAppMessage,
-    useTabItemTap,
-    useTitleClick,
-    useOptionMenuClick,
-    usePullIntercept,
-    useShareTimeline,
-    useAddToFavorites,
-    useReady,
-    useRouter
+    switchTab: router.switchTab
 };
 const initPxTransform = getInitPxTransform(taro);
 const requirePlugin = permanentlyNotSupport('requirePlugin');
 const pxTransform = function (size) {
+    // @ts-ignore
     const { designWidth } = taro.config;
     return Math.ceil((((parseInt(size, 10) / 40) * 640) / designWidth) * 10000) / 10000 + 'rem';
 };
@@ -7944,6 +8435,7 @@ taro.requirePlugin = requirePlugin;
 taro.getApp = getApp;
 taro.pxTransform = pxTransform;
 taro.initPxTransform = initPxTransform;
+// @ts-ignore
 taro.canIUseWebp = canIUseWebp;
 
 Object.defineProperty(exports, 'createRouter', {
@@ -7999,7 +8491,7 @@ exports.Current = Current;
 exports.ENV_TYPE = ENV_TYPE;
 exports.EditorContext = EditorContext;
 exports.Events = Events;
-exports.Link = Link$1;
+exports.Link = Link;
 exports.addCard = addCard;
 exports.addFileToFavorites = addFileToFavorites;
 exports.addInterceptor = addInterceptor;
@@ -8072,7 +8564,7 @@ exports.createVideoContext = createVideoContext;
 exports.createVideoDecoder = createVideoDecoder;
 exports.createWebAudioContext = createWebAudioContext;
 exports.createWorker = createWorker;
-exports.default = taro;
+exports['default'] = taro;
 exports.disableAlertBeforeUnload = disableAlertBeforeUnload;
 exports.dishClassify = dishClassify;
 exports.downloadFile = downloadFile;
@@ -8388,21 +8880,6 @@ exports.updateShareMenu = updateShareMenu;
 exports.updateVoIPChatMuteConfig = updateVoIPChatMuteConfig;
 exports.updateWeChatApp = updateWeChatApp;
 exports.uploadFile = uploadFile;
-exports.useAddToFavorites = useAddToFavorites;
-exports.useDidHide = useDidHide;
-exports.useDidShow = useDidShow;
-exports.useOptionMenuClick = useOptionMenuClick;
-exports.usePageScroll = usePageScroll;
-exports.usePullDownRefresh = usePullDownRefresh;
-exports.usePullIntercept = usePullIntercept;
-exports.useReachBottom = useReachBottom;
-exports.useReady = useReady;
-exports.useResize = useResize;
-exports.useRouter = useRouter;
-exports.useShareAppMessage = useShareAppMessage;
-exports.useShareTimeline = useShareTimeline;
-exports.useTabItemTap = useTabItemTap;
-exports.useTitleClick = useTitleClick;
 exports.vibrateLong = vibrateLong;
 exports.vibrateShort = vibrateShort;
 exports.writeBLECharacteristicValue = writeBLECharacteristicValue;