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

package/es/handler/handler_manager.js

@@ -2,7 +2,6 @@ import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import _merge from "lodash/merge";
 
 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; } } }; }
 
@@ -10,26 +9,29 @@ 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; }
 
+// @ts-ignore
+// tslint:disable-next-line: no-submodule-imports
 import { $window, isMini } from '@antv/l7-utils';
-import Point from '../geo/point';
-import DOM from '../utils/dom';
-import BlockableMapEventHandler from './blockable_map_event';
-import BoxZoomHandler from './box_zoom';
-import ClickZoomHandler from './click_zoom';
-import { Event } from './events/event';
-import RenderFrameEvent from './events/render_event';
-import HandlerInertia from './handler_inertia';
-import KeyboardHandler from './keyboard';
-import MapEventHandler from './map_event';
-import { MousePanHandler, MousePitchHandler, MouseRotateHandler } from './mouse';
-import ScrollZoomHandler from './scroll_zoom';
-import DoubleClickZoomHandler from './shim/dblclick_zoom';
-import DragPanHandler from './shim/drag_pan';
-import DragRotateHandler from './shim/drag_rotate';
-import TouchZoomRotateHandler from './shim/touch_zoom_rotate';
-import TapDragZoomHandler from './tap/tap_drag_zoom';
-import TapZoomHandler from './tap/tap_zoom';
-import { TouchPanHandler, TouchPitchHandler, TouchRotateHandler, TouchZoomHandler } from './touch';
+import { merge } from 'lodash';
+import Point from "../geo/point";
+import DOM from "../utils/dom";
+import BlockableMapEventHandler from "./blockable_map_event";
+import BoxZoomHandler from "./box_zoom";
+import ClickZoomHandler from "./click_zoom";
+import { Event } from "./events/event";
+import RenderFrameEvent from "./events/render_event";
+import HandlerInertia from "./handler_inertia";
+import KeyboardHandler from "./keyboard";
+import MapEventHandler from "./map_event";
+import { MousePanHandler, MousePitchHandler, MouseRotateHandler } from "./mouse";
+import ScrollZoomHandler from "./scroll_zoom";
+import DoubleClickZoomHandler from "./shim/dblclick_zoom";
+import DragPanHandler from "./shim/drag_pan";
+import DragRotateHandler from "./shim/drag_rotate";
+import TouchZoomRotateHandler from "./shim/touch_zoom_rotate";
+import TapDragZoomHandler from "./tap/tap_drag_zoom";
+import TapZoomHandler from "./tap/tap_zoom";
+import { TouchPanHandler, TouchPitchHandler, TouchRotateHandler, TouchZoomHandler } from "./touch";
 
 var _isMoving = function isMoving(p) {
   return p.zoom || p.drag || p.pitch || p.rotate;
@@ -39,42 +41,12 @@ function hasChange(result) {
   return result.panDelta && result.panDelta.mag() || result.zoomDelta || result.bearingDelta || result.pitchDelta;
 }
 
-var HandlerManager = function () {
+var HandlerManager = /*#__PURE__*/function () {
   function HandlerManager(map, options) {
     var _this = this;
 
     _classCallCheck(this, HandlerManager);
 
-    _defineProperty(this, "map", void 0);
-
-    _defineProperty(this, "el", void 0);
-
-    _defineProperty(this, "handlers", void 0);
-
-    _defineProperty(this, "eventsInProgress", void 0);
-
-    _defineProperty(this, "frameId", void 0);
-
-    _defineProperty(this, "inertia", void 0);
-
-    _defineProperty(this, "bearingSnap", void 0);
-
-    _defineProperty(this, "handlersById", void 0);
-
-    _defineProperty(this, "updatingCamera", void 0);
-
-    _defineProperty(this, "changes", void 0);
-
-    _defineProperty(this, "previousActiveHandlers", void 0);
-
-    _defineProperty(this, "bearingChanged", void 0);
-
-    _defineProperty(this, "rotateEnabled", void 0);
-
-    _defineProperty(this, "pitchEnabled", void 0);
-
-    _defineProperty(this, "listeners", void 0);
-
     _defineProperty(this, "handleWindowEvent", function (e) {
       _this.handleEvent(e, "".concat(e.type, "Window"));
     });
@@ -88,12 +60,19 @@ var HandlerManager = function () {
 
       _this.updatingCamera = true;
       var inputEvent = e.type === 'renderFrame' ? undefined : e;
+      /*
+       * We don't call e.preventDefault() for any events by default.
+       * Handlers are responsible for calling it where necessary.
+       */
+
       var mergedIHandlerResult = {
         needsRenderFrame: false
       };
       var eventsInProgress = {};
-      var activeHandlers = {};
-      var mapTouches = e.touches ? _this.getMapTouches(e.touches) : undefined;
+      var activeHandlers = {}; // @ts-ignore
+
+      var mapTouches = e.touches ? // @ts-ignore
+      _this.getMapTouches(e.touches) : undefined;
       var points = mapTouches ? DOM.touchPos(_this.el, mapTouches) : DOM.mousePos(_this.el, e);
 
       var _iterator = _createForOfIteratorHelper(_this.handlers),
@@ -115,9 +94,10 @@ var HandlerManager = function () {
           if (_this.blockedByActive(activeHandlers, allowed, handlerName)) {
             handler.reset();
           } else {
-            var handerName = eventName || e.type;
+            var handerName = eventName || e.type; // @ts-ignore
 
             if (handler && handler[handerName]) {
+              // @ts-ignore
               data = handler[handerName](e, points, mapTouches);
 
               _this.mergeIHandlerResult(mergedIHandlerResult, eventsInProgress, data, handlerName, inputEvent);
@@ -126,7 +106,8 @@ var HandlerManager = function () {
                 _this.triggerRenderFrame();
               }
             }
-          }
+          } // @ts-ignore
+
 
           if (data || handler.isActive()) {
             activeHandlers[handlerName] = handler;
@@ -180,24 +161,39 @@ var HandlerManager = function () {
     this.bearingSnap = options.bearingSnap;
     this.rotateEnabled = options.rotateEnabled;
     this.pitchEnabled = options.pitchEnabled;
-    this.previousActiveHandlers = {};
+    this.previousActiveHandlers = {}; // Track whether map is currently moving, to compute start/move/end events
+
     this.eventsInProgress = {};
     this.addDefaultHandlers(options);
     var el = this.el;
     this.listeners = [];
 
     if (!isMini) {
-      this.listeners = [[el, 'touchstart', {
+      // l7 - mini
+      this.listeners = [// Bind touchstart and touchmove with passive: false because, even though
+      // they only fire a map events and therefore could theoretically be
+      // passive, binding with passive: true causes iOS not to respect
+      // e.preventDefault() in _other_ handlers, even if they are non-passive
+      // (see https://bugs.webkit.org/show_bug.cgi?id=184251)
+      [el, 'touchstart', {
         passive: false
       }], [el, 'touchmove', {
         passive: false
-      }], [el, 'touchend', undefined], [el, 'touchcancel', undefined], [el, 'mousedown', undefined], [el, 'mousemove', undefined], [el, 'mouseup', undefined], [window.document, 'mousemove', {
+      }], [el, 'touchend', undefined], [el, 'touchcancel', undefined], [el, 'mousedown', undefined], [el, 'mousemove', undefined], [el, 'mouseup', undefined], // Bind window-level event listeners for move and up/end events. In the absence of
+      // the pointer capture API, which is not supported by all necessary platforms,
+      // window-level event listeners give us the best shot at capturing events that
+      // fall outside the map canvas element. Use `{capture: true}` for the move event
+      // to prevent map move events from being fired during a drag.
+      // @ts-ignore
+      [window.document, 'mousemove', {
         capture: true
-      }], [window.document, 'mouseup', undefined], [el, 'mouseover', undefined], [el, 'mouseout', undefined], [el, 'dblclick', undefined], [el, 'click', undefined], [el, 'keydown', {
+      }], // @ts-ignore
+      [window.document, 'mouseup', undefined], [el, 'mouseover', undefined], [el, 'mouseout', undefined], [el, 'dblclick', undefined], [el, 'click', undefined], [el, 'keydown', {
         capture: false
       }], [el, 'keyup', undefined], [el, 'wheel', {
         passive: false
-      }], [el, 'contextmenu', undefined], [window, 'blur', undefined]];
+      }], [el, 'contextmenu', undefined], // @ts-ignore
+      [window, 'blur', undefined]];
 
       var _iterator2 = _createForOfIteratorHelper(this.listeners),
           _step2;
@@ -209,7 +205,9 @@ var HandlerManager = function () {
               type = _step2$value[1],
               listenerOptions = _step2$value[2];
 
-          DOM.addEventListener(target, type, target === window.document ? this.handleWindowEvent : this.handleEvent, listenerOptions);
+          // @ts-ignore
+          DOM.addEventListener(target, type, // @ts-ignore
+          target === window.document ? this.handleWindowEvent : this.handleEvent, listenerOptions);
         }
       } catch (err) {
         _iterator2.e(err);
@@ -245,7 +243,9 @@ var HandlerManager = function () {
               type = _step3$value[1],
               listenerOptions = _step3$value[2];
 
-          DOM.removeEventListener(target, type, target === window.document ? this.handleWindowEvent : this.handleEvent, listenerOptions);
+          // @ts-ignore
+          DOM.removeEventListener(target, type, // @ts-ignore
+          target === window.document ? this.handleWindowEvent : this.handleEvent, listenerOptions);
         }
       } catch (err) {
         _iterator3.e(err);
@@ -256,6 +256,7 @@ var HandlerManager = function () {
   }, {
     key: "stop",
     value: function stop() {
+      // do nothing if this method was triggered by a gesture update
       if (this.updatingCamera) {
         return;
       }
@@ -322,12 +323,11 @@ var HandlerManager = function () {
         return;
       }
 
-      _merge(mergedIHandlerResult, HandlerResult);
-
+      merge(mergedIHandlerResult, HandlerResult);
       var eventData = {
         handlerName: name,
         originalEvent: HandlerResult.originalEvent || e
-      };
+      }; // track which handler changed which camera property
 
       if (HandlerResult.zoomDelta !== undefined) {
         eventsInProgress.zoom = eventData;
@@ -352,6 +352,7 @@ var HandlerManager = function () {
 
       if (this.frameId === undefined) {
         this.frameId = this.map.requestRenderFrame(function (timeStamp) {
+          // @ts-ignore
           delete _this2.frameId;
 
           _this2.handleEvent(new RenderFrameEvent('renderFrame', {
@@ -403,7 +404,9 @@ var HandlerManager = function () {
       for (var _i = 0, _arr = ['boxZoom', 'doubleClickZoom', 'tapDragZoom', 'touchPitch', 'dragRotate', 'dragPan', 'touchZoomRotate', 'scrollZoom', 'keyboard']; _i < _arr.length; _i++) {
         var name = _arr[_i];
 
+        // @ts-ignore
         if (options.interactive && options[name]) {
+          // @ts-ignore
           map[name].enable(options[name]);
         }
       }
@@ -503,9 +506,8 @@ var HandlerManager = function () {
             combined.noInertia = change.noInertia;
           }
 
-          _merge(combinedEventsInProgress, eventsInProgress);
-
-          _merge(combinedDeactivatedHandlers, deactivatedHandlers);
+          merge(combinedEventsInProgress, eventsInProgress);
+          merge(combinedDeactivatedHandlers, deactivatedHandlers);
         }
       } catch (err) {
         _iterator7.e(err);
@@ -535,7 +537,8 @@ var HandlerManager = function () {
 
       if (pinchAround !== undefined) {
         around = pinchAround;
-      }
+      } // stop any ongoing camera animations (easeTo, flyTo)
+
 
       map.stop(true);
       around = around || map.transform.centerPoint;
@@ -583,7 +586,8 @@ var HandlerManager = function () {
 
           this.eventsInProgress[eventName] = newEventsInProgress[eventName];
         }
-      }
+      } // fire start events only after this.eventsInProgress has been updated
+
 
       if (!wasMoving && nowMoving) {
         this.fireEvent('movestart', nowMoving.originalEvent);
@@ -677,5 +681,4 @@ var HandlerManager = function () {
   return HandlerManager;
 }();
 
-export default HandlerManager;
-//# sourceMappingURL=handler_manager.js.map
+export default HandlerManager;

package/es/handler/handler_util.js

@@ -1,3 +1,4 @@
+// @ts-ignore
 export function indexTouches(touches, points) {
   var obj = {};
 
@@ -6,5 +7,4 @@ export function indexTouches(touches, points) {
   }
 
   return obj;
-}
-//# sourceMappingURL=handler_util.js.map
+}

package/es/handler/keyboard.js

@@ -1,26 +1,32 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
 var defaultOptions = {
   panStep: 100,
   bearingStep: 15,
   pitchStep: 10
 };
-
-var KeyboardHandler = function () {
+/**
+ * The `KeyboardHandler` allows the user to zoom, rotate, and pan the map using
+ * the following keyboard shortcuts:
+ *
+ * - `=` / `+`: Increase the zoom level by 1.
+ * - `Shift-=` / `Shift-+`: Increase the zoom level by 2.
+ * - `-`: Decrease the zoom level by 1.
+ * - `Shift--`: Decrease the zoom level by 2.
+ * - Arrow keys: Pan by 100 pixels.
+ * - `Shift+⇢`: Increase the rotation by 15 degrees.
+ * - `Shift+⇠`: Decrease the rotation by 15 degrees.
+ * - `Shift+⇡`: Increase the pitch by 10 degrees.
+ * - `Shift+⇣`: Decrease the pitch by 10 degrees.
+ */
+
+var KeyboardHandler = /*#__PURE__*/function () {
+  /**
+   * @private
+   */
   function KeyboardHandler() {
     _classCallCheck(this, KeyboardHandler);
 
-    _defineProperty(this, "enabled", void 0);
-
-    _defineProperty(this, "active", void 0);
-
-    _defineProperty(this, "panStep", void 0);
-
-    _defineProperty(this, "bearingStep", void 0);
-
-    _defineProperty(this, "pitchStep", void 0);
-
     var stepOptions = defaultOptions;
     this.panStep = stepOptions.panStep;
     this.bearingStep = stepOptions.bearingStep;
@@ -153,5 +159,4 @@ function easeOut(t) {
   return t * (2 - t);
 }
 
-export default KeyboardHandler;
-//# sourceMappingURL=keyboard.js.map
+export default KeyboardHandler;

package/es/handler/map_event.js

@@ -1,18 +1,12 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import { MapMouseEvent, MapTouchEvent, MapWheelEvent } from './events';
+// @ts-ignore
+import { MapMouseEvent, MapTouchEvent, MapWheelEvent } from "./events";
 
-var MapEventHandler = function () {
+var MapEventHandler = /*#__PURE__*/function () {
   function MapEventHandler(map, options) {
     _classCallCheck(this, MapEventHandler);
 
-    _defineProperty(this, "mousedownPos", void 0);
-
-    _defineProperty(this, "clickTolerance", void 0);
-
-    _defineProperty(this, "map", void 0);
-
     this.map = map;
     this.clickTolerance = options.clickTolerance;
   }
@@ -20,17 +14,25 @@ var MapEventHandler = function () {
   _createClass(MapEventHandler, [{
     key: "reset",
     value: function reset() {
+      // @ts-ignore
       delete this.mousedownPos;
     }
   }, {
     key: "wheel",
     value: function wheel(e) {
+      // If mapEvent.preventDefault() is called by the user, prevent handlers such as:
+      // - ScrollZoom
       return this.firePreventable(new MapWheelEvent(e.type, this.map, e));
     }
   }, {
     key: "mousedown",
     value: function mousedown(e, point) {
-      this.mousedownPos = point;
+      this.mousedownPos = point; // If mapEvent.preventDefault() is called by the user, prevent handlers such as:
+      // - MousePan
+      // - MouseRotate
+      // - MousePitch
+      // - DblclickHandler
+
       return this.firePreventable(new MapMouseEvent(e.type, this.map, e));
     }
   }, {
@@ -50,6 +52,8 @@ var MapEventHandler = function () {
   }, {
     key: "dblclick",
     value: function dblclick(e) {
+      // If mapEvent.preventDefault() is called by the user, prevent handlers such as:
+      // - DblClickZoom
       return this.firePreventable(new MapMouseEvent(e.type, this.map, e));
     }
   }, {
@@ -65,6 +69,13 @@ var MapEventHandler = function () {
   }, {
     key: "touchstart",
     value: function touchstart(e) {
+      // If mapEvent.preventDefault() is called by the user, prevent handlers such as:
+      // - TouchPan
+      // - TouchZoom
+      // - TouchRotate
+      // - TouchPitch
+      // - TapZoom
+      // - SwipeZoom
       return this.firePreventable(new MapTouchEvent(e.type, this.map, e));
     }
   }, {
@@ -88,6 +99,7 @@ var MapEventHandler = function () {
       this.map.emit(mapEvent.type, mapEvent);
 
       if (mapEvent.defaultPrevented) {
+        // returning an object marks the handler as active and resets other handlers
         return {};
       }
     }
@@ -116,5 +128,4 @@ var MapEventHandler = function () {
   return MapEventHandler;
 }();
 
-export { MapEventHandler as default };
-//# sourceMappingURL=map_event.js.map
+export { MapEventHandler as default };

package/es/handler/mouse/index.js

@@ -1,5 +1,4 @@
-import MousePanHandler from './mousepan_handler';
-import MouseRotateHandler from './mousepitch_hander';
-import MousePitchHandler from './mouserotate_hander';
-export { MousePanHandler, MouseRotateHandler, MousePitchHandler };
-//# sourceMappingURL=index.js.map
+import MousePanHandler from "./mousepan_handler";
+import MouseRotateHandler from "./mousepitch_hander";
+import MousePitchHandler from "./mouserotate_hander";
+export { MousePanHandler, MouseRotateHandler, MousePitchHandler };

package/es/handler/mouse/mouse_handler.js

@@ -1,25 +1,13 @@
 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 { buttonStillPressed } from './util';
+// @ts-ignore
+import DOM from "../../utils/dom";
+import { buttonStillPressed } from "./util";
 
-var MouseHandler = function () {
+var MouseHandler = /*#__PURE__*/function () {
   function MouseHandler(options) {
     _classCallCheck(this, MouseHandler);
 
-    _defineProperty(this, "enabled", void 0);
-
-    _defineProperty(this, "active", void 0);
-
-    _defineProperty(this, "lastPoint", void 0);
-
-    _defineProperty(this, "eventButton", void 0);
-
-    _defineProperty(this, "moved", void 0);
-
-    _defineProperty(this, "clickTolerance", void 0);
-
     this.reset();
     this.clickTolerance = options.clickTolerance || 1;
   }
@@ -60,6 +48,12 @@ var MouseHandler = function () {
       e.preventDefault();
 
       if (buttonStillPressed(e, this.eventButton)) {
+        // Some browsers don't fire a `mouseup` when the mouseup occurs outside
+        // the window or iframe:
+        // https://github.com/mapbox/mapbox-gl-js/issues/4622
+        //
+        // If the button is no longer pressed during this `mousemove` it may have
+        // been released outside of the window or iframe.
         this.reset();
         return;
       }
@@ -69,7 +63,8 @@ var MouseHandler = function () {
       }
 
       this.moved = true;
-      this.lastPoint = point;
+      this.lastPoint = point; // implemented by child class
+
       return this.move(lastPoint, point);
     }
   }, {
@@ -115,17 +110,18 @@ var MouseHandler = function () {
   }, {
     key: "correctButton",
     value: function correctButton(e, button) {
-      return false;
+      // eslint-disable-line
+      return false; // implemented by child
     }
   }, {
     key: "move",
     value: function move(lastPoint, point) {
-      return;
+      // eslint-disable-line
+      return; // implemented by child
     }
   }]);
 
   return MouseHandler;
 }();
 
-export { MouseHandler as default };
-//# sourceMappingURL=mouse_handler.js.map
+export { MouseHandler as default };

package/es/handler/mouse/mousepan_handler.js

@@ -9,10 +9,11 @@ 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 MouseHandler from './mouse_handler';
-import { LEFT_BUTTON } from './util';
+// @ts-ignore
+import MouseHandler from "./mouse_handler";
+import { LEFT_BUTTON } from "./util";
 
-var MousePanHandler = function (_MouseHandler) {
+var MousePanHandler = /*#__PURE__*/function (_MouseHandler) {
   _inherits(MousePanHandler, _MouseHandler);
 
   var _super = _createSuper(MousePanHandler);
@@ -50,5 +51,4 @@ var MousePanHandler = function (_MouseHandler) {
   return MousePanHandler;
 }(MouseHandler);
 
-export { MousePanHandler as default };
-//# sourceMappingURL=mousepan_handler.js.map
+export { MousePanHandler as default };

package/es/handler/mouse/mousepitch_hander.js

@@ -8,10 +8,11 @@ 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 MouseHandler from './mouse_handler';
-import { LEFT_BUTTON, RIGHT_BUTTON } from './util';
+// @ts-ignore
+import MouseHandler from "./mouse_handler";
+import { LEFT_BUTTON, RIGHT_BUTTON } from "./util";
 
-var MousePitchHandler = function (_MouseHandler) {
+var MousePitchHandler = /*#__PURE__*/function (_MouseHandler) {
   _inherits(MousePitchHandler, _MouseHandler);
 
   var _super = _createSuper(MousePitchHandler);
@@ -43,6 +44,8 @@ var MousePitchHandler = function (_MouseHandler) {
   }, {
     key: "contextmenu",
     value: function contextmenu(e) {
+      // prevent browser context menu when necessary; we don't allow it with rotation
+      // because we can't discern rotation gesture start from contextmenu on Mac
       e.preventDefault();
     }
   }]);
@@ -50,5 +53,4 @@ var MousePitchHandler = function (_MouseHandler) {
   return MousePitchHandler;
 }(MouseHandler);
 
-export { MousePitchHandler as default };
-//# sourceMappingURL=mousepitch_hander.js.map
+export { MousePitchHandler as default };

package/es/handler/mouse/mouserotate_hander.js

@@ -8,10 +8,11 @@ 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 MouseHandler from './mouse_handler';
-import { LEFT_BUTTON, RIGHT_BUTTON } from './util';
+// @ts-ignore
+import MouseHandler from "./mouse_handler";
+import { LEFT_BUTTON, RIGHT_BUTTON } from "./util";
 
-var MouseRotateHandler = function (_MouseHandler) {
+var MouseRotateHandler = /*#__PURE__*/function (_MouseHandler) {
   _inherits(MouseRotateHandler, _MouseHandler);
 
   var _super = _createSuper(MouseRotateHandler);
@@ -25,6 +26,8 @@ var MouseRotateHandler = function (_MouseHandler) {
   _createClass(MouseRotateHandler, [{
     key: "contextmenu",
     value: function contextmenu(e) {
+      // prevent browser context menu when necessary; we don't allow it with rotation
+      // because we can't discern rotation gesture start from contextmenu on Mac
       e.preventDefault();
     }
   }, {
@@ -50,5 +53,4 @@ var MouseRotateHandler = function (_MouseHandler) {
   return MouseRotateHandler;
 }(MouseHandler);
 
-export { MouseRotateHandler as default };
-//# sourceMappingURL=mouserotate_hander.js.map
+export { MouseRotateHandler as default };

package/es/handler/mouse/util.js

@@ -3,10 +3,10 @@ import _defineProperty from "@babel/runtime/helpers/defineProperty";
 var _BUTTONS_FLAGS;
 
 export var LEFT_BUTTON = 0;
-export var RIGHT_BUTTON = 2;
+export var RIGHT_BUTTON = 2; // the values for each button in MouseEvent.buttons
+
 export var BUTTONS_FLAGS = (_BUTTONS_FLAGS = {}, _defineProperty(_BUTTONS_FLAGS, LEFT_BUTTON, 1), _defineProperty(_BUTTONS_FLAGS, RIGHT_BUTTON, 2), _BUTTONS_FLAGS);
 export function buttonStillPressed(e, button) {
   var flag = BUTTONS_FLAGS[button];
   return e.buttons === undefined || (e.buttons & flag) !== flag;
-}
-//# sourceMappingURL=util.js.map
+}