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

package/core/field.d.ts

@@ -13,8 +13,8 @@
 import './events/events_block_change.js';
 import type { Block } from './block.js';
 import type { Input } from './inputs/input.js';
-import type { IASTNodeLocationSvg } from './interfaces/i_ast_node_location_svg.js';
-import type { IASTNodeLocationWithBlock } from './interfaces/i_ast_node_location_with_block.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 { IRegistrable } from './interfaces/i_registrable.js';
 import { ISerializable } from './interfaces/i_serializable.js';
@@ -45,7 +45,7 @@ export type FieldValidator<T = any> = (newValue: T) => T | null | undefined;
  *
  * @typeParam T - The value stored on the field.
  */
-export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IASTNodeLocationWithBlock, IKeyboardAccessible, IRegistrable, ISerializable {
+export declare abstract class Field<T = any> implements IKeyboardAccessible, IRegistrable, ISerializable, IFocusableNode {
     /**
      * To overwrite the default value which is set in **Field**, directly update
      * the prototype.
@@ -54,6 +54,8 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      * `FieldImage.prototype.DEFAULT_VALUE = null;`
      */
     DEFAULT_VALUE: T | null;
+    /** Non-breaking space. */
+    static readonly NBSP = "\u00A0";
     /**
      * A value used to signal when a field's constructor should *not* set the
      * field's value or run configure_, and should allow a subclass to do that
@@ -73,17 +75,21 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      * field is not yet initialized. Is *not* guaranteed to be accurate.
      */
     private tooltip;
-    protected size_: Size;
+    /** This field's dimensions. */
+    private size;
     /**
-     * Holds the cursors svg element when the cursor is attached to the field.
-     * This is null if there is no cursor on the field.
+     * Gets the size of this field. Because getSize() and updateSize() have side
+     * effects, this acts as a shim for subclasses which wish to adjust field
+     * bounds when setting/getting the size without triggering unwanted rendering
+     * or other side effects. Note that subclasses must override *both* get and
+     * set if either is overridden; the implementation may just call directly
+     * through to super, but it must exist per the JS spec.
      */
-    private cursorSvg;
+    protected get size_(): Size;
     /**
-     * Holds the markers svg element when the marker is attached to the field.
-     * This is null if there is no marker on the field.
+     * Sets the size of this field.
      */
-    private markerSvg;
+    protected set size_(newValue: Size);
     /** The rendered field's SVG group element. */
     protected fieldGroup_: SVGGElement | null;
     /** The rendered field's SVG border element. */
@@ -139,6 +145,8 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      * case by default so that SERIALIZABLE is backwards compatible.
      */
     SERIALIZABLE: boolean;
+    /** The unique ID of this field. */
+    private id_;
     /**
      * @param value The initial value of the field.
      *     Also accepts Field.SKIP_SETUP if you wish to skip setup (only used by
@@ -669,26 +677,16 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      * @returns True if the shortcut has been handled, false otherwise.
      */
     onShortcut(_shortcut: KeyboardShortcut): boolean;
-    /**
-     * Add the cursor SVG to this fields SVG group.
-     *
-     * @param cursorSvg The SVG root of the cursor to be added to the field group.
-     * @internal
-     */
-    setCursorSvg(cursorSvg: SVGElement): void;
-    /**
-     * Add the marker SVG to this fields SVG group.
-     *
-     * @param markerSvg The SVG root of the marker to be added to the field group.
-     * @internal
-     */
-    setMarkerSvg(markerSvg: SVGElement): void;
-    /**
-     * Redraw any attached marker or cursor svgs if needed.
-     *
-     * @internal
-     */
-    updateMarkers_(): 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;
     /**
      * Subclasses should reimplement this method to construct their Field
      * subclass from a JSON arg object.

package/core/field_dropdown.d.ts

@@ -144,6 +144,13 @@ export declare class FieldDropdown extends Field<string> {
      * @throws {TypeError} If generated options are incorrectly structured.
      */
     getOptions(useCache?: boolean): MenuOption[];
+    /**
+     * Update the options on this dropdown. This will reset the selected item to
+     * the first item in the list.
+     *
+     * @param menuGenerator The array of options or a generator function.
+     */
+    setOptions(menuGenerator: MenuGenerator): void;
     /**
      * Ensure that the input value is a valid language-neutral option.
      *
@@ -184,7 +191,13 @@ export declare class FieldDropdown extends Field<string> {
     /**
      * Use the `getText_` developer hook to override the field's text
      * representation.  Get the selected option text.  If the selected option is
-     * an image we return the image alt text.
+     * an image we return the image alt text. If the selected option is
+     * an HTMLElement, return the title, ariaLabel, or innerText of the
+     * element.
+     *
+     * If you use HTMLElement options in Node.js and call this function,
+     * ensure that you are supplying an implementation of HTMLElement,
+     * such as through jsdom-global.
      *
      * @returns Selected option text.
      */
@@ -239,9 +252,10 @@ export interface ImageProperties {
  * An individual option in the dropdown menu. Can be either the string literal
  * `separator` for a menu separator item, or an array for normal action menu
  * items. In the latter case, the first element is the human-readable value
- * (text or image), and the second element is the language-neutral value.
+ * (text, ImageProperties object, or HTML element), and the second element is
+ * the language-neutral value.
  */
-export type MenuOption = [string | ImageProperties, string] | 'separator';
+export type MenuOption = [string | ImageProperties | HTMLElement, string] | 'separator';
 /**
  * A function that generates an array of menu options for FieldDropdown
  * or its descendants.

package/core/field_image.d.ts

@@ -9,7 +9,6 @@
  * @class
  */
 import { Field, FieldConfig } from './field.js';
-import { Size } from './utils/size.js';
 /**
  * Class for an image on a block.
  */
@@ -19,7 +18,6 @@ export declare class FieldImage extends Field<string> {
      * of the field.
      */
     private static readonly Y_PADDING;
-    protected size_: Size;
     protected readonly imageHeight: number;
     /** The function to be called when this field is clicked. */
     private clickHandler;

package/core/field_input.d.ts

@@ -62,6 +62,15 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      * are not. Editable fields should also be serializable.
      */
     SERIALIZABLE: boolean;
+    /**
+     * Sets the size of this field. Although this appears to be a no-op, it must
+     * exist since the getter is overridden below.
+     */
+    protected set size_(newValue: Size);
+    /**
+     * Returns the size of this field, with a minimum width of 14.
+     */
+    protected get size_(): Size;
     /**
      * @param value The initial value of the field. Should cast to a string.
      *     Defaults to an empty string if null or undefined. Also accepts

package/core/field_variable.d.ts

@@ -15,7 +15,6 @@ import { FieldDropdown, FieldDropdownValidator, MenuGenerator, MenuOption } from
 import { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
 import type { Menu } from './menu.js';
 import type { MenuItem } from './menuitem.js';
-import { Size } from './utils/size.js';
 /**
  * Class for a variable's dropdown field.
  */
@@ -29,7 +28,6 @@ export declare class FieldVariable extends FieldDropdown {
      * dropdown.
      */
     variableTypes: string[] | null;
-    protected size_: Size;
     /** The variable model associated with this field. */
     private variable;
     /**

package/core/flyout_base.d.ts

@@ -14,6 +14,8 @@ import { FlyoutItem } from './flyout_item.js';
 import { IAutoHideable } from './interfaces/i_autohideable.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
 import type { IFlyoutInflater } from './interfaces/i_flyout_inflater.js';
+import { IFocusableNode } from './interfaces/i_focusable_node.js';
+import type { IFocusableTree } from './interfaces/i_focusable_tree.js';
 import type { Options } from './options.js';
 import * as blocks from './serialization/blocks.js';
 import { Coordinate } from './utils/coordinate.js';
@@ -23,7 +25,7 @@ import { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for a flyout.
  */
-export declare abstract class Flyout extends DeleteArea implements IAutoHideable, IFlyout {
+export declare abstract class Flyout extends DeleteArea implements IAutoHideable, IFlyout, IFocusableNode {
     /**
      * Position the flyout.
      */
@@ -399,5 +401,27 @@ export declare abstract class Flyout extends DeleteArea implements IAutoHideable
      *     is registered for that type.
      */
     protected getInflaterForType(type: string): IFlyoutInflater | null;
+    /** 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;
+    /** 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=flyout_base.d.ts.map

package/core/flyout_button.d.ts

@@ -3,13 +3,9 @@
  * Copyright 2016 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Class for a button in the flyout.
- *
- * @class
- */
-import type { IASTNodeLocationSvg } from './blockly.js';
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
+import type { IFocusableTree } from './interfaces/i_focusable_tree.js';
 import type { IRenderedElement } from './interfaces/i_rendered_element.js';
 import { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';
@@ -18,7 +14,7 @@ import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for a button or label in the flyout.
  */
-export declare class FlyoutButton implements IASTNodeLocationSvg, IBoundedElement, IRenderedElement {
+export declare class FlyoutButton implements IBoundedElement, IRenderedElement, IFocusableNode {
     private readonly workspace;
     private readonly targetWorkspace;
     private readonly isFlyoutLabel;
@@ -49,6 +45,8 @@ export declare class FlyoutButton implements IASTNodeLocationSvg, IBoundedElemen
      * This is null if there is no cursor on the button.
      */
     cursorSvg: SVGElement | null;
+    /** The unique ID for this FlyoutButton. */
+    private id;
     /**
      * @param workspace The workspace in which to place this button.
      * @param targetWorkspace The flyout's target workspace.
@@ -116,12 +114,6 @@ export declare class FlyoutButton implements IASTNodeLocationSvg, IBoundedElemen
      *     group.
      */
     setCursorSvg(cursorSvg: SVGElement): void;
-    /**
-     * Required by IASTNodeLocationSvg, but not used. A marker cannot be set on a
-     * button. If the 'mark' shortcut is used on a button, its associated callback
-     * function is triggered.
-     */
-    setMarkerSvg(): void;
     /**
      * Do something when the button is clicked.
      *
@@ -133,5 +125,15 @@ export declare class FlyoutButton implements IASTNodeLocationSvg, IBoundedElemen
      * @returns The root SVG element of this rendered element.
      */
     getSvgRoot(): SVGGElement;
+    /** 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=flyout_button.d.ts.map

package/core/flyout_item.d.ts

@@ -1,32 +1,26 @@
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
 /**
  * Representation of an item displayed in a flyout.
  */
 export declare class FlyoutItem {
     private element;
     private type;
-    private focusable;
     /**
      * Creates a new FlyoutItem.
      *
      * @param element The element that will be displayed in the flyout.
      * @param type The type of element. Should correspond to the type of the
      *     flyout inflater that created this object.
-     * @param focusable True if the element should be allowed to be focused by
-     *     e.g. keyboard navigation in the flyout.
      */
-    constructor(element: IBoundedElement, type: string, focusable: boolean);
+    constructor(element: IBoundedElement & IFocusableNode, type: string);
     /**
      * Returns the element displayed in the flyout.
      */
-    getElement(): IBoundedElement;
+    getElement(): IBoundedElement & IFocusableNode;
     /**
      * Returns the type of flyout element this item represents.
      */
     getType(): string;
-    /**
-     * Returns whether or not the flyout element can receive focus.
-     */
-    isFocusable(): boolean;
 }
 //# sourceMappingURL=flyout_item.d.ts.map

package/core/flyout_navigator.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IFlyout } from './interfaces/i_flyout.js';
+import { Navigator } from './navigator.js';
+export declare class FlyoutNavigator extends Navigator {
+    constructor(flyout: IFlyout);
+}
+//# sourceMappingURL=flyout_navigator.d.ts.map

package/core/flyout_separator.d.ts

@@ -4,11 +4,13 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
+import type { IFocusableTree } from './interfaces/i_focusable_tree.js';
 import { Rect } from './utils/rect.js';
 /**
  * Representation of a gap between elements in a flyout.
  */
-export declare class FlyoutSeparator implements IBoundedElement {
+export declare class FlyoutSeparator implements IBoundedElement, IFocusableNode {
     private gap;
     private axis;
     private x;
@@ -34,6 +36,23 @@ export declare class FlyoutSeparator implements IBoundedElement {
      * @param _reason The reason this move was initiated.
      */
     moveBy(dx: number, dy: number, _reason?: string[]): void;
+    /**
+     * Returns false to prevent this separator from being navigated to by the
+     * keyboard.
+     *
+     * @returns False.
+     */
+    isNavigable(): boolean;
+    /** 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;
 }
 /**
  * Representation of an axis along which a separator occupies space.

package/core/focus_manager.d.ts

@@ -49,9 +49,12 @@ export declare class FocusManager {
      * using this constant directly (generally it never should need to be used).
      */
     static readonly PASSIVE_FOCUS_NODE_CSS_CLASS_NAME = "blocklyPassiveFocus";
-    focusedNode: IFocusableNode | null;
-    registeredTrees: Array<IFocusableTree>;
+    private focusedNode;
+    private previouslyFocusedNode;
+    private registeredTrees;
     private currentlyHoldsEphemeralFocus;
+    private lockFocusStateChanges;
+    private recentlyLostAllFocus;
     constructor(addGlobalEventListener: (type: string, listener: EventListener) => void);
     /**
      * Registers a new IFocusableTree for automatic focus management.
@@ -120,17 +123,20 @@ export declare class FocusManager {
      */
     focusTree(focusableTree: IFocusableTree): void;
     /**
-     * Focuses DOM input on the selected node, and marks it as actively focused.
+     * Focuses DOM input on the specified node, and marks it as actively focused.
      *
      * Any previously focused node will be updated to be passively highlighted (if
      * it's in a different focusable tree) or blurred (if it's in the same one).
      *
-     * @param focusableNode The node that should receive active
-     *     focus.
+     * **Important**: If the provided node is not able to be focused (e.g. its
+     * canBeFocused() method returns false), it will be ignored and any existing
+     * focus state will remain unchanged.
+     *
+     * @param focusableNode The node that should receive active focus.
      */
     focusNode(focusableNode: IFocusableNode): void;
     /**
-     * Ephemerally captures focus for a selected element until the returned lambda
+     * Ephemerally captures focus for a specific element until the returned lambda
      * is called. This is expected to be especially useful for ephemeral UI flows
      * like dialogs.
      *
@@ -148,16 +154,82 @@ export declare class FocusManager {
      * simultaneously will result in an error being thrown).
      */
     takeEphemeralFocus(focusableElement: HTMLElement | SVGElement): ReturnEphemeralFocus;
+    /**
+     * Ensures that the manager is currently allowing operations that change its
+     * internal focus state (such as via focusNode()).
+     *
+     * If the manager is currently not allowing state changes, an exception is
+     * thrown.
+     */
+    private ensureManagerIsUnlocked;
+    /**
+     * Updates the internally tracked focused node to the specified node, or null
+     * if focus is being lost. This also updates previous focus tracking.
+     *
+     * @param newFocusedNode The new node to set as focused.
+     */
+    private updateFocusedNode;
+    /**
+     * Defocuses the current actively focused node tracked by the manager, iff
+     * there's a node being tracked and the manager doesn't have ephemeral focus.
+     */
     private defocusCurrentFocusedNode;
-    private setNodeToActive;
-    private setNodeToPassive;
+    /**
+     * Marks the specified node as actively focused, also calling related
+     * lifecycle callback methods for both the node and its parent tree. This
+     * ensures that the node is properly styled to indicate its active focus.
+     *
+     * This does not change the manager's currently tracked node, nor does it
+     * change any other nodes.
+     *
+     * @param node The node to be actively focused.
+     * @param prevTree The tree of the previously actively focused node, or null
+     *     if there wasn't a previously actively focused node.
+     */
+    private activelyFocusNode;
+    /**
+     * Marks the specified node as passively focused, also calling related
+     * lifecycle callback methods for both the node and its parent tree. This
+     * ensures that the node is properly styled to indicate its passive focus.
+     *
+     * This does not change the manager's currently tracked node, nor does it
+     * change any other nodes.
+     *
+     * @param node The node to be passively focused.
+     * @param nextTree The tree of the node receiving active focus, or null if no
+     *     node will be actively focused.
+     */
+    private passivelyFocusNode;
+    /**
+     * Updates the node's styling to indicate that it should have an active focus
+     * indicator.
+     *
+     * @param node The node to be styled for active focus.
+     */
+    private setNodeToVisualActiveFocus;
+    /**
+     * Updates the node's styling to indicate that it should have a passive focus
+     * indicator.
+     *
+     * @param node The node to be styled for passive focus.
+     */
+    private setNodeToVisualPassiveFocus;
+    /**
+     * Removes any active/passive indicators for the specified node.
+     *
+     * @param node The node which should have neither passive nor active focus
+     *     indication.
+     */
     private removeHighlight;
+    private static focusManager;
+    /**
+     * Returns the page-global FocusManager.
+     *
+     * The returned instance is guaranteed to not change across function calls,
+     * but may change across page loads.
+     */
+    static getFocusManager(): FocusManager;
 }
-/**
- * Returns the page-global FocusManager.
- *
- * The returned instance is guaranteed to not change across function calls, but
- * may change across page loads.
- */
+/** Convenience function for FocusManager.getFocusManager. */
 export declare function getFocusManager(): FocusManager;
 //# sourceMappingURL=focus_manager.d.ts.map

package/core/icons/comment_icon.d.ts

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Block } from '../block.js';
+import type { IBubble } from '../interfaces/i_bubble.js';
 import type { IHasBubble } from '../interfaces/i_has_bubble.js';
 import type { ISerializable } from '../interfaces/i_serializable.js';
 import { Coordinate } from '../utils.js';
@@ -92,6 +93,8 @@ export declare class CommentIcon extends Icon implements IHasBubble, ISerializab
     onBubbleLocationChange(): void;
     bubbleIsVisible(): boolean;
     setBubbleVisible(visible: boolean): Promise<void>;
+    /** See IHasBubble.getBubble. */
+    getBubble(): IBubble | null;
     /**
      * Shows the editable text bubble for this comment, and adds change listeners
      * to update the state of this icon in response to changes in the bubble.

package/core/icons/icon.d.ts

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Block } from '../block.js';
+import type { IFocusableTree } from '../interfaces/i_focusable_tree.js';
 import type { IIcon } from '../interfaces/i_icon.js';
 import * as tooltip from '../tooltip.js';
 import { Coordinate } from '../utils/coordinate.js';
@@ -28,6 +29,8 @@ export declare abstract class Icon implements IIcon {
     protected svgRoot: SVGGElement | null;
     /** The tooltip for this icon. */
     protected tooltip: tooltip.TipInfo;
+    /** The unique ID of this icon. */
+    private id;
     constructor(sourceBlock: Block);
     getType(): IconType<IIcon>;
     initView(pointerdownListener: (e: PointerEvent) => void): void;
@@ -59,5 +62,15 @@ export declare abstract class Icon implements IIcon {
      * @returns Whether the icon should be clickable while the block is in a flyout.
      */
     isClickableInFlyout(autoClosingFlyout: boolean): boolean;
+    /** 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=icon.d.ts.map

package/core/icons/mutator_icon.d.ts

@@ -5,6 +5,7 @@
  */
 import type { BlockSvg } from '../block_svg.js';
 import type { Abstract } from '../events/events_abstract.js';
+import type { IBubble } from '../interfaces/i_bubble.js';
 import type { IHasBubble } from '../interfaces/i_has_bubble.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Size } from '../utils/size.js';
@@ -54,6 +55,8 @@ export declare class MutatorIcon extends Icon implements IHasBubble {
     isClickableInFlyout(): boolean;
     bubbleIsVisible(): boolean;
     setBubbleVisible(visible: boolean): Promise<void>;
+    /** See IHasBubble.getBubble. */
+    getBubble(): IBubble | null;
     /** @returns the configuration the mini workspace should have. */
     private getMiniWorkspaceConfig;
     /**

package/core/icons/warning_icon.d.ts

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { BlockSvg } from '../block_svg.js';
+import type { IBubble } from '../interfaces/i_bubble.js';
 import type { IHasBubble } from '../interfaces/i_has_bubble.js';
 import { Size } from '../utils.js';
 import { Coordinate } from '../utils/coordinate.js';
@@ -60,6 +61,8 @@ export declare class WarningIcon extends Icon implements IHasBubble {
     isClickableInFlyout(): boolean;
     bubbleIsVisible(): boolean;
     setBubbleVisible(visible: boolean): Promise<void>;
+    /** See IHasBubble.getBubble. */
+    getBubble(): IBubble | null;
     /**
      * @returns the location the bubble should be anchored to.
      *     I.E. the middle of this icon.

package/core/interfaces/i_autohideable.d.ts

@@ -16,4 +16,6 @@ export interface IAutoHideable extends IComponent {
      */
     autoHide(onlyClosePopups: boolean): void;
 }
+/** Returns true if the given object is autohideable. */
+export declare function isAutoHideable(obj: any): obj is IAutoHideable;
 //# sourceMappingURL=i_autohideable.d.ts.map

package/core/interfaces/i_bubble.d.ts

@@ -6,10 +6,11 @@
 import type { Coordinate } from '../utils/coordinate.js';
 import type { IContextMenu } from './i_contextmenu.js';
 import type { IDraggable } from './i_draggable.js';
+import { IFocusableNode } from './i_focusable_node.js';
 /**
  * A bubble interface.
  */
-export interface IBubble extends IDraggable, IContextMenu {
+export interface IBubble extends IDraggable, IContextMenu, IFocusableNode {
     /**
      * Return the coordinates of the top-left corner of this bubble's body
      * relative to the drawing surface's origin (0,0), in workspace units.

package/core/interfaces/i_flyout.d.ts

@@ -9,11 +9,12 @@ import type { Coordinate } from '../utils/coordinate.js';
 import type { Svg } from '../utils/svg.js';
 import type { FlyoutDefinition } from '../utils/toolbox.js';
 import type { WorkspaceSvg } from '../workspace_svg.js';
+import { IFocusableTree } from './i_focusable_tree.js';
 import type { IRegistrable } from './i_registrable.js';
 /**
  * Interface for a flyout.
  */
-export interface IFlyout extends IRegistrable {
+export interface IFlyout extends IRegistrable, IFocusableTree {
     /** Whether the flyout is laid out horizontally or not. */
     horizontalLayout: boolean;
     /** Is RTL vs LTR. */