blockly 12.0.0-beta.0 → 12.0.0-beta.2

package/core/block.d.ts

@@ -540,6 +540,12 @@ export declare class Block implements IASTNodeLocation {
      * @returns Named field, or null if field does not exist.
      */
     getField(name: string): Field | null;
+    /**
+     * Returns a generator that provides every field on the block.
+     *
+     * @yields A generator that can be used to iterate the fields on the block.
+     */
+    getFields(): Generator<Field>;
     /**
      * Return all variables referenced by this block.
      *
@@ -641,9 +647,8 @@ export declare class Block implements IASTNodeLocation {
      * @returns True if enabled.
      */
     isEnabled(): boolean;
-    /** @deprecated v11 - Get whether the block is manually disabled. */
+    /** @deprecated v11 - Get or sets whether the block is manually disabled. */
     private get disabled();
-    /** @deprecated v11 - Set whether the block is manually disabled. */
     private set disabled(value);
     /**
      * @deprecated v11 - Set whether the block is manually enabled or disabled.
@@ -999,7 +1004,7 @@ export declare class Block implements IASTNodeLocation {
      *
      * Intended to on be used in console logs and errors. If you need a string
      * that uses the user's native language (including block text, field values,
-     * and child blocks), use [toString()]{@link Block#toString}.
+     * and child blocks), use {@link (Block:class).toString | toString()}.
      *
      * @returns The description.
      */

package/core/block_flyout_inflater.d.ts

@@ -5,7 +5,7 @@
  */
 import { BlockSvg } from './block_svg.js';
 import * as browserEvents from './browser_events.js';
-import type { IBoundedElement } from './interfaces/i_bounded_element.js';
+import { FlyoutItem } from './flyout_item.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
 import type { IFlyoutInflater } from './interfaces/i_flyout_inflater.js';
 import type { BlockInfo } from './utils/toolbox.js';
@@ -16,7 +16,6 @@ import type { WorkspaceSvg } from './workspace_svg.js';
 export declare class BlockFlyoutInflater implements IFlyoutInflater {
     protected permanentlyDisabledBlocks: Set<BlockSvg>;
     protected listeners: Map<string, browserEvents.Data[]>;
-    protected flyoutWorkspace?: WorkspaceSvg;
     protected flyout?: IFlyout;
     private capacityWrapper;
     /**
@@ -27,10 +26,10 @@ export declare class BlockFlyoutInflater implements IFlyoutInflater {
      * Inflates a flyout block from the given state and adds it to the flyout.
      *
      * @param state A JSON representation of a flyout block.
-     * @param flyoutWorkspace The workspace to create the block on.
+     * @param flyout The flyout to create the block on.
      * @returns A newly created block.
      */
-    load(state: object, flyoutWorkspace: WorkspaceSvg): IBoundedElement;
+    load(state: object, flyout: IFlyout): FlyoutItem;
     /**
      * Creates a block on the given workspace.
      *
@@ -46,13 +45,13 @@ export declare class BlockFlyoutInflater implements IFlyoutInflater {
      * @param defaultGap The default spacing for flyout items.
      * @returns The amount of space that should follow this block.
      */
-    gapForElement(state: object, defaultGap: number): number;
+    gapForItem(state: object, defaultGap: number): number;
     /**
      * Disposes of the given block.
      *
-     * @param element The flyout block to dispose of.
+     * @param item The flyout block to dispose of.
      */
-    disposeElement(element: IBoundedElement): void;
+    disposeItem(item: FlyoutItem): void;
     /**
      * Removes event listeners for the block with the given ID.
      *
@@ -60,11 +59,11 @@ export declare class BlockFlyoutInflater implements IFlyoutInflater {
      */
     protected removeListeners(blockId: string): void;
     /**
-     * Updates this inflater's flyout workspace.
+     * Updates this inflater's flyout.
      *
-     * @param workspace The workspace of the flyout that owns this inflater.
+     * @param flyout The flyout that owns this inflater.
      */
-    protected setFlyoutWorkspace(workspace: WorkspaceSvg): void;
+    protected setFlyout(flyout: IFlyout): void;
     /**
      * Updates the enabled state of the given block based on the capacity of the
      * workspace.
@@ -85,5 +84,11 @@ export declare class BlockFlyoutInflater implements IFlyoutInflater {
      * @param event The event that triggered this update.
      */
     private filterFlyoutBasedOnCapacity;
+    /**
+     * Returns the type of items this inflater is responsible for creating.
+     *
+     * @returns An identifier for the type of items this inflater creates.
+     */
+    getType(): string;
 }
 //# sourceMappingURL=block_flyout_inflater.d.ts.map

package/core/block_svg.d.ts

@@ -132,13 +132,13 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      *
      * @returns #RRGGBB string.
      */
-    getColourSecondary(): string | undefined;
+    getColourSecondary(): string;
     /**
      * Get the tertiary colour of a block.
      *
      * @returns #RRGGBB string.
      */
-    getColourTertiary(): string | undefined;
+    getColourTertiary(): string;
     /** Selects this block. Highlights the block visually. */
     select(): void;
     /** Unselects this block. Unhighlights the block visually. */
@@ -470,6 +470,12 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * @throws {Error} if the block style does not exist.
      */
     setStyle(blockStyleName: string): void;
+    /**
+     * Returns the BlockStyle object used to style this block.
+     *
+     * @returns This block's style object.
+     */
+    getStyle(): BlockStyle;
     /**
      * Move this block to the front of the visible workspace.
      * <g> tags do not respect z-index so SVG renders them in the

package/core/blockly.d.ts

@@ -48,9 +48,10 @@ import { FieldNumber, FieldNumberConfig, FieldNumberFromJsonConfig, FieldNumberV
 import * as fieldRegistry from './field_registry.js';
 import { FieldTextInput, FieldTextInputConfig, FieldTextInputFromJsonConfig, FieldTextInputValidator } from './field_textinput.js';
 import { FieldVariable, FieldVariableConfig, FieldVariableFromJsonConfig, FieldVariableValidator } from './field_variable.js';
-import { Flyout, FlyoutItem } from './flyout_base.js';
+import { Flyout } from './flyout_base.js';
 import { FlyoutButton } from './flyout_button.js';
 import { HorizontalFlyout } from './flyout_horizontal.js';
+import { FlyoutItem } from './flyout_item.js';
 import { FlyoutMetricsManager } from './flyout_metrics_manager.js';
 import { FlyoutSeparator } from './flyout_separator.js';
 import { VerticalFlyout } from './flyout_vertical.js';
@@ -83,6 +84,8 @@ import { IDragTarget } from './interfaces/i_drag_target.js';
 import { 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';
+import { IFocusableTree } from './interfaces/i_focusable_tree.js';
 import { IHasBubble, hasBubble } from './interfaces/i_has_bubble.js';
 import { IIcon, isIcon } from './interfaces/i_icon.js';
 import { IKeyboardAccessible } from './interfaces/i_keyboard_accessible.js';
@@ -271,5 +274,5 @@ export declare const VARIABLE_DYNAMIC_CATEGORY_NAME: string;
 export declare const PROCEDURE_CATEGORY_NAME: string;
 export { ASTNode, BasicCursor, Block, BlockSvg, BlocklyOptions, Blocks, CollapsibleToolboxCategory, ComponentManager, Connection, ConnectionChecker, ConnectionDB, ConnectionType, ContextMenu, ContextMenuItems, ContextMenuRegistry, Css, Cursor, 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, 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, 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, Scrollbar, ScrollbarPair, SeparatorFlyoutInflater, ShortcutRegistry, TabNavigateCursor, Theme, ThemeManager, Toolbox, ToolboxCategory, ToolboxItem, ToolboxSeparator, Trashcan, UnattachedFieldError, VariableMap, VariableModel, VerticalFlyout, Workspace, WorkspaceAudio, WorkspaceDragger, WorkspaceSvg, ZoomControls, config, 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, 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, Scrollbar, ScrollbarPair, SeparatorFlyoutInflater, ShortcutRegistry, TabNavigateCursor, Theme, ThemeManager, Toolbox, ToolboxCategory, ToolboxItem, ToolboxSeparator, Trashcan, UnattachedFieldError, VariableMap, VariableModel, VerticalFlyout, Workspace, WorkspaceAudio, WorkspaceDragger, WorkspaceSvg, ZoomControls, config, 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/text_bubble.d.ts

@@ -26,12 +26,12 @@ export declare class TextBubble extends Bubble {
      * broken up by newlines.
      */
     private stringToSvg;
-    /** Creates the paragraph container for this bubble's view's spans. */
+    /** Creates the paragraph container for this bubble's view's text fragments. */
     private createParagraph;
-    /** Creates the spans visualizing the text of this bubble. */
-    private createSpans;
-    /** Right aligns the given spans. */
-    private rightAlignSpans;
+    /** Creates the text fragments visualizing the text of this bubble. */
+    private createTextFragments;
+    /** Right aligns the given text fragments. */
+    private rightAlignTextFragments;
     /** Updates the size of this bubble to account for the size of the text. */
     private updateBubbleSize;
 }

package/core/button_flyout_inflater.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { IBoundedElement } from './interfaces/i_bounded_element.js';
+import { FlyoutItem } from './flyout_item.js';
+import type { IFlyout } from './interfaces/i_flyout.js';
 import type { IFlyoutInflater } from './interfaces/i_flyout_inflater.js';
-import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class responsible for creating buttons for flyouts.
  */
@@ -14,10 +14,10 @@ export declare class ButtonFlyoutInflater implements IFlyoutInflater {
      * Inflates a flyout button from the given state and adds it to the flyout.
      *
      * @param state A JSON representation of a flyout button.
-     * @param flyoutWorkspace The workspace to create the button on.
+     * @param flyout The flyout to create the button on.
      * @returns A newly created FlyoutButton.
      */
-    load(state: object, flyoutWorkspace: WorkspaceSvg): IBoundedElement;
+    load(state: object, flyout: IFlyout): FlyoutItem;
     /**
      * Returns the amount of space that should follow this button.
      *
@@ -25,12 +25,18 @@ export declare class ButtonFlyoutInflater implements IFlyoutInflater {
      * @param defaultGap The default spacing for flyout items.
      * @returns The amount of space that should follow this button.
      */
-    gapForElement(state: object, defaultGap: number): number;
+    gapForItem(state: object, defaultGap: number): number;
     /**
      * Disposes of the given button.
      *
-     * @param element The flyout button to dispose of.
+     * @param item The flyout button to dispose of.
      */
-    disposeElement(element: IBoundedElement): void;
+    disposeItem(item: FlyoutItem): void;
+    /**
+     * Returns the type of items this inflater is responsible for creating.
+     *
+     * @returns An identifier for the type of items this inflater creates.
+     */
+    getType(): string;
 }
 //# sourceMappingURL=button_flyout_inflater.d.ts.map

package/core/comments/comment_view.d.ts

@@ -8,7 +8,7 @@ import { Coordinate } from '../utils/coordinate.js';
 import { Size } from '../utils/size.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
 export declare class CommentView implements IRenderedElement {
-    private readonly workspace;
+    readonly workspace: WorkspaceSvg;
     /** The root group element of the comment view. */
     private svgRoot;
     /**
@@ -62,9 +62,9 @@ export declare class CommentView implements IRenderedElement {
      */
     private resizePointerMoveListener;
     /** Whether this comment view is currently being disposed or not. */
-    private disposing;
+    protected disposing: boolean;
     /** Whether this comment view has been disposed or not. */
-    private disposed;
+    protected disposed: boolean;
     /** Size of this comment when the resize drag was initiated. */
     private preResizeSize?;
     /** The default size of newly created comments. */

package/core/connection.d.ts

@@ -216,7 +216,7 @@ export declare class Connection implements IASTNodeLocationWithBlock {
      *
      * Headless configurations (the default) do not have neighboring connection,
      * and always return an empty list (the default).
-     * {@link RenderedConnection#neighbours} overrides this behavior with a list
+     * {@link (RenderedConnection:class).neighbours} overrides this behavior with a list
      * computed from the rendered positioning.
      *
      * @param _maxLimit The maximum radius to another connection.

package/core/contextmenu_registry.d.ts

@@ -62,7 +62,7 @@ export declare namespace ContextMenuRegistry {
      * rendered in multiple scopes, e.g. on both a block and a workspace, it
      * should be registered for each scope.
      */
-    enum ScopeType {
+    export enum ScopeType {
         BLOCK = "block",
         WORKSPACE = "workspace",
         COMMENT = "comment"
@@ -71,15 +71,23 @@ export declare namespace ContextMenuRegistry {
      * The actual workspace/block where the menu is being rendered. This is passed
      * to callback and displayText functions that depend on this information.
      */
-    interface Scope {
+    export interface Scope {
         block?: BlockSvg;
         workspace?: WorkspaceSvg;
         comment?: RenderedWorkspaceComment;
     }
     /**
-     * A menu item as entered in the registry.
+     * Fields common to all context menu registry items.
+     */
+    interface CoreRegistryItem {
+        scopeType: ScopeType;
+        weight: number;
+        id: string;
+    }
+    /**
+     * A representation of a normal, clickable menu item in the registry.
      */
-    interface RegistryItem {
+    interface ActionRegistryItem extends CoreRegistryItem {
         /**
          * @param scope Object that provides a reference to the thing that had its
          *     context menu opened.
@@ -87,16 +95,34 @@ export declare namespace ContextMenuRegistry {
          *     the event that triggered the click on the option.
          */
         callback: (scope: Scope, e: PointerEvent) => void;
-        scopeType: ScopeType;
         displayText: ((p1: Scope) => string | HTMLElement) | string | HTMLElement;
         preconditionFn: (p1: Scope) => string;
+        separator?: never;
+    }
+    /**
+     * A representation of a menu separator item in the registry.
+     */
+    interface SeparatorRegistryItem extends CoreRegistryItem {
+        separator: true;
+        callback?: never;
+        displayText?: never;
+        preconditionFn?: never;
+    }
+    /**
+     * A menu item as entered in the registry.
+     */
+    export type RegistryItem = ActionRegistryItem | SeparatorRegistryItem;
+    /**
+     * Fields common to all context menu items as used by contextmenu.ts.
+     */
+    export interface CoreContextMenuOption {
+        scope: Scope;
         weight: number;
-        id: string;
     }
     /**
-     * A menu item as presented to contextmenu.js.
+     * A representation of a normal, clickable menu item in contextmenu.ts.
      */
-    interface ContextMenuOption {
+    export interface ActionContextMenuOption extends CoreContextMenuOption {
         text: string | HTMLElement;
         enabled: boolean;
         /**
@@ -106,18 +132,32 @@ export declare namespace ContextMenuRegistry {
          *     the event that triggered the click on the option.
          */
         callback: (scope: Scope, e: PointerEvent) => void;
-        scope: Scope;
-        weight: number;
+        separator?: never;
+    }
+    /**
+     * A representation of a menu separator item in contextmenu.ts.
+     */
+    export interface SeparatorContextMenuOption extends CoreContextMenuOption {
+        separator: true;
+        text?: never;
+        enabled?: never;
+        callback?: never;
     }
+    /**
+     * A menu item as presented to contextmenu.ts.
+     */
+    export type ContextMenuOption = ActionContextMenuOption | SeparatorContextMenuOption;
     /**
      * A subset of ContextMenuOption corresponding to what was publicly
      * documented.  ContextMenuOption should be preferred for new code.
      */
-    interface LegacyContextMenuOption {
+    export interface LegacyContextMenuOption {
         text: string;
         enabled: boolean;
         callback: (p1: Scope) => void;
+        separator?: never;
     }
+    export {};
 }
 export type ScopeType = ContextMenuRegistry.ScopeType;
 export declare const ScopeType: typeof ContextMenuRegistry.ScopeType;

package/core/dragging/block_drag_strategy.d.ts

@@ -25,8 +25,8 @@ export declare class BlockDragStrategy implements IDragStrategy {
      * block, to add to the drag location. In workspace units.
      */
     private dragOffset;
-    /** Was there already an event group in progress when the drag started? */
-    private inGroup;
+    /** Used to persist an event group when snapping is done async. */
+    private originalEventGroup;
     constructor(block: BlockSvg);
     /** Returns true if the block is currently movable. False otherwise. */
     isMovable(): boolean;

package/core/dragging/bubble_drag_strategy.d.ts

@@ -10,8 +10,6 @@ export declare class BubbleDragStrategy implements IDragStrategy {
     private bubble;
     private workspace;
     private startLoc;
-    /** Was there already an event group in progress when the drag started? */
-    private inGroup;
     constructor(bubble: IBubble, workspace: WorkspaceSvg);
     isMovable(): boolean;
     startDrag(): void;

package/core/dragging/comment_drag_strategy.d.ts

@@ -10,8 +10,6 @@ export declare class CommentDragStrategy implements IDragStrategy {
     private comment;
     private startLoc;
     private workspace;
-    /** Was there already an event group in progress when the drag started? */
-    private inGroup;
     constructor(comment: RenderedWorkspaceComment);
     isMovable(): boolean;
     startDrag(): void;

package/core/events/events_var_delete.d.ts

@@ -9,8 +9,6 @@ import { VarBase, VarBaseJson } from './events_var_base.js';
 import { EventType } from './type.js';
 /**
  * Notifies listeners that a variable model has been deleted.
- *
- * @class
  */
 export declare class VarDelete extends VarBase {
     type: EventType;

package/core/events/events_var_rename.d.ts

@@ -9,8 +9,6 @@ import { VarBase, VarBaseJson } from './events_var_base.js';
 import { EventType } from './type.js';
 /**
  * Notifies listeners that a variable model was renamed.
- *
- * @class
  */
 export declare class VarRename extends VarBase {
     type: EventType;

package/core/field.d.ts

@@ -54,8 +54,6 @@ 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

package/core/field_dropdown.d.ts

@@ -10,13 +10,10 @@ import { MenuItem } from './menuitem.js';
  * Class for an editable dropdown field.
  */
 export declare class FieldDropdown extends Field<string> {
-    /** Horizontal distance that a checkmark overhangs the dropdown. */
-    static CHECKMARK_OVERHANG: number;
     /**
-     * Maximum height of the dropdown menu, as a percentage of the viewport
-     * height.
+     * Magic constant used to represent a separator in a list of dropdown items.
      */
-    static MAX_MENU_HEIGHT_VH: number;
+    static readonly SEPARATOR = "separator";
     static ARROW_CHAR: string;
     /** A reference to the currently selected menu item. */
     private selectedMenuItem;
@@ -239,11 +236,12 @@ export interface ImageProperties {
     height: number;
 }
 /**
- * An individual option in the dropdown menu. The first element is the human-
- * readable value (text or image), and the second element is the language-
- * neutral value.
+ * An individual option in the dropdown menu. Can be either the string literal
+ * `separator` for a menu separator item, or an array for normal action menu
+ * items. In the latter case, the first element is the human-readable value
+ * (text or image), and the second element is the language-neutral value.
  */
-export type MenuOption = [string | ImageProperties, string];
+export type MenuOption = [string | ImageProperties, string] | 'separator';
 /**
  * A function that generates an array of menu options for FieldDropdown
  * or its descendants.

package/core/flyout_base.d.ts

@@ -10,8 +10,8 @@
  */
 import { BlockSvg } from './block_svg.js';
 import { DeleteArea } from './delete_area.js';
+import { FlyoutItem } from './flyout_item.js';
 import { IAutoHideable } from './interfaces/i_autohideable.js';
-import type { IBoundedElement } from './interfaces/i_bounded_element.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
 import type { IFlyoutInflater } from './interfaces/i_flyout_inflater.js';
 import type { Options } from './options.js';
@@ -400,11 +400,4 @@ export declare abstract class Flyout extends DeleteArea implements IAutoHideable
      */
     protected getInflaterForType(type: string): IFlyoutInflater | null;
 }
-/**
- * A flyout content item.
- */
-export interface FlyoutItem {
-    type: string;
-    element: IBoundedElement;
-}
 //# sourceMappingURL=flyout_base.d.ts.map

package/core/flyout_horizontal.d.ts

@@ -3,7 +3,8 @@
  * Copyright 2017 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Flyout, FlyoutItem } from './flyout_base.js';
+import { Flyout } from './flyout_base.js';
+import type { FlyoutItem } from './flyout_item.js';
 import type { Options } from './options.js';
 import type { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';

package/core/flyout_item.d.ts

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

package/core/flyout_vertical.d.ts

@@ -3,7 +3,8 @@
  * Copyright 2017 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Flyout, FlyoutItem } from './flyout_base.js';
+import { Flyout } from './flyout_base.js';
+import type { FlyoutItem } from './flyout_item.js';
 import type { Options } from './options.js';
 import type { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';

package/core/interfaces/i_flyout.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { BlockSvg } from '../block_svg.js';
-import { FlyoutItem } from '../flyout_base.js';
+import type { FlyoutItem } from '../flyout_item.js';
 import type { Coordinate } from '../utils/coordinate.js';
 import type { Svg } from '../utils/svg.js';
 import type { FlyoutDefinition } from '../utils/toolbox.js';

package/core/interfaces/i_flyout_inflater.d.ts

@@ -1,5 +1,5 @@
-import type { WorkspaceSvg } from '../workspace_svg.js';
-import type { IBoundedElement } from './i_bounded_element.js';
+import type { FlyoutItem } from '../flyout_item.js';
+import type { IFlyout } from './i_flyout.js';
 export interface IFlyoutInflater {
     /**
      * Loads the object represented by the given state onto the workspace.
@@ -8,14 +8,14 @@ export interface IFlyoutInflater {
      * allow for code reuse.
      *
      * @param state A JSON representation of an element to inflate on the flyout.
-     * @param flyoutWorkspace The flyout's workspace, where the inflated element
+     * @param flyout The flyout on whose workspace the inflated element
      *    should be created. If the inflated element is an `IRenderedElement` it
      *    itself or the inflater should append it to the workspace; the flyout
      *    will not do so itself. The flyout is responsible for positioning the
      *    element, however.
      * @returns The newly inflated flyout element.
      */
-    load(state: object, flyoutWorkspace: WorkspaceSvg): IBoundedElement;
+    load(state: object, flyout: IFlyout): FlyoutItem;
     /**
      * Returns the amount of spacing that should follow the element corresponding
      * to the given JSON representation.
@@ -24,7 +24,7 @@ export interface IFlyoutInflater {
      * @param defaultGap The default gap for elements in this flyout.
      * @returns The gap that should follow the given element.
      */
-    gapForElement(state: object, defaultGap: number): number;
+    gapForItem(state: object, defaultGap: number): number;
     /**
      * Disposes of the given element.
      *
@@ -34,6 +34,15 @@ export interface IFlyoutInflater {
      *
      * @param element The flyout element to dispose of.
      */
-    disposeElement(element: IBoundedElement): void;
+    disposeItem(item: FlyoutItem): void;
+    /**
+     * Returns the type of items that this inflater is responsible for inflating.
+     * This should be the same as the name under which this inflater registers
+     * itself, as well as the value returned by `getType()` on the `FlyoutItem`
+     * objects returned by `load()`.
+     *
+     * @returns The type of items this inflater creates.
+     */
+    getType(): string;
 }
 //# sourceMappingURL=i_flyout_inflater.d.ts.map

package/core/interfaces/i_focusable_node.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IFocusableTree } from './i_focusable_tree.js';
+/** Represents anything that can have input focus. */
+export interface IFocusableNode {
+    /**
+     * Returns the DOM element that can be explicitly requested to receive focus.
+     *
+     * IMPORTANT: Please note that this element is expected to have a visual
+     * presence on the page as it will both be explicitly focused and have its
+     * style changed depending on its current focus state (i.e. blurred, actively
+     * focused, and passively focused). The element will have one of two styles
+     * attached (where no style indicates blurred/not focused):
+     * - blocklyActiveFocus
+     * - blocklyPassiveFocus
+     *
+     * The returned element must also have a valid ID specified, and unique to the
+     * element relative to its nearest IFocusableTree parent.
+     *
+     * It's expected the return element will not change for the lifetime of the
+     * node.
+     */
+    getFocusableElement(): HTMLElement | SVGElement;
+    /**
+     * Returns the closest parent tree of this node (in cases where a tree has
+     * distinct trees underneath it), which represents the tree to which this node
+     * belongs.
+     */
+    getFocusableTree(): IFocusableTree;
+}
+//# sourceMappingURL=i_focusable_node.d.ts.map