blockly 13.0.0-beta.3 → 13.0.0-beta.5

package/core/block.d.ts

@@ -457,7 +457,25 @@ export declare class Block {
      */
     isDisposed(): boolean;
     /**
-     * @returns True if this block is a value block with a single editable field.
+     * Determines and returns the full-block field for this block, or null if there isn't one
+     * and this block can't be considered a singleton field block.
+     *
+     * Note that this method is unreliable if a block contains a single field that
+     * hasn't been initialized/rendered yet.
+     *
+     * @returns The full-block field this block contains, or null if it doesn't contain one.
+     * @internal
+     */
+    getFullBlockField(): Field<any> | null;
+    /**
+     * A block is a simple reporter if it has an output connection and exactly one field.
+     * In some renderers, simple reporters are rendered differently from other blocks.
+     * Being a simple reporter block is a prerequisite to the single field rendering itself
+     * as a "full-block field", but it is not sufficient, as not all fields or renderers use
+     * this special rendering. Use `getFullBlockField` to determine if the block is rendered
+     * as a "full-block field block".
+     *
+     * @returns True if this block is a value block with a single field.
      * @internal
      */
     isSimpleReporter(): boolean;

package/core/block_aria_composer.d.ts

@@ -16,7 +16,8 @@ export declare enum ConnectionPreposition {
     BEFORE = 1,
     AFTER = 2,
     AROUND = 3,
-    INSIDE = 4
+    INSIDE = 4,
+    TO = 5
 }
 /**
  * Returns an ARIA representation of the specified block.
@@ -41,9 +42,12 @@ export declare enum ConnectionPreposition {
  * @internal
  * @param block The block for which an ARIA representation should be created.
  * @param verbosity How much detail to include in the description.
+ * @param useCustomInputLabels Whether to use custom labels for inputs, if they
+ *   exist. We don't want to do this when just reading a block's label, but do
+ *   want to in other scenarios such as move mode.
  * @returns The ARIA representation for the specified block.
  */
-export declare function computeAriaLabel(block: BlockSvg, verbosity?: Verbosity): string;
+export declare function computeAriaLabel(block: BlockSvg, verbosity?: Verbosity, useCustomInputLabels?: boolean): string;
 /**
  * Sets the ARIA role and role description for the specified block, accounting
  * for whether the block is part of a flyout.
@@ -62,6 +66,14 @@ export declare function configureAriaRole(block: BlockSvg): void;
  * `lookback` attribute is specified, all of the fields on the row immediately
  * above the Input will be used instead.
  *
+ * If the input contains multiple adjacent FieldLabel fields, they will be
+ * combined together into a singular label string so that screenreaders can
+ * know to read them together as one piece of text.
+ *
+ * Empty field labels are excluded because they don't provide useful context.
+ * Fields should generally have a helpful label, but there are exceptions, such
+ * as when empty label fields are used to control the layout of a block.
+ *
  * @internal
  * @param input The Input to compute a description/context label for.
  * @param lookback If true, will use labels for fields on the previous row if
@@ -78,11 +90,18 @@ export declare function computeFieldRowLabel(input: Input, lookback: boolean, ve
  * their contents are returned as a single item in the array per top-level
  * input.
  *
+ * Generally, if a custom label for an input is provided, that is preferred.
+ * However, we do not surface the custom labels when simply reading the text of
+ * the block. They are used as supplementary information for situations like
+ * move mode or when an input itself is focused.
+ *
  * @internal
  * @param block The block to retrieve a list of field/input labels for.
+ * @param verbosity
+ * @param useCustomLabels whether to use the custom label for an input, if it's present.
  * @returns A list of field/input labels for the given block.
  */
-export declare function getInputLabels(block: BlockSvg, verbosity?: Verbosity): string[];
+export declare function getInputLabels(block: BlockSvg, verbosity?: Verbosity, useCustomLabels?: boolean): string[];
 /**
  * Returns a subset of labels for inputs on the given block, ending at the
  * specified input.
@@ -99,7 +118,7 @@ export declare function getInputLabels(block: BlockSvg, verbosity?: Verbosity):
  * @param input The input that defines the end of the subset.
  * @returns A list of field/input labels for the given block.
  */
-export declare function getInputLabelsSubset(block: BlockSvg, input: Input, verbosity?: Verbosity): string[];
+export declare function getInputLabelsSubset(block: BlockSvg, input: Input): string[];
 /**
  * Returns a translated string describing an in-progress move of a block to a new
  * connection, suitable for announcement on the ARIA live region. The returned string

package/core/block_svg.d.ts

@@ -719,6 +719,12 @@ export declare class BlockSvg extends Block implements IBoundedElement, IContext
      */
     toFlyoutInfo(): FlyoutItemInfo[];
     jsonInit(json: any): void;
+    /**
+     * Returns the number of blocks that this block is nested inside of.
+     *
+     * @internal
+     */
+    getNestingLevel(): number;
     /** See IFocusableNode.getFocusableElement. */
     getFocusableElement(): HTMLElement | SVGElement;
     /** See IFocusableNode.getFocusableTree. */
@@ -752,7 +758,10 @@ export declare class BlockSvg extends Block implements IBoundedElement, IContext
      */
     getOutputParents(): Set<BlockSvg>;
     /**
-     * Returns an ID for the visual "row" this block is part of.
+     * Returns an ID for the logical "row" this block is part of. A "row" is
+     * bounded by a previous/next connection, a statement input, or a block stack
+     * boundary; all blocks/inputs nested inside of one of those are conceptually
+     * part of its same row.
      *
      * @internal
      */
@@ -760,7 +769,7 @@ export declare class BlockSvg extends Block implements IBoundedElement, IContext
     /**
      * Updates the ARIA label, role and roledescription for this block.
      */
-    private recomputeAriaAttributes;
+    private recomputeAriaContext;
     /**
      * Returns a description of this block suitable for screenreaders or use in
      * ARIA attributes.

package/core/comments/collapse_comment_bar_button.d.ts

@@ -48,5 +48,12 @@ export declare class CollapseCommentBarButton extends CommentBarButton {
      * @param e The event that triggered this action.
      */
     performAction(e?: Event): void;
+    /**
+     * Returns the ARIA label to use for this button (defaults to null). Note that this
+     * method will only be called and apply when recomputeAriaContext is called.
+     *
+     * @returns The ARIA label to use for this button, or null to use a default.
+     */
+    protected getAriaLabel(): string;
 }
 //# sourceMappingURL=collapse_comment_bar_button.d.ts.map

package/core/comments/comment_bar_button.d.ts

@@ -58,5 +58,19 @@ export declare abstract class CommentBarButton implements IFocusableNode {
     onNodeBlur(): void;
     /** Returns whether this button can be focused. True if it is visible. */
     canBeFocused(): boolean;
+    /**
+     * Recomputes the ARIA label and role for this button. Note that this is not
+     * automatically called during initialization and must be called once a button's
+     * focusable element (icon) is initialized. Implementations may also find it useful
+     * to call this if the button's label should be changed.
+     */
+    protected recomputeAriaContext(): void;
+    /**
+     * Returns the ARIA label to use for this button (defaults to null). Note that this
+     * method will only be called and apply when recomputeAriaContext is called.
+     *
+     * @returns The ARIA label to use for this button, or null to use a default.
+     */
+    protected getAriaLabel(): string | null;
 }
 //# sourceMappingURL=comment_bar_button.d.ts.map

package/core/comments/comment_editor.d.ts

@@ -3,10 +3,12 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { BlockSvg } from '../block_svg.js';
 import { IFocusableNode } from '../interfaces/i_focusable_node.js';
 import { IFocusableTree } from '../interfaces/i_focusable_tree.js';
 import { Size } from '../utils/size.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
+import { RenderedWorkspaceComment } from './rendered_workspace_comment.js';
 /**
  * String added to the ID of a workspace comment to identify
  * the focusable node for the comment editor.
@@ -25,6 +27,8 @@ export declare class CommentEditor implements IFocusableNode {
     private textChangeListeners;
     /** The current text of the comment. Updates on text area change. */
     private text;
+    /** The parent object that owns this comment editor. */
+    private parent?;
     constructor(workspace: WorkspaceSvg, commentId: string, onFinishEditing?: (() => void) | undefined);
     /** Gets the dom structure for this comment editor. */
     getDom(): SVGForeignObjectElement;
@@ -32,6 +36,17 @@ export declare class CommentEditor implements IFocusableNode {
     getText(): string;
     /** Sets the current text of the comment and fires change listeners. */
     setText(text: string): void;
+    /**
+     * Sets the parent object that owns this comment editor.
+     *
+     * @param newParent The parent of this comment editor.
+     * @internal
+     */
+    setParent(newParent: BlockSvg | RenderedWorkspaceComment): void;
+    /**
+     * Returns the parent object that owns this comment editor, if any.
+     */
+    getParent(): BlockSvg | RenderedWorkspaceComment | undefined;
     /**
      * Triggers listeners when the text of the comment changes, either
      * programmatically or manually by the user.

package/core/comments/comment_view.d.ts

@@ -3,12 +3,12 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { IFocusableNode } from '../interfaces/i_focusable_node';
 import { IRenderedElement } from '../interfaces/i_rendered_element.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Size } from '../utils/size.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
 import { CommentBarButton } from './comment_bar_button.js';
+import { CommentEditor } from './comment_editor.js';
 export declare class CommentView implements IRenderedElement {
     readonly workspace: WorkspaceSvg;
     readonly commentId: string;
@@ -84,7 +84,7 @@ export declare class CommentView implements IRenderedElement {
      *
      * @returns The FocusableNode representing the editor portion of this comment.
      */
-    getEditorFocusableNode(): IFocusableNode;
+    getEditorFocusableNode(): CommentEditor;
     /** Creates the DOM elements for the comment resize handle. */
     private createResizeHandle;
     /** Returns the root SVG group element of the comment view. */

package/core/comments/delete_comment_bar_button.d.ts

@@ -48,5 +48,12 @@ export declare class DeleteCommentBarButton extends CommentBarButton {
      * @param e The event that triggered this action.
      */
     performAction(e?: Event): void;
+    /**
+     * Returns the ARIA label to use for this button (defaults to null). Note that this
+     * method will only be called and apply when recomputeAriaContext is called.
+     *
+     * @returns The ARIA label to use for this button, or null to use a default.
+     */
+    protected getAriaLabel(): string;
 }
 //# sourceMappingURL=delete_comment_bar_button.d.ts.map

package/core/contextmenu_registry.d.ts

@@ -103,6 +103,13 @@ export declare namespace ContextMenuRegistry {
         displayText: ((p1: Scope) => string | HTMLElement) | string | HTMLElement;
         separator?: never;
         preconditionFn: (p1: Scope, menuOpenEvent: Event) => string;
+        /**
+         * Identifier used to associate this context menu item with a keyboard
+         * shortcut  which will be displayed in the menu as a hint. Should
+         * correspond to the name under which a keyboard shortcut that performs the
+         * same action as this menu item is registered.
+         */
+        associatedKeyboardShortcut?: string;
     }
     /**
      * A representation of a menu separator item in the registry.
@@ -120,8 +127,10 @@ export declare namespace ContextMenuRegistry {
      * Fields common to all context menu items as used by contextmenu.ts.
      */
     export interface CoreContextMenuOption {
+        id: string;
         scope: Scope;
         weight: number;
+        associatedKeyboardShortcut?: string;
     }
     /**
      * A representation of a normal, clickable menu item in contextmenu.ts.
@@ -170,4 +179,5 @@ export type Scope = ContextMenuRegistry.Scope;
 export type RegistryItem = ContextMenuRegistry.RegistryItem;
 export type ContextMenuOption = ContextMenuRegistry.ContextMenuOption;
 export type LegacyContextMenuOption = ContextMenuRegistry.LegacyContextMenuOption;
+export type ActionContextMenuOption = ContextMenuRegistry.ActionContextMenuOption;
 //# sourceMappingURL=contextmenu_registry.d.ts.map

package/core/dragging/block_drag_strategy.d.ts

@@ -75,7 +75,7 @@ export declare class BlockDragStrategy implements IDragStrategy {
      * Handles any setup for starting the drag, including disconnecting the block
      * from any parent blocks.
      */
-    startDrag(e?: PointerEvent | KeyboardEvent): import("../interfaces/i_draggable.js").IDraggable;
+    startDrag(e?: PointerEvent | KeyboardEvent): import("../blockly.js").IDraggable;
     /**
      * Handles any setup for starting the drag, including disconnecting the block
      * from any parent blocks.
@@ -237,6 +237,14 @@ export declare class BlockDragStrategy implements IDragStrategy {
      * @returns All connections on the block and its children.
      */
     private getAllConnections;
+    /**
+     * Returns a connection candidate to move the dragged block to at the start of
+     * a drag. If the passively focused node is a connection and the dragged block
+     * can connect to it, the connection will be returned. Otherwise, the first
+     * compatible connection on the passively focused node's block, if any, will
+     * be returned. Returns null if the workspace does not have passive focus.
+     */
+    private getInitialCandidate;
 }
 export {};
 //# sourceMappingURL=block_drag_strategy.d.ts.map

package/core/field.d.ts

@@ -43,7 +43,7 @@ export type FieldValidator<T = any> = (newValue: T) => T | null | undefined;
 /**
  * Abstract class for an editable field.
  *
- * @typeParam T - The value stored on the field.
+ * @template T - The value stored on the field.
  */
 export declare abstract class Field<T = any> implements IKeyboardAccessible, IRegistrable, ISerializable, IFocusableNode {
     /**
@@ -235,9 +235,11 @@ export declare abstract class Field<T = any> implements IKeyboardAccessible, IRe
      * checkboxes represent their checked/non-checked status (i.e. value) through
      * a separate ARIA property.
      *
-     * It's not expected that this method, under normal operations, returns an empty
-     * string. If the field's value is empty then it will return a localized
-     * placeholder indicating that its value is empty.
+     * If the field's value is empty then it will return a localized placeholder
+     * indicating that its value is empty. If this method returns an empty string,
+     * the output will be ignored when composing the block-level ARIA label. Make
+     * sure you want your label hidden from screenreaders before returning an
+     * empty string.
      *
      * @param includeTypeInfo Whether to include the field's type information in
      *     the returned label, if available.
@@ -263,12 +265,16 @@ export declare abstract class Field<T = any> implements IKeyboardAccessible, IRe
     /**
      * Defines whether this field should take up the full block or not.
      *
-     * Be cautious when overriding this function. It may not work as you expect /
-     * intend because the behavior was kind of hacked in. If you are thinking
-     * about overriding this function, post on the forum with your intended
-     * behavior to see if there's another approach.
+     * This is typically only done for certain kinds of fields and in certain
+     * renderers. You should only override this if you're sure your field will
+     * render correctly in zelos and other renderers that support full-block
+     * fields.
      *
-     * @internal
+     * Blocks that contain only a single field that is a full-block-field
+     * have a special appearance in some renderers and their behavior is
+     * unique, because we pretend that the field is a whole block in some cases.
+     * This is hacky and you should use caution when attempting to do anything
+     * with this method.
      */
     isFullBlockField(): boolean;
     /**
@@ -750,6 +756,22 @@ export declare abstract class Field<T = any> implements IKeyboardAccessible, IRe
      * Shows and focuses the field editor.
      */
     performAction(): void;
+    /**
+     * Recomputes the aria state and label for this field. Fields are generally hidden
+     * when in blocks in the flyout (except for top-level full-block fields), and
+     * otherwise set to a role of button (indicating they can be clicked to edit)
+     * and given the label returned from their `computeAriaLabel` method.
+     *
+     * Subclasses can override this in order to change the role or label, but they must
+     * ensure they keep the correct behavior for fields in flyout blocks.
+     *
+     * This method will return a boolean indicating if the element is displayed in the
+     * aria tree or not. This can be used by subclasses to determine whether or not
+     * to continue customizing the role and label (hidden elements should not have labels).
+     *
+     * @returns true if the element is in the accessibility tree, false if the aria state is hidden
+     */
+    protected recomputeAriaContext(): boolean;
     /**
      * Subclasses should reimplement this method to construct their Field
      * subclass from a JSON arg object.

package/core/field_checkbox.d.ts

@@ -147,9 +147,9 @@ export declare class FieldCheckbox extends Field<CheckboxBool> {
      */
     static fromJson(options: FieldCheckboxFromJsonConfig): FieldCheckbox;
     /**
-     * Recomputes the ARIA role and label for this field.
+     * Customizes the label and sets additional aria state.
      */
-    protected recomputeAriaContext(): void;
+    recomputeAriaContext(): boolean;
 }
 /**
  * Config options for the checkbox field.

package/core/field_dropdown.d.ts

@@ -98,6 +98,15 @@ export declare class FieldDropdown extends Field<string> {
      * Create the block UI for this dropdown.
      */
     initView(): void;
+    /**
+     * This is hacky way of determining if a dropdown field is a full-block field or not.
+     * The constants that control the border rect are the same ones that determine how we
+     * render full-block dropdown fields. It's a full-block field if it doesn't have the
+     * border rect (and it's a simple reporter block).
+     *
+     * @returns true if this field should be treated as a full-block field
+     */
+    isFullBlockField(): boolean;
     /**
      * Whether or not the dropdown should add a border rect.
      *
@@ -270,9 +279,9 @@ export declare class FieldDropdown extends Field<string> {
      */
     private getSelectedAriaLabel;
     /**
-     * Recomputes the ARIA role and label for this field.
+     * Overrides the default label and sets additional aria state.
      */
-    protected recomputeAriaContext(): void;
+    recomputeAriaContext(): boolean;
     /**
      * Computes an ARIA-friendly label for a dropdown option.
      *

package/core/field_image.d.ts

@@ -150,9 +150,36 @@ export declare class FieldImage extends Field<string> {
      */
     getAriaValue(): string | null;
     /**
-     * Recomputes the ARIA role and label for this field.
+     * Computes a descriptive ARIA label to represent this field with configurable
+     * verbosity.
+     *
+     * A 'verbose' label includes type information, if available, whereas a
+     * non-verbose label only contains the field's value.
+     *
+     * Note that this will always return the latest representation of the field's
+     * label which may differ from any previously set ARIA label for the field
+     * itself. Implementations are largely responsible for ensuring that the
+     * field's ARIA label is set correctly at relevant moments in the field's
+     * lifecycle (such as when its value changes).
+     *
+     * Finally, it is never guaranteed that implementations use the label returned
+     * by this method for their actual ARIA label. Some implementations may rely
+     * on other contexts to convey information like the field's value. Example:
+     * checkboxes represent their checked/non-checked status (i.e. value) through
+     * a separate ARIA property.
+     *
+     * Returns an empty string on clickable images (buttons), as we do not want to
+     * include image buttons on the block-level ARIA label. When the button is
+     * focused the label is set in recomputeAriaContext below.
+     *
+     * @param includeTypeInfo Whether to include the field's type information in
+     *     the returned label, if available.
+     */
+    computeAriaLabel(includeTypeInfo: boolean): string;
+    /**
+     * Customizes label and sets additional aria state.
      */
-    protected recomputeAriaContext(): void;
+    recomputeAriaContext(): boolean;
 }
 /**
  * Config options for the image field.

package/core/field_input.d.ts

@@ -21,7 +21,7 @@ type InputTypes = string | number;
 /**
  * Abstract class for an editable input field.
  *
- * @typeParam T - The value stored on the field.
+ * @template T - The value stored on the field.
  * @internal
  */
 export declare abstract class FieldInput<T extends InputTypes> extends Field<string | T> {
@@ -283,9 +283,9 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      */
     getAriaValue(): string | null;
     /**
-     * Recomputes the ARIA role and label for this field.
+     * Customizes the label for this field to include "editable" if it applies.
      */
-    protected recomputeAriaContext(): void;
+    recomputeAriaContext(): boolean;
 }
 /**
  * Config options for the input field.

package/core/field_label.d.ts

@@ -41,6 +41,33 @@ export declare class FieldLabel extends Field<string> {
      * Create block UI for this label.
      */
     initView(): void;
+    /**
+     * Computes a descriptive ARIA label to represent this field with configurable
+     * verbosity.
+     *
+     * A 'verbose' label includes type information, if available, whereas a
+     * non-verbose label only contains the field's value.
+     *
+     * Note that this will always return the latest representation of the field's
+     * label which may differ from any previously set ARIA label for the field
+     * itself. Implementations are largely responsible for ensuring that the
+     * field's ARIA label is set correctly at relevant moments in the field's
+     * lifecycle (such as when its value changes).
+     *
+     * Finally, it is never guaranteed that implementations use the label returned
+     * by this method for their actual ARIA label. Some implementations may rely
+     * on other contexts to convey information like the field's value. Example:
+     * checkboxes represent their checked/non-checked status (i.e. value) through
+     * a separate ARIA property.
+     *
+     * Unlike other built-in fields, FieldLabel does return an empty string when its
+     * value is empty. This is because empty labels are sometimes used for layout
+     * purposes.
+     *
+     * @param includeTypeInfo Whether to include the field's type information in
+     *     the returned label, if available.
+     */
+    computeAriaLabel(includeTypeInfo?: boolean): string;
     /**
      * Ensure that the input value casts to a valid string.
      *

package/core/flyout_button.d.ts

@@ -142,7 +142,9 @@ export declare class FlyoutButton implements IBoundedElement, IRenderedElement,
     getId(): string;
     /**
      * Handles the user acting on this button via keyboard navigation.
-     * Invokes the click handler callback.
+     * Invokes the click handler callback for buttons. For labels, which are not
+     * interactive, shows a toast directing the user to navigate using the arrow
+     * keys or the next-heading shortcut.
      */
     performAction(): void;
 }

package/core/hints.d.ts

@@ -41,4 +41,38 @@ export declare function showBlockNavigationHint(workspace: WorkspaceSvg): void;
  * @param workspace The workspace.
  */
 export declare function showWorkspaceNavigationHint(workspace: WorkspaceSvg): void;
+/**
+ * Tell the user how to navigate away from a flyout label (heading) when they
+ * try to act on it. Labels are not interactive, so direct them to use the
+ * arrow keys to reach a block or the next-heading shortcut to skip ahead.
+ *
+ * @param workspace The workspace.
+ */
+export declare function showFlyoutLabelActionHint(workspace: WorkspaceSvg): void;
+/**
+ * Nudge the user to paste after a copy.
+ *
+ * @param workspace Workspace.
+ */
+export declare function showCopiedHint(workspace: WorkspaceSvg): void;
+/**
+ * Nudge the user to paste after a cut.
+ *
+ * @param workspace Workspace.
+ */
+export declare function showCutHint(workspace: WorkspaceSvg): void;
+/**
+ * Clear active paste-related hints, if any.
+ *
+ * @param workspace The workspace.
+ */
+export declare function clearPasteHints(workspace: WorkspaceSvg): void;
+/**
+ * Inform the user about screenreader optimization mode being toggled, and how
+ * to undo it.
+ *
+ * @param workspace The workspace where screenreader mode was toggled.
+ * @param enabled True if screenreader mode is now enabled, otherwise false.
+ */
+export declare function showScreenreaderModeHint(workspace: WorkspaceSvg, enabled: boolean): void;
 //# sourceMappingURL=hints.d.ts.map

package/core/inputs/input.d.ts

@@ -173,7 +173,10 @@ export declare class Input {
      */
     protected makeConnection(type: ConnectionType): Connection;
     /**
-     * Returns an ID for the visual "row" this input is part of.
+     * Returns an ID for the logical "row" this input is part of. A "row" is
+     * bounded by a previous/next connection, a statement input, or a block stack
+     * boundary; all blocks/inputs nested inside of one of those are conceptually
+     * part of its same row.
      *
      * @internal
      */
@@ -187,7 +190,8 @@ export declare class Input {
      */
     getLabel(verbosity?: Verbosity): string;
     /**
-     * Returns the index of this input on its source block.
+     * Returns the index of this input, excluding inputs without connections, on its
+     * source block.
      *
      * @internal
      */

package/core/keyboard_navigation_controller.d.ts

@@ -11,6 +11,8 @@
 export declare class KeyboardNavigationController {
     /** Whether the user is actively using keyboard navigation. */
     private isActive;
+    /** Whether to play audio cues when navigating between scope levels. */
+    private scopeChangeAudioCuesEnabled;
     /** Css class name added to body if keyboard nav is active. */
     private activeClassName;
     /**
@@ -40,6 +42,16 @@ export declare class KeyboardNavigationController {
      * (e.g., has recently taken some action that is only relevant to keyboard users)
      */
     getIsActive(): boolean;
+    /**
+     * Sets whether or not audio cues should be played when keyboard navigation
+     * transitions between blocks of different nesting levels.
+     */
+    setScopeChangeAudioCuesEnabled(enabled: boolean): void;
+    /**
+     * Returns whether or not audio cues should be played when keyboard navigation
+     * transitions between blocks of different nesting levels.
+     */
+    getScopeChangeAudioCuesEnabled(): boolean;
     /** Adds or removes the css class that indicates keyboard navigation is active. */
     private updateActiveVisualization;
 }

package/core/rendered_connection.d.ts

@@ -3,11 +3,6 @@
  * Copyright 2016 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Components for creating connections between blocks.
- *
- * @class
- */
 import type { BlockSvg } from './block_svg.js';
 import { Connection } from './connection.js';
 import { IContextMenu } from './interfaces/i_contextmenu.js';
@@ -133,6 +128,12 @@ export declare class RenderedConnection extends Connection implements IContextMe
         connection: RenderedConnection | null;
         radius: number;
     };
+    /**
+     * Sets the aria role, label, and other state for this connection.
+     *
+     * @param highlightSvg The focusable element for this connection.
+     */
+    private recomputeAriaContext;
     /** Add highlighting around this connection. */
     highlight(): void;
     /** Remove the highlighting around this connection. */