westures-core 1.2.1 → 1.3.1

package/dist/index.js

@@ -32,8 +32,7 @@ let $de0d6a332419bf3c$var$g_id = 0;
  * @param {number} [options.maxInputs=Number.MAX_VALUE] - The maximum number of
  * pointers that may be active for the gesture to be recognized. Uses <=.
  */ class $de0d6a332419bf3c$var$Gesture {
-    constructor(type, element, handler, options = {
-    }){
+    constructor(type, element, handler, options = {}){
         if (typeof type !== 'string') throw new TypeError('Gestures require a string type / name');
         /**
      * The name of the gesture. (e.g. 'pan' or 'tap' or 'pinch').
@@ -77,10 +76,8 @@ let $de0d6a332419bf3c$var$g_id = 0;
    */ isEnabled(state) {
         const count = state.active.length;
         const event = state.event;
-        const { enableKeys: enableKeys , disableKeys: disableKeys , minInputs: minInputs , maxInputs: maxInputs  } = this.options;
-        return minInputs <= count && maxInputs >= count && (enableKeys.length === 0 || enableKeys.some((k)=>event[k]
-        )) && !disableKeys.some((k)=>event[k]
-        );
+        const { enableKeys: enableKeys, disableKeys: disableKeys, minInputs: minInputs, maxInputs: maxInputs } = this.options;
+        return minInputs <= count && maxInputs >= count && (enableKeys.length === 0 || enableKeys.some((k)=>event[k])) && !disableKeys.some((k)=>event[k]);
     }
     /**
    * Event hook for the start phase of a gesture.
@@ -214,8 +211,7 @@ var $6c3676f10a43b740$exports = {};
    *
    * @returns {number[]}
    */ anglesTo(points) {
-        return points.map((point)=>this.angleTo(point)
-        );
+        return points.map((point)=>this.angleTo(point));
     }
     /**
    * Determine the average distance from this point to the provided array of
@@ -275,8 +271,7 @@ var $6c3676f10a43b740$exports = {};
    *
    * @return {number} The total distance from this point to the provided points.
    */ totalDistanceTo(points) {
-        return points.reduce((d, p)=>d + this.distanceTo(p)
-        , 0);
+        return points.reduce((d, p)=>d + this.distanceTo(p), 0);
     }
     /**
    * Calculates the centroid of a list of points.
@@ -319,9 +314,10 @@ var $be6f0e84320366a7$exports = {};
  * @type {string[]}
  */ const $be6f0e84320366a7$var$CANCEL_EVENTS = [
     'blur',
+    'contextmenu',
     'pointercancel',
     'touchcancel',
-    'mouseleave', 
+    'mouseleave'
 ];
 /**
  * List of keyboard events that trigger a restart.
@@ -330,7 +326,7 @@ var $be6f0e84320366a7$exports = {};
  * @type {string[]}
  */ const $be6f0e84320366a7$var$KEYBOARD_EVENTS = [
     'keydown',
-    'keyup', 
+    'keyup'
 ];
 /**
  * List of mouse events to listen to.
@@ -340,7 +336,7 @@ var $be6f0e84320366a7$exports = {};
  */ const $be6f0e84320366a7$var$MOUSE_EVENTS = [
     'mousedown',
     'mousemove',
-    'mouseup', 
+    'mouseup'
 ];
 /**
  * List of pointer events to listen to.
@@ -350,7 +346,7 @@ var $be6f0e84320366a7$exports = {};
  */ const $be6f0e84320366a7$var$POINTER_EVENTS = [
     'pointerdown',
     'pointermove',
-    'pointerup', 
+    'pointerup'
 ];
 /**
  * List of touch events to listen to.
@@ -360,7 +356,7 @@ var $be6f0e84320366a7$exports = {};
  */ const $be6f0e84320366a7$var$TOUCH_EVENTS = [
     'touchend',
     'touchmove',
-    'touchstart', 
+    'touchstart'
 ];
 /**
  * List of potentially state-modifying keys.
@@ -372,7 +368,7 @@ var $be6f0e84320366a7$exports = {};
     'altKey',
     'ctrlKey',
     'metaKey',
-    'shiftKey', 
+    'shiftKey'
 ];
 /**
  * List of the 'key' values on KeyboardEvent objects of the potentially
@@ -384,7 +380,7 @@ var $be6f0e84320366a7$exports = {};
     'Alt',
     'Control',
     'Meta',
-    'Shift', 
+    'Shift'
 ];
 /**
  * The cancel phase.
@@ -482,7 +478,7 @@ var $0ca7bfe1c074e8ca$require$PHASE = $be6f0e84320366a7$exports.PHASE;
  * @param {number} identifier - The index of touch if applicable
  */ class $0ca7bfe1c074e8ca$var$PointerData {
     constructor(event, identifier){
-        const { clientX: clientX , clientY: clientY  } = $0ca7bfe1c074e8ca$var$getEventObject(event, identifier);
+        const { clientX: clientX, clientY: clientY } = $0ca7bfe1c074e8ca$var$getEventObject(event, identifier);
         /**
      * The original event object.
      *
@@ -575,8 +571,7 @@ const $4559ecf940edc78d$var$PI_NVE = -Math.PI;
  * @return {Set} Set consisting of elements in 'left' that are not in
  * 'right'.
  */ function $4559ecf940edc78d$var$setDifference(left, right) {
-    return $4559ecf940edc78d$var$setFilter(left, (element)=>!right.has(element)
-    );
+    return $4559ecf940edc78d$var$setFilter(left, (element)=>!right.has(element));
 }
 $4559ecf940edc78d$exports = {
     angularDifference: $4559ecf940edc78d$var$angularDifference,
@@ -598,14 +593,17 @@ var $e2125e2e71e37a0c$require$getPropagationPath = $4559ecf940edc78d$exports.get
  * @param {number} identifier - The identifier for this input, so that it can
  * be located in subsequent Event objects.
  */ class $e2125e2e71e37a0c$var$Input {
-    constructor(event, identifier){
+    constructor(event, identifier, headless = false){
         const currentData = new $0ca7bfe1c074e8ca$exports(event, identifier);
         /**
      * The set of elements along the original event's propagation path at the
      * time it was dispatched.
      *
      * @type {WeakSet.<Element>}
-     */ this.initialElements = new WeakSet($e2125e2e71e37a0c$require$getPropagationPath(event));
+     */ if (headless) this.initialElements = new WeakSet([
+            event.target
+        ]);
+        else this.initialElements = new WeakSet($e2125e2e71e37a0c$require$getPropagationPath(event));
         /**
      * Holds the initial data from the mousedown / touchstart / pointerdown that
      * began this input.
@@ -683,31 +681,14 @@ var $639be6fb478a6d5a$require$END = $be6f0e84320366a7$exports.END;
 var $639be6fb478a6d5a$require$MOVE = $be6f0e84320366a7$exports.MOVE;
 var $639be6fb478a6d5a$require$PHASE = $be6f0e84320366a7$exports.PHASE;
 var $639be6fb478a6d5a$require$START = $be6f0e84320366a7$exports.START;
+var $639be6fb478a6d5a$require$MOUSE_EVENTS = $be6f0e84320366a7$exports.MOUSE_EVENTS;
+var $639be6fb478a6d5a$require$POINTER_EVENTS = $be6f0e84320366a7$exports.POINTER_EVENTS;
+var $639be6fb478a6d5a$require$TOUCH_EVENTS = $be6f0e84320366a7$exports.TOUCH_EVENTS;
 
 
 const $639be6fb478a6d5a$var$symbols = {
     inputs: Symbol.for('inputs')
 };
-/**
- * Set of helper functions for updating inputs based on type of input.
- * Must be called with a bound 'this', via bind(), or call(), or apply().
- *
- * @private
- * @inner
- * @memberof westure-core.State
- */ const $639be6fb478a6d5a$var$update_fns = {
-    TouchEvent: function TouchEvent(event) {
-        Array.from(event.changedTouches).forEach((touch)=>{
-            this.updateInput(event, touch.identifier);
-        });
-    },
-    PointerEvent: function PointerEvent(event) {
-        this.updateInput(event, event.pointerId);
-    },
-    MouseEvent: function MouseEvent(event) {
-        if (event.button === 0) this.updateInput(event, event.button);
-    }
-};
 /**
  * Keeps track of currently active and ending input points on the interactive
  * surface.
@@ -715,14 +696,21 @@ const $639be6fb478a6d5a$var$symbols = {
  * @memberof westures-core
  *
  * @param {Element} element - The element underpinning the associated Region.
+ * @param {boolean} [headless=false] - Whether westures is operating in
+ * "headless" mode.
  */ class $639be6fb478a6d5a$var$State {
-    constructor(element){
+    constructor(element, headless = false){
         /**
      * Keep a reference to the element for the associated region.
      *
      * @type {Element}
      */ this.element = element;
         /**
+     * Whether westures is operating in "headless" mode.
+     *
+     * @type {boolean}
+     */ this.headless = headless;
+        /**
      * Keeps track of the current Input objects.
      *
      * @alias [@@inputs]
@@ -747,11 +735,11 @@ const $639be6fb478a6d5a$var$symbols = {
      * @type {westures-core.Point2D[]}
      */ this.activePoints = [];
         /**
-     * The centroid of the currently active points.
+     * The centroid of the currently active points, or null when there are no
+     * active inputs (such as during the final end event).
      *
-     * @type {westures-core.Point2D}
-     */ this.centroid = {
-        };
+     * @type {?westures-core.Point2D}
+     */ this.centroid = null;
         /**
      * The latest event that the state processed.
      *
@@ -770,16 +758,14 @@ const $639be6fb478a6d5a$var$symbols = {
    *
    * @return {westures-core.Input[]} Inputs in the given phase.
    */ getInputsInPhase(phase) {
-        return this.inputs.filter((i)=>i.phase === phase
-        );
+        return this.inputs.filter((i)=>i.phase === phase);
     }
     /**
    * @param {string} phase - One of 'start', 'move', 'end', or 'cancel'.
    *
    * @return {westures-core.Input[]} Inputs <b>not</b> in the given phase.
    */ getInputsNotInPhase(phase) {
-        return this.inputs.filter((i)=>i.phase !== phase
-        );
+        return this.inputs.filter((i)=>i.phase !== phase);
     }
     /**
    * @return {boolean} True if there are no active inputs. False otherwise.
@@ -796,8 +782,8 @@ const $639be6fb478a6d5a$var$symbols = {
    */ updateInput(event, identifier) {
         switch($639be6fb478a6d5a$require$PHASE[event.type]){
             case $639be6fb478a6d5a$require$START:
-                this[$639be6fb478a6d5a$var$symbols.inputs].set(identifier, new $e2125e2e71e37a0c$exports(event, identifier));
-                try {
+                this[$639be6fb478a6d5a$var$symbols.inputs].set(identifier, new $e2125e2e71e37a0c$exports(event, identifier, this.headless));
+                if (!this.headless) try {
                     this.element.setPointerCapture(identifier);
                 } catch (e) {
                 // NOP: Optional operation failed.
@@ -806,9 +792,9 @@ const $639be6fb478a6d5a$var$symbols = {
             // All of 'end', 'move', and 'cancel' perform updates, hence the
             // following fall-throughs
             case $639be6fb478a6d5a$require$END:
-                try {
+                if (!this.headless) try {
                     this.element.releasePointerCapture(identifier);
-                } catch (e1) {
+                } catch (e) {
                 // NOP: Optional operation failed.
                 }
             case $639be6fb478a6d5a$require$CANCEL:
@@ -825,7 +811,13 @@ const $639be6fb478a6d5a$var$symbols = {
    * @private
    * @param {Event} event - The event being captured.
    */ updateAllInputs(event) {
-        $639be6fb478a6d5a$var$update_fns[event.constructor.name].call(this, event);
+        if ($639be6fb478a6d5a$require$POINTER_EVENTS.includes(event.type)) this.updateInput(event, event.pointerId);
+        else if ($639be6fb478a6d5a$require$MOUSE_EVENTS.includes(event.type)) {
+            if (event.button === 0) this.updateInput(event, event.button);
+        } else if ($639be6fb478a6d5a$require$TOUCH_EVENTS.includes(event.type)) Array.from(event.changedTouches).forEach((touch)=>{
+            this.updateInput(event, touch.identifier);
+        });
+        else throw new Error(`Unexpected event type: ${event.type}`);
         this.updateFields(event);
     }
     /**
@@ -836,8 +828,7 @@ const $639be6fb478a6d5a$var$symbols = {
    */ updateFields(event) {
         this.inputs = Array.from(this[$639be6fb478a6d5a$var$symbols.inputs].values());
         this.active = this.getInputsNotInPhase('end');
-        this.activePoints = this.active.map((i)=>i.current.point
-        );
+        this.activePoints = this.active.map((i)=>i.current.point);
         this.centroid = $6c3676f10a43b740$exports.centroid(this.activePoints);
         this.event = event;
     }
@@ -865,8 +856,9 @@ var $b66a0f22c18e3e3d$require$setFilter = $4559ecf940edc78d$exports.setFilter;
  *
  * @memberof westures-core
  *
- * @param {Element} element=window - The element which should listen to input
- * events.
+ * @param {Element} [element=null] - The element which should listen to input
+ * events. If not provided, will be set to the window unless operating in
+ * "headless" mode.
  * @param {object} [options]
  * @param {boolean} [options.capture=false] - Whether the region uses the
  * capture phase of input events. If false, uses the bubbling phase.
@@ -877,13 +869,26 @@ var $b66a0f22c18e3e3d$require$setFilter = $4559ecf940edc78d$exports.setFilter;
  * ignored. Here there by dragons if set to false.
  * @param {string} [options.touchAction='none'] - Value to set the CSS
  * 'touch-action' property to on elements added to the region.
+ * @param {boolean} [options.headless=false] - Set to true to turn on "headless"
+ * mode. This mode is intended for use outside of a browser environment. It does
+ * not listen to window events, so instead you will have to send events directly
+ * into the region. Pointer down/move/up events should be sent to
+ * Region.arbitrate(event), cancel events should be sent to
+ * Region.cancel(event), and keyboard events should be sent to
+ * Region.handleKeyboardEvent(event). You do not need to supply an element to
+ * the Region constructor in this mode, but you will still need to attach
+ * elements to Gestures, and the events you pass in should specify event.target
+ * appropriately, in order to select which gestures to run.
  */ class $b66a0f22c18e3e3d$var$Region {
-    constructor(element = window, options = {
-    }){
+    constructor(element = null, options = {}){
         options = {
             ...$b66a0f22c18e3e3d$var$Region.DEFAULTS,
             ...options
         };
+        if (element === null) {
+            if (options.headless) element = null;
+            else element = window;
+        }
         /**
      * The list of relations between elements, their gestures, and the handlers.
      *
@@ -914,8 +919,8 @@ var $b66a0f22c18e3e3d$require$setFilter = $4559ecf940edc78d$exports.setFilter;
      * The internal state object for a Region.  Keeps track of inputs.
      *
      * @type {westures-core.State}
-     */ this.state = new $639be6fb478a6d5a$exports(this.element);
-        // Begin operating immediately.
+     */ this.state = new $639be6fb478a6d5a$exports(this.element, options.headless);
+        if (!options.headless) // Begin operating immediately.
         this.activate();
     }
     /**
@@ -937,9 +942,7 @@ var $b66a0f22c18e3e3d$require$setFilter = $4559ecf940edc78d$exports.setFilter;
      *  https://www.html5rocks.com/en/mobile/touchandmouse/
      *  https://developer.mozilla.org/en-US/docs/Web/API/Touch_events
      *  https://developer.mozilla.org/en-US/docs/Web/API/Pointer_events
-     */ let eventNames = [];
-        if (this.options.preferPointer && window.PointerEvent) eventNames = $b66a0f22c18e3e3d$require$POINTER_EVENTS;
-        else eventNames = $b66a0f22c18e3e3d$require$MOUSE_EVENTS.concat($b66a0f22c18e3e3d$require$TOUCH_EVENTS);
+     */ const eventNames = this.options.preferPointer && window.PointerEvent ? $b66a0f22c18e3e3d$require$POINTER_EVENTS : $b66a0f22c18e3e3d$require$MOUSE_EVENTS.concat($b66a0f22c18e3e3d$require$TOUCH_EVENTS);
         // Bind detected browser events to the region element.
         const arbitrate = this.arbitrate.bind(this);
         eventNames.forEach((eventName)=>{
@@ -965,14 +968,14 @@ var $b66a0f22c18e3e3d$require$setFilter = $4559ecf940edc78d$exports.setFilter;
    * @private
    * @param {Event} event - The event emitted from the window object.
    */ cancel(event) {
-        if (this.options.preventDefault) event.preventDefault();
+        if (this.options.preventDefault && typeof event.preventDefault === 'function') event.preventDefault();
         this.state.inputs.forEach((input)=>{
             input.update(event);
         });
         this.activeGestures.forEach((gesture)=>{
             gesture.evaluateHook($b66a0f22c18e3e3d$require$CANCEL, this.state);
         });
-        this.state = new $639be6fb478a6d5a$exports(this.element);
+        this.state = new $639be6fb478a6d5a$exports(this.element, this.options.headless);
         this.resetActiveGestures();
     }
     /**
@@ -1057,7 +1060,7 @@ var $b66a0f22c18e3e3d$require$setFilter = $4559ecf940edc78d$exports.setFilter;
         this.state.updateAllInputs(event);
         this.updateActiveGestures(event, isInitial);
         if (this.activeGestures.size > 0) {
-            if (this.options.preventDefault) event.preventDefault();
+            if (this.options.preventDefault && typeof event.preventDefault === 'function') event.preventDefault();
             this.activeGestures.forEach((gesture)=>{
                 gesture.evaluateHook($b66a0f22c18e3e3d$require$PHASE[event.type], this.state);
             });
@@ -1070,7 +1073,7 @@ var $b66a0f22c18e3e3d$require$setFilter = $4559ecf940edc78d$exports.setFilter;
    *
    * @param {westures-core.Gesture} gesture - Instantiated gesture to add.
    */ addGesture(gesture) {
-        gesture.element.style.touchAction = this.options.touchAction;
+        if (!this.options.headless) gesture.element.style.touchAction = this.options.touchAction;
         this.gestures.add(gesture);
     }
     /**
@@ -1089,23 +1092,22 @@ var $b66a0f22c18e3e3d$require$setFilter = $4559ecf940edc78d$exports.setFilter;
    *
    * @return {westures-core.Gesture[]} Gestures to which the element is bound.
    */ getGesturesByElement(element) {
-        return $b66a0f22c18e3e3d$require$setFilter(this.gestures, (gesture)=>gesture.element === element
-        );
+        return $b66a0f22c18e3e3d$require$setFilter(this.gestures, (gesture)=>gesture.element === element);
     }
     /**
    * Remove all gestures bound to the given element.
    *
    * @param {Element} element - The element to unbind.
    */ removeGesturesByElement(element) {
-        this.getGesturesByElement(element).forEach((g)=>this.removeGesture(g)
-        );
+        this.getGesturesByElement(element).forEach((g)=>this.removeGesture(g));
     }
 }
 $b66a0f22c18e3e3d$var$Region.DEFAULTS = {
     capture: false,
     preferPointer: true,
     preventDefault: true,
-    touchAction: 'none'
+    touchAction: 'none',
+    headless: false
 };
 $b66a0f22c18e3e3d$exports = $b66a0f22c18e3e3d$var$Region;
 
@@ -1162,8 +1164,7 @@ const $01c3d7b128023e4f$var$smooth = Symbol('smooth');
  * the data.
  * @param {*} [options.identity=0] The identity value of this smoothable data.
  */ class $01c3d7b128023e4f$var$Smoothable {
-    constructor(options = {
-    }){
+    constructor(options = {}){
         const final_options = {
             ...$01c3d7b128023e4f$var$Smoothable.DEFAULTS,
             ...options
@@ -1177,8 +1178,7 @@ const $01c3d7b128023e4f$var$smooth = Symbol('smooth');
      * @return {*} The smoothed out data.
      */ this.next = null;
         if ($01c3d7b128023e4f$var$smoothingIsApplicable(final_options.applySmoothing)) this.next = this[$01c3d7b128023e4f$var$smooth].bind(this);
-        else this.next = (data)=>data
-        ;
+        else this.next = (data)=>data;
         /**
      * The "identity" value of the data that will be smoothed.
      *