blockly 12.5.1 → 13.0.0-beta.1

package/core/block.d.ts

@@ -548,6 +548,7 @@ export declare class Block {
     /**
      * Return all variables referenced by this block.
      *
+     * @deprecated v13: Use Blockly.Block.getVarModels().map(m => m.getId())
      * @returns List of variable ids.
      */
     getVars(): string[];
@@ -555,7 +556,6 @@ export declare class Block {
      * Return all variables referenced by this block.
      *
      * @returns List of variable models.
-     * @internal
      */
     getVarModels(): IVariableModel<IVariableState>[];
     /**

package/core/block_aria_composer.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @license
+ * Copyright 2026 Raspberry Pi Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from './block_svg.js';
+import { RenderedConnection } from './blockly.js';
+import type { Input } from './inputs/input.js';
+import { Verbosity } from './utils/aria.js';
+/**
+ * Prepositions to use when describing the relationship between two blocks based
+ * on their connection types.
+ */
+export declare enum ConnectionPreposition {
+    UNKNOWN = 0,
+    BEFORE = 1,
+    AFTER = 2,
+    AROUND = 3,
+    INSIDE = 4
+}
+/**
+ * Returns an ARIA representation of the specified block.
+ *
+ * The returned label will contain a complete context of the block, including:
+ * - Whether it begins a block stack or statement input stack.
+ * - Its constituent editable and non-editable fields.
+ * - Properties, including: disabled, collapsed, replaceable (a shadow), etc.
+ * - Its parent toolbox category.
+ * - Whether it has inputs.
+ *
+ * Beyond this, the returned label is specifically assembled with commas in
+ * select locations with the intention of better 'prosody' in the screen reader
+ * readouts since there's a lot of information being shared with the user. The
+ * returned label also places more important information earlier in the label so
+ * that the user gets the most important context as soon as possible in case
+ * they wish to stop readout early.
+ *
+ * The returned label will be specialized based on whether the block is part of a
+ * flyout.
+ *
+ * @internal
+ * @param block The block for which an ARIA representation should be created.
+ * @param verbosity How much detail to include in the description.
+ * @returns The ARIA representation for the specified block.
+ */
+export declare function computeAriaLabel(block: BlockSvg, verbosity?: Verbosity): string;
+/**
+ * Sets the ARIA role and role description for the specified block, accounting
+ * for whether the block is part of a flyout.
+ *
+ * @internal
+ * @param block The block to set ARIA role and roledescription attributes on.
+ */
+export declare function configureAriaRole(block: BlockSvg): void;
+/**
+ * Returns a list of ARIA labels for the 'field row' for the specified Input.
+ *
+ * 'Field row' essentially means the horizontal run of readable fields that
+ * precede the Input. Together, these provide the domain context for the input,
+ * particularly in the context of connections. In some cases, there may not be
+ * any readable fields immediately prior to the Input. In that case, if the
+ * `lookback` attribute is specified, all of the fields on the row immediately
+ * above the Input will be used instead.
+ *
+ * @internal
+ * @param input The Input to compute a description/context label for.
+ * @param lookback If true, will use labels for fields on the previous row if
+ *     the given input's row has no fields itself.
+ * @returns A list of labels for fields on the same row (or previous row, if
+ *     lookback is specified) as the given input.
+ */
+export declare function computeFieldRowLabel(input: Input, lookback: boolean, verbosity?: Verbosity): string[];
+/**
+ * Returns a list of accessibility labels for fields and inputs on a block.
+ * Each entry in the returned array corresponds to one of: (a) a label for a
+ * continuous run of non-interactable fields, (b) a label for an editable field,
+ * (c) a label for an input. When an input contains nested blocks/fields/inputs,
+ * their contents are returned as a single item in the array per top-level
+ * input.
+ *
+ * @internal
+ * @param block The block to retrieve a list of field/input labels for.
+ * @returns A list of field/input labels for the given block.
+ */
+export declare function getInputLabels(block: BlockSvg, verbosity?: Verbosity): string[];
+/**
+ * Returns a subset of labels for inputs on the given block, ending at the
+ * specified input.
+ *
+ * The subset is determined based on the input type:
+ * - For non-statement inputs, only the label for the given input is returned.
+ * - For statement inputs, labels are collected from the start of the current
+ *   statement section up to and including the given input. A statement section
+ *   begins immediately after the previous statement input, or at the start of
+ *   the block if none exists.
+ *
+ * @internal
+ * @param block The block to retrieve a list of field/input labels for.
+ * @param input The input that defines the end of the subset.
+ * @returns A list of field/input labels for the given block.
+ */
+export declare function getInputLabelsSubset(block: BlockSvg, input: Input, verbosity?: Verbosity): string[];
+/**
+ * Returns a translated string describing an in-progress move of a block to a new
+ * connection, suitable for announcement on the ARIA live region. The returned string
+ * will be assembled based on the types of the local and neighbour connections and
+ * the presence of any readable fields on the block's inputs. If multiple potential
+ * candidate connections are present, additional context will be included in the
+ * returned string to help disambiguate between them.
+ *
+ * @param local The moving side of the candidate connection pair
+ * @param neighbour The target side of the candidate connection pair
+ * @param disambiguationPolicy A function that determines whether it's useful to
+ *     include parent input labels for disambiguation.
+ * @param isMoveStart Whether this announcement is for the start of a move. If false,
+ *     skip announcing the block label since it should have already been announced.
+ */
+export declare function computeMoveLabel(local: RenderedConnection, neighbour: RenderedConnection, disambiguationPolicy: (forLocal: boolean) => boolean, isMoveStart?: boolean): string;
+//# sourceMappingURL=block_aria_composer.d.ts.map

package/core/block_svg.d.ts

@@ -21,13 +21,14 @@ 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 { DragDisposition, 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';
 import type { BlockStyle } from './theme.js';
+import * as aria from './utils/aria.js';
 import { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';
 import { FlyoutItemInfo } from './utils/toolbox.js';
@@ -100,9 +101,9 @@ export declare class BlockSvg extends Block implements IBoundedElement, IContext
     readonly rendered = true;
     private visuallyDisabled;
     workspace: WorkspaceSvg;
-    outputConnection: RenderedConnection;
-    nextConnection: RenderedConnection;
-    previousConnection: RenderedConnection;
+    outputConnection: RenderedConnection | null;
+    nextConnection: RenderedConnection | null;
+    previousConnection: RenderedConnection | null;
     private translation;
     /** Whether this block is currently being dragged. */
     private dragging;
@@ -301,6 +302,10 @@ export declare class BlockSvg extends Block implements IBoundedElement, IContext
      * @internal
      */
     setDragging(adding: boolean): void;
+    /**
+     * Returns whether or not this block is currently being dragged.
+     */
+    isDragging(): boolean;
     /**
      * Set whether this block is movable or not.
      *
@@ -688,15 +693,6 @@ export declare class BlockSvg extends Block implements IBoundedElement, IContext
      * @internal
      */
     fadeForReplacement(add: boolean): void;
-    /**
-     * Visual effect to show that if the dragging block is dropped it will connect
-     * to this input.
-     *
-     * @param conn The connection on the input to highlight.
-     * @param add True if highlighting should be added.
-     * @internal
-     */
-    highlightShapeForInput(conn: RenderedConnection, add: boolean): void;
     /**
      * Returns the drag strategy currently in use by this block.
      *
@@ -711,11 +707,11 @@ export declare class BlockSvg extends Block implements IBoundedElement, IContext
     /** Returns whether this block is movable or not. */
     isMovable(): boolean;
     /** Starts a drag on the block. */
-    startDrag(e?: PointerEvent): void;
+    startDrag(e?: PointerEvent | KeyboardEvent): IDraggable;
     /** Drags the block to the given location. */
-    drag(newLoc: Coordinate, e?: PointerEvent): void;
+    drag(newLoc: Coordinate, e?: PointerEvent | KeyboardEvent): void;
     /** Ends the drag on the block. */
-    endDrag(e?: PointerEvent): void;
+    endDrag(e: PointerEvent | KeyboardEvent | undefined, disposition: DragDisposition): void;
     /** Moves the block back to where it was at the start of a drag. */
     revertDrag(): void;
     /**
@@ -733,5 +729,52 @@ export declare class BlockSvg extends Block implements IBoundedElement, IContext
     onNodeBlur(): void;
     /** See IFocusableNode.canBeFocused. */
     canBeFocused(): boolean;
+    /**
+     * Handles the user acting on this block via keyboard navigation.
+     * If this block is in the flyout, a new copy is spawned in move mode on the
+     * main workspace. If this block has a single full-block field, that field
+     * will be focused. Otherwise, this is a no-op.
+     */
+    performAction(e?: KeyboardEvent): void;
+    /**
+     * Returns a set of all of the parent blocks of the given block.
+     *
+     * @internal
+     * @returns A set of the parents of the given block.
+     */
+    getParents(): Set<BlockSvg>;
+    /**
+     * Returns a set of all of the parent blocks connected to an output of the
+     * given block or one of its parents. Also includes the given block.
+     *
+     * @internal
+     * @returns A set of the output-connected parents of the given block.
+     */
+    getOutputParents(): Set<BlockSvg>;
+    /**
+     * Returns an ID for the visual "row" this block is part of.
+     *
+     * @internal
+     */
+    getRowId(): string;
+    /**
+     * Updates the ARIA label, role and roledescription for this block.
+     */
+    private recomputeAriaAttributes;
+    /**
+     * Returns a description of this block suitable for screenreaders or use in
+     * ARIA attributes.
+     *
+     * @param verbosity How much detail to include in the description.
+     * @returns An accessibility description of this block.
+     */
+    getAriaLabel(verbosity: aria.Verbosity): string;
+    /**
+     * Count the number of blocks in this stack (connected by next connections)
+     * and return a label to describe it. Uses the standard label if there is only one block.
+     *
+     * @internal
+     */
+    getStackBlocksCountLabel(): string;
 }
 //# sourceMappingURL=block_svg.d.ts.map

package/core/blockly.d.ts

@@ -63,13 +63,15 @@ import * as icons from './icons.js';
 import { inject } from './inject.js';
 import * as inputs from './inputs.js';
 import { IFlyoutInflater } from './interfaces/i_flyout_inflater.js';
+import { Direction, KeyboardMover } from './keyboard_nav/keyboard_mover.js';
+import { MoveIndicator } from './keyboard_nav/move_indicator.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 { IAutoHideable } from './interfaces/i_autohideable.js';
-import { IBoundedElement } from './interfaces/i_bounded_element.js';
+import { IBoundedElement, isBoundedElement } from './interfaces/i_bounded_element.js';
 import { IBubble } from './interfaces/i_bubble.js';
 import { ICollapsibleToolboxItem } from './interfaces/i_collapsible_toolbox_item.js';
 import { IComponent } from './interfaces/i_component.js';
@@ -80,7 +82,7 @@ import { ICopyData, ICopyable, isCopyable } from './interfaces/i_copyable.js';
 import { IDeletable, isDeletable } from './interfaces/i_deletable.js';
 import { IDeleteArea } from './interfaces/i_delete_area.js';
 import { IDragTarget } from './interfaces/i_drag_target.js';
-import { IDragStrategy, IDraggable, isDraggable } from './interfaces/i_draggable.js';
+import { DragDisposition, IDragStrategy, IDraggable, isDraggable } from './interfaces/i_draggable.js';
 import { IDragger } from './interfaces/i_dragger.js';
 import { IFlyout } from './interfaces/i_flyout.js';
 import { IFocusableNode } from './interfaces/i_focusable_node.js';
@@ -104,12 +106,10 @@ 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 { LineCursor } from './keyboard_nav/line_cursor.js';
-import { Marker } from './keyboard_nav/marker.js';
+import { ToolboxNavigator } from './keyboard_nav/navigators/toolbox_navigator.js';
 import { KeyboardNavigationController, keyboardNavigationController } from './keyboard_navigation_controller.js';
 import type { LayerManager } from './layer_manager.js';
 import * as layers from './layers.js';
-import { MarkerManager } from './marker_manager.js';
 import { Menu } from './menu.js';
 import { MenuItem } from './menuitem.js';
 import { MetricsManager } from './metrics_manager.js';
@@ -269,18 +269,23 @@ export declare const VARIABLE_DYNAMIC_CATEGORY_NAME: string;
  * procedure blocks.
  */
 export declare const PROCEDURE_CATEGORY_NAME: string;
-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 './keyboard_nav/navigation_policies/block_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/bubble_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/comment_bar_button_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/comment_editor_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/connection_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/field_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/flyout_button_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/flyout_separator_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/icon_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/toolbox_item_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/workspace_comment_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/workspace_navigation_policy.js';
+export * from './keyboard_nav/navigators/flyout_navigator.js';
+export * from './keyboard_nav/navigators/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 { Block, BlockSvg, BlocklyOptions, Blocks, CollapsibleToolboxCategory, ComponentManager, Connection, ConnectionChecker, ConnectionDB, ConnectionType, ContextMenu, ContextMenuItems, ContextMenuRegistry, Css, DeleteArea, DragTarget, Events, Extensions, 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, 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, KeyboardNavigationController, 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, keyboardNavigationController, layers, renderManagement, serialization, setLocale, };
+export { BlockFlyoutInflater, ButtonFlyoutInflater, CodeGenerator, Direction, DragDisposition, 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, KeyboardMover, KeyboardNavigationController, LabelFlyoutInflater, LayerManager, Menu, MenuGenerator, MenuGeneratorFunction, MenuItem, MenuOption, MetricsManager, MoveIndicator, Msg, Names, Options, RenderedConnection, ReturnEphemeralFocus, Scrollbar, ScrollbarPair, SeparatorFlyoutInflater, ShortcutRegistry, Theme, ThemeManager, Toolbox, ToolboxCategory, ToolboxItem, ToolboxNavigator, ToolboxSeparator, Trashcan, UnattachedFieldError, VariableMap, VariableModel, VerticalFlyout, Workspace, WorkspaceAudio, WorkspaceDragger, WorkspaceSvg, ZoomControls, config, getFocusManager, hasBubble, icons, inject, inputs, isBoundedElement, isCopyable, isDeletable, isDraggable, isIcon, isObservable, isPaster, isRenderedElement, isSelectable, isSerializable, isVariableBackedParameterModel, keyboardNavigationController, layers, renderManagement, serialization, setLocale, };
 //# sourceMappingURL=blockly.d.ts.map

package/core/bubbles/bubble.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { IBoundedElement } from '../interfaces/i_bounded_element.js';
 import { IBubble } from '../interfaces/i_bubble.js';
 import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
 import type { IFocusableTree } from '../interfaces/i_focusable_tree.js';
@@ -17,7 +18,7 @@ import { WorkspaceSvg } from '../workspace_svg.js';
  * bubble, where it has a "tail" that points to the block, and a "head" that
  * displays arbitrary svg elements.
  */
-export declare abstract class Bubble implements IBubble, ISelectable, IFocusableNode {
+export declare abstract class Bubble implements IBubble, ISelectable, IFocusableNode, IBoundedElement {
     readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;
     protected ownerRect?: Rect | undefined;
@@ -126,6 +127,14 @@ export declare abstract class Bubble implements IBubble, ISelectable, IFocusable
      * @internal
      */
     moveTo(x: number, y: number): void;
+    /**
+     * Moves the bubble by the given amounts in the x and y directions.
+     *
+     * @param dx The distance to move along the x axis.
+     * @param dy The distance to move along the y axis.
+     * @param _reason A description of why this move is happening.
+     */
+    moveBy(dx: number, dy: number, _reason?: string[]): void;
     /**
      * Positions the bubble "optimally" so that the most of it is visible and
      * it does not overlap the rect (if provided).
@@ -182,6 +191,12 @@ export declare abstract class Bubble implements IBubble, ISelectable, IFocusable
     bringToFront(): boolean;
     /** @internal */
     getRelativeToSurfaceXY(): Coordinate;
+    /**
+     * Returns the bounds of this bubble.
+     *
+     * @returns A bounding box for this bubble.
+     */
+    getBoundingRectangle(): Rect;
     /** @internal */
     getSvgRoot(): SVGElement;
     /**
@@ -201,7 +216,7 @@ export declare abstract class Bubble implements IBubble, ISelectable, IFocusable
     /** Returns whether this bubble is movable or not. */
     isMovable(): boolean;
     /** Starts a drag on the bubble. */
-    startDrag(): void;
+    startDrag(): IBubble;
     /** Drags the bubble to the given location. */
     drag(newLoc: Coordinate): void;
     /** Ends the drag on the bubble. */

package/core/bubbles/mini_workspace_bubble.d.ts

@@ -5,6 +5,8 @@
  */
 import type { BlocklyOptions } from '../blockly_options.js';
 import { Abstract as AbstractEvent } from '../events/events_abstract.js';
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
+import type { IHasBubble } from '../interfaces/i_has_bubble.js';
 import { Options } from '../options.js';
 import { Coordinate } from '../utils/coordinate.js';
 import type { Rect } from '../utils/rect.js';
@@ -18,6 +20,7 @@ export declare class MiniWorkspaceBubble extends Bubble {
     readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;
     protected ownerRect?: Rect | undefined;
+    protected owner?: (IHasBubble & IFocusableNode) | undefined;
     /**
      * The minimum amount of change to the mini workspace view to trigger
      * resizing the bubble.
@@ -38,7 +41,7 @@ export declare class MiniWorkspaceBubble extends Bubble {
      */
     private autoLayout;
     /** @internal */
-    constructor(workspaceOptions: BlocklyOptions, workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined);
+    constructor(workspaceOptions: BlocklyOptions, workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined, owner?: (IHasBubble & IFocusableNode) | undefined);
     dispose(): void;
     /** @internal */
     getWorkspace(): WorkspaceSvg;
@@ -80,5 +83,10 @@ export declare class MiniWorkspaceBubble extends Bubble {
     moveTo(x: number, y: number): void;
     /** @internal */
     newWorkspaceSvg(options: Options): WorkspaceSvg;
+    /**
+     * Handles the user acting on this bubble via keyboard navigation by focusing
+     * the mutator workspace.
+     */
+    performAction(): void;
 }
 //# sourceMappingURL=mini_workspace_bubble.d.ts.map

package/core/bubbles/text_bubble.d.ts

@@ -3,6 +3,8 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
+import type { IHasBubble } from '../interfaces/i_has_bubble.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
@@ -15,8 +17,9 @@ export declare class TextBubble extends Bubble {
     readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;
     protected ownerRect?: Rect | undefined;
+    protected owner?: (IHasBubble & IFocusableNode) | undefined;
     private paragraph;
-    constructor(text: string, workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined);
+    constructor(text: string, workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined, owner?: (IHasBubble & IFocusableNode) | undefined);
     /** @returns the current text of this text bubble. */
     getText(): string;
     /** Sets the current text of this text bubble, and updates the display. */

package/core/bubbles/textinput_bubble.d.ts

@@ -98,5 +98,10 @@ export declare class TextInputBubble extends Bubble {
      * @internal
      */
     getEditor(): CommentEditor;
+    /**
+     * Handles the user acting on this bubble via keyboard navigation by focusing
+     * the comment editor.
+     */
+    performAction(): void;
 }
 //# sourceMappingURL=textinput_bubble.d.ts.map

package/core/comments/comment_editor.d.ts

@@ -16,7 +16,7 @@ export declare const COMMENT_EDITOR_FOCUS_IDENTIFIER = "_comment_textarea_";
 export declare class CommentEditor implements IFocusableNode {
     workspace: WorkspaceSvg;
     private onFinishEditing?;
-    id?: string;
+    id: string;
     /** The foreignObject containing the HTML text area. */
     private foreignObject;
     /** The text area where the user can type. */
@@ -25,7 +25,7 @@ export declare class CommentEditor implements IFocusableNode {
     private textChangeListeners;
     /** The current text of the comment. Updates on text area change. */
     private text;
-    constructor(workspace: WorkspaceSvg, commentId?: string, onFinishEditing?: (() => void) | undefined);
+    constructor(workspace: WorkspaceSvg, commentId: string, onFinishEditing?: (() => void) | undefined);
     /** Gets the dom structure for this comment editor. */
     getDom(): SVGForeignObjectElement;
     /** Gets the current text of the comment. */

package/core/comments/rendered_workspace_comment.d.ts

@@ -83,7 +83,7 @@ export declare class RenderedWorkspaceComment extends WorkspaceComment implement
     /** Returns whether this comment is movable or not. */
     isMovable(): boolean;
     /** Starts a drag on the comment. */
-    startDrag(): void;
+    startDrag(): RenderedWorkspaceComment;
     /** Drags the comment to the given location. */
     drag(newLoc: Coordinate): void;
     /** Ends the drag on the comment. */
@@ -117,5 +117,10 @@ export declare class RenderedWorkspaceComment extends WorkspaceComment implement
     onNodeBlur(): void;
     /** See IFocusableNode.canBeFocused. */
     canBeFocused(): boolean;
+    /**
+     * Handles the user acting on this comment via keyboard navigation.
+     * Expands the comment and focuses its editor.
+     */
+    performAction(): void;
 }
 //# sourceMappingURL=rendered_workspace_comment.d.ts.map

package/core/common.d.ts

@@ -79,7 +79,7 @@ export declare function fireSelectedEvent(newSelection: ISelectable | null): voi
  *
  * @returns The parent container.
  */
-export declare function getParentContainer(): Element | null;
+export declare function getParentContainer(workspace?: Workspace): Element | null;
 /**
  * Set the parent container.  This is the container element that the WidgetDiv,
  * DropDownDiv, and Tooltip are rendered into the first time `Blockly.inject`

package/core/css.d.ts

@@ -17,9 +17,10 @@ export declare function register(cssContent: string): void;
  * b) It speeds up loading by not blocking on a separate HTTP transfer.
  * c) The CSS content may be made dynamic depending on init options.
  *
+ * @param container The div or other HTML element into which Blockly was injected.
  * @param hasCss If false, don't inject CSS (providing CSS becomes the
  *     document's responsibility).
  * @param pathToMedia Path from page to the Blockly media directory.
  */
-export declare function inject(hasCss: boolean, pathToMedia: string): void;
+export declare function inject(container: HTMLElement, hasCss: boolean, pathToMedia: string): void;
 //# sourceMappingURL=css.d.ts.map