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

package/core/main.js

@@ -1,303 +0,0 @@
-/**
- * @license
- * Copyright 2022 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview The entrypoint for blockly_compressed.js.  Provides
- *     various backwards-compatibility hacks.  Not used when loading
- *     in uncompiled (uncompressed) mode via bootstrap.js.
- */
-'use strict';
-
-goog.module('Blockly.main');
-
-const Blockly = goog.require('Blockly');
-const ContextMenu = goog.require('Blockly.ContextMenu');
-const Events = goog.require('Blockly.Events');
-const Msg = goog.require('Blockly.Msg');
-const Tooltip = goog.require('Blockly.Tooltip');
-const WidgetDiv = goog.require('Blockly.WidgetDiv');
-const colour = goog.require('Blockly.utils.colour');
-const common = goog.require('Blockly.common');
-const deprecation = goog.require('Blockly.utils.deprecation');
-const dialog = goog.require('Blockly.dialog');
-const eventUtils = goog.require('Blockly.Events.utils');
-
-/*
- * Aliased functions and properties that used to be on the Blockly namespace.
- * Everything in this section is deprecated. Both external and internal code
- * should avoid using these functions and use the designated replacements.
- * Everything in this section will be removed in a future version of Blockly.
- */
-
-// Add accessors for properties on Blockly that have now been deprecated.
-Object.defineProperties(Blockly, {
-  /**
-   * Wrapper to window.alert() that app developers may override to
-   * provide alternatives to the modal browser window.
-   * @name Blockly.alert
-   * @type {!function(string, function()=)}
-   * @deprecated Use Blockly.dialog.alert / .setAlert() instead.
-   *     (December 2021)
-   * @suppress {checkTypes}
-   */
-  alert: {
-    set: function(newAlert) {
-      deprecation.warn('Blockly.alert', 'December 2021', 'December 2022');
-      dialog.setAlert(newAlert);
-    },
-    get: function() {
-      deprecation.warn(
-          'Blockly.alert', 'December 2021', 'December 2022',
-          'Blockly.dialog.alert()');
-      return dialog.alert;
-    },
-  },
-  /**
-   * Wrapper to window.confirm() that app developers may override to
-   * provide alternatives to the modal browser window.
-   * @name Blockly.confirm
-   * @type {!function(string, function()=)}
-   * @deprecated Use Blockly.dialog.confirm / .setConfirm() instead.
-   *     (December 2021)
-   * @suppress {checkTypes}
-   */
-  confirm: {
-    set: function(newConfirm) {
-      deprecation.warn('Blockly.confirm', 'December 2021', 'December 2022');
-      dialog.setConfirm(newConfirm);
-    },
-    get: function() {
-      deprecation.warn(
-          'Blockly.confirm', 'December 2021', 'December 2022',
-          'Blockly.dialog.confirm()');
-      return dialog.confirm;
-    },
-  },
-  /**
-   * The main workspace most recently used.
-   * Set by Blockly.WorkspaceSvg.prototype.markFocused
-   * @name Blockly.mainWorkspace
-   * @type {Workspace}
-   * @suppress {checkTypes}
-   */
-  mainWorkspace: {
-    set: function(x) {
-      deprecation.warn(
-          'Blockly.mainWorkspace', 'August 2022', 'September 2022',
-          'Blockly.getMainWorkspace');
-      common.setMainWorkspace(x);
-    },
-    get: function() {
-      deprecation.warn(
-          'Blockly.mainWorkspace', 'August 2022', 'September 2022',
-          'Blockly.getMainWorkspace');
-      return common.getMainWorkspace();
-    },
-  },
-  /**
-   * Wrapper to window.prompt() that app developers may override to
-   * provide alternatives to the modal browser window. Built-in
-   * browser prompts are often used for better text input experience
-   * on mobile device. We strongly recommend testing mobile when
-   * overriding this.
-   * @name Blockly.prompt
-   * @type {!function(string, string, function()=)}
-   * @deprecated Use Blockly.dialog.prompt / .setPrompt() instead.
-   *     (December 2021)
-   * @suppress {checkTypes}
-   */
-  prompt: {
-    set: function(newPrompt) {
-      deprecation.warn('Blockly.prompt', 'December 2021', 'December 2022');
-      dialog.setPrompt(newPrompt);
-    },
-    get: function() {
-      deprecation.warn(
-          'Blockly.prompt', 'December 2021', 'December 2022',
-          'Blockly.dialog.prompt()');
-      return dialog.prompt;
-    },
-  },
-  /**
-   * Currently selected block.
-   * @name Blockly.selected
-   * @type {?ICopyable}
-   * @suppress {checkTypes}
-   */
-  selected: {
-    get: function() {
-      deprecation.warn(
-          'Blockly.selected', 'August 2022', 'September 2022',
-          'Blockly.getSelected');
-      return common.getSelected();
-    },
-    set: function(newSelection) {
-      deprecation.warn(
-          'Blockly.selected', 'August 2022', 'September 2022',
-          'Blockly.getSelected');
-      common.setSelected(newSelection);
-    },
-  },
-  /**
-   * The richness of block colours, regardless of the hue.
-   * Must be in the range of 0 (inclusive) to 1 (exclusive).
-   * @name Blockly.HSV_SATURATION
-   * @type {number}
-   * @suppress {checkTypes}
-   */
-  HSV_SATURATION: {
-    get: function() {
-      return colour.getHsvSaturation();
-    },
-    set: function(newValue) {
-      colour.setHsvSaturation(newValue);
-    },
-  },
-  /**
-   * The intensity of block colours, regardless of the hue.
-   * Must be in the range of 0 (inclusive) to 1 (exclusive).
-   * @name Blockly.HSV_VALUE
-   * @type {number}
-   * @suppress {checkTypes}
-   */
-  HSV_VALUE: {
-    get: function() {
-      return colour.getHsvValue();
-    },
-    set: function(newValue) {
-      colour.setHsvValue(newValue);
-    },
-  },
-});
-
-// Add accessors for properties on Blockly.ContextMenu that have now
-// been deprecated.
-Object.defineProperties(ContextMenu, {
-  /**
-   * Which block is the context menu attached to?
-   * @name Blockly.ContextMenu.currentBlock
-   * @type {Block}
-   * @deprecated Use Blockly.Tooltip.getCurrentBlock() /
-   *     .setCurrentBlock() instead.  (September 2021)
-   * @suppress {checkTypes}
-   */
-  currentBlock: {
-    get: function() {
-      deprecation.warn(
-          'Blockly.ContextMenu.currentBlock', 'September 2021',
-          'September 2022', 'Blockly.Tooltip.getCurrentBlock()');
-      return ContextMenu.getCurrentBlock();
-    },
-    set: function(block) {
-      deprecation.warn(
-          'Blockly.ContextMenu.currentBlock', 'September 2021',
-          'September 2022', 'Blockly.Tooltip.setCurrentBlock(block)');
-      ContextMenu.setCurrentBlock(block);
-    },
-  },
-});
-
-// Add accessors for properties on Blockly.Events that have now been
-// deprecated.
-Object.defineProperties(Events, {
-  /**
-   * Sets whether the next event should be added to the undo stack.
-   * @name Blockly.Evenents.recordUndo
-   * @type {boolean}
-   * @deprecated Use Blockly.Events.getRecordUndo() and
-   *     .setRecordUndo().  (September 2021)
-   * @suppress {checkTypes}
-   */
-  recordUndo: {
-    get: function() {
-      deprecation.warn(
-          'Blockly.Events.recordUndo', 'September 2021', 'September 2022',
-          'Blockly.Events.getRecordUndo()');
-      return eventUtils.getRecordUndo();
-    },
-    set: function(record) {
-      deprecation.warn(
-          'Blockly.Events.recordUndo', 'September 2021', 'September 2022',
-          'Blockly.Events.setRecordUndo()');
-      eventUtils.setRecordUndo(record);
-    },
-  },
-});
-
-
-// Add accessors for properties on Blockly.Tooltip that have now been
-// deprecated.
-Object.defineProperties(Tooltip, {
-  /**
-   * Is a tooltip currently showing?
-   * @name Blockly.Tooltip.visible
-   * @type {boolean}
-   * @deprecated Use Blockly.Tooltip.isVisible() instead.  (September
-   *     2021)
-   * @suppress {checkTypes}
-   */
-  visible: {
-    get: function() {
-      deprecation.warn(
-          'Blockly.Tooltip.visible', 'September 2021', 'September 2022',
-          'Blockly.Tooltip.isVisible()');
-      return Tooltip.isVisible();
-    },
-  },
-  /**
-   * The HTML container.  Set once by createDom.
-   * @name Blockly.Tooltip.DIV
-   * @type {HTMLDivElement}
-   * @deprecated Use Blockly.Tooltip.getDiv() and .setDiv().
-   *     (September 2021)
-   * @suppress {checkTypes}
-   */
-  DIV: {
-    get: function() {
-      deprecation.warn(
-          'Blockly.Tooltip.DIV', 'September 2021', 'September 2022',
-          'Blockly.Tooltip.getDiv()');
-      return Tooltip.getDiv();
-    },
-  },
-});
-
-// Add accessors for properties on Blockly.WidgetDiv that have now been
-// deprecated.
-Object.defineProperties(WidgetDiv, {
-  /**
-   * The HTML container for popup overlays (e.g. editor widgets).
-   * @name Blockly.WidgetDiv.DIV
-   * @type {?Element}
-   * @deprecated Use Blockly.WidgetDiv.getDiv() and .setDiv().
-   *     (September 2021)
-   * @suppress {checkTypes}
-   */
-  DIV: {
-    get: function() {
-      deprecation.warn(
-          'Blockly.WidgetDiv.DIV', 'September 2021', 'September 2022',
-          'Blockly.WidgetDiv.getDiv()');
-      return WidgetDiv.getDiv();
-    },
-  },
-});
-
-// If Blockly is compiled with ADVANCED_COMPILATION and/or loaded as a
-// CJS or ES module there will not be a Blockly global variable
-// created.  This can cause problems because a very common way of
-// loading translations is to use a <script> tag to load one of
-// msg/js/*.js, which consists of lines like:
-//
-// Blockly.Msg["ADD_COMMENT"] = "Add Comment";
-// Blockly.Msg["CLEAN_UP"] = "Clean up Blocks";
-//
-// This obviously only works if Blockly.Msg is the Msg export from the
-// Blockly.Msg module - so make sure it is, but only if there is not
-// yet a Blockly global variable.
-if (!('Blockly' in globalThis)) {
-  globalThis['Blockly'] = {'Msg': Msg};
-}

package/core/marker_manager.ts

@@ -1,181 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Object in charge of managing markers and the cursor.
- */
-
-/**
- * Object in charge of managing markers and the cursor.
- * @class
- */
-import * as goog from '../closure/goog/goog.js';
-goog.declareModuleId('Blockly.MarkerManager');
-
-import type {Cursor} from './keyboard_nav/cursor.js';
-import type {Marker} from './keyboard_nav/marker.js';
-import type {WorkspaceSvg} from './workspace_svg.js';
-
-
-/**
- * Class to manage the multiple markers and the cursor on a workspace.
- * @alias Blockly.MarkerManager
- */
-export class MarkerManager {
-  /** The name of the local marker. */
-  static readonly LOCAL_MARKER = 'local_marker_1';
-
-  /** The cursor. */
-  private cursor_: Cursor|null = null;
-
-  /** The cursor's SVG element. */
-  private cursorSvg_: SVGElement|null = null;
-
-  /** The map of markers for the workspace. */
-  private markers = new Map<string, Marker>();
-
-  /** The marker's SVG element. */
-  private markerSvg_: SVGElement|null = null;
-
-  /**
-   * @param workspace The workspace for the marker manager.
-   * @internal
-   */
-  constructor(private readonly workspace: WorkspaceSvg) {}
-
-  /**
-   * Register the marker by adding it to the map of markers.
-   * @param id A unique identifier for the marker.
-   * @param marker The marker to register.
-   */
-  registerMarker(id: string, marker: Marker) {
-    if (this.markers.has(id)) {
-      this.unregisterMarker(id);
-    }
-    marker.setDrawer(
-        this.workspace.getRenderer().makeMarkerDrawer(this.workspace, marker));
-    this.setMarkerSvg(marker.getDrawer().createDom());
-    this.markers.set(id, marker);
-  }
-
-  /**
-   * Unregister the marker by removing it from the map of markers.
-   * @param id The ID of the marker to unregister.
-   */
-  unregisterMarker(id: string) {
-    const marker = this.markers.get(id);
-    if (marker) {
-      marker.dispose();
-      this.markers.delete(id);
-    } else {
-      throw Error(
-          'Marker with ID ' + id + ' does not exist. ' +
-          'Can only unregister markers that exist.');
-    }
-  }
-
-  /**
-   * Get the cursor for the workspace.
-   * @return The cursor for this workspace.
-   */
-  getCursor(): Cursor|null {
-    return this.cursor_;
-  }
-
-  /**
-   * Get a single marker that corresponds to the given ID.
-   * @param id A unique identifier for the marker.
-   * @return The marker that corresponds to the given ID, or null if none
-   *     exists.
-   */
-  getMarker(id: string): Marker|null {
-    return this.markers.get(id) || null;
-  }
-
-  /**
-   * Sets the cursor and initializes the drawer for use with keyboard
-   * navigation.
-   * @param cursor The cursor used to move around this workspace.
-   */
-  setCursor(cursor: 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 cursorSvg The SVG root of the cursor to be added to the workspace
-   *     SVG group.
-   * @internal
-   */
-  setCursorSvg(cursorSvg: SVGElement|null) {
-    if (!cursorSvg) {
-      this.cursorSvg_ = null;
-      return;
-    }
-
-    this.workspace.getBlockCanvas()!.appendChild(cursorSvg);
-    this.cursorSvg_ = cursorSvg;
-  }
-
-  /**
-   * Add the marker SVG to this workspaces SVG group.
-   * @param markerSvg The SVG root of the marker to be added to the workspace
-   *     SVG group.
-   * @internal
-   */
-  setMarkerSvg(markerSvg: SVGElement|null) {
-    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.
-   * @internal
-   */
-  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}
-   * @internal
-   */
-  dispose() {
-    const markerIds = Object.keys(this.markers);
-    for (let i = 0, markerId; markerId = markerIds[i]; i++) {
-      this.unregisterMarker(markerId);
-    }
-    this.markers.clear();
-    if (this.cursor_) {
-      this.cursor_.dispose();
-      this.cursor_ = null;
-    }
-  }
-}