blockly 9.2.1 → 9.3.0

package/core/any_aliases.d.ts

@@ -1,2 +1,7 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
 type any = any;
 //# sourceMappingURL=any_aliases.d.ts.map

package/core/block.d.ts

@@ -22,8 +22,6 @@ import type { Workspace } from './workspace.js';
 /**
  * Class for one block.
  * Not normally called directly, workspace.newBlock() is preferred.
- *
- * @alias Blockly.Block
  */
 export declare class Block implements IASTNodeLocation, IDeletable {
     /**
@@ -31,7 +29,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * changes. This is usually only called from the constructor, the block type
      * initializer function, or an extension initializer function.
      */
-    onchange?: ((p1: Abstract) => any) | null;
+    onchange?: ((p1: Abstract) => void) | null;
     /** The language-neutral ID given to the collapsed input. */
     static readonly COLLAPSED_INPUT_NAME: string;
     /** The language-neutral ID given to the collapsed field. */
@@ -57,7 +55,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
     /** Name of the block style. */
     protected styleName_: string;
     /** An optional method called during initialization. */
-    init?: (() => any) | null;
+    init?: (() => void);
     /** An optional method called during disposal. */
     destroy?: (() => void);
     /**
@@ -65,25 +63,25 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * mutation state to XML. This must be coupled with defining
      * `domToMutation`.
      */
-    mutationToDom?: ((...p1: any[]) => Element) | null;
+    mutationToDom?: (...p1: any[]) => Element;
     /**
      * An optional deserialization method for defining how to deserialize the
      * mutation state from XML. This must be coupled with defining
      * `mutationToDom`.
      */
-    domToMutation?: ((p1: Element) => any) | null;
+    domToMutation?: (p1: Element) => void;
     /**
      * An optional serialization method for defining how to serialize the
      * block's extra state (eg mutation state) to something JSON compatible.
      * This must be coupled with defining `loadExtraState`.
      */
-    saveExtraState?: (() => any) | null;
+    saveExtraState?: () => any;
     /**
      * An optional serialization method for defining how to deserialize the
      * block's extra state (eg mutation state) from something JSON compatible.
      * This must be coupled with defining `saveExtraState`.
      */
-    loadExtraState?: ((p1: any) => any) | null;
+    loadExtraState?: (p1: any) => void;
     /**
      * An optional property for suppressing adding STATEMENT_PREFIX and
      * STATEMENT_SUFFIX to generated code.
@@ -95,21 +93,21 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * shown to the user, but are declared as global variables in the generated
      * code.
      */
-    getDeveloperVariables?: (() => string[]);
+    getDeveloperVariables?: () => string[];
     /**
      * An optional function that reconfigures the block based on the contents of
      * the mutator dialog.
      */
-    compose?: ((p1: Block) => void);
+    compose?: (p1: Block) => void;
     /**
      * An optional function that populates the mutator's dialog with
      * this block's components.
      */
-    decompose?: ((p1: Workspace) => Block);
+    decompose?: (p1: Workspace) => Block;
     id: string;
-    outputConnection: Connection;
-    nextConnection: Connection;
-    previousConnection: Connection;
+    outputConnection: Connection | null;
+    nextConnection: Connection | null;
+    previousConnection: Connection | null;
     inputList: Input[];
     inputsInline?: boolean;
     private disabled;
@@ -147,7 +145,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
     /**
      * String for block help, or function that returns a URL. Null for no help.
      */
-    helpUrl: string | Function;
+    helpUrl: string | Function | null;
     /** A bound callback function to use when the parent workspace changes. */
     private onchangeWrapper_;
     /**
@@ -179,6 +177,11 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * @suppress {checkTypes}
      */
     dispose(healStack: boolean): void;
+    /**
+     * Disposes of this block without doing things required by the top block.
+     * E.g. does not fire events, unplug the block, etc.
+     */
+    protected disposeInternal(): void;
     /**
      * Returns true if the block is either in the process of being disposed, or
      * is disposed.
@@ -348,6 +351,12 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * @returns True if deletable.
      */
     isDeletable(): boolean;
+    /**
+     * Return whether this block's own deletable property is true or false.
+     *
+     * @returns True if the block's deletable property is true, false otherwise.
+     */
+    isOwnDeletable(): boolean;
     /**
      * Set whether this block is deletable or not.
      *
@@ -358,8 +367,16 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * Get whether this block is movable or not.
      *
      * @returns True if movable.
+     * @internal
      */
     isMovable(): boolean;
+    /**
+     * Return whether this block's own movable property is true or false.
+     *
+     * @returns True if the block's movable property is true, false otherwise.
+     * @internal
+     */
+    isOwnMovable(): boolean;
     /**
      * Set whether this block is movable or not.
      *
@@ -406,8 +423,15 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * Get whether this block is editable or not.
      *
      * @returns True if editable.
+     * @internal
      */
     isEditable(): boolean;
+    /**
+     * Return whether this block's own editable property is true or false.
+     *
+     * @returns True if the block's editable property is true, false otherwise.
+     */
+    isOwnEditable(): boolean;
     /**
      * Set whether this block is editable or not.
      *
@@ -492,7 +516,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * @param onchangeFn The callback to call when the block's workspace changes.
      * @throws {Error} if onchangeFn is not falsey and not a function.
      */
-    setOnChange(onchangeFn: (p1: Abstract) => any): void;
+    setOnChange(onchangeFn: (p1: Abstract) => void): void;
     /**
      * Returns the named field from a block.
      *
@@ -627,11 +651,19 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * Create a human-readable text representation of this block and any children.
      *
      * @param opt_maxLength Truncate the string to this length.
-     * @param opt_emptyToken The placeholder string used to denote an empty field.
+     * @param opt_emptyToken The placeholder string used to denote an empty input.
      *     If not specified, '?' is used.
      * @returns Text of block.
      */
     toString(opt_maxLength?: number, opt_emptyToken?: string): string;
+    /**
+     * Converts this block into string tokens.
+     *
+     * @param emptyToken The token to use in place of an empty input.
+     *     Defaults to '?'.
+     * @returns The array of string tokens representing this block.
+     */
+    private toTokens;
     /**
      * Shortcut for appending a value input row.
      *

package/core/block_animations.d.ts

@@ -8,7 +8,6 @@ import type { BlockSvg } from './block_svg.js';
  * Play some UI effects (sound, animation) when disposing of a block.
  *
  * @param block The block being disposed of.
- * @alias Blockly.blockAnimations.disposeUiEffect
  * @internal
  */
 export declare function disposeUiEffect(block: BlockSvg): void;
@@ -16,7 +15,6 @@ export declare function disposeUiEffect(block: BlockSvg): void;
  * Play some UI effects (sound, ripple) after a connection has been established.
  *
  * @param block The block being connected.
- * @alias Blockly.blockAnimations.connectionUiEffect
  * @internal
  */
 export declare function connectionUiEffect(block: BlockSvg): void;
@@ -24,14 +22,12 @@ export declare function connectionUiEffect(block: BlockSvg): void;
  * Play some UI effects (sound, animation) when disconnecting a block.
  *
  * @param block The block being disconnected.
- * @alias Blockly.blockAnimations.disconnectUiEffect
  * @internal
  */
 export declare function disconnectUiEffect(block: BlockSvg): void;
 /**
  * Stop the disconnect UI animation immediately.
  *
- * @alias Blockly.blockAnimations.disconnectUiStop
  * @internal
  */
 export declare function disconnectUiStop(): void;

package/core/block_dragger.d.ts

@@ -13,8 +13,6 @@ import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for a block dragger.  It moves blocks around the workspace when they
  * are being dragged by a mouse or touch.
- *
- * @alias Blockly.BlockDragger
  */
 export declare class BlockDragger implements IBlockDragger {
     /** The top block in the stack that is being dragged. */
@@ -103,11 +101,8 @@ export declare class BlockDragger implements IBlockDragger {
     protected maybeDeleteBlock_(): boolean;
     /**
      * Updates the necessary information to place a block at a certain location.
-     *
-     * @param delta The change in location from where the block started the drag
-     *     to where it ended the drag.
      */
-    protected updateBlockAfterMove_(delta: Coordinate): void;
+    protected updateBlockAfterMove_(): void;
     /** Fire a UI event at the end of a block drag. */
     protected fireDragEndEvent_(): void;
     /**

package/core/block_svg.d.ts

@@ -28,8 +28,6 @@ import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for a block's SVG representation.
  * Not normally called directly, workspace.newBlock() is preferred.
- *
- * @alias Blockly.BlockSvg
  */
 export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBoundedElement, ICopyable, IDraggable {
     /**
@@ -43,9 +41,9 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * the block.
      */
     static readonly COLLAPSED_WARNING_ID = "TEMP_COLLAPSED_WARNING_";
-    decompose?: ((p1: Workspace) => BlockSvg);
-    saveConnections?: ((p1: BlockSvg) => any);
-    customContextMenu?: ((p1: Array<ContextMenuOption | LegacyContextMenuOption>) => any) | null;
+    decompose?: (p1: Workspace) => BlockSvg;
+    saveConnections?: (p1: BlockSvg) => void;
+    customContextMenu?: (p1: Array<ContextMenuOption | LegacyContextMenuOption>) => void;
     /**
      * An property used internally to reference the block's rendering debugger.
      *
@@ -78,6 +76,7 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
     /** @internal */
     pathObject: IPathObject;
     rendered: boolean;
+    private visuallyDisabled;
     /**
      * Is this block currently rendering? Used to stop recursive render calls
      * from actually triggering a re-render.
@@ -90,6 +89,20 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
     nextConnection: RenderedConnection;
     previousConnection: RenderedConnection;
     private readonly useDragSurface_;
+    private translation;
+    /**
+     * The ID of the setTimeout callback for bumping neighbours, or 0 if no bump
+     * is currently scheduled.
+     */
+    private bumpNeighboursPid;
+    /**
+     * The location of the top left of this block (in workspace coordinates)
+     * relative to either its parent block, or the workspace origin if it has no
+     * parent.
+     *
+     * @internal
+     */
+    relativeCoords: Coordinate;
     /**
      * @param workspace The block's workspace.
      * @param prototypeName Name of the language object containing type-specific
@@ -163,6 +176,12 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * @param y The y coordinate of the translation in workspace units.
      */
     translate(x: number, y: number): void;
+    /**
+     * Returns the SVG translation of this block.
+     *
+     * @internal
+     */
+    getTranslation(): string;
     /**
      * Move this block to its workspace's drag surface, accounting for
      * positioning. Generally should be called at the same time as
@@ -319,6 +338,11 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * @suppress {checkTypes}
      */
     dispose(healStack?: boolean, animate?: boolean): void;
+    /**
+     * Disposes of this block without doing things required by the top block.
+     * E.g. does trigger UI effects, remove nodes, etc.
+     */
+    disposeInternal(): void;
     /**
      * Delete a block and hide chaff when doing so. The block will not be deleted
      * if it's in a flyout. This is called from the context menu and keyboard
@@ -508,7 +532,7 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      *
      * @param all If true, return all connections even hidden ones.
      *     Otherwise, for a non-rendered block return an empty list, and for a
-     * collapsed block don't return inputs connections.
+     *     collapsed block don't return inputs connections.
      * @returns Array of connections.
      * @internal
      */
@@ -599,20 +623,46 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      */
     getChildren(ordered: boolean): BlockSvg[];
     /**
-     * Lays out and reflows a block based on its contents and settings.
+     * Triggers a rerender after a delay to allow for batching.
+     *
+     * @internal
+     */
+    queueRender(): void;
+    /**
+     * Immediately lays out and reflows a block based on its contents and
+     * settings.
      *
      * @param opt_bubble If false, just render this block.
      *   If true, also render block's parent, grandparent, etc.  Defaults to true.
      */
     render(opt_bubble?: boolean): void;
+    /**
+     * Renders this block in a way that's compatible with the more efficient
+     * render management system.
+     *
+     * @internal
+     */
+    renderEfficiently(): void;
+    /**
+     * Tightens all children of this block so they are snuggly rendered against
+     * their parent connections.
+     *
+     * Does not update connection locations, so that they can be updated more
+     * efficiently by the render management system.
+     *
+     * @internal
+     */
+    tightenChildrenEfficiently(): void;
     /** Redraw any attached marker or cursor svgs if needed. */
     protected updateMarkers_(): void;
     /**
      * Update all of the connections on this block with the new locations
      * calculated during rendering.  Also move all of the connected blocks based
      * on the new connection locations.
+     *
+     * @internal
      */
-    private updateConnectionLocations_;
+    updateConnectionLocations(): void;
     /**
      * Add the cursor SVG to this block's SVG group.
      *

package/core/blockly.d.ts

@@ -38,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';
@@ -84,6 +84,7 @@ import { IFlyout } from './interfaces/i_flyout.js';
 import { IKeyboardAccessible } from './interfaces/i_keyboard_accessible.js';
 import { IMetricsManager } from './interfaces/i_metrics_manager.js';
 import { IMovable } from './interfaces/i_movable.js';
+import { IObservable, isObservable } from './interfaces/i_observable.js';
 import { IPositionable } from './interfaces/i_positionable.js';
 import { IRegistrable } from './interfaces/i_registrable.js';
 import { ISelectable } from './interfaces/i_selectable.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';
@@ -155,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;
 /**
@@ -228,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;
 /**
@@ -236,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;
 /**
@@ -245,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;
 /**
@@ -260,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;
 /**
@@ -271,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;
 /**
@@ -281,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;
@@ -291,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;
 /**
@@ -300,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;
 /**
@@ -309,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;
 /**
@@ -319,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;
 /**
@@ -329,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;
 /**
@@ -345,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;
 /**
@@ -356,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;
 /**
@@ -376,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;
@@ -390,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 };
@@ -463,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 };
@@ -507,6 +474,7 @@ export { IMetricsManager };
 export { IMovable };
 export { Input };
 export { InsertionMarkerManager };
+export { IObservable, isObservable };
 export { IPositionable };
 export { IRegistrable };
 export { ISelectable };
@@ -514,6 +482,7 @@ export { ISelectableToolboxItem };
 export { IStyleable };
 export { IToolbox };
 export { IToolboxItem };
+export { IVariableBackedParameterModel, isVariableBackedParameterModel };
 export { Marker };
 export { MarkerManager };
 export { Menu };

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;