blockly 8.20220331.0-beta.0 → 9.0.0-beta.1

package/core/events/events_block_delete.js

@@ -1,139 +0,0 @@
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Class for a block delete event.
- */
-'use strict';
-
-/**
- * Class for a block delete event.
- * @class
- */
-goog.module('Blockly.Events.BlockDelete');
-
-const Xml = goog.require('Blockly.Xml');
-const blocks = goog.require('Blockly.serialization.blocks');
-const eventUtils = goog.require('Blockly.Events.utils');
-const registry = goog.require('Blockly.registry');
-const {BlockBase} = goog.require('Blockly.Events.BlockBase');
-/* eslint-disable-next-line no-unused-vars */
-const {Block} = goog.requireType('Blockly.Block');
-
-
-/**
- * Class for a block deletion event.
- * @extends {BlockBase}
- * @alias Blockly.Events.BlockDelete
- */
-class BlockDelete extends BlockBase {
-  /**
-   * @param {!Block=} opt_block The deleted block.  Undefined for a blank
-   *     event.
-   */
-  constructor(opt_block) {
-    super(opt_block);
-
-    /**
-     * Type of this event.
-     * @type {string}
-     */
-    this.type = eventUtils.BLOCK_DELETE;
-
-    if (!opt_block) {
-      return;  // Blank event to be populated by fromJson.
-    }
-    if (opt_block.getParent()) {
-      throw Error('Connected blocks cannot be deleted.');
-    }
-    if (opt_block.isShadow()) {
-      // Respawning shadow blocks is handled via disconnection.
-      this.recordUndo = false;
-    }
-
-    this.oldXml = Xml.blockToDomWithXY(opt_block);
-    this.ids = eventUtils.getDescendantIds(opt_block);
-
-    /**
-     * Was the block that was just deleted a shadow?
-     * @type {boolean}
-     */
-    this.wasShadow = opt_block.isShadow();
-
-    /**
-     * Play UI effects (sound and animation)?
-     * @type {boolean}
-     */
-    this.ui = true;
-
-    /**
-     * JSON representation of the block that was just deleted.
-     * @type {!blocks.State}
-     */
-    this.oldJson = /** @type {!blocks.State} */ (
-        blocks.save(opt_block, {addCoordinates: true}));
-  }
-
-  /**
-   * Encode the event as JSON.
-   * @return {!Object} JSON representation.
-   */
-  toJson() {
-    const json = super.toJson();
-    json['oldXml'] = Xml.domToText(this.oldXml);
-    json['ids'] = this.ids;
-    json['wasShadow'] = this.wasShadow;
-    json['oldJson'] = this.oldJson;
-    json['ui'] = this.ui;
-    if (!this.recordUndo) {
-      json['recordUndo'] = this.recordUndo;
-    }
-    return json;
-  }
-
-  /**
-   * Decode the JSON event.
-   * @param {!Object} json JSON representation.
-   */
-  fromJson(json) {
-    super.fromJson(json);
-    this.oldXml = Xml.textToDom(json['oldXml']);
-    this.ids = json['ids'];
-    this.wasShadow =
-        json['wasShadow'] || this.oldXml.tagName.toLowerCase() === 'shadow';
-    this.oldJson = /** @type {!blocks.State} */ (json['oldJson']);
-    this.ui = !!json['ui'];
-    if (json['recordUndo'] !== undefined) {
-      this.recordUndo = json['recordUndo'];
-    }
-  }
-
-  /**
-   * Run a deletion event.
-   * @param {boolean} forward True if run forward, false if run backward (undo).
-   */
-  run(forward) {
-    const workspace = this.getEventWorkspace_();
-    if (forward) {
-      for (let i = 0; i < this.ids.length; i++) {
-        const id = this.ids[i];
-        const block = workspace.getBlockById(id);
-        if (block) {
-          block.dispose(false, this.ui);
-        } else if (id === this.blockId) {
-          // Only complain about root-level block.
-          console.warn('Can\'t delete non-existent block: ' + id);
-        }
-      }
-    } else {
-      blocks.append(this.oldJson, workspace);
-    }
-  }
-}
-
-registry.register(registry.Type.EVENT, eventUtils.DELETE, BlockDelete);
-
-exports.BlockDelete = BlockDelete;

package/core/events/events_block_drag.js

@@ -1,89 +0,0 @@
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Events fired as a block drag.
- */
-'use strict';
-
-/**
- * Events fired as a block drag.
- * @class
- */
-goog.module('Blockly.Events.BlockDrag');
-
-const eventUtils = goog.require('Blockly.Events.utils');
-const registry = goog.require('Blockly.registry');
-/* eslint-disable-next-line no-unused-vars */
-const {Block} = goog.requireType('Blockly.Block');
-const {UiBase} = goog.require('Blockly.Events.UiBase');
-
-
-/**
- * Class for a block drag event.
- * @extends {UiBase}
- * @alias Blockly.Events.BlockDrag
- */
-class BlockDrag extends UiBase {
-  /**
-   * @param {!Block=} opt_block The top block in the stack that is being
-   *    dragged. Undefined for a blank event.
-   * @param {boolean=} opt_isStart Whether this is the start of a block drag.
-   *    Undefined for a blank event.
-   * @param {!Array<!Block>=} opt_blocks The blocks affected by this
-   *    drag. Undefined for a blank event.
-   */
-  constructor(opt_block, opt_isStart, opt_blocks) {
-    const workspaceId = opt_block ? opt_block.workspace.id : undefined;
-    super(workspaceId);
-    this.blockId = opt_block ? opt_block.id : null;
-
-    /**
-     * Whether this is the start of a block drag.
-     * @type {boolean|undefined}
-     */
-    this.isStart = opt_isStart;
-
-    /**
-     * The blocks affected by this drag event.
-     * @type {!Array<!Block>|undefined}
-     */
-    this.blocks = opt_blocks;
-
-    /**
-     * Type of this event.
-     * @type {string}
-     */
-    this.type = eventUtils.BLOCK_DRAG;
-  }
-
-  /**
-   * Encode the event as JSON.
-   * @return {!Object} JSON representation.
-   */
-  toJson() {
-    const json = super.toJson();
-    json['isStart'] = this.isStart;
-    json['blockId'] = this.blockId;
-    json['blocks'] = this.blocks;
-    return json;
-  }
-
-  /**
-   * Decode the JSON event.
-   * @param {!Object} json JSON representation.
-   */
-  fromJson(json) {
-    super.fromJson(json);
-    this.isStart = json['isStart'];
-    this.blockId = json['blockId'];
-    this.blocks = json['blocks'];
-  }
-}
-
-registry.register(registry.Type.EVENT, eventUtils.BLOCK_DRAG, BlockDrag);
-
-exports.BlockDrag = BlockDrag;

package/core/events/events_block_move.js

@@ -1,202 +0,0 @@
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Class for a block move event.
- */
-'use strict';
-
-/**
- * Class for a block move event.
- * @class
- */
-goog.module('Blockly.Events.BlockMove');
-
-const eventUtils = goog.require('Blockly.Events.utils');
-const registry = goog.require('Blockly.registry');
-const {BlockBase} = goog.require('Blockly.Events.BlockBase');
-/* eslint-disable-next-line no-unused-vars */
-const {Block} = goog.requireType('Blockly.Block');
-const {ConnectionType} = goog.require('Blockly.ConnectionType');
-const {Coordinate} = goog.require('Blockly.utils.Coordinate');
-
-
-/**
- * Class for a block move event.  Created before the move.
- * @extends {BlockBase}
- * @alias Blockly.Events.BlockMove
- */
-class BlockMove extends BlockBase {
-  /**
-   * @param {!Block=} opt_block The moved block.  Undefined for a blank
-   *     event.
-   */
-  constructor(opt_block) {
-    super(opt_block);
-
-    /**
-     * Type of this event.
-     * @type {string}
-     */
-    this.type = eventUtils.BLOCK_MOVE;
-
-    if (!opt_block) {
-      return;  // Blank event to be populated by fromJson.
-    }
-    if (opt_block.isShadow()) {
-      // Moving shadow blocks is handled via disconnection.
-      this.recordUndo = false;
-    }
-
-    const location = this.currentLocation_();
-    this.oldParentId = location.parentId;
-    this.oldInputName = location.inputName;
-    this.oldCoordinate = location.coordinate;
-
-    this.newParentId = null;
-    this.newInputName = null;
-    this.newCoordinate = null;
-  }
-
-  /**
-   * Encode the event as JSON.
-   * @return {!Object} JSON representation.
-   */
-  toJson() {
-    const json = super.toJson();
-    if (this.newParentId) {
-      json['newParentId'] = this.newParentId;
-    }
-    if (this.newInputName) {
-      json['newInputName'] = this.newInputName;
-    }
-    if (this.newCoordinate) {
-      json['newCoordinate'] = Math.round(this.newCoordinate.x) + ',' +
-          Math.round(this.newCoordinate.y);
-    }
-    if (!this.recordUndo) {
-      json['recordUndo'] = this.recordUndo;
-    }
-    return json;
-  }
-
-  /**
-   * Decode the JSON event.
-   * @param {!Object} json JSON representation.
-   */
-  fromJson(json) {
-    super.fromJson(json);
-    this.newParentId = json['newParentId'];
-    this.newInputName = json['newInputName'];
-    if (json['newCoordinate']) {
-      const xy = json['newCoordinate'].split(',');
-      this.newCoordinate = new Coordinate(Number(xy[0]), Number(xy[1]));
-    }
-    if (json['recordUndo'] !== undefined) {
-      this.recordUndo = json['recordUndo'];
-    }
-  }
-
-  /**
-   * Record the block's new location.  Called after the move.
-   */
-  recordNew() {
-    const location = this.currentLocation_();
-    this.newParentId = location.parentId;
-    this.newInputName = location.inputName;
-    this.newCoordinate = location.coordinate;
-  }
-
-  /**
-   * Returns the parentId and input if the block is connected,
-   *   or the XY location if disconnected.
-   * @return {!Object} Collection of location info.
-   * @private
-   */
-  currentLocation_() {
-    const workspace = this.getEventWorkspace_();
-    const block = workspace.getBlockById(this.blockId);
-    const location = {};
-    const parent = block.getParent();
-    if (parent) {
-      location.parentId = parent.id;
-      const input = parent.getInputWithBlock(block);
-      if (input) {
-        location.inputName = input.name;
-      }
-    } else {
-      location.coordinate = block.getRelativeToSurfaceXY();
-    }
-    return location;
-  }
-
-  /**
-   * Does this event record any change of state?
-   * @return {boolean} False if something changed.
-   */
-  isNull() {
-    return this.oldParentId === this.newParentId &&
-        this.oldInputName === this.newInputName &&
-        Coordinate.equals(this.oldCoordinate, this.newCoordinate);
-  }
-
-  /**
-   * Run a move event.
-   * @param {boolean} forward True if run forward, false if run backward (undo).
-   */
-  run(forward) {
-    const workspace = this.getEventWorkspace_();
-    const block = workspace.getBlockById(this.blockId);
-    if (!block) {
-      console.warn('Can\'t move non-existent block: ' + this.blockId);
-      return;
-    }
-    const parentId = forward ? this.newParentId : this.oldParentId;
-    const inputName = forward ? this.newInputName : this.oldInputName;
-    const coordinate = forward ? this.newCoordinate : this.oldCoordinate;
-    let parentBlock;
-    if (parentId) {
-      parentBlock = workspace.getBlockById(parentId);
-      if (!parentBlock) {
-        console.warn('Can\'t connect to non-existent block: ' + parentId);
-        return;
-      }
-    }
-    if (block.getParent()) {
-      block.unplug();
-    }
-    if (coordinate) {
-      const xy = block.getRelativeToSurfaceXY();
-      block.moveBy(coordinate.x - xy.x, coordinate.y - xy.y);
-    } else {
-      let blockConnection = block.outputConnection;
-      if (!blockConnection ||
-          (block.previousConnection &&
-           block.previousConnection.isConnected())) {
-        blockConnection = block.previousConnection;
-      }
-      let parentConnection;
-      const connectionType = blockConnection.type;
-      if (inputName) {
-        const input = parentBlock.getInput(inputName);
-        if (input) {
-          parentConnection = input.connection;
-        }
-      } else if (connectionType === ConnectionType.PREVIOUS_STATEMENT) {
-        parentConnection = parentBlock.nextConnection;
-      }
-      if (parentConnection) {
-        blockConnection.connect(parentConnection);
-      } else {
-        console.warn('Can\'t connect to non-existent input: ' + inputName);
-      }
-    }
-  }
-}
-
-registry.register(registry.Type.EVENT, eventUtils.MOVE, BlockMove);
-
-exports.BlockMove = BlockMove;

package/core/events/events_bubble_open.js

@@ -1,90 +0,0 @@
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Events fired as a result of bubble open.
- */
-'use strict';
-
-/**
- * Events fired as a result of bubble open.
- * @class
- */
-goog.module('Blockly.Events.BubbleOpen');
-
-const eventUtils = goog.require('Blockly.Events.utils');
-const registry = goog.require('Blockly.registry');
-/* eslint-disable-next-line no-unused-vars */
-const {BlockSvg} = goog.requireType('Blockly.BlockSvg');
-const {UiBase} = goog.require('Blockly.Events.UiBase');
-
-
-/**
- * Class for a bubble open event.
- * @extends {UiBase}
- * @alias Blockly.Events.BubbleOpen
- */
-class BubbleOpen extends UiBase {
-  /**
-   * @param {BlockSvg} opt_block The associated block. Undefined for a
-   *    blank event.
-   * @param {boolean=} opt_isOpen Whether the bubble is opening (false if
-   *    closing). Undefined for a blank event.
-   * @param {string=} opt_bubbleType The type of bubble. One of 'mutator',
-   *     'comment'
-   *    or 'warning'. Undefined for a blank event.
-   */
-  constructor(opt_block, opt_isOpen, opt_bubbleType) {
-    const workspaceId = opt_block ? opt_block.workspace.id : undefined;
-    super(workspaceId);
-    this.blockId = opt_block ? opt_block.id : null;
-
-    /**
-     * Whether the bubble is opening (false if closing).
-     * @type {boolean|undefined}
-     */
-    this.isOpen = opt_isOpen;
-
-    /**
-     * The type of bubble. One of 'mutator', 'comment', or 'warning'.
-     * @type {string|undefined}
-     */
-    this.bubbleType = opt_bubbleType;
-
-    /**
-     * Type of this event.
-     * @type {string}
-     */
-    this.type = eventUtils.BUBBLE_OPEN;
-  }
-
-  /**
-   * Encode the event as JSON.
-   * @return {!Object} JSON representation.
-   */
-  toJson() {
-    const json = super.toJson();
-    json['isOpen'] = this.isOpen;
-    json['bubbleType'] = this.bubbleType;
-    json['blockId'] = this.blockId;
-    return json;
-  }
-
-  /**
-   * Decode the JSON event.
-   * @param {!Object} json JSON representation.
-   */
-  fromJson(json) {
-    super.fromJson(json);
-    this.isOpen = json['isOpen'];
-    this.bubbleType = json['bubbleType'];
-    this.blockId = json['blockId'];
-  }
-}
-
-registry.register(registry.Type.EVENT, eventUtils.BUBBLE_OPEN, BubbleOpen);
-
-exports.BubbleOpen = BubbleOpen;

package/core/events/events_click.js

@@ -1,87 +0,0 @@
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Events fired as a result of UI click in Blockly's editor.
- */
-'use strict';
-
-/**
- * Events fired as a result of UI click in Blockly's editor.
- * @class
- */
-goog.module('Blockly.Events.Click');
-
-const eventUtils = goog.require('Blockly.Events.utils');
-const registry = goog.require('Blockly.registry');
-/* eslint-disable-next-line no-unused-vars */
-const {Block} = goog.requireType('Blockly.Block');
-const {UiBase} = goog.require('Blockly.Events.UiBase');
-
-
-/**
- * Class for a click event.
- * @extends {UiBase}
- * @alias Blockly.Events.Click
- */
-class Click extends UiBase {
-  /**
-   * @param {?Block=} opt_block The affected block. Null for click events
-   *    that do not have an associated block (i.e. workspace click). Undefined
-   *    for a blank event.
-   * @param {?string=} opt_workspaceId The workspace identifier for this event.
-   *    Not used if block is passed. Undefined for a blank event.
-   * @param {string=} opt_targetType The type of element targeted by this click
-   *    event. Undefined for a blank event.
-   */
-  constructor(opt_block, opt_workspaceId, opt_targetType) {
-    let workspaceId = opt_block ? opt_block.workspace.id : opt_workspaceId;
-    if (workspaceId === null) {
-      workspaceId = undefined;
-    }
-    super(workspaceId);
-    this.blockId = opt_block ? opt_block.id : null;
-
-    /**
-     * The type of element targeted by this click event.
-     * @type {string|undefined}
-     */
-    this.targetType = opt_targetType;
-
-    /**
-     * Type of this event.
-     * @type {string}
-     */
-    this.type = eventUtils.CLICK;
-  }
-
-  /**
-   * Encode the event as JSON.
-   * @return {!Object} JSON representation.
-   */
-  toJson() {
-    const json = super.toJson();
-    json['targetType'] = this.targetType;
-    if (this.blockId) {
-      json['blockId'] = this.blockId;
-    }
-    return json;
-  }
-
-  /**
-   * Decode the JSON event.
-   * @param {!Object} json JSON representation.
-   */
-  fromJson(json) {
-    super.fromJson(json);
-    this.targetType = json['targetType'];
-    this.blockId = json['blockId'];
-  }
-}
-
-registry.register(registry.Type.EVENT, eventUtils.CLICK, Click);
-
-exports.Click = Click;