@antv/l7-map 2.9.19 → 2.9.22-alpha.0

package/es/handler/IHandler.js

@@ -1,2 +1 @@
-export {};
-//# sourceMappingURL=IHandler.js.map
+export {};

package/es/handler/blockable_map_event.js

@@ -1,30 +1,26 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import { MapMouseEvent } from './events';
+// @ts-ignore
+import { MapMouseEvent } from "./events";
 
-var BlockableMapEventHandler = function () {
+var BlockableMapEventHandler = /*#__PURE__*/function () {
   function BlockableMapEventHandler(map) {
     _classCallCheck(this, BlockableMapEventHandler);
 
-    _defineProperty(this, "map", void 0);
-
-    _defineProperty(this, "delayContextMenu", void 0);
-
-    _defineProperty(this, "contextMenuEvent", void 0);
-
     this.map = map;
   }
 
   _createClass(BlockableMapEventHandler, [{
     key: "reset",
     value: function reset() {
-      this.delayContextMenu = false;
+      this.delayContextMenu = false; // @ts-ignore
+
       delete this.contextMenuEvent;
     }
   }, {
     key: "mousemove",
     value: function mousemove(e) {
+      // mousemove map events should not be fired when interaction handlers (pan, rotate, etc) are active
       this.map.emit(e.type, new MapMouseEvent(e.type, this.map, e));
     }
   }, {
@@ -38,7 +34,8 @@ var BlockableMapEventHandler = function () {
       this.delayContextMenu = false;
 
       if (this.contextMenuEvent) {
-        this.map.emit('contextmenu', new MapMouseEvent('contextmenu', this.map, this.contextMenuEvent));
+        this.map.emit('contextmenu', new MapMouseEvent('contextmenu', this.map, this.contextMenuEvent)); // @ts-ignore
+
         delete this.contextMenuEvent;
       }
     }
@@ -46,10 +43,13 @@ var BlockableMapEventHandler = function () {
     key: "contextmenu",
     value: function contextmenu(e) {
       if (this.delayContextMenu) {
+        // Mac: contextmenu fired on mousedown; we save it until mouseup for consistency's sake
         this.contextMenuEvent = e;
       } else {
+        // Windows: contextmenu fired on mouseup, so fire event now
         this.map.emit(e.type, new MapMouseEvent(e.type, this.map, e));
-      }
+      } // prevent browser context menu when necessary
+
 
       if (this.map.listeners('contextmenu')) {
         e.preventDefault();
@@ -80,5 +80,4 @@ var BlockableMapEventHandler = function () {
   return BlockableMapEventHandler;
 }();
 
-export { BlockableMapEventHandler as default };
-//# sourceMappingURL=blockable_map_event.js.map
+export { BlockableMapEventHandler as default };

package/es/handler/box_zoom.js

@@ -1,47 +1,55 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import DOM from '../utils/dom';
-import { Event } from './events/event';
-
-var BoxZoomHandler = function () {
+// @ts-ignore
+import DOM from "../utils/dom";
+import { Event } from "./events/event";
+/**
+ * The `BoxZoomHandler` allows the user to zoom the map to fit within a bounding box.
+ * The bounding box is defined by clicking and holding `shift` while dragging the cursor.
+ */
+
+var BoxZoomHandler = /*#__PURE__*/function () {
+  /**
+   * @private
+   */
   function BoxZoomHandler(map, options) {
     _classCallCheck(this, BoxZoomHandler);
 
-    _defineProperty(this, "map", void 0);
-
-    _defineProperty(this, "el", void 0);
-
-    _defineProperty(this, "container", void 0);
-
-    _defineProperty(this, "enabled", void 0);
-
-    _defineProperty(this, "active", void 0);
-
-    _defineProperty(this, "startPos", void 0);
-
-    _defineProperty(this, "lastPos", void 0);
-
-    _defineProperty(this, "box", void 0);
-
-    _defineProperty(this, "clickTolerance", void 0);
-
     this.map = map;
     this.el = map.getCanvasContainer();
     this.container = map.getContainer();
     this.clickTolerance = options.clickTolerance || 1;
   }
+  /**
+   * Returns a Boolean indicating whether the "box zoom" interaction is enabled.
+   *
+   * @returns {boolean} `true` if the "box zoom" interaction is enabled.
+   */
+
 
   _createClass(BoxZoomHandler, [{
     key: "isEnabled",
     value: function isEnabled() {
       return !!this.enabled;
     }
+    /**
+     * Returns a Boolean indicating whether the "box zoom" interaction is active, i.e. currently being used.
+     *
+     * @returns {boolean} `true` if the "box zoom" interaction is active.
+     */
+
   }, {
     key: "isActive",
     value: function isActive() {
       return !!this.active;
     }
+    /**
+     * Enables the "box zoom" interaction.
+     *
+     * @example
+     *   map.boxZoom.enable();
+     */
+
   }, {
     key: "enable",
     value: function enable() {
@@ -51,6 +59,13 @@ var BoxZoomHandler = function () {
 
       this.enabled = true;
     }
+    /**
+     * Disables the "box zoom" interaction.
+     *
+     * @example
+     *   map.boxZoom.disable();
+     */
+
   }, {
     key: "disable",
     value: function disable() {
@@ -164,8 +179,10 @@ var BoxZoomHandler = function () {
         this.box = null;
       }
 
-      DOM.enableDrag();
-      delete this.startPos;
+      DOM.enableDrag(); // @ts-ignore
+
+      delete this.startPos; // @ts-ignore
+
       delete this.lastPos;
     }
   }, {
@@ -180,5 +197,4 @@ var BoxZoomHandler = function () {
   return BoxZoomHandler;
 }();
 
-export default BoxZoomHandler;
-//# sourceMappingURL=box_zoom.js.map
+export default BoxZoomHandler;

package/es/handler/click_zoom.js

@@ -1,15 +1,11 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
 
-var ClickZoomHandler = function () {
+// @ts-ignore
+var ClickZoomHandler = /*#__PURE__*/function () {
   function ClickZoomHandler() {
     _classCallCheck(this, ClickZoomHandler);
 
-    _defineProperty(this, "enabled", void 0);
-
-    _defineProperty(this, "active", void 0);
-
     this.reset();
   }
 
@@ -60,5 +56,4 @@ var ClickZoomHandler = function () {
   return ClickZoomHandler;
 }();
 
-export { ClickZoomHandler as default };
-//# sourceMappingURL=click_zoom.js.map
+export { ClickZoomHandler as default };

package/es/handler/events/event.js

@@ -1,15 +1,12 @@
 import _createClass from "@babel/runtime/helpers/createClass";
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
+// tslint:disable-next-line:no-submodule-imports
 import merge from 'lodash/merge';
-export var Event = _createClass(function Event(type) {
+export var Event = /*#__PURE__*/_createClass(function Event(type) {
   var data = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
 
   _classCallCheck(this, Event);
 
-  _defineProperty(this, "type", void 0);
-
   merge(this, data);
   this.type = type;
-});
-//# sourceMappingURL=event.js.map
+});

package/es/handler/events/index.js

@@ -1,5 +1,4 @@
-import MapMouseEvent from './map_mouse_event';
-import MapTouchEvent from './map_touch_event';
-import MapWheelEvent from './map_wheel_event';
-export { MapMouseEvent, MapTouchEvent, MapWheelEvent };
-//# sourceMappingURL=index.js.map
+import MapMouseEvent from "./map_mouse_event";
+import MapTouchEvent from "./map_touch_event";
+import MapWheelEvent from "./map_wheel_event";
+export { MapMouseEvent, MapTouchEvent, MapWheelEvent };

package/es/handler/events/map_mouse_event.js

@@ -1,24 +1,48 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _assertThisInitialized from "@babel/runtime/helpers/assertThisInitialized";
 import _inherits from "@babel/runtime/helpers/inherits";
 import _possibleConstructorReturn from "@babel/runtime/helpers/possibleConstructorReturn";
 import _getPrototypeOf from "@babel/runtime/helpers/getPrototypeOf";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
 
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
 
 function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
 
+// @ts-ignore
+// tslint:disable-next-line:no-submodule-imports
 import merge from 'lodash/merge';
-import DOM from '../../utils/dom';
-import { Event } from './event';
+import DOM from "../../utils/dom";
+import { Event } from "./event";
 
-var MapMouseEvent = function (_Event) {
+var MapMouseEvent = /*#__PURE__*/function (_Event) {
   _inherits(MapMouseEvent, _Event);
 
   var _super = _createSuper(MapMouseEvent);
 
+  /**
+   * `true` if `preventDefault` has been called.
+   * @private
+   */
+
+  /**
+   * The `Map` object that fired the event.
+   */
+
+  /**
+   * The DOM event which caused the map event.
+   */
+
+  /**
+   * The pixel coordinates of the mouse cursor, relative to the map and measured from the top left corner.
+   */
+
+  /**
+   * The geographic location on the map of the mouse cursor.
+   */
+
+  /**
+   * @private
+   */
   function MapMouseEvent(type, map, originalEvent) {
     var _this;
 
@@ -33,19 +57,6 @@ var MapMouseEvent = function (_Event) {
       lngLat: lngLat,
       originalEvent: originalEvent
     }, data));
-
-    _defineProperty(_assertThisInitialized(_this), "type", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "target", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "originalEvent", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "point", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "lngLat", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "defaultPrevented", void 0);
-
     _this.defaultPrevented = false;
     _this.target = map;
     return _this;
@@ -61,5 +72,4 @@ var MapMouseEvent = function (_Event) {
   return MapMouseEvent;
 }(Event);
 
-export { MapMouseEvent as default };
-//# sourceMappingURL=map_mouse_event.js.map
+export { MapMouseEvent as default };

package/es/handler/events/map_touch_event.js

@@ -1,24 +1,62 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _assertThisInitialized from "@babel/runtime/helpers/assertThisInitialized";
 import _inherits from "@babel/runtime/helpers/inherits";
 import _possibleConstructorReturn from "@babel/runtime/helpers/possibleConstructorReturn";
 import _getPrototypeOf from "@babel/runtime/helpers/getPrototypeOf";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
 
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
 
 function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
 
-import Point from '../../geo/point';
-import DOM from '../../utils/dom';
-import { Event } from './event';
+// @ts-ignore
+import Point from "../../geo/point";
+import DOM from "../../utils/dom";
+import { Event } from "./event";
 
-var MapTouchEvent = function (_Event) {
+var MapTouchEvent = /*#__PURE__*/function (_Event) {
   _inherits(MapTouchEvent, _Event);
 
   var _super = _createSuper(MapTouchEvent);
 
+  /**
+   * The event type.
+   */
+
+  /**
+   * The `Map` object that fired the event.
+   */
+
+  /**
+   * The DOM event which caused the map event.
+   */
+
+  /**
+   * The geographic location on the map of the center of the touch event points.
+   */
+
+  /**
+   * The pixel coordinates of the center of the touch event points, relative to the map and measured from the top left
+   * corner.
+   */
+
+  /**
+   * The array of pixel coordinates corresponding to a
+   * [touch event's `touches`](https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/touches) property.
+   */
+
+  /**
+   * The geographical locations on the map corresponding to a
+   * [touch event's `touches`](https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/touches) property.
+   */
+
+  /**
+   * `true` if `preventDefault` has been called.
+   * @private
+   */
+
+  /**
+   * @private
+   */
   function MapTouchEvent(type, map, originalEvent) {
     var _this;
 
@@ -40,26 +78,19 @@ var MapTouchEvent = function (_Event) {
       lngLat: lngLat,
       originalEvent: originalEvent
     });
-
-    _defineProperty(_assertThisInitialized(_this), "type", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "target", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "originalEvent", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "lngLat", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "point", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "points", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "lngLats", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "defaultPrevented", void 0);
-
     _this.defaultPrevented = false;
     return _this;
   }
+  /**
+   * Prevents subsequent default processing of the event by the map.
+   *
+   * Calling this method will prevent the following default map behaviors:
+   *
+   *   * On `touchstart` events, the behavior of {@link DragPanHandler}
+   *   * On `touchstart` events, the behavior of {@link TouchZoomRotateHandler}
+   *
+   */
+
 
   _createClass(MapTouchEvent, [{
     key: "preventDefault",
@@ -71,5 +102,4 @@ var MapTouchEvent = function (_Event) {
   return MapTouchEvent;
 }(Event);
 
-export { MapTouchEvent as default };
-//# sourceMappingURL=map_touch_event.js.map
+export { MapTouchEvent as default };

package/es/handler/events/map_wheel_event.js

@@ -1,22 +1,35 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _assertThisInitialized from "@babel/runtime/helpers/assertThisInitialized";
 import _inherits from "@babel/runtime/helpers/inherits";
 import _possibleConstructorReturn from "@babel/runtime/helpers/possibleConstructorReturn";
 import _getPrototypeOf from "@babel/runtime/helpers/getPrototypeOf";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
 
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
 
 function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
 
-import { Event } from './event';
+import { Event } from "./event";
 
-var MapWheelEvent = function (_Event) {
+var MapWheelEvent = /*#__PURE__*/function (_Event) {
   _inherits(MapWheelEvent, _Event);
 
   var _super = _createSuper(MapWheelEvent);
 
+  /**
+   * The event type.
+   */
+
+  /**
+   * The DOM event which caused the map event.
+   */
+
+  /**
+   * The `Map` object that fired the event.
+   */
+
+  /**
+   * @private
+   */
   function MapWheelEvent(type, map, originalEvent) {
     var _this;
 
@@ -25,18 +38,15 @@ var MapWheelEvent = function (_Event) {
     _this = _super.call(this, type, {
       originalEvent: originalEvent
     });
-
-    _defineProperty(_assertThisInitialized(_this), "type", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "originalEvent", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "defaultPrevented", void 0);
-
-    _defineProperty(_assertThisInitialized(_this), "target", void 0);
-
     _this.defaultPrevented = false;
     return _this;
   }
+  /**
+   * Prevents subsequent default processing of the event by the map.
+   *
+   * Calling this method will prevent the the behavior of {@link ScrollZoomHandler}.
+   */
+
 
   _createClass(MapWheelEvent, [{
     key: "preventDefault",
@@ -48,5 +58,4 @@ var MapWheelEvent = function (_Event) {
   return MapWheelEvent;
 }(Event);
 
-export { MapWheelEvent as default };
-//# sourceMappingURL=map_wheel_event.js.map
+export { MapWheelEvent as default };

package/es/handler/events/render_event.js

@@ -10,9 +10,9 @@ function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflec
 
 function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
 
-import { Event } from './event';
+import { Event } from "./event";
 
-var RenderFrameEvent = function (_Event) {
+var RenderFrameEvent = /*#__PURE__*/function (_Event) {
   _inherits(RenderFrameEvent, _Event);
 
   var _super = _createSuper(RenderFrameEvent);
@@ -30,13 +30,10 @@ var RenderFrameEvent = function (_Event) {
 
     _defineProperty(_assertThisInitialized(_this), "type", 'renderFrame');
 
-    _defineProperty(_assertThisInitialized(_this), "timeStamp", void 0);
-
     return _this;
   }
 
   return _createClass(RenderFrameEvent);
 }(Event);
 
-export { RenderFrameEvent as default };
-//# sourceMappingURL=render_event.js.map
+export { RenderFrameEvent as default };

package/es/handler/handler_inertia.js

@@ -1,6 +1,5 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
 
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
 
@@ -8,9 +7,11 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
 
-import Point from '../geo/point';
+// @ts-ignore
+import Point from "../geo/point"; // tslint:disable-next-line:no-submodule-imports
+
 import merge from 'lodash/merge';
-import { bezier, clamp, now } from '../util';
+import { bezier, clamp, now } from "../util";
 var defaultInertiaOptions = {
   linearity: 0.3,
   easing: bezier(0, 0, 0.3, 1)
@@ -32,14 +33,10 @@ var defaultPitchInertiaOptions = merge({
   maxSpeed: 90
 }, defaultInertiaOptions);
 
-var HandlerInertia = function () {
+var HandlerInertia = /*#__PURE__*/function () {
   function HandlerInertia(map) {
     _classCallCheck(this, HandlerInertia);
 
-    _defineProperty(this, "map", void 0);
-
-    _defineProperty(this, "inertiaBuffer", void 0);
-
     this.map = map;
     this.clear();
   }
@@ -63,7 +60,7 @@ var HandlerInertia = function () {
     value: function drainInertiaBuffer() {
       var inertia = this.inertiaBuffer;
       var nowTime = now();
-      var cutoff = 160;
+      var cutoff = 160; // msec
 
       while (inertia.length > 0 && nowTime - inertia[0].time > cutoff) {
         inertia.shift();
@@ -160,7 +157,9 @@ var HandlerInertia = function () {
   }]);
 
   return HandlerInertia;
-}();
+}(); // Unfortunately zoom, bearing, etc can't have different durations and easings so
+// we need to choose one. We use the longest duration and it's corresponding easing.
+
 
 export { HandlerInertia as default };
 
@@ -182,5 +181,4 @@ function calculateEasing(amount, inertiaDuration, inertiaOptions) {
     duration: duration * 1000,
     amount: speed * (duration / 2)
   };
-}
-//# sourceMappingURL=handler_inertia.js.map
+}