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

package/core/variable_map.d.ts

@@ -3,16 +3,8 @@
  * Copyright 2017 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Object representing a map of variables and their types.
- *
- * @class
- */
-import './events/events_var_delete.js';
-import './events/events_var_rename.js';
-import type { Block } from './block.js';
 import type { IVariableMap } from './interfaces/i_variable_map.js';
-import { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
+import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
 import type { Workspace } from './workspace.js';
 /**
  * Class for a variable map.  This contains a dictionary data structure with
@@ -45,15 +37,6 @@ export declare class VariableMap implements IVariableMap<IVariableModel<IVariabl
      */
     renameVariable(variable: IVariableModel<IVariableState>, newName: string): IVariableModel<IVariableState>;
     changeVariableType(variable: IVariableModel<IVariableState>, newType: string): IVariableModel<IVariableState>;
-    /**
-     * Rename a variable by updating its name in the variable map. Identify the
-     * variable to rename with the given ID.
-     *
-     * @deprecated v12: use VariableMap.renameVariable.
-     * @param id ID of the variable to rename.
-     * @param newName New variable name.
-     */
-    renameVariableById(id: string, newName: string): void;
     /**
      * Update the name of the given variable and refresh all references to it.
      * The new name must not conflict with any existing variable names.
@@ -99,14 +82,6 @@ export declare class VariableMap implements IVariableMap<IVariableModel<IVariabl
      * @param variable Variable to delete.
      */
     deleteVariable(variable: IVariableModel<IVariableState>): void;
-    /**
-     * Delete a variables by the passed in ID and all of its uses from this
-     * workspace. May prompt the user for confirmation.
-     *
-     * @deprecated v12: use Blockly.Variables.deleteVariable.
-     * @param id ID of variable to delete.
-     */
-    deleteVariableById(id: string): void;
     /**
      * Find the variable by the given name and type and return it.  Return null if
      *     it is not found.
@@ -145,20 +120,5 @@ export declare class VariableMap implements IVariableMap<IVariableModel<IVariabl
      * @returns List of variable models.
      */
     getAllVariables(): IVariableModel<IVariableState>[];
-    /**
-     * Returns all of the variable names of all types.
-     *
-     * @deprecated v12: use Blockly.Variables.getAllVariables.
-     * @returns All of the variable names of all types.
-     */
-    getAllVariableNames(): string[];
-    /**
-     * Find all the uses of a named variable.
-     *
-     * @deprecated v12: use Blockly.Variables.getVariableUsesById.
-     * @param id ID of the variable to find.
-     * @returns Array of block usages.
-     */
-    getVariableUsesById(id: string): Block[];
 }
 //# sourceMappingURL=variable_map.d.ts.map

package/core/variable_model.d.ts

@@ -3,13 +3,7 @@
  * Copyright 2017 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Components for the variable model.
- *
- * @class
- */
-import './events/events_var_create.js';
-import { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
+import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
 import type { Workspace } from './workspace.js';
 /**
  * Class for a variable model.

package/core/variables.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Block } from './block.js';
-import { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
+import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
 import type { BlockInfo, FlyoutItemInfo } from './utils/toolbox.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
@@ -41,14 +41,13 @@ export declare function allUsedVarModels(ws: Workspace): IVariableModel<IVariabl
  */
 export declare function allDeveloperVariables(workspace: Workspace): string[];
 /**
- * Internal wrapper that returns the contents of the variables category.
+ * Construct the elements (blocks and button) required by the flyout for the
+ * variable category.
  *
- * @internal
- * @param workspace The workspace to populate variable blocks for.
+ * @param workspace The workspace containing variables.
+ * @returns List of flyout contents as JSON.
  */
-export declare function internalFlyoutCategory(workspace: WorkspaceSvg): FlyoutItemInfo[];
-export declare function flyoutCategory(workspace: WorkspaceSvg, useXml: true): Element[];
-export declare function flyoutCategory(workspace: WorkspaceSvg, useXml: false): FlyoutItemInfo[];
+export declare function flyoutCategory(workspace: WorkspaceSvg): FlyoutItemInfo[];
 /**
  * Construct the blocks required by the flyout for the variable category.
  *
@@ -109,7 +108,7 @@ export declare function generateUniqueNameFromOptions(startChar: string, usedNam
  * @param opt_type The type of the variable like 'int', 'string', or ''. This
  *     will default to '', which is a specific type.
  */
-export declare function createVariableButtonHandler(workspace: Workspace, opt_callback?: (p1?: string | null) => void, opt_type?: string): void;
+export declare function createVariableButtonHandler(workspace: WorkspaceSvg, opt_callback?: (p1?: string | null) => void, opt_type?: string): void;
 /**
  * Opens a prompt that allows the user to enter a new name for a variable.
  * Triggers a rename if the new name is valid. Or re-prompts if there is a

package/core/variables_dynamic.d.ts

@@ -37,14 +37,12 @@ export declare const onCreateVariableButtonClick_Number: typeof numberButtonClic
 declare function colourButtonClickHandler(button: FlyoutButton): void;
 export declare const onCreateVariableButtonClick_Colour: typeof colourButtonClickHandler;
 /**
- * Internal wrapper that returns the contents of the dynamic variables category.
+ * Construct the elements (blocks and button) required by the flyout for the
+ * dynamic variables category.
  *
- * @internal
- * @param workspace The workspace to populate variable blocks for.
+ * @returns List of flyout contents as JSON.
  */
-export declare function internalFlyoutCategory(workspace: WorkspaceSvg): FlyoutItemInfo[];
-export declare function flyoutCategory(workspace: WorkspaceSvg, useXml: true): Element[];
-export declare function flyoutCategory(workspace: WorkspaceSvg, useXml: false): FlyoutItemInfo[];
+export declare function flyoutCategory(workspace: WorkspaceSvg): FlyoutItemInfo[];
 /**
  * Construct the blocks required by the flyout for the variable category.
  *

package/core/workspace.d.ts

@@ -8,14 +8,13 @@
  *
  * @class
  */
-import './connection_checker.js';
 import type { Block } from './block.js';
-import { WorkspaceComment } from './comments/workspace_comment.js';
+import type { WorkspaceComment } from './comments/workspace_comment.js';
 import type { ConnectionDB } from './connection_db.js';
 import type { Abstract } from './events/events_abstract.js';
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
 import type { IConnectionChecker } from './interfaces/i_connection_checker.js';
-import { IProcedureMap } from './interfaces/i_procedure_map.js';
+import type { IProcedureMap } from './interfaces/i_procedure_map.js';
 import type { IVariableMap } from './interfaces/i_variable_map.js';
 import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
 import { Options } from './options.js';
@@ -192,87 +191,6 @@ export declare class Workspace {
     getAllBlocks(ordered?: boolean): Block[];
     /** Dispose of all blocks and comments in workspace. */
     clear(): void;
-    /**
-     * Rename a variable by updating its name in the variable
-     * map. Identify the variable to rename with the given ID.
-     *
-     * @deprecated v12: use Blockly.Workspace.getVariableMap().renameVariable
-     * @param id ID of the variable to rename.
-     * @param newName New variable name.
-     */
-    renameVariableById(id: string, newName: string): void;
-    /**
-     * Create a variable with a given name, optional type, and optional ID.
-     *
-     * @deprecated v12: use Blockly.Workspace.getVariableMap().createVariable.
-     * @param name The name of the variable. This must be unique across variables
-     *     and procedures.
-     * @param opt_type The type of the variable like 'int' or 'string'.
-     *     Does not need to be unique. Field_variable can filter variables based
-     * on their type. This will default to '' which is a specific type.
-     * @param opt_id The unique ID of the variable. This will default to a UUID.
-     * @returns The newly created variable.
-     */
-    createVariable(name: string, opt_type?: string | null, opt_id?: string | null): IVariableModel<IVariableState>;
-    /**
-     * Find all the uses of the given variable, which is identified by ID.
-     *
-     * @deprecated v12: use Blockly.Workspace.getVariableMap().getVariableUsesById
-     * @param id ID of the variable to find.
-     * @returns Array of block usages.
-     */
-    getVariableUsesById(id: string): Block[];
-    /**
-     * Delete a variables by the passed in ID and all of its uses from this
-     * workspace. May prompt the user for confirmation.
-     *
-     * @deprecated v12: use Blockly.Workspace.getVariableMap().deleteVariable.
-     * @param id ID of variable to delete.
-     */
-    deleteVariableById(id: string): void;
-    /**
-     * Find the variable by the given name and return it. Return null if not
-     * found.
-     *
-     * @deprecated v12: use Blockly.Workspace.getVariableMap().getVariable.
-     * @param name The name to check for.
-     * @param opt_type The type of the variable.  If not provided it defaults to
-     *     the empty string, which is a specific type.
-     * @returns The variable with the given name.
-     */
-    getVariable(name: string, opt_type?: string): IVariableModel<IVariableState> | null;
-    /**
-     * Find the variable by the given ID and return it. Return null if not found.
-     *
-     * @deprecated v12: use Blockly.Workspace.getVariableMap().getVariableById.
-     * @param id The ID to check for.
-     * @returns The variable with the given ID.
-     */
-    getVariableById(id: string): IVariableModel<IVariableState> | null;
-    /**
-     * Find the variable with the specified type. If type is null, return list of
-     *     variables with empty string type.
-     *
-     * @deprecated v12: use Blockly.Workspace.getVariableMap().getVariablesOfType.
-     * @param type Type of the variables to find.
-     * @returns The sought after variables of the passed in type. An empty array
-     *     if none are found.
-     */
-    getVariablesOfType(type: string | null): IVariableModel<IVariableState>[];
-    /**
-     * Return all variables of all types.
-     *
-     * @deprecated v12: use Blockly.Workspace.getVariableMap().getAllVariables.
-     * @returns List of variable models.
-     */
-    getAllVariables(): IVariableModel<IVariableState>[];
-    /**
-     * Returns all variable names of all types.
-     *
-     * @deprecated v12: use Blockly.Workspace.getVariableMap().getAllVariables.
-     * @returns List of all variable names of all types.
-     */
-    getAllVariableNames(): string[];
     /**
      * Returns the horizontal offset of the workspace.
      * Intended for LTR/RTL compatibility in XML.
@@ -353,7 +271,11 @@ export declare class Workspace {
      *
      * @param redo False if undo, true if redo.
      */
-    undo(redo: boolean): void;
+    undo(redo?: boolean): void;
+    /**
+     * Redoes the previous action.
+     */
+    redo(): void;
     /** Clear the undo/redo stacks. */
     clearUndo(): void;
     /**

package/core/workspace_audio.d.ts

@@ -3,12 +3,7 @@
  * Copyright 2017 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Object in charge of loading, storing, and playing audio for a
- *     workspace.
- *
- * @class
- */
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for loading, storing, and playing audio for a workspace.
@@ -25,7 +20,7 @@ export declare class WorkspaceAudio {
     private readonly context?;
     /**
      * @param parentWorkspace The parent of the workspace this audio object
-     *     belongs to, or null.
+     *     belongs to if it has one, or the workspace that owns this instance.
      */
     constructor(parentWorkspace: WorkspaceSvg);
     /**
@@ -50,6 +45,40 @@ export declare class WorkspaceAudio {
      * @param opt_volume Volume of sound (0-1).
      */
     play(name: string, opt_volume?: number): Promise<void>;
+    /**
+     * Plays a beep at the given frequency.
+     *
+     * @param tone The frequency of the beep to play, in hertz.
+     * @param duration The duration of the beep, in seconds. Defaults to 0.2.
+     */
+    beep(tone: number, duration?: number): Promise<void>;
+    /**
+     * Plays a standard error beep.
+     */
+    playErrorBeep(): Promise<void>;
+    /**
+     * If enabled, plays a tone corresponding to the nesting level of the given
+     * node when it differs from the nesting level of the currently focused node.
+     * These tones are generally used for accessibility purposes to indicate a
+     * scope transition to users who use a screenreader. This method must be
+     * called before focus transitions to the given node.
+     *
+     * @internal
+     * @param newNode The soon-to-be-focused node.
+     */
+    maybePlayScopeChangeAudioCue(newNode: IFocusableNode): void;
+    /**
+     * Returns whether or not playing sounds is currently allowed.
+     *
+     * @returns False if audio is muted or a sound has just been played, otherwise
+     *     true.
+     */
+    private isPlayingAllowed;
+    /**
+     * Prepares to play audio by recording the time of the last play and resuming
+     * the audio context.
+     */
+    private prepareToPlay;
     /**
      * @param muted If true, mute sounds. Otherwise, play them.
      */

package/core/workspace_focus_target.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2026 Raspberry Pi Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IContextMenu } from './interfaces/i_contextmenu.js';
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
+import type { IFocusableTree } from './interfaces/i_focusable_tree.js';
+import type { WorkspaceSvg } from './workspace_svg.js';
+/**
+ * A focusable element representing the workspace as a whole.
+ *
+ * Focus on the workspace itself (i.e. not on any block, comment, or other
+ * content) lands here rather than on the workspace's region element. VoiceOver
+ * does not announce a region when focus moves into it from a node already
+ * inside that region, so focusing the region directly (e.g. after pressing "W"
+ * from a block) would be silent. This is an ordinary focusable node, so moving
+ * to it is announced. It carries the stack count and a "workspace" role
+ * description; the enclosing region keeps a short, stable label
+ * ("Blocks workspace.").
+ */
+export declare class WorkspaceFocusTarget implements IFocusableNode, IContextMenu {
+    private readonly workspace;
+    private readonly element;
+    /**
+     * @param workspace The workspace this focus target represents.
+     * @param element The SVG element that receives focus for the workspace.
+     */
+    constructor(workspace: WorkspaceSvg, element: SVGElement);
+    /** See IFocusableNode.getFocusableElement. */
+    getFocusableElement(): SVGElement;
+    /** See IFocusableNode.getFocusableTree. */
+    getFocusableTree(): IFocusableTree;
+    /** See IFocusableNode.onNodeFocus. */
+    onNodeFocus(): void;
+    /** See IFocusableNode.onNodeBlur. */
+    onNodeBlur(): void;
+    /** See IFocusableNode.canBeFocused. */
+    canBeFocused(): boolean;
+    /**
+     * Returns the workspace this focus target represents.
+     *
+     * @returns The workspace this focus target represents.
+     */
+    getWorkspace(): WorkspaceSvg;
+    /**
+     * Displays the workspace's context menu.
+     */
+    showContextMenu(e: Event): void;
+}
+//# sourceMappingURL=workspace_focus_target.d.ts.map

package/core/workspace_svg.d.ts

@@ -8,32 +8,26 @@
  *
  * @class
  */
-import './events/events_block_create.js';
-import './events/events_theme_change.js';
-import './events/events_viewport.js';
 import type { Block } from './block.js';
 import type { BlockSvg } from './block_svg.js';
 import * as browserEvents from './browser_events.js';
 import { RenderedWorkspaceComment } from './comments/rendered_workspace_comment.js';
-import { WorkspaceComment } from './comments/workspace_comment.js';
+import type { WorkspaceComment } from './comments/workspace_comment.js';
 import { ComponentManager } from './component_manager.js';
-import { ContextMenuOption } from './contextmenu_registry.js';
+import type { ContextMenuOption } from './contextmenu_registry.js';
 import type { FlyoutButton } from './flyout_button.js';
 import { Gesture } from './gesture.js';
 import { Grid } from './grid.js';
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
-import { IContextMenu } from './interfaces/i_contextmenu.js';
+import type { IContextMenu } from './interfaces/i_contextmenu.js';
 import type { IDragTarget } from './interfaces/i_drag_target.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
 import { type IFocusableNode } from './interfaces/i_focusable_node.js';
 import type { IFocusableTree } from './interfaces/i_focusable_tree.js';
 import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
 import type { IToolbox } from './interfaces/i_toolbox.js';
-import type { LineCursor } from './keyboard_nav/line_cursor.js';
-import type { Marker } from './keyboard_nav/marker.js';
+import { Navigator } from './keyboard_nav/navigators/navigator.js';
 import { LayerManager } from './layer_manager.js';
-import { MarkerManager } from './marker_manager.js';
-import { Navigator } from './navigator.js';
 import { Options } from './options.js';
 import type { Renderer } from './renderers/common/renderer.js';
 import type { ScrollbarPair } from './scrollbar_pair.js';
@@ -48,6 +42,7 @@ import { Svg } from './utils/svg.js';
 import * as toolbox from './utils/toolbox.js';
 import { Workspace } from './workspace.js';
 import { WorkspaceAudio } from './workspace_audio.js';
+import { WorkspaceFocusTarget } from './workspace_focus_target.js';
 import { ZoomControls } from './zoom_controls.js';
 /**
  * Class for a workspace.  This is an onscreen area with optional trashcan,
@@ -220,7 +215,6 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
     private readonly highlightedBlocks;
     private audioManager;
     private grid;
-    private markerManager;
     /**
      * Map from function names to callbacks, for deciding what to do when a
      * custom toolbox category is opened.
@@ -235,10 +229,6 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
     private readonly renderer;
     /** Cached parent SVG. */
     private cachedParentSvg;
-    /** True if keyboard accessibility mode is on, false otherwise. */
-    keyboardAccessibilityMode: boolean;
-    /** True iff a keyboard-initiated move ("drag") is in progress. */
-    keyboardMoveInProgress: boolean;
     /** The list of top-level bounded elements on the workspace. */
     private topBoundedElements;
     /** The recorded drag targets. */
@@ -250,21 +240,40 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
     svgBlockCanvas_: SVGElement;
     svgBubbleCanvas_: SVGElement;
     zoomControls_: ZoomControls | null;
+    /**
+     * Focus ring in the workspace.
+     */
+    private workspaceFocusRing;
+    /**
+     * Selection ring inside the workspace.
+     */
+    private workspaceSelectionRing;
+    /**
+     * Element that receives focus when the workspace itself (rather than any of
+     * its contents) is focused. See {@link WorkspaceFocusTarget}. This is the
+     * selection ring (which already represents the workspace being the active
+     * node); it's set only for main (non-flyout, non-mutator) workspaces.
+     */
+    private workspaceFocusTargetElement;
+    /**
+     * Focusable node wrapping {@link workspaceFocusTargetElement}, or null if this
+     * workspace has no focus target.
+     */
+    private workspaceFocusTarget;
     /**
      * Navigator that handles moving focus between items in this workspace in
      * response to keyboard navigation commands.
      */
     private navigator;
     /**
-     * @param options Dictionary of options.
+     * Whether this workspace has ever been focused. Used to announce usage hints
+     * to screenreaders on initial focus only.
      */
-    constructor(options: Options);
+    private static everFocused;
     /**
-     * Get the marker manager for this workspace.
-     *
-     * @returns The marker manager.
+     * @param options Dictionary of options.
      */
-    getMarkerManager(): MarkerManager;
+    constructor(options: Options);
     /**
      * Gets the metrics manager for this workspace.
      *
@@ -284,21 +293,6 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
      * @returns The component manager.
      */
     getComponentManager(): ComponentManager;
-    /**
-     * Get the marker with the given ID.
-     *
-     * @param id The ID of the marker.
-     * @returns The marker with the given ID or null if no marker with the given
-     *     ID exists.
-     * @internal
-     */
-    getMarker(id: string): Marker | null;
-    /**
-     * The cursor for this workspace.
-     *
-     * @returns The cursor for the workspace.
-     */
-    getCursor(): LineCursor;
     /**
      * Get the block renderer attached to this workspace.
      *
@@ -406,6 +400,15 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
      * @param handler Data that can be passed to eventHandling.unbind.
      */
     setResizeHandlerWrapper(handler: browserEvents.Data): void;
+    /**
+     * Sets Aria labels, roles, etc. for the workspace depending on the type of workspace it is.
+     */
+    setInitialAriaContext(): void;
+    /**
+     * Updates the focus target's label to reflect the number of top-level stacks in the
+     * workspace. No-op for workspaces without a focus target (flyouts and mutators).
+     */
+    private updateAriaLabel;
     /**
      * Create the workspace DOM elements.
      *
@@ -487,6 +490,14 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
      * trash, zoom, toolbox, etc. (e.g. window resize).
      */
     resize(): void;
+    /**
+     * Sizes the given focus/selection ring inside the bounds of the workspace.
+     *
+     * @param ring The interior workspace ring indicator to resize.
+     * @param inset How many pixels in from the bounds of the workspace the ring
+     *     should be positioned.
+     */
+    private resizeWorkspaceRing;
     /**
      * Resizes and repositions workspace chrome if the page has a new
      * scroll position.
@@ -606,13 +617,12 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
      */
     newComment(id?: string): WorkspaceComment;
     /**
-     * Returns the drag target the pointer event is over.
+     * Returns the drag target at the given point.
      *
-     * @param e Pointer move event.
-     * @returns Null if not over a drag target, or the drag target the event is
-     *     over.
+     * @param point A pointer event, or a point in client/viewport coordinates.
+     * @returns Null if not over a drag target, or the drag target at that point.
      */
-    getDragTarget(e: PointerEvent): IDragTarget | null;
+    getDragTarget(point: PointerEvent | Coordinate): IDragTarget | null;
     /**
      * Handle a pointerdown on SVG drawing surface.
      *
@@ -633,24 +643,6 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
      * @returns New location of object.
      */
     moveDrag(e: PointerEvent): Coordinate;
-    /**
-     * Indicate whether a keyboard move is in progress or not.
-     *
-     * Should be called with true when a keyboard move of an IDraggable
-     * is starts, and false when it finishes or is aborted.
-     *
-     * N.B.: This method is experimental and internal-only.  It is
-     * intended only to called only from the keyboard navigation plugin.
-     * Its signature and behaviour may be modified, or the method
-     * removed, at an time without notice and without being treated
-     * as a breaking change.
-     *
-     * TODO(#8960): Delete this.
-     *
-     * @internal
-     * @param inProgress Is a keyboard-initated move in progress?
-     */
-    setKeyboardMoveInProgress(inProgress: boolean): void;
     /**
      * Returns true iff the user is currently engaged in a drag gesture,
      * or if a keyboard-initated move is in progress.
@@ -809,8 +801,9 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
      *
      * @param x Target X to scroll to.
      * @param y Target Y to scroll to.
+     * @param shouldHidePopups Whether to hide popups. Defaults to true.
      */
-    scroll(x: number, y: number): void;
+    scroll(x: number, y: number, shouldHidePopups?: boolean): void;
     /**
      * Find the block on this workspace with the specified ID.
      *
@@ -1054,6 +1047,17 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
     getFocusableTree(): IFocusableTree;
     /** See IFocusableNode.onNodeFocus. */
     onNodeFocus(): void;
+    /**
+     * Handles the workspace's focus target receiving focus, which represents focus
+     * landing on the workspace as a whole.
+     *
+     * @internal
+     */
+    handleWorkspaceFocusTargetFocus(): void;
+    /**
+     * Announces the screen reader hint the first time any workspace is focused.
+     */
+    private maybeAnnounceScreenreaderHint;
     /** See IFocusableNode.onNodeBlur. */
     onNodeBlur(): void;
     /** See IFocusableNode.canBeFocused. */
@@ -1062,6 +1066,16 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
     getRootFocusableNode(): IFocusableNode;
     /** See IFocusableTree.getRestoredFocusableNode. */
     getRestoredFocusableNode(previousNode: IFocusableNode | null): IFocusableNode | null;
+    /**
+     * Returns the focusable node representing this workspace as a whole, or null
+     * for workspaces without one (flyouts and mutators).
+     *
+     * Focus lands here when the workspace itself is focused (e.g. via the focus
+     * workspace shortcut) rather than on any of its contents.
+     *
+     * @returns This workspace's focus target node, if any.
+     */
+    getWorkspaceFocusTarget(): WorkspaceFocusTarget | null;
     /** See IFocusableTree.getNestedTrees. */
     getNestedTrees(): Array<IFocusableTree>;
     /**
@@ -1077,6 +1091,11 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
     onTreeFocus(_node: IFocusableNode, _previousTree: IFocusableTree | null): void;
     /** See IFocusableTree.onTreeBlur. */
     onTreeBlur(nextTree: IFocusableTree | null): void;
+    /**
+     * Handles the user acting on this workspace via keyboard navigation by
+     * prompting them to use the arrow keys (instead of Enter) to navigate.
+     */
+    performAction(): void;
     /**
      * Returns an object responsible for coordinating movement of focus between
      * items on this workspace in response to keyboard navigation commands.

package/core/xml.d.ts

@@ -7,7 +7,7 @@ import type { Block } from './block.js';
 import { WorkspaceComment } from './comments/workspace_comment.js';
 import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
 import type { Workspace } from './workspace.js';
-import { WorkspaceSvg } from './workspace_svg.js';
+import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Encode a block tree as XML.
  *