blockly 11.1.1 → 11.2.0-beta.1

package/core/interfaces/i_legacy_procedure_blocks.d.ts

@@ -23,12 +23,12 @@ export interface LegacyProcedureDefBlock {
     getProcedureDef: () => ProcedureTuple;
 }
 /** @internal */
-export declare function isLegacyProcedureDefBlock(block: Object): block is LegacyProcedureDefBlock;
+export declare function isLegacyProcedureDefBlock(block: object): block is LegacyProcedureDefBlock;
 /** @internal */
 export interface LegacyProcedureCallBlock {
     getProcedureCall: () => string;
     renameProcedure: (p1: string, p2: string) => void;
 }
 /** @internal */
-export declare function isLegacyProcedureCallBlock(block: Object): block is LegacyProcedureCallBlock;
+export declare function isLegacyProcedureCallBlock(block: object): block is LegacyProcedureCallBlock;
 //# sourceMappingURL=i_legacy_procedure_blocks.d.ts.map

package/core/interfaces/i_metrics_manager.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2021 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { ContainerRegion, ToolboxMetrics, AbsoluteMetrics, UiMetrics } from '../metrics_manager.js';
-import type { Size } from '../utils/size.js';
+import type { AbsoluteMetrics, ContainerRegion, ToolboxMetrics, UiMetrics } from '../metrics_manager.js';
 import type { Metrics } from '../utils/metrics.js';
+import type { Size } from '../utils/size.js';
 /**
  * Interface for a metrics manager.
  */

package/core/interfaces/i_positionable.d.ts

@@ -3,8 +3,8 @@
  * Copyright 2021 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { Rect } from '../utils/rect.js';
 import type { UiMetrics } from '../metrics_manager.js';
+import type { Rect } from '../utils/rect.js';
 import type { IComponent } from './i_component.js';
 /**
  * Interface for a component that is positioned on top of the workspace.

package/core/interfaces/i_selectable.d.ts

@@ -16,5 +16,5 @@ export interface ISelectable {
     unselect(): void;
 }
 /** Checks whether the given object is an ISelectable. */
-export declare function isSelectable(obj: Object): obj is ISelectable;
+export declare function isSelectable(obj: object): obj is ISelectable;
 //# sourceMappingURL=i_selectable.d.ts.map

package/core/interfaces/i_serializer.d.ts

@@ -24,7 +24,7 @@ export interface ISerializer {
      * @returns A JS object containing the system's state, or null if there is no
      *     state to record.
      */
-    save(workspace: Workspace): Object | null;
+    save(workspace: Workspace): object | null;
     /**
      * Loads the state of the plugin or system.
      *
@@ -33,7 +33,7 @@ export interface ISerializer {
      * @param workspace The workspace the system to deserialize is associated
      *     with.
      */
-    load(state: Object, workspace: Workspace): void;
+    load(state: object, workspace: Workspace): void;
     /**
      * Clears the state of the plugin or system.
      *

package/core/interfaces/i_toolbox.d.ts

@@ -3,11 +3,11 @@
  * Copyright 2020 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { IRegistrable } from './i_registrable.js';
-import type { IToolboxItem } from './i_toolbox_item.js';
 import type { ToolboxInfo } from '../utils/toolbox.js';
-import type { IFlyout } from './i_flyout.js';
 import type { WorkspaceSvg } from '../workspace_svg.js';
+import type { IFlyout } from './i_flyout.js';
+import type { IRegistrable } from './i_registrable.js';
+import type { IToolboxItem } from './i_toolbox_item.js';
 /**
  * Interface for a toolbox.
  */

package/core/keyboard_nav/ast_node.d.ts

@@ -12,11 +12,11 @@
 import { Block } from '../block.js';
 import type { Connection } from '../connection.js';
 import type { Field } from '../field.js';
+import { FlyoutButton } from '../flyout_button.js';
 import type { Input } from '../inputs/input.js';
 import type { IASTNodeLocation } from '../interfaces/i_ast_node_location.js';
 import { Coordinate } from '../utils/coordinate.js';
 import type { Workspace } from '../workspace.js';
-import { FlyoutButton } from '../flyout_button.js';
 /**
  * Class for an AST node.
  * It is recommended that you use one of the createNode methods instead of

package/core/layer_manager.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { WorkspaceSvg } from './workspace_svg.js';
 import { IRenderedElement } from './interfaces/i_rendered_element.js';
 import { Coordinate } from './utils/coordinate.js';
+import { WorkspaceSvg } from './workspace_svg.js';
 /** @internal */
 export declare class LayerManager {
     private workspace;

package/core/layers.d.ts

@@ -6,13 +6,11 @@
 /**
  * The layer to place blocks on.
  *
- * @internal
  */
 export declare const BLOCK = 50;
 /**
  * The layer to place bubbles on.
  *
- * @internal
  */
 export declare const BUBBLE = 100;
 //# sourceMappingURL=layers.d.ts.map

package/core/procedures.d.ts

@@ -7,11 +7,11 @@ import './events/events_block_change.js';
 import type { Block } from './block.js';
 import type { Abstract } from './events/events_abstract.js';
 import { Field } from './field.js';
+import { ProcedureTuple } from './interfaces/i_legacy_procedure_blocks.js';
 import { IParameterModel } from './interfaces/i_parameter_model.js';
+import { IProcedureBlock, isProcedureBlock } from './interfaces/i_procedure_block.js';
 import { IProcedureMap } from './interfaces/i_procedure_map.js';
 import { IProcedureModel } from './interfaces/i_procedure_model.js';
-import { IProcedureBlock, isProcedureBlock } from './interfaces/i_procedure_block.js';
-import { ProcedureTuple } from './interfaces/i_legacy_procedure_blocks.js';
 import { ObservableProcedureMap } from './observable_procedure_map.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
@@ -101,5 +101,5 @@ export declare function mutateCallers(defBlock: Block): void;
  * @returns The procedure definition block, or null not found.
  */
 export declare function getDefinition(name: string, workspace: Workspace): Block | null;
-export { ObservableProcedureMap, IParameterModel, IProcedureBlock, isProcedureBlock, IProcedureMap, IProcedureModel, ProcedureTuple, };
+export { IParameterModel, IProcedureBlock, IProcedureMap, IProcedureModel, isProcedureBlock, ObservableProcedureMap, ProcedureTuple, };
 //# sourceMappingURL=procedures.d.ts.map

package/core/registry.d.ts

@@ -5,11 +5,15 @@
  */
 import type { Abstract } from './events/events_abstract.js';
 import type { Field } from './field.js';
+import type { Input } from './inputs/input.js';
 import type { IConnectionChecker } from './interfaces/i_connection_checker.js';
+import type { IConnectionPreviewer } from './interfaces/i_connection_previewer.js';
+import type { ICopyable } from './interfaces/i_copyable.js';
+import type { IDragger } from './interfaces/i_dragger.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
-import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
 import type { IIcon } from './interfaces/i_icon.js';
-import type { Input } from './inputs/input.js';
+import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
+import type { IPaster } from './interfaces/i_paster.js';
 import type { ISerializer } from './interfaces/i_serializer.js';
 import type { IToolbox } from './interfaces/i_toolbox.js';
 import type { Cursor } from './keyboard_nav/cursor.js';
@@ -17,10 +21,6 @@ import type { Options } from './options.js';
 import type { Renderer } from './renderers/common/renderer.js';
 import type { Theme } from './theme.js';
 import type { ToolboxItem } from './toolbox/toolbox_item.js';
-import type { IPaster } from './interfaces/i_paster.js';
-import type { ICopyable } from './interfaces/i_copyable.js';
-import type { IConnectionPreviewer } from './interfaces/i_connection_previewer.js';
-import type { IDragger } from './interfaces/i_dragger.js';
 export declare const TEST_ONLY: {
     typeMap: {
         [key: string]: {

package/core/rendered_connection.d.ts

@@ -60,10 +60,15 @@ export declare class RenderedConnection extends Connection {
      * Move the block(s) belonging to the connection to a point where they don't
      * visually interfere with the specified connection.
      *
-     * @param staticConnection The connection to move away from.
+     * @param superiorConnection The connection to move away from. The provided
+     *     connection should be the superior connection and should not be
+     *     connected to this connection.
+     * @param initiatedByThis Whether or not the block group that was manipulated
+     *     recently causing bump checks is associated with the inferior
+     *     connection. Defaults to false.
      * @internal
      */
-    bumpAwayFrom(staticConnection: RenderedConnection): void;
+    bumpAwayFrom(superiorConnection: RenderedConnection, initiatedByThis?: boolean): void;
     /**
      * Change the connection's coordinates.
      *
@@ -162,11 +167,11 @@ export declare class RenderedConnection extends Connection {
      * Bumps this connection away from the other connection. Called when an
      * attempted connection fails.
      *
-     * @param otherConnection Connection that this connection failed to connect
-     *     to.
+     * @param superiorConnection Connection that this connection failed to connect
+     *     to. The provided connection should be the superior connection.
      * @internal
      */
-    onFailedConnect(otherConnection: Connection): void;
+    onFailedConnect(superiorConnection: Connection): void;
     /**
      * Disconnect two blocks that are connected by this connection.
      *

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

@@ -39,7 +39,7 @@ import { Renderer } from './renderer.js';
  * @param rendererClass The new renderer class to register.
  * @throws {Error} if a renderer with the same name has already been registered.
  */
-export declare function register(name: string, rendererClass: Function): void;
+export declare function register(name: string, rendererClass: new (name: string) => Renderer): void;
 /**
  * Unregisters the renderer registered with the given name.
  *
@@ -59,33 +59,6 @@ export declare function unregister(name: string): void;
 export declare function init(name: string, theme: Theme, opt_rendererOverrides?: {
     [rendererConstant: string]: any;
 }): Renderer;
-export { BottomRow };
-export { Connection };
-export { Drawer };
-export { ExternalValueInput };
-export { Field };
-export { Hat };
-export { Icon };
-export { InRowSpacer };
-export { InlineInput };
-export { InputConnection };
-export { InputRow };
-export { IPathObject };
-export { JaggedEdge };
-export { MarkerSvg };
-export { Measurable };
-export { NextConnection };
-export { OutputConnection };
-export { PathObject };
-export { PreviousConnection };
-export { Renderer };
-export { RenderInfo };
-export { RoundCorner };
-export { Row };
-export { SpacerRow };
-export { SquareCorner };
-export { StatementInput };
-export { TopRow };
-export { Types };
-export { OutsideCorners, InsideCorners, StartHat, Notch, PuzzleTab, JaggedTeeth, BaseShape, DynamicShape, ConstantProvider, } from './constants.js';
+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 { BaseShape, ConstantProvider, DynamicShape, InsideCorners, JaggedTeeth, Notch, OutsideCorners, PuzzleTab, StartHat, } from './constants.js';
 //# sourceMappingURL=block_rendering.d.ts.map

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

@@ -3,11 +3,11 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { BlockStyle } from '../../theme.js';
 import type { BlockSvg } from '../../block_svg.js';
-import type { ConstantProvider } from './constants.js';
 import type { RenderedConnection } from '../../rendered_connection.js';
+import type { BlockStyle } from '../../theme.js';
 import type { Coordinate } from '../../utils/coordinate.js';
+import type { ConstantProvider } from './constants.js';
 /**
  * An interface for a block's path object.
  *

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

@@ -8,6 +8,7 @@ import { Input } from '../../inputs/input.js';
 import type { RenderedConnection } from '../../rendered_connection.js';
 import type { Measurable } from '../measurables/base.js';
 import { BottomRow } from '../measurables/bottom_row.js';
+import { Connection } from '../measurables/connection.js';
 import { InputRow } from '../measurables/input_row.js';
 import { OutputConnection } from '../measurables/output_connection.js';
 import type { Row } from '../measurables/row.js';
@@ -15,7 +16,6 @@ import { SpacerRow } from '../measurables/spacer_row.js';
 import { TopRow } from '../measurables/top_row.js';
 import type { ConstantProvider } from './constants.js';
 import type { Renderer } from './renderer.js';
-import { Connection } from '../measurables/connection.js';
 /**
  * An object containing all sizing information needed to draw this block.
  *

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

@@ -15,13 +15,13 @@ import type { ConstantProvider, Notch, PuzzleTab } from './constants.js';
  * SVG.
  */
 export declare class MarkerSvg {
-    private readonly workspace;
-    private readonly marker;
+    protected readonly workspace: WorkspaceSvg;
+    protected readonly marker: Marker;
     /**
      * The workspace, field, or block that the marker SVG element should be
      * attached to.
      */
-    private parent;
+    protected parent: IASTNodeLocationSvg | null;
     /** The current SVG element for the marker. */
     currentMarkerSvg: SVGElement | null;
     colour_: string;
@@ -94,7 +94,7 @@ export declare class MarkerSvg {
      *
      * @param curNode The node to draw the marker for.
      */
-    private showWithBlockPrevOutput;
+    protected showWithBlockPrevOutput(curNode: ASTNode): void;
     /**
      * Position and display the marker for a block.
      *
@@ -229,7 +229,7 @@ export declare class MarkerSvg {
      * @param oldNode The old node the marker used to be on.
      * @param curNode The new node the marker is currently on.
      */
-    private fireMarkerEvent;
+    protected fireMarkerEvent(oldNode: ASTNode, curNode: ASTNode): void;
     /**
      * Get the properties to make a marker blink.
      *

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

@@ -5,8 +5,8 @@
  */
 import type { RenderedConnection } from '../../rendered_connection.js';
 import type { Theme } from '../../theme.js';
-import { ConstantProvider as BaseConstantProvider } from '../common/constants.js';
 import type { Shape } from '../common/constants.js';
+import { ConstantProvider as BaseConstantProvider } from '../common/constants.js';
 /** An object containing sizing and path information about inside corners. */
 export interface InsideCorners {
     width: number;

package/core/serialization/procedures.d.ts

@@ -38,7 +38,7 @@ interface ProcedureModelConstructor<ProcedureModel extends IProcedureModel> {
      * @param workspace The workspace to load the procedure model into.
      * @returns The constructed procedure model.
      */
-    loadState(state: Object, workspace: Workspace): ProcedureModel;
+    loadState(state: object, workspace: Workspace): ProcedureModel;
 }
 /**
  * A newable signature for an IParameterModel.
@@ -56,7 +56,7 @@ interface ParameterModelConstructor<ParameterModel extends IParameterModel> {
      * @param workspace The workspace to load the parameter model into.
      * @returns The constructed parameter model.
      */
-    loadState(state: Object, workspace: Workspace): ParameterModel;
+    loadState(state: object, workspace: Workspace): ParameterModel;
 }
 /**
  * Serializes the given IProcedureModel to JSON.

package/core/serialization/workspace_comments.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { WorkspaceComment } from '../comments/workspace_comment.js';
 import { ISerializer } from '../interfaces/i_serializer.js';
 import { Workspace } from '../workspace.js';
-import type { WorkspaceComment } from '../comments/workspace_comment.js';
 export interface State {
     id?: string;
     text?: string;

package/core/serialization.d.ts

@@ -6,14 +6,14 @@
 /**
  * Serialization methods.
  */
+import { ISerializer } from './interfaces/i_serializer.js';
 import * as blocks from './serialization/blocks.js';
 import * as exceptions from './serialization/exceptions.js';
 import * as priorities from './serialization/priorities.js';
 import * as procedures from './serialization/procedures.js';
 import * as registry from './serialization/registry.js';
 import * as variables from './serialization/variables.js';
-import * as workspaces from './serialization/workspaces.js';
 import * as workspaceComments from './serialization/workspace_comments.js';
-import { ISerializer } from './interfaces/i_serializer.js';
-export { blocks, exceptions, priorities, procedures, registry, variables, workspaces, workspaceComments, ISerializer, };
+import * as workspaces from './serialization/workspaces.js';
+export { blocks, exceptions, ISerializer, priorities, procedures, registry, variables, workspaceComments, workspaces, };
 //# sourceMappingURL=serialization.d.ts.map

package/core/shortcut_registry.d.ts

@@ -30,13 +30,13 @@ export declare class ShortcutRegistry {
      * Registers a keyboard shortcut.
      *
      * @param shortcut The shortcut for this key code.
-     * @param opt_allowOverrides True to prevent a warning when overriding an
+     * @param allowOverrides True to prevent a warning when overriding an
      *     already registered item.
      * @throws {Error} if a shortcut with the same name already exists.
      */
-    register(shortcut: KeyboardShortcut, opt_allowOverrides?: boolean): void;
+    register(shortcut: KeyboardShortcut, allowOverrides?: boolean): void;
     /**
-     * Unregisters a keyboard shortcut registered with the given key code. This
+     * Unregisters a keyboard shortcut registered with the given name. This
      * will also remove any key mappings that reference this shortcut.
      *
      * @param shortcutName The name of the shortcut to unregister.
@@ -46,16 +46,23 @@ export declare class ShortcutRegistry {
     /**
      * Adds a mapping between a keycode and a keyboard shortcut.
      *
+     * Normally only one shortcut can be mapped to any given keycode,
+     * but setting allowCollisions to true allows a keyboard to be
+     * mapped to multiple shortcuts.  In that case, when onKeyDown is
+     * called with the given keystroke, it will process the mapped
+     * shortcuts in reverse order, from the most- to least-recently
+     * mapped).
+     *
      * @param keyCode The key code for the keyboard shortcut. If registering a key
      *     code with a modifier (ex: ctrl+c) use
      *     ShortcutRegistry.registry.createSerializedKey;
      * @param shortcutName The name of the shortcut to execute when the given
      *     keycode is pressed.
-     * @param opt_allowCollision True to prevent an error when adding a shortcut
+     * @param allowCollision True to prevent an error when adding a shortcut
      *     to a key that is already mapped to a shortcut.
      * @throws {Error} if the given key code is already mapped to a shortcut.
      */
-    addKeyMapping(keyCode: string | number | KeyCodes, shortcutName: string, opt_allowCollision?: boolean): void;
+    addKeyMapping(keyCode: string | number | KeyCodes, shortcutName: string, allowCollision?: boolean): void;
     /**
      * Removes a mapping between a keycode and a keyboard shortcut.
      *
@@ -64,11 +71,11 @@ export declare class ShortcutRegistry {
      *     ShortcutRegistry.registry.createSerializedKey;
      * @param shortcutName The name of the shortcut to execute when the given
      *     keycode is pressed.
-     * @param opt_quiet True to not console warn when there is no shortcut to
+     * @param quiet True to not console warn when there is no shortcut to
      *     remove.
      * @returns True if a key mapping was removed, false otherwise.
      */
-    removeKeyMapping(keyCode: string, shortcutName: string, opt_quiet?: boolean): boolean;
+    removeKeyMapping(keyCode: string, shortcutName: string, quiet?: boolean): boolean;
     /**
      * Removes all the key mappings for a shortcut with the given name.
      * Useful when changing the default key mappings and the key codes registered
@@ -105,6 +112,21 @@ export declare class ShortcutRegistry {
     /**
      * Handles key down events.
      *
+     * - Any `KeyboardShortcut`(s) mapped to the keycodes that cause
+     *   event `e` to be fired will be processed, in order from least-
+     *   to most-recently registered.
+     * - If the shortcut's `preconditionFn` exists it will be called.
+     *   If `preconditionFn` returns false the shortcut's `callback`
+     *   function will be skipped.  Processing will continue with the
+     *   next shortcut, if any.
+     * - The shortcut's `callback` function will then be called.  If it
+     *   returns true, processing will terminate and `onKeyDown` will
+     *   return true.  If it returns false, processing will continue
+     *   with with the next shortcut, if any.
+     * - If all registered shortcuts for the given keycode have been
+     *   processed without any having returned true, `onKeyDown` will
+     *   return false.
+     *
      * @param workspace The main workspace where the event was captured.
      * @param e The key down event.
      * @returns True if the event was handled, false otherwise.
@@ -145,18 +167,56 @@ export declare class ShortcutRegistry {
      *
      * @param keyCode Number code representing the key.
      * @param modifiers List of modifier key codes to be used with the key. All
-     *     valid modifiers can be found in the ShortcutRegistry.modifierKeys.
+     *     valid modifiers can be found in the `ShortcutRegistry.modifierKeys`.
      * @returns The serialized key code for the given modifiers and key.
      */
     createSerializedKey(keyCode: number, modifiers: KeyCodes[] | null): string;
 }
 export declare namespace ShortcutRegistry {
+    /** Interface defining a keyboard shortcut. */
     interface KeyboardShortcut {
-        callback?: (p1: WorkspaceSvg, p2: Event, p3: KeyboardShortcut) => boolean;
+        /**
+         * The function to be called when the shorctut is invoked.
+         *
+         * @param workspace The `WorkspaceSvg` when the shortcut was
+         *     invoked.
+         * @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).
+         * @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;
+        /** The name of the shortcut.  Should be unique. */
         name: string;
-        preconditionFn?: (p1: WorkspaceSvg) => boolean;
+        /**
+         * A function to be called when the shortcut is invoked, before
+         * calling `callback`, to decide if this shortcut is applicable in
+         * the current situation.
+         *
+         * @param workspace The `WorkspaceSvg` where the shortcut was
+         *     invoked.
+         * @returns True iff `callback` function should be called.
+         */
+        preconditionFn?: (workspace: WorkspaceSvg) => boolean;
+        /** Optional arbitray extra data attached to the shortcut. */
         metadata?: object;
+        /**
+         * Optional list of key codes to be bound (via
+         * ShortcutRegistry.prototype.addKeyMapping) to this shortcut.
+         */
         keyCodes?: (number | string)[];
+        /**
+         * Value of `allowCollision` to pass to `addKeyMapping` when
+         * binding this shortcut's `.keyCodes` (if any).
+         *
+         * N.B.: this is only used for binding keycodes at the time this
+         * shortcut is initially registered, not for any subsequent
+         * `addKeyMapping` calls that happen to reference this shortcut's
+         * name.
+         */
         allowCollision?: boolean;
     }
     /** Supported modifiers. */

package/core/toolbox/toolbox.d.ts

@@ -3,14 +3,9 @@
  * Copyright 2020 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Toolbox from whence to create blocks.
- *
- * @class
- */
-import '../events/events_toolbox_item_select.js';
 import * as browserEvents from '../browser_events.js';
 import { DeleteArea } from '../delete_area.js';
+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';

package/core/tooltip.d.ts

@@ -11,7 +11,7 @@
  */
 export type TipInfo = string | {
     tooltip: any;
-} | (() => TipInfo | string | Function);
+} | (() => TipInfo | string);
 /**
  * A function that renders custom tooltip UI.
  * 1st parameter: the div element to render content into.

package/core/trashcan.d.ts

@@ -3,13 +3,8 @@
  * Copyright 2011 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Object representing a trash can icon.
- *
- * @class
- */
-import './events/events_trashcan_open.js';
 import { DeleteArea } from './delete_area.js';
+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';

package/core/utils/drag.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { WorkspaceSvg } from '../workspace_svg.js';
+import { Coordinate } from './coordinate.js';
+/**
+ * Start tracking a drag of an object on this workspace by recording the offset
+ * between the pointer's current location and the object's starting location.
+ *
+ * Used for resizing block comments and workspace comments.
+ *
+ * @param workspace The workspace where the drag is occurring.
+ * @param e Pointer down event.
+ * @param xy Starting location of object.
+ */
+export declare function start(workspace: WorkspaceSvg, e: PointerEvent, xy: Coordinate): void;
+/**
+ * Compute the new position of a dragged object in this workspace based on the
+ * current pointer position and the offset between the pointer's starting
+ * location and the object's starting location.
+ *
+ * The start function should have be called previously, when the drag started.
+ *
+ * Used for resizing block comments and workspace comments.
+ *
+ * @param workspace The workspace where the drag is occurring.
+ * @param e Pointer move event.
+ * @returns New location of object.
+ */
+export declare function move(workspace: WorkspaceSvg, e: PointerEvent): Coordinate;
+//# sourceMappingURL=drag.d.ts.map

package/core/utils/rect.d.ts

@@ -10,6 +10,7 @@
  *
  * @class
  */
+import { Coordinate } from './coordinate.js';
 /**
  * Class for representing rectangular regions.
  */
@@ -25,7 +26,15 @@ export declare class Rect {
      * @param right Right.
      */
     constructor(top: number, bottom: number, left: number, right: number);
+    /**
+     * Creates a new copy of this rectangle.
+     *
+     * @returns A copy of this Rect.
+     */
+    clone(): Rect;
+    /** Returns the height of this rectangle. */
     getHeight(): number;
+    /** Returns the width of this rectangle. */
     getWidth(): number;
     /**
      * Tests whether this rectangle contains a x/y coordinate.
@@ -43,5 +52,22 @@ export declare class Rect {
      * @returns Whether this rectangle intersects the provided rectangle.
      */
     intersects(other: Rect): boolean;
+    /**
+     * Compares bounding rectangles for equality.
+     *
+     * @param a A Rect.
+     * @param b A Rect.
+     * @returns True iff the bounding rectangles are equal, or if both are null.
+     */
+    static equals(a?: Rect | null, b?: Rect | null): boolean;
+    /**
+     * Creates a new Rect using a position and supplied dimensions.
+     *
+     * @param position The upper left coordinate of the new rectangle.
+     * @param width The width of the rectangle, in pixels.
+     * @param height The height of the rectangle, in pixels.
+     * @returns A newly created Rect using the provided Coordinate and dimensions.
+     */
+    static createFromPoint(position: Coordinate, width: number, height: number): Rect;
 }
 //# sourceMappingURL=rect.d.ts.map