blockly 11.0.0-beta.2 → 11.0.0-beta.4

package/core/block.d.ts

@@ -18,7 +18,7 @@ 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 IIcon } from './interfaces/i_icon.js';
 import type { MutatorIcon } from './icons/mutator_icon.js';
 import * as Tooltip from './tooltip.js';
 import { Coordinate } from './utils/coordinate.js';
@@ -138,7 +138,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
     /**
      * Is the current block currently in the process of being disposed?
      */
-    private disposing;
+    protected disposing: boolean;
     /**
      * Has this block been fully initialized? E.g. all fields initailized.
      *

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,22 @@ 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;
+    /** 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;
     /**
      * @param block The block to drag.
      * @param workspace The workspace to drag on.
@@ -71,10 +79,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.
      *
@@ -83,6 +139,11 @@ export declare class BlockDragger implements IBlockDragger {
      *     at the start of the drag, in pixel units.
      */
     endDrag(e: PointerEvent, currentDragDeltaXY: Coordinate): void;
+    /**
+     * Moves the dragged block back to its original position before the start of
+     * the drag. Reconnects any parent and child blocks.
+     */
+    private moveToOriginalPosition;
     /**
      * Calculates the drag delta and new location values after a block is dragged.
      *
@@ -107,6 +168,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;
     /**

package/core/blockly.d.ts

@@ -28,6 +28,7 @@ import { ConnectionType } from './connection_type.js';
 import * as ContextMenu from './contextmenu.js';
 import * as ContextMenuItems from './contextmenu_items.js';
 import { ContextMenuRegistry } from './contextmenu_registry.js';
+import * as comments from './comments.js';
 import * as Css from './css.js';
 import { DeleteArea } from './delete_area.js';
 import * as dialog from './dialog.js';
@@ -36,14 +37,11 @@ import * as dropDownDiv from './dropdowndiv.js';
 import * as Events from './events/events.js';
 import * as Extensions from './extensions.js';
 import { Field, FieldConfig, FieldValidator, UnattachedFieldError } from './field.js';
-import { FieldAngle, FieldAngleConfig, FieldAngleFromJsonConfig, FieldAngleValidator } from './field_angle.js';
 import { FieldCheckbox, FieldCheckboxConfig, FieldCheckboxFromJsonConfig, FieldCheckboxValidator } from './field_checkbox.js';
-import { FieldColour, FieldColourConfig, FieldColourFromJsonConfig, FieldColourValidator } from './field_colour.js';
 import { FieldDropdown, FieldDropdownConfig, FieldDropdownFromJsonConfig, FieldDropdownValidator, MenuGenerator, MenuGeneratorFunction, MenuOption } from './field_dropdown.js';
 import { FieldImage, FieldImageConfig, FieldImageFromJsonConfig } from './field_image.js';
 import { FieldLabel, FieldLabelConfig, FieldLabelFromJsonConfig } from './field_label.js';
 import { FieldLabelSerializable } from './field_label_serializable.js';
-import { FieldMultilineInput, FieldMultilineInputConfig, FieldMultilineInputFromJsonConfig, FieldMultilineInputValidator } from './field_multilineinput.js';
 import { FieldNumber, FieldNumberConfig, FieldNumberFromJsonConfig, FieldNumberValidator } from './field_number.js';
 import * as fieldRegistry from './field_registry.js';
 import { FieldTextInput, FieldTextInputConfig, FieldTextInputFromJsonConfig, FieldTextInputValidator } from './field_textinput.js';
@@ -61,6 +59,7 @@ import { inject } from './inject.js';
 import { Input } from './inputs/input.js';
 import * as inputs from './inputs.js';
 import { InsertionMarkerManager } from './insertion_marker_manager.js';
+import { InsertionMarkerPreviewer } from './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 +70,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';
@@ -309,19 +309,17 @@ export { ConnectionType };
 export { ConnectionChecker };
 export { ConnectionDB };
 export { ContextMenuRegistry };
+export { comments };
 export { Cursor };
 export { DeleteArea };
 export { DragTarget };
 export declare const DropDownDiv: typeof dropDownDiv;
 export { Field, FieldConfig, FieldValidator, UnattachedFieldError };
-export { FieldAngle, FieldAngleConfig, FieldAngleFromJsonConfig, FieldAngleValidator, };
 export { FieldCheckbox, FieldCheckboxConfig, FieldCheckboxFromJsonConfig, FieldCheckboxValidator, };
-export { FieldColour, FieldColourConfig, FieldColourFromJsonConfig, FieldColourValidator, };
 export { FieldDropdown, FieldDropdownConfig, FieldDropdownFromJsonConfig, FieldDropdownValidator, MenuGenerator, MenuGeneratorFunction, MenuOption, };
 export { FieldImage, FieldImageConfig, FieldImageFromJsonConfig };
 export { FieldLabel, FieldLabelConfig, FieldLabelFromJsonConfig };
 export { FieldLabelSerializable };
-export { FieldMultilineInput, FieldMultilineInputConfig, FieldMultilineInputFromJsonConfig, FieldMultilineInputValidator, };
 export { FieldNumber, FieldNumberConfig, FieldNumberFromJsonConfig, FieldNumberValidator, };
 export { FieldTextInput, FieldTextInputConfig, FieldTextInputFromJsonConfig, FieldTextInputValidator, };
 export { FieldVariable, FieldVariableConfig, FieldVariableFromJsonConfig, FieldVariableValidator, };
@@ -343,6 +341,7 @@ export { IBubble };
 export { ICollapsibleToolboxItem };
 export { IComponent };
 export { IConnectionChecker };
+export { IConnectionPreviewer };
 export { IContextMenu };
 export { icons };
 export { ICopyable, isCopyable };
@@ -359,6 +358,7 @@ export { IMovable };
 export { Input };
 export { inputs };
 export { InsertionMarkerManager };
+export { InsertionMarkerPreviewer };
 export { IObservable, isObservable };
 export { IPaster, isPaster };
 export { IPositionable };

package/core/comments/comment_view.d.ts

@@ -0,0 +1,200 @@
+/**
+ * @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, Size } from '../utils.js';
+export declare class CommentView implements IRenderedElement {
+    private readonly workspace;
+    /** The root group element of the comment view. */
+    private svgRoot;
+    /** The rect background for the top bar. */
+    private topBar;
+    /** 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 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 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;
+    /**
+     * 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/workspace_comment.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @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 {
+    protected 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. */
+    private location;
+    /** Whether this comment has been disposed or not. */
+    private disposed;
+    /**
+     * 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);
+    /** 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): 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;
+}
+//# sourceMappingURL=workspace_comment.d.ts.map

package/core/comments.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @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';
+//# sourceMappingURL=comments.d.ts.map

package/core/events/events_click.d.ts

@@ -13,7 +13,7 @@ import { AbstractEventJson } from './events_abstract.js';
 import { UiBase } from './events_ui_base.js';
 import { Workspace } from '../workspace.js';
 /**
- * Notifies listeners that ome blockly element was clicked.
+ * Notifies listeners that some blockly element was clicked.
  */
 export declare class Click extends UiBase {
     /** The ID of the block that was clicked, if a block was clicked. */

package/core/field_dropdown.d.ts

@@ -148,6 +148,7 @@ export declare class FieldDropdown extends Field<string> {
      * @param newValue The input value.
      * @returns A valid language-neutral option, or null if invalid.
      */
+    protected doClassValidation_(newValue: string): string | null | undefined;
     protected doClassValidation_(newValue?: string): string | null;
     /**
      * Update the value of this dropdown field.

package/core/field_image.d.ts

@@ -134,7 +134,7 @@ export interface FieldImageConfig extends FieldConfig {
     alt?: string;
 }
 /**
- * fromJson config options for the colour field.
+ * fromJson config options for the image field.
  */
 export interface FieldImageFromJsonConfig extends FieldImageConfig {
     src?: string;

package/core/generator.d.ts

@@ -254,7 +254,7 @@ export declare class CodeGenerator {
      * @param _opt_thisOnly True to generate code for only this statement.
      * @returns Code with comments and subsequent blocks added.
      */
-    protected scrub_(_block: Block, code: string, _opt_thisOnly?: boolean): string;
+    scrub_(_block: Block, code: string, _opt_thisOnly?: boolean): string;
     /**
      * Hook for code to run at end of code generation.
      * Subclasses may override this, e.g. to prepend the generated code with

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.

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/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 {
     /**