blockly 11.0.0-beta.3 → 11.0.0-beta.5

package/core/block.d.ts

@@ -139,12 +139,6 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * Is the current block currently in the process of being disposed?
      */
     private disposing;
-    /**
-     * Has this block been fully initialized? E.g. all fields initailized.
-     *
-     * @internal
-     */
-    initialized: boolean;
     private readonly xy_;
     isInFlyout: boolean;
     isInMutator: boolean;
@@ -153,8 +147,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
     protected isInsertionMarker_: boolean;
     /** Name of the type of hat. */
     hat?: string;
-    /** Is this block a BlockSVG? */
-    readonly rendered: boolean;
+    rendered: boolean | null;
     /**
      * String for block help, or function that returns a URL. Null for no help.
      */

package/core/block_dragger.d.ts

@@ -11,10 +11,10 @@
 import './events/events_block_drag.js';
 import type { BlockSvg } from './block_svg.js';
 import type { Icon } from './icons/icon.js';
-import { InsertionMarkerManager } from './insertion_marker_manager.js';
 import type { IBlockDragger } from './interfaces/i_block_dragger.js';
 import { Coordinate } from './utils/coordinate.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
+import { IConnectionPreviewer } from './blockly.js';
 /**
  * Class for a block dragger.  It moves blocks around the workspace when they
  * are being dragged by a mouse or touch.
@@ -22,14 +22,20 @@ import type { WorkspaceSvg } from './workspace_svg.js';
 export declare class BlockDragger implements IBlockDragger {
     /** The top block in the stack that is being dragged. */
     protected draggingBlock_: BlockSvg;
-    protected draggedConnectionManager_: InsertionMarkerManager;
+    protected connectionPreviewer: IConnectionPreviewer;
     /** The workspace on which the block is being dragged. */
     protected workspace_: WorkspaceSvg;
     /** Which drag area the mouse pointer is over, if any. */
     private dragTarget_;
+    private connectionCandidate;
     /** Whether the block would be deleted if dropped immediately. */
     protected wouldDeleteBlock_: boolean;
     protected startXY_: Coordinate;
+    /**
+     * @deprecated To be removed in v11. Updating icons is now handled by the
+     *     block's `moveDuringDrag` method.
+     */
+    protected dragIconData_: IconPositionData[];
     /**
      * @param block The block to drag.
      * @param workspace The workspace to drag on.
@@ -71,10 +77,58 @@ export declare class BlockDragger implements IBlockDragger {
      * display accordingly.
      *
      * @param e The most recent move event.
-     * @param currentDragDeltaXY How far the pointer has moved from the position
+     * @param delta How far the pointer has moved from the position
+     *     at the start of the drag, in pixel units.
+     */
+    drag(e: PointerEvent, delta: Coordinate): void;
+    /**
+     * @param draggingBlock The block being dragged.
+     * @param dragDelta How far the pointer has moved from the position
+     *     at the start of the drag, in pixel units.
+     */
+    private moveBlock;
+    private updateDragTargets;
+    /**
+     * Returns true if we would delete the block if it was dropped at this time,
+     * false otherwise.
+     *
+     * @param e The most recent move event.
+     * @param draggingBlock The block being dragged.
+     * @param delta How far the pointer has moved from the position
+     *     at the start of the drag, in pixel units.
+     */
+    private wouldDeleteBlock;
+    /**
+     * @param draggingBlock The block being dragged.
+     * @param dragDelta How far the pointer has moved from the position
      *     at the start of the drag, in pixel units.
      */
-    drag(e: PointerEvent, currentDragDeltaXY: Coordinate): void;
+    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;
     /**
      * Finish a block drag and put the block back on the workspace.
      *
@@ -107,6 +161,7 @@ export declare class BlockDragger implements IBlockDragger {
      * Updates the necessary information to place a block at a certain location.
      */
     protected updateBlockAfterMove_(): void;
+    private applyConnections;
     /** Fire a UI event at the end of a block drag. */
     protected fireDragEndEvent_(): void;
     /**
@@ -134,6 +189,13 @@ export declare class BlockDragger implements IBlockDragger {
      * @returns The input coordinate divided by the workspace scale.
      */
     protected pixelsToWorkspaceUnits_(pixelCoord: Coordinate): Coordinate;
+    /**
+     * Move all of the icons connected to this drag.
+     *
+     * @deprecated To be removed in v11. This is now handled by the block's
+     *     `moveDuringDrag` method.
+     */
+    protected dragIcons_(): void;
     /**
      * Get a list of the insertion markers that currently exist.  Drags have 0, 1,
      * or 2 insertion markers.

package/core/block_svg.d.ts

@@ -10,6 +10,7 @@
  */
 import './events/events_selected.js';
 import { Block } from './block.js';
+import { CommentIcon } from './icons/comment_icon.js';
 import type { Connection } from './connection.js';
 import { ConnectionType } from './connection_type.js';
 import { ContextMenuOption, LegacyContextMenuOption } from './contextmenu_registry.js';
@@ -26,6 +27,7 @@ import type { IPathObject } from './renderers/common/i_path_object.js';
 import type { BlockStyle } from './theme.js';
 import { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';
+import { WarningIcon } from './icons/warning_icon.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 import { IconType } from './icons/icon_types.js';
@@ -66,12 +68,17 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
     private warningTextDb;
     /** Block's mutator icon (if any). */
     mutator: MutatorIcon | null;
+    /**
+     * Block's warning icon (if any).
+     *
+     * @deprecated Use `setWarningText` to modify warnings on this block.
+     */
+    warning: WarningIcon | null;
     private svgGroup_;
     style: BlockStyle;
     /** @internal */
     pathObject: IPathObject;
-    /** Is this block a BlockSVG? */
-    readonly rendered = true;
+    rendered: boolean;
     private visuallyDisabled;
     /**
      * Is this block currently rendering? Used to stop recursive render calls
@@ -85,6 +92,11 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
     nextConnection: RenderedConnection;
     previousConnection: RenderedConnection;
     private translation;
+    /**
+     * The ID of the setTimeout callback for bumping neighbours, or 0 if no bump
+     * is currently scheduled.
+     */
+    private bumpNeighboursPid;
     /** Whether this block is currently being dragged. */
     private dragging;
     /**
@@ -337,6 +349,14 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * @internal
      */
     updateDisabled(): void;
+    /**
+     * Get the comment icon attached to this block, or null if the block has no
+     * comment.
+     *
+     * @returns The comment icon attached to this block, or null.
+     * @deprecated Use getIcon. To be remove in v11.
+     */
+    getCommentIcon(): CommentIcon | null;
     /**
      * Set this block's warning text.
      *
@@ -486,7 +506,8 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * Returns connections originating from this block.
      *
      * @param all If true, return all connections even hidden ones.
-     *     Otherwise, for a collapsed block don't return inputs connections.
+     *     Otherwise, for a non-rendered block return an empty list, and for a
+     *     collapsed block don't return inputs connections.
      * @returns Array of connections.
      * @internal
      */
@@ -541,8 +562,14 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      */
     bumpNeighbours(): void;
     /**
-     * Snap to grid, and then bump neighbouring blocks away at the end of the next
-     * render.
+     * Bumps unconnected blocks out of alignment.
+     */
+    private bumpNeighboursInternal;
+    /**
+     * Schedule snapping to grid and bumping neighbours to occur after a brief
+     * delay.
+     *
+     * @internal
      */
     scheduleSnapAndBump(): void;
     /**

package/core/blockly.d.ts

@@ -14,6 +14,7 @@ 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 { Bubble } from './bubbles/bubble.js';
 import * as bubbles from './bubbles.js';
 import { BubbleDragger } from './bubble_dragger.js';
 import * as bumpObjects from './bump_objects.js';
@@ -58,9 +59,12 @@ import { Gesture } from './gesture.js';
 import { Grid } from './grid.js';
 import * as icons from './icons.js';
 import { inject } from './inject.js';
+import { Align } from './inputs/align.js';
 import { Input } from './inputs/input.js';
+import { inputTypes } from './inputs/input_types.js';
 import * as inputs from './inputs.js';
 import { InsertionMarkerManager } from './insertion_marker_manager.js';
+import { InsertionMarkerPreviewer } from './connection_previewers/insertion_marker_previewer.js';
 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';
@@ -71,6 +75,7 @@ import { IBubble } from './interfaces/i_bubble.js';
 import { ICollapsibleToolboxItem } from './interfaces/i_collapsible_toolbox_item.js';
 import { IComponent } from './interfaces/i_component.js';
 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';
@@ -114,6 +119,7 @@ import * as renderManagement from './render_management.js';
 import * as blockRendering from './renderers/common/block_rendering.js';
 import * as constants from './constants.js';
 import * as geras from './renderers/geras/geras.js';
+import * as minimalist from './renderers/minimalist/minimalist.js';
 import * as thrasos from './renderers/thrasos/thrasos.js';
 import * as zelos from './renderers/zelos/zelos.js';
 import { Scrollbar } from './scrollbar.js';
@@ -157,6 +163,21 @@ import { ZoomControls } from './zoom_controls.js';
  * @define {string}
  */
 export declare const VERSION = "uncompiled";
+/**
+ * @see Blockly.Input.Align.LEFT
+ * @deprecated Use `Blockly.inputs.Align.LEFT`. To be removed in v11.
+ */
+export declare const ALIGN_LEFT = Align.LEFT;
+/**
+ * @see Blockly.Input.Align.CENTRE
+ * @deprecated Use `Blockly.inputs.Align.CENTER`. To be removed in v11.
+ */
+export declare const ALIGN_CENTRE = Align.CENTRE;
+/**
+ * @see Blockly.Input.Align.RIGHT
+ * @deprecated Use `Blockly.inputs.Align.RIGHT`. To be removed in v11.
+ */
+export declare const ALIGN_RIGHT = Align.RIGHT;
 /**
  * @see ConnectionType.INPUT_VALUE
  */
@@ -173,6 +194,11 @@ export declare const NEXT_STATEMENT = ConnectionType.NEXT_STATEMENT;
  * @see ConnectionType.PREVIOUS_STATEMENT
  */
 export declare const PREVIOUS_STATEMENT = ConnectionType.PREVIOUS_STATEMENT;
+/**
+ * @see inputTypes.DUMMY_INPUT
+ * @deprecated Use `Blockly.inputs.inputTypes.DUMMY`. To be removed in v11.
+ */
+export declare const DUMMY_INPUT = inputTypes.DUMMY;
 /** Aliases for toolbox positions. */
 /**
  * @see toolbox.Position.TOP
@@ -288,6 +314,7 @@ export { constants };
 export { dialog };
 export { fieldRegistry };
 export { geras };
+export { minimalist };
 export { registry };
 export { thrasos };
 export { uiPosition };
@@ -301,6 +328,8 @@ export { BlockDragger };
 export { BlockSvg };
 export { Blocks };
 export { bubbles };
+/** @deprecated Use Blockly.bubbles.Bubble instead. To be removed in v11. */
+export { Bubble };
 export { BubbleDragger };
 export { CollapsibleToolboxCategory };
 export { ComponentManager };
@@ -343,6 +372,7 @@ export { IBubble };
 export { ICollapsibleToolboxItem };
 export { IComponent };
 export { IConnectionChecker };
+export { IConnectionPreviewer };
 export { IContextMenu };
 export { icons };
 export { ICopyable, isCopyable };
@@ -359,6 +389,7 @@ export { IMovable };
 export { Input };
 export { inputs };
 export { InsertionMarkerManager };
+export { InsertionMarkerPreviewer };
 export { IObservable, isObservable };
 export { IPaster, isPaster };
 export { IPositionable };
@@ -402,6 +433,10 @@ export { WorkspaceDragger };
 export { WorkspaceSvg };
 export { ZoomControls };
 export { config };
+/** @deprecated Use Blockly.ConnectionType instead. */
+export declare const connectionTypes: typeof ConnectionType;
 export { inject };
+/** @deprecated Use Blockly.inputs.inputTypes instead. To be removed in v11. */
+export { inputTypes };
 export { serialization };
 //# sourceMappingURL=blockly.d.ts.map

package/core/clipboard.d.ts

@@ -8,6 +8,14 @@ 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.
  */
@@ -27,6 +35,17 @@ 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/connection_previewers/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/gesture.d.ts

@@ -86,8 +86,6 @@ export declare class Gesture {
      * 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. */

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.
@@ -21,6 +22,26 @@ export declare class Grid {
      *     https://developers.google.com/blockly/guides/configure/web/grid
      */
     constructor(pattern: SVGElement, options: GridOptions);
+    /**
+     * Sets the spacing between the centers of the grid lines.
+     *
+     * 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.
+     */
+    setSpacing(spacing: number): void;
+    /** Sets the length of the grid lines. */
+    setLength(length: number): void;
+    /**
+     * 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, based on the initial configuration.
      *

package/core/icons/comment_icon.d.ts

@@ -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(): Promise<void>;
+    updateEditable(): 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): Promise<void>;
+    setBubbleVisible(visible: boolean): 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.

package/core/icons/icon.d.ts

@@ -59,5 +59,11 @@ 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/mutator_icon.d.ts

@@ -4,7 +4,9 @@
  * 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';
@@ -53,7 +55,7 @@ export declare class MutatorIcon extends Icon implements IHasBubble {
     onClick(): void;
     isClickableInFlyout(): boolean;
     bubbleIsVisible(): boolean;
-    setBubbleVisible(visible: boolean): Promise<void>;
+    setBubbleVisible(visible: boolean): void;
     /** @returns the configuration the mini workspace should have. */
     private getMiniWorkspaceConfig;
     /**
@@ -89,5 +91,18 @@ 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): Promise<void>;
+    setBubbleVisible(visible: boolean): void;
     /**
      * @returns the location the bubble should be anchored to.
      *     I.E. the middle of this icon.

package/core/inputs/input.d.ts

@@ -15,14 +15,13 @@ 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: Align;
+    align: Input.Align;
     /** Is the input visible? */
     private visible;
     readonly type: inputTypes;
@@ -122,14 +121,6 @@ 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.
      */
@@ -144,4 +135,22 @@ 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/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_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): Promise<void>;
+    setBubbleVisible(visible: boolean): void;
 }
 /** Type guard that checks whether the given object is a IHasBubble. */
 export declare function hasBubble(obj: any): obj is IHasBubble;