blockly 11.0.0-beta.0 → 11.0.0-beta.10

package/core/gesture.d.ts

@@ -11,15 +11,15 @@
  */
 import './events/events_click.js';
 import type { BlockSvg } from './block_svg.js';
-import { BubbleDragger } from './bubble_dragger.js';
 import type { Field } from './field.js';
-import type { IBlockDragger } from './interfaces/i_block_dragger.js';
 import type { IBubble } from './interfaces/i_bubble.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
 import { Coordinate } from './utils/coordinate.js';
 import { WorkspaceDragger } from './workspace_dragger.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 import type { IIcon } from './interfaces/i_icon.js';
+import { IDragger } from './interfaces/i_dragger.js';
+import { RenderedWorkspaceComment } from './comments.js';
 /**
  * Class for one gesture.
  */
@@ -52,6 +52,11 @@ export declare class Gesture {
      * block.
      */
     private startBlock;
+    /**
+     * The comment that the gesture started on, or null if it did not start on a
+     * comment.
+     */
+    private startComment;
     /**
      * The block that this gesture targets.  If the gesture started on a
      * shadow block, this is the first non-shadow parent of the block.  If the
@@ -77,15 +82,14 @@ export declare class Gesture {
      * Ex: [[node, name, func], [node, name, func]].
      */
     private boundEvents;
-    /** The object tracking a bubble drag, or null if none is in progress. */
-    private bubbleDragger;
-    /** The object tracking a block drag, or null if none is in progress. */
-    private blockDragger;
+    private dragger;
     /**
      * The object tracking a workspace or flyout workspace drag, or null if none
      * is in progress.
      */
     private workspaceDragger;
+    /** Whether the gesture is dragging or not. */
+    private dragging;
     /** The flyout a gesture started in, if any. */
     private flyout;
     /** Boolean for sanity-checking that some code is only called once. */
@@ -94,7 +98,6 @@ export declare class Gesture {
     private gestureHasStarted;
     /** Boolean used internally to break a cycle in disposal. */
     protected isEnding_: boolean;
-    private healStack;
     /** The event that most recently updated this gesture. */
     private mostRecentEvent;
     /** Boolean for whether or not this gesture is a multi-touch gesture. */
@@ -158,30 +161,6 @@ export declare class Gesture {
      * @returns True if a block is being dragged from the flyout.
      */
     private updateIsDraggingFromFlyout;
-    /**
-     * Update this gesture to record whether a bubble is being dragged.
-     * This function should be called on a pointermove event the first time
-     * the drag radius is exceeded.  It should be called no more than once per
-     * gesture. If a bubble should be dragged this function creates the necessary
-     * BubbleDragger and starts the drag.
-     *
-     * @returns True if a bubble is being dragged.
-     */
-    private updateIsDraggingBubble;
-    /**
-     * Check whether to start a block drag. If a block should be dragged, either
-     * from the flyout or in the workspace, create the necessary BlockDragger and
-     * start the drag.
-     *
-     * This function should be called on a pointermove event the first time
-     * the drag radius is exceeded.  It should be called no more than once per
-     * gesture. If a block should be dragged, either from the flyout or in the
-     * workspace, this function creates the necessary BlockDragger and starts the
-     * drag.
-     *
-     * @returns True if a block is being dragged.
-     */
-    private updateIsDraggingBlock;
     /**
      * Check whether to start a workspace drag. If a workspace is being dragged,
      * create the necessary WorkspaceDragger and start the drag.
@@ -199,10 +178,7 @@ export declare class Gesture {
      * gesture.
      */
     private updateIsDragging;
-    /** Create a block dragger and start dragging the selected block. */
-    private startDraggingBlock;
-    /** Create a bubble dragger and start dragging the selected bubble. */
-    private startDraggingBubble;
+    private createDragger;
     /**
      * Start a gesture: update the workspace to indicate that a gesture is in
      * progress and bind pointermove and pointerup handlers.
@@ -335,8 +311,14 @@ export declare class Gesture {
      * @internal
      */
     handleBubbleStart(e: PointerEvent, bubble: IBubble): void;
-    /** Execute a bubble click. */
-    private doBubbleClick;
+    /**
+     * Handle a pointerdown event on a workspace comment.
+     *
+     * @param e A pointerdown event.
+     * @param comment The comment the event hit.
+     * @internal
+     */
+    handleCommentStart(e: PointerEvent, comment: RenderedWorkspaceComment): void;
     /** Execute a field click. */
     private doFieldClick;
     /** Execute an icon click. */
@@ -376,6 +358,13 @@ export declare class Gesture {
      * @internal
      */
     setStartBubble(bubble: IBubble): void;
+    /**
+     * Record the comment that a gesture started on
+     *
+     * @param comment The comment the gesture started on.
+     * @internal
+     */
+    setStartComment(comment: RenderedWorkspaceComment): void;
     /**
      * Record the block that a gesture started on, and set the target block
      * appropriately.
@@ -411,6 +400,7 @@ export declare class Gesture {
      * @returns Whether this gesture was a click on a bubble.
      */
     private isBubbleClick;
+    private isCommentClick;
     /**
      * Whether this gesture is a click on a block.  This should only be called
      * when ending a gesture (pointerup).
@@ -434,6 +424,8 @@ export declare class Gesture {
      * @returns Whether this gesture was a click on a workspace.
      */
     private isWorkspaceClick;
+    /** Returns the current dragger if the gesture is a drag. */
+    getCurrentDragger(): WorkspaceDragger | IDragger | null;
     /**
      * Whether this gesture is a drag of either a workspace or block.
      * This function is called externally to block actions that cannot be taken
@@ -452,22 +444,6 @@ export declare class Gesture {
      * @internal
      */
     hasStarted(): boolean;
-    /**
-     * Get a list of the insertion markers that currently exist.  Block drags have
-     * 0, 1, or 2 insertion markers.
-     *
-     * @returns A possibly empty list of insertion marker blocks.
-     * @internal
-     */
-    getInsertionMarkers(): BlockSvg[];
-    /**
-     * Gets the current dragger if an item is being dragged. Null if nothing is
-     * being dragged.
-     *
-     * @returns The dragger that is currently in use or null if no drag is in
-     *     progress.
-     */
-    getCurrentDragger(): WorkspaceDragger | BubbleDragger | IBlockDragger | null;
     /**
      * Is a drag or other gesture currently in progress on any workspace?
      *

package/core/grid.d.ts

@@ -9,11 +9,12 @@ import { GridOptions } from './options.js';
  */
 export declare class Grid {
     private pattern;
-    private readonly spacing;
-    private readonly length;
+    private spacing;
+    private length;
+    private scale;
     private readonly line1;
     private readonly line2;
-    private readonly snapToGrid;
+    private snapToGrid;
     /**
      * @param pattern The grid's SVG pattern, created during injection.
      * @param options A dictionary of normalized options for the grid.
@@ -22,19 +23,39 @@ export declare class Grid {
      */
     constructor(pattern: SVGElement, options: GridOptions);
     /**
-     * Whether blocks should snap to the grid, based on the initial configuration.
+     * Sets the spacing between the centers of the grid lines.
      *
-     * @returns True if blocks should snap, false otherwise.
-     * @internal
+     * This does not trigger snapping to the newly spaced grid. If you want to
+     * snap blocks to the grid programmatically that needs to be triggered
+     * on individual top-level blocks. The next time a block is dragged and
+     * dropped it will snap to the grid if snapping to the grid is enabled.
      */
-    shouldSnap(): boolean;
+    setSpacing(spacing: number): void;
     /**
      * Get the spacing of the grid points (in px).
      *
      * @returns The spacing of the grid points.
-     * @internal
      */
     getSpacing(): number;
+    /** Sets the length of the grid lines. */
+    setLength(length: number): void;
+    /** Get the length of the grid lines (in px). */
+    getLength(): number;
+    /**
+     * Sets whether blocks should snap to the grid or not.
+     *
+     * Setting this to true does not trigger snapping. If you want to snap blocks
+     * to the grid programmatically that needs to be triggered on individual
+     * top-level blocks. The next time a block is dragged and dropped it will
+     * snap to the grid.
+     */
+    setSnapToGrid(snap: boolean): void;
+    /**
+     * Whether blocks should snap to the grid.
+     *
+     * @returns True if blocks should snap, false otherwise.
+     */
+    shouldSnap(): boolean;
     /**
      * Get the ID of the pattern element, which should be randomized to avoid
      * conflicts with other Blockly instances on the page.

package/core/icons/comment_icon.d.ts

@@ -16,7 +16,7 @@ import { Size } from '../utils/size.js';
 export declare class CommentIcon extends Icon implements IHasBubble, ISerializable {
     protected readonly sourceBlock: Block;
     /** The type string used to identify this icon. */
-    static readonly TYPE: IconType<CommentIcon>;
+    static readonly TYPE: IconType<import("../interfaces/i_comment_icon.js").ICommentIcon>;
     /**
      * The weight this icon has relative to other icons. Icons with more positive
      * weight values are rendered farther toward the end of the block.
@@ -49,7 +49,7 @@ export declare class CommentIcon extends Icon implements IHasBubble, ISerializab
      * Updates the state of the bubble (editable / noneditable) to reflect the
      * state of the bubble if the bubble is currently shown.
      */
-    updateEditable(): void;
+    updateEditable(): Promise<void>;
     onLocationChange(blockOrigin: Coordinate): void;
     /** Sets the text of this comment. Updates any bubbles if they are visible. */
     setText(text: string): void;
@@ -82,7 +82,7 @@ export declare class CommentIcon extends Icon implements IHasBubble, ISerializab
      */
     onSizeChange(): void;
     bubbleIsVisible(): boolean;
-    setBubbleVisible(visible: boolean): void;
+    setBubbleVisible(visible: boolean): Promise<void>;
     /**
      * Shows the editable text bubble for this comment, and adds change listeners
      * to update the state of this icon in response to changes in the bubble.
@@ -103,10 +103,15 @@ export declare class CommentIcon extends Icon implements IHasBubble, ISerializab
      */
     private getBubbleOwnerRect;
 }
+/** The save state format for a comment icon. */
 export interface CommentState {
+    /** The text of the comment. */
     text?: string;
+    /** True if the comment is open, false otherwise. */
     pinned?: boolean;
+    /** The height of the comment bubble. */
     height?: number;
+    /** The width of the comment bubble. */
     width?: number;
 }
 //# sourceMappingURL=comment_icon.d.ts.map

package/core/icons/icon.d.ts

@@ -59,11 +59,5 @@ export declare abstract class Icon implements IIcon {
      * @returns Whether the icon should be clickable while the block is in a flyout.
      */
     isClickableInFlyout(autoClosingFlyout: boolean): boolean;
-    /**
-     * Sets the visibility of the icon's bubble if one exists.
-     *
-     * @deprecated Use `setBubbleVisible` instead. To be removed in v11.
-     */
-    setVisible(visibility: boolean): void;
 }
 //# sourceMappingURL=icon.d.ts.map

package/core/icons/icon_types.d.ts

@@ -3,8 +3,8 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { ICommentIcon } from '../interfaces/i_comment_icon.js';
 import { IIcon } from '../interfaces/i_icon.js';
-import { CommentIcon } from './comment_icon.js';
 import { MutatorIcon } from './mutator_icon.js';
 import { WarningIcon } from './warning_icon.js';
 /**
@@ -20,6 +20,6 @@ export declare class IconType<_T extends IIcon> {
     equals(type: IconType<IIcon>): boolean;
     static MUTATOR: IconType<MutatorIcon>;
     static WARNING: IconType<WarningIcon>;
-    static COMMENT: IconType<CommentIcon>;
+    static COMMENT: IconType<ICommentIcon>;
 }
 //# sourceMappingURL=icon_types.d.ts.map

package/core/icons/mutator_icon.d.ts

@@ -4,9 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Abstract } from '../events/events_abstract.js';
-import type { Block } from '../block.js';
 import type { BlockSvg } from '../block_svg.js';
-import type { Connection } from '../connection.js';
 import { Coordinate } from '../utils/coordinate.js';
 import type { IHasBubble } from '../interfaces/i_has_bubble.js';
 import { Icon } from './icon.js';
@@ -55,7 +53,7 @@ export declare class MutatorIcon extends Icon implements IHasBubble {
     onClick(): void;
     isClickableInFlyout(): boolean;
     bubbleIsVisible(): boolean;
-    setBubbleVisible(visible: boolean): void;
+    setBubbleVisible(visible: boolean): Promise<void>;
     /** @returns the configuration the mini workspace should have. */
     private getMiniWorkspaceConfig;
     /**
@@ -91,18 +89,5 @@ export declare class MutatorIcon extends Icon implements IHasBubble {
      *     currently open.
      */
     getWorkspace(): WorkspaceSvg | undefined;
-    /**
-     * Reconnects the given connection to the mutated input on the given block.
-     *
-     * @deprecated Use connection.reconnect instead. To be removed in v11.
-     */
-    static reconnect(connectionChild: Connection | null, block: Block, inputName: string): boolean;
-    /**
-     * Returns the parent workspace of a workspace that is inside a mini workspace
-     * bubble, taking into account whether the workspace is a flyout.
-     *
-     * @deprecated Use workspace.getRootWorkspace. To be removed in v11.
-     */
-    static findParentWs(workspace: WorkspaceSvg): WorkspaceSvg | null;
 }
 //# sourceMappingURL=mutator_icon.d.ts.map

package/core/icons/warning_icon.d.ts

@@ -59,7 +59,7 @@ export declare class WarningIcon extends Icon implements IHasBubble {
     onClick(): void;
     isClickableInFlyout(): boolean;
     bubbleIsVisible(): boolean;
-    setBubbleVisible(visible: boolean): void;
+    setBubbleVisible(visible: boolean): Promise<void>;
     /**
      * @returns the location the bubble should be anchored to.
      *     I.E. the middle of this icon.

package/core/inputs/input.d.ts

@@ -15,13 +15,14 @@ import type { Connection } from '../connection.js';
 import type { ConnectionType } from '../connection_type.js';
 import type { Field } from '../field.js';
 import { inputTypes } from './input_types.js';
+import { Align } from './align.js';
 /** Class for an input with optional fields. */
 export declare class Input {
     name: string;
     private sourceBlock;
     fieldRow: Field[];
     /** Alignment of input's fields (left, right or centre). */
-    align: Input.Align;
+    align: Align;
     /** Is the input visible? */
     private visible;
     readonly type: inputTypes;
@@ -121,6 +122,14 @@ export declare class Input {
     getShadowDom(): Element | null;
     /** Initialize the fields on this input. */
     init(): void;
+    /**
+     * Initializes the fields on this input for a headless block.
+     *
+     * @internal
+     */
+    initModel(): void;
+    /** Initializes the given field. */
+    private initField;
     /**
      * Sever all links to this input.
      */
@@ -135,22 +144,4 @@ export declare class Input {
      */
     protected makeConnection(type: ConnectionType): Connection;
 }
-export declare namespace Input {
-    /**
-     * Enum for alignment of inputs.
-     *
-     * @deprecated Use Blockly.inputs.Align. To be removed in v11.
-     */
-    enum Align {
-        LEFT = -1,
-        CENTRE = 0,
-        RIGHT = 1
-    }
-}
-/** @deprecated Use Blockly.inputs.Align. To be removed in v11. */
-/** @suppress {deprecated} */
-export type Align = Input.Align;
-/** @deprecated Use Blockly.inputs.Align. To be removed in v11. */
-/** @suppress {deprecated} */
-export declare const Align: typeof Input.Align;
 //# sourceMappingURL=input.d.ts.map

package/core/insertion_marker_manager.d.ts

@@ -10,6 +10,8 @@ import type { Coordinate } from './utils/coordinate.js';
  * Class that controls updates to connections during drags.  It is primarily
  * responsible for finding the closest eligible connection and highlighting or
  * unhighlighting it as needed during a drag.
+ *
+ * @deprecated v10 - Use an IConnectionPreviewer instead.
  */
 export declare class InsertionMarkerManager {
     /**

package/core/insertion_marker_previewer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BlockSvg } from './block_svg.js';
+import { IConnectionPreviewer } from './interfaces/i_connection_previewer.js';
+import { RenderedConnection } from './rendered_connection.js';
+export declare class InsertionMarkerPreviewer implements IConnectionPreviewer {
+    private readonly workspace;
+    private fadedBlock;
+    private markerConn;
+    private draggedConn;
+    private staticConn;
+    constructor(draggedBlock: BlockSvg);
+    /**
+     * Display a connection preview where the draggedCon connects to the
+     * staticCon, replacing the replacedBlock (currently connected to the
+     * staticCon).
+     *
+     * @param draggedConn The connection on the block stack being dragged.
+     * @param staticConn The connection not being dragged that we are
+     *     connecting to.
+     * @param replacedBlock The block currently connected to the staticCon that
+     *     is being replaced.
+     */
+    previewReplacement(draggedConn: RenderedConnection, staticConn: RenderedConnection, replacedBlock: BlockSvg): void;
+    /**
+     * Display a connection preview where the draggedCon connects to the
+     * staticCon, and no block is being relaced.
+     *
+     * @param draggedConn The connection on the block stack being dragged.
+     * @param staticConn The connection not being dragged that we are
+     *     connecting to.
+     */
+    previewConnection(draggedConn: RenderedConnection, staticConn: RenderedConnection): void;
+    private shouldUseMarkerPreview;
+    private previewMarker;
+    private createInsertionMarker;
+    /**
+     * Gets the connection on the marker block that matches the original
+     * connection on the original block.
+     *
+     * @param orig The original block.
+     * @param marker The marker block (where we want to find the matching
+     *     connection).
+     * @param origConn The original connection.
+     */
+    private getMatchingConnection;
+    /** Hide any previews that are currently displayed. */
+    hidePreview(): void;
+    private hideInsertionMarker;
+    /** Dispose of any references held by this connection previewer. */
+    dispose(): void;
+}
+//# sourceMappingURL=insertion_marker_previewer.d.ts.map

package/core/interfaces/i_comment_icon.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CommentState } from '../icons/comment_icon.js';
+import { IIcon } from './i_icon.js';
+import { Size } from '../utils/size.js';
+import { IHasBubble } from './i_has_bubble.js';
+import { ISerializable } from './i_serializable.js';
+export interface ICommentIcon extends IIcon, IHasBubble, ISerializable {
+    setText(text: string): void;
+    getText(): string;
+    setBubbleSize(size: Size): void;
+    getBubbleSize(): Size;
+    saveState(): CommentState;
+    loadState(state: CommentState): void;
+}
+/** Checks whether the given object is an ICommentIcon. */
+export declare function isCommentIcon(obj: Object): obj is ICommentIcon;
+//# sourceMappingURL=i_comment_icon.d.ts.map

package/core/interfaces/i_connection_previewer.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from '../block_svg';
+import type { RenderedConnection } from '../rendered_connection';
+/**
+ * Displays visual "previews" of where a block will be connected if it is
+ * dropped.
+ */
+export interface IConnectionPreviewer {
+    /**
+     * Display a connection preview where the draggedCon connects to the
+     * staticCon, replacing the replacedBlock (currently connected to the
+     * staticCon).
+     *
+     * @param draggedCon The connection on the block stack being dragged.
+     * @param staticCon The connection not being dragged that we are
+     *     connecting to.
+     * @param replacedBlock The block currently connected to the staticCon that
+     *     is being replaced.
+     */
+    previewReplacement(draggedConn: RenderedConnection, staticConn: RenderedConnection, replacedBlock: BlockSvg): void;
+    /**
+     * Display a connection preview where the draggedCon connects to the
+     * staticCon, and no block is being relaced.
+     *
+     * @param draggedCon The connection on the block stack being dragged.
+     * @param staticCon The connection not being dragged that we are
+     *     connecting to.
+     */
+    previewConnection(draggedConn: RenderedConnection, staticConn: RenderedConnection): void;
+    /** Hide any previews that are currently displayed. */
+    hidePreview(): void;
+    /** Dispose of any references held by this connection previewer. */
+    dispose(): void;
+}
+//# sourceMappingURL=i_connection_previewer.d.ts.map

package/core/interfaces/i_deletable.d.ts

@@ -13,5 +13,11 @@ export interface IDeletable {
      * @returns True if deletable.
      */
     isDeletable(): boolean;
+    /** Disposes of this object, cleaning up any references or DOM elements. */
+    dispose(): void;
+    /** Visually indicates that the object is pending deletion. */
+    setDeleteStyle(wouldDelete: boolean): void;
 }
+/** Returns whether the given object is an IDeletable. */
+export declare function isDeletable(obj: any): obj is IDeletable;
 //# sourceMappingURL=i_deletable.d.ts.map

package/core/interfaces/i_delete_area.d.ts

@@ -17,10 +17,9 @@ export interface IDeleteArea extends IDragTarget {
      * before onDragEnter/onDragOver/onDragExit.
      *
      * @param element The block or bubble currently being dragged.
-     * @param couldConnect Whether the element could could connect to another.
      * @returns Whether the element provided would be deleted if dropped on this
      *     area.
      */
-    wouldDelete(element: IDraggable, couldConnect: boolean): boolean;
+    wouldDelete(element: IDraggable): boolean;
 }
 //# sourceMappingURL=i_delete_area.d.ts.map

package/core/interfaces/i_draggable.d.ts

@@ -3,10 +3,54 @@
  * Copyright 2021 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { IDeletable } from './i_deletable.js';
+import { Coordinate } from '../utils/coordinate';
 /**
- * The interface for an object that can be dragged.
+ * Represents an object that can be dragged.
  */
-export interface IDraggable extends IDeletable {
+export interface IDraggable extends IDragStrategy {
+    /**
+     * Returns the current location of the draggable in workspace
+     * coordinates.
+     *
+     * @returns Coordinate of current location on workspace.
+     */
+    getRelativeToSurfaceXY(): Coordinate;
 }
+export interface IDragStrategy {
+    /** Returns true iff the element is currently movable. */
+    isMovable(): boolean;
+    /**
+     * Handles any drag startup (e.g moving elements to the front of the
+     * workspace).
+     *
+     * @param e PointerEvent that started the drag; can be used to
+     *     check modifier keys, etc.  May be missing when dragging is
+     *     triggered programatically rather than by user.
+     */
+    startDrag(e?: PointerEvent): void;
+    /**
+     * Handles moving elements to the new location, and updating any
+     * visuals based on that (e.g connection previews for blocks).
+     *
+     * @param newLoc Workspace coordinate to which the draggable has
+     *     been dragged.
+     * @param e PointerEvent that continued the drag.  Can be
+     *     used to check modifier keys, etc.
+     */
+    drag(newLoc: Coordinate, e?: PointerEvent): void;
+    /**
+     * Handles any drag cleanup, including e.g. connecting or deleting
+     * blocks.
+     *
+     * @param newLoc Workspace coordinate at which the drag finished.
+     *     been dragged.
+     * @param e PointerEvent that finished the drag.  Can be
+     *     used to check modifier keys, etc.
+     */
+    endDrag(e?: PointerEvent): void;
+    /** Moves the draggable back to where it was at the start of the drag. */
+    revertDrag(): void;
+}
+/** Returns whether the given object is an IDraggable or not. */
+export declare function isDraggable(obj: any): obj is IDraggable;
 //# sourceMappingURL=i_draggable.d.ts.map

package/core/interfaces/i_dragger.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Coordinate } from '../utils/coordinate';
+export interface IDragger {
+    /**
+     * Handles any drag startup.
+     *
+     * @param e PointerEvent that started the drag.
+     */
+    onDragStart(e: PointerEvent): void;
+    /**
+     * Handles dragging, including calculating where the element should
+     * actually be moved to.
+     *
+     * @param e PointerEvent that continued the drag.
+     * @param totalDelta The total distance, in pixels, that the mouse
+     *     has moved since the start of the drag.
+     */
+    onDrag(e: PointerEvent, totalDelta: Coordinate): void;
+    /**
+     * Handles any drag cleanup.
+     *
+     * @param e PointerEvent that finished the drag.
+     * @param totalDelta The total distance, in pixels, that the mouse
+     *     has moved since the start of the drag.
+     */
+    onDragEnd(e: PointerEvent, totalDelta: Coordinate): void;
+}
+//# sourceMappingURL=i_dragger.d.ts.map

package/core/interfaces/i_has_bubble.d.ts

@@ -7,7 +7,7 @@ export interface IHasBubble {
     /** @returns True if the bubble is currently open, false otherwise. */
     bubbleIsVisible(): boolean;
     /** Sets whether the bubble is open or not. */
-    setBubbleVisible(visible: boolean): void;
+    setBubbleVisible(visible: boolean): Promise<void>;
 }
 /** Type guard that checks whether the given object is a IHasBubble. */
 export declare function hasBubble(obj: any): obj is IHasBubble;