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

package/core/field_image.d.ts

@@ -8,7 +8,8 @@
  *
  * @class
  */
-import { Field, FieldConfig } from './field.js';
+import type { FieldConfig } from './field.js';
+import { Field } from './field.js';
 /**
  * Class for an image on a block.
  */
@@ -51,7 +52,7 @@ export declare class FieldImage extends Field<string> {
      * @param flipRtl Whether to flip the icon in RTL.
      * @param config A map of options used to configure the field.
      *     See the [field creation documentation]{@link
-     * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/image#creation}
+     * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/image/#creation}
      * for a list of properties this parameter supports.
      */
     constructor(src: string | typeof Field.SKIP_SETUP, width: string | number, height: string | number, alt?: string, onClick?: (p1: FieldImage) => void, flipRtl?: boolean, config?: FieldImageConfig);
@@ -129,6 +130,57 @@ 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;
+    /**
+     * 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.
+     */
+    recomputeAriaContext(): boolean;
 }
 /**
  * Config options for the image field.

package/core/field_input.d.ts

@@ -3,14 +3,9 @@
  * Copyright 2012 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Text input field.
- *
- * @class
- */
-import './events/events_block_change.js';
-import { Field, FieldConfig, FieldValidator } from './field.js';
-import { Size } from './utils/size.js';
+import type { FieldConfig, FieldValidator } from './field.js';
+import { Field } from './field.js';
+import type { Size } from './utils/size.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Supported types for FieldInput subclasses.
@@ -21,7 +16,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> {
@@ -40,6 +35,10 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      * True if the value currently displayed in the field's editory UI is valid.
      */
     protected isTextValid_: boolean;
+    /**
+     * The warning icon to display on invalid input
+     */
+    protected warningIcon: SVGElement | null;
     /**
      * The intial value of the field when the user opened an editor to change its
      * value. When the editor is disposed, an event will be fired that uses this
@@ -78,13 +77,15 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      *     to abort the change.
      * @param config A map of options used to configure the field.
      *     See the [field creation documentation]{@link
-     * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/text-input#creation}
+     * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/text-input/#creation}
      * for a list of properties this parameter supports.
      */
     constructor(value?: string | typeof Field.SKIP_SETUP, validator?: FieldInputValidator<T> | null, config?: FieldInputConfig);
     protected configure_(config: FieldInputConfig): void;
     initView(): void;
     isFullBlockField(): boolean;
+    /** Creates the DOM elements for the invalid input warning icon. */
+    protected createWarningIcon(): SVGElement | null;
     /**
      * Called by setValue if the text input is not valid. If the field is
      * currently being edited it reverts value of the field to the previous
@@ -130,6 +131,7 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      * block field or not.
      */
     protected render_(): void;
+    protected renderWarningIcon(rtl: boolean, isValid: boolean): void;
     /**
      * Set whether this field is spellchecked by the browser.
      *
@@ -218,8 +220,8 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
     protected resizeEditor_(): void;
     /**
      * Handles repositioning the WidgetDiv used for input fields when the
-     * workspace is resized. Will bump the block into the viewport and update the
-     * position of the text input if necessary.
+     * workspace is resized. Scrolls this field into view, then updates the
+     * position of the text input.
      *
      * @returns True for rendered workspaces, as we never want to hide the widget
      *     div.
@@ -263,6 +265,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;
+    /**
+     * Customizes the label for this field to include "editable" if it applies.
+     */
+    recomputeAriaContext(): boolean;
 }
 /**
  * Config options for the input field.
@@ -276,7 +301,7 @@ export interface FieldInputConfig extends FieldConfig {
  * A function that is called to validate changes to the field's value before
  * they are set.
  *
- * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @see {@link https://docs.blockly.com/guides/create-custom-blocks/fields/validators/#return-values}
  * @param newValue The value to be validated.
  * @returns One of three instructions for setting the new value: `T`, `null`,
  * or `undefined`.

package/core/field_label.d.ts

@@ -9,7 +9,8 @@
  *
  * @class
  */
-import { Field, FieldConfig } from './field.js';
+import type { FieldConfig } from './field.js';
+import { Field } from './field.js';
 /**
  * Class for a non-editable, non-serializable text field.
  */
@@ -23,6 +24,7 @@ export declare class FieldLabel extends Field<string> {
     EDITABLE: boolean;
     /** Text labels should not truncate. */
     maxDisplayLength: number;
+    isLabelField(): boolean;
     /**
      * @param value The initial value of the field. Should cast to a string.
      *     Defaults to an empty string if null or undefined. Also accepts
@@ -32,7 +34,7 @@ export declare class FieldLabel extends Field<string> {
      * @param textClass Optional CSS class for the field's text.
      * @param config A map of options used to configure the field.
      *    See the [field creation documentation]{@link
-     * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/label#creation}
+     * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/label/#creation}
      * for a list of properties this parameter supports.
      */
     constructor(value?: string | typeof Field.SKIP_SETUP, textClass?: string, config?: FieldLabelConfig);
@@ -41,6 +43,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/field_label_serializable.d.ts

@@ -10,7 +10,8 @@
  *
  * @class
  */
-import { FieldLabel, FieldLabelConfig, FieldLabelFromJsonConfig } from './field_label.js';
+import type { FieldLabelConfig, FieldLabelFromJsonConfig } from './field_label.js';
+import { FieldLabel } from './field_label.js';
 /**
  * Class for a non-editable, serializable text field.
  */
@@ -32,7 +33,7 @@ export declare class FieldLabelSerializable extends FieldLabel {
      * @param textClass Optional CSS class for the field's text.
      * @param config A map of options used to configure the field.
      *    See the [field creation documentation]{@link
-     * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/label-serializable#creation}
+     * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/label-serializable/#creation}
      * for a list of properties this parameter supports.
      */
     constructor(value?: string, textClass?: string, config?: FieldLabelConfig);

package/core/field_number.d.ts

@@ -9,7 +9,8 @@
  * @class
  */
 import { Field } from './field.js';
-import { FieldInput, FieldInputConfig, FieldInputValidator } from './field_input.js';
+import type { FieldInputConfig, FieldInputValidator } from './field_input.js';
+import { FieldInput } from './field_input.js';
 /**
  * Class for an editable number field.
  */
@@ -43,7 +44,7 @@ export declare class FieldNumber extends FieldInput<number> {
      *     to abort the change.
      * @param config A map of options used to configure the field.
      *     See the [field creation documentation]{@link
-     * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/number#creation}
+     * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/number/#creation}
      * for a list of properties this parameter supports.
      */
     constructor(value?: string | number | typeof Field.SKIP_SETUP, min?: string | number | null, max?: string | number | null, precision?: string | number | null, validator?: FieldNumberValidator | null, config?: FieldNumberConfig);
@@ -160,6 +161,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.
@@ -179,7 +190,7 @@ export interface FieldNumberFromJsonConfig extends FieldNumberConfig {
  * A function that is called to validate changes to the field's value before
  * they are set.
  *
- * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @see {@link https://docs.blockly.com/guides/create-custom-blocks/fields/validators/#return-values}
  * @param newValue The value to be validated.
  * @returns One of three instructions for setting the new value: `T`, `null`,
  * or `undefined`.

package/core/field_textinput.d.ts

@@ -8,9 +8,9 @@
  *
  * @class
  */
-import './events/events_block_change.js';
-import { Field } from './field.js';
-import { FieldInput, FieldInputConfig, FieldInputValidator } from './field_input.js';
+import type { Field } from './field.js';
+import type { FieldInputConfig, FieldInputValidator } from './field_input.js';
+import { FieldInput } from './field_input.js';
 /**
  * Class for an editable text field.
  */
@@ -26,7 +26,7 @@ export declare class FieldTextInput extends FieldInput<string> {
      *     to abort the change.
      * @param config A map of options used to configure the field.
      *     See the [field creation documentation]{@link
-     * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/text-input#creation}
+     * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/text-input/#creation}
      * for a list of properties this parameter supports.
      */
     constructor(value?: string | typeof Field.SKIP_SETUP, validator?: FieldTextInputValidator | null, config?: FieldTextInputConfig);
@@ -48,6 +48,16 @@ export declare class FieldTextInput extends FieldInput<string> {
      * @internal
      */
     static fromJson(options: FieldTextInputFromJsonConfig): FieldTextInput;
+    /**
+     * 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 text input field.
@@ -63,7 +73,7 @@ export interface FieldTextInputFromJsonConfig extends FieldTextInputConfig {
  * A function that is called to validate changes to the field's value before
  * they are set.
  *
- * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @see {@link https://docs.blockly.com/guides/create-custom-blocks/fields/validators/#return-values}
  * @param newValue The value to be validated.
  * @returns One of three instructions for setting the new value: `T`, `null`,
  * or `undefined`.

package/core/field_variable.d.ts

@@ -8,11 +8,12 @@
  *
  * @class
  */
-import './events/events_block_change.js';
 import type { Block } from './block.js';
-import { Field, FieldConfig } from './field.js';
-import { FieldDropdown, FieldDropdownValidator, MenuGenerator, MenuOption } from './field_dropdown.js';
-import { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
+import type { FieldConfig } from './field.js';
+import { Field } from './field.js';
+import type { FieldDropdownValidator, MenuGenerator, MenuOption } from './field_dropdown.js';
+import { FieldDropdown } from './field_dropdown.js';
+import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
 import type { Menu } from './menu.js';
 import type { MenuItem } from './menuitem.js';
 /**
@@ -52,7 +53,7 @@ export declare class FieldVariable extends FieldDropdown {
      *     is not provided.
      * @param config A map of options used to configure the field.
      *    See the [field creation documentation]{@link
-     * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/variable#creation}
+     * https://docs.blockly.com/guides/create-custom-blocks/fields/built-in-fields/variable/#creation}
      * for a list of properties this parameter supports.
      */
     constructor(varName: string | null | typeof Field.SKIP_SETUP, validator?: FieldVariableValidator, variableTypes?: string[] | null, defaultType?: string, config?: FieldVariableConfig);
@@ -228,6 +229,15 @@ export declare class FieldVariable extends FieldDropdown {
      * @returns Array of variable names/id tuples.
      */
     static dropdownCreate(this: FieldVariable): MenuOption[];
+    /**
+     * 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;
 }
 /**
  * Config options for the variable field.
@@ -246,7 +256,7 @@ export interface FieldVariableFromJsonConfig extends FieldVariableConfig {
  * A function that is called to validate changes to the field's value before
  * they are set.
  *
- * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @see {@link https://docs.blockly.com/guides/create-custom-blocks/fields/validators/#return-values}
  * @param newValue The value to be validated.
  * @returns One of three instructions for setting the new value: `T`, `null`,
  * or `undefined`.

package/core/flyout_base.d.ts

@@ -3,43 +3,23 @@
  * Copyright 2011 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Flyout tray containing blocks which may be created.
- *
- * @class
- */
-import { BlockSvg } from './block_svg.js';
 import { DeleteArea } from './delete_area.js';
 import { FlyoutItem } from './flyout_item.js';
-import { IAutoHideable } from './interfaces/i_autohideable.js';
+import type { IAutoHideable } from './interfaces/i_autohideable.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
 import type { IFlyoutInflater } from './interfaces/i_flyout_inflater.js';
-import { IFocusableNode } from './interfaces/i_focusable_node.js';
-import type { IFocusableTree } from './interfaces/i_focusable_tree.js';
 import type { Options } from './options.js';
-import * as blocks from './serialization/blocks.js';
-import { Coordinate } from './utils/coordinate.js';
 import { Svg } from './utils/svg.js';
 import * as toolbox from './utils/toolbox.js';
 import { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for a flyout.
  */
-export declare abstract class Flyout extends DeleteArea implements IAutoHideable, IFlyout, IFocusableNode {
+export declare abstract class Flyout extends DeleteArea implements IAutoHideable, IFlyout {
     /**
      * Position the flyout.
      */
     abstract position(): void;
-    /**
-     * Determine if a drag delta is toward the workspace, based on the position
-     * and orientation of the flyout. This is used in determineDragIntention_ to
-     * determine if a new block should be created or if the flyout should scroll.
-     *
-     * @param currentDragDeltaXY How far the pointer has
-     *     moved from the position at mouse down, in pixel units.
-     * @returns True if the drag is toward the workspace.
-     */
-    abstract isDragTowardWorkspace(currentDragDeltaXY: Coordinate): boolean;
     /**
      * Sets the translation of the flyout to match the scrollbars.
      *
@@ -151,27 +131,6 @@ export declare abstract class Flyout extends DeleteArea implements IAutoHideable
      * Height of flyout.
      */
     protected height_: number;
-    /**
-     * Range of a drag angle from a flyout considered "dragging toward
-     * workspace". Drags that are within the bounds of this many degrees from
-     * the orthogonal line to the flyout edge are considered to be "drags toward
-     * the workspace".
-     *
-     * @example
-     *
-     * ```
-     * Flyout                                                 Edge   Workspace
-     * [block] /  <-within this angle, drags "toward workspace" |
-     * [block] ---- orthogonal to flyout boundary ----          |
-     * [block] \                                                |
-     * ```
-     *
-     * The angle is given in degrees from the orthogonal.
-     *
-     * This is used to know when to create a new block and when to scroll the
-     * flyout. Setting it to 360 means that all drags create a new block.
-     */
-    protected dragAngleRange_: number;
     /**
      * The path around the background of the flyout, which will be filled with a
      * background colour.
@@ -309,6 +268,16 @@ export declare abstract class Flyout extends DeleteArea implements IAutoHideable
      *     toolbox definition, or a string with the name of the dynamic category.
      */
     show(flyoutDef: toolbox.FlyoutDefinition | string): void;
+    /**
+     * Updates the aria attributes for the entire flyout dom.
+     * This needs to do two things:
+     * 1. Set aria-owns on the flyout's workspace canvas to include the ids of all
+     *    focusable elements in the flyout.
+     * 2. Update the aria attributes on the flyout's workspace. This can't be done at workspace
+     *    creation because the workspace may not have all required information until the flyout
+     *    is fully shown.
+     */
+    protected updateAriaContext(): void;
     /**
      * Create the contents array and gaps array necessary to create the layout for
      * the flyout.
@@ -348,25 +317,6 @@ export declare abstract class Flyout extends DeleteArea implements IAutoHideable
      * @param e Pointer down event.
      */
     private onMouseDown;
-    /**
-     * Does this flyout allow you to create a new instance of the given block?
-     * Used for deciding if a block can be "dragged out of" the flyout.
-     *
-     * @param block The block to copy from the flyout.
-     * @returns True if you can create a new instance of the block, false
-     *    otherwise.
-     * @internal
-     */
-    isBlockCreatable(block: BlockSvg): boolean;
-    /**
-     * Create a copy of this block on the workspace.
-     *
-     * @param originalBlock The block to copy from the flyout.
-     * @returns The newly created block.
-     * @throws {Error} if something went wrong with deserialization.
-     * @internal
-     */
-    createBlock(originalBlock: BlockSvg): BlockSvg;
     /**
      * Reflow flyout contents.
      */
@@ -377,20 +327,6 @@ export declare abstract class Flyout extends DeleteArea implements IAutoHideable
      * @internal
      */
     isScrollable(): boolean;
-    /**
-     * Serialize a block to JSON.
-     *
-     * @param block The block to serialize.
-     * @returns A serialized representation of the block.
-     */
-    protected serializeBlock(block: BlockSvg): blocks.State;
-    /**
-     * Positions a block on the target workspace.
-     *
-     * @param oldBlock The flyout block being copied.
-     * @param block The block to posiiton.
-     */
-    private positionNewBlock;
     /**
      * Returns the inflater responsible for constructing items of the given type.
      *
@@ -399,55 +335,5 @@ export declare abstract class Flyout extends DeleteArea implements IAutoHideable
      *     is registered for that type.
      */
     protected getInflaterForType(type: string): IFlyoutInflater | null;
-    /**
-     * See IFocusableNode.getFocusableElement.
-     *
-     * @deprecated v12: Use the Flyout's workspace for focus operations, instead.
-     */
-    getFocusableElement(): HTMLElement | SVGElement;
-    /**
-     * See IFocusableNode.getFocusableTree.
-     *
-     * @deprecated v12: Use the Flyout's workspace for focus operations, instead.
-     */
-    getFocusableTree(): IFocusableTree;
-    /** See IFocusableNode.onNodeFocus. */
-    onNodeFocus(): void;
-    /** See IFocusableNode.onNodeBlur. */
-    onNodeBlur(): void;
-    /** See IFocusableNode.canBeFocused. */
-    canBeFocused(): boolean;
-    /**
-     * See IFocusableNode.getRootFocusableNode.
-     *
-     * @deprecated v12: Use the Flyout's workspace for focus operations, instead.
-     */
-    getRootFocusableNode(): IFocusableNode;
-    /**
-     * See IFocusableNode.getRestoredFocusableNode.
-     *
-     * @deprecated v12: Use the Flyout's workspace for focus operations, instead.
-     */
-    getRestoredFocusableNode(_previousNode: IFocusableNode | null): IFocusableNode | null;
-    /**
-     * See IFocusableNode.getNestedTrees.
-     *
-     * @deprecated v12: Use the Flyout's workspace for focus operations, instead.
-     */
-    getNestedTrees(): Array<IFocusableTree>;
-    /**
-     * See IFocusableNode.lookUpFocusableNode.
-     *
-     * @deprecated v12: Use the Flyout's workspace for focus operations, instead.
-     */
-    lookUpFocusableNode(_id: string): IFocusableNode | null;
-    /** See IFocusableTree.onTreeFocus. */
-    onTreeFocus(_node: IFocusableNode, _previousTree: IFocusableTree | null): void;
-    /**
-     * See IFocusableNode.onTreeBlur.
-     *
-     * @deprecated v12: Use the Flyout's workspace for focus operations, instead.
-     */
-    onTreeBlur(_nextTree: IFocusableTree | null): void;
 }
 //# sourceMappingURL=flyout_base.d.ts.map

package/core/flyout_button.d.ts

@@ -136,5 +136,16 @@ export declare class FlyoutButton implements IBoundedElement, IRenderedElement,
     onNodeBlur(): void;
     /** See IFocusableNode.canBeFocused. */
     canBeFocused(): boolean;
+    /**
+     * Returns the ID of this FlyoutButton.
+     */
+    getId(): string;
+    /**
+     * Handles the user acting on this button via keyboard navigation.
+     * 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;
 }
 //# sourceMappingURL=flyout_button.d.ts.map

package/core/flyout_horizontal.d.ts

@@ -6,7 +6,6 @@
 import { Flyout } from './flyout_base.js';
 import type { FlyoutItem } from './flyout_item.js';
 import type { Options } from './options.js';
-import type { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';
 /**
  * Class for a flyout.
@@ -60,16 +59,6 @@ export declare class HorizontalFlyout extends Flyout {
      * @param contents The flyout items to lay out.
      */
     protected layout_(contents: FlyoutItem[]): void;
-    /**
-     * Determine if a drag delta is toward the workspace, based on the position
-     * and orientation of the flyout. This is used in determineDragIntention_ to
-     * determine if a new block should be created or if the flyout should scroll.
-     *
-     * @param currentDragDeltaXY How far the pointer has moved from the position
-     *     at mouse down, in pixel units.
-     * @returns True if the drag is toward the workspace.
-     */
-    isDragTowardWorkspace(currentDragDeltaXY: Coordinate): boolean;
     /**
      * Returns the bounding rectangle of the drag target area in pixel units
      * relative to viewport.

package/core/flyout_metrics_manager.d.ts

@@ -9,7 +9,8 @@
  * @class
  */
 import type { IFlyout } from './interfaces/i_flyout.js';
-import { ContainerRegion, MetricsManager } from './metrics_manager.js';
+import type { ContainerRegion } from './metrics_manager.js';
+import { MetricsManager } from './metrics_manager.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Calculates metrics for a flyout's workspace.