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

package/core/utils/aria.d.ts

@@ -97,19 +97,13 @@ export declare enum State {
      *
      * Value: one of {true, false}.
      */
-    ATOMIC = "ATOMIC",
+    ATOMIC = "atomic",
     /**
      * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-checked.
      *
      * Value: one of {true, false, mixed, undefined}.
      */
     CHECKED = "checked",
-    /**
-     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-colcount.
-     *
-     * Value: an integer representing the number of columns in a grid.
-     */
-    COLCOUNT = "colcount",
     /**
      * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-controls.
      *
@@ -170,72 +164,18 @@ export declare enum State {
      * Value: one of {polite, assertive, off}.
      */
     LIVE = "live",
-    /**
-     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-orientation.
-     *
-     * Value: one of {horizontal, vertical, undefined}.
-     */
-    ORIENTATION = "orientation",
-    /**
-     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-posinset.
-     *
-     * Value: an integer representing the position of the element within a set of related elements.
-     */
-    POSINSET = "posinset",
-    /**
-     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-pressed.
-     *
-     * Value: one of {true, false, mixed, undefined}.
-     */
-    PRESSED = "pressed",
-    /**
-     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-readonly.
-     *
-     * Value: one of {true, false}.
-     */
-    READONLY = "readonly",
-    /**
-     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-required.
-     *
-     * Value: one of {true, false}.
-     */
-    REQUIRED = "required",
     /**
      * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-roledescription.
      *
      * Value: a string.
      */
     ROLEDESCRIPTION = "roledescription",
-    /**
-     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-rowcount.
-     *
-     * Value: an integer representing the number of rows in a grid or table.
-     */
-    ROWCOUNT = "rowcount",
-    /**
-     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-rowindex.
-     *
-     * Value: an integer representing the index of the element within a set of related elements.
-     */
-    ROWINDEX = "rowindex",
-    /**
-     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-rowspan.
-     *
-     * Value: an integer representing the number of rows a cell spans in a grid or table.
-     */
-    ROWSPAN = "rowspan",
     /**
      * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-selected.
      *
      * Value:one of {true, false, undefined}.
      */
     SELECTED = "selected",
-    /**
-     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-setsize.
-     *
-     * Value: an integer representing the total number of elements in a set of related elements.
-     */
-    SETSIZE = "setsize",
     /**
      * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-valuemax.
      *
@@ -247,7 +187,21 @@ 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.
+ */
+export declare enum Verbosity {
+    TERSE = 0,
+    STANDARD = 1,
+    LOQUACIOUS = 2
 }
 /**
  * Removes the ARIA role from an element.

package/core/utils/dom.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { Svg } from './svg.js';
+import { Svg } from './svg.js';
 /**
  * Required name space for SVG elements.
  */

package/core/utils/shortcut_formatting.d.ts

@@ -7,18 +7,16 @@
  * Find the primary shortcut for this platform and return it as single string
  * in a short user facing format.
  *
- * @internal
- * @param action The action name, e.g. "cut".
+ * @param shortcutName The keyboard shortcut name, e.g. "cut".
  * @returns The formatted shortcut.
  */
-export declare function getShortActionShortcut(action: string): string;
+export declare function getShortcutKeysShort(shortcutName: string): string;
 /**
- * Find the relevant shortcuts for the given action for the current platform.
+ * Find the relevant shortcuts for the given shortcut for the current platform.
  * Keys are returned in a long user facing format, e.g. "Command ⌘ Option ⌥ C"
  *
- * @internal
- * @param action The action name, e.g. "cut".
+ * @param shortcutName The keyboard shortcut name, e.g. "cut".
  * @returns The formatted shortcuts as individual keys.
  */
-export declare function getLongActionShortcutsAsKeys(action: string): string[][];
+export declare function getShortcutKeysLong(shortcutName: string): string[][];
 //# sourceMappingURL=shortcut_formatting.d.ts.map

package/core/variables.d.ts

@@ -109,7 +109,7 @@ export declare function generateUniqueNameFromOptions(startChar: string, usedNam
  * @param opt_type The type of the variable like 'int', 'string', or ''. This
  *     will default to '', which is a specific type.
  */
-export declare function createVariableButtonHandler(workspace: Workspace, opt_callback?: (p1?: string | null) => void, opt_type?: string): void;
+export declare function createVariableButtonHandler(workspace: WorkspaceSvg, opt_callback?: (p1?: string | null) => void, opt_type?: string): void;
 /**
  * Opens a prompt that allows the user to enter a new name for a variable.
  * Triggers a rename if the new name is valid. Or re-prompts if there is a

package/core/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