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

package/core/toolbox/collapsible_category.d.ts

@@ -10,6 +10,7 @@ import * as toolbox from '../utils/toolbox.js';
 import { ToolboxCategory } from './category.js';
 /**
  * Class for a category in a toolbox that can be collapsed.
+ *
  * @alias Blockly.CollapsibleToolboxCategory
  */
 export declare class CollapsibleToolboxCategory extends ToolboxCategory implements ICollapsibleToolboxItem {
@@ -35,6 +36,7 @@ export declare class CollapsibleToolboxCategory extends ToolboxCategory implemen
     parseContents_(categoryDef: toolbox.CategoryInfo): void;
     /**
      * Creates a toolbox item and adds it to the list of toolbox items.
+     *
      * @param itemDef The information needed to create a toolbox item.
      */
     private createToolboxItem_;
@@ -43,19 +45,22 @@ export declare class CollapsibleToolboxCategory extends ToolboxCategory implemen
     createIconDom_(): HTMLSpanElement;
     /**
      * Create the DOM for all subcategories.
+     *
      * @param subcategories The subcategories.
-     * @return The div holding all the subcategories.
+     * @returns The div holding all the subcategories.
      */
     protected createSubCategoriesDom_(subcategories: IToolboxItem[]): HTMLDivElement;
     /**
      * Opens or closes the current category.
+     *
      * @param isExpanded True to expand the category, false to close.
      */
     setExpanded(isExpanded: boolean): void;
     setVisible_(isVisible: boolean): void;
     /**
      * Whether the category is expanded to show its child subcategories.
-     * @return True if the toolbox item shows its children, false if it is
+     *
+     * @returns True if the toolbox item shows its children, false if it is
      *     collapsed.
      */
     isExpanded(): boolean;
@@ -66,7 +71,8 @@ export declare class CollapsibleToolboxCategory extends ToolboxCategory implemen
     getDiv(): HTMLDivElement | null;
     /**
      * Gets any children toolbox items. (ex. Gets the subcategories)
-     * @return The child toolbox items.
+     *
+     * @returns The child toolbox items.
      */
     getChildToolboxItems(): IToolboxItem[];
 }
@@ -89,3 +95,4 @@ export declare namespace CollapsibleToolboxCategory {
     }
 }
 export declare type CssConfig = CollapsibleToolboxCategory.CssConfig;
+//# sourceMappingURL=collapsible_category.d.ts.map

package/core/toolbox/separator.d.ts

@@ -9,6 +9,7 @@ import { ToolboxItem } from './toolbox_item.js';
 /**
  * Class for a toolbox separator. This is the thin visual line that appears on
  * the toolbox. This item is not interactable.
+ *
  * @alias Blockly.ToolboxSeparator
  */
 export declare class ToolboxSeparator extends ToolboxItem {
@@ -25,7 +26,8 @@ export declare class ToolboxSeparator extends ToolboxItem {
     init(): void;
     /**
      * Creates the DOM for a separator.
-     * @return The parent element for the separator.
+     *
+     * @returns The parent element for the separator.
      */
     protected createDom_(): HTMLDivElement;
     getDiv(): HTMLDivElement;
@@ -37,3 +39,4 @@ export declare namespace ToolboxSeparator {
     }
 }
 export declare type CssConfig = ToolboxSeparator.CssConfig;
+//# sourceMappingURL=separator.d.ts.map

package/core/toolbox/toolbox.d.ts

@@ -21,11 +21,12 @@ import type { WorkspaceSvg } from '../workspace_svg.js';
 /**
  * Class for a Toolbox.
  * Creates the toolbox's DOM.
+ *
  * @alias Blockly.Toolbox
  */
 export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeyboardAccessible, IStyleable, IToolbox {
     /**
-     * The unique id for this component that is used to register with the
+     * The unique ID for this component that is used to register with the
      * ComponentManager.
      */
     id: string;
@@ -67,30 +68,35 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     constructor(workspace: WorkspaceSvg);
     /**
      * Handles the given keyboard shortcut.
+     *
      * @param _shortcut The shortcut to be handled.
-     * @return True if the shortcut has been handled, false otherwise.
+     * @returns True if the shortcut has been handled, false otherwise.
      */
     onShortcut(_shortcut: KeyboardShortcut): boolean;
     /** Initializes the toolbox */
     init(): void;
     /**
      * Creates the DOM for the toolbox.
+     *
      * @param workspace The workspace this toolbox is on.
-     * @return The HTML container for the toolbox.
+     * @returns The HTML container for the toolbox.
      */
     protected createDom_(workspace: WorkspaceSvg): HTMLDivElement;
     /**
      * Creates the container div for the toolbox.
-     * @return The HTML container for the toolbox.
+     *
+     * @returns The HTML container for the toolbox.
      */
     protected createContainer_(): HTMLDivElement;
     /**
      * Creates the container for all the contents in the toolbox.
-     * @return The HTML container for the toolbox contents.
+     *
+     * @returns The HTML container for the toolbox contents.
      */
     protected createContentsContainer_(): HTMLDivElement;
     /**
      * Adds event listeners to the toolbox container div.
+     *
      * @param container The HTML container for the toolbox.
      * @param contentsContainer The HTML container for the contents of the
      *     toolbox.
@@ -98,35 +104,41 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     protected attachEvents_(container: HTMLDivElement, contentsContainer: HTMLDivElement): void;
     /**
      * Handles on click events for when the toolbox or toolbox items are clicked.
+     *
      * @param e Click event to handle.
      */
     protected onClick_(e: MouseEvent): void;
     /**
      * Handles key down events for the toolbox.
+     *
      * @param e The key down event.
      */
     protected onKeyDown_(e: KeyboardEvent): void;
     /**
      * Creates the flyout based on the toolbox layout.
-     * @return The flyout for the toolbox.
+     *
+     * @returns The flyout for the toolbox.
      * @throws {Error} If missing a require for `Blockly.HorizontalFlyout`,
      *     `Blockly.VerticalFlyout`, and no flyout plugin is specified.
      */
     protected createFlyout_(): IFlyout;
     /**
      * Fills the toolbox with new toolbox items and removes any old contents.
+     *
      * @param toolboxDef Object holding information for creating a toolbox.
      * @internal
      */
     render(toolboxDef: toolbox.ToolboxInfo): void;
     /**
      * Adds all the toolbox items to the toolbox.
+     *
      * @param toolboxDef Array holding objects containing information on the
      *     contents of the toolbox.
      */
     protected renderContents_(toolboxDef: toolbox.ToolboxItemInfo[]): void;
     /**
      * Creates and renders the toolbox item.
+     *
      * @param toolboxItemDef Any information that can be used to create an item in
      *     the toolbox.
      * @param fragment The document fragment to add the child toolbox elements to.
@@ -134,22 +146,26 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     private createToolboxItem_;
     /**
      * Adds an item to the toolbox.
+     *
      * @param toolboxItem The item in the toolbox.
      */
     protected addToolboxItem_(toolboxItem: IToolboxItem): void;
     /**
      * Gets the items in the toolbox.
-     * @return The list of items in the toolbox.
+     *
+     * @returns The list of items in the toolbox.
      */
     getToolboxItems(): IToolboxItem[];
     /**
      * Adds a style on the toolbox. Usually used to change the cursor.
+     *
      * @param style The name of the class to add.
      * @internal
      */
     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.
      * @internal
      */
@@ -157,7 +173,8 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     /**
      * Returns the bounding rectangle of the drag target area in pixel units
      * relative to viewport.
-     * @return The component's bounding box. Null if drag target area should be
+     *
+     * @returns The component's bounding box. Null if drag target area should be
      *     ignored.
      */
     getClientRect(): Rect | null;
@@ -166,30 +183,35 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
      * this area.
      * This method should check if the element is deletable and is always called
      * before onDragEnter/onDragOver/onDragExit.
+     *
      * @param element The block or bubble currently being dragged.
      * @param _couldConnect Whether the element could could connect to another.
-     * @return Whether the element provided would be deleted if dropped on this
+     * @returns Whether the element provided would be deleted if dropped on this
      *     area.
      */
     wouldDelete(element: IDraggable, _couldConnect: boolean): boolean;
     /**
      * Handles when a cursor with a block or bubble enters this drag target.
+     *
      * @param _dragElement The block or bubble currently being dragged.
      */
     onDragEnter(_dragElement: IDraggable): void;
     /**
      * Handles when a cursor with a block or bubble exits this drag target.
+     *
      * @param _dragElement The block or bubble currently being dragged.
      */
     onDragExit(_dragElement: IDraggable): void;
     /**
      * Handles when a block or bubble is dropped on this component.
      * Should not handle delete here.
+     *
      * @param _dragElement The block or bubble currently being dragged.
      */
     onDrop(_dragElement: IDraggable): void;
     /**
      * Updates the internal wouldDelete_ state.
+     *
      * @param wouldDelete The new value for the wouldDelete state.
      */
     protected updateWouldDelete_(wouldDelete: boolean): void;
@@ -197,49 +219,58 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
      * Adds or removes the CSS style of the cursor over the toolbox based whether
      * the block or bubble over it is expected to be deleted if dropped (using the
      * internal this.wouldDelete_ property).
+     *
      * @param addStyle Whether the style should be added or removed.
      */
     protected updateCursorDeleteStyle_(addStyle: boolean): void;
     /**
      * Gets the toolbox item with the given ID.
+     *
      * @param id The ID of the toolbox item.
-     * @return The toolbox item with the given ID, or null if no item exists.
+     * @returns The toolbox item with the given ID, or null if no item exists.
      */
     getToolboxItemById(id: string): IToolboxItem | null;
     /**
      * Gets the width of the toolbox.
-     * @return The width of the toolbox.
+     *
+     * @returns The width of the toolbox.
      */
     getWidth(): number;
     /**
      * Gets the height of the toolbox.
-     * @return The width of the toolbox.
+     *
+     * @returns The width of the toolbox.
      */
     getHeight(): number;
     /**
      * Gets the toolbox flyout.
-     * @return The toolbox flyout.
+     *
+     * @returns The toolbox flyout.
      */
     getFlyout(): IFlyout | null;
     /**
      * Gets the workspace for the toolbox.
-     * @return The parent workspace for the toolbox.
+     *
+     * @returns The parent workspace for the toolbox.
      */
     getWorkspace(): WorkspaceSvg;
     /**
      * Gets the selected item.
-     * @return The selected item, or null if no item is currently selected.
+     *
+     * @returns The selected item, or null if no item is currently selected.
      */
     getSelectedItem(): ISelectableToolboxItem | null;
     /**
      * Gets the previously selected item.
-     * @return The previously selected item, or null if no item was previously
+     *
+     * @returns The previously selected item, or null if no item was previously
      *     selected.
      */
     getPreviouslySelectedItem(): ISelectableToolboxItem | null;
     /**
      * Gets whether or not the toolbox is horizontal.
-     * @return True if the toolbox is horizontal, false if the toolbox is
+     *
+     * @returns True if the toolbox is horizontal, false if the toolbox is
      *     vertical.
      */
     isHorizontal(): boolean;
@@ -250,6 +281,7 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     position(): void;
     /**
      * Handles resizing the toolbox when a toolbox item resizes.
+     *
      * @internal
      */
     handleToolboxItemResize(): void;
@@ -257,6 +289,7 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     clearSelection(): void;
     /**
      * Updates the category colours and background colour of selected categories.
+     *
      * @internal
      */
     refreshTheme(): void;
@@ -268,11 +301,13 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     refreshSelection(): void;
     /**
      * Shows or hides the toolbox.
+     *
      * @param isVisible True if toolbox should be visible.
      */
     setVisible(isVisible: boolean): void;
     /**
      * Hides the component. Called in WorkspaceSvg.hideChaff.
+     *
      * @param onlyClosePopups Whether only popups should be closed.
      *     Flyouts should not be closed if this is true.
      */
@@ -280,73 +315,86 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     /**
      * Sets the given item as selected.
      * No-op if the item is not selectable.
+     *
      * @param newItem The toolbox item to select.
      */
     setSelectedItem(newItem: IToolboxItem | null): void;
     /**
      * Decides whether the old item should be deselected.
+     *
      * @param oldItem The previously selected toolbox item.
      * @param newItem The newly selected toolbox item.
-     * @return True if the old item should be deselected, false otherwise.
+     * @returns True if the old item should be deselected, false otherwise.
      */
     protected shouldDeselectItem_(oldItem: ISelectableToolboxItem | null, newItem: ISelectableToolboxItem | null): boolean;
     /**
      * Decides whether the new item should be selected.
+     *
      * @param oldItem The previously selected toolbox item.
      * @param newItem The newly selected toolbox item.
-     * @return True if the new item should be selected, false otherwise.
+     * @returns True if the new item should be selected, false otherwise.
      */
     protected shouldSelectItem_(oldItem: ISelectableToolboxItem | null, newItem: ISelectableToolboxItem | null): boolean;
     /**
      * Deselects the given item, marks it as unselected, and updates aria state.
+     *
      * @param item The previously selected toolbox item which should be
      *     deselected.
      */
     protected deselectItem_(item: ISelectableToolboxItem): void;
     /**
      * Selects the given item, marks it selected, and updates aria state.
+     *
      * @param oldItem The previously selected toolbox item.
      * @param newItem The newly selected toolbox item.
      */
     protected selectItem_(oldItem: ISelectableToolboxItem | null, newItem: ISelectableToolboxItem): void;
     /**
      * Selects the toolbox item by its position in the list of toolbox items.
+     *
      * @param position The position of the item to select.
      */
     selectItemByPosition(position: number): void;
     /**
      * Decides whether to hide or show the flyout depending on the selected item.
+     *
      * @param oldItem The previously selected toolbox item.
      * @param newItem The newly selected toolbox item.
      */
     protected updateFlyout_(oldItem: ISelectableToolboxItem | null, newItem: ISelectableToolboxItem | null): void;
     /**
      * Emits an event when a new toolbox item is selected.
+     *
      * @param oldItem The previously selected toolbox item.
      * @param newItem The newly selected toolbox item.
      */
     private fireSelectEvent_;
     /**
      * Closes the current item if it is expanded, or selects the parent.
-     * @return True if a parent category was selected, false otherwise.
+     *
+     * @returns True if a parent category was selected, false otherwise.
      */
     private selectParent_;
     /**
      * Selects the first child of the currently selected item, or nothing if the
      * toolbox item has no children.
-     * @return True if a child category was selected, false otherwise.
+     *
+     * @returns True if a child category was selected, false otherwise.
      */
     private selectChild_;
     /**
      * Selects the next visible toolbox item.
-     * @return True if a next category was selected, false otherwise.
+     *
+     * @returns True if a next category was selected, false otherwise.
      */
     private selectNext_;
     /**
      * Selects the previous visible toolbox item.
-     * @return True if a previous category was selected, false otherwise.
+     *
+     * @returns True if a previous category was selected, false otherwise.
      */
     private selectPrevious_;
     /** Disposes of this toolbox. */
     dispose(): void;
 }
+//# sourceMappingURL=toolbox.d.ts.map

package/core/toolbox/toolbox_item.d.ts

@@ -10,6 +10,7 @@ import type * as toolbox from '../utils/toolbox.js';
 import type { WorkspaceSvg } from '../workspace_svg.js';
 /**
  * Class for an item in the toolbox.
+ *
  * @alias Blockly.ToolboxItem
  */
 export declare class ToolboxItem implements IToolboxItem {
@@ -35,7 +36,8 @@ export declare class ToolboxItem implements IToolboxItem {
     init(): void;
     /**
      * Gets the div for the toolbox item.
-     * @return The div for the toolbox item.
+     *
+     * @returns The div for the toolbox item.
      */
     getDiv(): Element | null;
     /**
@@ -43,35 +45,41 @@ export declare class ToolboxItem implements IToolboxItem {
      * 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, or null if this item should
+     *
+     * @returns The HTML element that receives clicks, or null if this item should
      *     not receive clicks.
      */
     getClickTarget(): Element | null;
     /**
      * Gets a unique identifier for this toolbox item.
-     * @return The ID for the toolbox item.
+     *
+     * @returns 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
+     *
+     * @returns The parent toolbox item, or null if this toolbox item is not
      *     nested.
      */
     getParent(): ICollapsibleToolboxItem | null;
     /**
      * Gets the nested level of the category.
-     * @return The nested level of the category.
+     *
+     * @returns The nested level of the category.
      * @internal
      */
     getLevel(): number;
     /**
      * Whether the toolbox item is selectable.
-     * @return True if the toolbox item can be selected.
+     *
+     * @returns True if the toolbox item can be selected.
      */
     isSelectable(): boolean;
     /**
      * Whether the toolbox item is collapsible.
-     * @return True if the toolbox item is collapsible.
+     *
+     * @returns True if the toolbox item is collapsible.
      */
     isCollapsible(): boolean;
     /** Dispose of this toolbox item. No-op by default. */
@@ -79,7 +87,9 @@ export declare class ToolboxItem implements IToolboxItem {
     /**
      * 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;
 }
+//# sourceMappingURL=toolbox_item.d.ts.map

package/core/tooltip.d.ts

@@ -8,6 +8,7 @@
  * Either a string, an object containing a tooltip property, or a function which
  * returns either a string, or another arbitrarily nested function which
  * eventually unwinds to a string.
+ *
  * @alias Blockly.Tooltip.TipInfo
  */
 export declare type TipInfo = string | {
@@ -18,101 +19,119 @@ export declare type TipInfo = string | {
  * 1st parameter: the div element to render content into.
  * 2nd parameter: the element being moused over (i.e., the element for which the
  * tooltip should be shown).
+ *
  * @alias Blockly.Tooltip.CustomTooltip
  */
 export declare type CustomTooltip = (p1: Element, p2: Element) => any;
 /**
  * Sets a custom function that will be called if present instead of the default
  * tooltip UI.
+ *
  * @param customFn A custom tooltip used to render an alternate tooltip UI.
  * @alias Blockly.Tooltip.setCustomTooltip
  */
 export declare function setCustomTooltip(customFn: CustomTooltip): void;
 /**
  * Gets the custom tooltip function.
+ *
  * @returns The custom tooltip function, if defined.
  */
 export declare function getCustomTooltip(): CustomTooltip | undefined;
 /**
  * Returns whether or not a tooltip is showing
+ *
  * @returns True if a tooltip is showing
  * @alias Blockly.Tooltip.isVisible
  */
 export declare function isVisible(): boolean;
 /**
  * Maximum width (in characters) of a tooltip.
+ *
  * @alias Blockly.Tooltip.LIMIT
  */
 export declare const LIMIT = 50;
 /**
  * Horizontal offset between mouse cursor and tooltip.
+ *
  * @alias Blockly.Tooltip.OFFSET_X
  */
 export declare const OFFSET_X = 0;
 /**
  * Vertical offset between mouse cursor and tooltip.
+ *
  * @alias Blockly.Tooltip.OFFSET_Y
  */
 export declare const OFFSET_Y = 10;
 /**
  * Radius mouse can move before killing tooltip.
+ *
  * @alias Blockly.Tooltip.RADIUS_OK
  */
 export declare const RADIUS_OK = 10;
 /**
  * Delay before tooltip appears.
+ *
  * @alias Blockly.Tooltip.HOVER_MS
  */
 export declare const HOVER_MS = 750;
 /**
  * Horizontal padding between tooltip and screen edge.
+ *
  * @alias Blockly.Tooltip.MARGINS
  */
 export declare const MARGINS = 5;
 /**
  * Returns the HTML tooltip container.
+ *
  * @returns The HTML tooltip container.
  * @alias Blockly.Tooltip.getDiv
  */
 export declare function getDiv(): HTMLDivElement | null;
 /**
  * Returns the tooltip text for the given element.
+ *
  * @param object The object to get the tooltip text of.
- * @return The tooltip text of the element.
+ * @returns The tooltip text of the element.
  * @alias Blockly.Tooltip.getTooltipOfObject
  */
 export declare function getTooltipOfObject(object: any | null): string;
 /**
  * Create the tooltip div and inject it onto the page.
+ *
  * @alias Blockly.Tooltip.createDom
  */
 export declare function createDom(): void;
 /**
  * Binds the required mouse events onto an SVG element.
+ *
  * @param element SVG element onto which tooltip is to be bound.
  * @alias Blockly.Tooltip.bindMouseEvents
  */
 export declare function bindMouseEvents(element: Element): void;
 /**
  * Unbinds tooltip mouse events from the SVG element.
+ *
  * @param element SVG element onto which tooltip is bound.
  * @alias Blockly.Tooltip.unbindMouseEvents
  */
 export declare function unbindMouseEvents(element: Element): void;
 /**
  * Dispose of the tooltip.
+ *
  * @alias Blockly.Tooltip.dispose
  * @internal
  */
 export declare function dispose(): void;
 /**
  * Hide the tooltip.
+ *
  * @alias Blockly.Tooltip.hide
  */
 export declare function hide(): void;
 /**
  * Hide any in-progress tooltips and block showing new tooltips until the next
  * call to unblock().
+ *
  * @alias Blockly.Tooltip.block
  * @internal
  */
@@ -120,7 +139,9 @@ export declare function block(): void;
 /**
  * Unblock tooltips: allow them to be scheduled and shown according to their own
  * logic.
+ *
  * @alias Blockly.Tooltip.unblock
  * @internal
  */
 export declare function unblock(): void;
+//# sourceMappingURL=tooltip.d.ts.map