blockly 12.5.1 → 13.0.0-beta.1

package/core/keyboard_nav/{field_navigation_policy.d.ts → navigation_policies/field_navigation_policy.d.ts}

@@ -3,9 +3,9 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Field } from '../field.js';
-import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
-import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+import { Field } from '../../field.js';
+import type { IFocusableNode } from '../../interfaces/i_focusable_node.js';
+import type { INavigationPolicy } from '../../interfaces/i_navigation_policy.js';
 /**
  * Set of rules controlling keyboard navigation from a field.
  */
@@ -38,6 +38,13 @@ export declare class FieldNavigationPolicy implements INavigationPolicy<Field<an
      * @returns The preceding field or input in the given field's block.
      */
     getPreviousSibling(current: Field<any>): IFocusableNode | null;
+    /**
+     * Returns the row ID of the given field.
+     *
+     * @param current The field to retrieve the row ID of.
+     * @returns The row ID of the given field.
+     */
+    getRowId(current: Field<any>): string;
     /**
      * Returns whether or not the given field can be navigated to.
      *

package/core/keyboard_nav/{flyout_button_navigation_policy.d.ts → navigation_policies/flyout_button_navigation_policy.d.ts}

@@ -3,9 +3,9 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { FlyoutButton } from '../flyout_button.js';
-import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
-import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+import { FlyoutButton } from '../../flyout_button.js';
+import type { IFocusableNode } from '../../interfaces/i_focusable_node.js';
+import type { INavigationPolicy } from '../../interfaces/i_navigation_policy.js';
 /**
  * Set of rules controlling keyboard navigation from a flyout button.
  */
@@ -38,6 +38,13 @@ export declare class FlyoutButtonNavigationPolicy implements INavigationPolicy<F
      * @returns Null.
      */
     getPreviousSibling(_current: FlyoutButton): IFocusableNode | null;
+    /**
+     * Returns the row ID of the given flyout button.
+     *
+     * @param current The flyout button to retrieve the row ID of.
+     * @returns The row ID of the given flyout button.
+     */
+    getRowId(current: FlyoutButton): string;
     /**
      * Returns whether or not the given flyout button can be navigated to.
      *

package/core/keyboard_nav/{flyout_separator_navigation_policy.d.ts → navigation_policies/flyout_separator_navigation_policy.d.ts}

@@ -3,9 +3,9 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { FlyoutSeparator } from '../flyout_separator.js';
-import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
-import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+import { FlyoutSeparator } from '../../flyout_separator.js';
+import type { IFocusableNode } from '../../interfaces/i_focusable_node.js';
+import type { INavigationPolicy } from '../../interfaces/i_navigation_policy.js';
 /**
  * Set of rules controlling keyboard navigation from a flyout separator.
  * This is a no-op placeholder, since flyout separators can't be navigated to.
@@ -15,6 +15,12 @@ export declare class FlyoutSeparatorNavigationPolicy implements INavigationPolic
     getParent(_current: FlyoutSeparator): IFocusableNode | null;
     getNextSibling(_current: FlyoutSeparator): IFocusableNode | null;
     getPreviousSibling(_current: FlyoutSeparator): IFocusableNode | null;
+    /**
+     * Returns the row ID of the given flyout separator.
+     *
+     * @returns Dummy row ID, as flyout separators are never navigable.
+     */
+    getRowId(): string;
     /**
      * Returns whether or not the given flyout separator can be navigated to.
      *

package/core/keyboard_nav/{icon_navigation_policy.d.ts → navigation_policies/icon_navigation_policy.d.ts}

@@ -3,9 +3,9 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Icon } from '../icons/icon.js';
-import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
-import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+import { Icon } from '../../icons/icon.js';
+import type { IFocusableNode } from '../../interfaces/i_focusable_node.js';
+import type { INavigationPolicy } from '../../interfaces/i_navigation_policy.js';
 /**
  * Set of rules controlling keyboard navigation from an icon.
  */
@@ -13,10 +13,10 @@ export declare class IconNavigationPolicy implements INavigationPolicy<Icon> {
     /**
      * Returns the first child of the given icon.
      *
-     * @param current The icon to return the first child of.
+     * @param _current The icon to return the first child of.
      * @returns Null.
      */
-    getFirstChild(current: Icon): IFocusableNode | null;
+    getFirstChild(_current: Icon): IFocusableNode | null;
     /**
      * Returns the parent of the given icon.
      *
@@ -38,6 +38,13 @@ export declare class IconNavigationPolicy implements INavigationPolicy<Icon> {
      * @returns The icon's previous icon, if any.
      */
     getPreviousSibling(current: Icon): IFocusableNode | null;
+    /**
+     * Returns the row ID of the given icon.
+     *
+     * @param current The icon to retrieve the row ID of.
+     * @returns The row ID of the given icon.
+     */
+    getRowId(current: Icon): string;
     /**
      * Returns whether or not the given icon can be navigated to.
      *

package/core/keyboard_nav/navigation_policies/toolbox_item_navigation_policy.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright 2026 Raspberry Pi Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IFocusableNode } from '../../interfaces/i_focusable_node.js';
+import type { INavigationPolicy } from '../../interfaces/i_navigation_policy.js';
+import { type IToolboxItem } from '../../interfaces/i_toolbox_item.js';
+/**
+ * Set of rules controlling keyboard navigation from a toolbox item.
+ */
+export declare class ToolboxItemNavigationPolicy implements INavigationPolicy<IToolboxItem> {
+    /**
+     * Returns the first child of the given toolbox item.
+     *
+     * @param current The toolbox item to return the first child of.
+     * @returns The child item of a collapsible toolbox item, otherwise null.
+     */
+    getFirstChild(current: IToolboxItem): IFocusableNode | null;
+    /**
+     * Returns the parent of the given toolbox item.
+     *
+     * @param current The toolbox item to return the parent of.
+     * @returns The parent toolbox item of the given toolbox item, if any.
+     */
+    getParent(current: IToolboxItem): IFocusableNode | null;
+    /**
+     * Returns the next sibling of the given toolbox item.
+     *
+     * @param current The toolbox item to return the next sibling of.
+     * @returns The next toolbox item, or null.
+     */
+    getNextSibling(current: IToolboxItem): IFocusableNode | null;
+    /**
+     * Returns the previous sibling of the given toolbox item.
+     *
+     * @param current The toolbox item to return the previous sibling of.
+     * @returns The previous toolbox item, or null.
+     */
+    getPreviousSibling(current: IToolboxItem): IFocusableNode | null;
+    /**
+     * Returns the row ID of the given toolbox item.
+     *
+     * @param current The toolbox item to retrieve the row ID of.
+     * @returns The row ID of the given toolbox item.
+     */
+    getRowId(current: IToolboxItem): string;
+    /**
+     * Returns whether or not the given toolbox item can be navigated to.
+     *
+     * @param current The instance to check for navigability.
+     * @returns True if the given toolbox item can be focused.
+     */
+    isNavigable(current: IToolboxItem): boolean;
+    private allParentsExpanded;
+    /**
+     * Returns whether the given object can be navigated from by this policy.
+     *
+     * @param current The object to check if this policy applies to.
+     * @returns True if the object is an IToolboxItem.
+     */
+    isApplicable(current: any): current is IToolboxItem;
+}
+//# sourceMappingURL=toolbox_item_navigation_policy.d.ts.map

package/core/keyboard_nav/{workspace_comment_navigation_policy.d.ts → navigation_policies/workspace_comment_navigation_policy.d.ts}

@@ -3,9 +3,9 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { RenderedWorkspaceComment } from '../comments/rendered_workspace_comment.js';
-import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
-import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+import { RenderedWorkspaceComment } from '../../comments/rendered_workspace_comment.js';
+import type { IFocusableNode } from '../../interfaces/i_focusable_node.js';
+import type { INavigationPolicy } from '../../interfaces/i_navigation_policy.js';
 /**
  * Set of rules controlling keyboard navigation from an RenderedWorkspaceComment.
  */
@@ -27,17 +27,22 @@ export declare class WorkspaceCommentNavigationPolicy implements INavigationPoli
     /**
      * Returns the next peer node of the given workspace comment.
      *
-     * @param current The workspace comment to find the following element of.
-     * @returns The next workspace comment or block stack, if any.
+     * @returns Null, as workspace comments do not have peers.
      */
-    getNextSibling(current: RenderedWorkspaceComment): IFocusableNode | null;
+    getNextSibling(): IFocusableNode | null;
     /**
      * Returns the previous peer node of the given workspace comment.
      *
-     * @param current The workspace comment to find the preceding element of.
-     * @returns The previous workspace comment or block stack, if any.
+     * @returns Null, as workspace comments do not have peers.
      */
-    getPreviousSibling(current: RenderedWorkspaceComment): IFocusableNode | null;
+    getPreviousSibling(): IFocusableNode | null;
+    /**
+     * Returns the row ID of the given workspace comment.
+     *
+     * @param current The workspace comment to retrieve the row ID of.
+     * @returns The row ID of the given workspace comment.
+     */
+    getRowId(current: RenderedWorkspaceComment): string;
     /**
      * Returns whether or not the given workspace comment can be navigated to.
      *

package/core/keyboard_nav/{workspace_navigation_policy.d.ts → navigation_policies/workspace_navigation_policy.d.ts}

@@ -3,9 +3,9 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
-import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
+import type { IFocusableNode } from '../../interfaces/i_focusable_node.js';
+import type { INavigationPolicy } from '../../interfaces/i_navigation_policy.js';
+import { WorkspaceSvg } from '../../workspace_svg.js';
 /**
  * Set of rules controlling keyboard navigation from a workspace.
  */
@@ -38,6 +38,13 @@ export declare class WorkspaceNavigationPolicy implements INavigationPolicy<Work
      * @returns Null.
      */
     getPreviousSibling(_current: WorkspaceSvg): IFocusableNode | null;
+    /**
+     * Returns the row ID of the given workspace.
+     *
+     * @param current The workspace to retrieve the row ID of.
+     * @returns The row ID of the given workspace.
+     */
+    getRowId(current: WorkspaceSvg): string;
     /**
      * Returns whether or not the given workspace can be navigated to.
      *

package/core/keyboard_nav/navigators/flyout_navigator.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IFlyout } from '../../interfaces/i_flyout.js';
+import type { IFocusableNode } from '../../interfaces/i_focusable_node.js';
+import { Navigator } from './navigator.js';
+/**
+ * Navigator that handles keyboard navigation within a flyout.
+ */
+export declare class FlyoutNavigator extends Navigator {
+    protected flyout: IFlyout;
+    constructor(flyout: IFlyout);
+    /**
+     * Returns the parent toolbox item or previous flyout item when navigating out
+     * (left arrow) from a flyout.
+     *
+     * @param node The flyout item to navigate relative to.
+     * @param bypassAdjustments True to skip adjusting navigation based on the
+     *     flyout's layout; false (default) to take it into account.
+     */
+    getOutNode(node?: IFocusableNode | null, bypassAdjustments?: boolean): IFocusableNode | null;
+    /**
+     * Returns the parent toolbox item or next flyout item when navigating in
+     * (right arrow) from a flyout.
+     *
+     * @param node The flyout item to navigate relative to.
+     * @param bypassAdjustments True to skip adjusting navigation based on the
+     *     flyout's layout; false (default) to take it into account.
+     */
+    getInNode(node?: IFocusableNode | null, bypassAdjustments?: boolean): IFocusableNode | null;
+    /**
+     * Returns the parent toolbox item or next flyout item when navigating next
+     * (down arrow) from a flyout.
+     *
+     * @param node The flyout item to navigate relative to.
+     * @param bypassAdjustments True to skip adjusting navigation based on the
+     *     flyout's layout; false (default) to take it into account.
+     */
+    getNextNode(node?: IFocusableNode | null, bypassAdjustments?: boolean): IFocusableNode | null;
+    /**
+     * Returns the parent toolbox item or previous flyout item when navigating
+     * previous (up arrow) from a flyout.
+     *
+     * @param node The flyout item to navigate relative to.
+     * @param bypassAdjustments True to skip adjusting navigation based on the
+     *     flyout's layout; false (default) to take it into account.
+     */
+    getPreviousNode(node?: IFocusableNode | null, bypassAdjustments?: boolean): IFocusableNode | null;
+    /**
+     * Returns a list of top-level navigable flyout items.
+     */
+    protected getTopLevelItems(): IFocusableNode[];
+    /**
+     * Returns whether or not the given node is navigable.
+     *
+     * @param node A focusable node to check the navigability of.
+     * @returns True if the node is navigable, otherwise false.
+     */
+    protected isNavigable(node: IFocusableNode): boolean | undefined;
+}
+//# sourceMappingURL=flyout_navigator.d.ts.map

package/core/keyboard_nav/navigators/navigator.d.ts

@@ -0,0 +1,225 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BlockSvg } from '../../block_svg.js';
+import type { IFocusableNode } from '../../interfaces/i_focusable_node.js';
+import type { INavigationPolicy } from '../../interfaces/i_navigation_policy.js';
+type RuleList<T> = INavigationPolicy<T>[];
+/**
+ * Representation of the direction of travel within a navigation context.
+ */
+export declare enum NavigationDirection {
+    NEXT = 0,
+    PREVIOUS = 1,
+    IN = 2,
+    OUT = 3
+}
+/**
+ * Class responsible for determining where focus should move in response to
+ * keyboard navigation commands.
+ */
+export declare class Navigator {
+    /**
+     * Map from classes to a corresponding ruleset to handle navigation from
+     * instances of that class.
+     */
+    protected rules: RuleList<any>;
+    /** Whether or not navigation loops around when reaching the end. */
+    protected navigationLoops: boolean;
+    /**
+     * Adds a navigation ruleset to this Navigator.
+     *
+     * @param policy A ruleset that determines where focus should move starting
+     *     from an instance of its managed class.
+     */
+    addNavigationPolicy(policy: INavigationPolicy<any>): void;
+    /**
+     * Returns the navigation ruleset associated with the given object instance's
+     * class.
+     *
+     * @param current An object to retrieve a navigation ruleset for.
+     * @returns The navigation ruleset of objects of the given object's class, or
+     *     undefined if no ruleset has been registered for the object's class.
+     */
+    private get;
+    /**
+     * Returns the first child of the given object instance, if any.
+     *
+     * @param current The object to retrieve the first child of.
+     * @returns The first child node of the given object, if any.
+     */
+    getFirstChild(current: IFocusableNode): IFocusableNode | null;
+    /**
+     * Returns the parent of the given object instance, if any.
+     *
+     * @param current The object to retrieve the parent of.
+     * @returns The parent node of the given object, if any.
+     */
+    getParent(current: IFocusableNode): IFocusableNode | null;
+    /**
+     * Returns the next sibling of the given object instance, if any.
+     *
+     * @param current The object to retrieve the next sibling node of.
+     * @returns The next sibling node of the given object, if any.
+     */
+    getNextSibling(current: IFocusableNode): IFocusableNode | null;
+    /**
+     * Returns the previous sibling of the given object instance, if any.
+     *
+     * @param current The object to retrieve the previous sibling node of.
+     * @returns The previous sibling node of the given object, if any.
+     */
+    getPreviousSibling(current: IFocusableNode): IFocusableNode | null;
+    /**
+     * Returns the previous node relative to the given node.
+     *
+     * @param node The node to navigate relative to, defaults to the currently
+     *     focused node.
+     * @returns The previous node, generally on the "row" visually above the
+     *     specified node, or null if there is none.
+     */
+    getPreviousNode(node?: IFocusableNode | null): IFocusableNode | null;
+    /**
+     * Returns the node to the left of the given node.
+     *
+     * @param node The node to navigate relative to, defaults to the currently
+     *     focused node.
+     * @returns The node to the left of the given node, within the same visual
+     *     "row" as the given node, or null if there is none.
+     */
+    getOutNode(node?: IFocusableNode | null): IFocusableNode | null;
+    /**
+     * Returns next node relative to the given node.
+     *
+     * @param node The node to navigate relative to, defaults to the currently
+     *     focused node.
+     * @returns The next node, generally on the "row" visually below the
+     *     specified node, or null if there is none.
+     */
+    getNextNode(node?: IFocusableNode | null): IFocusableNode | null;
+    /**
+     * Returns the node to the right of the given node.
+     *
+     * @param node The node to navigate relative to, defaults to the currently
+     *     focused node.
+     * @returns The node to the right of the given node, within the same visual
+     *     "row" as the given node, or null if there is none.
+     */
+    getInNode(node?: IFocusableNode | null): IFocusableNode | null;
+    /**
+     * Returns the previous sibling/parent node relative to the given node.
+     *
+     * @param startNode The node that navigation is starting from.
+     * @param node The node to navigate relative to.
+     * @param direction The direction to navigate, either OUT or PREVIOUS.
+     * @param visitedNodes Set of already-visited nodes used to avoid cycles,
+     *     should not be specified by the caller.
+     * @returns The previous sibling/parent node, or null if there is none or a
+     *     node was not provided.
+     */
+    private getPreviousNodeImpl;
+    /**
+     * Returns the next sibling/child node relative to the given node.
+     *
+     * @param startNode The node that navigation is starting from.
+     * @param node The node to navigate relative to.
+     * @param direction The direction to navigate, either IN or NEXT.
+     * @param visitedNodes Set of already-visited nodes used to avoid cycles,
+     *     should not be specified by the caller.
+     * @returns The next sibling/child node, or null if there is none or a
+     *     node was not provided.
+     */
+    private getNextNodeImpl;
+    private getRightMostChild;
+    /**
+     * Sets whether or not navigation should loop around when reaching the end
+     * of the workspace.
+     *
+     * @param loops True if navigation should loop around, otherwise false.
+     */
+    setNavigationLoops(loops: boolean): void;
+    /**
+     * Returns whether or not navigation loops around when reaching the end of
+     * the workspace.
+     */
+    getNavigationLoops(): boolean;
+    /**
+     * Get the first navigable node on the workspace, or null if none exist.
+     *
+     * @returns The first navigable node on the workspace, or null.
+     */
+    getFirstNode(): IFocusableNode | null;
+    /**
+     * Get the last navigable node on the workspace, or null if none exist.
+     *
+     * @returns The last navigable node on the workspace, or null.
+     */
+    getLastNode(): IFocusableNode | null;
+    /**
+     * Determines whether navigation is allowed between two nodes.
+     *
+     * @param current The starting node for proposed navigation.
+     * @param candidate The proposed destination node.
+     * @param direction The direction in which the user is navigating.
+     * @returns True if navigation should be allowed to proceed, or false to find
+     *     a different candidate.
+     */
+    protected transitionAllowed(current: IFocusableNode, candidate: IFocusableNode, direction: NavigationDirection): boolean;
+    /**
+     * Returns the leftmost node in the same row as the given node.
+     *
+     * @param node The node to find the leftmost sibling of.
+     * @returns The leftmost sibling of the given node in the same row.
+     */
+    private getLeftmostSibling;
+    /**
+     * Returns the last node in a stack of blocks or other top-level workspace
+     * entity.
+     *
+     * @param stackRoot A top-level item to get the last node of.
+     * @param stopIfFound A sentinel node that terminates traversal if
+     *     encountered; typically the root node of the next stack.
+     * @returns The last node in the given stack.
+     */
+    private getLastNodeInStack;
+    private getRowId;
+    /**
+     * Returns the next/previous stack relative to the given element's stack.
+     *
+     * @internal
+     * @param current The element whose stack will be navigated relative to.
+     * @param delta The difference in index to navigate; positive values navigate
+     *     to the nth next stack, while negative values navigate to the nth
+     *     previous stack.
+     * @returns The first element in the stack offset by `delta` relative to the
+     *     current element's stack, or the last element in the stack offset by
+     * `delta` relative to the current element's stack when navigating backwards.
+     */
+    navigateStacks(current: IFocusableNode, delta: number): IFocusableNode | null;
+    /**
+     * Returns a list of all top-level focusable items on the given node's
+     * focusable tree.
+     *
+     * @param current The node whose root focusable tree to retrieve the top-level
+     *     items of.
+     * @returns A list of all top-level items on the given node's parent tree.
+     */
+    protected getTopLevelItems(current: IFocusableNode): IFocusableNode[];
+    /**
+     * Returns whether or not the given node is navigable.
+     *
+     * @param node A focusable node to check the navigability of.
+     * @returns True if the node is navigable, otherwise false.
+     */
+    protected isNavigable(node: IFocusableNode): boolean | undefined;
+    /**
+     * Returns the block that the given node is a child of.
+     *
+     * @returns The parent block of the node if any, otherwise null.
+     */
+    getSourceBlockFromNode(node: IFocusableNode | null): BlockSvg | null;
+}
+export {};
+//# sourceMappingURL=navigator.d.ts.map

package/core/keyboard_nav/navigators/toolbox_navigator.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2026 Raspberry Pi Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IFocusableNode } from '../../interfaces/i_focusable_node.js';
+import type { IToolbox } from '../../interfaces/i_toolbox.js';
+import { Position } from '../../utils/toolbox.js';
+import type { WorkspaceSvg } from '../../workspace_svg.js';
+import { Navigator } from './navigator.js';
+/**
+ * Navigator that handles keyboard navigation within a toolbox.
+ */
+export declare class ToolboxNavigator extends Navigator {
+    protected toolbox: IToolbox;
+    constructor(toolbox: IToolbox);
+    /**
+     * Returns the flyout's first item (if any) or next toolbox item when
+     * navigating in (right arrow) from a toolbox.
+     *
+     * @param node The toolbox item to navigate relative to.
+     * @param bypassAdjustments True to skip adjusting navigation based on the
+     *     toolbox's layout; false (default) to take it into account.
+     */
+    getInNode(node?: IFocusableNode | null, bypassAdjustments?: boolean): IFocusableNode | null;
+    /**
+     * Returns the flyout's first item (if any) or previous toolbox item when
+     * navigating out (left arrow) from a toolbox.
+     *
+     * @param node The toolbox item to navigate relative to.
+     * @param bypassAdjustments True to skip adjusting navigation based on the
+     *     toolbox's layout; false (default) to take it into account.
+     */
+    getOutNode(node?: IFocusableNode | null, bypassAdjustments?: boolean): IFocusableNode | null;
+    /**
+     * Returns the flyout's first item (if any) or next toolbox item when
+     * navigating next (down arrow) from a toolbox.
+     *
+     * @param node The toolbox item to navigate relative to.
+     * @param bypassAdjustments True to skip adjusting navigation based on the
+     *     toolbox's layout; false (default) to take it into account.
+     */
+    getNextNode(node?: IFocusableNode | null, bypassAdjustments?: boolean): IFocusableNode | null;
+    /**
+     * Returns the flyout's first item (if any) or previous toolbox item when
+     * navigating previous (up arrow) from a toolbox.
+     *
+     * @param node The toolbox item to navigate relative to.
+     * @param bypassAdjustments True to skip adjusting navigation based on the
+     *     toolbox's layout; false (default) to take it into account.
+     */
+    getPreviousNode(node?: IFocusableNode | null, bypassAdjustments?: boolean): IFocusableNode | null;
+    /**
+     * Returns a list of all toolbox items.
+     */
+    protected getTopLevelItems(): IFocusableNode[];
+}
+/**
+ * Although developers specify the toolbox position as "start" or "end", this
+ * gets normalized by the injection options parser based on RTL, such that "end"
+ * in RTL means the left. When dealing with arrow keys, we want the actual/
+ * physical position on screen, not the logical position. This function converts
+ * the stored logical position to the physical position.
+ *
+ * @internal
+ * @param workspace The workspace to use injection options from.
+ * @returns The physical location of the toolbox/flyout on screen.
+ */
+export declare function getPhysicalToolboxPosition(workspace: WorkspaceSvg): Position;
+//# sourceMappingURL=toolbox_navigator.d.ts.map

package/core/registry.d.ts

@@ -19,7 +19,6 @@ import type { ISerializer } from './interfaces/i_serializer.js';
 import type { IToolbox } from './interfaces/i_toolbox.js';
 import type { IVariableMap } from './interfaces/i_variable_map.js';
 import type { IVariableModel, IVariableModelStatic, IVariableState } from './interfaces/i_variable_model.js';
-import type { LineCursor } from './keyboard_nav/line_cursor.js';
 import type { Options } from './options.js';
 import type { Renderer } from './renderers/common/renderer.js';
 import type { Theme } from './theme.js';
@@ -50,7 +49,6 @@ export declare class Type<_T> {
     toString(): string;
     static CONNECTION_CHECKER: Type<IConnectionChecker>;
     static CONNECTION_PREVIEWER: Type<IConnectionPreviewer>;
-    static CURSOR: Type<LineCursor>;
     static EVENT: Type<Abstract>;
     static FIELD: Type<Field<any>>;
     static INPUT: Type<Input>;

package/core/renderers/common/constants.d.ts

@@ -244,8 +244,6 @@ export declare class ConstantProvider {
      * The <filter> element to use for a debug highlight, or null if not set.
      */
     private debugFilter;
-    /** The <style> element to use for injecting renderer specific CSS. */
-    private cssNode;
     /**
      * Cursor colour.
      */
@@ -422,7 +420,6 @@ export declare class ConstantProvider {
      * Create any DOM elements that this renderer needs (filters, patterns, etc).
      *
      * @param svg The root of the workspace's SVG.
-     * @param tagName The name to use for the CSS style tag.
      * @param selector The CSS selector to use.
      * @param injectionDivIfIsParent The div containing the parent workspace and
      *   all related workspaces and block containers, if this renderer is for the
@@ -430,7 +427,7 @@ export declare class ConstantProvider {
      *   to this container. Child workspaces should not override the CSS variables
      *   created by the parent and thus do not need access to the injection div.
      */
-    createDom(svg: SVGElement, tagName: string, selector: string, injectionDivIfIsParent?: HTMLElement): void;
+    createDom(svg: SVGElement, selector: string, injectionDivIfIsParent?: HTMLElement): void;
     /**
      * Create a filter for highlighting the currently rendering block during
      * render debugging.
@@ -439,10 +436,10 @@ export declare class ConstantProvider {
     /**
      * Inject renderer specific CSS into the page.
      *
-     * @param tagName The name of the style tag to use.
-     * @param selector The CSS selector to use.
+     * @param root The document root to inject the CSS into.
+     * @param selector The CSS selector to interpolate into the stylesheet.
      */
-    protected injectCSS_(tagName: string, selector: string): void;
+    protected injectCSS_(root: Document | ShadowRoot, selector: string): void;
     /**
      * Get any renderer specific CSS to inject when the renderer is initialized.
      *