blockly 11.0.0-beta.1 → 11.0.0-beta.11

package/core/clipboard/workspace_comment_paster.d.ts

@@ -7,12 +7,13 @@ import { IPaster } from '../interfaces/i_paster.js';
 import { ICopyData } from '../interfaces/i_copyable.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
-import { WorkspaceCommentSvg } from '../workspace_comment_svg.js';
-export declare class WorkspaceCommentPaster implements IPaster<WorkspaceCommentCopyData, WorkspaceCommentSvg> {
+import * as commentSerialiation from '../serialization/workspace_comments.js';
+import { RenderedWorkspaceComment } from '../comments/rendered_workspace_comment.js';
+export declare class WorkspaceCommentPaster implements IPaster<WorkspaceCommentCopyData, RenderedWorkspaceComment> {
     static TYPE: string;
-    paste(copyData: WorkspaceCommentCopyData, workspace: WorkspaceSvg, coordinate?: Coordinate): WorkspaceCommentSvg;
+    paste(copyData: WorkspaceCommentCopyData, workspace: WorkspaceSvg, coordinate?: Coordinate): RenderedWorkspaceComment | null;
 }
 export interface WorkspaceCommentCopyData extends ICopyData {
-    commentState: Element;
+    commentState: commentSerialiation.State;
 }
 //# sourceMappingURL=workspace_comment_paster.d.ts.map

package/core/clipboard.d.ts

@@ -8,14 +8,6 @@ import { BlockPaster } from './clipboard/block_paster.js';
 import { WorkspaceSvg } from './workspace_svg.js';
 import * as registry from './clipboard/registry.js';
 import { Coordinate } from './utils/coordinate.js';
-/**
- * Copy a copyable element onto the local clipboard.
- *
- * @param toCopy The copyable element to be copied.
- * @deprecated v11. Use `myCopyable.toCopyData()` instead. To be removed v12.
- * @internal
- */
-export declare function copy<T extends ICopyData>(toCopy: ICopyable<T>): T | null;
 /**
  * Private version of copy for stubbing in tests.
  */
@@ -35,17 +27,6 @@ export declare function paste<T extends ICopyData>(copyData: T, workspace: Works
  * @returns the pasted thing if the paste was successful, null otherwise.
  */
 export declare function paste(): ICopyable<ICopyData> | null;
-/**
- * Duplicate this copy-paste-able element.
- *
- * @param toDuplicate The element to be duplicated.
- * @returns The element that was duplicated, or null if the duplication failed.
- * @deprecated v11. Use
- *     `Blockly.clipboard.paste(myCopyable.toCopyData(), myWorkspace)` instead.
- *     To be removed v12.
- * @internal
- */
-export declare function duplicate<U extends ICopyData, T extends ICopyable<U> & IHasWorkspace>(toDuplicate: T): T | null;
 /**
  * Private version of duplicate for stubbing in tests.
  */

package/core/comments/comment_view.d.ts

@@ -0,0 +1,217 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IRenderedElement } from '../interfaces/i_rendered_element.js';
+import { WorkspaceSvg } from '../workspace_svg.js';
+import { Coordinate } from '../utils/coordinate.js';
+import { Size } from '../utils/size.js';
+export declare class CommentView implements IRenderedElement {
+    private readonly workspace;
+    /** The root group element of the comment view. */
+    private svgRoot;
+    /**
+     * The svg rect element that we use to create a hightlight around the comment.
+     */
+    private highlightRect;
+    /** The group containing all of the top bar elements. */
+    private topBarGroup;
+    /** The rect background for the top bar. */
+    private topBarBackground;
+    /** The delete icon that goes in the top bar. */
+    private deleteIcon;
+    /** The foldout icon that goes in the top bar. */
+    private foldoutIcon;
+    /** The text element that goes in the top bar. */
+    private textPreview;
+    /** The actual text node in the text preview. */
+    private textPreviewNode;
+    /** The resize handle element. */
+    private resizeHandle;
+    /** The foreignObject containing the HTML text area. */
+    private foreignObject;
+    /** The text area where the user can type. */
+    private textArea;
+    /** The current size of the comment in workspace units. */
+    private size;
+    /** Whether the comment is collapsed or not. */
+    private collapsed;
+    /** Whether the comment is editable or not. */
+    private editable;
+    /** The current location of the comment in workspace coordinates. */
+    private location;
+    /** The current text of the comment. Updates on  text area change. */
+    private text;
+    /** Listeners for changes to text. */
+    private textChangeListeners;
+    /** Listeners for changes to size. */
+    private sizeChangeListeners;
+    /** Listeners for disposal. */
+    private disposeListeners;
+    /** Listeners for collapsing. */
+    private collapseChangeListeners;
+    /**
+     * Event data for the pointer up event on the resize handle. Used to
+     * unregister the listener.
+     */
+    private resizePointerUpListener;
+    /**
+     * Event data for the pointer move event on the resize handle. Used to
+     * unregister the listener.
+     */
+    private resizePointerMoveListener;
+    /** Whether this comment view is currently being disposed or not. */
+    private disposing;
+    /** Whether this comment view has been disposed or not. */
+    private disposed;
+    constructor(workspace: WorkspaceSvg);
+    /**
+     * Creates the rect we use for highlighting the comment when it's selected.
+     */
+    private createHighlightRect;
+    /**
+     * Creates the top bar and the elements visually within it.
+     * Registers event listeners.
+     */
+    private createTopBar;
+    /**
+     * Creates the text area where users can type. Registers event listeners.
+     */
+    private createTextArea;
+    /** Creates the DOM elements for the comment resize handle. */
+    private createResizeHandle;
+    /** Returns the root SVG group element of the comment view. */
+    getSvgRoot(): SVGGElement;
+    /** Returns the current size of the comment in workspace units. */
+    getSize(): Size;
+    /**
+     * Sets the size of the comment in workspace units, and updates the view
+     * elements to reflect the new size.
+     */
+    setSize(size: Size): void;
+    /**
+     * Calculates the minimum size for the uncollapsed comment based on text
+     * size and visible icons.
+     *
+     * The minimum width is based on the width of the truncated preview text.
+     *
+     * The minimum height is based on the height of the top bar.
+     */
+    private calcMinSize;
+    /** Calculates the margin that should exist around the delete icon. */
+    private calcDeleteMargin;
+    /** Calculates the margin that should exist around the foldout icon. */
+    private calcFoldoutMargin;
+    /** Updates the size of the highlight rect to reflect the new size. */
+    private updateHighlightRect;
+    /** 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;
+    /**
+     * Updates the position of the delete icon elements to reflect the new size.
+     */
+    private updateDeleteIconPosition;
+    /**
+     * Updates the position of the foldout icon elements to reflect the new size.
+     */
+    private updateFoldoutIconPosition;
+    /**
+     * 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.
+     */
+    private onSizeChange;
+    /**
+     * Registers a callback that listens for size changes.
+     *
+     * @param listener Receives callbacks when the size of the comment changes.
+     *     The new and old size are in workspace units.
+     */
+    addSizeChangeListener(listener: (oldSize: Size, newSize: Size) => void): void;
+    /** Removes the given listener from the list of size change listeners. */
+    removeSizeChangeListener(listener: () => void): void;
+    /**
+     * Handles starting an interaction with the resize handle to resize the
+     * comment.
+     */
+    private onResizePointerDown;
+    /** Ends an interaction with the resize handle. */
+    private onResizePointerUp;
+    /** Resizes the comment in response to a drag on the resize handle. */
+    private onResizePointerMove;
+    /** Returns true if the comment is currently collapsed. */
+    isCollapsed(): boolean;
+    /** Sets whether the comment is currently collapsed or not. */
+    setCollapsed(collapsed: boolean): void;
+    /**
+     * Triggers listeners when the collapsed-ness of the comment changes, either
+     * progrmatically or manually by the user.
+     */
+    private onCollapse;
+    /** Registers a callback that listens for collapsed-ness changes. */
+    addOnCollapseListener(listener: (newCollapse: boolean) => void): void;
+    /** Removes the given listener from the list of on collapse listeners. */
+    removeOnCollapseListener(listener: () => void): void;
+    /**
+     * Toggles the collapsedness of the block when we receive a pointer down
+     * event on the foldout icon.
+     */
+    private onFoldoutDown;
+    /** Returns true if the comment is currently editable. */
+    isEditable(): boolean;
+    /** Sets the editability of the comment. */
+    setEditable(editable: boolean): void;
+    /** Returns the current location of the comment in workspace coordinates. */
+    getRelativeToSurfaceXY(): Coordinate;
+    /**
+     * Moves the comment view to the given location.
+     *
+     * @param location The location to move to in workspace coordinates.
+     */
+    moveTo(location: Coordinate): void;
+    /** Retursn the current text of the comment. */
+    getText(): string;
+    /** Sets the current text of the comment. */
+    setText(text: string): void;
+    /** Registers a callback that listens for text changes. */
+    addTextChangeListener(listener: (oldText: string, newText: string) => void): void;
+    /** Removes the given listener from the list of text change listeners. */
+    removeTextChangeListener(listener: () => void): void;
+    /**
+     * Triggers listeners when the text of the comment changes, either
+     * progrmatically or manually by the user.
+     */
+    private onTextChange;
+    /** Updates the preview text element to reflect the given text. */
+    private updateTextPreview;
+    /** Truncates the text to fit within the top view. */
+    private truncateText;
+    /** Brings the workspace comment to the front of its layer. */
+    private bringToFront;
+    /**
+     * Handles disposing of the comment when we get a pointer down event on the
+     * delete icon.
+     */
+    private onDeleteDown;
+    /** Disposes of this comment view. */
+    dispose(): void;
+    /** Returns whether this comment view has been disposed or not. */
+    isDisposed(): boolean;
+    /**
+     * Returns true if this comment view is currently being disposed or has
+     * already been disposed.
+     */
+    isDeadOrDying(): boolean;
+    /** Registers a callback that listens for disposal of this view. */
+    addDisposeListener(listener: () => void): void;
+    /** Removes the given listener from the list of disposal listeners. */
+    removeDisposeListener(listener: () => void): void;
+}
+//# sourceMappingURL=comment_view.d.ts.map

package/core/comments/rendered_workspace_comment.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { WorkspaceComment } from './workspace_comment.js';
+import { WorkspaceSvg } from '../workspace_svg.js';
+import { Coordinate } from '../utils/coordinate.js';
+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';
+import { IDraggable } from '../interfaces/i_draggable.js';
+import { ISelectable } from '../interfaces/i_selectable.js';
+import { IDeletable } from '../interfaces/i_deletable.js';
+import { ICopyable } from '../interfaces/i_copyable.js';
+import { WorkspaceCommentCopyData } from '../clipboard/workspace_comment_paster.js';
+import { IContextMenu } from '../interfaces/i_contextmenu.js';
+export declare class RenderedWorkspaceComment extends WorkspaceComment implements IBoundedElement, IRenderedElement, IDraggable, ISelectable, IDeletable, ICopyable<WorkspaceCommentCopyData>, IContextMenu {
+    /** 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);
+    /**
+     * Adds listeners to the view that updates the model (i.e. the superclass)
+     * when changes are made to the view.
+     */
+    private addModelUpdateBindings;
+    /** Sets the text of the comment. */
+    setText(text: string): void;
+    /** Sets the size of the comment. */
+    setSize(size: Size): void;
+    /** Sets whether the comment is collapsed or not. */
+    setCollapsed(collapsed: boolean): void;
+    /** Sets whether the comment is editable or not. */
+    setEditable(editable: boolean): void;
+    /** Returns the root SVG element of this comment. */
+    getSvgRoot(): SVGElement;
+    /** 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;
+    /** Moves the comment to the given location in workspace coordinates. */
+    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;
+    /** Visually indicates that this comment would be deleted if dropped. */
+    setDeleteStyle(wouldDelete: boolean): void;
+    /** 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;
+    /** Visually highlights the comment. */
+    select(): void;
+    /** Visually unhighlights the comment. */
+    unselect(): void;
+    /**
+     * Returns a JSON serializable representation of this comment's state that
+     * can be used for pasting.
+     */
+    toCopyData(): WorkspaceCommentCopyData | null;
+    /** Show a context menu for this comment. */
+    showContextMenu(e: PointerEvent): void;
+}
+//# sourceMappingURL=rendered_workspace_comment.d.ts.map

package/core/comments/workspace_comment.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Workspace } from '../workspace.js';
+import { Size } from '../utils/size.js';
+import { Coordinate } from '../utils/coordinate.js';
+export declare class WorkspaceComment {
+    readonly workspace: Workspace;
+    /** The unique identifier for this comment. */
+    readonly id: string;
+    /** The text of the comment. */
+    private text;
+    /** The size of the comment in workspace units. */
+    private size;
+    /** Whether the comment is collapsed or not. */
+    private collapsed;
+    /** Whether the comment is editable or not. */
+    private editable;
+    /** Whether the comment is movable or not. */
+    private movable;
+    /** Whether the comment is deletable or not. */
+    private deletable;
+    /** The location of the comment in workspace coordinates. */
+    protected location: Coordinate;
+    /** Whether this comment has been disposed or not. */
+    protected disposed: boolean;
+    /** Whether this comment is being disposed or not. */
+    protected disposing: boolean;
+    /**
+     * Constructs the comment.
+     *
+     * @param workspace The workspace to construct the comment in.
+     * @param id An optional ID to give to the comment. If not provided, one will
+     *     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. */
+    getText(): string;
+    /** Sets the comment's size in workspace units. */
+    setSize(size: Size): void;
+    /** Returns the comment's size in workspace units. */
+    getSize(): Size;
+    /** Sets whether the comment is collapsed or not. */
+    setCollapsed(collapsed: boolean): void;
+    /** Returns whether the comment is collapsed or not. */
+    isCollapsed(): boolean;
+    /** Sets whether the comment is editable or not. */
+    setEditable(editable: boolean): void;
+    /**
+     * Returns whether the comment is editable or not, respecting whether the
+     * workspace is read-only.
+     */
+    isEditable(): boolean;
+    /**
+     * Returns whether the comment is editable or not, only examining its own
+     * state and ignoring the state of the workspace.
+     */
+    isOwnEditable(): boolean;
+    /** Sets whether the comment is movable or not. */
+    setMovable(movable: boolean): void;
+    /**
+     * Returns whether the comment is movable or not, respecting whether the
+     * workspace is read-only.
+     */
+    isMovable(): boolean;
+    /**
+     * Returns whether the comment is movable or not, only examining its own
+     * state and ignoring the state of the workspace.
+     */
+    isOwnMovable(): boolean;
+    /** Sets whether the comment is deletable or not. */
+    setDeletable(deletable: boolean): void;
+    /**
+     * Returns whether the comment is deletable or not, respecting whether the
+     * workspace is read-only.
+     */
+    isDeletable(): boolean;
+    /**
+     * Returns whether the comment is deletable or not, only examining its own
+     * state and ignoring the state of the workspace.
+     */
+    isOwnDeletable(): boolean;
+    /** Moves the comment to the given location in workspace coordinates. */
+    moveTo(location: Coordinate, reason?: string[] | undefined): void;
+    /** Returns the position of the comment in workspace coordinates. */
+    getRelativeToSurfaceXY(): Coordinate;
+    /** Disposes of this comment. */
+    dispose(): void;
+    /** Returns whether the comment has been disposed or not. */
+    isDisposed(): boolean;
+    /**
+     * Returns true if this comment view is currently being disposed or has
+     * already been disposed.
+     */
+    isDeadOrDying(): boolean;
+}
+//# sourceMappingURL=workspace_comment.d.ts.map

package/core/comments.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export { CommentView } from './comments/comment_view.js';
+export { WorkspaceComment } from './comments/workspace_comment.js';
+export { RenderedWorkspaceComment } from './comments/rendered_workspace_comment.js';
+//# sourceMappingURL=comments.d.ts.map

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/constants.d.ts

@@ -11,4 +11,9 @@ export declare const COLLAPSED_INPUT_NAME = "_TEMP_COLLAPSED_INPUT";
  * The language-neutral ID given to the collapsed field.
  */
 export declare const COLLAPSED_FIELD_NAME = "_TEMP_COLLAPSED_FIELD";
+/**
+ * The language-neutral ID for when the reason why a block is disabled is
+ * because the user manually disabled it, such as via the context menu.
+ */
+export declare const MANUALLY_DISABLED = "MANUALLY_DISABLED";
 //# sourceMappingURL=constants.d.ts.map

package/core/contextmenu.d.ts

@@ -7,8 +7,6 @@ import type { Block } from './block.js';
 import type { BlockSvg } from './block_svg.js';
 import type { ContextMenuOption, LegacyContextMenuOption } from './contextmenu_registry.js';
 import * as serializationBlocks from './serialization/blocks.js';
-import { WorkspaceCommentSvg } from './workspace_comment_svg.js';
-import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Gets the block the context menu is currently attached to.
  *
@@ -28,7 +26,7 @@ export declare function setCurrentBlock(block: Block | null): void;
  * @param options Array of menu options.
  * @param rtl True if RTL, false if LTR.
  */
-export declare function show(e: Event, options: (ContextMenuOption | LegacyContextMenuOption)[], rtl: boolean): void;
+export declare function show(e: PointerEvent, options: (ContextMenuOption | LegacyContextMenuOption)[], rtl: boolean): void;
 /**
  * Hide the context menu.
  */
@@ -46,35 +44,4 @@ export declare function dispose(): void;
  * @returns Function that creates a block.
  */
 export declare function callbackFactory(block: Block, state: Element | serializationBlocks.State): () => BlockSvg;
-/**
- * Make a context menu option for deleting the current workspace comment.
- *
- * @param comment The workspace comment where the
- *     right-click originated.
- * @returns A menu option,
- *     containing text, enabled, and a callback.
- * @internal
- */
-export declare function commentDeleteOption(comment: WorkspaceCommentSvg): LegacyContextMenuOption;
-/**
- * Make a context menu option for duplicating the current workspace comment.
- *
- * @param comment The workspace comment where the
- *     right-click originated.
- * @returns A menu option,
- *     containing text, enabled, and a callback.
- * @internal
- */
-export declare function commentDuplicateOption(comment: WorkspaceCommentSvg): LegacyContextMenuOption;
-/**
- * Make a context menu option for adding a comment on the workspace.
- *
- * @param ws The workspace where the right-click
- *     originated.
- * @param e The right-click mouse event.
- * @returns A menu option, containing text, enabled, and a callback.
- *     comments are not bundled in.
- * @internal
- */
-export declare function workspaceCommentOption(ws: WorkspaceSvg, e: Event): ContextMenuOption;
 //# sourceMappingURL=contextmenu.d.ts.map

package/core/contextmenu_items.d.ts

@@ -55,6 +55,14 @@ export declare function registerDelete(): void;
  * Option to open help for a block.
  */
 export declare function registerHelp(): void;
+/** Registers an option for deleting a workspace comment. */
+export declare function registerCommentDelete(): void;
+/** Registers an option for duplicating a workspace comment. */
+export declare function registerCommentDuplicate(): void;
+/** Registers an option for adding a workspace comment to the workspace. */
+export declare function registerCommentCreate(): void;
+/** Registers all workspace comment related menu items. */
+export declare function registerCommentOptions(): void;
 /**
  * Registers all default context menu items. This should be called once per
  * instance of ContextMenuRegistry.

package/core/contextmenu_registry.d.ts

@@ -9,6 +9,7 @@
  * @class
  */
 import type { BlockSvg } from './block_svg.js';
+import { RenderedWorkspaceComment } from './comments/rendered_workspace_comment.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for the registry of context menu items. This is intended to be a
@@ -63,7 +64,8 @@ export declare namespace ContextMenuRegistry {
      */
     enum ScopeType {
         BLOCK = "block",
-        WORKSPACE = "workspace"
+        WORKSPACE = "workspace",
+        COMMENT = "comment"
     }
     /**
      * The actual workspace/block where the menu is being rendered. This is passed
@@ -72,12 +74,19 @@ export declare namespace ContextMenuRegistry {
     interface Scope {
         block?: BlockSvg;
         workspace?: WorkspaceSvg;
+        comment?: RenderedWorkspaceComment;
     }
     /**
      * A menu item as entered in the registry.
      */
     interface RegistryItem {
-        callback: (p1: Scope) => void;
+        /**
+         * @param scope Object that provides a reference to the thing that had its
+         *     context menu opened.
+         * @param e The original event that triggered the context menu to open. Not
+         *     the event that triggered the click on the option.
+         */
+        callback: (scope: Scope, e: PointerEvent) => void;
         scopeType: ScopeType;
         displayText: ((p1: Scope) => string | HTMLElement) | string | HTMLElement;
         preconditionFn: (p1: Scope) => string;
@@ -90,7 +99,13 @@ export declare namespace ContextMenuRegistry {
     interface ContextMenuOption {
         text: string | HTMLElement;
         enabled: boolean;
-        callback: (p1: Scope) => void;
+        /**
+         * @param scope Object that provides a reference to the thing that had its
+         *     context menu opened.
+         * @param e The original event that triggered the context menu to open. Not
+         *     the event that triggered the click on the option.
+         */
+        callback: (scope: Scope, e: PointerEvent) => void;
         scope: Scope;
         weight: number;
     }

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.
      *