@cp949/phyx-blockly 12.5.1-p1 → 13.4.0-patch.1

package/core/toolbox/toolbox.d.ts

@@ -3,6 +3,11 @@
  * Copyright 2020 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+/**
+ * Toolbox from whence to create blocks.
+ *
+ * @class
+ */
 import * as browserEvents from '../browser_events.js';
 import { DeleteArea } from '../delete_area.js';
 import '../events/events_toolbox_item_select.js';
@@ -16,6 +21,7 @@ import type { ISelectableToolboxItem } from '../interfaces/i_selectable_toolbox_
 import type { IStyleable } from '../interfaces/i_styleable.js';
 import type { IToolbox } from '../interfaces/i_toolbox.js';
 import type { IToolboxItem } from '../interfaces/i_toolbox_item.js';
+import { ToolboxNavigator } from '../keyboard_nav/navigators/toolbox_navigator.js';
 import type { KeyboardShortcut } from '../shortcut_registry.js';
 import { Rect } from '../utils/rect.js';
 import * as toolbox from '../utils/toolbox.js';
@@ -62,6 +68,8 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     protected readonly workspace_: WorkspaceSvg;
     /** Whether the mouse is currently being clicked. */
     private mouseDown;
+    /** Object used by keyboard navigation to move focus in this toolbox. */
+    private navigator;
     /** @param workspace The workspace in which to create new blocks. */
     constructor(workspace: WorkspaceSvg);
     /**
@@ -176,17 +184,6 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
      *     ignored.
      */
     getClientRect(): Rect | null;
-    /**
-     * Returns whether the provided block or bubble would be deleted if dropped on
-     * this area.
-     * This method should check if the element is deletable and is always called
-     * before onDragEnter/onDragOver/onDragExit.
-     *
-     * @param element The block or bubble currently being dragged.
-     * @returns Whether the element provided would be deleted if dropped on this
-     *     area.
-     */
-    wouldDelete(element: IDraggable): boolean;
     /**
      * Handles when a cursor with a block or bubble enters this drag target.
      *
@@ -367,30 +364,12 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
      */
     private fireSelectEvent;
     /**
-     * Closes the current item if it is expanded, or selects the parent.
-     *
-     * @returns True if a parent category was selected, false otherwise.
-     */
-    private selectParent;
-    /**
-     * Selects the first child of the currently selected item, or nothing if the
-     * toolbox item has no children.
+     * Sets the currently selected item's expansion state, if possible.
      *
-     * @returns True if a child category was selected, false otherwise.
+     * @param expanded True to expand the item or false to collapse it.
+     * @returns True if the selected item's expansion state was updated.
      */
-    private selectChild;
-    /**
-     * Selects the next visible toolbox item.
-     *
-     * @returns True if a next category was selected, false otherwise.
-     */
-    private selectNext;
-    /**
-     * Selects the previous visible toolbox item.
-     *
-     * @returns True if a previous category was selected, false otherwise.
-     */
-    private selectPrevious;
+    private toggleSelectedItem;
     /** Disposes of this toolbox. */
     dispose(): void;
     /** See IFocusableNode.getFocusableElement. */
@@ -415,5 +394,10 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     onTreeFocus(node: IFocusableNode, _previousTree: IFocusableTree | null): void;
     /** See IFocusableTree.onTreeBlur. */
     onTreeBlur(nextTree: IFocusableTree | null): void;
+    /**
+     * Returns the Navigator instance to use to move between items in this
+     * toolbox.
+     */
+    getNavigator(): ToolboxNavigator;
 }
 //# sourceMappingURL=toolbox.d.ts.map

package/core/toolbox/toolbox_item.d.ts

@@ -105,5 +105,9 @@ export declare class ToolboxItem implements IToolboxItem {
     onNodeBlur(): void;
     /** See IFocusableNode.canBeFocused. */
     canBeFocused(): boolean;
+    /**
+     * Returns the toolbox this toolbox item belongs to.
+     */
+    getParentToolbox(): IToolbox;
 }
 //# sourceMappingURL=toolbox_item.d.ts.map

package/core/tooltip.d.ts

@@ -3,6 +3,8 @@
  * Copyright 2011 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
+import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * A type which can define a tooltip.
  * Either a string, an object containing a tooltip property, or a function which
@@ -23,9 +25,10 @@ export type CustomTooltip = (p1: Element, p2: Element) => any;
  * Sets a custom function that will be called if present instead of the default
  * tooltip UI.
  *
- * @param customFn A custom tooltip used to render an alternate tooltip UI.
+ * @param customFn A custom tooltip used to render an alternate tooltip UI, or
+ *     undefined to use the default implementation.
  */
-export declare function setCustomTooltip(customFn: CustomTooltip): void;
+export declare function setCustomTooltip(customFn: CustomTooltip | undefined): void;
 /**
  * Gets the custom tooltip function.
  *
@@ -101,6 +104,14 @@ export declare function dispose(): void;
  * Hide the tooltip.
  */
 export declare function hide(): void;
+/**
+ * Display the tooltip for a given target.
+ *
+ * @internal
+ * @param target The node upon which the tooltip should be displayed.
+ * @param workspace The target node's workspace.
+ */
+export declare function display(target: IFocusableNode, workspace?: WorkspaceSvg): void;
 /**
  * Hide any in-progress tooltips and block showing new tooltips until the next
  * call to unblock().

package/core/trashcan.d.ts

@@ -6,6 +6,7 @@
 import { DeleteArea } from './delete_area.js';
 import './events/events_trashcan_open.js';
 import type { IAutoHideable } from './interfaces/i_autohideable.js';
+import type { IComponent } from './interfaces/i_component';
 import type { IDraggable } from './interfaces/i_draggable.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
 import type { IPositionable } from './interfaces/i_positionable.js';
@@ -15,13 +16,20 @@ import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for a trash can.
  */
-export declare class Trashcan extends DeleteArea implements IAutoHideable, IPositionable {
+export declare class Trashcan extends DeleteArea implements IAutoHideable, IPositionable, IComponent {
     private workspace;
     /**
-     * The unique id for this component that is used to register with the
+     * The id for this component that is used to register with the
      * ComponentManager.
      */
     id: string;
+    /**
+     * A globally unique ID for this particular trashcan. Component Manager IDs
+     * (the ID above) are 1:1 with classes, but if there are multiple workspaces
+     * with trashcans on a page, each actual trashcan DOM element needs a unique
+     * ID to support focusable node resolution. This ID is for that purpose.
+     */
+    private uniqueId;
     /**
      * A list of JSON (stored as strings) representing blocks in the trashcan.
      */
@@ -34,19 +42,8 @@ export declare class Trashcan extends DeleteArea implements IAutoHideable, IPosi
     flyout: IFlyout | null;
     /** Current open/close state of the lid. */
     isLidOpen: boolean;
-    /**
-     * The minimum openness of the lid. Used to indicate if the trashcan
-     * contains blocks.
-     */
-    private minOpenness;
     /** The SVG group containing the trash can. */
     private svgGroup;
-    /** The SVG image element of the trash can lid. */
-    private svgLid;
-    /** Task ID of opening/closing animation. */
-    private lidTask;
-    /** Current state of lid opening (0.0 = closed, 1.0 = open). */
-    private lidOpen;
     /** Left coordinate of the trash can. */
     private left;
     /** Top coordinate of the trash can. */
@@ -148,22 +145,6 @@ export declare class Trashcan extends DeleteArea implements IAutoHideable, IPosi
      * @internal
      */
     setLidOpen(state: boolean): void;
-    /** Rotate the lid open or closed by one step.  Then wait and recurse. */
-    private animateLid;
-    /**
-     * Set the angle of the trashcan's lid.
-     *
-     * @param lidAngle The angle at which to set the lid.
-     */
-    private setLidAngle;
-    /**
-     * Sets the minimum openness of the trashcan lid. If the lid is currently
-     * closed, this will update lid's position.
-     *
-     * @param newMin The new minimum openness of the lid. Should be between 0
-     *     and 1.
-     */
-    private setMinOpenness;
     /**
      * Flip the lid shut.
      * Called externally after a drag.
@@ -171,6 +152,12 @@ export declare class Trashcan extends DeleteArea implements IAutoHideable, IPosi
     closeLid(): void;
     /** Inspect the contents of the trash. */
     click(): void;
+    /**
+     * Activates the trashcan when Enter or Space is pressed.
+     *
+     * @param e A keydown event.
+     */
+    private onKeyDown;
     /**
      * Fires a UI event for trashcan flyout open or close.
      *
@@ -183,15 +170,6 @@ export declare class Trashcan extends DeleteArea implements IAutoHideable, IPosi
      * @param e A mouse down event.
      */
     private blockMouseDownWhenOpenable;
-    /**
-     * Indicate that the trashcan can be clicked (by opening it) if it has blocks.
-     */
-    private mouseOver;
-    /**
-     * Close the lid of the trashcan if it was open (Vis. it was indicating it had
-     *    blocks).
-     */
-    private mouseOut;
     /**
      * Handle a BLOCK_DELETE event. Adds deleted blocks oldXml to the content
      * array.

package/core/utils/aria.d.ts

@@ -4,66 +4,297 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 /**
- * ARIA role values.
- * Copied from Closure's goog.a11y.aria.Role
+ * ARIA state values for LivePriority.
+ * Copied from Closure's goog.a11y.aria.LivePriority
+ */
+export declare enum LiveRegionAssertiveness {
+    ASSERTIVE = "assertive",
+    OFF = "off",
+    POLITE = "polite"
+}
+/**
+ * Customization options that can be passed when using `announceDynamicAriaState`.
+ */
+export interface DynamicAnnouncementOptions {
+    /** The custom ARIA `Role` that should be used for the announcement container. */
+    role?: Role;
+    /**
+     * How assertive the announcement should be.
+     *
+     * Important*: It was found through testing that `ASSERTIVE` announcements are
+     * often outright ignored by some screen readers, so it's generally recommended
+     * to always use `POLITE` unless specifically tested across supported readers.
+     */
+    assertiveness?: LiveRegionAssertiveness;
+}
+/**
+ * A valid ARIA role for a Blockly DOM element. See also setRole() and getRole().
+ *
+ * This should be used instead of directly setting an element's role attribute.
  */
 export declare enum Role {
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/application_role. */
+    APPLICATION = "application",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/button_role. */
+    BUTTON = "button",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/checkbox_role. */
+    CHECKBOX = "checkbox",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/dialog_role. */
+    DIALOG = "dialog",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/figure_role. */
+    FIGURE = "figure",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/generic_role. */
+    GENERIC = "generic",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/grid_role. */
     GRID = "grid",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/gridcell_role. */
     GRIDCELL = "gridcell",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/group_role. */
     GROUP = "group",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/list_role. */
+    LIST = "list",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/listbox_role. */
     LISTBOX = "listbox",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/listitem_role. */
+    LISTITEM = "listitem",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/menu_role. */
     MENU = "menu",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/menuitem_role. */
     MENUITEM = "menuitem",
-    MENUITEMCHECKBOX = "menuitemcheckbox",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/none_role. */
+    NONE = "none",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/option_role. */
     OPTION = "option",
-    PRESENTATION = "presentation",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/region_role. */
+    REGION = "region",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/row_role. */
     ROW = "row",
-    TREE = "tree",
-    TREEITEM = "treeitem",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/search_role. */
+    SEARCH = "search",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/separator_role. */
     SEPARATOR = "separator",
-    STATUS = "status"
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/status_role. */
+    STATUS = "status",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/textbox_role. */
+    TEXTBOX = "textbox",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/tree_role. */
+    TREE = "tree",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/treeitem_role. */
+    TREEITEM = "treeitem"
 }
 /**
- * ARIA states and properties.
- * Copied from Closure's goog.a11y.aria.State
+ * A possible ARIA attribute state for a Blockly DOM element. See also setState() and getState().
+ *
+ * This should be used instead of directly setting aria-* attributes on elements.
  */
 export declare enum State {
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-activedescendant.
+     *
+     * Value: ID of a DOM element.
+     */
     ACTIVEDESCENDANT = "activedescendant",
-    COLCOUNT = "colcount",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-atomic.
+     *
+     * Value: one of {true, false}.
+     */
+    ATOMIC = "atomic",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-checked.
+     *
+     * Value: one of {true, false, mixed, undefined}.
+     */
+    CHECKED = "checked",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-controls.
+     *
+     * Value: an array of element IDs.
+     */
+    CONTROLS = "controls",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-disabled.
+     *
+     * Value: one of {true, false}.
+     */
     DISABLED = "disabled",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-expanded.
+     *
+     * Value: one of {true, false, undefined}.
+     */
     EXPANDED = "expanded",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-haspopup.
+     *
+     * Value: one of {true, false, menu, listbox, tree, grid, dialog}.
+     */
+    HASPOPUP = "haspopup",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-hidden.
+     *
+     * Value: one of {true, false,undefined}.
+     */
+    HIDDEN = "hidden",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-invalid.
+     *
+     * Value: one of {true, false, grammar, spelling}.
+     */
     INVALID = "invalid",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label.
+     *
+     * Value: a string.
+     */
     LABEL = "label",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-labelledby.
+     *
+     * Value: an array of element IDs.
+     */
     LABELLEDBY = "labelledby",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-level.
+     *
+     * Value: an integer.
+     */
     LEVEL = "level",
-    ORIENTATION = "orientation",
-    POSINSET = "posinset",
-    ROWCOUNT = "rowcount",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-live.
+     *
+     * Value: one of {polite, assertive, off}.
+     */
+    LIVE = "live",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-pressed.
+     *
+     * Value: one of {true, false, mixed, undefined}.
+     */
+    PRESSED = "pressed",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-roledescription.
+     *
+     * Value: a string.
+     */
+    ROLEDESCRIPTION = "roledescription",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-selected.
+     *
+     * Value:one of {true, false, undefined}.
+     */
     SELECTED = "selected",
-    SETSIZE = "setsize",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-valuemax.
+     *
+     * Value: a number representing the maximum allowed value for a range widget.
+     */
     VALUEMAX = "valuemax",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-valuemin.
+     *
+     * Value: a number representing the minimum allowed value for a range widget.
+     */
     VALUEMIN = "valuemin",
-    LIVE = "live",
-    HIDDEN = "hidden"
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-owns
+     *
+     * Value: a space-separated list of element IDs that are owned by the current element.
+     */
+    OWNS = "owns"
+}
+/**
+ * Used to control how verbose generated a11y labels are.
+ */
+export declare enum Verbosity {
+    TERSE = 0,
+    STANDARD = 1,
+    LOQUACIOUS = 2
 }
 /**
- * Sets the role of an element.
+ * Removes the ARIA role from an element.
  *
- * Similar to Closure's goog.a11y.aria
+ * Similar to Closure's goog.a11y.aria.removeRole
  *
- * @param element DOM node to set role of.
- * @param roleName Role name.
+ * @param element DOM element to remove the role from.
  */
-export declare function setRole(element: Element, roleName: Role): void;
+export declare function removeRole(element: Element): void;
 /**
- * Sets the state or property of an element.
- * Copied from Closure's goog.a11y.aria
+ * Updates the specific role for the specified element.
  *
- * @param element DOM node where we set state.
- * @param stateName State attribute being set.
- *     Automatically adds prefix 'aria-' to the state name if the attribute is
- * not an extra attribute.
- * @param value Value for the state attribute.
+ * @param element The element whose ARIA role should be changed.
+ * @param roleName The new role for the specified element, or null if its role
+ *     should be cleared.
+ */
+export declare function setRole(element: Element, roleName: Role | null): void;
+/**
+ * Returns the ARIA role of the specified element, or null if it either doesn't
+ * have a designated role or if that role is unknown.
+ *
+ * @param element The element from which to retrieve its ARIA role.
+ * @returns The ARIA role of the element, or null if undefined or unknown.
+ */
+export declare function getRole(element: Element): Role | null;
+/**
+ * Sets the specified ARIA state by its name and value for the specified
+ * element.
+ *
+ * Note that the type of value is not validated against the specific type of
+ * state being changed, so it's up to callers to ensure the correct value is
+ * used for the given state.
+ *
+ * @param element The element whose ARIA state may be changed.
+ * @param stateName The state to change.
+ * @param value The new value to specify for the provided state.
  */
 export declare function setState(element: Element, stateName: State, value: string | boolean | number | string[]): void;
+/**
+ * Clears the specified ARIA state by removing any related attributes from the
+ * specified element that have been set using setState().
+ *
+ * @param element The element whose ARIA state may be changed.
+ * @param stateName The state to clear from the provided element.
+ */
+export declare function clearState(element: Element, stateName: State): void;
+/**
+ * Returns a string representation of the specified state for the specified
+ * element, or null if it's not defined or specified.
+ *
+ * Note that an explicit set state of 'null' will return the 'null' string, not
+ * the value null.
+ *
+ * @param element The element whose state is being retrieved.
+ * @param stateName The state to retrieve.
+ * @returns The string representation of the requested state for the specified
+ *     element, or null if not defined.
+ */
+export declare function getState(element: Element, stateName: State): string | null;
+/**
+ * Creates an ARIA live region under the specified parent Element to be used
+ * for all dynamic announcements via `announceDynamicAriaState`. This must be
+ * called only once and before any dynamic announcements can be made.
+ *
+ * @param parent The container element to which the live region will be appended.
+ */
+export declare function initializeGlobalAriaLiveRegion(parent: HTMLElement): void;
+/**
+ * Requests that the specified text be read to the user if a screen reader is
+ * currently active.
+ *
+ * This relies on a centrally managed ARIA live region that is hidden from the
+ * visual DOM. This live region is designed to try and ensure the text is read,
+ * including if the same text is issued multiple times consecutively. Note that
+ * `initializeGlobalAriaLiveRegion` must be called before this can be used.
+ *
+ * Callers should use this judiciously. It's often considered bad practice to
+ * over-announce information that can be inferred from other sources on the page,
+ * so this ought to be used only when certain context cannot be easily determined
+ * (such as dynamic states that may not have perfect ARIA representations or
+ * indications).
+ *
+ * @param text The text to read to the user.
+ * @param options Custom options to configure the announcement. This defaults to
+ *    the status role and polite assertiveness.
+ */
+export declare function announceDynamicAriaState(text: string, options?: DynamicAnnouncementOptions): void;
 //# sourceMappingURL=aria.d.ts.map

package/core/utils/dom.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { Svg } from './svg.js';
+import { Svg } from './svg.js';
 /**
  * Required name space for SVG elements.
  */

package/core/utils/focusable_tree_traverser.d.ts

@@ -34,8 +34,8 @@ export declare class FocusableTreeTraverser {
      * the specified IFocusableTree.
      *
      * If the element exists within the specified tree's DOM structure but does
-     * not directly correspond to a node, the nearest parent node (or the tree's
-     * root) will be returned to represent the provided element.
+     * not directly correspond to a node and is not a tab stop, the nearest parent
+     * node (or the tree's root) will be returned to represent the provided element.
      *
      * If the tree contains another nested IFocusableTree, the nested tree may be
      * traversed but its nodes will never be returned here per the contract of

package/core/utils/shortcut_formatting.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2026 Raspberry Pi Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Find the primary shortcut for this platform and return it as single string
+ * in a short user facing format.
+ *
+ * @param shortcutName The keyboard shortcut name, e.g. "cut".
+ * @returns The formatted shortcut.
+ */
+export declare function getShortcutKeysShort(shortcutName: string): string;
+/**
+ * Find the relevant shortcuts for the given shortcut for the current platform.
+ * Keys are returned in a long user facing format, e.g. "Command ⌘ Option ⌥ C"
+ *
+ * @param shortcutName The keyboard shortcut name, e.g. "cut".
+ * @returns The formatted shortcuts as individual keys.
+ */
+export declare function getShortcutKeysLong(shortcutName: string): string[][];
+//# sourceMappingURL=shortcut_formatting.d.ts.map

package/core/utils/style.d.ts

@@ -53,6 +53,20 @@ export declare function getViewportPageOffset(): Coordinate;
  * @returns The computed border widths.
  */
 export declare function getBorderBox(element: Element): Rect;
+/**
+ * Converts a point in page coordinates into the equivalent CSS `left`/`top`
+ * for an absolutely positioned child of `container`.
+ *
+ * Those properties are resolved against the container's padding box, so the
+ * container's border widths have to be subtracted along with its position.
+ *
+ * @param x Horizontal page coordinate.
+ * @param y Vertical page coordinate.
+ * @param container The relatively positioned parent element.
+ * @returns The equivalent point relative to the container's padding box.
+ * @internal
+ */
+export declare function pageToContainerOffset(x: number, y: number, container: Element): Coordinate;
 /**
  * Changes the scroll position of `container` with the minimum amount so
  * that the content and the borders of the given `element` become visible.

package/core/utils/toolbox.d.ts

@@ -154,10 +154,6 @@ export declare function convertFlyoutDefToJsonArray(flyoutDef: FlyoutDefinition
  * @internal
  */
 export declare function hasCategories(toolboxJson: ToolboxInfo | null): boolean;
-/**
- * Private version of hasCategories for stubbing in tests.
- */
-declare function hasCategoriesInternal(toolboxJson: ToolboxInfo | null): boolean;
 /**
  * Whether or not the category is collapsible.
  *
@@ -173,8 +169,4 @@ export declare function isCategoryCollapsible(categoryInfo: CategoryInfo): boole
  * @returns DOM tree of blocks, or null.
  */
 export declare function parseToolboxTree(toolboxDef: Element | null | string): Element | null;
-export declare const TEST_ONLY: {
-    hasCategoriesInternal: typeof hasCategoriesInternal;
-};
-export {};
 //# sourceMappingURL=toolbox.d.ts.map

package/core/utils/useragent.d.ts

@@ -11,4 +11,5 @@ export declare const IPAD: boolean;
 export declare const IPHONE: boolean;
 export declare const MAC: boolean;
 export declare const MOBILE: boolean;
+export declare const APPLE: boolean;
 //# sourceMappingURL=useragent.d.ts.map