blockly 12.0.0-beta.4 → 12.0.0-beta.5

package/core/navigator.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { INavigable } from './interfaces/i_navigable.js';
+import type { INavigationPolicy } from './interfaces/i_navigation_policy.js';
+/**
+ * Class responsible for determining where focus should move in response to
+ * keyboard navigation commands.
+ */
+export declare class Navigator {
+    /**
+     * Map from classes to a corresponding ruleset to handle navigation from
+     * instances of that class.
+     */
+    private rules;
+    /**
+     * Associates a navigation ruleset with its corresponding class.
+     *
+     * @param key The class whose object instances should have their navigation
+     *     controlled by the associated policy.
+     * @param policy A ruleset that determines where focus should move starting
+     *     from an instance of the given class.
+     */
+    set<T extends INavigable<T>>(key: new (...args: any) => T, policy: INavigationPolicy<T>): void;
+    /**
+     * Returns the navigation ruleset associated with the given object instance's
+     * class.
+     *
+     * @param key An object to retrieve a navigation ruleset for.
+     * @returns The navigation ruleset of objects of the given object's class, or
+     *     undefined if no ruleset has been registered for the object's class.
+     */
+    private get;
+    /**
+     * Returns the first child of the given object instance, if any.
+     *
+     * @param current The object to retrieve the first child of.
+     * @returns The first child node of the given object, if any.
+     */
+    getFirstChild<T extends INavigable<T>>(current: T): INavigable<any> | null;
+    /**
+     * Returns the parent of the given object instance, if any.
+     *
+     * @param current The object to retrieve the parent of.
+     * @returns The parent node of the given object, if any.
+     */
+    getParent<T extends INavigable<T>>(current: T): INavigable<any> | null;
+    /**
+     * Returns the next sibling of the given object instance, if any.
+     *
+     * @param current The object to retrieve the next sibling node of.
+     * @returns The next sibling node of the given object, if any.
+     */
+    getNextSibling<T extends INavigable<T>>(current: T): INavigable<any> | null;
+    /**
+     * Returns the previous sibling of the given object instance, if any.
+     *
+     * @param current The object to retrieve the previous sibling node of.
+     * @returns The previous sibling node of the given object, if any.
+     */
+    getPreviousSibling<T extends INavigable<T>>(current: T): INavigable<any> | null;
+}
+//# sourceMappingURL=navigator.d.ts.map

package/core/rendered_connection.d.ts

@@ -11,11 +11,15 @@
 import type { Block } from './block.js';
 import type { BlockSvg } from './block_svg.js';
 import { Connection } from './connection.js';
+import { IContextMenu } from './interfaces/i_contextmenu.js';
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
+import type { IFocusableTree } from './interfaces/i_focusable_tree.js';
+import type { INavigable } from './interfaces/i_navigable.js';
 import { Coordinate } from './utils/coordinate.js';
 /**
  * Class for a connection between blocks that may be rendered on screen.
  */
-export declare class RenderedConnection extends Connection {
+export declare class RenderedConnection extends Connection implements IContextMenu, IFocusableNode, INavigable<RenderedConnection> {
     sourceBlock_: BlockSvg;
     private readonly db;
     private readonly dbOpposite;
@@ -216,6 +220,36 @@ export declare class RenderedConnection extends Connection {
      * @returns The connection being modified (to allow chaining).
      */
     setCheck(check: string | string[] | null): RenderedConnection;
+    /**
+     * Handles showing the context menu when it is opened on a connection.
+     * Note that typically the context menu can't be opened with the mouse
+     * on a connection, because you can't select a connection. But keyboard
+     * users may open the context menu with a keyboard shortcut.
+     *
+     * @param e Event that triggered the opening of the context menu.
+     */
+    showContextMenu(e: Event): void;
+    /** See IFocusableNode.getFocusableElement. */
+    getFocusableElement(): HTMLElement | SVGElement;
+    /** See IFocusableNode.getFocusableTree. */
+    getFocusableTree(): IFocusableTree;
+    /** See IFocusableNode.onNodeFocus. */
+    onNodeFocus(): void;
+    /** See IFocusableNode.onNodeBlur. */
+    onNodeBlur(): void;
+    private findHighlightSvg;
+    /**
+     * Returns whether or not this connection is keyboard-navigable.
+     *
+     * @returns True.
+     */
+    isNavigable(): boolean;
+    /**
+     * Returns this connection's class for keyboard navigation.
+     *
+     * @returns RenderedConnection.
+     */
+    getClass(): typeof RenderedConnection;
 }
 export declare namespace RenderedConnection {
     /**

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

@@ -29,7 +29,6 @@ import { Types } from '../measurables/types.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';
 import { PathObject } from './path_object.js';
 import { Renderer } from './renderer.js';
 /**
@@ -59,6 +58,6 @@ export declare function unregister(name: string): void;
 export declare function init(name: string, theme: Theme, opt_rendererOverrides?: {
     [rendererConstant: string]: any;
 }): Renderer;
-export { BottomRow, Connection, Drawer, ExternalValueInput, Field, Hat, Icon, InlineInput, InputConnection, InputRow, InRowSpacer, IPathObject, JaggedEdge, MarkerSvg, Measurable, NextConnection, OutputConnection, PathObject, PreviousConnection, Renderer, RenderInfo, RoundCorner, Row, SpacerRow, SquareCorner, StatementInput, TopRow, Types, };
+export { BottomRow, Connection, Drawer, ExternalValueInput, Field, Hat, Icon, InlineInput, InputConnection, InputRow, InRowSpacer, IPathObject, JaggedEdge, Measurable, NextConnection, OutputConnection, PathObject, PreviousConnection, Renderer, RenderInfo, RoundCorner, Row, SpacerRow, SquareCorner, StatementInput, TopRow, Types, };
 export { BaseShape, ConstantProvider, DynamicShape, InsideCorners, JaggedTeeth, Notch, OutsideCorners, PuzzleTab, StartHat, } from './constants.js';
 //# sourceMappingURL=block_rendering.d.ts.map

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

@@ -141,7 +141,7 @@ export declare class Drawer {
      */
     protected updateConnectionHighlights(): void;
     /** Returns a path to highlight the given connection. */
-    drawConnectionHighlightPath(measurable: Connection): void;
+    drawConnectionHighlightPath(measurable: Connection): SVGElement | undefined;
     /**
      * Returns a path to highlight the given conneciton, assuming it is an
      * input or output connection.

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,25 @@ 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 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,13 @@ 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;
 }
 //# 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/variable_map.d.ts

@@ -44,7 +44,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 +98,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 +143,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

@@ -184,9 +184,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 +195,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 +208,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 +217,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 +225,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 +235,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 +244,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 +253,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[];