blockly 12.0.0-beta.5 → 12.0.0-beta.7

package/core/block.d.ts

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

package/core/block_svg.d.ts

@@ -17,7 +17,6 @@ import { ContextMenuOption, LegacyContextMenuOption } from './contextmenu_regist
 import { IconType } from './icons/icon_types.js';
 import { MutatorIcon } from './icons/mutator_icon.js';
 import type { Input } from './inputs/input.js';
-import type { IASTNodeLocationSvg } from './interfaces/i_ast_node_location_svg.js';
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
 import { IContextMenu } from './interfaces/i_contextmenu.js';
 import type { ICopyable } from './interfaces/i_copyable.js';
@@ -26,7 +25,6 @@ import type { IDragStrategy, IDraggable } from './interfaces/i_draggable.js';
 import type { IFocusableNode } from './interfaces/i_focusable_node.js';
 import type { IFocusableTree } from './interfaces/i_focusable_tree.js';
 import { IIcon } from './interfaces/i_icon.js';
-import type { INavigable } from './interfaces/i_navigable.js';
 import { RenderedConnection } from './rendered_connection.js';
 import type { IPathObject } from './renderers/common/i_path_object.js';
 import type { BlockStyle } from './theme.js';
@@ -39,7 +37,7 @@ import type { WorkspaceSvg } from './workspace_svg.js';
  * Class for a block's SVG representation.
  * Not normally called directly, workspace.newBlock() is preferred.
  */
-export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBoundedElement, IContextMenu, ICopyable<BlockCopyData>, IDraggable, IDeletable, IFocusableNode, INavigable<BlockSvg> {
+export declare class BlockSvg extends Block implements IBoundedElement, IContextMenu, ICopyable<BlockCopyData>, IDraggable, IDeletable, IFocusableNode {
     /**
      * Constant for identifying rows that are to be rendered inline.
      * Don't collide with Blockly.inputTypes.
@@ -400,19 +398,6 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      */
     private createIconPointerDownListener;
     removeIcon(type: IconType<IIcon>): boolean;
-    /**
-     * Set whether the block is manually enabled or disabled.
-     *
-     * The user can toggle whether a block is disabled from a context menu
-     * option. A block may still be disabled for other reasons even if the user
-     * attempts to manually enable it, such as when the block is in an invalid
-     * location. This method is deprecated and setDisabledReason should be used
-     * instead.
-     *
-     * @deprecated v11: use setDisabledReason.
-     * @param enabled True if enabled.
-     */
-    setEnabled(enabled: boolean): void;
     /**
      * Add or remove a reason why the block might be disabled. If a block has
      * any reasons to be disabled, then the block itself will be considered
@@ -737,20 +722,7 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
     onNodeFocus(): void;
     /** See IFocusableNode.onNodeBlur. */
     onNodeBlur(): void;
-    /**
-     * Returns whether or not this block can be navigated to via the keyboard.
-     *
-     * @returns True if this block is keyboard navigable, otherwise false.
-     */
-    isNavigable(): boolean;
-    /**
-     * Returns this block's class.
-     *
-     * Used by keyboard navigation to look up the rules for navigating from this
-     * block.
-     *
-     * @returns This block's class.
-     */
-    getClass(): typeof BlockSvg;
+    /** See IFocusableNode.canBeFocused. */
+    canBeFocused(): boolean;
 }
 //# sourceMappingURL=block_svg.d.ts.map

package/core/blockly.d.ts

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

package/core/bubbles/bubble.d.ts

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

package/core/bubbles/textinput_bubble.d.ts

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

package/core/comments/rendered_workspace_comment.d.ts

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

package/core/common.d.ts

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

package/core/connection.d.ts

@@ -10,13 +10,12 @@
  */
 import type { Block } from './block.js';
 import type { Input } from './inputs/input.js';
-import type { IASTNodeLocationWithBlock } from './interfaces/i_ast_node_location_with_block.js';
 import type { IConnectionChecker } from './interfaces/i_connection_checker.js';
 import * as blocks from './serialization/blocks.js';
 /**
  * Class for a connection between blocks.
  */
-export declare class Connection implements IASTNodeLocationWithBlock {
+export declare class Connection {
     type: number;
     /** Constants for checking whether two connections are compatible. */
     static CAN_CONNECT: number;

package/core/contextmenu_registry.d.ts

@@ -77,7 +77,7 @@ export declare namespace ContextMenuRegistry {
         block?: BlockSvg;
         workspace?: WorkspaceSvg;
         comment?: RenderedWorkspaceComment;
-        focusedNode?: IFocusableNode | any;
+        focusedNode?: IFocusableNode;
     }
     /**
      * Fields common to all context menu registry items.

package/core/dropdowndiv.d.ts

@@ -126,10 +126,12 @@ export declare function showPositionedByField<T>(field: Field<T>, opt_onHide?: (
  * @param secondaryX Secondary/alternative origin point x, in absolute px.
  * @param secondaryY Secondary/alternative origin point y, in absolute px.
  * @param opt_onHide Optional callback for when the drop-down is hidden.
+ * @param manageEphemeralFocus Whether ephemeral focus should be managed
+ *     according to the widget div's lifetime.
  * @returns True if the menu rendered at the primary origin point.
  * @internal
  */
-export declare function show<T>(newOwner: Field<T>, rtl: boolean, primaryX: number, primaryY: number, secondaryX: number, secondaryY: number, opt_onHide?: () => void): boolean;
+export declare function show<T>(newOwner: Field<T>, rtl: boolean, primaryX: number, primaryY: number, secondaryX: number, secondaryY: number, manageEphemeralFocus: boolean, opt_onHide?: () => void): boolean;
 /**
  * Get the x positions for the left side of the DropDownDiv and the arrow,
  * accounting for the bounds of the workspace.

package/core/events/events.d.ts

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

package/core/events/predicates.d.ts

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

package/core/events/utils.d.ts

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

package/core/field.d.ts

@@ -13,12 +13,9 @@
 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 { INavigable } from './interfaces/i_navigable.js';
 import type { IRegistrable } from './interfaces/i_registrable.js';
 import { ISerializable } from './interfaces/i_serializable.js';
 import type { ConstantProvider } from './renderers/common/constants.js';
@@ -48,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, IFocusableNode, INavigable<Field<T>> {
+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.
@@ -57,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
@@ -76,7 +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;
+    /**
+     * 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.
+     */
+    protected get size_(): Size;
+    /**
+     * Sets the size of this field.
+     */
+    protected set size_(newValue: Size);
     /** The rendered field's SVG group element. */
     protected fieldGroup_: SVGGElement | null;
     /** The rendered field's SVG border element. */
@@ -672,6 +685,8 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
     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.
@@ -683,21 +698,6 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      *    to configure a specific field.
      */
     static fromJson(_options: FieldConfig): Field;
-    /**
-     * Returns whether or not this field is accessible by keyboard navigation.
-     *
-     * @returns True if this field is keyboard accessible, otherwise false.
-     */
-    isNavigable(): boolean;
-    /**
-     * Returns this field's class.
-     *
-     * Used by keyboard navigation to look up the rules for navigating from this
-     * field. Must be implemented by subclasses.
-     *
-     * @returns This field's class.
-     */
-    abstract getClass(): new (...args: any) => Field<T>;
 }
 /**
  * Extra configuration options for the base field.

package/core/field_checkbox.d.ts

@@ -123,15 +123,6 @@ export declare class FieldCheckbox extends Field<CheckboxBool> {
      * @internal
      */
     static fromJson(options: FieldCheckboxFromJsonConfig): FieldCheckbox;
-    /**
-     * Returns this field's class.
-     *
-     * Used by keyboard navigation to look up the rules for navigating from this
-     * field.
-     *
-     * @returns This field's class.
-     */
-    getClass(): typeof FieldCheckbox;
 }
 /**
  * Config options for the checkbox field.

package/core/field_dropdown.d.ts

@@ -191,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.
      */
@@ -232,15 +238,6 @@ export declare class FieldDropdown extends Field<string> {
      * @throws {TypeError} If proposed options are incorrectly structured.
      */
     protected validateOptions(options: MenuOption[]): void;
-    /**
-     * Returns this field's class.
-     *
-     * Used by keyboard navigation to look up the rules for navigating from this
-     * field.
-     *
-     * @returns This field's class.
-     */
-    getClass(): typeof FieldDropdown;
 }
 /**
  * Definition of a human-readable image dropdown option.

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;
@@ -125,15 +123,6 @@ export declare class FieldImage extends Field<string> {
      * @internal
      */
     static fromJson(options: FieldImageFromJsonConfig): FieldImage;
-    /**
-     * Returns this field's class.
-     *
-     * Used by keyboard navigation to look up the rules for navigating from this
-     * field.
-     *
-     * @returns This field's class.
-     */
-    getClass(): typeof FieldImage;
 }
 /**
  * Config options for the image field.

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
@@ -141,8 +150,12 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      *     undefined if triggered programmatically.
      * @param quietInput True if editor should be created without focus.
      *     Defaults to false.
+     * @param manageEphemeralFocus Whether ephemeral focus should be managed as
+     *     part of the editor's inline editor (when the inline editor is shown).
+     *     Callers must manage ephemeral focus themselves if this is false.
+     *     Defaults to true.
      */
-    protected showEditor_(_e?: Event, quietInput?: boolean): void;
+    protected showEditor_(_e?: Event, quietInput?: boolean, manageEphemeralFocus?: boolean): void;
     /**
      * Create and show a text input editor that is a prompt (usually a popup).
      * Mobile browsers may have issues with in-line textareas (focus and
@@ -153,6 +166,8 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      * Create and show a text input editor that sits directly over the text input.
      *
      * @param quietInput True if editor should be created without focus.
+     * @param manageEphemeralFocus Whether ephemeral focus should be managed as
+     *     part of the field's inline editor (widget div).
      */
     private showInlineEditor;
     /**

package/core/field_label.d.ts

@@ -64,15 +64,6 @@ export declare class FieldLabel extends Field<string> {
      * @internal
      */
     static fromJson(options: FieldLabelFromJsonConfig): FieldLabel;
-    /**
-     * Returns this field's class.
-     *
-     * Used by keyboard navigation to look up the rules for navigating from this
-     * field.
-     *
-     * @returns This field's class.
-     */
-    getClass(): typeof FieldLabel;
 }
 /**
  * Config options for the label field.

package/core/field_number.d.ts

@@ -160,15 +160,6 @@ export declare class FieldNumber extends FieldInput<number> {
      * @internal
      */
     static fromJson(options: FieldNumberFromJsonConfig): FieldNumber;
-    /**
-     * Returns this field's class.
-     *
-     * Used by keyboard navigation to look up the rules for navigating from this
-     * field.
-     *
-     * @returns This field's class.
-     */
-    getClass(): typeof FieldNumber;
 }
 /**
  * Config options for the number field.