blockly 11.0.0-beta.6 → 11.0.0-beta.7

package/core/block.d.ts

@@ -17,7 +17,6 @@ import type { Abstract } from './events/events_abstract.js';
 import type { Field } from './field.js';
 import { Input } from './inputs/input.js';
 import type { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
-import type { IDeletable } from './interfaces/i_deletable.js';
 import { type IIcon } from './interfaces/i_icon.js';
 import type { MutatorIcon } from './icons/mutator_icon.js';
 import * as Tooltip from './tooltip.js';
@@ -30,7 +29,7 @@ import { IconType } from './icons/icon_types.js';
  * Class for one block.
  * Not normally called directly, workspace.newBlock() is preferred.
  */
-export declare class Block implements IASTNodeLocation, IDeletable {
+export declare class Block implements IASTNodeLocation {
     /**
      * An optional callback method to use whenever the block's parent workspace
      * changes. This is usually only called from the constructor, the block type
@@ -188,7 +187,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      *     statement with the previous statement.  Otherwise, dispose of all
      *     children of this block.
      */
-    dispose(healStack: boolean): void;
+    dispose(healStack?: boolean): void;
     /**
      * Disposes of this block without doing things required by the top block.
      * E.g. does not fire events, unplug the block, etc.

package/core/block_svg.d.ts

@@ -18,7 +18,7 @@ import type { Input } from './inputs/input.js';
 import type { IASTNodeLocationSvg } from './interfaces/i_ast_node_location_svg.js';
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
 import type { ICopyable } from './interfaces/i_copyable.js';
-import type { IDraggable } from './interfaces/i_draggable.js';
+import type { IDragStrategy, IDraggable } from './interfaces/i_draggable.js';
 import { IIcon } from './interfaces/i_icon.js';
 import { MutatorIcon } from './icons/mutator_icon.js';
 import { RenderedConnection } from './rendered_connection.js';
@@ -30,11 +30,13 @@ import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 import { IconType } from './icons/icon_types.js';
 import { BlockCopyData } from './clipboard/block_paster.js';
+import { IDeletable } from './blockly.js';
+import { FlyoutItemInfo } from './utils/toolbox.js';
 /**
  * Class for a block's SVG representation.
  * Not normally called directly, workspace.newBlock() is preferred.
  */
-export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBoundedElement, ICopyable<BlockCopyData>, IDraggable {
+export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBoundedElement, ICopyable<BlockCopyData>, IDraggable, IDeletable {
     /**
      * Constant for identifying rows that are to be rendered inline.
      * Don't collide with Blockly.inputTypes.
@@ -95,6 +97,7 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * @internal
      */
     relativeCoords: Coordinate;
+    private dragStrategy;
     /**
      * @param workspace The block's workspace.
      * @param prototypeName Name of the language object containing type-specific
@@ -120,15 +123,9 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * @returns #RRGGBB string.
      */
     getColourTertiary(): string | undefined;
-    /**
-     * Selects this block. Highlights the block visually and fires a select event
-     * if the block is not already selected.
-     */
+    /** Selects this block. Highlights the block visually. */
     select(): void;
-    /**
-     * Unselects this block. Unhighlights the block and fires a select (false)
-     * event if the block is currently selected.
-     */
+    /** Unselects this block. Unhighlights the blockv visually.   */
     unselect(): void;
     /**
      * Sets the parent of this block to be a new block or null.
@@ -647,5 +644,21 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * @internal
      */
     highlightShapeForInput(conn: RenderedConnection, add: boolean): void;
+    /** Sets the drag strategy for this block. */
+    setDragStrategy(dragStrategy: IDragStrategy): void;
+    /** Returns whether this block is movable or not. */
+    isMovable(): boolean;
+    /** Starts a drag on the block. */
+    startDrag(e?: PointerEvent): void;
+    /** Drags the block to the given location. */
+    drag(newLoc: Coordinate, e?: PointerEvent): void;
+    /** Ends the drag on the block. */
+    endDrag(e?: PointerEvent): void;
+    /** Moves the block back to where it was at the start of a drag. */
+    revertDrag(): void;
+    /**
+     * Returns a representation of this block that can be displayed in a flyout.
+     */
+    toFlyoutData(): FlyoutItemInfo[];
 }
 //# sourceMappingURL=block_svg.d.ts.map

package/core/blockly.d.ts

@@ -9,13 +9,11 @@ import './events/events_ui_base.js';
 import './events/events_var_create.js';
 import { Block } from './block.js';
 import * as blockAnimations from './block_animations.js';
-import { BlockDragger } from './block_dragger.js';
 import { BlockSvg } from './block_svg.js';
 import { BlocklyOptions } from './blockly_options.js';
 import { Blocks } from './blocks.js';
 import * as browserEvents from './browser_events.js';
 import * as bubbles from './bubbles.js';
-import { BubbleDragger } from './bubble_dragger.js';
 import * as bumpObjects from './bump_objects.js';
 import * as clipboard from './clipboard.js';
 import * as common from './common.js';
@@ -32,6 +30,7 @@ import * as comments from './comments.js';
 import * as Css from './css.js';
 import { DeleteArea } from './delete_area.js';
 import * as dialog from './dialog.js';
+import { Dragger } from './dragging/dragger.js';
 import { DragTarget } from './drag_target.js';
 import * as dropDownDiv from './dropdowndiv.js';
 import * as Events from './events/events.js';
@@ -64,7 +63,6 @@ import { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
 import { IASTNodeLocationSvg } from './interfaces/i_ast_node_location_svg.js';
 import { IASTNodeLocationWithBlock } from './interfaces/i_ast_node_location_with_block.js';
 import { IAutoHideable } from './interfaces/i_autohideable.js';
-import { IBlockDragger } from './interfaces/i_block_dragger.js';
 import { IBoundedElement } from './interfaces/i_bounded_element.js';
 import { IBubble } from './interfaces/i_bubble.js';
 import { ICollapsibleToolboxItem } from './interfaces/i_collapsible_toolbox_item.js';
@@ -73,10 +71,10 @@ import { IConnectionChecker } from './interfaces/i_connection_checker.js';
 import { IConnectionPreviewer } from './interfaces/i_connection_previewer.js';
 import { IContextMenu } from './interfaces/i_contextmenu.js';
 import { ICopyable, isCopyable } from './interfaces/i_copyable.js';
-import { IDeletable } from './interfaces/i_deletable.js';
+import { IDeletable, isDeletable } from './interfaces/i_deletable.js';
 import { IDeleteArea } from './interfaces/i_delete_area.js';
 import { IDragTarget } from './interfaces/i_drag_target.js';
-import { IDraggable } from './interfaces/i_draggable.js';
+import { IDraggable, isDraggable } from './interfaces/i_draggable.js';
 import { IFlyout } from './interfaces/i_flyout.js';
 import { IHasBubble, hasBubble } from './interfaces/i_has_bubble.js';
 import { IIcon, isIcon } from './interfaces/i_icon.js';
@@ -87,7 +85,7 @@ import { IObservable, isObservable } from './interfaces/i_observable.js';
 import { IPaster, isPaster } from './interfaces/i_paster.js';
 import { IPositionable } from './interfaces/i_positionable.js';
 import { IRegistrable } from './interfaces/i_registrable.js';
-import { ISelectable } from './interfaces/i_selectable.js';
+import { ISelectable, isSelectable } from './interfaces/i_selectable.js';
 import { ISelectableToolboxItem } from './interfaces/i_selectable_toolbox_item.js';
 import { ISerializable, isSerializable } from './interfaces/i_serializable.js';
 import { IStyleable } from './interfaces/i_styleable.js';
@@ -239,7 +237,6 @@ export declare const defineBlocksWithJsonArray: typeof common.defineBlocksWithJs
  */
 export declare const setParentContainer: typeof common.setParentContainer;
 export declare const COLLAPSE_CHARS = 30;
-export declare const DRAG_STACK = true;
 export declare const OPPOSITE_TYPE: number[];
 export declare const RENAME_VARIABLE_ID = "RENAME_VARIABLE_ID";
 export declare const DELETE_VARIABLE_ID = "DELETE_VARIABLE_ID";
@@ -297,11 +294,9 @@ export { ASTNode };
 export { BasicCursor };
 export { Block };
 export { BlocklyOptions };
-export { BlockDragger };
 export { BlockSvg };
 export { Blocks };
 export { bubbles };
-export { BubbleDragger };
 export { CollapsibleToolboxCategory };
 export { ComponentManager };
 export { Connection };
@@ -312,6 +307,7 @@ export { ContextMenuRegistry };
 export { comments };
 export { Cursor };
 export { DeleteArea };
+export { Dragger };
 export { DragTarget };
 export declare const DropDownDiv: typeof dropDownDiv;
 export { Field, FieldConfig, FieldValidator, UnattachedFieldError };
@@ -335,7 +331,6 @@ export { IASTNodeLocation };
 export { IASTNodeLocationSvg };
 export { IASTNodeLocationWithBlock };
 export { IAutoHideable };
-export { IBlockDragger };
 export { IBoundedElement };
 export { IBubble };
 export { ICollapsibleToolboxItem };
@@ -345,10 +340,10 @@ export { IConnectionPreviewer };
 export { IContextMenu };
 export { icons };
 export { ICopyable, isCopyable };
-export { IDeletable };
+export { IDeletable, isDeletable };
 export { IDeleteArea };
 export { IDragTarget };
-export { IDraggable };
+export { IDraggable, isDraggable };
 export { IFlyout };
 export { IHasBubble, hasBubble };
 export { IIcon, isIcon };
@@ -363,7 +358,7 @@ export { IObservable, isObservable };
 export { IPaster, isPaster };
 export { IPositionable };
 export { IRegistrable };
-export { ISelectable };
+export { ISelectable, isSelectable };
 export { ISelectableToolboxItem };
 export { ISerializable, isSerializable };
 export { IStyleable };

package/core/bubbles/bubble.d.ts

@@ -8,13 +8,14 @@ import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { Size } from '../utils/size.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
+import { ISelectable } from '../blockly.js';
 /**
  * The abstract pop-up bubble class. This creates a UI that looks like a speech
  * bubble, where it has a "tail" that points to the block, and a "head" that
  * displays arbitrary svg elements.
  */
-export declare abstract class Bubble implements IBubble {
-    protected readonly workspace: WorkspaceSvg;
+export declare abstract class Bubble implements IBubble, ISelectable {
+    readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;
     protected ownerRect?: Rect | undefined;
     /** The width of the border around the bubble. */
@@ -37,6 +38,7 @@ export declare abstract class Bubble implements IBubble {
     static readonly TAIL_BEND = 4;
     /** Distance between arrow point and anchor point. */
     static readonly ANCHOR_RADIUS = 8;
+    id: string;
     /** The SVG group containing all parts of the bubble. */
     protected svgRoot: SVGGElement;
     /** The SVG path for the arrow from the anchor to the bubble. */
@@ -57,6 +59,7 @@ export declare abstract class Bubble implements IBubble {
     private relativeTop;
     /** The position of the left of the bubble realtive to its anchor. */
     private relativeLeft;
+    private dragStrategy;
     /**
      * @param workspace The workspace this bubble belongs to.
      * @param anchor The anchor location of the thing this bubble is attached to.
@@ -175,5 +178,17 @@ export declare abstract class Bubble implements IBubble {
     isDeletable(): boolean;
     /** @internal */
     showContextMenu(_e: Event): void;
+    /** Returns whether this bubble is movable or not. */
+    isMovable(): boolean;
+    /** Starts a drag on the bubble. */
+    startDrag(): void;
+    /** Drags the bubble to the given location. */
+    drag(newLoc: Coordinate): void;
+    /** Ends the drag on the bubble. */
+    endDrag(): void;
+    /** Moves the bubble back to where it was at the start of a drag. */
+    revertDrag(): void;
+    select(): void;
+    unselect(): void;
 }
 //# sourceMappingURL=bubble.d.ts.map

package/core/bubbles/mini_workspace_bubble.d.ts

@@ -15,7 +15,7 @@ import type { WorkspaceSvg } from '../workspace_svg.js';
  * Used by the mutator icon.
  */
 export declare class MiniWorkspaceBubble extends Bubble {
-    protected readonly workspace: WorkspaceSvg;
+    readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;
     protected ownerRect?: Rect | undefined;
     /**

package/core/bubbles/text_bubble.d.ts

@@ -12,7 +12,7 @@ import { WorkspaceSvg } from '../workspace_svg.js';
  */
 export declare class TextBubble extends Bubble {
     private text;
-    protected readonly workspace: WorkspaceSvg;
+    readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;
     protected ownerRect?: Rect | undefined;
     private paragraph;

package/core/bubbles/textinput_bubble.d.ts

@@ -13,7 +13,7 @@ import { WorkspaceSvg } from '../workspace_svg.js';
  * Used by the comment icon.
  */
 export declare class TextInputBubble extends Bubble {
-    protected readonly workspace: WorkspaceSvg;
+    readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;
     protected ownerRect?: Rect | undefined;
     /** The root of the elements specific to the text element. */

package/core/comments/comment_view.d.ts

@@ -11,8 +11,10 @@ export declare class CommentView implements IRenderedElement {
     private readonly workspace;
     /** The root group element of the comment view. */
     private svgRoot;
+    /** The group containing all of the top bar elements. */
+    private topBarGroup;
     /** The rect background for the top bar. */
-    private topBar;
+    private topBarBackground;
     /** The delete icon that goes in the top bar. */
     private deleteIcon;
     /** The foldout icon that goes in the top bar. */
@@ -93,6 +95,8 @@ export declare class CommentView implements IRenderedElement {
     private calcDeleteMargin;
     /** Calculates the margin that should exist around the foldout icon. */
     private calcFoldoutMargin;
+    /** Updates the size of the top bar to reflect the new size. */
+    private updateTopBarSize;
     /** Updates the size of the text area elements to reflect the new size. */
     private updateTextAreaSize;
     /**
@@ -107,6 +111,8 @@ export declare class CommentView implements IRenderedElement {
      * Updates the size and position of the text preview elements to reflect the new size.
      */
     private updateTextPreviewSize;
+    /** Updates the position of the resize handle to reflect the new size. */
+    private updateResizeHandlePosition;
     /**
      * Triggers listeners when the size of the comment changes, either
      * progrmatically or manually by the user.

package/core/comments/rendered_workspace_comment.d.ts

@@ -10,9 +10,13 @@ import { Rect } from '../utils/rect.js';
 import { Size } from '../utils/size.js';
 import { IBoundedElement } from '../interfaces/i_bounded_element.js';
 import { IRenderedElement } from '../interfaces/i_rendered_element.js';
-export declare class RenderedWorkspaceComment extends WorkspaceComment implements IBoundedElement, IRenderedElement {
+import { IDraggable } from '../interfaces/i_draggable.js';
+import { ISelectable } from '../interfaces/i_selectable.js';
+export declare class RenderedWorkspaceComment extends WorkspaceComment implements IBoundedElement, IRenderedElement, IDraggable, ISelectable {
     /** The class encompassing the svg elements making up the workspace comment. */
     private view;
+    readonly workspace: WorkspaceSvg;
+    private dragStrategy;
     /** Constructs the workspace comment, including the view. */
     constructor(workspace: WorkspaceSvg, id?: string);
     /**
@@ -33,10 +37,39 @@ export declare class RenderedWorkspaceComment extends WorkspaceComment implement
     /** Returns the bounding rectangle of this comment in workspace coordinates. */
     getBoundingRectangle(): Rect;
     /** Move the comment by the given amounts in workspace coordinates. */
-    moveBy(dx: number, dy: number, _reason?: string[] | undefined): void;
+    moveBy(dx: number, dy: number, reason?: string[] | undefined): void;
     /** Moves the comment to the given location in workspace coordinates. */
-    moveTo(location: Coordinate): void;
+    moveTo(location: Coordinate, reason?: string[] | undefined): void;
+    /**
+     * Moves the comment during a drag. Doesn't fire move events.
+     *
+     * @internal
+     */
+    moveDuringDrag(location: Coordinate): void;
+    /**
+     * Adds the dragging CSS class to this comment.
+     *
+     * @internal
+     */
+    setDragging(dragging: boolean): void;
     /** Disposes of the view. */
     dispose(): void;
+    /**
+     * Starts a gesture because we detected a pointer down on the comment
+     * (that wasn't otherwise gobbled up, e.g. by resizing).
+     */
+    private startGesture;
+    /** Returns whether this comment is movable or not. */
+    isMovable(): boolean;
+    /** Starts a drag on the comment. */
+    startDrag(): void;
+    /** Drags the comment to the given location. */
+    drag(newLoc: Coordinate): void;
+    /** Ends the drag on the comment. */
+    endDrag(): void;
+    /** Moves the comment back to where it was at the start of a drag. */
+    revertDrag(): void;
+    select(): void;
+    unselect(): void;
 }
 //# sourceMappingURL=rendered_workspace_comment.d.ts.map

package/core/comments/workspace_comment.d.ts

@@ -7,7 +7,7 @@ import { Workspace } from '../workspace.js';
 import { Size } from '../utils/size.js';
 import { Coordinate } from '../utils/coordinate.js';
 export declare class WorkspaceComment {
-    protected readonly workspace: Workspace;
+    readonly workspace: Workspace;
     /** The unique identifier for this comment. */
     readonly id: string;
     /** The text of the comment. */
@@ -23,7 +23,7 @@ export declare class WorkspaceComment {
     /** Whether the comment is deletable or not. */
     private deletable;
     /** The location of the comment in workspace coordinates. */
-    private location;
+    protected location: Coordinate;
     /** Whether this comment has been disposed or not. */
     protected disposed: boolean;
     /** Whether this comment is being disposed or not. */
@@ -36,6 +36,12 @@ export declare class WorkspaceComment {
      *     be generated.
      */
     constructor(workspace: Workspace, id?: string);
+    private fireCreateEvent;
+    private fireDeleteEvent;
+    /** Fires a comment change event. */
+    private fireChangeEvent;
+    /** Fires a comment collapse event. */
+    private fireCollapseEvent;
     /** Sets the text of the comment. */
     setText(text: string): void;
     /** Returns the text of the comment. */
@@ -85,7 +91,7 @@ export declare class WorkspaceComment {
      */
     isOwnDeletable(): boolean;
     /** Moves the comment to the given location in workspace coordinates. */
-    moveTo(location: Coordinate): void;
+    moveTo(location: Coordinate, reason?: string[] | undefined): void;
     /** Returns the position of the comment in workspace coordinates. */
     getRelativeToSurfaceXY(): Coordinate;
     /** Disposes of this comment. */

package/core/connection.d.ts

@@ -111,7 +111,7 @@ export declare class Connection implements IASTNodeLocationWithBlock {
      * Connect this connection to another connection.
      *
      * @param otherConnection Connection to connect to.
-     * @returns Whether the the blocks are now connected or not.
+     * @returns Whether the blocks are now connected or not.
      */
     connect(otherConnection: Connection): boolean;
     /**

package/core/delete_area.d.ts

@@ -34,11 +34,10 @@ export declare class DeleteArea extends DragTarget implements IDeleteArea {
      * 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;
     /**
      * Updates the internal wouldDelete_ state.
      *

package/core/dragging/block_drag_strategy.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IDragStrategy } from '../interfaces/i_draggable.js';
+import { Coordinate } from '../utils.js';
+import { BlockSvg } from '../block_svg.js';
+export declare class BlockDragStrategy implements IDragStrategy {
+    private block;
+    private workspace;
+    /** The parent block at the start of the drag. */
+    private startParentConn;
+    /**
+     * The child block at the start of the drag. Only gets set if
+     * `healStack` is true.
+     */
+    private startChildConn;
+    private startLoc;
+    private connectionCandidate;
+    private connectionPreviewer;
+    private dragging;
+    /**
+     * If this is a shadow block, the offset between this block and the parent
+     * block, to add to the drag location. In workspace units.
+     */
+    private dragOffset;
+    constructor(block: BlockSvg);
+    /** Returns true if the block is currently movable. False otherwise. */
+    isMovable(): boolean;
+    /**
+     * Handles any setup for starting the drag, including disconnecting the block
+     * from any parent blocks.
+     */
+    startDrag(e?: PointerEvent): void;
+    /** Starts a drag on a shadow, recording the drag offset. */
+    private startDraggingShadow;
+    /**
+     * Whether or not we should disconnect the block when a drag is started.
+     *
+     * @param healStack Whether or not to heal the stack after disconnecting.
+     * @returns True to disconnect the block, false otherwise.
+     */
+    private shouldDisconnect;
+    /**
+     * Disconnects the block from any parents. If `healStack` is true and this is
+     * a stack block, we also disconnect from any next blocks and attempt to
+     * attach them to any parent.
+     *
+     * @param healStack Whether or not to heal the stack after disconnecting.
+     */
+    private disconnectBlock;
+    /** Fire a UI event at the start of a block drag. */
+    private fireDragStartEvent;
+    /** Fire a UI event at the end of a block drag. */
+    private fireDragEndEvent;
+    /** Fire a move event at the end of a block drag. */
+    private fireMoveEvent;
+    /** Moves the block and updates any connection previews. */
+    drag(newLoc: Coordinate): void;
+    /**
+     * @param draggingBlock The block being dragged.
+     * @param delta How far the pointer has moved from the position
+     *     at the start of the drag, in workspace units.
+     */
+    private updateConnectionPreview;
+    /**
+     * Returns true if the given orphan block can connect at the end of the
+     * top block's stack or row, false otherwise.
+     */
+    private orphanCanConnectAtEnd;
+    /**
+     * Returns true if the current candidate is better than the new candidate.
+     *
+     * We slightly prefer the current candidate even if it is farther away.
+     */
+    private currCandidateIsBetter;
+    /**
+     * Returns the closest valid candidate connection, if one can be found.
+     *
+     * Valid neighbour connections are within the configured start radius, with a
+     * compatible type (input, output, etc) and connection check.
+     */
+    private getConnectionCandidate;
+    /**
+     * Returns all of the connections we might connect to blocks on the workspace.
+     *
+     * Includes any connections on the dragging block, and any last next
+     * connection on the stack (if one exists).
+     */
+    private getLocalConnections;
+    /**
+     * Cleans up any state at the end of the drag. Applies any pending
+     * connections.
+     */
+    endDrag(e?: PointerEvent): void;
+    /** Connects the given candidate connections. */
+    private applyConnections;
+    /**
+     * Moves the block back to where it was at the beginning of the drag,
+     * including reconnecting connections.
+     */
+    revertDrag(): void;
+}
+//# sourceMappingURL=block_drag_strategy.d.ts.map

package/core/dragging/bubble_drag_strategy.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IDragStrategy } from '../interfaces/i_draggable.js';
+import { Coordinate } from '../utils.js';
+import { IBubble, WorkspaceSvg } from '../blockly.js';
+export declare class BubbleDragStrategy implements IDragStrategy {
+    private bubble;
+    private workspace;
+    private startLoc;
+    constructor(bubble: IBubble, workspace: WorkspaceSvg);
+    isMovable(): boolean;
+    startDrag(): void;
+    drag(newLoc: Coordinate): void;
+    endDrag(): void;
+    revertDrag(): void;
+}
+//# sourceMappingURL=bubble_drag_strategy.d.ts.map

package/core/dragging/comment_drag_strategy.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IDragStrategy } from '../interfaces/i_draggable.js';
+import { Coordinate } from '../utils.js';
+import { RenderedWorkspaceComment } from '../comments.js';
+export declare class CommentDragStrategy implements IDragStrategy {
+    private comment;
+    private startLoc;
+    private workspace;
+    constructor(comment: RenderedWorkspaceComment);
+    isMovable(): boolean;
+    startDrag(): void;
+    drag(newLoc: Coordinate): void;
+    endDrag(): void;
+    revertDrag(): void;
+}
+//# sourceMappingURL=comment_drag_strategy.d.ts.map

package/core/dragging/dragger.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IDeletable } from '../interfaces/i_deletable.js';
+import { IDragger } from '../interfaces/i_dragger.js';
+import { IDraggable } from '../interfaces/i_draggable.js';
+import { Coordinate } from '../utils/coordinate.js';
+import { WorkspaceSvg } from '../workspace_svg.js';
+export declare class Dragger implements IDragger {
+    private draggable;
+    private workspace;
+    private startLoc;
+    private dragTarget;
+    constructor(draggable: IDraggable, workspace: WorkspaceSvg);
+    /** Handles any drag startup. */
+    onDragStart(e: PointerEvent): void;
+    /**
+     * Handles calculating where the element should actually be moved to.
+     *
+     * @param totalDelta The total amount in pixel coordinates the mouse has moved
+     *     since the start of the drag.
+     */
+    onDrag(e: PointerEvent, totalDelta: Coordinate): void;
+    /** Updates the drag target under the pointer (if there is one). */
+    protected updateDragTarget(e: PointerEvent): void;
+    /**
+     * Calculates the correct workspace coordinate for the movable and tells
+     * the draggable to go to that location.
+     */
+    private moveDraggable;
+    /**
+     * Returns true if we would delete the draggable if it was dropped
+     * at the current location.
+     */
+    protected wouldDeleteDraggable(e: PointerEvent, draggable: IDraggable & IDeletable): boolean;
+    /** Handles any drag cleanup. */
+    onDragEnd(e: PointerEvent): void;
+    /**
+     * Returns true if we should return the draggable to its original location
+     * at the end of the drag.
+     */
+    protected shouldReturnToStart(e: PointerEvent, draggable: IDraggable): boolean;
+    protected pixelsToWorkspaceUnits(pixelCoord: Coordinate): Coordinate;
+}
+//# sourceMappingURL=dragger.d.ts.map

package/core/events/events.d.ts

@@ -18,6 +18,7 @@ import { CommentChange, CommentChangeJson } from './events_comment_change.js';
 import { CommentCreate, CommentCreateJson } from './events_comment_create.js';
 import { CommentDelete } from './events_comment_delete.js';
 import { CommentMove, CommentMoveJson } from './events_comment_move.js';
+import { CommentCollapse, CommentCollapseJson } from './events_comment_collapse.js';
 import { MarkerMove, MarkerMoveJson } from './events_marker_move.js';
 import { Selected, SelectedJson } from './events_selected.js';
 import { ThemeChange, ThemeChangeJson } from './events_theme_change.js';
@@ -62,6 +63,8 @@ export { CommentCreateJson };
 export { CommentDelete };
 export { CommentMove };
 export { CommentMoveJson };
+export { CommentCollapse };
+export { CommentCollapseJson };
 export { FinishedLoading };
 export { MarkerMove };
 export { MarkerMoveJson };

package/core/events/events_comment_base.d.ts

@@ -3,7 +3,12 @@
  * Copyright 2018 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { WorkspaceComment } from '../workspace_comment.js';
+/**
+ * Base class for comment events.
+ *
+ * @class
+ */
+import type { WorkspaceComment } from '../comments/workspace_comment.js';
 import { Abstract as AbstractEvent, AbstractEventJson } from './events_abstract.js';
 import type { CommentCreate } from './events_comment_create.js';
 import type { CommentDelete } from './events_comment_delete.js';