blockly 9.3.0-beta.0 → 9.3.0

package/core/blockly.d.ts

@@ -10,6 +10,7 @@ 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 { BlockDragSurfaceSvg } from './block_drag_surface.js';
 import { BlockDragger } from './block_dragger.js';
 import { BlockSvg } from './block_svg.js';
 import { BlocklyOptions } from './blockly_options.js';
@@ -37,19 +38,19 @@ import { DragTarget } from './drag_target.js';
 import * as dropDownDiv from './dropdowndiv.js';
 import * as Events from './events/events.js';
 import * as Extensions from './extensions.js';
-import { Field, FieldValidator } from './field.js';
-import { FieldAngle, FieldAngleValidator } from './field_angle.js';
-import { FieldCheckbox, FieldCheckboxValidator } from './field_checkbox.js';
-import { FieldColour, FieldColourValidator } from './field_colour.js';
-import { FieldDropdown, FieldDropdownValidator, MenuGenerator, MenuGeneratorFunction, MenuOption } from './field_dropdown.js';
-import { FieldImage } from './field_image.js';
-import { FieldLabel } from './field_label.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, FieldMultilineInputValidator } from './field_multilineinput.js';
-import { FieldNumber, FieldNumberValidator } from './field_number.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, FieldTextInputValidator } from './field_textinput.js';
-import { FieldVariable, FieldVariableValidator } from './field_variable.js';
+import { FieldTextInput, FieldTextInputConfig, FieldTextInputFromJsonConfig, FieldTextInputValidator } from './field_textinput.js';
+import { FieldVariable, FieldVariableConfig, FieldVariableFromJsonConfig, FieldVariableValidator } from './field_variable.js';
 import { Flyout } from './flyout_base.js';
 import { FlyoutButton } from './flyout_button.js';
 import { HorizontalFlyout } from './flyout_horizontal.js';
@@ -91,6 +92,7 @@ import { ISelectableToolboxItem } from './interfaces/i_selectable_toolbox_item.j
 import { IStyleable } from './interfaces/i_styleable.js';
 import { IToolbox } from './interfaces/i_toolbox.js';
 import { IToolboxItem } from './interfaces/i_toolbox_item.js';
+import { IVariableBackedParameterModel, isVariableBackedParameterModel } from './interfaces/i_variable_backed_parameter_model.js';
 import { ASTNode } from './keyboard_nav/ast_node.js';
 import { BasicCursor } from './keyboard_nav/basic_cursor.js';
 import { Cursor } from './keyboard_nav/cursor.js';
@@ -141,6 +143,7 @@ import { Workspace } from './workspace.js';
 import { WorkspaceAudio } from './workspace_audio.js';
 import { WorkspaceComment } from './workspace_comment.js';
 import { WorkspaceCommentSvg } from './workspace_comment_svg.js';
+import { WorkspaceDragSurfaceSvg } from './workspace_drag_surface_svg.js';
 import { WorkspaceDragger } from './workspace_dragger.js';
 import { WorkspaceSvg } from './workspace_svg.js';
 import * as Xml from './xml.js';
@@ -154,68 +157,55 @@ import { ZoomControls } from './zoom_controls.js';
  * compiler to override this constant.
  *
  * @define {string}
- * @alias Blockly.VERSION
  */
 export declare const VERSION = "uncompiled";
 /**
  * @see Blockly.Input.Align.LEFT
- * @alias Blockly.ALIGN_LEFT
  */
 export declare const ALIGN_LEFT = Input.Align.LEFT;
 /**
  * @see Blockly.Input.Align.CENTRE
- * @alias Blockly.ALIGN_CENTRE
  */
 export declare const ALIGN_CENTRE = Input.Align.CENTRE;
 /**
  * @see Blockly.Input.Align.RIGHT
- * @alias Blockly.ALIGN_RIGHT
  */
 export declare const ALIGN_RIGHT = Input.Align.RIGHT;
 /**
  * @see ConnectionType.INPUT_VALUE
- * @alias Blockly.INPUT_VALUE
  */
 export declare const INPUT_VALUE = ConnectionType.INPUT_VALUE;
 /**
  * @see ConnectionType.OUTPUT_VALUE
- * @alias Blockly.OUTPUT_VALUE
  */
 export declare const OUTPUT_VALUE = ConnectionType.OUTPUT_VALUE;
 /**
  * @see ConnectionType.NEXT_STATEMENT
- * @alias Blockly.NEXT_STATEMENT
  */
 export declare const NEXT_STATEMENT = ConnectionType.NEXT_STATEMENT;
 /**
  * @see ConnectionType.PREVIOUS_STATEMENT
- * @alias Blockly.PREVIOUS_STATEMENT
  */
 export declare const PREVIOUS_STATEMENT = ConnectionType.PREVIOUS_STATEMENT;
 /**
  * @see inputTypes.DUMMY_INPUT
- * @alias Blockly.DUMMY_INPUT
  */
-export declare const DUMMY_INPUT: inputTypes;
+export declare const DUMMY_INPUT = inputTypes.DUMMY;
 /** Aliases for toolbox positions. */
 /**
  * @see toolbox.Position.TOP
- * @alias Blockly.TOOLBOX_AT_TOP
  */
 export declare const TOOLBOX_AT_TOP = utils.toolbox.Position.TOP;
 /**
  * @see toolbox.Position.BOTTOM
- * @alias Blockly.TOOLBOX_AT_BOTTOM
  */
 export declare const TOOLBOX_AT_BOTTOM = utils.toolbox.Position.BOTTOM;
 /**
  * @see toolbox.Position.LEFT
- * @alias Blockly.TOOLBOX_AT_LEFT
  */
 export declare const TOOLBOX_AT_LEFT = utils.toolbox.Position.LEFT;
 /**
  * @see toolbox.Position.RIGHT
- * @alias Blockly.TOOLBOX_AT_RIGHT
  */
 export declare const TOOLBOX_AT_RIGHT = utils.toolbox.Position.RIGHT;
 /**
@@ -227,7 +217,6 @@ export declare const TOOLBOX_AT_RIGHT = utils.toolbox.Position.RIGHT;
  *
  * @param workspace Any workspace in the SVG.
  * @see Blockly.common.svgResize
- * @alias Blockly.svgResize
  */
 export declare const svgResize: typeof common.svgResize;
 /**
@@ -235,7 +224,6 @@ export declare const svgResize: typeof common.svgResize;
  *
  * @param opt_onlyClosePopups Whether only popups should be closed.
  * @see Blockly.WorkspaceSvg.hideChaff
- * @alias Blockly.hideChaff
  */
 export declare function hideChaff(opt_onlyClosePopups?: boolean): void;
 /**
@@ -244,13 +232,10 @@ export declare function hideChaff(opt_onlyClosePopups?: boolean): void;
  * Blockly instances on a page.
  *
  * @see Blockly.common.getMainWorkspace
- * @alias Blockly.getMainWorkspace
  */
 export declare const getMainWorkspace: typeof common.getMainWorkspace;
 /**
  * Returns the currently selected copyable object.
- *
- * @alias Blockly.common.getSelected
  */
 export declare const getSelected: typeof common.getSelected;
 /**
@@ -259,7 +244,6 @@ export declare const getSelected: typeof common.getSelected;
  *
  * @param jsonArray An array of JSON block definitions.
  * @see Blockly.common.defineBlocksWithJsonArray
- * @alias Blockly.defineBlocksWithJsonArray
  */
 export declare const defineBlocksWithJsonArray: typeof common.defineBlocksWithJsonArray;
 /**
@@ -270,7 +254,6 @@ export declare const defineBlocksWithJsonArray: typeof common.defineBlocksWithJs
  *
  * @param container The container element.
  * @see Blockly.common.setParentContainer
- * @alias Blockly.setParentContainer
  */
 export declare const setParentContainer: typeof common.setParentContainer;
 /**
@@ -280,7 +263,6 @@ export declare const setParentContainer: typeof common.setParentContainer;
  * @param workspace The workspace to resize.
  * @deprecated Use **workspace.resizeContents** instead.
  * @see Blockly.WorkspaceSvg.resizeContents
- * @alias Blockly.resizeSvgContents
  */
 declare function resizeSvgContentsLocal(workspace: WorkspaceSvg): void;
 export declare const resizeSvgContents: typeof resizeSvgContentsLocal;
@@ -290,7 +272,6 @@ export declare const resizeSvgContents: typeof resizeSvgContentsLocal;
  * @param toCopy Block or Workspace Comment to be copied.
  * @deprecated Use **Blockly.clipboard.copy** instead.
  * @see Blockly.clipboard.copy
- * @alias Blockly.copy
  */
 export declare function copy(toCopy: ICopyable): void;
 /**
@@ -299,7 +280,6 @@ export declare function copy(toCopy: ICopyable): void;
  * @returns True if the paste was successful, false otherwise.
  * @deprecated Use **Blockly.clipboard.paste** instead.
  * @see Blockly.clipboard.paste
- * @alias Blockly.paste
  */
 export declare function paste(): boolean;
 /**
@@ -308,7 +288,6 @@ export declare function paste(): boolean;
  * @param toDuplicate Block or Workspace Comment to be copied.
  * @deprecated Use **Blockly.clipboard.duplicate** instead.
  * @see Blockly.clipboard.duplicate
- * @alias Blockly.duplicate
  */
 export declare function duplicate(toDuplicate: ICopyable): void;
 /**
@@ -318,7 +297,6 @@ export declare function duplicate(toDuplicate: ICopyable): void;
  * @returns True if number, false otherwise.
  * @deprecated Use **Blockly.utils.string.isNumber** instead.
  * @see Blockly.utils.string.isNumber
- * @alias Blockly.isNumber
  */
 export declare function isNumber(str: string): boolean;
 /**
@@ -328,7 +306,6 @@ export declare function isNumber(str: string): boolean;
  * @returns RGB code, e.g. '#5ba65b'.
  * @deprecated Use **Blockly.utils.colour.hueToHex** instead.
  * @see Blockly.utils.colour.hueToHex
- * @alias Blockly.hueToHex
  */
 export declare function hueToHex(hue: number): string;
 /**
@@ -344,7 +321,6 @@ export declare function hueToHex(hue: number): string;
  * @returns Opaque data that can be passed to unbindEvent_.
  * @deprecated Use **Blockly.browserEvents.bind** instead.
  * @see Blockly.browserEvents.bind
- * @alias Blockly.bindEvent_
  */
 export declare function bindEvent_(node: EventTarget, name: string, thisObject: Object | null, func: Function): browserEvents.Data;
 /**
@@ -355,7 +331,6 @@ export declare function bindEvent_(node: EventTarget, name: string, thisObject:
  * @returns The function call.
  * @deprecated Use **Blockly.browserEvents.unbind** instead.
  * @see browserEvents.unbind
- * @alias Blockly.unbindEvent_
  */
 export declare function unbindEvent_(bindData: browserEvents.Data): Function;
 /**
@@ -375,7 +350,6 @@ export declare function unbindEvent_(bindData: browserEvents.Data): Function;
  * @returns Opaque data that can be passed to unbindEvent_.
  * @deprecated Use **Blockly.browserEvents.conditionalBind** instead.
  * @see browserEvents.conditionalBind
- * @alias Blockly.bindEventWithChecks_
  */
 export declare function bindEventWithChecks_(node: EventTarget, name: string, thisObject: Object | null, func: Function, opt_noCaptureIdentifier?: boolean, _opt_noPreventDefault?: boolean): browserEvents.Data;
 export declare const COLLAPSE_CHARS = 30;
@@ -389,24 +363,18 @@ export declare const COLLAPSED_FIELD_NAME = "_TEMP_COLLAPSED_FIELD";
  * String for use in the "custom" attribute of a category in toolbox XML.
  * This string indicates that the category should be dynamically populated with
  * variable blocks.
- *
- * @alias Blockly.VARIABLE_CATEGORY_NAME
  */
 export declare const VARIABLE_CATEGORY_NAME: string;
 /**
  * String for use in the "custom" attribute of a category in toolbox XML.
  * This string indicates that the category should be dynamically populated with
  * variable blocks.
- *
- * @alias Blockly.VARIABLE_DYNAMIC_CATEGORY_NAME
  */
 export declare const VARIABLE_DYNAMIC_CATEGORY_NAME: string;
 /**
  * String for use in the "custom" attribute of a category in toolbox XML.
  * This string indicates that the category should be dynamically populated with
  * procedure blocks.
- *
- * @alias Blockly.PROCEDURE_CATEGORY_NAME
  */
 export declare const PROCEDURE_CATEGORY_NAME: string;
 export { browserEvents };
@@ -445,6 +413,7 @@ export { BasicCursor };
 export { Block };
 export { BlocklyOptions };
 export { BlockDragger };
+export { BlockDragSurfaceSvg };
 export { BlockSvg };
 export { Blocks };
 export { Bubble };
@@ -461,18 +430,18 @@ export { Cursor };
 export { DeleteArea };
 export { DragTarget };
 export declare const DropDownDiv: typeof dropDownDiv;
-export { Field, FieldValidator };
-export { FieldAngle, FieldAngleValidator };
-export { FieldCheckbox, FieldCheckboxValidator };
-export { FieldColour, FieldColourValidator };
-export { FieldDropdown, FieldDropdownValidator, MenuGenerator, MenuGeneratorFunction, MenuOption, };
-export { FieldImage };
-export { FieldLabel };
+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, FieldMultilineInputValidator };
-export { FieldNumber, FieldNumberValidator };
-export { FieldTextInput, FieldTextInputValidator };
-export { FieldVariable, FieldVariableValidator };
+export { FieldMultilineInput, FieldMultilineInputConfig, FieldMultilineInputFromJsonConfig, FieldMultilineInputValidator, };
+export { FieldNumber, FieldNumberConfig, FieldNumberFromJsonConfig, FieldNumberValidator, };
+export { FieldTextInput, FieldTextInputConfig, FieldTextInputFromJsonConfig, FieldTextInputValidator, };
+export { FieldVariable, FieldVariableConfig, FieldVariableFromJsonConfig, FieldVariableValidator, };
 export { Flyout };
 export { FlyoutButton };
 export { FlyoutMetricsManager };
@@ -513,6 +482,7 @@ export { ISelectableToolboxItem };
 export { IStyleable };
 export { IToolbox };
 export { IToolboxItem };
+export { IVariableBackedParameterModel, isVariableBackedParameterModel };
 export { Marker };
 export { MarkerManager };
 export { Menu };
@@ -542,6 +512,7 @@ export { Workspace };
 export { WorkspaceAudio };
 export { WorkspaceComment };
 export { WorkspaceCommentSvg };
+export { WorkspaceDragSurfaceSvg };
 export { WorkspaceDragger };
 export { WorkspaceSvg };
 export { ZoomControls };

package/core/blockly_options.d.ts

@@ -8,8 +8,6 @@ import type { WorkspaceSvg } from './workspace_svg.js';
 import type { ToolboxDefinition } from './utils/toolbox.js';
 /**
  * Blockly options.
- *
- * @alias Blockly.BlocklyOptions
  */
 export interface BlocklyOptions {
     collapse?: boolean;

package/core/blocks.d.ts

@@ -10,8 +10,6 @@
 export type BlockDefinition = any;
 /**
  * A mapping of block type names to block prototype objects.
- *
- * @alias Blockly.blocks.Blocks
  */
 export declare const Blocks: {
     [key: string]: BlockDefinition;

package/core/browser_events.d.ts

@@ -6,8 +6,6 @@
 /**
  * Blockly opaque event data used to unbind events when using
  * `bind` and `conditionalBind`.
- *
- * @alias Blockly.browserEvents.Data
  */
 export type Data = [EventTarget, string, (e: Event) => void][];
 /**
@@ -25,7 +23,6 @@ export type Data = [EventTarget, string, (e: Event) => void][];
  *     simultaneous touches.  False by default.
  * @param opt_noPreventDefault No-op, deprecated and will be removed in v10.
  * @returns Opaque data that can be passed to unbindEvent_.
- * @alias Blockly.browserEvents.conditionalBind
  */
 export declare function conditionalBind(node: EventTarget, name: string, thisObject: Object | null, func: Function, opt_noCaptureIdentifier?: boolean, opt_noPreventDefault?: boolean): Data;
 /**
@@ -39,7 +36,6 @@ export declare function conditionalBind(node: EventTarget, name: string, thisObj
  * @param thisObject The value of 'this' in the function.
  * @param func Function to call when event is triggered.
  * @returns Opaque data that can be passed to unbindEvent_.
- * @alias Blockly.browserEvents.bind
  */
 export declare function bind(node: EventTarget, name: string, thisObject: Object | null, func: Function): Data;
 /**
@@ -48,7 +44,6 @@ export declare function bind(node: EventTarget, name: string, thisObject: Object
  * @param bindData Opaque data from bindEvent_.
  *     This list is emptied during the course of calling this function.
  * @returns The function call.
- * @alias Blockly.browserEvents.unbind
  */
 export declare function unbind(bindData: Data): (e: Event) => void;
 /**
@@ -56,7 +51,6 @@ export declare function unbind(bindData: Data): (e: Event) => void;
  *
  * @param e An event.
  * @returns True if text input.
- * @alias Blockly.browserEvents.isTargetInput
  */
 export declare function isTargetInput(e: Event): boolean;
 /**
@@ -64,7 +58,6 @@ export declare function isTargetInput(e: Event): boolean;
  *
  * @param e Mouse event.
  * @returns True if right-click.
- * @alias Blockly.browserEvents.isRightButton
  */
 export declare function isRightButton(e: MouseEvent): boolean;
 /**
@@ -75,7 +68,6 @@ export declare function isRightButton(e: MouseEvent): boolean;
  * @param svg SVG element.
  * @param matrix Inverted screen CTM to use.
  * @returns Object with .x and .y properties.
- * @alias Blockly.browserEvents.mouseToSvg
  */
 export declare function mouseToSvg(e: MouseEvent, svg: SVGSVGElement, matrix: SVGMatrix | null): SVGPoint;
 /**
@@ -83,7 +75,6 @@ export declare function mouseToSvg(e: MouseEvent, svg: SVGSVGElement, matrix: SV
  *
  * @param e Mouse event.
  * @returns Scroll delta object with .x and .y properties.
- * @alias Blockly.browserEvents.getScrollDeltaPixels
  */
 export declare function getScrollDeltaPixels(e: WheelEvent): {
     x: number;

package/core/bubble.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2012 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { BlockDragSurfaceSvg } from './block_drag_surface.js';
 import type { BlockSvg } from './block_svg.js';
 import type { IBubble } from './interfaces/i_bubble.js';
 import { Coordinate } from './utils/coordinate.js';
@@ -10,8 +11,6 @@ import { Size } from './utils/size.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for UI bubble.
- *
- * @alias Blockly.Bubble
  */
 export declare class Bubble implements IBubble {
     /** Width of the border around the bubble. */
@@ -253,12 +252,15 @@ export declare class Bubble implements IBubble {
     /** Dispose of this bubble. */
     dispose(): void;
     /**
-     * Move this bubble during a drag.
+     * Move this bubble during a drag, taking into account whether or not there is
+     * a drag surface.
      *
+     * @param dragSurface The surface that carries rendered items during a drag,
+     *     or null if no drag surface is in use.
      * @param newLoc The location to translate to, in workspace coordinates.
      * @internal
      */
-    moveDuringDrag(newLoc: Coordinate): void;
+    moveDuringDrag(dragSurface: BlockDragSurfaceSvg, newLoc: Coordinate): void;
     /**
      * Return the coordinates of the top-left corner of this bubble's body
      * relative to the drawing surface's origin (0,0), in workspace units.

package/core/bubble_dragger.d.ts

@@ -10,8 +10,6 @@ import type { WorkspaceSvg } from './workspace_svg.js';
  * Class for a bubble dragger.  It moves things on the bubble canvas around the
  * workspace when they are being dragged by a mouse or touch.  These can be
  * block comments, mutators, warnings, or workspace comments.
- *
- * @alias Blockly.BubbleDragger
  */
 export declare class BubbleDragger {
     private bubble;
@@ -21,13 +19,14 @@ export declare class BubbleDragger {
     /** Whether the bubble would be deleted if dropped immediately. */
     private wouldDeleteBubble_;
     private readonly startXY_;
+    private dragSurface_;
     /**
      * @param bubble The item on the bubble canvas to drag.
      * @param workspace The workspace to drag on.
      */
     constructor(bubble: IBubble, workspace: WorkspaceSvg);
     /**
-     * Start dragging a bubble.
+     * Start dragging a bubble.  This includes moving it to the drag surface.
      *
      * @internal
      */

package/core/bump_objects.d.ts

@@ -15,7 +15,6 @@ import type { WorkspaceSvg } from './workspace_svg.js';
  *    in workspace coordinates.
  * @param object The object to bump.
  * @returns True if block was bumped.
- * @alias Blockly.bumpObjects.bumpIntoBounds
  */
 declare function bumpObjectIntoBounds(workspace: WorkspaceSvg, scrollMetrics: ContainerRegion, object: IBoundedElement): boolean;
 export declare const bumpIntoBounds: typeof bumpObjectIntoBounds;
@@ -24,14 +23,12 @@ export declare const bumpIntoBounds: typeof bumpObjectIntoBounds;
  *
  * @param workspace The workspace to handle.
  * @returns The event handler.
- * @alias Blockly.bumpObjects.bumpIntoBoundsHandler
  */
 export declare function bumpIntoBoundsHandler(workspace: WorkspaceSvg): (p1: Abstract) => void;
 /**
  * Bumps the top objects in the given workspace into bounds.
  *
  * @param workspace The workspace.
- * @alias Blockly.bumpObjects.bumpTopObjectsIntoBounds
  */
 export declare function bumpTopObjectsIntoBounds(workspace: WorkspaceSvg): void;
 export {};

package/core/clipboard.d.ts

@@ -8,7 +8,6 @@ import type { ICopyable } from './interfaces/i_copyable.js';
  * Copy a block or workspace comment onto the local clipboard.
  *
  * @param toCopy Block or Workspace Comment to be copied.
- * @alias Blockly.clipboard.copy
  * @internal
  */
 export declare function copy(toCopy: ICopyable): void;
@@ -20,7 +19,6 @@ declare function copyInternal(toCopy: ICopyable): void;
  * Paste a block or workspace comment on to the main workspace.
  *
  * @returns The pasted thing if the paste was successful, null otherwise.
- * @alias Blockly.clipboard.paste
  * @internal
  */
 export declare function paste(): ICopyable | null;
@@ -30,7 +28,6 @@ export declare function paste(): ICopyable | null;
  * @param toDuplicate Block or Workspace Comment to be duplicated.
  * @returns The block or workspace comment that was duplicated, or null if the
  *     duplication failed.
- * @alias Blockly.clipboard.duplicate
  * @internal
  */
 export declare function duplicate(toDuplicate: ICopyable): ICopyable | null;

package/core/comment.d.ts

@@ -10,8 +10,6 @@ import { Icon } from './icon.js';
 import type { Size } from './utils/size.js';
 /**
  * Class for a comment.
- *
- * @alias Blockly.Comment
  */
 export declare class Comment extends Icon {
     private readonly model;
@@ -20,14 +18,12 @@ export declare class Comment extends Icon {
      * Used to tell if an event should be fired at the end of an edit.
      */
     private cachedText;
-    /** Mouse up event data. */
-    private onMouseUpWrapper;
-    /** Wheel event data. */
-    private onWheelWrapper;
-    /** Change event data. */
-    private onChangeWrapper;
-    /** Input event data. */
-    private onInputWrapper;
+    /**
+     * Array holding info needed to unbind events.
+     * Used for disposing.
+     * Ex: [[node, name, func], [node, name, func]].
+     */
+    private boundEvents;
     /**
      * The SVG element that contains the text edit area, or null if not created.
      */

package/core/common.d.ts

@@ -40,20 +40,16 @@ export declare function unregisterWorkpace(workspace: Workspace): void;
  * page.
  *
  * @returns The main workspace.
- * @alias Blockly.common.getMainWorkspace
  */
 export declare function getMainWorkspace(): Workspace;
 /**
  * Sets last used main workspace.
  *
  * @param workspace The most recently used top level workspace.
- * @alias Blockly.common.setMainWorkspace
  */
 export declare function setMainWorkspace(workspace: Workspace): void;
 /**
  * Returns the currently selected copyable object.
- *
- * @alias Blockly.common.getSelected
  */
 export declare function getSelected(): ICopyable | null;
 /**
@@ -62,7 +58,6 @@ export declare function getSelected(): ICopyable | null;
  * programmatically select a block, use `BlockSvg#select`.
  *
  * @param newSelection The newly selected block.
- * @alias Blockly.common.setSelected
  * @internal
  */
 export declare function setSelected(newSelection: ICopyable | null): void;
@@ -71,7 +66,6 @@ export declare function setSelected(newSelection: ICopyable | null): void;
  * Tooltip.
  *
  * @returns The parent container.
- * @alias Blockly.common.getParentContainer
  */
 export declare function getParentContainer(): Element | null;
 /**
@@ -81,7 +75,6 @@ export declare function getParentContainer(): Element | null;
  * This method is a NOP if called after the first `Blockly.inject`.
  *
  * @param newParent The container element.
- * @alias Blockly.common.setParentContainer
  */
 export declare function setParentContainer(newParent: Element): void;
 /**
@@ -92,7 +85,6 @@ export declare function setParentContainer(newParent: Element): void;
  * Record the height/width of the SVG image.
  *
  * @param workspace Any workspace in the SVG.
- * @alias Blockly.common.svgResize
  */
 export declare function svgResize(workspace: WorkspaceSvg): void;
 /**
@@ -108,7 +100,6 @@ export declare const draggingConnections: Connection[];
  *    statements (blocks that are not inside a value or statement input
  *    of the block).
  * @returns Map of types to type counts for descendants of the bock.
- * @alias Blockly.common.getBlockTypeCounts
  */
 export declare function getBlockTypeCounts(block: Block, opt_stripFollowing?: boolean): {
     [key: string]: number;
@@ -118,7 +109,6 @@ export declare function getBlockTypeCounts(block: Block, opt_stripFollowing?: bo
  * by the Blockly Developer Tools.
  *
  * @param jsonArray An array of JSON block definitions.
- * @alias Blockly.common.defineBlocksWithJsonArray
  */
 export declare function defineBlocksWithJsonArray(jsonArray: any[]): void;
 /**
@@ -132,7 +122,6 @@ declare function defineBlocksWithJsonArrayInternal(jsonArray: any[]): void;
  * @param jsonArray An array of JSON block definitions.
  * @returns A map of the block
  *     definitions created.
- * @alias Blockly.common.defineBlocksWithJsonArray
  */
 export declare function createBlockDefinitionsFromJsonArray(jsonArray: any[]): {
     [key: string]: BlockDefinition;
@@ -143,7 +132,6 @@ export declare function createBlockDefinitionsFromJsonArray(jsonArray: any[]): {
  *
  * @param blocks A map of block
  *     type names to block definitions.
- * @alias Blockly.common.defineBlocks
  */
 export declare function defineBlocks(blocks: {
     [key: string]: BlockDefinition;

package/core/component_manager.d.ts

@@ -25,8 +25,6 @@ declare class Capability<_T> {
 }
 /**
  * Manager for all items registered with the workspace.
- *
- * @alias Blockly.ComponentManager
  */
 export declare class ComponentManager {
     static Capability: typeof Capability;

package/core/connection.d.ts

@@ -10,8 +10,6 @@ import type { IConnectionChecker } from './interfaces/i_connection_checker.js';
 import * as blocks from './serialization/blocks.js';
 /**
  * Class for a connection between blocks.
- *
- * @alias Blockly.Connection
  */
 export declare class Connection implements IASTNodeLocationWithBlock {
     type: number;
@@ -111,15 +109,30 @@ export declare class Connection implements IASTNodeLocationWithBlock {
      * @returns Whether the the blocks are now connected or not.
      */
     connect(otherConnection: Connection): boolean;
-    /** Disconnect this connection. */
+    /**
+     * Disconnect this connection.
+     */
     disconnect(): void;
     /**
      * Disconnect two blocks that are connected by this connection.
      *
-     * @param parentBlock The superior block.
-     * @param childBlock The inferior block.
+     * @param setParent Whether to set the parent of the disconnected block or
+     *     not, defaults to true.
+     *     If you do not set the parent, ensure that a subsequent action does,
+     *     otherwise the view and model will be out of sync.
+     */
+    protected disconnectInternal(setParent?: boolean): void;
+    /**
+     * Returns the parent connection (superior) and child connection (inferior)
+     * given this connection and the connection it is connected to.
+     *
+     * @returns The parent connection and child connection, given this connection
+     *     and the connection it is connected to.
      */
-    protected disconnectInternal_(parentBlock: Block, childBlock: Block): void;
+    protected getParentAndChildConnections(): {
+        parentConnection?: Connection;
+        childConnection?: Connection;
+    };
     /**
      * Respawn the shadow block if there was one connected to the this connection.
      */