blockly 12.0.0-beta.4 → 12.0.0-beta.6

package/core/block.d.ts

@@ -18,7 +18,6 @@ import type { Field } from './field.js';
 import { IconType } from './icons/icon_types.js';
 import type { MutatorIcon } from './icons/mutator_icon.js';
 import { Input } from './inputs/input.js';
-import type { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
 import { type IIcon } from './interfaces/i_icon.js';
 import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
 import * as Tooltip from './tooltip.js';
@@ -29,7 +28,7 @@ import type { Workspace } from './workspace.js';
  * Class for one block.
  * Not normally called directly, workspace.newBlock() is preferred.
  */
-export declare class Block implements IASTNodeLocation {
+export declare class Block {
     /**
      * An optional callback method to use whenever the block's parent workspace
      * changes. This is usually only called from the constructor, the block type
@@ -647,20 +646,6 @@ export declare class Block implements IASTNodeLocation {
      * @returns True if enabled.
      */
     isEnabled(): boolean;
-    /** @deprecated v11 - Get or sets whether the block is manually disabled. */
-    private get disabled();
-    private set disabled(value);
-    /**
-     * @deprecated v11 - Set whether the block is manually enabled or disabled.
-     * The user can toggle whether a block is disabled from a context menu
-     * option. A block may still be disabled for other reasons even if the user
-     * attempts to manually enable it, such as when the block is in an invalid
-     * location. This method is deprecated and setDisabledReason should be used
-     * instead.
-     *
-     * @param enabled True if enabled.
-     */
-    setEnabled(enabled: boolean): void;
     /**
      * Add or remove a reason why the block might be disabled. If a block has
      * any reasons to be disabled, then the block itself will be considered

package/core/block_svg.d.ts

@@ -17,12 +17,13 @@ import { ContextMenuOption, LegacyContextMenuOption } from './contextmenu_regist
 import { IconType } from './icons/icon_types.js';
 import { MutatorIcon } from './icons/mutator_icon.js';
 import type { Input } from './inputs/input.js';
-import type { IASTNodeLocationSvg } from './interfaces/i_ast_node_location_svg.js';
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
 import { IContextMenu } from './interfaces/i_contextmenu.js';
 import type { ICopyable } from './interfaces/i_copyable.js';
 import { IDeletable } from './interfaces/i_deletable.js';
 import type { IDragStrategy, IDraggable } from './interfaces/i_draggable.js';
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
+import type { IFocusableTree } from './interfaces/i_focusable_tree.js';
 import { IIcon } from './interfaces/i_icon.js';
 import { RenderedConnection } from './rendered_connection.js';
 import type { IPathObject } from './renderers/common/i_path_object.js';
@@ -36,7 +37,7 @@ import type { WorkspaceSvg } from './workspace_svg.js';
  * Class for a block's SVG representation.
  * Not normally called directly, workspace.newBlock() is preferred.
  */
-export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBoundedElement, IContextMenu, ICopyable<BlockCopyData>, IDraggable, IDeletable {
+export declare class BlockSvg extends Block implements IBoundedElement, IContextMenu, ICopyable<BlockCopyData>, IDraggable, IDeletable, IFocusableNode {
     /**
      * Constant for identifying rows that are to be rendered inline.
      * Don't collide with Blockly.inputTypes.
@@ -227,6 +228,12 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * @param collapsed True if collapsed.
      */
     setCollapsed(collapsed: boolean): void;
+    /**
+     * Traverses child blocks to see if any of them have a warning.
+     *
+     * @returns true if any child has a warning, false otherwise.
+     */
+    private childHasWarning;
     /**
      * Makes sure that when the block is collapsed, it is rendered correctly
      * for that state.
@@ -391,17 +398,6 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      */
     private createIconPointerDownListener;
     removeIcon(type: IconType<IIcon>): boolean;
-    /**
-     * @deprecated v11 - Set whether the block is manually enabled or disabled.
-     * The user can toggle whether a block is disabled from a context menu
-     * option. A block may still be disabled for other reasons even if the user
-     * attempts to manually enable it, such as when the block is in an invalid
-     * location. This method is deprecated and setDisabledReason should be used
-     * instead.
-     *
-     * @param enabled True if enabled.
-     */
-    setEnabled(enabled: boolean): void;
     /**
      * Add or remove a reason why the block might be disabled. If a block has
      * any reasons to be disabled, then the block itself will be considered
@@ -665,24 +661,6 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * @internal
      */
     tightenChildrenEfficiently(): void;
-    /** Redraw any attached marker or cursor svgs if needed. */
-    protected updateMarkers_(): void;
-    /**
-     * Add the cursor SVG to this block's SVG group.
-     *
-     * @param cursorSvg The SVG root of the cursor to be added to the block SVG
-     *     group.
-     * @internal
-     */
-    setCursorSvg(cursorSvg: SVGElement): void;
-    /**
-     * Add the marker SVG to this block's SVG group.
-     *
-     * @param markerSvg The SVG root of the marker to be added to the block SVG
-     *     group.
-     * @internal
-     */
-    setMarkerSvg(markerSvg: SVGElement): void;
     /**
      * Returns a bounding box describing the dimensions of this block
      * and any blocks stacked below it.
@@ -736,5 +714,15 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      */
     toFlyoutInfo(): FlyoutItemInfo[];
     jsonInit(json: any): void;
+    /** See IFocusableNode.getFocusableElement. */
+    getFocusableElement(): HTMLElement | SVGElement;
+    /** See IFocusableNode.getFocusableTree. */
+    getFocusableTree(): IFocusableTree;
+    /** See IFocusableNode.onNodeFocus. */
+    onNodeFocus(): void;
+    /** See IFocusableNode.onNodeBlur. */
+    onNodeBlur(): void;
+    /** See IFocusableNode.canBeFocused. */
+    canBeFocused(): boolean;
 }
 //# sourceMappingURL=block_svg.d.ts.map

package/core/blockly.d.ts

@@ -65,11 +65,9 @@ import * as inputs from './inputs.js';
 import { IFlyoutInflater } from './interfaces/i_flyout_inflater.js';
 import { LabelFlyoutInflater } from './label_flyout_inflater.js';
 import { SeparatorFlyoutInflater } from './separator_flyout_inflater.js';
+import { FocusableTreeTraverser } from './utils/focusable_tree_traverser.js';
 import { Input } from './inputs/input.js';
 import { InsertionMarkerPreviewer } from './insertion_marker_previewer.js';
-import { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
-import { IASTNodeLocationSvg } from './interfaces/i_ast_node_location_svg.js';
-import { IASTNodeLocationWithBlock } from './interfaces/i_ast_node_location_with_block.js';
 import { IAutoHideable } from './interfaces/i_autohideable.js';
 import { IBoundedElement } from './interfaces/i_bounded_element.js';
 import { IBubble } from './interfaces/i_bubble.js';
@@ -106,8 +104,7 @@ import { IToolboxItem } from './interfaces/i_toolbox_item.js';
 import { IVariableBackedParameterModel, isVariableBackedParameterModel } from './interfaces/i_variable_backed_parameter_model.js';
 import { IVariableMap } from './interfaces/i_variable_map.js';
 import { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
-import { ASTNode } from './keyboard_nav/ast_node.js';
-import { CursorOptions, LineCursor } from './keyboard_nav/line_cursor.js';
+import { LineCursor } from './keyboard_nav/line_cursor.js';
 import { Marker } from './keyboard_nav/marker.js';
 import type { LayerManager } from './layer_manager.js';
 import * as layers from './layers.js';
@@ -271,7 +268,18 @@ export declare const VARIABLE_DYNAMIC_CATEGORY_NAME: string;
  * procedure blocks.
  */
 export declare const PROCEDURE_CATEGORY_NAME: string;
-export { ASTNode, Block, BlockSvg, BlocklyOptions, Blocks, CollapsibleToolboxCategory, ComponentManager, Connection, ConnectionChecker, ConnectionDB, ConnectionType, ContextMenu, ContextMenuItems, ContextMenuRegistry, Css, CursorOptions, DeleteArea, DragTarget, Events, Extensions, LineCursor, Procedures, ShortcutItems, Themes, Tooltip, Touch, Variables, VariablesDynamic, WidgetDiv, Xml, blockAnimations, blockRendering, browserEvents, bubbles, bumpObjects, clipboard, comments, common, constants, dialog, dragging, fieldRegistry, geras, Procedures as procedures, registry, thrasos, uiPosition, utils, zelos, };
+export * from './flyout_navigator.js';
+export * from './interfaces/i_navigation_policy.js';
+export * from './keyboard_nav/block_navigation_policy.js';
+export * from './keyboard_nav/connection_navigation_policy.js';
+export * from './keyboard_nav/field_navigation_policy.js';
+export * from './keyboard_nav/flyout_button_navigation_policy.js';
+export * from './keyboard_nav/flyout_navigation_policy.js';
+export * from './keyboard_nav/flyout_separator_navigation_policy.js';
+export * from './keyboard_nav/workspace_navigation_policy.js';
+export * from './navigator.js';
+export * from './toast.js';
+export { Block, BlockSvg, BlocklyOptions, Blocks, CollapsibleToolboxCategory, ComponentManager, Connection, ConnectionChecker, ConnectionDB, ConnectionType, ContextMenu, ContextMenuItems, ContextMenuRegistry, Css, DeleteArea, DragTarget, Events, Extensions, LineCursor, Procedures, ShortcutItems, Themes, Tooltip, Touch, Variables, VariablesDynamic, WidgetDiv, Xml, blockAnimations, blockRendering, browserEvents, bubbles, bumpObjects, clipboard, comments, common, constants, dialog, dragging, fieldRegistry, geras, Procedures as procedures, registry, thrasos, uiPosition, utils, zelos, };
 export declare const DropDownDiv: typeof dropDownDiv;
-export { BlockFlyoutInflater, ButtonFlyoutInflater, CodeGenerator, Field, FieldCheckbox, FieldCheckboxConfig, FieldCheckboxFromJsonConfig, FieldCheckboxValidator, FieldConfig, FieldDropdown, FieldDropdownConfig, FieldDropdownFromJsonConfig, FieldDropdownValidator, FieldImage, FieldImageConfig, FieldImageFromJsonConfig, FieldLabel, FieldLabelConfig, FieldLabelFromJsonConfig, FieldLabelSerializable, FieldNumber, FieldNumberConfig, FieldNumberFromJsonConfig, FieldNumberValidator, FieldTextInput, FieldTextInputConfig, FieldTextInputFromJsonConfig, FieldTextInputValidator, FieldValidator, FieldVariable, FieldVariableConfig, FieldVariableFromJsonConfig, FieldVariableValidator, Flyout, FlyoutButton, FlyoutItem, FlyoutMetricsManager, FlyoutSeparator, FocusManager, CodeGenerator as Generator, Gesture, Grid, HorizontalFlyout, IASTNodeLocation, IASTNodeLocationSvg, IASTNodeLocationWithBlock, IAutoHideable, IBoundedElement, IBubble, ICollapsibleToolboxItem, IComponent, IConnectionChecker, IConnectionPreviewer, IContextMenu, ICopyData, ICopyable, IDeletable, IDeleteArea, IDragStrategy, IDragTarget, IDraggable, IDragger, IFlyout, IFlyoutInflater, IFocusableNode, IFocusableTree, IHasBubble, IIcon, IKeyboardAccessible, IMetricsManager, IMovable, IObservable, IPaster, IPositionable, IRegistrable, IRenderedElement, ISelectable, ISelectableToolboxItem, ISerializable, IStyleable, IToolbox, IToolboxItem, IVariableBackedParameterModel, IVariableMap, IVariableModel, IVariableState, ImageProperties, Input, InsertionMarkerPreviewer, LabelFlyoutInflater, LayerManager, Marker, MarkerManager, Menu, MenuGenerator, MenuGeneratorFunction, MenuItem, MenuOption, MetricsManager, Msg, Names, Options, RenderedConnection, ReturnEphemeralFocus, Scrollbar, ScrollbarPair, SeparatorFlyoutInflater, ShortcutRegistry, Theme, ThemeManager, Toolbox, ToolboxCategory, ToolboxItem, ToolboxSeparator, Trashcan, UnattachedFieldError, VariableMap, VariableModel, VerticalFlyout, Workspace, WorkspaceAudio, WorkspaceDragger, WorkspaceSvg, ZoomControls, config, getFocusManager, hasBubble, icons, inject, inputs, isCopyable, isDeletable, isDraggable, isIcon, isObservable, isPaster, isRenderedElement, isSelectable, isSerializable, isVariableBackedParameterModel, layers, renderManagement, serialization, setLocale, };
+export { BlockFlyoutInflater, ButtonFlyoutInflater, CodeGenerator, Field, FieldCheckbox, FieldCheckboxConfig, FieldCheckboxFromJsonConfig, FieldCheckboxValidator, FieldConfig, FieldDropdown, FieldDropdownConfig, FieldDropdownFromJsonConfig, FieldDropdownValidator, FieldImage, FieldImageConfig, FieldImageFromJsonConfig, FieldLabel, FieldLabelConfig, FieldLabelFromJsonConfig, FieldLabelSerializable, FieldNumber, FieldNumberConfig, FieldNumberFromJsonConfig, FieldNumberValidator, FieldTextInput, FieldTextInputConfig, FieldTextInputFromJsonConfig, FieldTextInputValidator, FieldValidator, FieldVariable, FieldVariableConfig, FieldVariableFromJsonConfig, FieldVariableValidator, Flyout, FlyoutButton, FlyoutItem, FlyoutMetricsManager, FlyoutSeparator, FocusManager, FocusableTreeTraverser, CodeGenerator as Generator, Gesture, Grid, HorizontalFlyout, IAutoHideable, IBoundedElement, IBubble, ICollapsibleToolboxItem, IComponent, IConnectionChecker, IConnectionPreviewer, IContextMenu, ICopyData, ICopyable, IDeletable, IDeleteArea, IDragStrategy, IDragTarget, IDraggable, IDragger, IFlyout, IFlyoutInflater, IFocusableNode, IFocusableTree, IHasBubble, IIcon, IKeyboardAccessible, IMetricsManager, IMovable, IObservable, IPaster, IPositionable, IRegistrable, IRenderedElement, ISelectable, ISelectableToolboxItem, ISerializable, IStyleable, IToolbox, IToolboxItem, IVariableBackedParameterModel, IVariableMap, IVariableModel, IVariableState, ImageProperties, Input, InsertionMarkerPreviewer, LabelFlyoutInflater, LayerManager, Marker, MarkerManager, Menu, MenuGenerator, MenuGeneratorFunction, MenuItem, MenuOption, MetricsManager, Msg, Names, Options, RenderedConnection, ReturnEphemeralFocus, Scrollbar, ScrollbarPair, SeparatorFlyoutInflater, ShortcutRegistry, Theme, ThemeManager, Toolbox, ToolboxCategory, ToolboxItem, ToolboxSeparator, Trashcan, UnattachedFieldError, VariableMap, VariableModel, VerticalFlyout, Workspace, WorkspaceAudio, WorkspaceDragger, WorkspaceSvg, ZoomControls, config, getFocusManager, hasBubble, icons, inject, inputs, isCopyable, isDeletable, isDraggable, isIcon, isObservable, isPaster, isRenderedElement, isSelectable, isSerializable, isVariableBackedParameterModel, layers, renderManagement, serialization, setLocale, };
 //# sourceMappingURL=blockly.d.ts.map

package/core/bubbles/bubble.d.ts

@@ -3,8 +3,9 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { ISelectable } from '../blockly.js';
 import { IBubble } from '../interfaces/i_bubble.js';
+import type { IFocusableTree } from '../interfaces/i_focusable_tree.js';
+import { ISelectable } from '../interfaces/i_selectable.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { Size } from '../utils/size.js';
@@ -60,14 +61,19 @@ export declare abstract class Bubble implements IBubble, ISelectable {
     /** The position of the left of the bubble realtive to its anchor. */
     private relativeLeft;
     private dragStrategy;
+    private focusableElement;
     /**
      * @param workspace The workspace this bubble belongs to.
      * @param anchor The anchor location of the thing this bubble is attached to.
      *     The tail of the bubble will point to this location.
      * @param ownerRect An optional rect we don't want the bubble to overlap with
      *     when automatically positioning.
+     * @param overriddenFocusableElement An optional replacement to the focusable
+     *     element that's represented by this bubble (as a focusable node). This
+     *     element will have its ID and tabindex overwritten. If not provided, the
+     *     focusable element of this node will default to the bubble's SVG root.
      */
-    constructor(workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined);
+    constructor(workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined, overriddenFocusableElement?: SVGElement | HTMLElement);
     /** Dispose of this bubble. */
     dispose(): void;
     /**
@@ -96,7 +102,10 @@ export declare abstract class Bubble implements IBubble, ISelectable {
     protected getColour(): string;
     /** Sets the colour of the background and tail of this bubble. */
     setColour(colour: string): void;
-    /** Brings the bubble to the front and passes the pointer event off to the gesture system. */
+    /**
+     * Passes the pointer event off to the gesture system and ensures the bubble
+     * is focused.
+     */
     private onMouseDown;
     /** Positions the bubble relative to its anchor. Does not render its tail. */
     protected positionRelativeToAnchor(): void;
@@ -190,5 +199,15 @@ export declare abstract class Bubble implements IBubble, ISelectable {
     revertDrag(): void;
     select(): void;
     unselect(): void;
+    /** See IFocusableNode.getFocusableElement. */
+    getFocusableElement(): HTMLElement | SVGElement;
+    /** See IFocusableNode.getFocusableTree. */
+    getFocusableTree(): IFocusableTree;
+    /** See IFocusableNode.onNodeFocus. */
+    onNodeFocus(): void;
+    /** See IFocusableNode.onNodeBlur. */
+    onNodeBlur(): void;
+    /** See IFocusableNode.canBeFocused. */
+    canBeFocused(): boolean;
 }
 //# sourceMappingURL=bubble.d.ts.map

package/core/bubbles/textinput_bubble.d.ts

@@ -67,7 +67,9 @@ export declare class TextInputBubble extends Bubble {
     addSizeChangeListener(listener: () => void): void;
     /** Adds a change listener to be notified when this bubble's location changes. */
     addLocationChangeListener(listener: () => void): void;
-    /** Creates the editor UI for this bubble. */
+    /** Creates and returns the editable text area for this bubble's editor. */
+    private static createTextArea;
+    /** Creates and returns the UI container element for this bubble's editor. */
     private createEditor;
     /** Binds events to the text area element. */
     private bindTextAreaEvents;
@@ -93,10 +95,6 @@ export declare class TextInputBubble extends Bubble {
     private onResizePointerUp;
     /** Handles pointer move events on the resize target. */
     private onResizePointerMove;
-    /**
-     * Handles starting an edit of the text area. Brings the bubble to the front.
-     */
-    private onStartEdit;
     /** Handles a text change event for the text area. Calls event listeners. */
     private onTextChange;
     /** Handles a size change event for the text area. Calls event listeners. */

package/core/comments/rendered_workspace_comment.d.ts

@@ -9,6 +9,7 @@ import { IContextMenu } from '../interfaces/i_contextmenu.js';
 import { ICopyable } from '../interfaces/i_copyable.js';
 import { IDeletable } from '../interfaces/i_deletable.js';
 import { IDraggable } from '../interfaces/i_draggable.js';
+import type { IFocusableTree } from '../interfaces/i_focusable_tree.js';
 import { IRenderedElement } from '../interfaces/i_rendered_element.js';
 import { ISelectable } from '../interfaces/i_selectable.js';
 import { Coordinate } from '../utils/coordinate.js';
@@ -98,5 +99,15 @@ export declare class RenderedWorkspaceComment extends WorkspaceComment implement
     showContextMenu(e: Event): void;
     /** Snap this comment to the nearest grid point. */
     snapToGrid(): void;
+    /** See IFocusableNode.getFocusableElement. */
+    getFocusableElement(): HTMLElement | SVGElement;
+    /** See IFocusableNode.getFocusableTree. */
+    getFocusableTree(): IFocusableTree;
+    /** See IFocusableNode.onNodeFocus. */
+    onNodeFocus(): void;
+    /** See IFocusableNode.onNodeBlur. */
+    onNodeBlur(): void;
+    /** See IFocusableNode.canBeFocused. */
+    canBeFocused(): boolean;
 }
 //# sourceMappingURL=rendered_workspace_comment.d.ts.map

package/core/common.d.ts

@@ -4,9 +4,9 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Block } from './block.js';
-import { ISelectable } from './blockly.js';
 import { BlockDefinition } from './blocks.js';
 import type { Connection } from './connection.js';
+import { ISelectable } from './interfaces/i_selectable.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
@@ -49,18 +49,30 @@ export declare function getMainWorkspace(): Workspace;
  */
 export declare function setMainWorkspace(workspace: Workspace): void;
 /**
- * Returns the currently selected copyable object.
+ * Returns the current selection.
  */
 export declare function getSelected(): ISelectable | null;
 /**
- * Sets the currently selected block. This function does not visually mark the
- * block as selected or fire the required events. If you wish to
- * programmatically select a block, use `BlockSvg#select`.
+ * Sets the current selection.
  *
- * @param newSelection The newly selected block.
+ * To clear the current selection, select another ISelectable or focus a
+ * non-selectable (like the workspace root node).
+ *
+ * @param newSelection The new selection to make.
+ * @internal
+ */
+export declare function setSelected(newSelection: ISelectable): void;
+/**
+ * Fires a selection change event based on the new selection.
+ *
+ * This is only expected to be called by ISelectable implementations and should
+ * always be called before updating the current selection state. It does not
+ * change focus or selection state.
+ *
+ * @param newSelection The new selection.
  * @internal
  */
-export declare function setSelected(newSelection: ISelectable | null): void;
+export declare function fireSelectedEvent(newSelection: ISelectable | null): void;
 /**
  * Get the container element in which to render the WidgetDiv, DropDownDiv and
  * Tooltip.

package/core/connection.d.ts

@@ -10,13 +10,12 @@
  */
 import type { Block } from './block.js';
 import type { Input } from './inputs/input.js';
-import type { IASTNodeLocationWithBlock } from './interfaces/i_ast_node_location_with_block.js';
 import type { IConnectionChecker } from './interfaces/i_connection_checker.js';
 import * as blocks from './serialization/blocks.js';
 /**
  * Class for a connection between blocks.
  */
-export declare class Connection implements IASTNodeLocationWithBlock {
+export declare class Connection {
     type: number;
     /** Constants for checking whether two connections are compatible. */
     static CAN_CONNECT: number;
@@ -41,6 +40,8 @@ export declare class Connection implements IASTNodeLocationWithBlock {
     private check;
     /** DOM representation of a shadow block, or null if none. */
     private shadowDom;
+    /** The unique ID of this connection. */
+    id: string;
     /**
      * Horizontal location of this connection.
      *

package/core/contextmenu_registry.d.ts

@@ -10,6 +10,7 @@
  */
 import type { BlockSvg } from './block_svg.js';
 import { RenderedWorkspaceComment } from './comments/rendered_workspace_comment.js';
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
 import { Coordinate } from './utils/coordinate.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
@@ -45,17 +46,16 @@ export declare class ContextMenuRegistry {
      */
     getItem(id: string): RegistryItem | null;
     /**
-     * Gets the valid context menu options for the given scope type (e.g. block or
-     * workspace) and scope. Blocks are only shown if the preconditionFn shows
+     * Gets the valid context menu options for the given scope.
+     * Options are only included if the preconditionFn shows
      * they should not be hidden.
      *
-     * @param scopeType Type of scope where menu should be shown (e.g. on a block
-     *     or on a workspace)
      * @param scope Current scope of context menu (i.e., the exact workspace or
-     *     block being clicked on)
+     *     block being clicked on).
+     * @param menuOpenEvent Event that caused the menu to open.
      * @returns the list of ContextMenuOptions
      */
-    getContextMenuOptions(scopeType: ScopeType, scope: Scope, menuOpenEvent: Event): ContextMenuOption[];
+    getContextMenuOptions(scope: Scope, menuOpenEvent: Event): ContextMenuOption[];
 }
 export declare namespace ContextMenuRegistry {
     /**
@@ -69,19 +69,21 @@ export declare namespace ContextMenuRegistry {
         COMMENT = "comment"
     }
     /**
-     * The actual workspace/block where the menu is being rendered. This is passed
-     * to callback and displayText functions that depend on this information.
+     * The actual workspace/block/focused object where the menu is being
+     * rendered. This is passed to callback and displayText functions
+     * that depend on this information.
      */
     export interface Scope {
         block?: BlockSvg;
         workspace?: WorkspaceSvg;
         comment?: RenderedWorkspaceComment;
+        focusedNode?: IFocusableNode;
     }
     /**
      * Fields common to all context menu registry items.
      */
     interface CoreRegistryItem {
-        scopeType: ScopeType;
+        scopeType?: ScopeType;
         weight: number;
         id: string;
     }

package/core/dialog.d.ts

@@ -3,6 +3,8 @@
  * Copyright 2021 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { ToastOptions } from './toast.js';
+import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Wrapper to window.alert() that app developers may override via setAlert to
  * provide alternatives to the modal browser window.
@@ -14,10 +16,11 @@ export declare function alert(message: string, opt_callback?: () => void): void;
 /**
  * Sets the function to be run when Blockly.dialog.alert() is called.
  *
- * @param alertFunction The function to be run.
+ * @param alertFunction The function to be run, or undefined to restore the
+ *     default implementation.
  * @see Blockly.dialog.alert
  */
-export declare function setAlert(alertFunction: (p1: string, p2?: () => void) => void): void;
+export declare function setAlert(alertFunction?: (message: string, callback?: () => void) => void): void;
 /**
  * Wrapper to window.confirm() that app developers may override via setConfirm
  * to provide alternatives to the modal browser window.
@@ -25,18 +28,15 @@ export declare function setAlert(alertFunction: (p1: string, p2?: () => void) =>
  * @param message The message to display to the user.
  * @param callback The callback for handling user response.
  */
-export declare function confirm(message: string, callback: (p1: boolean) => void): void;
-/**
- * Private version of confirm for stubbing in tests.
- */
-declare function confirmInternal(message: string, callback: (p1: boolean) => void): void;
+export declare function confirm(message: string, callback: (result: boolean) => void): void;
 /**
  * Sets the function to be run when Blockly.dialog.confirm() is called.
  *
- * @param confirmFunction The function to be run.
+ * @param confirmFunction The function to be run, or undefined to restore the
+ *     default implementation.
  * @see Blockly.dialog.confirm
  */
-export declare function setConfirm(confirmFunction: (p1: string, p2: (p1: boolean) => void) => void): void;
+export declare function setConfirm(confirmFunction?: (message: string, callback: (result: boolean) => void) => void): void;
 /**
  * Wrapper to window.prompt() that app developers may override via setPrompt to
  * provide alternatives to the modal browser window. Built-in browser prompts
@@ -47,16 +47,36 @@ export declare function setConfirm(confirmFunction: (p1: string, p2: (p1: boolea
  * @param defaultValue The value to initialize the prompt with.
  * @param callback The callback for handling user response.
  */
-export declare function prompt(message: string, defaultValue: string, callback: (p1: string | null) => void): void;
+export declare function prompt(message: string, defaultValue: string, callback: (result: string | null) => void): void;
 /**
  * Sets the function to be run when Blockly.dialog.prompt() is called.
  *
- * @param promptFunction The function to be run.
+ * **Important**: When overridding this, be aware that non-native prompt
+ * experiences may require managing ephemeral focus in FocusManager. This isn't
+ * needed for the native window prompt because it prevents focus from being
+ * changed while open.
+ *
+ * @param promptFunction The function to be run, or undefined to restore the
+ *     default implementation.
  * @see Blockly.dialog.prompt
  */
-export declare function setPrompt(promptFunction: (p1: string, p2: string, p3: (p1: string | null) => void) => void): void;
-export declare const TEST_ONLY: {
-    confirmInternal: typeof confirmInternal;
-};
-export {};
+export declare function setPrompt(promptFunction?: (message: string, defaultValue: string, callback: (result: string | null) => void) => void): void;
+/**
+ * Displays a temporary notification atop the workspace. Blockly provides a
+ * default toast implementation, but developers may provide their own via
+ * setToast. For simple appearance customization, CSS should be sufficient.
+ *
+ * @param workspace The workspace to display the toast notification atop.
+ * @param options Configuration options for the notification, including its
+ *     message and duration.
+ */
+export declare function toast(workspace: WorkspaceSvg, options: ToastOptions): void;
+/**
+ * Sets the function to be run when Blockly.dialog.toast() is called.
+ *
+ * @param toastFunction The function to be run, or undefined to restore the
+ *     default implementation.
+ * @see Blockly.dialog.toast
+ */
+export declare function setToast(toastFunction?: (workspace: WorkspaceSvg, options: ToastOptions) => void): void;
 //# sourceMappingURL=dialog.d.ts.map

package/core/events/events.d.ts

@@ -22,7 +22,6 @@ export { CommentDelete } from './events_comment_delete.js';
 export { CommentDrag, CommentDragJson } from './events_comment_drag.js';
 export { CommentMove, CommentMoveJson } from './events_comment_move.js';
 export { CommentResize, CommentResizeJson } from './events_comment_resize.js';
-export { MarkerMove, MarkerMoveJson } from './events_marker_move.js';
 export { Selected, SelectedJson } from './events_selected.js';
 export { ThemeChange, ThemeChangeJson } from './events_theme_change.js';
 export { ToolboxItemSelect, ToolboxItemSelectJson, } from './events_toolbox_item_select.js';
@@ -57,7 +56,6 @@ export declare const CREATE = EventType.BLOCK_CREATE;
 /** @deprecated Use BLOCK_DELETE instead */
 export declare const DELETE = EventType.BLOCK_DELETE;
 export declare const FINISHED_LOADING = EventType.FINISHED_LOADING;
-export declare const MARKER_MOVE = EventType.MARKER_MOVE;
 /** @deprecated Use BLOCK_MOVE instead */
 export declare const MOVE = EventType.BLOCK_MOVE;
 export declare const SELECTED = EventType.SELECTED;

package/core/events/predicates.d.ts

@@ -27,7 +27,6 @@ import type { CommentDelete } from './events_comment_delete.js';
 import type { CommentDrag } from './events_comment_drag.js';
 import type { CommentMove } from './events_comment_move.js';
 import type { CommentResize } from './events_comment_resize.js';
-import type { MarkerMove } from './events_marker_move.js';
 import type { Selected } from './events_selected.js';
 import type { ThemeChange } from './events_theme_change.js';
 import type { ToolboxItemSelect } from './events_toolbox_item_select.js';
@@ -59,8 +58,6 @@ export declare function isBlockDrag(event: Abstract): event is BlockDrag;
 export declare function isSelected(event: Abstract): event is Selected;
 /** @returns true iff event.type is EventType.CLICK */
 export declare function isClick(event: Abstract): event is Click;
-/** @returns true iff event.type is EventType.MARKER_MOVE */
-export declare function isMarkerMove(event: Abstract): event is MarkerMove;
 /** @returns true iff event.type is EventType.BUBBLE_OPEN */
 export declare function isBubbleOpen(event: Abstract): event is BubbleOpen;
 /** @returns true iff event.type is EventType.TRASHCAN_OPEN */

package/core/events/utils.d.ts

@@ -129,13 +129,9 @@ declare function enqueueEvent(event: Abstract): void;
  * cause them to be reordered.
  *
  * @param queue Array of events.
- * @param forward True if forward (redo), false if backward (undo).
- *     This parameter is deprecated: true is now the default and
- *     calling filter with it set to false will in future not be
- *     supported.
  * @returns Array of filtered events.
  */
-export declare function filter(queue: Abstract[], forward?: boolean): Abstract[];
+export declare function filter(queue: Abstract[]): Abstract[];
 /**
  * Modify pending undo events so that when they are fired they don't land
  * in the undo stack.  Called by Workspace.clearUndo.