blockly 12.0.0-beta.4 → 12.0.0-beta.6

package/core/renderers/common/i_path_object.d.ts

@@ -23,16 +23,6 @@ export interface IPathObject {
     constants: ConstantProvider;
     /** The primary path of the block. */
     style: BlockStyle;
-    /**
-     * Holds the cursors SVG element when the cursor is attached to the block.
-     * This is null if there is no cursor on the block.
-     */
-    cursorSvg: SVGElement | null;
-    /**
-     * Holds the markers SVG element when the marker is attached to the block.
-     * This is null if there is no marker on the block.
-     */
-    markerSvg: SVGElement | null;
     /**
      * Set the path generated by the renderer onto the respective SVG element.
      *
@@ -43,20 +33,6 @@ export interface IPathObject {
      * Flip the SVG paths in RTL.
      */
     flipRTL(): void;
-    /**
-     * Add the cursor SVG to this block's SVG group.
-     *
-     * @param cursorSvg The SVG root of the cursor to be added to the block SVG
-     *     group.
-     */
-    setCursorSvg(cursorSvg: SVGElement): void;
-    /**
-     * Add the marker SVG to this block's SVG group.
-     *
-     * @param markerSvg The SVG root of the marker to be added to the block SVG
-     *     group.
-     */
-    setMarkerSvg(markerSvg: SVGElement): void;
     /**
      * Set whether the block shows a highlight or not.  Block highlighting is
      * often used to visually mark blocks currently being executed.
@@ -90,7 +66,7 @@ export interface IPathObject {
      */
     updateMovable(enabled: boolean): void;
     /** Adds the given path as a connection highlight for the given connection. */
-    addConnectionHighlight?(connection: RenderedConnection, connectionPath: string, offset: Coordinate, rtl: boolean): void;
+    addConnectionHighlight?(connection: RenderedConnection, connectionPath: string, offset: Coordinate, rtl: boolean): SVGElement;
     /**
      * Apply the stored colours to the block's path, taking into account whether
      * the paths belong to a shadow block.

package/core/renderers/common/path_object.d.ts

@@ -17,16 +17,6 @@ import type { IPathObject } from './i_path_object.js';
 export declare class PathObject implements IPathObject {
     svgRoot: SVGElement;
     svgPath: SVGElement;
-    /**
-     * Holds the cursors svg element when the cursor is attached to the block.
-     * This is null if there is no cursor on the block.
-     */
-    cursorSvg: SVGElement | null;
-    /**
-     * Holds the markers svg element when the marker is attached to the block.
-     * This is null if there is no marker on the block.
-     */
-    markerSvg: SVGElement | null;
     constants: ConstantProvider;
     style: BlockStyle;
     /** Highlight paths associated with connections. */
@@ -49,20 +39,6 @@ export declare class PathObject implements IPathObject {
      * Flip the SVG paths in RTL.
      */
     flipRTL(): void;
-    /**
-     * Add the cursor SVG to this block's SVG group.
-     *
-     * @param cursorSvg The SVG root of the cursor to be added to the block SVG
-     *     group.
-     */
-    setCursorSvg(cursorSvg: SVGElement): void;
-    /**
-     * Add the marker SVG to this block's SVG group.
-     *
-     * @param markerSvg The SVG root of the marker to be added to the block SVG
-     *     group.
-     */
-    setMarkerSvg(markerSvg: SVGElement): void;
     /**
      * Apply the stored colours to the block's path, taking into account whether
      * the paths belong to a shadow block.
@@ -145,8 +121,7 @@ export declare class PathObject implements IPathObject {
      */
     updateShapeForInputHighlight(_conn: Connection, _enable: boolean): void;
     /** Adds the given path as a connection highlight for the given connection. */
-    addConnectionHighlight(connection: RenderedConnection, connectionPath: string, offset: Coordinate, rtl: boolean): void;
-    private currentHighlightMatchesNew;
+    addConnectionHighlight(connection: RenderedConnection, connectionPath: string, offset: Coordinate, rtl: boolean): SVGElement;
     /**
      * Removes any highlight associated with the given connection, if it exists.
      */

package/core/renderers/common/renderer.d.ts

@@ -6,14 +6,11 @@
 import type { BlockSvg } from '../../block_svg.js';
 import { Connection } from '../../connection.js';
 import type { IRegistrable } from '../../interfaces/i_registrable.js';
-import type { Marker } from '../../keyboard_nav/marker.js';
 import type { BlockStyle, Theme } from '../../theme.js';
-import type { WorkspaceSvg } from '../../workspace_svg.js';
 import { ConstantProvider } from './constants.js';
 import { Drawer } from './drawer.js';
 import type { IPathObject } from './i_path_object.js';
 import { RenderInfo } from './info.js';
-import { MarkerSvg } from './marker_svg.js';
 /**
  * The base class for a block renderer.
  */
@@ -98,14 +95,6 @@ export declare class Renderer implements IRegistrable {
      * @returns The drawer.
      */
     protected makeDrawer_(block: BlockSvg, info: RenderInfo): Drawer;
-    /**
-     * Create a new instance of the renderer's marker drawer.
-     *
-     * @param workspace The workspace the marker belongs to.
-     * @param marker The marker.
-     * @returns The object in charge of drawing the marker.
-     */
-    makeMarkerDrawer(workspace: WorkspaceSvg, marker: Marker): MarkerSvg;
     /**
      * Create a new instance of a renderer path object.
      *

package/core/renderers/zelos/drawer.d.ts

@@ -46,6 +46,6 @@ export declare class Drawer extends BaseDrawer {
     private getInlineInputPath;
     drawStatementInput_(row: Row): void;
     /** Returns a path to highlight the given connection. */
-    drawConnectionHighlightPath(measurable: Connection): void;
+    drawConnectionHighlightPath(measurable: Connection): SVGElement | undefined;
 }
 //# sourceMappingURL=drawer.d.ts.map

package/core/renderers/zelos/renderer.d.ts

@@ -4,15 +4,12 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { BlockSvg } from '../../block_svg.js';
-import type { Marker } from '../../keyboard_nav/marker.js';
 import type { BlockStyle } from '../../theme.js';
-import type { WorkspaceSvg } from '../../workspace_svg.js';
 import type { RenderInfo as BaseRenderInfo } from '../common/info.js';
 import { Renderer as BaseRenderer } from '../common/renderer.js';
 import { ConstantProvider } from './constants.js';
 import { Drawer } from './drawer.js';
 import { RenderInfo } from './info.js';
-import { MarkerSvg } from './marker_svg.js';
 import { PathObject } from './path_object.js';
 /**
  * The zelos renderer. This renderer emulates Scratch-style and MakeCode-style
@@ -48,14 +45,6 @@ export declare class Renderer extends BaseRenderer {
      * @returns The drawer.
      */
     protected makeDrawer_(block: BlockSvg, info: BaseRenderInfo): Drawer;
-    /**
-     * Create a new instance of the renderer's cursor drawer.
-     *
-     * @param workspace The workspace the cursor belongs to.
-     * @param marker The marker.
-     * @returns The object in charge of drawing the marker.
-     */
-    makeMarkerDrawer(workspace: WorkspaceSvg, marker: Marker): MarkerSvg;
     /**
      * Create a new instance of a renderer path object.
      *

package/core/renderers/zelos/zelos.d.ts

@@ -7,12 +7,11 @@
 import { ConstantProvider } from './constants.js';
 import { Drawer } from './drawer.js';
 import { RenderInfo } from './info.js';
-import { MarkerSvg } from './marker_svg.js';
 import { BottomRow } from './measurables/bottom_row.js';
 import { StatementInput } from './measurables/inputs.js';
 import { RightConnectionShape } from './measurables/row_elements.js';
 import { TopRow } from './measurables/top_row.js';
 import { PathObject } from './path_object.js';
 import { Renderer } from './renderer.js';
-export { BottomRow, ConstantProvider, Drawer, MarkerSvg, PathObject, Renderer, RenderInfo, RightConnectionShape, StatementInput, TopRow, };
+export { BottomRow, ConstantProvider, Drawer, PathObject, Renderer, RenderInfo, RightConnectionShape, StatementInput, TopRow, };
 //# sourceMappingURL=zelos.d.ts.map

package/core/shortcut_registry.d.ts

@@ -9,6 +9,7 @@
  *
  * @class
  */
+import { Scope } from './contextmenu_registry.js';
 import { KeyCodes } from './utils/keycodes.js';
 import { WorkspaceSvg } from './workspace_svg.js';
 /**
@@ -183,12 +184,14 @@ export declare namespace ShortcutRegistry {
          * @param e The event that caused the shortcut to be activated.
          * @param shortcut The `KeyboardShortcut` that was activated
          *     (i.e., the one this callback is attached to).
+         * @param scope Information about the focused item when the
+         * shortcut was invoked.
          * @returns Returning true ends processing of the invoked keycode.
          *     Returning false causes processing to continue with the
          *     next-most-recently registered shortcut for the invoked
          *     keycode.
          */
-        callback?: (workspace: WorkspaceSvg, e: Event, shortcut: KeyboardShortcut) => boolean;
+        callback?: (workspace: WorkspaceSvg, e: Event, shortcut: KeyboardShortcut, scope: Scope) => boolean;
         /** The name of the shortcut.  Should be unique. */
         name: string;
         /**
@@ -198,9 +201,11 @@ export declare namespace ShortcutRegistry {
          *
          * @param workspace The `WorkspaceSvg` where the shortcut was
          *     invoked.
+         * @param scope Information about the focused item when the
+         * shortcut would be invoked.
          * @returns True iff `callback` function should be called.
          */
-        preconditionFn?: (workspace: WorkspaceSvg) => boolean;
+        preconditionFn?: (workspace: WorkspaceSvg, scope: Scope) => boolean;
         /** Optional arbitray extra data attached to the shortcut. */
         metadata?: object;
         /**

package/core/toast.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { WorkspaceSvg } from './workspace_svg.js';
+/**
+ * Display/configuration options for a toast notification.
+ */
+export interface ToastOptions {
+    /**
+     * Toast ID. If set along with `oncePerSession`, will cause subsequent toasts
+     * with this ID to not be shown.
+     */
+    id?: string;
+    /**
+     * Flag to show the toast once per session only.
+     * Subsequent calls are ignored.
+     */
+    oncePerSession?: boolean;
+    /**
+     * Text of the message to display on the toast.
+     */
+    message: string;
+    /**
+     * Duration in seconds before the toast is removed. Defaults to 5.
+     */
+    duration?: number;
+    /**
+     * How prominently/interrupting the readout of the toast should be for
+     * screenreaders. Corresponds to aria-live and defaults to polite.
+     */
+    assertiveness?: Toast.Assertiveness;
+}
+/**
+ * Class that allows for showing and dismissing temporary notifications.
+ */
+export declare class Toast {
+    /** IDs of toasts that have previously been shown. */
+    private static shownIds;
+    /**
+     * Shows a toast notification.
+     *
+     * @param workspace The workspace to show the toast on.
+     * @param options Configuration options for the toast message, duration, etc.
+     */
+    static show(workspace: WorkspaceSvg, options: ToastOptions): void;
+    /**
+     * Creates the DOM representation of a toast.
+     *
+     * @param workspace The workspace to inject the toast notification onto.
+     * @param options Configuration options for the toast.
+     * @returns The root DOM element of the toast.
+     */
+    protected static createDom(workspace: WorkspaceSvg, options: ToastOptions): HTMLDivElement;
+    /**
+     * Dismiss a toast, e.g. in response to a user action.
+     *
+     * @param workspace The workspace to dismiss a toast in.
+     * @param id The toast ID, or undefined to clear any toast.
+     */
+    static hide(workspace: WorkspaceSvg, id?: string): void;
+}
+/**
+ * Options for how aggressively toasts should be read out by screenreaders.
+ * Values correspond to those for aria-live.
+ */
+export declare namespace Toast {
+    enum Assertiveness {
+        ASSERTIVE = "assertive",
+        POLITE = "polite"
+    }
+}
+//# sourceMappingURL=toast.d.ts.map

package/core/toolbox/toolbox.d.ts

@@ -9,6 +9,8 @@ import '../events/events_toolbox_item_select.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 { IFocusableTree } from '../interfaces/i_focusable_tree.js';
 import type { IKeyboardAccessible } from '../interfaces/i_keyboard_accessible.js';
 import type { ISelectableToolboxItem } from '../interfaces/i_selectable_toolbox_item.js';
 import type { IStyleable } from '../interfaces/i_styleable.js';
@@ -22,7 +24,7 @@ import type { WorkspaceSvg } from '../workspace_svg.js';
  * Class for a Toolbox.
  * Creates the toolbox's DOM.
  */
-export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeyboardAccessible, IStyleable, IToolbox {
+export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeyboardAccessible, IStyleable, IToolbox, IFocusableNode {
     /**
      * The unique ID for this component that is used to register with the
      * ComponentManager.
@@ -389,5 +391,27 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     private selectPrevious;
     /** Disposes of this toolbox. */
     dispose(): void;
+    /** See IFocusableNode.getFocusableElement. */
+    getFocusableElement(): HTMLElement | SVGElement;
+    /** See IFocusableNode.getFocusableTree. */
+    getFocusableTree(): IFocusableTree;
+    /** See IFocusableNode.onNodeFocus. */
+    onNodeFocus(): void;
+    /** See IFocusableNode.onNodeBlur. */
+    onNodeBlur(): void;
+    /** See IFocusableNode.canBeFocused. */
+    canBeFocused(): boolean;
+    /** See IFocusableTree.getRootFocusableNode. */
+    getRootFocusableNode(): IFocusableNode;
+    /** See IFocusableTree.getRestoredFocusableNode. */
+    getRestoredFocusableNode(previousNode: IFocusableNode | null): IFocusableNode | null;
+    /** See IFocusableTree.getNestedTrees. */
+    getNestedTrees(): Array<IFocusableTree>;
+    /** See IFocusableTree.lookUpFocusableNode. */
+    lookUpFocusableNode(id: string): IFocusableNode | null;
+    /** See IFocusableTree.onTreeFocus. */
+    onTreeFocus(node: IFocusableNode, _previousTree: IFocusableTree | null): void;
+    /** See IFocusableTree.onTreeBlur. */
+    onTreeBlur(_nextTree: IFocusableTree | null): void;
 }
 //# sourceMappingURL=toolbox.d.ts.map

package/core/toolbox/toolbox_item.d.ts

@@ -9,6 +9,7 @@
  * @class
  */
 import type { ICollapsibleToolboxItem } from '../interfaces/i_collapsible_toolbox_item.js';
+import type { IFocusableTree } from '../interfaces/i_focusable_tree.js';
 import type { IToolbox } from '../interfaces/i_toolbox.js';
 import type { IToolboxItem } from '../interfaces/i_toolbox_item.js';
 import type * as toolbox from '../utils/toolbox.js';
@@ -94,5 +95,15 @@ export declare class ToolboxItem implements IToolboxItem {
      * @param _isVisible True if category should be visible.
      */
     setVisible_(_isVisible: boolean): void;
+    /** See IFocusableNode.getFocusableElement. */
+    getFocusableElement(): HTMLElement | SVGElement;
+    /** See IFocusableNode.getFocusableTree. */
+    getFocusableTree(): IFocusableTree;
+    /** See IFocusableNode.onNodeFocus. */
+    onNodeFocus(): void;
+    /** See IFocusableNode.onNodeBlur. */
+    onNodeBlur(): void;
+    /** See IFocusableNode.canBeFocused. */
+    canBeFocused(): boolean;
 }
 //# sourceMappingURL=toolbox_item.d.ts.map

package/core/utils/aria.d.ts

@@ -20,7 +20,8 @@ export declare enum Role {
     ROW = "row",
     TREE = "tree",
     TREEITEM = "treeitem",
-    SEPARATOR = "separator"
+    SEPARATOR = "separator",
+    STATUS = "status"
 }
 /**
  * ARIA states and properties.
@@ -41,7 +42,9 @@ export declare enum State {
     SELECTED = "selected",
     SETSIZE = "setsize",
     VALUEMAX = "valuemax",
-    VALUEMIN = "valuemin"
+    VALUEMIN = "valuemin",
+    LIVE = "live",
+    HIDDEN = "hidden"
 }
 /**
  * Sets the role of an element.

package/core/utils/object.d.ts

@@ -6,6 +6,9 @@
 /**
  * Complete a deep merge of all members of a source object with a target object.
  *
+ * N.B. This is not a very sophisticated merge algorithm and does not
+ * handle complex cases. Use with caution.
+ *
  * @param target Target.
  * @param source Source.
  * @returns The resulting object.

package/core/variable_map.d.ts

@@ -21,14 +21,19 @@ import type { Workspace } from './workspace.js';
  */
 export declare class VariableMap implements IVariableMap<IVariableModel<IVariableState>> {
     workspace: Workspace;
+    potentialMap: boolean;
     /**
      * A map from variable type to map of IDs to variables. The maps contain
      * all of the named variables in the workspace, including variables that are
      * not currently in use.
      */
     private variableMap;
-    /** @param workspace The workspace this map belongs to. */
-    constructor(workspace: Workspace);
+    /**
+     * @param workspace The workspace this map belongs to.
+     * @param potentialMap True if this holds variables that don't exist in the
+     *  workspace yet.
+     */
+    constructor(workspace: Workspace, potentialMap?: boolean);
     /** Clear the variable map.  Fires events for every deletion. */
     clear(): void;
     /**
@@ -44,7 +49,7 @@ export declare class VariableMap implements IVariableMap<IVariableModel<IVariabl
      * Rename a variable by updating its name in the variable map. Identify the
      * variable to rename with the given ID.
      *
-     * @deprecated v12, use VariableMap.renameVariable.
+     * @deprecated v12: use VariableMap.renameVariable.
      * @param id ID of the variable to rename.
      * @param newName New variable name.
      */
@@ -98,7 +103,7 @@ export declare class VariableMap implements IVariableMap<IVariableModel<IVariabl
      * Delete a variables by the passed in ID and all of its uses from this
      * workspace. May prompt the user for confirmation.
      *
-     * @deprecated v12, use Blockly.Variables.deleteVariable.
+     * @deprecated v12: use Blockly.Variables.deleteVariable.
      * @param id ID of variable to delete.
      */
     deleteVariableById(id: string): void;
@@ -143,14 +148,14 @@ export declare class VariableMap implements IVariableMap<IVariableModel<IVariabl
     /**
      * Returns all of the variable names of all types.
      *
-     * @deprecated v12, use Blockly.Variables.getAllVariables.
+     * @deprecated v12: use Blockly.Variables.getAllVariables.
      * @returns All of the variable names of all types.
      */
     getAllVariableNames(): string[];
     /**
      * Find all the uses of a named variable.
      *
-     * @deprecated v12, use Blockly.Variables.getVariableUsesById.
+     * @deprecated v12: use Blockly.Variables.getVariableUsesById.
      * @param id ID of the variable to find.
      * @returns Array of block usages.
      */

package/core/variables.d.ts

@@ -19,8 +19,9 @@ export declare const CATEGORY_NAME = "VARIABLE";
 /**
  * Find all user-created variables that are in use in the workspace.
  * For use by generators.
+ *
  * To get a list of all variables on a workspace, including unused variables,
- * call Workspace.getAllVariables.
+ * call getAllVariables.
  *
  * @param ws The workspace to search for variables.
  * @returns Array of variable models.
@@ -28,6 +29,7 @@ export declare const CATEGORY_NAME = "VARIABLE";
 export declare function allUsedVarModels(ws: Workspace): IVariableModel<IVariableState>[];
 /**
  * Find all developer variables used by blocks in the workspace.
+ *
  * Developer variables are never shown to the user, but are declared as global
  * variables in the generated code.
  * To declare developer variables, define the getDeveloperVariables function on

package/core/workspace.d.ts

@@ -13,7 +13,6 @@ import type { Block } from './block.js';
 import { WorkspaceComment } from './comments/workspace_comment.js';
 import type { ConnectionDB } from './connection_db.js';
 import type { Abstract } from './events/events_abstract.js';
-import type { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
 import type { IConnectionChecker } from './interfaces/i_connection_checker.js';
 import { IProcedureMap } from './interfaces/i_procedure_map.js';
 import type { IVariableMap } from './interfaces/i_variable_map.js';
@@ -24,7 +23,7 @@ import type * as toolbox from './utils/toolbox.js';
  * Class for a workspace.  This is a data structure that contains blocks.
  * There is no UI, and can be created headlessly.
  */
-export declare class Workspace implements IASTNodeLocation {
+export declare class Workspace {
     /**
      * Angle away from the horizontal to sweep for blocks.  Order of execution is
      * generally top to bottom, but a small angle changes the scan to give a bit
@@ -184,9 +183,10 @@ export declare class Workspace implements IASTNodeLocation {
     /** Dispose of all blocks and comments in workspace. */
     clear(): void;
     /**
-     * @deprecated v12 - Rename a variable by updating its name in the variable
+     * Rename a variable by updating its name in the variable
      * map. Identify the variable to rename with the given ID.
      *
+     * @deprecated v12: use Blockly.Workspace.getVariableMap().renameVariable
      * @param id ID of the variable to rename.
      * @param newName New variable name.
      */
@@ -194,7 +194,7 @@ export declare class Workspace implements IASTNodeLocation {
     /**
      * Create a variable with a given name, optional type, and optional ID.
      *
-     * @deprecated v12, use Blockly.Workspace.getVariableMap().createVariable.
+     * @deprecated v12: use Blockly.Workspace.getVariableMap().createVariable.
      * @param name The name of the variable. This must be unique across variables
      *     and procedures.
      * @param opt_type The type of the variable like 'int' or 'string'.
@@ -207,7 +207,7 @@ export declare class Workspace implements IASTNodeLocation {
     /**
      * Find all the uses of the given variable, which is identified by ID.
      *
-     * @deprecated v12, use Blockly.Workspace.getVariableMap().getVariableUsesById
+     * @deprecated v12: use Blockly.Workspace.getVariableMap().getVariableUsesById
      * @param id ID of the variable to find.
      * @returns Array of block usages.
      */
@@ -216,7 +216,7 @@ export declare class Workspace implements IASTNodeLocation {
      * Delete a variables by the passed in ID and all of its uses from this
      * workspace. May prompt the user for confirmation.
      *
-     * @deprecated v12, use Blockly.Workspace.getVariableMap().deleteVariable.
+     * @deprecated v12: use Blockly.Workspace.getVariableMap().deleteVariable.
      * @param id ID of variable to delete.
      */
     deleteVariableById(id: string): void;
@@ -224,7 +224,7 @@ export declare class Workspace implements IASTNodeLocation {
      * Find the variable by the given name and return it. Return null if not
      * found.
      *
-     * @deprecated v12, use Blockly.Workspace.getVariableMap().getVariable.
+     * @deprecated v12: use Blockly.Workspace.getVariableMap().getVariable.
      * @param name The name to check for.
      * @param opt_type The type of the variable.  If not provided it defaults to
      *     the empty string, which is a specific type.
@@ -234,7 +234,7 @@ export declare class Workspace implements IASTNodeLocation {
     /**
      * Find the variable by the given ID and return it. Return null if not found.
      *
-     * @deprecated v12, use Blockly.Workspace.getVariableMap().getVariableById.
+     * @deprecated v12: use Blockly.Workspace.getVariableMap().getVariableById.
      * @param id The ID to check for.
      * @returns The variable with the given ID.
      */
@@ -243,7 +243,7 @@ export declare class Workspace implements IASTNodeLocation {
      * Find the variable with the specified type. If type is null, return list of
      *     variables with empty string type.
      *
-     * @deprecated v12, use Blockly.Workspace.getVariableMap().getVariablesOfType.
+     * @deprecated v12: use Blockly.Workspace.getVariableMap().getVariablesOfType.
      * @param type Type of the variables to find.
      * @returns The sought after variables of the passed in type. An empty array
      *     if none are found.
@@ -252,14 +252,14 @@ export declare class Workspace implements IASTNodeLocation {
     /**
      * Return all variables of all types.
      *
-     * @deprecated v12, use Blockly.Workspace.getVariableMap().getAllVariables.
+     * @deprecated v12: use Blockly.Workspace.getVariableMap().getAllVariables.
      * @returns List of variable models.
      */
     getAllVariables(): IVariableModel<IVariableState>[];
     /**
      * Returns all variable names of all types.
      *
-     * @deprecated v12, use Blockly.Workspace.getVariableMap().getAllVariables.
+     * @deprecated v12: use Blockly.Workspace.getVariableMap().getAllVariables.
      * @returns List of all variable names of all types.
      */
     getAllVariableNames(): string[];

package/core/workspace_dragger.d.ts

@@ -3,6 +3,11 @@
  * Copyright 2017 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+/**
+ * Methods for dragging a workspace visually.
+ *
+ * @class
+ */
 import { Coordinate } from './utils/coordinate.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**