blockly 8.0.5 → 9.0.0-beta.0

package/core/interfaces/i_toolbox.js

@@ -1,142 +0,0 @@
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview The interface for a toolbox.
- */
-
-'use strict';
-
-/**
- * The interface for a toolbox.
- * @namespace Blockly.IToolbox
- */
-goog.module('Blockly.IToolbox');
-
-/* eslint-disable-next-line no-unused-vars */
-const toolbox = goog.requireType('Blockly.utils.toolbox');
-/* eslint-disable-next-line no-unused-vars */
-const {IFlyout} = goog.requireType('Blockly.IFlyout');
-/* eslint-disable-next-line no-unused-vars */
-const {IRegistrable} = goog.require('Blockly.IRegistrable');
-/* eslint-disable-next-line no-unused-vars */
-const {IToolboxItem} = goog.requireType('Blockly.IToolboxItem');
-/* eslint-disable-next-line no-unused-vars */
-const {WorkspaceSvg} = goog.requireType('Blockly.WorkspaceSvg');
-
-
-/**
- * Interface for a toolbox.
- * @extends {IRegistrable}
- * @interface
- * @alias Blockly.IToolbox
- */
-const IToolbox = function() {};
-
-/**
- * Initializes the toolbox.
- * @return {void}
- */
-IToolbox.prototype.init;
-
-/**
- * Fills the toolbox with new toolbox items and removes any old contents.
- * @param {!toolbox.ToolboxInfo} toolboxDef Object holding information
- *     for creating a toolbox.
- */
-IToolbox.prototype.render;
-
-/**
- * Gets the width of the toolbox.
- * @return {number} The width of the toolbox.
- */
-IToolbox.prototype.getWidth;
-
-/**
- * Gets the height of the toolbox.
- * @return {number} The width of the toolbox.
- */
-IToolbox.prototype.getHeight;
-
-/**
- * Gets the toolbox flyout.
- * @return {?IFlyout} The toolbox flyout.
- */
-IToolbox.prototype.getFlyout;
-
-/**
- * Gets the workspace for the toolbox.
- * @return {!WorkspaceSvg} The parent workspace for the toolbox.
- */
-IToolbox.prototype.getWorkspace;
-
-/**
- * Gets whether or not the toolbox is horizontal.
- * @return {boolean} True if the toolbox is horizontal, false if the toolbox is
- *     vertical.
- */
-IToolbox.prototype.isHorizontal;
-
-/**
- * Positions the toolbox based on whether it is a horizontal toolbox and whether
- * the workspace is in rtl.
- * @return {void}
- */
-IToolbox.prototype.position;
-
-/**
- * Handles resizing the toolbox when a toolbox item resizes.
- * @return {void}
- */
-IToolbox.prototype.handleToolboxItemResize;
-
-/**
- * Unhighlights any previously selected item.
- * @return {void}
- */
-IToolbox.prototype.clearSelection;
-
-/**
- * Updates the category colours and background colour of selected categories.
- * @return {void}
- */
-IToolbox.prototype.refreshTheme;
-
-/**
- * Updates the flyout's content without closing it.  Should be used in response
- * to a change in one of the dynamic categories, such as variables or
- * procedures.
- * @return {void}
- */
-IToolbox.prototype.refreshSelection;
-
-/**
- * Sets the visibility of the toolbox.
- * @param {boolean} isVisible True if toolbox should be visible.
- */
-IToolbox.prototype.setVisible;
-
-/**
- * Selects the toolbox item by it's position in the list of toolbox items.
- * @param {number} position The position of the item to select.
- * @return {void}
- */
-IToolbox.prototype.selectItemByPosition;
-
-/**
- * Gets the selected item.
- * @return {?IToolboxItem} The selected item, or null if no item is
- *     currently selected.
- */
-IToolbox.prototype.getSelectedItem;
-
-/**
- * Disposes of this toolbox.
- * @return {void}
- */
-IToolbox.prototype.dispose;
-
-exports.IToolbox = IToolbox;

package/core/interfaces/i_toolbox_item.js

@@ -1,85 +0,0 @@
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview The interface for a toolbox item.
- */
-
-'use strict';
-
-/**
- * The interface for a toolbox item.
- * @namespace Blockly.IToolboxItem
- */
-goog.module('Blockly.IToolboxItem');
-
-
-/**
- * Interface for an item in the toolbox.
- * @interface
- * @alias Blockly.IToolboxItem
- */
-const IToolboxItem = function() {};
-
-/**
- * Initializes the toolbox item.
- * This includes creating the DOM and updating the state of any items based
- * on the info object.
- * @return {void}
- * @public
- */
-IToolboxItem.prototype.init;
-
-/**
- * Gets the div for the toolbox item.
- * @return {?Element} The div for the toolbox item.
- * @public
- */
-IToolboxItem.prototype.getDiv;
-
-/**
- * Gets a unique identifier for this toolbox item.
- * @return {string} The ID for the toolbox item.
- * @public
- */
-IToolboxItem.prototype.getId;
-
-/**
- * Gets the parent if the toolbox item is nested.
- * @return {?IToolboxItem} The parent toolbox item, or null if
- *     this toolbox item is not nested.
- * @public
- */
-IToolboxItem.prototype.getParent;
-
-/**
- * Gets the nested level of the category.
- * @return {number} The nested level of the category.
- * @package
- */
-IToolboxItem.prototype.getLevel;
-
-/**
- * Whether the toolbox item is selectable.
- * @return {boolean} True if the toolbox item can be selected.
- * @public
- */
-IToolboxItem.prototype.isSelectable;
-
-/**
- * Whether the toolbox item is collapsible.
- * @return {boolean} True if the toolbox item is collapsible.
- * @public
- */
-IToolboxItem.prototype.isCollapsible;
-
-/**
- * Dispose of this toolbox item. No-op by default.
- * @public
- */
-IToolboxItem.prototype.dispose;
-
-exports.IToolboxItem = IToolboxItem;

package/core/marker_manager.js

@@ -1,213 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Object in charge of managing markers and the cursor.
- */
-'use strict';
-
-/**
- * Object in charge of managing markers and the cursor.
- * @class
- */
-goog.module('Blockly.MarkerManager');
-
-/* eslint-disable-next-line no-unused-vars */
-const {Cursor} = goog.requireType('Blockly.Cursor');
-/* eslint-disable-next-line no-unused-vars */
-const {Marker} = goog.requireType('Blockly.Marker');
-/* eslint-disable-next-line no-unused-vars */
-const {WorkspaceSvg} = goog.requireType('Blockly.WorkspaceSvg');
-
-
-/**
- * Class to manage the multiple markers and the cursor on a workspace.
- * @alias Blockly.MarkerManager
- */
-class MarkerManager {
-  /**
-   * @param {!WorkspaceSvg} workspace The workspace for the marker manager.
-   * @package
-   */
-  constructor(workspace) {
-    /**
-     * The cursor.
-     * @type {?Cursor}
-     * @private
-     */
-    this.cursor_ = null;
-
-    /**
-     * The cursor's SVG element.
-     * @type {?SVGElement}
-     * @private
-     */
-    this.cursorSvg_ = null;
-
-    /**
-     * The map of markers for the workspace.
-     * @type {!Object<string, !Marker>}
-     * @private
-     */
-    this.markers_ = Object.create(null);
-
-    /**
-     * The workspace this marker manager is associated with.
-     * @type {!WorkspaceSvg}
-     * @private
-     */
-    this.workspace_ = workspace;
-
-    /**
-     * The marker's SVG element.
-     * @type {?SVGElement}
-     * @private
-     */
-    this.markerSvg_ = null;
-  }
-
-  /**
-   * Register the marker by adding it to the map of markers.
-   * @param {string} id A unique identifier for the marker.
-   * @param {!Marker} marker The marker to register.
-   */
-  registerMarker(id, marker) {
-    if (this.markers_[id]) {
-      this.unregisterMarker(id);
-    }
-    marker.setDrawer(this.workspace_.getRenderer().makeMarkerDrawer(
-        this.workspace_, marker));
-    this.setMarkerSvg(marker.getDrawer().createDom());
-    this.markers_[id] = marker;
-  }
-
-  /**
-   * Unregister the marker by removing it from the map of markers.
-   * @param {string} id The ID of the marker to unregister.
-   */
-  unregisterMarker(id) {
-    const marker = this.markers_[id];
-    if (marker) {
-      marker.dispose();
-      delete this.markers_[id];
-    } else {
-      throw Error(
-          'Marker with ID ' + id + ' does not exist. ' +
-          'Can only unregister markers that exist.');
-    }
-  }
-
-  /**
-   * Get the cursor for the workspace.
-   * @return {?Cursor} The cursor for this workspace.
-   */
-  getCursor() {
-    return this.cursor_;
-  }
-
-  /**
-   * Get a single marker that corresponds to the given ID.
-   * @param {string} id A unique identifier for the marker.
-   * @return {?Marker} The marker that corresponds to the given ID,
-   *     or null if none exists.
-   */
-  getMarker(id) {
-    return this.markers_[id] || null;
-  }
-
-  /**
-   * Sets the cursor and initializes the drawer for use with keyboard
-   * navigation.
-   * @param {Cursor} cursor The cursor used to move around this workspace.
-   */
-  setCursor(cursor) {
-    if (this.cursor_ && this.cursor_.getDrawer()) {
-      this.cursor_.getDrawer().dispose();
-    }
-    this.cursor_ = cursor;
-    if (this.cursor_) {
-      const drawer = this.workspace_.getRenderer().makeMarkerDrawer(
-          this.workspace_, this.cursor_);
-      this.cursor_.setDrawer(drawer);
-      this.setCursorSvg(this.cursor_.getDrawer().createDom());
-    }
-  }
-
-  /**
-   * Add the cursor SVG to this workspace SVG group.
-   * @param {?SVGElement} cursorSvg The SVG root of the cursor to be added to
-   *     the workspace SVG group.
-   * @package
-   */
-  setCursorSvg(cursorSvg) {
-    if (!cursorSvg) {
-      this.cursorSvg_ = null;
-      return;
-    }
-
-    this.workspace_.getBlockCanvas().appendChild(cursorSvg);
-    this.cursorSvg_ = cursorSvg;
-  }
-
-  /**
-   * Add the marker SVG to this workspaces SVG group.
-   * @param {?SVGElement} markerSvg The SVG root of the marker to be added to
-   *     the workspace SVG group.
-   * @package
-   */
-  setMarkerSvg(markerSvg) {
-    if (!markerSvg) {
-      this.markerSvg_ = null;
-      return;
-    }
-
-    if (this.workspace_.getBlockCanvas()) {
-      if (this.cursorSvg_) {
-        this.workspace_.getBlockCanvas().insertBefore(
-            markerSvg, this.cursorSvg_);
-      } else {
-        this.workspace_.getBlockCanvas().appendChild(markerSvg);
-      }
-    }
-  }
-
-  /**
-   * Redraw the attached cursor SVG if needed.
-   * @package
-   */
-  updateMarkers() {
-    if (this.workspace_.keyboardAccessibilityMode && this.cursorSvg_) {
-      this.workspace_.getCursor().draw();
-    }
-  }
-
-  /**
-   * Dispose of the marker manager.
-   * Go through and delete all markers associated with this marker manager.
-   * @suppress {checkTypes}
-   * @package
-   */
-  dispose() {
-    const markerIds = Object.keys(this.markers_);
-    for (let i = 0, markerId; (markerId = markerIds[i]); i++) {
-      this.unregisterMarker(markerId);
-    }
-    this.markers_ = null;
-    if (this.cursor_) {
-      this.cursor_.dispose();
-      this.cursor_ = null;
-    }
-  }
-}
-
-/**
- * The name of the local marker.
- * @type {string}
- * @const
- */
-MarkerManager.LOCAL_MARKER = 'local_marker_1';
-
-exports.MarkerManager = MarkerManager;