blockly 13.0.0-beta.0 → 13.0.0-beta.2

package/core/block.d.ts

@@ -174,6 +174,8 @@ export declare class Block {
     type: string;
     inputsInlineDefault?: boolean;
     workspace: Workspace;
+    /** A custom provider for generating the aria role description for this block. */
+    private ariaRoleDescriptionProvider;
     /**
      * @param workspace The block's workspace.
      * @param prototypeName Name of the language object containing type-specific
@@ -695,6 +697,22 @@ export declare class Block {
      * @param collapsed True if collapsed.
      */
     setCollapsed(collapsed: boolean): void;
+    /**
+     * Set a custom aria role description provider for this block. If not set,
+     * uses a default provider based on the block's properties (e.g. whether it has
+     * inputs, outputs, etc.).
+     *
+     * @param description The description or function to provide the description.
+     *   If a string, we'll replace message references in the string, e.g.
+     *   `%{BKY_CUSTOM_MESSAGE}` will be replaced with the value of
+     *   `Blockly.Msg['CUSTOM_MESSAGE']`.}'
+     */
+    setAriaRoleDescriptionProvider(description: string | (() => string)): void;
+    /**
+     * @returns The custom string to use as the role description for this block,
+     *   or undefined if no custom description is set.
+     */
+    getAriaRoleDescription(): string | undefined;
     /**
      * Create a human-readable text representation of this block and any children.
      *

package/core/block_aria_composer.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @license
+ * Copyright 2026 Raspberry Pi Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from './block_svg.js';
+import type { Input } from './inputs/input.js';
+import { RenderedConnection } from './rendered_connection.js';
+import { Verbosity } from './utils/aria.js';
+/**
+ * Prepositions to use when describing the relationship between two blocks based
+ * on their connection types.
+ */
+export declare enum ConnectionPreposition {
+    UNKNOWN = 0,
+    BEFORE = 1,
+    AFTER = 2,
+    AROUND = 3,
+    INSIDE = 4
+}
+/**
+ * Returns an ARIA representation of the specified block.
+ *
+ * The returned label will contain a complete context of the block, including:
+ * - Whether it begins a block stack or statement input stack.
+ * - Its constituent editable and non-editable fields.
+ * - Properties, including: disabled, collapsed, replaceable (a shadow), etc.
+ * - Its parent toolbox category.
+ * - Whether it has inputs.
+ *
+ * Beyond this, the returned label is specifically assembled with commas in
+ * select locations with the intention of better 'prosody' in the screen reader
+ * readouts since there's a lot of information being shared with the user. The
+ * returned label also places more important information earlier in the label so
+ * that the user gets the most important context as soon as possible in case
+ * they wish to stop readout early.
+ *
+ * The returned label will be specialized based on whether the block is part of a
+ * flyout.
+ *
+ * @internal
+ * @param block The block for which an ARIA representation should be created.
+ * @param verbosity How much detail to include in the description.
+ * @returns The ARIA representation for the specified block.
+ */
+export declare function computeAriaLabel(block: BlockSvg, verbosity?: Verbosity): string;
+/**
+ * Sets the ARIA role and role description for the specified block, accounting
+ * for whether the block is part of a flyout.
+ *
+ * @internal
+ * @param block The block to set ARIA role and roledescription attributes on.
+ */
+export declare function configureAriaRole(block: BlockSvg): void;
+/**
+ * Returns a list of ARIA labels for the 'field row' for the specified Input.
+ *
+ * 'Field row' essentially means the horizontal run of readable fields that
+ * precede the Input. Together, these provide the domain context for the input,
+ * particularly in the context of connections. In some cases, there may not be
+ * any readable fields immediately prior to the Input. In that case, if the
+ * `lookback` attribute is specified, all of the fields on the row immediately
+ * above the Input will be used instead.
+ *
+ * @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
+ *     the given input's row has no fields itself.
+ * @returns A list of labels for fields on the same row (or previous row, if
+ *     lookback is specified) as the given input.
+ */
+export declare function computeFieldRowLabel(input: Input, lookback: boolean, verbosity?: Verbosity): string[];
+/**
+ * Returns a list of accessibility labels for fields and inputs on a block.
+ * Each entry in the returned array corresponds to one of: (a) a label for a
+ * continuous run of non-interactable fields, (b) a label for an editable field,
+ * (c) a label for an input. When an input contains nested blocks/fields/inputs,
+ * their contents are returned as a single item in the array per top-level
+ * input.
+ *
+ * @internal
+ * @param block The block to retrieve a list of field/input labels for.
+ * @returns A list of field/input labels for the given block.
+ */
+export declare function getInputLabels(block: BlockSvg, verbosity?: Verbosity): string[];
+/**
+ * Returns a subset of labels for inputs on the given block, ending at the
+ * specified input.
+ *
+ * The subset is determined based on the input type:
+ * - For non-statement inputs, only the label for the given input is returned.
+ * - For statement inputs, labels are collected from the start of the current
+ *   statement section up to and including the given input. A statement section
+ *   begins immediately after the previous statement input, or at the start of
+ *   the block if none exists.
+ *
+ * @internal
+ * @param block The block to retrieve a list of field/input labels for.
+ * @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[];
+/**
+ * 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
+ * will be assembled based on the types of the local and neighbour connections and
+ * the presence of any readable fields on the block's inputs. If multiple potential
+ * candidate connections are present, additional context will be included in the
+ * returned string to help disambiguate between them.
+ *
+ * @param local The moving side of the candidate connection pair
+ * @param neighbour The target side of the candidate connection pair
+ * @param disambiguationPolicy A function that determines whether it's useful to
+ *     include parent input labels for disambiguation.
+ * @param isMoveStart Whether this announcement is for the start of a move. If false,
+ *     skip announcing the block label since it should have already been announced.
+ */
+export declare function computeMoveLabel(local: RenderedConnection, neighbour: RenderedConnection, disambiguationPolicy: (forLocal: boolean) => boolean, isMoveStart?: boolean): string;
+//# sourceMappingURL=block_aria_composer.d.ts.map

package/core/block_svg.d.ts

@@ -28,6 +28,7 @@ import { IIcon } from './interfaces/i_icon.js';
 import { RenderedConnection } from './rendered_connection.js';
 import type { IPathObject } from './renderers/common/i_path_object.js';
 import type { BlockStyle } from './theme.js';
+import * as aria from './utils/aria.js';
 import { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';
 import { FlyoutItemInfo } from './utils/toolbox.js';
@@ -734,7 +735,7 @@ export declare class BlockSvg extends Block implements IBoundedElement, IContext
      * main workspace. If this block has a single full-block field, that field
      * will be focused. Otherwise, this is a no-op.
      */
-    performAction(): void;
+    performAction(e?: KeyboardEvent): void;
     /**
      * Returns a set of all of the parent blocks of the given block.
      *
@@ -756,5 +757,24 @@ export declare class BlockSvg extends Block implements IBoundedElement, IContext
      * @internal
      */
     getRowId(): string;
+    /**
+     * Updates the ARIA label, role and roledescription for this block.
+     */
+    private recomputeAriaAttributes;
+    /**
+     * Returns a description of this block suitable for screenreaders or use in
+     * ARIA attributes.
+     *
+     * @param verbosity How much detail to include in the description.
+     * @returns An accessibility description of this block.
+     */
+    getAriaLabel(verbosity: aria.Verbosity): string;
+    /**
+     * Count the number of blocks in this stack (connected by next connections)
+     * and return a label to describe it. Uses the standard label if there is only one block.
+     *
+     * @internal
+     */
+    getStackBlocksCountLabel(): string;
 }
 //# sourceMappingURL=block_svg.d.ts.map

package/core/blockly.d.ts

@@ -270,8 +270,8 @@ export declare const VARIABLE_DYNAMIC_CATEGORY_NAME: string;
  */
 export declare const PROCEDURE_CATEGORY_NAME: string;
 export * from './interfaces/i_navigation_policy.js';
-export * from './keyboard_nav/navigation_policies/block_comment_navigation_policy.js';
 export * from './keyboard_nav/navigation_policies/block_navigation_policy.js';
+export * from './keyboard_nav/navigation_policies/bubble_navigation_policy.js';
 export * from './keyboard_nav/navigation_policies/comment_bar_button_navigation_policy.js';
 export * from './keyboard_nav/navigation_policies/comment_editor_navigation_policy.js';
 export * from './keyboard_nav/navigation_policies/connection_navigation_policy.js';

package/core/bubbles/bubble.d.ts

@@ -13,6 +13,12 @@ import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { Size } from '../utils/size.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
+/**
+ * Represents a either a string or a function that, when called, can provide a
+ * custom ARIA string to represent a bubble, or null if the default fallback
+ * should be used. See setAriaLabelProvider for more context.
+ */
+export type AriaLabelProvider = string | ((bubble: Bubble) => string | null);
 /**
  * The abstract pop-up bubble class. This creates a UI that looks like a speech
  * bubble, where it has a "tail" that points to the block, and a "head" that
@@ -66,6 +72,7 @@ export declare abstract class Bubble implements IBubble, ISelectable, IFocusable
     private relativeLeft;
     private dragStrategy;
     private focusableElement;
+    private ariaLabelProvider;
     /**
      * @param workspace The workspace this bubble belongs to.
      * @param anchor The anchor location of the thing this bubble is attached to.
@@ -239,5 +246,37 @@ export declare abstract class Bubble implements IBubble, ISelectable, IFocusable
      * Returns the object that owns/hosts this bubble, if any.
      */
     getOwner(): (IHasBubble & IFocusableNode) | undefined;
+    /**
+     * Recomputes the ARIA label and role for this bubble. This is automatically called
+     * during initialization, but implementations may find it useful to call this if
+     * the bubble's label should be changed.
+     *
+     * Bubbles use a default non-specific label unless they're customized otherwise
+     * which is the responsibility of the bubble's owner rather than bubble
+     * implementations. Customization can be done via setAriaLabelProvider.
+     */
+    protected recomputeAriaContext(): void;
+    /**
+     * Sets a custom ARIA label provider for this bubble, or null if it should be reset
+     * to use the default method.
+     *
+     * Bubbles do not compute ARIA labels specifically to their implementation since
+     * they can be rather general-purpose. Instead, owners of the specific bubble
+     * instance (such as an icon) are responsible for defining custom label providers
+     * for their bubbles.
+     *
+     * Note that calling this isn't sufficient for it to actually be used.
+     * recomputeAriaContext will likely also need to be called to actually apply the
+     * custom label to the bubble's focusable element.
+     */
+    setAriaLabelProvider(provider: AriaLabelProvider | null): void;
+    /**
+     * Returns the ARIA label to use for this bubble based on the provider set via
+     * setAriaLabelProvider. This will return null if the provider is absent or
+     * returns null.
+     *
+     * @returns The ARIA label to use for this bubble, or null if one is not provided.
+     */
+    getAriaLabel(): string | null;
 }
 //# sourceMappingURL=bubble.d.ts.map

package/core/bubbles/mini_workspace_bubble.d.ts

@@ -5,6 +5,8 @@
  */
 import type { BlocklyOptions } from '../blockly_options.js';
 import { Abstract as AbstractEvent } from '../events/events_abstract.js';
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
+import type { IHasBubble } from '../interfaces/i_has_bubble.js';
 import { Options } from '../options.js';
 import { Coordinate } from '../utils/coordinate.js';
 import type { Rect } from '../utils/rect.js';
@@ -18,6 +20,7 @@ export declare class MiniWorkspaceBubble extends Bubble {
     readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;
     protected ownerRect?: Rect | undefined;
+    protected owner?: (IHasBubble & IFocusableNode) | undefined;
     /**
      * The minimum amount of change to the mini workspace view to trigger
      * resizing the bubble.
@@ -38,7 +41,7 @@ export declare class MiniWorkspaceBubble extends Bubble {
      */
     private autoLayout;
     /** @internal */
-    constructor(workspaceOptions: BlocklyOptions, workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined);
+    constructor(workspaceOptions: BlocklyOptions, workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined, owner?: (IHasBubble & IFocusableNode) | undefined);
     dispose(): void;
     /** @internal */
     getWorkspace(): WorkspaceSvg;

package/core/bubbles/text_bubble.d.ts

@@ -3,6 +3,8 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
+import type { IHasBubble } from '../interfaces/i_has_bubble.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
@@ -15,8 +17,9 @@ export declare class TextBubble extends Bubble {
     readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;
     protected ownerRect?: Rect | undefined;
+    protected owner?: (IHasBubble & IFocusableNode) | undefined;
     private paragraph;
-    constructor(text: string, workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined);
+    constructor(text: string, workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined, owner?: (IHasBubble & IFocusableNode) | undefined);
     /** @returns the current text of this text bubble. */
     getText(): string;
     /** Sets the current text of this text bubble, and updates the display. */

package/core/dragging/block_drag_strategy.d.ts

@@ -6,7 +6,6 @@
 import type { BlockSvg } from '../block_svg.js';
 import type { IDragStrategy } from '../interfaces/i_draggable.js';
 import { DragDisposition } from '../interfaces/i_draggable.js';
-import { Direction } from '../keyboard_nav/keyboard_mover.js';
 import type { RenderedConnection } from '../rendered_connection.js';
 import { Coordinate } from '../utils.js';
 /** Represents a valid pair of connections between the dragging block and a block on the workspace. */
@@ -57,6 +56,21 @@ export declare class BlockDragStrategy implements IDragStrategy {
      * and return a newly instantiated block when e.g. dragging from a flyout.
      */
     protected getTargetBlock(): BlockSvg;
+    /**
+     * Announces a move on the ARIA live region for assistive technologies.
+     *
+     * @param isMoveStart Whether this announcement is for the start of a move. If false,
+     * skip announcing the block label since it should have already been announced at the
+     * start of the move.
+     */
+    private announceMove;
+    /**
+     * Checks if there are multiple compatible connections for the specified side of the pair.
+     *
+     * @param forLocal Whether we are considering the local or neighbour side of the pair
+     * @returns True if there are multiple compatible connections, false otherwise
+     */
+    private hasMultipleCompatibleConnections;
     /**
      * Handles any setup for starting the drag, including disconnecting the block
      * from any parent blocks.
@@ -141,6 +155,14 @@ export declare class BlockDragStrategy implements IDragStrategy {
      * compatible type (input, output, etc) and connection check.
      */
     private getConnectionCandidate;
+    /**
+     * Returns the closest connection candidate for the given block.
+     *
+     * @param block The block to find a connection for.
+     * @param delta The distance the block has traveled since dragging began.
+     * @returns The closest available connection candidate, if any.
+     */
+    private getClosestCandidate;
     /**
      * Get the radius to use when searching for a nearby valid connection.
      */
@@ -169,10 +191,30 @@ export declare class BlockDragStrategy implements IDragStrategy {
     /**
      * Get the nearest valid candidate connection in traversal order.
      *
-     * @param direction The cardinal direction in which the block is being moved.
+     * @param delta The distance the block has moved since this drag began.
      * @returns A candidate connection and radius, or null if none was found.
      */
-    findTraversalCandidate(direction: Direction): ConnectionCandidate | null;
+    findTraversalCandidate(delta: Coordinate): ConnectionCandidate | null;
+    /**
+     * Returns whether or not the given block is at a terminal position (start or
+     * end) of the blocks on the workspace. This helps distinguish between a block
+     * that is at the end of the line because all valid connections have been
+     * visited and the proposed constrained move destination is now to drop it on
+     * the workspace as a top-level block (in which case it will be in a terminal
+     * position), and a block that just entered move mode as a top-level block,
+     * and should therefore still be able to move to another connection point
+     * even if looping is disabled.
+     *
+     * @param block The block to check.
+     * @param direction The current dragging direction.
+     * @returns True if the block is at the start or end of its possible positions
+     *     on the workspace.
+     */
+    private isInTerminalPosition;
+    /**
+     * Converts a connection pair to a connection candidate with a default
+     * distance of 0.
+     */
     private pairToCandidate;
     /**
      * Returns the cardinal direction that the block being dragged would have to

package/core/field.d.ts

@@ -200,22 +200,20 @@ export declare abstract class Field<T = any> implements IKeyboardAccessible, IRe
      * Gets an ARIA-friendly label representation of this field's value.
      *
      * Note that implementations should generally always override this value to
-     * ensure a non-null value is returned since the default implementation relies
-     * on 'getValue' which may return null, and a null return value for this
+     * ensure a non-null value is returned. The default implementation relies on
+     * 'getText' which may return an empty string. A null return value from this
      * function will prompt ARIA label generation to skip the field's value
-     * entirely when there may be a better contextual placeholder to use, instead,
-     * specific to the field.
+     * entirely when there may be a better contextual placeholder to use isstead.
      *
-     * For example, a text input field may have a value of null when empty. To
-     * avoid hiding this field from screen reader, implementations should ensure
-     * that if the value is null, this function would return an appropriate,
-     * localized value such as "empty text".
+     * For example, to avoid hiding an empty text input field from screen reader,
+     * implementations should ensure that if the text is an empty string, this
+     * function would return an appropriate, localized value such as "empty text".
      *
      * Implementations are responsible for, and encouraged to, return a localized
      * version of the ARIA representation of the field's value.
      *
-     * @returns An ARIA representation of the field's value, or null if no value
-     *     is currently defined or known for the field.
+     * @returns An ARIA representation of the field's text, or null if no text is
+     *     currently defined or known for the field.
      */
     getAriaValue(): string | null;
     /**
@@ -237,11 +235,9 @@ 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 possible this returns an empty string if the field doesn't supply type
-     * or value information for certain cases (such as a null value). This can
-     * lead to the field being potentially COMPLETELY HIDDEN for screen reader
-     * navigation so it's crucial for implementations to ensure a non-empty value
-     * is returned here.
+     * 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.
      *
      * @param includeTypeInfo Whether to include the field's type information in
      *     the returned label, if available.
@@ -282,9 +278,11 @@ export declare abstract class Field<T = any> implements IKeyboardAccessible, IRe
      */
     protected createBorderRect_(): void;
     /**
-     * Create a field text element. Not to be overridden by subclasses. Instead
+     * Create a field text element. Not to be overridden by subclasses. Instead,
      * modify the result of the function inside initView, or create a separate
-     * function to call.
+     * function to call. Aria state is hidden; use the aria label for the field
+     * and/or containing block to expose content to screen readers. Text content
+     * for custom blocks can be set after creation.
      */
     protected createTextElement_(): void;
     /**

package/core/field_checkbox.d.ts

@@ -114,6 +114,29 @@ export declare class FieldCheckbox extends Field<CheckboxBool> {
      * @returns The converted value.
      */
     private convertValueToBool;
+    /**
+     * Gets an ARIA-friendly label representation of this field's type.
+     *
+     * Implementations are responsible for, and encouraged to, return a localized
+     * version of the ARIA representation of the field's type.
+     *
+     * @returns An ARIA representation of the field's type or a default if it is
+     *     unspecified.
+     */
+    getAriaTypeName(): string;
+    /**
+     * Gets an ARIA-friendly label representation of this field's value.
+     *
+     * Implementations are responsible for, and encouraged to, return a localized
+     * version of the ARIA representation of the field's value.
+     *
+     * The FieldCheckbox implementation is not used for the actual ARIA label of
+     * the field, since the checked state is already included in the ARIA checked
+     * state, but it is used for the ARIA label of its source block.
+     *
+     * @returns An ARIA representation of the field's text.
+     */
+    getAriaValue(): string | null;
     /**
      * Construct a FieldCheckbox from a JSON arg object.
      *
@@ -123,6 +146,10 @@ export declare class FieldCheckbox extends Field<CheckboxBool> {
      * @internal
      */
     static fromJson(options: FieldCheckboxFromJsonConfig): FieldCheckbox;
+    /**
+     * Recomputes the ARIA role and label for this field.
+     */
+    protected recomputeAriaContext(): void;
 }
 /**
  * Config options for the checkbox field.

package/core/field_dropdown.d.ts

@@ -56,6 +56,11 @@ export declare class FieldDropdown extends Field<string> {
     protected static IMAGE_Y_OFFSET: number;
     /** The total vertical padding above and below an image. */
     protected static IMAGE_Y_PADDING: number;
+    /**
+     * True once the field’s DOM has been created and it is safe to run ARIA
+     * updates in response to value changes.
+     */
+    isInitialized: boolean;
     /**
      * @param menuGenerator A non-empty array of options for a dropdown list, or a
      *     function which generates these options. Also accepts Field.SKIP_SETUP
@@ -238,6 +243,50 @@ export declare class FieldDropdown extends Field<string> {
      * @throws {TypeError} If proposed options are incorrectly structured.
      */
     protected validateOptions(options: MenuOption[]): void;
+    /**
+     * Gets an ARIA-friendly label representation of this field's type.
+     *
+     * Implementations are responsible for, and encouraged to, return a localized
+     * version of the ARIA representation of the field's type.
+     *
+     * @returns An ARIA representation of the field's type or a default if it is
+     *     unspecified.
+     */
+    getAriaTypeName(): string | null;
+    /**
+     * Gets an ARIA-friendly label representation of this field's value.
+     *
+     * Implementations are responsible for, and encouraged to, return a localized
+     * version of the ARIA representation of the field's value.
+     *
+     * @returns An ARIA representation of the field's text.
+     */
+    getAriaValue(): string;
+    /**
+     * Returns the ARIA label for the currently selected dropdown option.
+     *
+     * @returns The computed ARIA label for the selected option, or `null` if no
+     * option is selected.
+     */
+    private getSelectedAriaLabel;
+    /**
+     * Recomputes the ARIA role and label for this field.
+     */
+    protected recomputeAriaContext(): void;
+    /**
+     * Computes an ARIA-friendly label for a dropdown option.
+     *
+     * The label is derived using a prioritized set of sources.
+     *
+     * Returned values are guaranteed to be non-empty strings for all non-separator
+     * options. Whitespace-only values are ignored when determining a usable label.
+     *
+     * @param option The dropdown option for which to compute the ARIA label.
+     * @param index The index of the option within the dropdown (0-based).
+     * @returns A string suitable for use as an ARIA label. Returns an empty string
+     *     only if the option is a separator.
+     */
+    private computeOptionAriaLabel;
 }
 /**
  * Definition of a human-readable image dropdown option.
@@ -247,6 +296,7 @@ export interface ImageProperties {
     alt: string;
     width: number;
     height: number;
+    ariaLabel?: string;
 }
 /**
  * An individual option in the dropdown menu. Can be either the string literal
@@ -255,7 +305,7 @@ export interface ImageProperties {
  * (text, ImageProperties object, or HTML element), and the second element is
  * the language-neutral value.
  */
-export type MenuOption = [string | ImageProperties | HTMLElement, string] | 'separator';
+export type MenuOption = [string | ImageProperties | HTMLElement, string, string?] | 'separator';
 /**
  * A function that generates an array of menu options for FieldDropdown
  * or its descendants.

package/core/field_image.d.ts

@@ -129,6 +129,30 @@ export declare class FieldImage extends Field<string> {
      * @internal
      */
     static fromJson(options: FieldImageFromJsonConfig): FieldImage;
+    /**
+     * Gets an ARIA-friendly label representation of this field's type.
+     *
+     * Implementations are responsible for, and encouraged to, return a localized
+     * version of the ARIA representation of the field's type.
+     *
+     * @returns An ARIA representation of the field's type or a default if it is
+     *     unspecified.
+     */
+    getAriaTypeName(): string | null;
+    /**
+     * Gets an ARIA-friendly label representation of this field's value.
+     *
+     * Implementations are responsible for, and encouraged to, return a localized
+     * version of the ARIA representation of the field's value.
+     *
+     * @returns An ARIA representation of the field's text, or null if no text is
+     *     currently defined or known for the field.
+     */
+    getAriaValue(): string | null;
+    /**
+     * Recomputes the ARIA role and label for this field.
+     */
+    protected recomputeAriaContext(): void;
 }
 /**
  * Config options for the image field.

package/core/field_input.d.ts

@@ -263,6 +263,29 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      * @returns The value to store.
      */
     protected getValueFromEditorText_(text: string): any;
+    /**
+     * Gets an ARIA-friendly label representation of this field's type.
+     *
+     * Implementations are responsible for, and encouraged to, return a localized
+     * version of the ARIA representation of the field's type.
+     *
+     * @returns An ARIA representation of the field's type or a default if it is
+     *     unspecified.
+     */
+    getAriaTypeName(): string | null;
+    /**
+     * Gets an ARIA-friendly label representation of this field's value.
+     *
+     * Implementations are responsible for, and encouraged to, return a localized
+     * version of the ARIA representation of the field's value.
+     *
+     * @returns An ARIA representation of the field's text.
+     */
+    getAriaValue(): string | null;
+    /**
+     * Recomputes the ARIA role and label for this field.
+     */
+    protected recomputeAriaContext(): void;
 }
 /**
  * Config options for the input field.

package/core/field_number.d.ts

@@ -160,6 +160,16 @@ export declare class FieldNumber extends FieldInput<number> {
      * @internal
      */
     static fromJson(options: FieldNumberFromJsonConfig): FieldNumber;
+    /**
+     * Gets an ARIA-friendly label representation of this field's type.
+     *
+     * Implementations are responsible for, and encouraged to, return a localized
+     * version of the ARIA representation of the field's type.
+     *
+     * @returns An ARIA representation of the field's type or a default if it is
+     *     unspecified.
+     */
+    getAriaTypeName(): string | null;
 }
 /**
  * Config options for the number field.