blockly 8.0.4-beta.0 → 8.0.5-beta.0

package/core/touch.js

@@ -1,285 +0,0 @@
-/**
- * @license
- * Copyright 2016 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Touch handling for Blockly.
- */
-'use strict';
-
-/**
- * Touch handling for Blockly.
- * @namespace Blockly.Touch
- */
-goog.module('Blockly.Touch');
-
-const utilsString = goog.require('Blockly.utils.string');
-/* eslint-disable-next-line no-unused-vars */
-const {Gesture} = goog.requireType('Blockly.Gesture');
-const {globalThis} = goog.require('Blockly.utils.global');
-
-
-/**
- * Length in ms for a touch to become a long press.
- * @const
- */
-const LONGPRESS = 750;
-
-/**
- * Whether touch is enabled in the browser.
- * Copied from Closure's goog.events.BrowserFeature.TOUCH_ENABLED
- * @const
- */
-const TOUCH_ENABLED =
-    ('ontouchstart' in globalThis ||
-     !!(globalThis['document'] && document.documentElement &&
-        'ontouchstart' in document.documentElement) ||
-     // IE10 uses non-standard touch events, so it has a different check.
-     !!(globalThis['navigator'] &&
-        (globalThis['navigator']['maxTouchPoints'] ||
-         globalThis['navigator']['msMaxTouchPoints'])));
-exports.TOUCH_ENABLED = TOUCH_ENABLED;
-
-/**
- * Which touch events are we currently paying attention to?
- * @type {?string}
- */
-let touchIdentifier_ = null;
-
-/**
- * The TOUCH_MAP lookup dictionary specifies additional touch events to fire,
- * in conjunction with mouse events.
- * @type {Object}
- * @alias Blockly.Touch.TOUCH_MAP
- */
-let TOUCH_MAP = {};
-if (globalThis['PointerEvent']) {
-  TOUCH_MAP = {
-    'mousedown': ['pointerdown'],
-    'mouseenter': ['pointerenter'],
-    'mouseleave': ['pointerleave'],
-    'mousemove': ['pointermove'],
-    'mouseout': ['pointerout'],
-    'mouseover': ['pointerover'],
-    'mouseup': ['pointerup', 'pointercancel'],
-    'touchend': ['pointerup'],
-    'touchcancel': ['pointercancel'],
-  };
-} else if (TOUCH_ENABLED) {
-  TOUCH_MAP = {
-    'mousedown': ['touchstart'],
-    'mousemove': ['touchmove'],
-    'mouseup': ['touchend', 'touchcancel'],
-  };
-}
-exports.TOUCH_MAP = TOUCH_MAP;
-
-/**
- * PID of queued long-press task.
- */
-let longPid_ = 0;
-
-/**
- * Context menus on touch devices are activated using a long-press.
- * Unfortunately the contextmenu touch event is currently (2015) only supported
- * by Chrome.  This function is fired on any touchstart event, queues a task,
- * which after about a second opens the context menu.  The tasks is killed
- * if the touch event terminates early.
- * @param {!Event} e Touch start event.
- * @param {Gesture} gesture The gesture that triggered this longStart.
- * @alias Blockly.Touch.longStart
- * @package
- */
-const longStart = function(e, gesture) {
-  longStop();
-  // Punt on multitouch events.
-  if (e.changedTouches && e.changedTouches.length !== 1) {
-    return;
-  }
-  longPid_ = setTimeout(function() {
-    // Additional check to distinguish between touch events and pointer events
-    if (e.changedTouches) {
-      // TouchEvent
-      e.button = 2;  // Simulate a right button click.
-      // e was a touch event.  It needs to pretend to be a mouse event.
-      e.clientX = e.changedTouches[0].clientX;
-      e.clientY = e.changedTouches[0].clientY;
-    }
-
-    // Let the gesture route the right-click correctly.
-    if (gesture) {
-      gesture.handleRightClick(e);
-    }
-  }, LONGPRESS);
-};
-exports.longStart = longStart;
-
-/**
- * Nope, that's not a long-press.  Either touchend or touchcancel was fired,
- * or a drag hath begun.  Kill the queued long-press task.
- * @alias Blockly.Touch.longStop
- * @package
- */
-const longStop = function() {
-  if (longPid_) {
-    clearTimeout(longPid_);
-    longPid_ = 0;
-  }
-};
-exports.longStop = longStop;
-
-/**
- * Clear the touch identifier that tracks which touch stream to pay attention
- * to.  This ends the current drag/gesture and allows other pointers to be
- * captured.
- * @alias Blockly.Touch.clearTouchIdentifier
- */
-const clearTouchIdentifier = function() {
-  touchIdentifier_ = null;
-};
-exports.clearTouchIdentifier = clearTouchIdentifier;
-
-/**
- * Decide whether Blockly should handle or ignore this event.
- * Mouse and touch events require special checks because we only want to deal
- * with one touch stream at a time.  All other events should always be handled.
- * @param {!Event} e The event to check.
- * @return {boolean} True if this event should be passed through to the
- *     registered handler; false if it should be blocked.
- * @alias Blockly.Touch.shouldHandleEvent
- */
-const shouldHandleEvent = function(e) {
-  return !isMouseOrTouchEvent(e) || checkTouchIdentifier(e);
-};
-exports.shouldHandleEvent = shouldHandleEvent;
-
-/**
- * Get the touch identifier from the given event.  If it was a mouse event, the
- * identifier is the string 'mouse'.
- * @param {!Event} e Mouse event or touch event.
- * @return {string} The touch identifier from the first changed touch, if
- *     defined.  Otherwise 'mouse'.
- * @alias Blockly.Touch.getTouchIdentifierFromEvent
- */
-const getTouchIdentifierFromEvent = function(e) {
-  return e.pointerId !== undefined ? e.pointerId :
-      (e.changedTouches && e.changedTouches[0] &&
-       e.changedTouches[0].identifier !== undefined &&
-       e.changedTouches[0].identifier !== null) ?
-                                     e.changedTouches[0].identifier :
-                                     'mouse';
-};
-exports.getTouchIdentifierFromEvent = getTouchIdentifierFromEvent;
-
-/**
- * Check whether the touch identifier on the event matches the current saved
- * identifier.  If there is no identifier, that means it's a mouse event and
- * we'll use the identifier "mouse".  This means we won't deal well with
- * multiple mice being used at the same time.  That seems okay.
- * If the current identifier was unset, save the identifier from the
- * event.  This starts a drag/gesture, during which touch events with other
- * identifiers will be silently ignored.
- * @param {!Event} e Mouse event or touch event.
- * @return {boolean} Whether the identifier on the event matches the current
- *     saved identifier.
- * @alias Blockly.Touch.checkTouchIdentifier
- */
-const checkTouchIdentifier = function(e) {
-  const identifier = getTouchIdentifierFromEvent(e);
-
-  // if (touchIdentifier_) is insufficient because Android touch
-  // identifiers may be zero.
-  if (touchIdentifier_ !== undefined && touchIdentifier_ !== null) {
-    // We're already tracking some touch/mouse event.  Is this from the same
-    // source?
-    return touchIdentifier_ === identifier;
-  }
-  if (e.type === 'mousedown' || e.type === 'touchstart' ||
-      e.type === 'pointerdown') {
-    // No identifier set yet, and this is the start of a drag.  Set it and
-    // return.
-    touchIdentifier_ = identifier;
-    return true;
-  }
-  // There was no identifier yet, but this wasn't a start event so we're going
-  // to ignore it.  This probably means that another drag finished while this
-  // pointer was down.
-  return false;
-};
-exports.checkTouchIdentifier = checkTouchIdentifier;
-
-/**
- * Set an event's clientX and clientY from its first changed touch.  Use this to
- * make a touch event work in a mouse event handler.
- * @param {!Event} e A touch event.
- * @alias Blockly.Touch.setClientFromTouch
- */
-const setClientFromTouch = function(e) {
-  if (utilsString.startsWith(e.type, 'touch') && e.changedTouches) {
-    // Map the touch event's properties to the event.
-    const touchPoint = e.changedTouches[0];
-    e.clientX = touchPoint.clientX;
-    e.clientY = touchPoint.clientY;
-  }
-};
-exports.setClientFromTouch = setClientFromTouch;
-
-/**
- * Check whether a given event is a mouse or touch event.
- * @param {!Event} e An event.
- * @return {boolean} True if it is a mouse or touch event; false otherwise.
- * @alias Blockly.Touch.isMouseOrTouchEvent
- */
-const isMouseOrTouchEvent = function(e) {
-  return utilsString.startsWith(e.type, 'touch') ||
-      utilsString.startsWith(e.type, 'mouse') ||
-      utilsString.startsWith(e.type, 'pointer');
-};
-exports.isMouseOrTouchEvent = isMouseOrTouchEvent;
-
-/**
- * Check whether a given event is a touch event or a pointer event.
- * @param {!Event} e An event.
- * @return {boolean} True if it is a touch event; false otherwise.
- * @alias Blockly.Touch.isTouchEvent
- */
-const isTouchEvent = function(e) {
-  return utilsString.startsWith(e.type, 'touch') ||
-      utilsString.startsWith(e.type, 'pointer');
-};
-exports.isTouchEvent = isTouchEvent;
-
-/**
- * Split an event into an array of events, one per changed touch or mouse
- * point.
- * @param {!Event} e A mouse event or a touch event with one or more changed
- * touches.
- * @return {!Array<!Event>} An array of mouse or touch events.  Each touch
- *     event will have exactly one changed touch.
- * @alias Blockly.Touch.splitEventByTouches
- */
-const splitEventByTouches = function(e) {
-  const events = [];
-  if (e.changedTouches) {
-    for (let i = 0; i < e.changedTouches.length; i++) {
-      const newEvent = {
-        type: e.type,
-        changedTouches: [e.changedTouches[i]],
-        target: e.target,
-        stopPropagation: function() {
-          e.stopPropagation();
-        },
-        preventDefault: function() {
-          e.preventDefault();
-        },
-      };
-      events[i] = newEvent;
-    }
-  } else {
-    events.push(e);
-  }
-  return events;
-};
-exports.splitEventByTouches = splitEventByTouches;

package/core/utils/coordinate.js

@@ -1,138 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Utility methods for coordinate manipulation.
- * These methods are not specific to Blockly, and could be factored out into
- * a JavaScript framework such as Closure.
- */
-'use strict';
-
-/**
- * Utility methods for coordinate manipulation.
- * These methods are not specific to Blockly, and could be factored out into
- * a JavaScript framework such as Closure.
- * @class
- */
-goog.module('Blockly.utils.Coordinate');
-
-/**
- * Class for representing coordinates and positions.
- * @alias Blockly.utils.Coordinate
- */
-const Coordinate = class {
-  /**
-   * @param {number} x Left.
-   * @param {number} y Top.
-   */
-  constructor(x, y) {
-    /**
-     * X-value
-     * @type {number}
-     */
-    this.x = x;
-
-    /**
-     * Y-value
-     * @type {number}
-     */
-    this.y = y;
-  }
-
-  /**
-   * Creates a new copy of this coordinate.
-   * @return {!Coordinate} A copy of this coordinate.
-   */
-  clone() {
-    return new Coordinate(this.x, this.y);
-  }
-
-  /**
-   * Scales this coordinate by the given scale factor.
-   * @param {number} s The scale factor to use for both x and y dimensions.
-   * @return {!Coordinate} This coordinate after scaling.
-   */
-  scale(s) {
-    this.x *= s;
-    this.y *= s;
-    return this;
-  }
-
-  /**
-   * Translates this coordinate by the given offsets.
-   * respectively.
-   * @param {number} tx The value to translate x by.
-   * @param {number} ty The value to translate y by.
-   * @return {!Coordinate} This coordinate after translating.
-   */
-  translate(tx, ty) {
-    this.x += tx;
-    this.y += ty;
-    return this;
-  }
-
-  /**
-   * Compares coordinates for equality.
-   * @param {?Coordinate} a A Coordinate.
-   * @param {?Coordinate} b A Coordinate.
-   * @return {boolean} True iff the coordinates are equal, or if both are null.
-   */
-  static equals(a, b) {
-    if (a === b) {
-      return true;
-    }
-    if (!a || !b) {
-      return false;
-    }
-    return a.x === b.x && a.y === b.y;
-  }
-
-  /**
-   * Returns the distance between two coordinates.
-   * @param {!Coordinate} a A Coordinate.
-   * @param {!Coordinate} b A Coordinate.
-   * @return {number} The distance between `a` and `b`.
-   */
-  static distance(a, b) {
-    const dx = a.x - b.x;
-    const dy = a.y - b.y;
-    return Math.sqrt(dx * dx + dy * dy);
-  }
-
-  /**
-   * Returns the magnitude of a coordinate.
-   * @param {!Coordinate} a A Coordinate.
-   * @return {number} The distance between the origin and `a`.
-   */
-  static magnitude(a) {
-    return Math.sqrt(a.x * a.x + a.y * a.y);
-  }
-
-  /**
-   * Returns the difference between two coordinates as a new
-   * Coordinate.
-   * @param {!Coordinate|!SVGPoint} a An x/y coordinate.
-   * @param {!Coordinate|!SVGPoint} b An x/y coordinate.
-   * @return {!Coordinate} A Coordinate representing the difference
-   *     between `a` and `b`.
-   */
-  static difference(a, b) {
-    return new Coordinate(a.x - b.x, a.y - b.y);
-  }
-
-  /**
-   * Returns the sum of two coordinates as a new Coordinate.
-   * @param {!Coordinate|!SVGPoint} a An x/y coordinate.
-   * @param {!Coordinate|!SVGPoint} b An x/y coordinate.
-   * @return {!Coordinate} A Coordinate representing the sum of
-   *     the two coordinates.
-   */
-  static sum(a, b) {
-    return new Coordinate(a.x + b.x, a.y + b.y);
-  }
-};
-
-exports.Coordinate = Coordinate;

package/core/utils/global.js

@@ -1,41 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Provides a reference to the global object.
- */
-'use strict';
-
-/**
- * Provides a reference to the global object.
- * @namespace Blockly.utils.global
- */
-goog.module('Blockly.utils.global');
-
-
-/* eslint-disable no-undef, no-invalid-this */
-
-/**
- * Reference to the global object.
- *
- * More info on this implementation here:
- * https://docs.google.com/document/d/1NAeW4Wk7I7FV0Y2tcUFvQdGMc89k2vdgSXInw8_nvCI
- */
-exports.globalThis = (function() {  // Not "let globalThis" to avoid shadowing.
-  if (typeof globalThis === 'object') {
-    return globalThis;
-  }
-  if (typeof self === 'object') {
-    return self;
-  }
-  if (typeof window === 'object') {
-    return window;
-  }
-  if (typeof global === 'object') {
-    return global;
-  }
-  return this;
-})();

package/core/utils/keycodes.js

@@ -1,172 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Constant declarations for common key codes.
- * These methods are not specific to Blockly, and could be factored out into
- * a JavaScript framework such as Closure.
- */
-'use strict';
-
-/**
- * Constant declarations for common key codes.
- * These methods are not specific to Blockly, and could be factored out into
- * a JavaScript framework such as Closure.
- * @namespace Blockly.utils.KeyCodes
- */
-goog.module('Blockly.utils.KeyCodes');
-
-
-/**
- * Key codes for common characters.
- *
- * Copied from Closure's goog.events.KeyCodes
- *
- * This list is not localized and therefore some of the key codes are not
- * correct for non US keyboard layouts. See comments below.
- *
- * @enum {number}
- * @alias Blockly.utils.KeyCodes
- */
-const KeyCodes = {
-  WIN_KEY_FF_LINUX: 0,
-  MAC_ENTER: 3,
-  BACKSPACE: 8,
-  TAB: 9,
-  NUM_CENTER: 12,  // NUMLOCK on FF/Safari Mac
-  ENTER: 13,
-  SHIFT: 16,
-  CTRL: 17,
-  ALT: 18,
-  PAUSE: 19,
-  CAPS_LOCK: 20,
-  ESC: 27,
-  SPACE: 32,
-  PAGE_UP: 33,    // also NUM_NORTH_EAST
-  PAGE_DOWN: 34,  // also NUM_SOUTH_EAST
-  END: 35,        // also NUM_SOUTH_WEST
-  HOME: 36,       // also NUM_NORTH_WEST
-  LEFT: 37,       // also NUM_WEST
-  UP: 38,         // also NUM_NORTH
-  RIGHT: 39,      // also NUM_EAST
-  DOWN: 40,       // also NUM_SOUTH
-  PLUS_SIGN: 43,  // NOT numpad plus
-  PRINT_SCREEN: 44,
-  INSERT: 45,  // also NUM_INSERT
-  DELETE: 46,  // also NUM_DELETE
-  ZERO: 48,
-  ONE: 49,
-  TWO: 50,
-  THREE: 51,
-  FOUR: 52,
-  FIVE: 53,
-  SIX: 54,
-  SEVEN: 55,
-  EIGHT: 56,
-  NINE: 57,
-  FF_SEMICOLON: 59,  // Firefox (Gecko) fires this for semicolon instead of 186
-  FF_EQUALS: 61,     // Firefox (Gecko) fires this for equals instead of 187
-  FF_DASH: 173,      // Firefox (Gecko) fires this for dash instead of 189
-  // Firefox (Gecko) fires this for # on UK keyboards, rather than
-  // Shift+SINGLE_QUOTE.
-  FF_HASH: 163,
-  QUESTION_MARK: 63,  // needs localization
-  AT_SIGN: 64,
-  A: 65,
-  B: 66,
-  C: 67,
-  D: 68,
-  E: 69,
-  F: 70,
-  G: 71,
-  H: 72,
-  I: 73,
-  J: 74,
-  K: 75,
-  L: 76,
-  M: 77,
-  N: 78,
-  O: 79,
-  P: 80,
-  Q: 81,
-  R: 82,
-  S: 83,
-  T: 84,
-  U: 85,
-  V: 86,
-  W: 87,
-  X: 88,
-  Y: 89,
-  Z: 90,
-  META: 91,  // WIN_KEY_LEFT
-  WIN_KEY_RIGHT: 92,
-  CONTEXT_MENU: 93,
-  NUM_ZERO: 96,
-  NUM_ONE: 97,
-  NUM_TWO: 98,
-  NUM_THREE: 99,
-  NUM_FOUR: 100,
-  NUM_FIVE: 101,
-  NUM_SIX: 102,
-  NUM_SEVEN: 103,
-  NUM_EIGHT: 104,
-  NUM_NINE: 105,
-  NUM_MULTIPLY: 106,
-  NUM_PLUS: 107,
-  NUM_MINUS: 109,
-  NUM_PERIOD: 110,
-  NUM_DIVISION: 111,
-  F1: 112,
-  F2: 113,
-  F3: 114,
-  F4: 115,
-  F5: 116,
-  F6: 117,
-  F7: 118,
-  F8: 119,
-  F9: 120,
-  F10: 121,
-  F11: 122,
-  F12: 123,
-  NUMLOCK: 144,
-  SCROLL_LOCK: 145,
-
-  // OS-specific media keys like volume controls and browser controls.
-  FIRST_MEDIA_KEY: 166,
-  LAST_MEDIA_KEY: 183,
-
-  SEMICOLON: 186,             // needs localization
-  DASH: 189,                  // needs localization
-  EQUALS: 187,                // needs localization
-  COMMA: 188,                 // needs localization
-  PERIOD: 190,                // needs localization
-  SLASH: 191,                 // needs localization
-  APOSTROPHE: 192,            // needs localization
-  TILDE: 192,                 // needs localization
-  SINGLE_QUOTE: 222,          // needs localization
-  OPEN_SQUARE_BRACKET: 219,   // needs localization
-  BACKSLASH: 220,             // needs localization
-  CLOSE_SQUARE_BRACKET: 221,  // needs localization
-  WIN_KEY: 224,
-  MAC_FF_META:
-      224,  // Firefox (Gecko) fires this for the meta key instead of 91
-  MAC_WK_CMD_LEFT: 91,   // WebKit Left Command key fired, same as META
-  MAC_WK_CMD_RIGHT: 93,  // WebKit Right Command key fired, different from META
-  WIN_IME: 229,
-
-  // "Reserved for future use". Some programs (e.g. the SlingPlayer 2.4 ActiveX
-  // control) fire this as a hacky way to disable screensavers.
-  VK_NONAME: 252,
-
-  // We've seen users whose machines fire this keycode at regular one
-  // second intervals. The common thread among these users is that
-  // they're all using Dell Inspiron laptops, so we suspect that this
-  // indicates a hardware/bios problem.
-  // http://en.community.dell.com/support-forums/laptop/f/3518/p/19285957/19523128.aspx
-  PHANTOM: 255,
-};
-
-exports.KeyCodes = KeyCodes;