scratch-blocks 1.1.206 → 2.0.0-beta.1

package/core/connection_db.js

@@ -1,300 +0,0 @@
-/**
- * @license
- * Visual Blocks Editor
- *
- * Copyright 2011 Google Inc.
- * https://developers.google.com/blockly/
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-/**
- * @fileoverview Components for managing connections between blocks.
- * @author fraser@google.com (Neil Fraser)
- */
-'use strict';
-
-goog.provide('Blockly.ConnectionDB');
-
-goog.require('Blockly.Connection');
-
-
-/**
- * Database of connections.
- * Connections are stored in order of their vertical component.  This way
- * connections in an area may be looked up quickly using a binary search.
- * @constructor
- */
-Blockly.ConnectionDB = function() {
-  /**
-   * Array of connections sorted by y coordinate.
-   * @type {!Array.<!Blockly.Connection>}
-   * @private
-   */
-  this.connections_ = [];
-};
-
-/**
- * Add a connection to the database.  Must not already exist in DB.
- * @param {!Blockly.Connection} connection The connection to be added.
- */
-Blockly.ConnectionDB.prototype.addConnection = function(connection) {
-  if (connection.inDB_) {
-    throw Error('Connection already in database.');
-  }
-  if (connection.getSourceBlock().isInFlyout) {
-    // Don't bother maintaining a database of connections in a flyout.
-    return;
-  }
-  var position = this.findPositionForConnection_(connection);
-  this.connections_.splice(position, 0, connection);
-  connection.inDB_ = true;
-};
-
-/**
- * Find the given connection.
- * Starts by doing a binary search to find the approximate location, then
- *     linearly searches nearby for the exact connection.
- * @param {!Blockly.Connection} conn The connection to find.
- * @return {number} The index of the connection, or -1 if the connection was
- *     not found.
- */
-Blockly.ConnectionDB.prototype.findConnection = function(conn) {
-  if (!this.connections_.length) {
-    return -1;
-  }
-
-  var bestGuess = this.findPositionForConnection_(conn);
-  if (bestGuess >= this.connections_.length) {
-    // Not in list
-    return -1;
-  }
-
-  var yPos = conn.y_;
-  // Walk forward and back on the y axis looking for the connection.
-  var pointerMin = bestGuess;
-  var pointerMax = bestGuess;
-  while (pointerMin >= 0 && this.connections_[pointerMin].y_ == yPos) {
-    if (this.connections_[pointerMin] == conn) {
-      return pointerMin;
-    }
-    pointerMin--;
-  }
-
-  while (pointerMax < this.connections_.length &&
-         this.connections_[pointerMax].y_ == yPos) {
-    if (this.connections_[pointerMax] == conn) {
-      return pointerMax;
-    }
-    pointerMax++;
-  }
-  return -1;
-};
-
-/**
- * Finds a candidate position for inserting this connection into the list.
- * This will be in the correct y order but makes no guarantees about ordering in
- *     the x axis.
- * @param {!Blockly.Connection} connection The connection to insert.
- * @return {number} The candidate index.
- * @private
- */
-Blockly.ConnectionDB.prototype.findPositionForConnection_ = function(
-    connection) {
-  if (!this.connections_.length) {
-    return 0;
-  }
-  var pointerMin = 0;
-  var pointerMax = this.connections_.length;
-  while (pointerMin < pointerMax) {
-    var pointerMid = Math.floor((pointerMin + pointerMax) / 2);
-    if (this.connections_[pointerMid].y_ < connection.y_) {
-      pointerMin = pointerMid + 1;
-    } else if (this.connections_[pointerMid].y_ > connection.y_) {
-      pointerMax = pointerMid;
-    } else {
-      pointerMin = pointerMid;
-      break;
-    }
-  }
-  return pointerMin;
-};
-
-/**
- * Remove a connection from the database.  Must already exist in DB.
- * @param {!Blockly.Connection} connection The connection to be removed.
- * @private
- */
-Blockly.ConnectionDB.prototype.removeConnection_ = function(connection) {
-  if (!connection.inDB_) {
-    throw Error('Connection not in database.');
-  }
-  var removalIndex = this.findConnection(connection);
-  if (removalIndex == -1) {
-    throw Error('Unable to find connection in connectionDB.');
-  }
-  connection.inDB_ = false;
-  this.connections_.splice(removalIndex, 1);
-};
-
-/**
- * Find all nearby connections to the given connection.
- * Type checking does not apply, since this function is used for bumping.
- * @param {!Blockly.Connection} connection The connection whose neighbours
- *     should be returned.
- * @param {number} maxRadius The maximum radius to another connection.
- * @return {!Array.<Blockly.Connection>} List of connections.
- */
-Blockly.ConnectionDB.prototype.getNeighbours = function(connection, maxRadius) {
-  var db = this.connections_;
-  var currentX = connection.x_;
-  var currentY = connection.y_;
-
-  // Binary search to find the closest y location.
-  var pointerMin = 0;
-  var pointerMax = db.length - 2;
-  var pointerMid = pointerMax;
-  while (pointerMin < pointerMid) {
-    if (db[pointerMid].y_ < currentY) {
-      pointerMin = pointerMid;
-    } else {
-      pointerMax = pointerMid;
-    }
-    pointerMid = Math.floor((pointerMin + pointerMax) / 2);
-  }
-
-  var neighbours = [];
-  /**
-   * Computes if the current connection is within the allowed radius of another
-   * connection.
-   * This function is a closure and has access to outside variables.
-   * @param {number} yIndex The other connection's index in the database.
-   * @return {boolean} True if the current connection's vertical distance from
-   *     the other connection is less than the allowed radius.
-   */
-  function checkConnection_(yIndex) {
-    var dx = currentX - db[yIndex].x_;
-    var dy = currentY - db[yIndex].y_;
-    var r = Math.sqrt(dx * dx + dy * dy);
-    if (r <= maxRadius) {
-      neighbours.push(db[yIndex]);
-    }
-    return dy < maxRadius;
-  }
-
-  // Walk forward and back on the y axis looking for the closest x,y point.
-  pointerMin = pointerMid;
-  pointerMax = pointerMid;
-  if (db.length) {
-    while (pointerMin >= 0 && checkConnection_(pointerMin)) {
-      pointerMin--;
-    }
-    do {
-      pointerMax++;
-    } while (pointerMax < db.length && checkConnection_(pointerMax));
-  }
-
-  return neighbours;
-};
-
-
-/**
- * Is the candidate connection close to the reference connection.
- * Extremely fast; only looks at Y distance.
- * @param {number} index Index in database of candidate connection.
- * @param {number} baseY Reference connection's Y value.
- * @param {number} maxRadius The maximum radius to another connection.
- * @return {boolean} True if connection is in range.
- * @private
- */
-Blockly.ConnectionDB.prototype.isInYRange_ = function(index, baseY, maxRadius) {
-  return (Math.abs(this.connections_[index].y_ - baseY) <= maxRadius);
-};
-
-/**
- * Find the closest compatible connection to this connection.
- * @param {!Blockly.Connection} conn The connection searching for a compatible
- *     mate.
- * @param {number} maxRadius The maximum radius to another connection.
- * @param {!goog.math.Coordinate} dxy Offset between this connection's location
- *     in the database and the current location (as a result of dragging).
- * @return {!{connection: ?Blockly.Connection, radius: number}} Contains two
- *     properties:' connection' which is either another connection or null,
- *     and 'radius' which is the distance.
- */
-Blockly.ConnectionDB.prototype.searchForClosest = function(conn, maxRadius,
-    dxy) {
-  // Don't bother.
-  if (!this.connections_.length) {
-    return {connection: null, radius: maxRadius};
-  }
-
-  // Stash the values of x and y from before the drag.
-  var baseY = conn.y_;
-  var baseX = conn.x_;
-
-  conn.x_ = baseX + dxy.x;
-  conn.y_ = baseY + dxy.y;
-
-  // findPositionForConnection finds an index for insertion, which is always
-  // after any block with the same y index.  We want to search both forward
-  // and back, so search on both sides of the index.
-  var closestIndex = this.findPositionForConnection_(conn);
-
-  var bestConnection = null;
-  var bestRadius = maxRadius;
-  var temp;
-
-  // Walk forward and back on the y axis looking for the closest x,y point.
-  var pointerMin = closestIndex - 1;
-  while (pointerMin >= 0 && this.isInYRange_(pointerMin, conn.y_, maxRadius)) {
-    temp = this.connections_[pointerMin];
-    if (conn.isConnectionAllowed(temp, bestRadius)) {
-      bestConnection = temp;
-      bestRadius = temp.distanceFrom(conn);
-    }
-    pointerMin--;
-  }
-
-  var pointerMax = closestIndex;
-  while (pointerMax < this.connections_.length &&
-      this.isInYRange_(pointerMax, conn.y_, maxRadius)) {
-    temp = this.connections_[pointerMax];
-    if (conn.isConnectionAllowed(temp, bestRadius)) {
-      bestConnection = temp;
-      bestRadius = temp.distanceFrom(conn);
-    }
-    pointerMax++;
-  }
-
-  // Reset the values of x and y.
-  conn.x_ = baseX;
-  conn.y_ = baseY;
-
-  // If there were no valid connections, bestConnection will be null.
-  return {connection: bestConnection, radius: bestRadius};
-};
-
-/**
- * Initialize a set of connection DBs for a specified workspace.
- * @param {!Blockly.Workspace} workspace The workspace this DB is for.
- */
-Blockly.ConnectionDB.init = function(workspace) {
-  // Create four databases, one for each connection type.
-  var dbList = [];
-  dbList[Blockly.INPUT_VALUE] = new Blockly.ConnectionDB();
-  dbList[Blockly.OUTPUT_VALUE] = new Blockly.ConnectionDB();
-  dbList[Blockly.NEXT_STATEMENT] = new Blockly.ConnectionDB();
-  dbList[Blockly.PREVIOUS_STATEMENT] = new Blockly.ConnectionDB();
-  workspace.connectionDBList = dbList;
-};

package/core/constants.js

@@ -1,387 +0,0 @@
-/**
- * @license
- * Visual Blocks Editor
- *
- * Copyright 2016 Google Inc.
- * https://developers.google.com/blockly/
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-/**
- * @fileoverview Blockly constants.
- * @author fenichel@google.com (Rachel Fenichel)
- */
-'use strict';
-
-goog.provide('Blockly.constants');
-
-
-/**
- * Number of pixels the mouse must move before a drag starts.
- */
-Blockly.DRAG_RADIUS = 3;
-
-/**
- * Number of pixels the mouse must move before a drag/scroll starts from the
- * flyout.  Because the drag-intention is determined when this is reached, it is
- * larger than Blockly.DRAG_RADIUS so that the drag-direction is clearer.
- */
-Blockly.FLYOUT_DRAG_RADIUS = 10;
-
-/**
- * Maximum misalignment between connections for them to snap together.
- */
-Blockly.SNAP_RADIUS = 48;
-
-/**
- * Maximum misalignment between connections for them to snap together,
- * when a connection is already highlighted.
- */
-Blockly.CONNECTING_SNAP_RADIUS = 68;
-
-/**
- * How much to prefer staying connected to the current connection over moving to
- * a new connection.  The current previewed connection is considered to be this
- * much closer to the matching connection on the block than it actually is.
- */
-Blockly.CURRENT_CONNECTION_PREFERENCE = 20;
-
-/**
- * Delay in ms between trigger and bumping unconnected block out of alignment.
- */
-Blockly.BUMP_DELAY = 0;
-
-/**
- * Number of characters to truncate a collapsed block to.
- */
-Blockly.COLLAPSE_CHARS = 30;
-
-/**
- * Length in ms for a touch to become a long press.
- */
-Blockly.LONGPRESS = 750;
-
-/**
- * Distance to scroll when a mouse wheel event is received and its delta mode
- * is line (0x1) instead of pixel (0x0). In these cases, a single "scroll" has
- * a delta of 1, which makes the workspace scroll very slowly (just one pixel).
- * To compensate, that delta is multiplied by this value.
- * @const
- * @package
- */
-Blockly.LINE_SCROLL_MULTIPLIER = 15;
-
-/**
- * Prevent a sound from playing if another sound preceded it within this many
- * milliseconds.
- */
-Blockly.SOUND_LIMIT = 100;
-
-/**
- * When dragging a block out of a stack, split the stack in two (true), or drag
- * out the block healing the stack (false).
- */
-Blockly.DRAG_STACK = true;
-
-/**
- * The richness of block colours, regardless of the hue.
- * Must be in the range of 0 (inclusive) to 1 (exclusive).
- */
-Blockly.HSV_SATURATION = 0.45;
-
-/**
- * The intensity of block colours, regardless of the hue.
- * Must be in the range of 0 (inclusive) to 1 (exclusive).
- */
-Blockly.HSV_VALUE = 0.65;
-
-/**
- * Sprited icons and images.
- */
-Blockly.SPRITE = {
-  width: 96,
-  height: 124,
-  url: 'sprites.png'
-};
-
-// Constants below this point are not intended to be changed.
-
-/**
- * Required name space for SVG elements.
- * @const
- */
-Blockly.SVG_NS = 'http://www.w3.org/2000/svg';
-
-/**
- * Required name space for HTML elements.
- * @const
- */
-Blockly.HTML_NS = 'http://www.w3.org/1999/xhtml';
-
-/**
- * ENUM for a right-facing value input.  E.g. 'set item to' or 'return'.
- * @const
- */
-Blockly.INPUT_VALUE = 1;
-
-/**
- * ENUM for a left-facing value output.  E.g. 'random fraction'.
- * @const
- */
-Blockly.OUTPUT_VALUE = 2;
-
-/**
- * ENUM for a down-facing block stack.  E.g. 'if-do' or 'else'.
- * @const
- */
-Blockly.NEXT_STATEMENT = 3;
-
-/**
- * ENUM for an up-facing block stack.  E.g. 'break out of loop'.
- * @const
- */
-Blockly.PREVIOUS_STATEMENT = 4;
-
-/**
- * ENUM for an dummy input.  Used to add field(s) with no input.
- * @const
- */
-Blockly.DUMMY_INPUT = 5;
-
-/**
- * ENUM for left alignment.
- * @const
- */
-Blockly.ALIGN_LEFT = -1;
-
-/**
- * ENUM for centre alignment.
- * @const
- */
-Blockly.ALIGN_CENTRE = 0;
-
-/**
- * ENUM for right alignment.
- * @const
- */
-Blockly.ALIGN_RIGHT = 1;
-
-/**
- * ENUM for no drag operation.
- * @const
- */
-Blockly.DRAG_NONE = 0;
-
-/**
- * ENUM for inside the sticky DRAG_RADIUS.
- * @const
- */
-Blockly.DRAG_STICKY = 1;
-
-/**
- * ENUM for inside the non-sticky DRAG_RADIUS, for differentiating between
- * clicks and drags.
- * @const
- */
-Blockly.DRAG_BEGIN = 1;
-
-/**
- * ENUM for freely draggable (outside the DRAG_RADIUS, if one applies).
- * @const
- */
-Blockly.DRAG_FREE = 2;
-
-/**
- * Lookup table for determining the opposite type of a connection.
- * @const
- */
-Blockly.OPPOSITE_TYPE = [];
-Blockly.OPPOSITE_TYPE[Blockly.INPUT_VALUE] = Blockly.OUTPUT_VALUE;
-Blockly.OPPOSITE_TYPE[Blockly.OUTPUT_VALUE] = Blockly.INPUT_VALUE;
-Blockly.OPPOSITE_TYPE[Blockly.NEXT_STATEMENT] = Blockly.PREVIOUS_STATEMENT;
-Blockly.OPPOSITE_TYPE[Blockly.PREVIOUS_STATEMENT] = Blockly.NEXT_STATEMENT;
-
-/**
- * ENUM for toolbox and flyout at top of screen.
- * @const
- */
-Blockly.TOOLBOX_AT_TOP = 0;
-
-/**
- * ENUM for toolbox and flyout at bottom of screen.
- * @const
- */
-Blockly.TOOLBOX_AT_BOTTOM = 1;
-
-/**
- * ENUM for toolbox and flyout at left of screen.
- * @const
- */
-Blockly.TOOLBOX_AT_LEFT = 2;
-
-/**
- * ENUM for toolbox and flyout at right of screen.
- * @const
- */
-Blockly.TOOLBOX_AT_RIGHT = 3;
-
-/**
- * ENUM for output shape: hexagonal (booleans/predicates).
- * @const
- */
-Blockly.OUTPUT_SHAPE_HEXAGONAL = 1;
-
-/**
- * ENUM for output shape: rounded (numbers).
- * @const
- */
-Blockly.OUTPUT_SHAPE_ROUND = 2;
-
-/**
- * ENUM for output shape: squared (any/all values; strings).
- * @const
- */
-Blockly.OUTPUT_SHAPE_SQUARE = 3;
-
-/**
- * ENUM for categories.
- * @const
- */
-Blockly.Categories = {
-  "motion": "motion",
-  "looks": "looks",
-  "sound": "sounds",
-  "pen": "pen",
-  "data": "data",
-  "dataLists": "data-lists",
-  "event": "events",
-  "control": "control",
-  "sensing": "sensing",
-  "operators": "operators",
-  "more": "more"
-};
-
-/**
- * ENUM representing that an event is not in any delete areas.
- * Null for backwards compatibility reasons.
- * @const
- */
-Blockly.DELETE_AREA_NONE = null;
-
-/**
- * ENUM representing that an event is in the delete area of the trash can.
- * @const
- */
-Blockly.DELETE_AREA_TRASH = 1;
-
-/**
- * ENUM representing that an event is in the delete area of the toolbox or
- * flyout.
- * @const
- */
-Blockly.DELETE_AREA_TOOLBOX = 2;
-
-/**
- * String for use in the "custom" attribute of a category in toolbox xml.
- * This string indicates that the category should be dynamically populated with
- * variable blocks.
- * @const {string}
- */
-Blockly.VARIABLE_CATEGORY_NAME = 'VARIABLE';
-
-/**
- * String for use in the "custom" attribute of a category in toolbox xml.
- * This string indicates that the category should be dynamically populated with
- * procedure blocks.
- * @const {string}
- */
-Blockly.PROCEDURE_CATEGORY_NAME = 'PROCEDURE';
-
-/**
- * String for use in the dropdown created in field_variable.
- * This string indicates that this option in the dropdown is 'Rename
- * variable...' and if selected, should trigger the prompt to rename a variable.
- * @const {string}
- */
-Blockly.RENAME_VARIABLE_ID = 'RENAME_VARIABLE_ID';
-
-/**
- * String for use in the dropdown created in field_variable.
- * This string indicates that this option in the dropdown is 'Delete the "%1"
- * variable' and if selected, should trigger the prompt to delete a variable.
- * @const {string}
- */
-Blockly.DELETE_VARIABLE_ID = 'DELETE_VARIABLE_ID';
-
-/**
- * String for use in the dropdown created in field_variable,
- * specifically for broadcast messages.
- * This string indicates that this option in the dropdown is 'New message...'
- * and if selected, should trigger the prompt to create a new message.
- * @const {string}
- */
-Blockly.NEW_BROADCAST_MESSAGE_ID = 'NEW_BROADCAST_MESSAGE_ID';
-
-/**
- * String representing the variable type of broadcast message blocks.
- * This string, for use in differentiating between types of variables,
- * indicates that the current variable is a broadcast message.
- * @const {string}
- */
-Blockly.BROADCAST_MESSAGE_VARIABLE_TYPE = 'broadcast_msg';
-
-/**
- * String representing the variable type of list blocks.
- * This string, for use in differentiating between types of variables,
- * indicates that the current variable is a list.
- * @const {string}
- */
-Blockly.LIST_VARIABLE_TYPE = 'list';
-
-// TODO (#1251) Replace '' below with 'scalar', and start using this constant
-// everywhere.
-/**
- * String representing the variable type of scalar variables.
- * This string, for use in differentiating between types of variables,
- * indicates that the current variable is a scalar variable.
- * @const {string}
- */
-Blockly.SCALAR_VARIABLE_TYPE = '';
-
-/**
- * The type of all procedure definition blocks.
- * @const {string}
- */
-Blockly.PROCEDURES_DEFINITION_BLOCK_TYPE = 'procedures_definition';
-
-/**
- * The type of all procedure prototype blocks.
- * @const {string}
- */
-Blockly.PROCEDURES_PROTOTYPE_BLOCK_TYPE = 'procedures_prototype';
-
-/**
- * The type of all procedure call blocks.
- * @const {string}
- */
-Blockly.PROCEDURES_CALL_BLOCK_TYPE = 'procedures_call';
-
-/**
- * ENUM for flyout status button states.
- * @const
- */
-Blockly.StatusButtonState = {
-  "READY": "ready",
-  "NOT_READY": "not ready",
-};