blockly 12.0.0-beta.3 → 12.0.0-beta.5

package/core/keyboard_nav/marker.d.ts

@@ -9,8 +9,9 @@
  *
  * @class
  */
-import type { MarkerSvg } from '../renderers/common/marker_svg.js';
-import type { ASTNode } from './ast_node.js';
+import { BlockSvg } from '../block_svg.js';
+import type { INavigable } from '../interfaces/i_navigable.js';
+import { ASTNode } from './ast_node.js';
 /**
  * Class for a marker.
  * This is used in keyboard navigation to save a location in the Blockly AST.
@@ -19,47 +20,37 @@ export declare class Marker {
     /** The colour of the marker. */
     colour: string | null;
     /** The current location of the marker. */
-    private curNode;
-    /**
-     * The object in charge of drawing the visual representation of the current
-     * node.
-     */
-    private drawer;
+    protected curNode: INavigable<any> | null;
     /** The type of the marker. */
     type: string;
-    /**
-     * Sets the object in charge of drawing the marker.
-     *
-     * @param drawer The object in charge of drawing the marker.
-     */
-    setDrawer(drawer: MarkerSvg): void;
-    /**
-     * Get the current drawer for the marker.
-     *
-     * @returns The object in charge of drawing the marker.
-     */
-    getDrawer(): MarkerSvg | null;
     /**
      * Gets the current location of the marker.
      *
      * @returns The current field, connection, or block the marker is on.
      */
-    getCurNode(): ASTNode | null;
+    getCurNode(): INavigable<any> | null;
     /**
      * Set the location of the marker and call the update method.
      *
      * @param newNode The new location of the marker, or null to remove it.
      */
-    setCurNode(newNode: ASTNode | null): void;
+    setCurNode(newNode: INavigable<any> | null): void;
+    /** Dispose of this marker. */
+    dispose(): void;
     /**
-     * Redraw the current marker.
+     * Converts an INavigable to a legacy ASTNode.
      *
-     * @internal
+     * @param node The INavigable instance to convert.
+     * @returns An ASTNode representation of the given object if possible,
+     *     otherwise null.
      */
-    draw(): void;
-    /** Hide the marker SVG. */
-    hide(): void;
-    /** Dispose of this marker. */
-    dispose(): void;
+    toASTNode(node: INavigable<any> | null): ASTNode | null;
+    /**
+     * Returns the block that this marker's current node is a child of.
+     *
+     * @returns The parent block of the marker's current node if any, otherwise
+     *     null.
+     */
+    getSourceBlock(): BlockSvg | null;
 }
 //# sourceMappingURL=marker.d.ts.map

package/core/keyboard_nav/workspace_navigation_policy.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { INavigable } from '../interfaces/i_navigable.js';
+import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+import type { WorkspaceSvg } from '../workspace_svg.js';
+/**
+ * Set of rules controlling keyboard navigation from a workspace.
+ */
+export declare class WorkspaceNavigationPolicy implements INavigationPolicy<WorkspaceSvg> {
+    /**
+     * Returns the first child of the given workspace.
+     *
+     * @param current The workspace to return the first child of.
+     * @returns The top block of the first block stack, if any.
+     */
+    getFirstChild(current: WorkspaceSvg): INavigable<unknown> | null;
+    /**
+     * Returns the parent of the given workspace.
+     *
+     * @param _current The workspace to return the parent of.
+     * @returns Null.
+     */
+    getParent(_current: WorkspaceSvg): INavigable<unknown> | null;
+    /**
+     * Returns the next sibling of the given workspace.
+     *
+     * @param _current The workspace to return the next sibling of.
+     * @returns Null.
+     */
+    getNextSibling(_current: WorkspaceSvg): INavigable<unknown> | null;
+    /**
+     * Returns the previous sibling of the given workspace.
+     *
+     * @param _current The workspace to return the previous sibling of.
+     * @returns Null.
+     */
+    getPreviousSibling(_current: WorkspaceSvg): INavigable<unknown> | null;
+}
+//# sourceMappingURL=workspace_navigation_policy.d.ts.map

package/core/marker_manager.d.ts

@@ -20,12 +20,8 @@ export declare class MarkerManager {
     static readonly LOCAL_MARKER = "local_marker_1";
     /** The cursor. */
     private cursor;
-    /** The cursor's SVG element. */
-    private cursorSvg;
     /** The map of markers for the workspace. */
     private markers;
-    /** The marker's SVG element. */
-    private markerSvg;
     /**
      * @param workspace The workspace for the marker manager.
      * @internal
@@ -65,28 +61,6 @@ export declare class MarkerManager {
      * @param cursor The cursor used to move around this workspace.
      */
     setCursor(cursor: LineCursor): void;
-    /**
-     * 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): void;
-    /**
-     * 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): void;
-    /**
-     * Redraw the attached cursor SVG if needed.
-     *
-     * @internal
-     */
-    updateMarkers(): void;
     /**
      * Dispose of the marker manager.
      * Go through and delete all markers associated with this marker manager.

package/core/menuitem.d.ts

@@ -120,9 +120,12 @@ export declare class MenuItem {
      * Performs the appropriate action when the menu item is activated
      * by the user.
      *
+     * @param menuSelectEvent the event that triggered the selection
+     * of the menu item.
+     *
      * @internal
      */
-    performAction(): void;
+    performAction(menuSelectEvent: Event): void;
     /**
      * Set the handler that's called when the menu item is activated by the user.
      * `obj` will be used as the 'this' object in the function when called.
@@ -131,6 +134,6 @@ export declare class MenuItem {
      * @param obj Used as the 'this' object in fn when called.
      * @internal
      */
-    onAction(fn: (p1: MenuItem) => void, obj: object): void;
+    onAction(fn: (p1: MenuItem, menuSelectEvent: Event) => void, obj: object): void;
 }
 //# sourceMappingURL=menuitem.d.ts.map

package/core/navigator.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { INavigable } from './interfaces/i_navigable.js';
+import type { INavigationPolicy } from './interfaces/i_navigation_policy.js';
+/**
+ * Class responsible for determining where focus should move in response to
+ * keyboard navigation commands.
+ */
+export declare class Navigator {
+    /**
+     * Map from classes to a corresponding ruleset to handle navigation from
+     * instances of that class.
+     */
+    private rules;
+    /**
+     * Associates a navigation ruleset with its corresponding class.
+     *
+     * @param key The class whose object instances should have their navigation
+     *     controlled by the associated policy.
+     * @param policy A ruleset that determines where focus should move starting
+     *     from an instance of the given class.
+     */
+    set<T extends INavigable<T>>(key: new (...args: any) => T, policy: INavigationPolicy<T>): void;
+    /**
+     * Returns the navigation ruleset associated with the given object instance's
+     * class.
+     *
+     * @param key An object to retrieve a navigation ruleset for.
+     * @returns The navigation ruleset of objects of the given object's class, or
+     *     undefined if no ruleset has been registered for the object's class.
+     */
+    private get;
+    /**
+     * Returns the first child of the given object instance, if any.
+     *
+     * @param current The object to retrieve the first child of.
+     * @returns The first child node of the given object, if any.
+     */
+    getFirstChild<T extends INavigable<T>>(current: T): INavigable<any> | null;
+    /**
+     * Returns the parent of the given object instance, if any.
+     *
+     * @param current The object to retrieve the parent of.
+     * @returns The parent node of the given object, if any.
+     */
+    getParent<T extends INavigable<T>>(current: T): INavigable<any> | null;
+    /**
+     * Returns the next sibling of the given object instance, if any.
+     *
+     * @param current The object to retrieve the next sibling node of.
+     * @returns The next sibling node of the given object, if any.
+     */
+    getNextSibling<T extends INavigable<T>>(current: T): INavigable<any> | null;
+    /**
+     * Returns the previous sibling of the given object instance, if any.
+     *
+     * @param current The object to retrieve the previous sibling node of.
+     * @returns The previous sibling node of the given object, if any.
+     */
+    getPreviousSibling<T extends INavigable<T>>(current: T): INavigable<any> | null;
+}
+//# sourceMappingURL=navigator.d.ts.map

package/core/rendered_connection.d.ts

@@ -11,11 +11,15 @@
 import type { Block } from './block.js';
 import type { BlockSvg } from './block_svg.js';
 import { Connection } from './connection.js';
+import { IContextMenu } from './interfaces/i_contextmenu.js';
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
+import type { IFocusableTree } from './interfaces/i_focusable_tree.js';
+import type { INavigable } from './interfaces/i_navigable.js';
 import { Coordinate } from './utils/coordinate.js';
 /**
  * Class for a connection between blocks that may be rendered on screen.
  */
-export declare class RenderedConnection extends Connection {
+export declare class RenderedConnection extends Connection implements IContextMenu, IFocusableNode, INavigable<RenderedConnection> {
     sourceBlock_: BlockSvg;
     private readonly db;
     private readonly dbOpposite;
@@ -216,6 +220,36 @@ export declare class RenderedConnection extends Connection {
      * @returns The connection being modified (to allow chaining).
      */
     setCheck(check: string | string[] | null): RenderedConnection;
+    /**
+     * Handles showing the context menu when it is opened on a connection.
+     * Note that typically the context menu can't be opened with the mouse
+     * on a connection, because you can't select a connection. But keyboard
+     * users may open the context menu with a keyboard shortcut.
+     *
+     * @param e Event that triggered the opening of the context menu.
+     */
+    showContextMenu(e: Event): void;
+    /** See IFocusableNode.getFocusableElement. */
+    getFocusableElement(): HTMLElement | SVGElement;
+    /** See IFocusableNode.getFocusableTree. */
+    getFocusableTree(): IFocusableTree;
+    /** See IFocusableNode.onNodeFocus. */
+    onNodeFocus(): void;
+    /** See IFocusableNode.onNodeBlur. */
+    onNodeBlur(): void;
+    private findHighlightSvg;
+    /**
+     * Returns whether or not this connection is keyboard-navigable.
+     *
+     * @returns True.
+     */
+    isNavigable(): boolean;
+    /**
+     * Returns this connection's class for keyboard navigation.
+     *
+     * @returns RenderedConnection.
+     */
+    getClass(): typeof RenderedConnection;
 }
 export declare namespace RenderedConnection {
     /**

package/core/renderers/common/block_rendering.d.ts

@@ -29,7 +29,6 @@ import { Types } from '../measurables/types.js';
 import { Drawer } from './drawer.js';
 import type { IPathObject } from './i_path_object.js';
 import { RenderInfo } from './info.js';
-import { MarkerSvg } from './marker_svg.js';
 import { PathObject } from './path_object.js';
 import { Renderer } from './renderer.js';
 /**
@@ -59,6 +58,6 @@ export declare function unregister(name: string): void;
 export declare function init(name: string, theme: Theme, opt_rendererOverrides?: {
     [rendererConstant: string]: any;
 }): Renderer;
-export { BottomRow, Connection, Drawer, ExternalValueInput, Field, Hat, Icon, InlineInput, InputConnection, InputRow, InRowSpacer, IPathObject, JaggedEdge, MarkerSvg, Measurable, NextConnection, OutputConnection, PathObject, PreviousConnection, Renderer, RenderInfo, RoundCorner, Row, SpacerRow, SquareCorner, StatementInput, TopRow, Types, };
+export { BottomRow, Connection, Drawer, ExternalValueInput, Field, Hat, Icon, InlineInput, InputConnection, InputRow, InRowSpacer, IPathObject, JaggedEdge, Measurable, NextConnection, OutputConnection, PathObject, PreviousConnection, Renderer, RenderInfo, RoundCorner, Row, SpacerRow, SquareCorner, StatementInput, TopRow, Types, };
 export { BaseShape, ConstantProvider, DynamicShape, InsideCorners, JaggedTeeth, Notch, OutsideCorners, PuzzleTab, StartHat, } from './constants.js';
 //# sourceMappingURL=block_rendering.d.ts.map

package/core/renderers/common/drawer.d.ts

@@ -141,7 +141,7 @@ export declare class Drawer {
      */
     protected updateConnectionHighlights(): void;
     /** Returns a path to highlight the given connection. */
-    drawConnectionHighlightPath(measurable: Connection): void;
+    drawConnectionHighlightPath(measurable: Connection): SVGElement | undefined;
     /**
      * Returns a path to highlight the given conneciton, assuming it is an
      * input or output connection.

package/core/renderers/common/i_path_object.d.ts

@@ -23,16 +23,6 @@ export interface IPathObject {
     constants: ConstantProvider;
     /** The primary path of the block. */
     style: BlockStyle;
-    /**
-     * Holds the cursors SVG element when the cursor is attached to the block.
-     * This is null if there is no cursor on the block.
-     */
-    cursorSvg: SVGElement | null;
-    /**
-     * Holds the markers SVG element when the marker is attached to the block.
-     * This is null if there is no marker on the block.
-     */
-    markerSvg: SVGElement | null;
     /**
      * Set the path generated by the renderer onto the respective SVG element.
      *
@@ -43,20 +33,6 @@ export interface IPathObject {
      * Flip the SVG paths in RTL.
      */
     flipRTL(): 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.
-     */
-    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.
-     */
-    setMarkerSvg(markerSvg: SVGElement): void;
     /**
      * Set whether the block shows a highlight or not.  Block highlighting is
      * often used to visually mark blocks currently being executed.
@@ -90,7 +66,7 @@ export interface IPathObject {
      */
     updateMovable(enabled: boolean): void;
     /** Adds the given path as a connection highlight for the given connection. */
-    addConnectionHighlight?(connection: RenderedConnection, connectionPath: string, offset: Coordinate, rtl: boolean): void;
+    addConnectionHighlight?(connection: RenderedConnection, connectionPath: string, offset: Coordinate, rtl: boolean): SVGElement;
     /**
      * Apply the stored colours to the block's path, taking into account whether
      * the paths belong to a shadow block.

package/core/renderers/common/path_object.d.ts

@@ -17,16 +17,6 @@ import type { IPathObject } from './i_path_object.js';
 export declare class PathObject implements IPathObject {
     svgRoot: SVGElement;
     svgPath: SVGElement;
-    /**
-     * Holds the cursors svg element when the cursor is attached to the block.
-     * This is null if there is no cursor on the block.
-     */
-    cursorSvg: SVGElement | null;
-    /**
-     * Holds the markers svg element when the marker is attached to the block.
-     * This is null if there is no marker on the block.
-     */
-    markerSvg: SVGElement | null;
     constants: ConstantProvider;
     style: BlockStyle;
     /** Highlight paths associated with connections. */
@@ -49,20 +39,6 @@ export declare class PathObject implements IPathObject {
      * Flip the SVG paths in RTL.
      */
     flipRTL(): 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.
-     */
-    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.
-     */
-    setMarkerSvg(markerSvg: SVGElement): void;
     /**
      * Apply the stored colours to the block's path, taking into account whether
      * the paths belong to a shadow block.
@@ -145,8 +121,7 @@ export declare class PathObject implements IPathObject {
      */
     updateShapeForInputHighlight(_conn: Connection, _enable: boolean): void;
     /** Adds the given path as a connection highlight for the given connection. */
-    addConnectionHighlight(connection: RenderedConnection, connectionPath: string, offset: Coordinate, rtl: boolean): void;
-    private currentHighlightMatchesNew;
+    addConnectionHighlight(connection: RenderedConnection, connectionPath: string, offset: Coordinate, rtl: boolean): SVGElement;
     /**
      * Removes any highlight associated with the given connection, if it exists.
      */

package/core/renderers/common/renderer.d.ts

@@ -6,14 +6,11 @@
 import type { BlockSvg } from '../../block_svg.js';
 import { Connection } from '../../connection.js';
 import type { IRegistrable } from '../../interfaces/i_registrable.js';
-import type { Marker } from '../../keyboard_nav/marker.js';
 import type { BlockStyle, Theme } from '../../theme.js';
-import type { WorkspaceSvg } from '../../workspace_svg.js';
 import { ConstantProvider } from './constants.js';
 import { Drawer } from './drawer.js';
 import type { IPathObject } from './i_path_object.js';
 import { RenderInfo } from './info.js';
-import { MarkerSvg } from './marker_svg.js';
 /**
  * The base class for a block renderer.
  */
@@ -98,14 +95,6 @@ export declare class Renderer implements IRegistrable {
      * @returns The drawer.
      */
     protected makeDrawer_(block: BlockSvg, info: RenderInfo): Drawer;
-    /**
-     * Create a new instance of the renderer's marker drawer.
-     *
-     * @param workspace The workspace the marker belongs to.
-     * @param marker The marker.
-     * @returns The object in charge of drawing the marker.
-     */
-    makeMarkerDrawer(workspace: WorkspaceSvg, marker: Marker): MarkerSvg;
     /**
      * Create a new instance of a renderer path object.
      *

package/core/renderers/zelos/drawer.d.ts

@@ -46,6 +46,6 @@ export declare class Drawer extends BaseDrawer {
     private getInlineInputPath;
     drawStatementInput_(row: Row): void;
     /** Returns a path to highlight the given connection. */
-    drawConnectionHighlightPath(measurable: Connection): void;
+    drawConnectionHighlightPath(measurable: Connection): SVGElement | undefined;
 }
 //# sourceMappingURL=drawer.d.ts.map

package/core/renderers/zelos/renderer.d.ts

@@ -4,15 +4,12 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { BlockSvg } from '../../block_svg.js';
-import type { Marker } from '../../keyboard_nav/marker.js';
 import type { BlockStyle } from '../../theme.js';
-import type { WorkspaceSvg } from '../../workspace_svg.js';
 import type { RenderInfo as BaseRenderInfo } from '../common/info.js';
 import { Renderer as BaseRenderer } from '../common/renderer.js';
 import { ConstantProvider } from './constants.js';
 import { Drawer } from './drawer.js';
 import { RenderInfo } from './info.js';
-import { MarkerSvg } from './marker_svg.js';
 import { PathObject } from './path_object.js';
 /**
  * The zelos renderer. This renderer emulates Scratch-style and MakeCode-style
@@ -48,14 +45,6 @@ export declare class Renderer extends BaseRenderer {
      * @returns The drawer.
      */
     protected makeDrawer_(block: BlockSvg, info: BaseRenderInfo): Drawer;
-    /**
-     * Create a new instance of the renderer's cursor drawer.
-     *
-     * @param workspace The workspace the cursor belongs to.
-     * @param marker The marker.
-     * @returns The object in charge of drawing the marker.
-     */
-    makeMarkerDrawer(workspace: WorkspaceSvg, marker: Marker): MarkerSvg;
     /**
      * Create a new instance of a renderer path object.
      *

package/core/renderers/zelos/zelos.d.ts

@@ -7,12 +7,11 @@
 import { ConstantProvider } from './constants.js';
 import { Drawer } from './drawer.js';
 import { RenderInfo } from './info.js';
-import { MarkerSvg } from './marker_svg.js';
 import { BottomRow } from './measurables/bottom_row.js';
 import { StatementInput } from './measurables/inputs.js';
 import { RightConnectionShape } from './measurables/row_elements.js';
 import { TopRow } from './measurables/top_row.js';
 import { PathObject } from './path_object.js';
 import { Renderer } from './renderer.js';
-export { BottomRow, ConstantProvider, Drawer, MarkerSvg, PathObject, Renderer, RenderInfo, RightConnectionShape, StatementInput, TopRow, };
+export { BottomRow, ConstantProvider, Drawer, PathObject, Renderer, RenderInfo, RightConnectionShape, StatementInput, TopRow, };
 //# sourceMappingURL=zelos.d.ts.map

package/core/shortcut_registry.d.ts

@@ -9,6 +9,7 @@
  *
  * @class
  */
+import { Scope } from './contextmenu_registry.js';
 import { KeyCodes } from './utils/keycodes.js';
 import { WorkspaceSvg } from './workspace_svg.js';
 /**
@@ -183,12 +184,14 @@ export declare namespace ShortcutRegistry {
          * @param e The event that caused the shortcut to be activated.
          * @param shortcut The `KeyboardShortcut` that was activated
          *     (i.e., the one this callback is attached to).
+         * @param scope Information about the focused item when the
+         * shortcut was invoked.
          * @returns Returning true ends processing of the invoked keycode.
          *     Returning false causes processing to continue with the
          *     next-most-recently registered shortcut for the invoked
          *     keycode.
          */
-        callback?: (workspace: WorkspaceSvg, e: Event, shortcut: KeyboardShortcut) => boolean;
+        callback?: (workspace: WorkspaceSvg, e: Event, shortcut: KeyboardShortcut, scope: Scope) => boolean;
         /** The name of the shortcut.  Should be unique. */
         name: string;
         /**
@@ -198,9 +201,11 @@ export declare namespace ShortcutRegistry {
          *
          * @param workspace The `WorkspaceSvg` where the shortcut was
          *     invoked.
+         * @param scope Information about the focused item when the
+         * shortcut would be invoked.
          * @returns True iff `callback` function should be called.
          */
-        preconditionFn?: (workspace: WorkspaceSvg) => boolean;
+        preconditionFn?: (workspace: WorkspaceSvg, scope: Scope) => boolean;
         /** Optional arbitray extra data attached to the shortcut. */
         metadata?: object;
         /**

package/core/toast.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { WorkspaceSvg } from './workspace_svg.js';
+/**
+ * Display/configuration options for a toast notification.
+ */
+export interface ToastOptions {
+    /**
+     * Toast ID. If set along with `oncePerSession`, will cause subsequent toasts
+     * with this ID to not be shown.
+     */
+    id?: string;
+    /**
+     * Flag to show the toast once per session only.
+     * Subsequent calls are ignored.
+     */
+    oncePerSession?: boolean;
+    /**
+     * Text of the message to display on the toast.
+     */
+    message: string;
+    /**
+     * Duration in seconds before the toast is removed. Defaults to 5.
+     */
+    duration?: number;
+    /**
+     * How prominently/interrupting the readout of the toast should be for
+     * screenreaders. Corresponds to aria-live and defaults to polite.
+     */
+    assertiveness?: Toast.Assertiveness;
+}
+/**
+ * Class that allows for showing and dismissing temporary notifications.
+ */
+export declare class Toast {
+    /** IDs of toasts that have previously been shown. */
+    private static shownIds;
+    /**
+     * Shows a toast notification.
+     *
+     * @param workspace The workspace to show the toast on.
+     * @param options Configuration options for the toast message, duration, etc.
+     */
+    static show(workspace: WorkspaceSvg, options: ToastOptions): void;
+    /**
+     * Creates the DOM representation of a toast.
+     *
+     * @param workspace The workspace to inject the toast notification onto.
+     * @param options Configuration options for the toast.
+     * @returns The root DOM element of the toast.
+     */
+    protected static createDom(workspace: WorkspaceSvg, options: ToastOptions): HTMLDivElement;
+    /**
+     * Dismiss a toast, e.g. in response to a user action.
+     *
+     * @param workspace The workspace to dismiss a toast in.
+     * @param id The toast ID, or undefined to clear any toast.
+     */
+    static hide(workspace: WorkspaceSvg, id?: string): void;
+}
+/**
+ * Options for how aggressively toasts should be read out by screenreaders.
+ * Values correspond to those for aria-live.
+ */
+export declare namespace Toast {
+    enum Assertiveness {
+        ASSERTIVE = "assertive",
+        POLITE = "polite"
+    }
+}
+//# sourceMappingURL=toast.d.ts.map

package/core/toolbox/toolbox.d.ts

@@ -9,6 +9,8 @@ import '../events/events_toolbox_item_select.js';
 import type { IAutoHideable } from '../interfaces/i_autohideable.js';
 import type { IDraggable } from '../interfaces/i_draggable.js';
 import type { IFlyout } from '../interfaces/i_flyout.js';
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
+import type { IFocusableTree } from '../interfaces/i_focusable_tree.js';
 import type { IKeyboardAccessible } from '../interfaces/i_keyboard_accessible.js';
 import type { ISelectableToolboxItem } from '../interfaces/i_selectable_toolbox_item.js';
 import type { IStyleable } from '../interfaces/i_styleable.js';
@@ -22,7 +24,7 @@ import type { WorkspaceSvg } from '../workspace_svg.js';
  * Class for a Toolbox.
  * Creates the toolbox's DOM.
  */
-export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeyboardAccessible, IStyleable, IToolbox {
+export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeyboardAccessible, IStyleable, IToolbox, IFocusableNode {
     /**
      * The unique ID for this component that is used to register with the
      * ComponentManager.
@@ -389,5 +391,25 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     private selectPrevious;
     /** Disposes of this toolbox. */
     dispose(): void;
+    /** See IFocusableNode.getFocusableElement. */
+    getFocusableElement(): HTMLElement | SVGElement;
+    /** See IFocusableNode.getFocusableTree. */
+    getFocusableTree(): IFocusableTree;
+    /** See IFocusableNode.onNodeFocus. */
+    onNodeFocus(): void;
+    /** See IFocusableNode.onNodeBlur. */
+    onNodeBlur(): void;
+    /** See IFocusableTree.getRootFocusableNode. */
+    getRootFocusableNode(): IFocusableNode;
+    /** See IFocusableTree.getRestoredFocusableNode. */
+    getRestoredFocusableNode(previousNode: IFocusableNode | null): IFocusableNode | null;
+    /** See IFocusableTree.getNestedTrees. */
+    getNestedTrees(): Array<IFocusableTree>;
+    /** See IFocusableTree.lookUpFocusableNode. */
+    lookUpFocusableNode(id: string): IFocusableNode | null;
+    /** See IFocusableTree.onTreeFocus. */
+    onTreeFocus(node: IFocusableNode, _previousTree: IFocusableTree | null): void;
+    /** See IFocusableTree.onTreeBlur. */
+    onTreeBlur(_nextTree: IFocusableTree | null): void;
 }
 //# sourceMappingURL=toolbox.d.ts.map