blockly 12.5.1 → 13.0.0-beta.0

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_svg.d.ts

@@ -21,7 +21,7 @@ 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';
@@ -100,9 +100,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 +301,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 +692,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 +706,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 +728,33 @@ 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(): 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;
 }
 //# 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_comment_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/block_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

@@ -80,5 +80,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/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

package/core/dragging/block_drag_strategy.d.ts

@@ -3,9 +3,24 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { BlockSvg } from '../block_svg.js';
-import { IDragStrategy } from '../interfaces/i_draggable.js';
+import type { BlockSvg } from '../block_svg.js';
+import type { IDragStrategy } from '../interfaces/i_draggable.js';
+import { DragDisposition } from '../interfaces/i_draggable.js';
+import { Direction } from '../keyboard_nav/keyboard_mover.js';
+import type { RenderedConnection } from '../rendered_connection.js';
 import { Coordinate } from '../utils.js';
+/** Represents a valid pair of connections between the dragging block and a block on the workspace. */
+interface ConnectionPair {
+    /** A connection on the dragging stack that is compatible with neighbour. */
+    local: RenderedConnection;
+    /** A nearby connection that is compatible with local. */
+    neighbour: RenderedConnection;
+}
+/** Represents a nearby valid connection. */
+interface ConnectionCandidate extends ConnectionPair {
+    /** The distance between the local connection and the neighbour connection. */
+    distance: number;
+}
 export declare class BlockDragStrategy implements IDragStrategy {
     private block;
     private workspace;
@@ -20,21 +35,38 @@ export declare class BlockDragStrategy implements IDragStrategy {
     private connectionCandidate;
     private connectionPreviewer;
     private dragging;
-    /**
-     * If this is a shadow block, the offset between this block and the parent
-     * block, to add to the drag location. In workspace units.
-     */
-    private dragOffset;
+    /** List of all connections available on the workspace. */
+    private allConnectionPairs;
+    /** The current movement mode. */
+    private moveMode;
     /** Used to persist an event group when snapping is done async. */
     private originalEventGroup;
+    protected readonly BLOCK_CONNECTION_OFFSET = 10;
     constructor(block: BlockSvg);
     /** Returns true if the block is currently movable. False otherwise. */
     isMovable(): boolean;
+    /**
+     * Positions a cloned block on its new workspace.
+     *
+     * @param oldBlock The flyout block that was cloned.
+     * @param newBlock The new block to position.
+     */
+    private positionNewBlock;
+    /**
+     * Returns the block to use for the current drag operation. This may create
+     * and return a newly instantiated block when e.g. dragging from a flyout.
+     */
+    protected getTargetBlock(): BlockSvg;
+    /**
+     * Handles any setup for starting the drag, including disconnecting the block
+     * from any parent blocks.
+     */
+    startDrag(e?: PointerEvent | KeyboardEvent): import("../interfaces/i_draggable.js").IDraggable;
     /**
      * Handles any setup for starting the drag, including disconnecting the block
      * from any parent blocks.
      */
-    startDrag(e?: PointerEvent): void;
+    private cacheAllConnectionPairs;
     /**
      * Returns an array of visible bubbles attached to the given block or its
      * descendants.
@@ -47,13 +79,11 @@ export declare class BlockDragStrategy implements IDragStrategy {
     /**
      * Get whether the drag should act on a single block or a block stack.
      *
-     * @param e The instigating pointer event, if any.
+     * @param e The instigating pointer or keyboard event, if any.
      * @returns True if just the initial block should be dragged out, false
      *     if all following blocks should also be dragged.
      */
-    protected shouldHealStack(e: PointerEvent | undefined): boolean;
-    /** Starts a drag on a shadow, recording the drag offset. */
-    private startDraggingShadow;
+    protected shouldHealStack(e: PointerEvent | KeyboardEvent | undefined): boolean;
     /**
      * Whether or not we should disconnect the block when a drag is started.
      *
@@ -69,6 +99,12 @@ export declare class BlockDragStrategy implements IDragStrategy {
      * @param healStack Whether or not to heal the stack after disconnecting.
      */
     private disconnectBlock;
+    /**
+     * Stores the dragging block's current parent or child connection before
+     * unplugging. This allows us to revert the drag cleanly. In keyboard move mode,
+     * the initial connection pair is also used as the first connection candidate.
+     */
+    private storeInitialConnections;
     /** Fire a UI event at the start of a block drag. */
     private fireDragStartEvent;
     /** Fire a UI event at the end of a block drag. */
@@ -76,11 +112,15 @@ export declare class BlockDragStrategy implements IDragStrategy {
     /** Fire a move event at the end of a block drag. */
     private fireMoveEvent;
     /** Moves the block and updates any connection previews. */
-    drag(newLoc: Coordinate): void;
+    drag(newLoc: Coordinate, e?: PointerEvent | KeyboardEvent): void;
     /**
+     * Renders the connection preview indicator.
+     *
      * @param draggingBlock The block being dragged.
      * @param delta How far the pointer has moved from the position
      *     at the start of the drag, in workspace units.
+     * @returns The neighbouring connection to which the connection preview will
+     *     be attached.
      */
     private updateConnectionPreview;
     /**
@@ -116,7 +156,7 @@ export declare class BlockDragStrategy implements IDragStrategy {
      * Cleans up any state at the end of the drag. Applies any pending
      * connections.
      */
-    endDrag(e?: PointerEvent): void;
+    endDrag(_e: PointerEvent | KeyboardEvent | undefined, disposition: DragDisposition): void;
     /** Disposes of any state at the end of the drag. */
     private disposeStep;
     /** Connects the given candidate connections. */
@@ -126,5 +166,35 @@ export declare class BlockDragStrategy implements IDragStrategy {
      * including reconnecting connections.
      */
     revertDrag(): void;
+    /**
+     * Get the nearest valid candidate connection in traversal order.
+     *
+     * @param direction The cardinal direction in which the block is being moved.
+     * @returns A candidate connection and radius, or null if none was found.
+     */
+    findTraversalCandidate(direction: Direction): ConnectionCandidate | null;
+    private pairToCandidate;
+    /**
+     * Returns the cardinal direction that the block being dragged would have to
+     * move in to reach the given location.
+     * The given coordinate should differ from the current location on only one
+     * axis.
+     *
+     * @param newLocation The intended destination for the block.
+     * @returns The direction the block would need to travel to reach the new
+     *     location.
+     */
+    private getDirectionToNewLocation;
+    /**
+     * Returns all navigable connections on the given block and its children.
+     * Omits connections on shadow blocks, collapsed blocks, or those that are
+     * associated with a hidden input.
+     *
+     * @param block The block to use as a starting point for retrieving
+     *     connections.
+     * @returns All connections on the block and its children.
+     */
+    private getAllConnections;
 }
+export {};
 //# sourceMappingURL=block_drag_strategy.d.ts.map

package/core/dragging/bubble_drag_strategy.d.ts

@@ -3,16 +3,17 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { IBubble, WorkspaceSvg } from '../blockly.js';
-import { IDragStrategy } from '../interfaces/i_draggable.js';
-import { Coordinate } from '../utils.js';
+import type { IBubble } from '../interfaces/i_bubble.js';
+import type { IDragStrategy } from '../interfaces/i_draggable.js';
+import type { Coordinate } from '../utils.js';
+import type { WorkspaceSvg } from '../workspace_svg.js';
 export declare class BubbleDragStrategy implements IDragStrategy {
     private bubble;
     private workspace;
     private startLoc;
     constructor(bubble: IBubble, workspace: WorkspaceSvg);
     isMovable(): boolean;
-    startDrag(): void;
+    startDrag(): IBubble;
     drag(newLoc: Coordinate): void;
     endDrag(): void;
     revertDrag(): void;

package/core/dragging/comment_drag_strategy.d.ts

@@ -3,16 +3,16 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { RenderedWorkspaceComment } from '../comments.js';
-import { IDragStrategy } from '../interfaces/i_draggable.js';
-import { Coordinate } from '../utils.js';
+import type { RenderedWorkspaceComment } from '../comments.js';
+import type { IDragStrategy } from '../interfaces/i_draggable.js';
+import type { Coordinate } from '../utils.js';
 export declare class CommentDragStrategy implements IDragStrategy {
     private comment;
     private startLoc;
     private workspace;
     constructor(comment: RenderedWorkspaceComment);
     isMovable(): boolean;
-    startDrag(): void;
+    startDrag(): RenderedWorkspaceComment;
     drag(newLoc: Coordinate): void;
     endDrag(): void;
     /** Fire a UI event at the start of a comment drag. */

package/core/dragging/dragger.d.ts

@@ -3,29 +3,27 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { IDeletable } from '../interfaces/i_deletable.js';
-import { IDragTarget } from '../interfaces/i_drag_target.js';
-import { IDraggable } from '../interfaces/i_draggable.js';
-import { IDragger } from '../interfaces/i_dragger.js';
+import type { IDeletable } from '../interfaces/i_deletable.js';
+import type { IDragTarget } from '../interfaces/i_drag_target.js';
+import { type IDraggable } from '../interfaces/i_draggable.js';
+import type { IDragger } from '../interfaces/i_dragger.js';
 import { Coordinate } from '../utils/coordinate.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
 export declare class Dragger implements IDragger {
     protected draggable: IDraggable;
-    protected workspace: WorkspaceSvg;
     protected startLoc: Coordinate;
     protected dragTarget: IDragTarget | null;
-    constructor(draggable: IDraggable, workspace: WorkspaceSvg);
+    constructor(draggable: IDraggable);
     /** Handles any drag startup. */
-    onDragStart(e: PointerEvent): void;
+    onDragStart(e?: PointerEvent | KeyboardEvent): IDraggable;
     /**
      * Handles calculating where the element should actually be moved to.
      *
      * @param totalDelta The total amount in pixel coordinates the mouse has moved
      *     since the start of the drag.
      */
-    onDrag(e: PointerEvent, totalDelta: Coordinate): void;
+    onDrag(e: PointerEvent | KeyboardEvent | undefined, totalDelta: Coordinate): void;
     /** Updates the drag target under the pointer (if there is one). */
-    protected updateDragTarget(e: PointerEvent): void;
+    protected updateDragTarget(coordinate: Coordinate): void;
     /**
      * Calculates the correct workspace coordinate for the movable and tells
      * the draggable to go to that location.
@@ -35,15 +33,16 @@ export declare class Dragger implements IDragger {
      * Returns true if we would delete the draggable if it was dropped
      * at the current location.
      */
-    protected wouldDeleteDraggable(e: PointerEvent, rootDraggable: IDraggable & IDeletable): boolean;
+    protected wouldDeleteDraggable(coordinate: Coordinate, rootDraggable: IDraggable & IDeletable): boolean;
     /** Handles any drag cleanup. */
-    onDragEnd(e: PointerEvent): void;
-    private getRoot;
+    onDragEnd(e?: PointerEvent | KeyboardEvent): void;
+    /** Handles a drag being reverted. */
+    onDragRevert(): void;
     /**
      * Returns true if we should return the draggable to its original location
      * at the end of the drag.
      */
-    protected shouldReturnToStart(e: PointerEvent, rootDraggable: IDraggable): boolean;
+    protected shouldReturnToStart(coordinate: Coordinate, rootDraggable: IDraggable): boolean;
     protected pixelsToWorkspaceUnits(pixelCoord: Coordinate): Coordinate;
 }
 //# sourceMappingURL=dragger.d.ts.map

package/core/events/events_block_create.d.ts

@@ -19,8 +19,6 @@ import { EventType } from './type.js';
  */
 export declare class BlockCreate extends BlockBase {
     type: EventType;
-    /** The XML representation of the created block(s). */
-    xml?: Element | DocumentFragment;
     /** The JSON respresentation of the created block(s). */
     json?: blocks.State;
     /** All of the IDs of created blocks. */
@@ -51,7 +49,6 @@ export declare class BlockCreate extends BlockBase {
     run(forward: boolean): void;
 }
 export interface BlockCreateJson extends BlockBaseJson {
-    xml: string;
     ids: string[];
     json: object;
     recordUndo?: boolean;

package/core/events/events_block_delete.d.ts

@@ -18,8 +18,6 @@ import { EventType } from './type.js';
  * deleted.
  */
 export declare class BlockDelete extends BlockBase {
-    /** The XML representation of the deleted block(s). */
-    oldXml?: Element | DocumentFragment;
     /** The JSON respresentation of the deleted block(s). */
     oldJson?: blocks.State;
     /** All of the IDs of deleted blocks. */
@@ -53,7 +51,6 @@ export declare class BlockDelete extends BlockBase {
     run(forward: boolean): void;
 }
 export interface BlockDeleteJson extends BlockBaseJson {
-    oldXml: string;
     ids: string[];
     wasShadow: boolean;
     oldJson: blocks.State;