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

package/core/events/events_toolbox_item_select.ts

@@ -1,79 +0,0 @@
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Events fired as a result of selecting an item on the toolbox.
- */
-
-/**
- * Events fired as a result of selecting an item on the toolbox.
- * @class
- */
-import * as goog from '../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.Events.ToolboxItemSelect');
-
-import * as registry from '../registry.js';
-
-import {UiBase} from './events_ui_base.js';
-import * as eventUtils from './utils.js';
-
-
-/**
- * Class for a toolbox item select event.
- * @alias Blockly.Events.ToolboxItemSelect
- */
-export class ToolboxItemSelect extends UiBase {
-  oldItem?: string|null;
-  newItem?: string|null;
-  override type: string;
-
-  /**
-   * @param opt_oldItem The previously selected toolbox item.
-   *     Undefined for a blank event.
-   * @param opt_newItem The newly selected toolbox item. Undefined for a blank
-   *     event.
-   * @param opt_workspaceId The workspace identifier for this event.
-   *    Undefined for a blank event.
-   */
-  constructor(
-      opt_oldItem?: string|null, opt_newItem?: string|null,
-      opt_workspaceId?: string) {
-    super(opt_workspaceId);
-
-    /** The previously selected toolbox item. */
-    this.oldItem = opt_oldItem;
-
-    /** The newly selected toolbox item. */
-    this.newItem = opt_newItem;
-
-    /** Type of this event. */
-    this.type = eventUtils.TOOLBOX_ITEM_SELECT;
-  }
-
-  /**
-   * Encode the event as JSON.
-   * @return JSON representation.
-   */
-  override toJson(): AnyDuringMigration {
-    const json = super.toJson();
-    json['oldItem'] = this.oldItem;
-    json['newItem'] = this.newItem;
-    return json;
-  }
-
-  /**
-   * Decode the JSON event.
-   * @param json JSON representation.
-   */
-  override fromJson(json: AnyDuringMigration) {
-    super.fromJson(json);
-    this.oldItem = json['oldItem'];
-    this.newItem = json['newItem'];
-  }
-}
-
-registry.register(
-    registry.Type.EVENT, eventUtils.TOOLBOX_ITEM_SELECT, ToolboxItemSelect);

package/core/events/events_trashcan_open.ts

@@ -1,68 +0,0 @@
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Events fired as a result of trashcan flyout open and close.
- */
-
-/**
- * Events fired as a result of trashcan flyout open and close.
- * @class
- */
-import * as goog from '../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.Events.TrashcanOpen');
-
-import * as registry from '../registry.js';
-
-import {UiBase} from './events_ui_base.js';
-import * as eventUtils from './utils.js';
-
-
-/**
- * Class for a trashcan open event.
- * @alias Blockly.Events.TrashcanOpen
- */
-export class TrashcanOpen extends UiBase {
-  isOpen?: boolean;
-  override type: string;
-
-  /**
-   * @param opt_isOpen Whether the trashcan flyout is opening (false if
-   *     opening). Undefined for a blank event.
-   * @param opt_workspaceId The workspace identifier for this event.
-   *    Undefined for a blank event.
-   */
-  constructor(opt_isOpen?: boolean, opt_workspaceId?: string) {
-    super(opt_workspaceId);
-
-    /** Whether the trashcan flyout is opening (false if closing). */
-    this.isOpen = opt_isOpen;
-
-    /** Type of this event. */
-    this.type = eventUtils.TRASHCAN_OPEN;
-  }
-
-  /**
-   * Encode the event as JSON.
-   * @return JSON representation.
-   */
-  override toJson(): AnyDuringMigration {
-    const json = super.toJson();
-    json['isOpen'] = this.isOpen;
-    return json;
-  }
-
-  /**
-   * Decode the JSON event.
-   * @param json JSON representation.
-   */
-  override fromJson(json: AnyDuringMigration) {
-    super.fromJson(json);
-    this.isOpen = json['isOpen'];
-  }
-}
-
-registry.register(registry.Type.EVENT, eventUtils.TRASHCAN_OPEN, TrashcanOpen);

package/core/events/events_ui.ts

@@ -1,89 +0,0 @@
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview (Deprecated) Events fired as a result of UI actions in
- * Blockly's editor.
- */
-
-/**
- * (Deprecated) Events fired as a result of UI actions in
- * Blockly's editor.
- * @class
- */
-import * as goog from '../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.Events.Ui');
-
-import type {Block} from '../block.js';
-import * as registry from '../registry.js';
-
-import {UiBase} from './events_ui_base.js';
-import * as eventUtils from './utils.js';
-
-
-/**
- * Class for a UI event.
- * @deprecated December 2020. Instead use a more specific UI event.
- * @alias Blockly.Events.Ui
- */
-export class Ui extends UiBase {
-  blockId: AnyDuringMigration;
-  element: AnyDuringMigration;
-  oldValue: AnyDuringMigration;
-  newValue: AnyDuringMigration;
-  override type: string;
-
-  /**
-   * @param opt_block The affected block.  Null for UI events that do not have
-   *     an associated block.  Undefined for a blank event.
-   * @param opt_element One of 'selected', 'comment', 'mutatorOpen', etc.
-   * @param opt_oldValue Previous value of element.
-   * @param opt_newValue New value of element.
-   */
-  constructor(
-      opt_block?: Block|null, opt_element?: string,
-      opt_oldValue?: AnyDuringMigration, opt_newValue?: AnyDuringMigration) {
-    const workspaceId = opt_block ? opt_block.workspace.id : undefined;
-    super(workspaceId);
-
-    this.blockId = opt_block ? opt_block.id : null;
-    this.element = typeof opt_element === 'undefined' ? '' : opt_element;
-    this.oldValue = typeof opt_oldValue === 'undefined' ? '' : opt_oldValue;
-    this.newValue = typeof opt_newValue === 'undefined' ? '' : opt_newValue;
-
-    /** Type of this event. */
-    this.type = eventUtils.UI;
-  }
-
-  /**
-   * Encode the event as JSON.
-   * @return JSON representation.
-   */
-  override toJson(): AnyDuringMigration {
-    const json = super.toJson();
-    json['element'] = this.element;
-    if (this.newValue !== undefined) {
-      json['newValue'] = this.newValue;
-    }
-    if (this.blockId) {
-      json['blockId'] = this.blockId;
-    }
-    return json;
-  }
-
-  /**
-   * Decode the JSON event.
-   * @param json JSON representation.
-   */
-  override fromJson(json: AnyDuringMigration) {
-    super.fromJson(json);
-    this.element = json['element'];
-    this.newValue = json['newValue'];
-    this.blockId = json['blockId'];
-  }
-}
-
-registry.register(registry.Type.EVENT, eventUtils.UI, Ui);

package/core/events/events_ui_base.ts

@@ -1,54 +0,0 @@
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Base class for events fired as a result of UI actions in
- * Blockly's editor.
- */
-
-/**
- * Base class for events fired as a result of UI actions in
- * Blockly's editor.
- * @class
- */
-import * as goog from '../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.Events.UiBase');
-
-import {Abstract as AbstractEvent} from './events_abstract.js';
-
-
-/**
- * Base class for a UI event.
- * UI events are events that don't need to be sent over the wire for multi-user
- * editing to work (e.g. scrolling the workspace, zooming, opening toolbox
- * categories).
- * UI events do not undo or redo.
- * @alias Blockly.Events.UiBase
- */
-export class UiBase extends AbstractEvent {
-  override isBlank: boolean;
-  override workspaceId: string;
-
-  // UI events do not undo or redo.
-  override recordUndo = false;
-
-  /** Whether or not the event is a UI event. */
-  override isUiEvent = true;
-
-  /**
-   * @param opt_workspaceId The workspace identifier for this event.
-   *    Undefined for a blank event.
-   */
-  constructor(opt_workspaceId?: string) {
-    super();
-
-    /** Whether or not the event is blank (to be populated by fromJson). */
-    this.isBlank = typeof opt_workspaceId === 'undefined';
-
-    /** The workspace identifier for this event. */
-    this.workspaceId = opt_workspaceId ? opt_workspaceId : '';
-  }
-}

package/core/events/events_var_base.ts

@@ -1,65 +0,0 @@
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Abstract class for a variable event.
- */
-
-/**
- * Abstract class for a variable event.
- * @class
- */
-import * as goog from '../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.Events.VarBase');
-
-import type {VariableModel} from '../variable_model.js';
-
-import {Abstract as AbstractEvent} from './events_abstract.js';
-
-
-/**
- * Abstract class for a variable event.
- * @alias Blockly.Events.VarBase
- */
-export class VarBase extends AbstractEvent {
-  override isBlank: AnyDuringMigration;
-  varId: string;
-  override workspaceId: string;
-
-  /**
-   * @param opt_variable The variable this event corresponds to.  Undefined for
-   *     a blank event.
-   */
-  constructor(opt_variable?: VariableModel) {
-    super();
-    this.isBlank = typeof opt_variable === 'undefined';
-
-    /** The variable id for the variable this event pertains to. */
-    this.varId = this.isBlank ? '' : opt_variable!.getId();
-
-    /** The workspace identifier for this event. */
-    this.workspaceId = this.isBlank ? '' : opt_variable!.workspace.id;
-  }
-
-  /**
-   * Encode the event as JSON.
-   * @return JSON representation.
-   */
-  override toJson(): AnyDuringMigration {
-    const json = super.toJson();
-    json['varId'] = this.varId;
-    return json;
-  }
-
-  /**
-   * Decode the JSON event.
-   * @param json JSON representation.
-   */
-  override fromJson(json: AnyDuringMigration) {
-    super.fromJson(json);
-    this.varId = json['varId'];
-  }
-}

package/core/events/events_var_create.ts

@@ -1,88 +0,0 @@
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Class for a variable creation event.
- */
-
-/**
- * Class for a variable creation event.
- * @class
- */
-import * as goog from '../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.Events.VarCreate');
-
-import * as registry from '../registry.js';
-import type {VariableModel} from '../variable_model.js';
-
-import {VarBase} from './events_var_base.js';
-import * as eventUtils from './utils.js';
-
-
-/**
- * Class for a variable creation event.
- * @alias Blockly.Events.VarCreate
- */
-export class VarCreate extends VarBase {
-  override type: string;
-
-  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
-  varType!: string;
-  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
-  varName!: string;
-
-  /**
-   * @param opt_variable The created variable. Undefined for a blank event.
-   */
-  constructor(opt_variable?: VariableModel) {
-    super(opt_variable);
-
-    /** Type of this event. */
-    this.type = eventUtils.VAR_CREATE;
-
-    if (!opt_variable) {
-      return;  // Blank event to be populated by fromJson.
-    }
-    this.varType = opt_variable.type;
-    this.varName = opt_variable.name;
-  }
-
-  /**
-   * Encode the event as JSON.
-   * @return JSON representation.
-   */
-  override toJson(): AnyDuringMigration {
-    const json = super.toJson();
-    json['varType'] = this.varType;
-    json['varName'] = this.varName;
-    return json;
-  }
-
-  /**
-   * Decode the JSON event.
-   * @param json JSON representation.
-   */
-  override fromJson(json: AnyDuringMigration) {
-    super.fromJson(json);
-    this.varType = json['varType'];
-    this.varName = json['varName'];
-  }
-
-  /**
-   * Run a variable creation event.
-   * @param forward True if run forward, false if run backward (undo).
-   */
-  override run(forward: boolean) {
-    const workspace = this.getEventWorkspace_();
-    if (forward) {
-      workspace.createVariable(this.varName, this.varType, this.varId);
-    } else {
-      workspace.deleteVariableById(this.varId);
-    }
-  }
-}
-
-registry.register(registry.Type.EVENT, eventUtils.VAR_CREATE, VarCreate);

package/core/events/events_var_delete.ts

@@ -1,88 +0,0 @@
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Classes for all types of variable events.
- */
-
-/**
- * Classes for all types of variable events.
- * @class
- */
-import * as goog from '../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.Events.VarDelete');
-
-import * as registry from '../registry.js';
-import type {VariableModel} from '../variable_model.js';
-
-import {VarBase} from './events_var_base.js';
-import * as eventUtils from './utils.js';
-
-
-/**
- * Class for a variable deletion event.
- * @alias Blockly.Events.VarDelete
- */
-export class VarDelete extends VarBase {
-  override type: string;
-
-  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
-  varType!: string;
-  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
-  varName!: string;
-
-  /**
-   * @param opt_variable The deleted variable. Undefined for a blank event.
-   */
-  constructor(opt_variable?: VariableModel) {
-    super(opt_variable);
-
-    /** Type of this event. */
-    this.type = eventUtils.VAR_DELETE;
-
-    if (!opt_variable) {
-      return;  // Blank event to be populated by fromJson.
-    }
-    this.varType = opt_variable.type;
-    this.varName = opt_variable.name;
-  }
-
-  /**
-   * Encode the event as JSON.
-   * @return JSON representation.
-   */
-  override toJson(): AnyDuringMigration {
-    const json = super.toJson();
-    json['varType'] = this.varType;
-    json['varName'] = this.varName;
-    return json;
-  }
-
-  /**
-   * Decode the JSON event.
-   * @param json JSON representation.
-   */
-  override fromJson(json: AnyDuringMigration) {
-    super.fromJson(json);
-    this.varType = json['varType'];
-    this.varName = json['varName'];
-  }
-
-  /**
-   * Run a variable deletion event.
-   * @param forward True if run forward, false if run backward (undo).
-   */
-  override run(forward: boolean) {
-    const workspace = this.getEventWorkspace_();
-    if (forward) {
-      workspace.deleteVariableById(this.varId);
-    } else {
-      workspace.createVariable(this.varName, this.varType, this.varId);
-    }
-  }
-}
-
-registry.register(registry.Type.EVENT, eventUtils.VAR_DELETE, VarDelete);

package/core/events/events_var_rename.ts

@@ -1,89 +0,0 @@
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Class for a variable rename event.
- */
-
-/**
- * Class for a variable rename event.
- * @class
- */
-import * as goog from '../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.Events.VarRename');
-
-import * as registry from '../registry.js';
-import type {VariableModel} from '../variable_model.js';
-
-import {VarBase} from './events_var_base.js';
-import * as eventUtils from './utils.js';
-
-
-/**
- * Class for a variable rename event.
- * @alias Blockly.Events.VarRename
- */
-export class VarRename extends VarBase {
-  override type: string;
-
-  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
-  oldName!: string;
-  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
-  newName!: string;
-
-  /**
-   * @param opt_variable The renamed variable. Undefined for a blank event.
-   * @param newName The new name the variable will be changed to.
-   */
-  constructor(opt_variable?: VariableModel, newName?: string) {
-    super(opt_variable);
-
-    /** Type of this event. */
-    this.type = eventUtils.VAR_RENAME;
-
-    if (!opt_variable) {
-      return;  // Blank event to be populated by fromJson.
-    }
-    this.oldName = opt_variable.name;
-    this.newName = typeof newName === 'undefined' ? '' : newName;
-  }
-
-  /**
-   * Encode the event as JSON.
-   * @return JSON representation.
-   */
-  override toJson(): AnyDuringMigration {
-    const json = super.toJson();
-    json['oldName'] = this.oldName;
-    json['newName'] = this.newName;
-    return json;
-  }
-
-  /**
-   * Decode the JSON event.
-   * @param json JSON representation.
-   */
-  override fromJson(json: AnyDuringMigration) {
-    super.fromJson(json);
-    this.oldName = json['oldName'];
-    this.newName = json['newName'];
-  }
-
-  /**
-   * Run a variable rename event.
-   * @param forward True if run forward, false if run backward (undo).
-   */
-  override run(forward: boolean) {
-    const workspace = this.getEventWorkspace_();
-    if (forward) {
-      workspace.renameVariableById(this.varId, this.newName);
-    } else {
-      workspace.renameVariableById(this.varId, this.oldName);
-    }
-  }
-}
-
-registry.register(registry.Type.EVENT, eventUtils.VAR_RENAME, VarRename);