blockly 9.3.0-beta.0 → 9.3.0

package/core/field_multilineinput.d.ts

@@ -3,20 +3,17 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { Field } from './field.js';
 import { FieldTextInput, FieldTextInputConfig, FieldTextInputValidator } from './field_textinput.js';
-import type { Sentinel } from './utils/sentinel.js';
-export type FieldMultilineInputValidator = FieldTextInputValidator;
 /**
  * Class for an editable text area field.
- *
- * @alias Blockly.FieldMultilineInput
  */
 export declare class FieldMultilineInput extends FieldTextInput {
     /**
      * The SVG group element that will contain a text element for each text row
      *     when initialized.
      */
-    textGroup_: SVGGElement;
+    textGroup: SVGGElement | null;
     /**
      * Defines the maximum number of lines of field.
      * If exceeded, scrolling functionality is enabled.
@@ -25,21 +22,26 @@ export declare class FieldMultilineInput extends FieldTextInput {
     /** Whether Y overflow is currently occurring. */
     protected isOverflowedY_: boolean;
     /**
-     * @param opt_value The initial content of the field. Should cast to a string.
+     * @param value The initial content of the field. Should cast to a string.
      *     Defaults to an empty string if null or undefined. Also accepts
      *     Field.SKIP_SETUP if you wish to skip setup (only used by subclasses
      *     that want to handle configuration and setting the field value after
      *     their own constructors have run).
-     * @param opt_validator An optional function that is called to validate any
+     * @param validator An optional function that is called to validate any
      *     constraints on what the user entered.  Takes the new text as an
      *     argument and returns either the accepted text, a replacement text, or
      *     null to abort the change.
-     * @param opt_config A map of options used to configure the field.
+     * @param config A map of options used to configure the field.
      *     See the [field creation documentation]{@link
      * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/multiline-text-input#creation}
      * for a list of properties this parameter supports.
      */
-    constructor(opt_value?: string | Sentinel, opt_validator?: FieldMultilineInputValidator, opt_config?: FieldMultilineInputConfig);
+    constructor(value?: string | typeof Field.SKIP_SETUP, validator?: FieldMultilineInputValidator, config?: FieldMultilineInputConfig);
+    /**
+     * Configure the field based on the given map of options.
+     *
+     * @param config A map of options to configure the field based on.
+     */
     protected configure_(config: FieldMultilineInputConfig): void;
     /**
      * Serializes this field's value to XML. Should only be called by Blockly.Xml.
@@ -60,6 +62,8 @@ export declare class FieldMultilineInput extends FieldTextInput {
     fromXml(fieldElement: Element): void;
     /**
      * Saves this field's value.
+     * This function only exists for subclasses of FieldMultilineInput which
+     * predate the load/saveState API and only define to/fromXml.
      *
      * @returns The state of this field.
      * @internal
@@ -67,6 +71,8 @@ export declare class FieldMultilineInput extends FieldTextInput {
     saveState(): any;
     /**
      * Sets the field's value based on the given state.
+     * This function only exists for subclasses of FieldMultilineInput which
+     * predate the load/saveState API and only define to/fromXml.
      *
      * @param state The state of the variable to assign to this variable field.
      * @internal
@@ -104,12 +110,12 @@ export declare class FieldMultilineInput extends FieldTextInput {
      * Overrides the default behaviour to force rerender in order to
      * correct block size, based on editor text.
      *
-     * @param _opt_e Optional mouse event that triggered the field to open, or
+     * @param e Optional mouse event that triggered the field to open, or
      *     undefined if triggered programmatically.
-     * @param opt_quietInput True if editor should be created without focus.
+     * @param quietInput True if editor should be created without focus.
      *     Defaults to false.
      */
-    showEditor_(_opt_e?: Event, opt_quietInput?: boolean): void;
+    showEditor_(e?: Event, quietInput?: boolean): void;
     /**
      * Create the text input editor widget.
      *
@@ -159,4 +165,20 @@ export interface FieldMultilineInputConfig extends FieldTextInputConfig {
 export interface FieldMultilineInputFromJsonConfig extends FieldMultilineInputConfig {
     text?: string;
 }
+/**
+ * A function that is called to validate changes to the field's value before
+ * they are set.
+ *
+ * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @param newValue The value to be validated.
+ * @returns One of three instructions for setting the new value: `T`, `null`,
+ * or `undefined`.
+ *
+ * - `T` to set this function's returned value instead of `newValue`.
+ *
+ * - `null` to invoke `doValueInvalid_` and not set a value.
+ *
+ * - `undefined` to set `newValue` as is.
+ */
+export type FieldMultilineInputValidator = FieldTextInputValidator;
 //# sourceMappingURL=field_multilineinput.d.ts.map

package/core/field_number.d.ts

@@ -3,13 +3,10 @@
  * Copyright 2016 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { Field } from './field.js';
 import { FieldInput, FieldInputConfig, FieldInputValidator } from './field_input.js';
-import type { Sentinel } from './utils/sentinel.js';
-export type FieldNumberValidator = FieldInputValidator<number>;
 /**
  * Class for an editable number field.
- *
- * @alias Blockly.FieldNumber
  */
 export declare class FieldNumber extends FieldInput<number> {
     /** The minimum value this number field can contain. */
@@ -23,33 +20,28 @@ export declare class FieldNumber extends FieldInput<number> {
      * decimal digits.
      */
     private decimalPlaces_;
-    /**
-     * Serializable fields are saved by the serializer, non-serializable fields
-     * are not. Editable fields should also be serializable.
-     */
-    SERIALIZABLE: boolean;
     /** Don't spellcheck numbers.  Our validator does a better job. */
     protected spellcheck_: boolean;
     /**
-     * @param opt_value The initial value of the field. Should cast to a number.
+     * @param value The initial value of the field. Should cast to a number.
      *     Defaults to 0. Also accepts Field.SKIP_SETUP if you wish to skip setup
      *     (only used by subclasses that want to handle configuration and setting
      *     the field value after their own constructors have run).
-     * @param opt_min Minimum value. Will only be used if opt_config is not
+     * @param min Minimum value. Will only be used if config is not
      *     provided.
-     * @param opt_max Maximum value. Will only be used if opt_config is not
+     * @param max Maximum value. Will only be used if config is not
      *     provided.
-     * @param opt_precision Precision for value. Will only be used if opt_config
+     * @param precision Precision for value. Will only be used if config
      *     is not provided.
-     * @param opt_validator A function that is called to validate changes to the
+     * @param validator A function that is called to validate changes to the
      *     field's value. Takes in a number & returns a validated number, or null
      *     to abort the change.
-     * @param opt_config A map of options used to configure the field.
+     * @param config A map of options used to configure the field.
      *     See the [field creation documentation]{@link
      * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/number#creation}
      * for a list of properties this parameter supports.
      */
-    constructor(opt_value?: string | number | Sentinel, opt_min?: string | number | null, opt_max?: string | number | null, opt_precision?: string | number | null, opt_validator?: FieldNumberValidator | null, opt_config?: FieldNumberConfig);
+    constructor(value?: string | number | typeof Field.SKIP_SETUP, min?: string | number | null, max?: string | number | null, precision?: string | number | null, validator?: FieldNumberValidator | null, config?: FieldNumberConfig);
     /**
      * Configure the field based on the given map of options.
      *
@@ -138,16 +130,16 @@ export declare class FieldNumber extends FieldInput<number> {
      * Ensure that the input value is a valid number (must fulfill the
      * constraints placed on the field).
      *
-     * @param opt_newValue The input value.
+     * @param newValue The input value.
      * @returns A valid number, or null if invalid.
      */
-    protected doClassValidation_(opt_newValue?: any): number | null;
+    protected doClassValidation_(newValue?: any): number | null;
     /**
      * Create the number input editor widget.
      *
      * @returns The newly created number input editor.
      */
-    protected widgetCreate_(): HTMLElement;
+    protected widgetCreate_(): HTMLInputElement;
     /**
      * Construct a FieldNumber from a JSON arg object.
      *
@@ -172,4 +164,20 @@ export interface FieldNumberConfig extends FieldInputConfig {
 export interface FieldNumberFromJsonConfig extends FieldNumberConfig {
     value?: number;
 }
+/**
+ * A function that is called to validate changes to the field's value before
+ * they are set.
+ *
+ * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @param newValue The value to be validated.
+ * @returns One of three instructions for setting the new value: `T`, `null`,
+ * or `undefined`.
+ *
+ * - `T` to set this function's returned value instead of `newValue`.
+ *
+ * - `null` to invoke `doValueInvalid_` and not set a value.
+ *
+ * - `undefined` to set `newValue` as is.
+ */
+export type FieldNumberValidator = FieldInputValidator<number>;
 //# sourceMappingURL=field_number.d.ts.map

package/core/field_registry.d.ts

@@ -18,14 +18,12 @@ interface RegistryOptions {
  *     construct an instance of the field.
  * @throws {Error} if the type name is empty, the field is already registered,
  *     or the fieldClass is not an object containing a fromJson function.
- * @alias Blockly.fieldRegistry.register
  */
 export declare function register(type: string, fieldClass: FieldProto): void;
 /**
  * Unregisters the field registered with the given type.
  *
  * @param type The field type name as used in the JSON definition.
- * @alias Blockly.fieldRegistry.unregister
  */
 export declare function unregister(type: string): void;
 /**
@@ -37,7 +35,6 @@ export declare function unregister(type: string): void;
  *     type.
  * @returns The new field instance or null if a field wasn't found with the
  *     given type name
- * @alias Blockly.fieldRegistry.fromJson
  * @internal
  */
 export declare function fromJson<T>(options: RegistryOptions): Field<T> | null;

package/core/field_textinput.d.ts

@@ -4,37 +4,34 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import './events/events_block_change.js';
+import { Field } from './field.js';
 import { FieldInput, FieldInputConfig, FieldInputValidator } from './field_input.js';
-import type { Sentinel } from './utils/sentinel.js';
-export type FieldTextInputValidator = FieldInputValidator<string>;
 /**
  * Class for an editable text field.
- *
- * @alias Blockly.FieldTextInput
  */
 export declare class FieldTextInput extends FieldInput<string> {
     /**
-     * @param opt_value The initial value of the field. Should cast to a string.
+     * @param value The initial value of the field. Should cast to a string.
      *     Defaults to an empty string if null or undefined. Also accepts
      *     Field.SKIP_SETUP if you wish to skip setup (only used by subclasses
      *     that want to handle configuration and setting the field value after
      *     their own constructors have run).
-     * @param opt_validator A function that is called to validate changes to the
+     * @param validator A function that is called to validate changes to the
      *     field's value. Takes in a string & returns a validated string, or null
      *     to abort the change.
-     * @param opt_config A map of options used to configure the field.
+     * @param config A map of options used to configure the field.
      *     See the [field creation documentation]{@link
      * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/text-input#creation}
      * for a list of properties this parameter supports.
      */
-    constructor(opt_value?: string | Sentinel, opt_validator?: FieldTextInputValidator | null, opt_config?: FieldInputConfig);
+    constructor(value?: string | typeof Field.SKIP_SETUP, validator?: FieldTextInputValidator | null, config?: FieldTextInputConfig);
     /**
      * Ensure that the input value casts to a valid string.
      *
-     * @param opt_newValue The input value.
+     * @param newValue The input value.
      * @returns A valid string, or null if invalid.
      */
-    protected doClassValidation_(opt_newValue?: any): string | null;
+    protected doClassValidation_(newValue?: any): string | null;
     /**
      * Construct a FieldTextInput from a JSON arg object,
      * dereferencing any string table references.
@@ -46,11 +43,30 @@ export declare class FieldTextInput extends FieldInput<string> {
      */
     static fromJson(options: FieldTextInputFromJsonConfig): FieldTextInput;
 }
+/**
+ *  Config options for the text input field.
+ */
+export type FieldTextInputConfig = FieldInputConfig;
 /**
  * fromJson config options for the text input field.
  */
-export interface FieldTextInputFromJsonConfig extends FieldInputConfig {
+export interface FieldTextInputFromJsonConfig extends FieldTextInputConfig {
     text?: string;
 }
-export { FieldInputConfig as FieldTextInputConfig };
+/**
+ * A function that is called to validate changes to the field's value before
+ * they are set.
+ *
+ * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @param newValue The value to be validated.
+ * @returns One of three instructions for setting the new value: `T`, `null`,
+ * or `undefined`.
+ *
+ * - `T` to set this function's returned value instead of `newValue`.
+ *
+ * - `null` to invoke `doValueInvalid_` and not set a value.
+ *
+ * - `undefined` to set `newValue` as is.
+ */
+export type FieldTextInputValidator = FieldInputValidator<string>;
 //# sourceMappingURL=field_textinput.d.ts.map

package/core/field_variable.d.ts

@@ -5,18 +5,14 @@
  */
 import './events/events_block_change.js';
 import type { Block } from './block.js';
-import { FieldConfig } from './field.js';
+import { Field, FieldConfig } from './field.js';
 import { FieldDropdown, FieldDropdownValidator, MenuGenerator, MenuOption } from './field_dropdown.js';
 import type { Menu } from './menu.js';
 import type { MenuItem } from './menuitem.js';
-import type { Sentinel } from './utils/sentinel.js';
 import { Size } from './utils/size.js';
 import { VariableModel } from './variable_model.js';
-export type FieldVariableValidator = FieldDropdownValidator;
 /**
  * Class for a variable's dropdown field.
- *
- * @alias Blockly.FieldVariable
  */
 export declare class FieldVariable extends FieldDropdown {
     protected menuGenerator_: MenuGenerator | undefined;
@@ -42,20 +38,20 @@ export declare class FieldVariable extends FieldDropdown {
      *     Also accepts Field.SKIP_SETUP if you wish to skip setup (only used by
      * subclasses that want to handle configuration and setting the field value
      * after their own constructors have run).
-     * @param opt_validator A function that is called to validate changes to the
+     * @param validator A function that is called to validate changes to the
      *     field's value. Takes in a variable ID  & returns a validated variable
      *     ID, or null to abort the change.
-     * @param opt_variableTypes A list of the types of variables to include in the
-     *     dropdown. Will only be used if opt_config is not provided.
-     * @param opt_defaultType The type of variable to create if this field's value
-     *     is not explicitly set.  Defaults to ''. Will only be used if opt_config
+     * @param variableTypes A list of the types of variables to include in the
+     *     dropdown. Will only be used if config is not provided.
+     * @param defaultType The type of variable to create if this field's value
+     *     is not explicitly set.  Defaults to ''. Will only be used if config
      *     is not provided.
-     * @param opt_config A map of options used to configure the field.
+     * @param config A map of options used to configure the field.
      *    See the [field creation documentation]{@link
      * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/variable#creation}
      * for a list of properties this parameter supports.
      */
-    constructor(varName: string | null | Sentinel, opt_validator?: FieldVariableValidator, opt_variableTypes?: string[], opt_defaultType?: string, opt_config?: FieldVariableConfig);
+    constructor(varName: string | null | typeof Field.SKIP_SETUP, validator?: FieldVariableValidator, variableTypes?: string[], defaultType?: string, config?: FieldVariableConfig);
     /**
      * Configure the field based on the given map of options.
      *
@@ -143,10 +139,10 @@ export declare class FieldVariable extends FieldDropdown {
     /**
      * Ensure that the ID belongs to a valid variable of an allowed type.
      *
-     * @param opt_newValue The ID of the new variable to set.
+     * @param newValue The ID of the new variable to set.
      * @returns The validated ID, or null if invalid.
      */
-    protected doClassValidation_(opt_newValue?: any): string | null;
+    protected doClassValidation_(newValue?: any): string | null;
     /**
      * Update the value of this variable field, as well as its variable and text.
      *
@@ -174,10 +170,10 @@ export declare class FieldVariable extends FieldDropdown {
      * Parse the optional arguments representing the allowed variable types and
      * the default variable type.
      *
-     * @param opt_variableTypes A list of the types of variables to include in the
+     * @param variableTypes A list of the types of variables to include in the
      *     dropdown.  If null or undefined, variables of all types will be
      *     displayed in the dropdown.
-     * @param opt_defaultType The type of the variable to create if this field's
+     * @param defaultType The type of the variable to create if this field's
      *     value is not explicitly set.  Defaults to ''.
      */
     private setTypes_;
@@ -238,4 +234,20 @@ export interface FieldVariableConfig extends FieldConfig {
 export interface FieldVariableFromJsonConfig extends FieldVariableConfig {
     variable?: string;
 }
+/**
+ * A function that is called to validate changes to the field's value before
+ * they are set.
+ *
+ * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @param newValue The value to be validated.
+ * @returns One of three instructions for setting the new value: `T`, `null`,
+ * or `undefined`.
+ *
+ * - `T` to set this function's returned value instead of `newValue`.
+ *
+ * - `null` to invoke `doValueInvalid_` and not set a value.
+ *
+ * - `undefined` to set `newValue` as is.
+ */
+export type FieldVariableValidator = FieldDropdownValidator;
 //# sourceMappingURL=field_variable.d.ts.map

package/core/flyout_base.d.ts

@@ -18,8 +18,6 @@ declare enum FlyoutItemType {
 }
 /**
  * Class for a flyout.
- *
- * @alias Blockly.Flyout
  */
 export declare abstract class Flyout extends DeleteArea implements IFlyout {
     /**
@@ -50,8 +48,7 @@ export declare abstract class Flyout extends DeleteArea implements IFlyout {
     /**
      * Lay out the blocks in the flyout.
      *
-     * @param contents The blocks and buttons to lay
-     *     out.
+     * @param contents The blocks and buttons to lay out.
      * @param gaps The visible gaps between blocks.
      */
     protected abstract layout_(contents: FlyoutItem[], gaps: number[]): void;
@@ -96,9 +93,11 @@ export declare abstract class Flyout extends DeleteArea implements IFlyout {
     horizontalLayout: boolean;
     protected toolboxPosition_: number;
     /**
-     * Opaque data that can be passed to Blockly.unbindEvent_.
+     * Array holding info needed to unbind events.
+     * Used for disposing.
+     * Ex: [[node, name, func], [node, name, func]].
      */
-    private eventWrappers_;
+    private boundEvents;
     /**
      * Function that will be registered as a change listener on the workspace
      * to reflow when blocks in the flyout workspace change.

package/core/flyout_button.d.ts

@@ -8,8 +8,6 @@ import type * as toolbox from './utils/toolbox.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for a button or label in the flyout.
- *
- * @alias Blockly.FlyoutButton
  */
 export declare class FlyoutButton {
     private readonly workspace;
@@ -19,6 +17,8 @@ export declare class FlyoutButton {
     static TEXT_MARGIN_X: number;
     /** The vertical margin around the text in the button. */
     static TEXT_MARGIN_Y: number;
+    /** The radius of the flyout button's borders. */
+    static BORDER_RADIUS: number;
     private readonly text_;
     private readonly position_;
     private readonly callbackKey_;

package/core/flyout_horizontal.d.ts

@@ -9,8 +9,6 @@ import type { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';
 /**
  * Class for a flyout.
- *
- * @alias Blockly.HorizontalFlyout
  */
 export declare class HorizontalFlyout extends Flyout {
     horizontalLayout: boolean;

package/core/flyout_metrics_manager.d.ts

@@ -9,8 +9,6 @@ import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Calculates metrics for a flyout's workspace.
  * The metrics are mainly used to size scrollbars for the flyout.
- *
- * @alias Blockly.FlyoutMetricsManager
  */
 export declare class FlyoutMetricsManager extends MetricsManager {
     /** The flyout that owns the workspace to calculate metrics for. */

package/core/flyout_vertical.d.ts

@@ -9,8 +9,6 @@ import type { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';
 /**
  * Class for a flyout.
- *
- * @alias Blockly.VerticalFlyout
  */
 export declare class VerticalFlyout extends Flyout {
     /** The name of the vertical flyout in the registry. */

package/core/generator.d.ts

@@ -10,7 +10,6 @@ import type { Workspace } from './workspace.js';
  * Class for a code generator that translates the blocks into a language.
  *
  * @unrestricted
- * @alias Blockly.CodeGenerator
  */
 export declare class CodeGenerator {
     name_: string;

package/core/gesture.d.ts

@@ -5,7 +5,6 @@
  */
 import './events/events_click.js';
 import type { BlockSvg } from './block_svg.js';
-import * as browserEvents from './browser_events.js';
 import { BubbleDragger } from './bubble_dragger.js';
 import type { Field } from './field.js';
 import type { IBlockDragger } from './interfaces/i_block_dragger.js';
@@ -16,8 +15,6 @@ import { WorkspaceDragger } from './workspace_dragger.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for one gesture.
- *
- * @alias Blockly.Gesture
  */
 export declare class Gesture {
     private readonly creatorWorkspace;
@@ -63,15 +60,11 @@ export declare class Gesture {
      */
     private hasExceededDragRadius_;
     /**
-     * A handle to use to unbind a pointermove listener at the end of a drag.
-     * Opaque data returned from Blockly.bindEventWithChecks_.
+     * Array holding info needed to unbind events.
+     * Used for disposing.
+     * Ex: [[node, name, func], [node, name, func]].
      */
-    protected onMoveWrapper_: browserEvents.Data | null;
-    /**
-     * A handle to use to unbind a pointerup listener at the end of a drag.
-     * Opaque data returned from Blockly.bindEventWithChecks_.
-     */
-    protected onUpWrapper_: browserEvents.Data | null;
+    private boundEvents;
     /** The object tracking a bubble drag, or null if none is in progress. */
     private bubbleDragger_;
     /** The object tracking a block drag, or null if none is in progress. */
@@ -105,12 +98,6 @@ export declare class Gesture {
     private previousScale_;
     /** The starting distance between two touch points. */
     private startDistance_;
-    /**
-     * A handle to use to unbind the second pointerdown listener
-     * at the end of a drag.
-     * Opaque data returned from Blockly.bindEventWithChecks_.
-     */
-    private onStartWrapper_;
     /** Boolean for whether or not the workspace supports pinch-zoom. */
     private isPinchZoomEnabled_;
     /**

package/core/grid.d.ts

@@ -6,8 +6,6 @@
 import { GridOptions } from './options.js';
 /**
  * Class for a workspace's grid.
- *
- * @alias Blockly.Grid
  */
 export declare class Grid {
     private pattern;

package/core/icon.d.ts

@@ -9,8 +9,6 @@ import { Coordinate } from './utils/coordinate.js';
 import { Size } from './utils/size.js';
 /**
  * Class for an icon.
- *
- * @alias Blockly.Icon
  */
 export declare abstract class Icon {
     protected block_: BlockSvg | null;

package/core/inject.d.ts

@@ -11,7 +11,6 @@ import { WorkspaceSvg } from './workspace_svg.js';
  * @param container Containing element, or its ID, or a CSS selector.
  * @param opt_options Optional dictionary of options.
  * @returns Newly created main workspace.
- * @alias Blockly.inject
  */
 export declare function inject(container: Element | string, opt_options?: BlocklyOptions): WorkspaceSvg;
 //# sourceMappingURL=inject.d.ts.map

package/core/input.d.ts

@@ -10,8 +10,6 @@ import type { Connection } from './connection.js';
 import type { Field } from './field.js';
 /**
  * Class for an input with an optional field.
- *
- * @alias Blockly.Input
  */
 export declare class Input {
     type: number;
@@ -131,7 +129,6 @@ export declare namespace Input {
     /**
      * Enum for alignment of inputs.
      *
-     * @alias Blockly.Input.Align
      */
     enum Align {
         LEFT = -1,

package/core/input_types.d.ts

@@ -5,8 +5,6 @@
  */
 /**
  * Enum for the type of a connection or input.
- *
- * @alias Blockly.inputTypes
  */
 export declare enum inputTypes {
     VALUE = 1,

package/core/insertion_marker_manager.d.ts

@@ -10,8 +10,6 @@ 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.
- *
- * @alias Blockly.InsertionMarkerManager
  */
 export declare class InsertionMarkerManager {
     /**
@@ -114,10 +112,8 @@ export declare class InsertionMarkerManager {
      */
     private createMarkerBlock;
     /**
-     * Populate the list of available connections on this block stack.  This
-     * should only be called once, at the beginning of a drag. If the stack has
-     * more than one block, this function will populate lastOnStack and create
-     * the corresponding insertion marker.
+     * Populate the list of available connections on this block stack. If the
+     * stack has more than one block, this function will also update lastOnStack.
      *
      * @returns A list of available connections.
      */
@@ -230,6 +226,10 @@ export declare class InsertionMarkerManager {
      * @internal
      */
     getInsertionMarkers(): BlockSvg[];
+    /**
+     * Safely disposes of an insertion marker.
+     */
+    private disposeInsertionMarker;
 }
 export declare namespace InsertionMarkerManager {
     /**

package/core/interfaces/i_ast_node_location.d.ts

@@ -5,8 +5,6 @@
  */
 /**
  * An AST node location interface.
- *
- * @alias Blockly.IASTNodeLocation
  */
 export interface IASTNodeLocation {
 }

package/core/interfaces/i_ast_node_location_svg.d.ts

@@ -6,8 +6,6 @@
 import type { IASTNodeLocation } from './i_ast_node_location.js';
 /**
  * An AST node location SVG interface.
- *
- * @alias Blockly.IASTNodeLocationSvg
  */
 export interface IASTNodeLocationSvg extends IASTNodeLocation {
     /**

package/core/interfaces/i_ast_node_location_with_block.d.ts

@@ -7,8 +7,6 @@ import type { IASTNodeLocation } from './i_ast_node_location.js';
 import type { Block } from '../block.js';
 /**
  * An AST node location that has an associated block.
- *
- * @alias Blockly.IASTNodeLocationWithBlock
  */
 export interface IASTNodeLocationWithBlock extends IASTNodeLocation {
     /**