blockly 9.0.0-beta.0 → 9.0.0-beta.2

package/core/interfaces/i_selectable_toolbox_item.ts

@@ -1,64 +0,0 @@
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview The interface for a selectable toolbox item.
- */
-
-/**
- * The interface for a selectable toolbox item.
- * @namespace Blockly.ISelectableToolboxItem
- */
-import * as goog from '../../closure/goog/goog.js';
-import type {FlyoutItemInfoArray} from '../utils/toolbox';
-goog.declareModuleId('Blockly.ISelectableToolboxItem');
-
-/* eslint-disable-next-line no-unused-vars */
-// Unused import preserved for side-effects. Remove if unneeded.
-// import '../utils/toolbox.js';
-
-import type {IToolboxItem} from './i_toolbox_item.js';
-
-
-/**
- * Interface for an item in the toolbox that can be selected.
- * @alias Blockly.ISelectableToolboxItem
- */
-export interface ISelectableToolboxItem extends IToolboxItem {
-  /**
-   * Gets the name of the toolbox item. Used for emitting events.
-   * @return The name of the toolbox item.
-   */
-  getName(): string;
-
-  /**
-   * Gets the contents of the toolbox item. These are items that are meant to be
-   * displayed in the flyout.
-   * @return The definition of items to be displayed in the flyout.
-   */
-  getContents(): FlyoutItemInfoArray|string;
-
-  /**
-   * Sets the current toolbox item as selected.
-   * @param _isSelected True if this category is selected, false otherwise.
-   */
-  setSelected(_isSelected: boolean): void;
-
-  /**
-   * Gets the HTML element that is clickable.
-   * The parent toolbox element receives clicks. The parent toolbox will add an
-   * ID to this element so it can pass the onClick event to the correct
-   * toolboxItem.
-   * @return The HTML element that receives clicks.
-   */
-  getClickTarget(): Element;
-
-  /**
-   * Handles when the toolbox item is clicked.
-   * @param _e Click event to handle.
-   */
-  onClick(_e: Event): void;
-}

package/core/interfaces/i_serializer.ts

@@ -1,65 +0,0 @@
-/**
- * @license
- * Copyright 2021 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview The record type for an object containing functions for
- * serializing part of the workspace.
- */
-
-/**
- * The record type for an object containing functions for
- *     serializing part of the workspace.
- * @namespace Blockly.serialization.ISerializer
- */
-import * as goog from '../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.serialization.ISerializer');
-
-import type {Workspace} from '../workspace.js';
-
-
-/**
- * Serializes and deserializes a plugin or system.
- * @alias Blockly.serialization.ISerializer.ISerializer
- */
-export interface ISerializer {
-  /**
-   * A priority value used to determine the order of deserializing state.
-   * More positive priorities are deserialized before less positive
-   * priorities. Eg if you have priorities (0, -10, 10, 100) the order of
-   * deserialiation will be (100, 10, 0, -10).
-   * If two serializers have the same priority, they are deserialized in an
-   * arbitrary order relative to each other.
-   */
-  priority: number;
-
-  /* eslint-disable no-unused-vars, valid-jsdoc */
-
-  /**
-   * Saves the state of the plugin or system.
-   * @param workspace The workspace the system to serialize is associated with.
-   * @return A JS object containing the system's state, or null if there is no
-   *     state to record.
-   */
-  save(workspace: Workspace): Object|null;
-  /* eslint-enable valid-jsdoc */
-
-  /**
-   * Loads the state of the plugin or system.
-   * @param state The state of the system to deserialize. This will always be
-   *     non-null.
-   * @param workspace The workspace the system to deserialize is associated
-   *     with.
-   */
-  load(state: Object, workspace: Workspace): void;
-
-  /**
-   * Clears the state of the plugin or system.
-   * @param workspace The workspace the system to clear the state of is
-   *     associated with.
-   */
-  clear(workspace: Workspace): void;
-}
-/* eslint-enable no-unused-vars */

package/core/interfaces/i_styleable.ts

@@ -1,35 +0,0 @@
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview The interface for an object that a style can be added to.
- */
-
-/**
- * The interface for an object that a style can be added to.
- * @namespace Blockly.IStyleable
- */
-import * as goog from '../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.IStyleable');
-
-
-/**
- * Interface for an object that a style can be added to.
- * @alias Blockly.IStyleable
- */
-export interface IStyleable {
-  /**
-   * Adds a style on the toolbox. Usually used to change the cursor.
-   * @param style The name of the class to add.
-   */
-  addStyle(style: string): void;
-
-  /**
-   * Removes a style from the toolbox. Usually used to change the cursor.
-   * @param style The name of the class to remove.
-   */
-  removeStyle(style: string): void;
-}

package/core/interfaces/i_toolbox.ts

@@ -1,127 +0,0 @@
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview The interface for a toolbox.
- */
-
-/**
- * The interface for a toolbox.
- * @namespace Blockly.IToolbox
- */
-import * as goog from '../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.IToolbox');
-
-/* eslint-disable-next-line no-unused-vars */
-// Unused import preserved for side-effects. Remove if unneeded.
-// import '../utils/toolbox.js';
-/* eslint-disable-next-line no-unused-vars */
-// Unused import preserved for side-effects. Remove if unneeded.
-// import './i_flyout.js';
-/* eslint-disable-next-line no-unused-vars */
-// Unused import preserved for side-effects. Remove if unneeded.
-// import './i_toolbox_item.js';
-/* eslint-disable-next-line no-unused-vars */
-// Unused import preserved for side-effects. Remove if unneeded.
-// import '../workspace_svg.js';
-
-import type {IRegistrable} from './i_registrable.js';
-import type {IToolboxItem} from './i_toolbox_item.js';
-import type {ToolboxInfo} from '../utils/toolbox.js';
-import type {IFlyout} from './i_flyout.js';
-import type {WorkspaceSvg} from '../workspace_svg.js';
-
-
-/**
- * Interface for a toolbox.
- * @alias Blockly.IToolbox
- */
-export interface IToolbox extends IRegistrable {
-  /** Initializes the toolbox. */
-  init(): void;
-
-  /**
-   * Fills the toolbox with new toolbox items and removes any old contents.
-   * @param toolboxDef Object holding information for creating a toolbox.
-   */
-  render(toolboxDef: ToolboxInfo): void;
-
-  /**
-   * Gets the width of the toolbox.
-   * @return The width of the toolbox.
-   */
-  getWidth(): number;
-
-  /**
-   * Gets the height of the toolbox.
-   * @return The height of the toolbox.
-   */
-  getHeight(): number;
-
-  /**
-   * Gets the toolbox flyout.
-   * @return The toolbox flyout.
-   */
-  getFlyout(): IFlyout|null;
-
-  /**
-   * Gets the workspace for the toolbox.
-   * @return The parent workspace for the toolbox.
-   */
-  getWorkspace(): WorkspaceSvg;
-
-  /**
-   * Gets whether or not the toolbox is horizontal.
-   * @return True if the toolbox is horizontal, false if the toolbox is
-   *     vertical.
-   */
-  isHorizontal(): boolean;
-
-  /**
-   * Positions the toolbox based on whether it is a horizontal toolbox and
-   * whether the workspace is in rtl.
-   */
-  position(): void;
-
-  /** Handles resizing the toolbox when a toolbox item resizes. */
-  handleToolboxItemResize(): void;
-
-  /** Unhighlights any previously selected item. */
-  clearSelection(): void;
-
-  /**
-   * Updates the category colours and background colour of selected categories.
-   */
-  refreshTheme(): void;
-
-  /**
-   * 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.
-   */
-  refreshSelection(): void;
-
-  /**
-   * Sets the visibility of the toolbox.
-   * @param isVisible True if toolbox should be visible.
-   */
-  setVisible(isVisible: boolean): void;
-
-  /**
-   * Selects the toolbox item by it's position in the list of toolbox items.
-   * @param position The position of the item to select.
-   */
-  selectItemByPosition(position: number): void;
-
-  /**
-   * Gets the selected item.
-   * @return The selected item, or null if no item is currently selected.
-   */
-  getSelectedItem(): IToolboxItem|null;
-
-  /** Disposes of this toolbox. */
-  dispose(): void;
-}

package/core/interfaces/i_toolbox_item.ts

@@ -1,84 +0,0 @@
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview The interface for a toolbox item.
- */
-
-/**
- * The interface for a toolbox item.
- * @namespace Blockly.IToolboxItem
- */
-import * as goog from '../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.IToolboxItem');
-
-
-/**
- * Interface for an item in the toolbox.
- * @alias Blockly.IToolboxItem
- */
-export interface IToolboxItem {
-  /**
-   * Initializes the toolbox item.
-   * This includes creating the DOM and updating the state of any items based
-   * on the info object.
-   */
-  init(): void;
-
-  /**
-   * Gets the div for the toolbox item.
-   * @return The div for the toolbox item.
-   */
-  getDiv(): Element|null;
-
-  /**
-   * Gets a unique identifier for this toolbox item.
-   * @return The ID for the toolbox item.
-   */
-  getId(): string;
-
-  /**
-   * Gets the parent if the toolbox item is nested.
-   * @return The parent toolbox item, or null if this toolbox item is not
-   *     nested.
-   */
-  getParent(): IToolboxItem|null;
-
-  /**
-   * Gets the nested level of the category.
-   * @return The nested level of the category.
-   * @internal
-   */
-  getLevel(): number;
-
-  /**
-   * Whether the toolbox item is selectable.
-   * @return True if the toolbox item can be selected.
-   */
-  isSelectable(): boolean;
-
-  /**
-   * Whether the toolbox item is collapsible.
-   * @return True if the toolbox item is collapsible.
-   */
-  isCollapsible(): boolean;
-
-  /** Dispose of this toolbox item. No-op by default. */
-  dispose(): void;
-
-  /**
-   * Gets the HTML element that is clickable.
-   * @return The HTML element that receives clicks.
-   */
-  getClickTarget(): Element|null;
-
-  /**
-   * Sets whether the category is visible or not.
-   * For a category to be visible its parent category must also be expanded.
-   * @param isVisible True if category should be visible.
-   */
-  setVisible_(isVisible: boolean): void;
-}

package/core/internal_constants.ts

@@ -1,67 +0,0 @@
-/**
- * @license
- * Copyright 2021 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Module that provides constants for use inside Blockly. Do not
- * use these constants outside of the core library.
- */
-
-/**
- * Module that provides constants for use inside Blockly. Do not
- * use these constants outside of the core library.
- * @namespace Blockly.internalConstants
- */
-import * as goog from '../closure/goog/goog.js';
-goog.declareModuleId('Blockly.internalConstants');
-
-import {ConnectionType} from './connection_type.js';
-
-
-/**
- * Number of characters to truncate a collapsed block to.
- * @alias Blockly.internalConstants.COLLAPSE_CHARS
- * @internal
- */
-export const COLLAPSE_CHARS = 30;
-
-/**
- * When dragging a block out of a stack, split the stack in two (true), or drag
- * out the block healing the stack (false).
- * @alias Blockly.internalConstants.DRAG_STACK
- * @internal
- */
-export const DRAG_STACK = true;
-
-/**
- * Lookup table for determining the opposite type of a connection.
- * @alias Blockly.internalConstants.OPPOSITE_TYPE
- * @internal
- */
-export const OPPOSITE_TYPE: number[] = [];
-OPPOSITE_TYPE[ConnectionType.INPUT_VALUE] = ConnectionType.OUTPUT_VALUE;
-OPPOSITE_TYPE[ConnectionType.OUTPUT_VALUE] = ConnectionType.INPUT_VALUE;
-OPPOSITE_TYPE[ConnectionType.NEXT_STATEMENT] =
-    ConnectionType.PREVIOUS_STATEMENT;
-OPPOSITE_TYPE[ConnectionType.PREVIOUS_STATEMENT] =
-    ConnectionType.NEXT_STATEMENT;
-
-/**
- * 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.
- * @alias Blockly.internalConstants.RENAME_VARIABLE_ID
- * @internal
- */
-export const 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.
- * @alias Blockly.internalConstants.DELETE_VARIABLE_ID
- * @internal
- */
-export const DELETE_VARIABLE_ID = 'DELETE_VARIABLE_ID';