blockly 13.0.0-beta.1 → 13.0.0-beta.3

package/core/trashcan.d.ts

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

package/core/utils/aria.d.ts

@@ -187,7 +187,13 @@ export declare enum State {
      *
      * Value: a number representing the minimum allowed value for a range widget.
      */
-    VALUEMIN = "valuemin"
+    VALUEMIN = "valuemin",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-owns
+     *
+     * Value: a space-separated list of element IDs that are owned by the current element.
+     */
+    OWNS = "owns"
 }
 /**
  * Used to control how verbose generated a11y labels are.

package/core/workspace.d.ts

@@ -353,7 +353,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_svg.d.ts

@@ -377,6 +377,14 @@ 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 label on the workspace to reflect the number of top-level stacks in the workspace.
+     */
+    private updateAriaLabel;
     /**
      * Create the workspace DOM elements.
      *

package/core/zoom_controls.d.ts

@@ -9,10 +9,42 @@
  * @class
  */
 import './events/events_click.js';
+import { IFocusableNode } from './blockly.js';
 import type { IPositionable } from './interfaces/i_positionable.js';
 import type { UiMetrics } from './metrics_manager.js';
 import { Rect } from './utils/rect.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
+/**
+ * Base class for an individual zoom control (in, out, reset).
+ *
+ * @internal
+ */
+declare abstract class ZoomControl implements IFocusableNode {
+    protected workspace: WorkspaceSvg;
+    protected group: SVGGElement;
+    private pointerDownHandler;
+    private id;
+    constructor(workspace: WorkspaceSvg, group: SVGGElement);
+    getId(): string;
+    /**
+     * Handles a mouse down event on the zoom in or zoom out buttons on the
+     *    workspace.
+     *
+     * @param amount Amount of zooming. Negative amount values zoom out, and
+     *     positive amount values zoom in.
+     * @param e A mouse down or keydown event.
+     */
+    protected zoom(amount: number, e: Event): void;
+    /** Fires a zoom control UI event. */
+    protected fireZoomEvent(): void;
+    getFocusableElement(): SVGGElement;
+    getFocusableTree(): WorkspaceSvg;
+    onNodeFocus(): void;
+    onNodeBlur(): void;
+    canBeFocused(): boolean;
+    abstract performAction(_e: Event): void;
+    dispose(): void;
+}
 /**
  * Class for a zoom controls.
  */
@@ -23,18 +55,12 @@ export declare class ZoomControls implements IPositionable {
      * ComponentManager.
      */
     id: string;
-    /**
-     * Array holding info needed to unbind events.
-     * Used for disposing.
-     * Ex: [[node, name, func], [node, name, func]].
-     */
-    private boundEvents;
-    /** The zoom in svg <g> element. */
-    private zoomInGroup;
-    /** The zoom out svg <g> element. */
-    private zoomOutGroup;
-    /** The zoom reset svg <g> element. */
-    private zoomResetGroup;
+    /** The zoom in control. */
+    private zoomInControl;
+    /** The zoom out control. */
+    private zoomOutControl;
+    /** The zoom reset control. */
+    private zoomResetControl;
     /** Width of the zoom controls. */
     private readonly WIDTH;
     /** Height of each zoom control. */
@@ -90,45 +116,12 @@ export declare class ZoomControls implements IPositionable {
      */
     position(metrics: UiMetrics, savedPositions: Rect[]): void;
     /**
-     * Create the zoom in icon and its event handler.
-     *
-     * @param rnd The random string to use as a suffix in the clip path's ID.
-     *     These IDs must be unique in case there are multiple Blockly instances
-     *     on the same page.
-     */
-    private createZoomOutSvg;
-    /**
-     * Create the zoom out icon and its event handler.
-     *
-     * @param rnd The random string to use as a suffix in the clip path's ID.
-     *     These IDs must be unique in case there are multiple Blockly instances
-     *     on the same page.
-     */
-    private createZoomInSvg;
-    /**
-     * Handles a mouse down event on the zoom in or zoom out buttons on the
-     *    workspace.
-     *
-     * @param amount Amount of zooming. Negative amount values zoom out, and
-     *     positive amount values zoom in.
-     * @param e A mouse down event.
-     */
-    private zoom;
-    /**
-     * Create the zoom reset icon and its event handler.
+     * Returns the individual zoom control, if any, with the given ID. Used for
+     * focus management.
      *
-     * @param rnd The random string to use as a suffix in the clip path's ID.
-     *     These IDs must be unique in case there are multiple Blockly instances
-     *     on the same page.
+     * @internal
      */
-    private createZoomResetSvg;
-    /**
-     * Handles a mouse down event on the reset zoom button on the workspace.
-     *
-     * @param e A mouse down event.
-     */
-    private resetZoom;
-    /** Fires a zoom control UI event. */
-    private fireZoomEvent;
+    getControlWithId(id: string): ZoomControl | undefined;
 }
+export {};
 //# sourceMappingURL=zoom_controls.d.ts.map