blockly 9.0.0-beta.1 → 9.0.0-beta.3

package/core/events/events_comment_change.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { WorkspaceComment } from '../workspace_comment.js';
-import { CommentBase } from './events_comment_base.js';
+import { CommentBase, CommentBaseJson } from './events_comment_base.js';
 /**
  * Class for a comment change event.
  *
@@ -12,8 +12,8 @@ import { CommentBase } from './events_comment_base.js';
  */
 export declare class CommentChange extends CommentBase {
     type: string;
-    oldContents_: string;
-    newContents_: string;
+    oldContents_?: string;
+    newContents_?: string;
     /**
      * @param opt_comment The comment that is being changed.  Undefined for a
      *     blank event.
@@ -26,13 +26,13 @@ export declare class CommentChange extends CommentBase {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): CommentChangeJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: CommentChangeJson): void;
     /**
      * Does this event record any change of state?
      *
@@ -46,4 +46,8 @@ export declare class CommentChange extends CommentBase {
      */
     run(forward: boolean): void;
 }
+export interface CommentChangeJson extends CommentBaseJson {
+    oldContents: string;
+    newContents: string;
+}
 //# sourceMappingURL=events_comment_change.d.ts.map

package/core/events/events_comment_create.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { WorkspaceComment } from '../workspace_comment.js';
-import { CommentBase } from './events_comment_base.js';
+import { CommentBase, CommentBaseJson } from './events_comment_base.js';
 /**
  * Class for a comment creation event.
  *
@@ -12,7 +12,7 @@ import { CommentBase } from './events_comment_base.js';
  */
 export declare class CommentCreate extends CommentBase {
     type: string;
-    xml: any;
+    xml?: Element | DocumentFragment;
     /**
      * @param opt_comment The created comment.
      *     Undefined for a blank event.
@@ -23,13 +23,13 @@ export declare class CommentCreate extends CommentBase {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): CommentCreateJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: CommentCreateJson): void;
     /**
      * Run a creation event.
      *
@@ -37,4 +37,7 @@ export declare class CommentCreate extends CommentBase {
      */
     run(forward: boolean): void;
 }
+export interface CommentCreateJson extends CommentBaseJson {
+    xml: string;
+}
 //# sourceMappingURL=events_comment_create.d.ts.map

package/core/events/events_comment_delete.d.ts

@@ -12,24 +12,12 @@ import { CommentBase } from './events_comment_base.js';
  */
 export declare class CommentDelete extends CommentBase {
     type: string;
-    xml: any;
+    xml?: Element;
     /**
      * @param opt_comment The deleted comment.
      *     Undefined for a blank event.
      */
     constructor(opt_comment?: WorkspaceComment);
-    /**
-     * Encode the event as JSON.
-     *
-     * @returns JSON representation.
-     */
-    toJson(): any;
-    /**
-     * Decode the JSON event.
-     *
-     * @param json JSON representation.
-     */
-    fromJson(json: any): void;
     /**
      * Run a creation event.
      *

package/core/events/events_comment_move.d.ts

@@ -5,7 +5,7 @@
  */
 import { Coordinate } from '../utils/coordinate.js';
 import type { WorkspaceComment } from '../workspace_comment.js';
-import { CommentBase } from './events_comment_base.js';
+import { CommentBase, CommentBaseJson } from './events_comment_base.js';
 /**
  * Class for a comment move event.  Created before the move.
  *
@@ -13,10 +13,10 @@ import { CommentBase } from './events_comment_base.js';
  */
 export declare class CommentMove extends CommentBase {
     type: string;
-    comment_: WorkspaceComment;
-    oldCoordinate_: Coordinate;
+    comment_?: WorkspaceComment;
+    oldCoordinate_?: Coordinate;
     /** The location after the move, in workspace coordinates. */
-    newCoordinate_: Coordinate;
+    newCoordinate_?: Coordinate;
     /**
      * @param opt_comment The comment that is being moved.  Undefined for a blank
      *     event.
@@ -39,13 +39,13 @@ export declare class CommentMove extends CommentBase {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): CommentMoveJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: CommentMoveJson): void;
     /**
      * Does this event record any change of state?
      *
@@ -59,4 +59,8 @@ export declare class CommentMove extends CommentBase {
      */
     run(forward: boolean): void;
 }
+export interface CommentMoveJson extends CommentBaseJson {
+    oldCoordinate: string;
+    newCoordinate: string;
+}
 //# sourceMappingURL=events_comment_move.d.ts.map

package/core/events/events_marker_move.d.ts

@@ -5,6 +5,7 @@
  */
 import type { Block } from '../block.js';
 import { ASTNode } from '../keyboard_nav/ast_node.js';
+import { AbstractEventJson } from './events_abstract.js';
 import { UiBase } from './events_ui_base.js';
 /**
  * Class for a marker move event.
@@ -12,8 +13,8 @@ import { UiBase } from './events_ui_base.js';
  * @alias Blockly.Events.MarkerMove
  */
 export declare class MarkerMove extends UiBase {
-    blockId: string | null;
-    oldNode?: ASTNode | null;
+    blockId?: string;
+    oldNode?: ASTNode;
     newNode?: ASTNode;
     isCursor?: boolean;
     type: string;
@@ -33,12 +34,18 @@ export declare class MarkerMove extends UiBase {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): MarkerMoveJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: MarkerMoveJson): void;
+}
+export interface MarkerMoveJson extends AbstractEventJson {
+    isCursor: boolean;
+    blockId?: string;
+    oldNode?: ASTNode;
+    newNode: ASTNode;
 }
 //# sourceMappingURL=events_marker_move.d.ts.map

package/core/events/events_selected.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2020 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { AbstractEventJson } from './events_abstract.js';
 import { UiBase } from './events_ui_base.js';
 /**
  * Class for a selected event.
@@ -10,8 +11,8 @@ import { UiBase } from './events_ui_base.js';
  * @alias Blockly.Events.Selected
  */
 export declare class Selected extends UiBase {
-    oldElementId?: string | null;
-    newElementId?: string | null;
+    oldElementId?: string;
+    newElementId?: string;
     type: string;
     /**
      * @param opt_oldElementId The ID of the previously selected element. Null if
@@ -27,12 +28,16 @@ export declare class Selected extends UiBase {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): SelectedJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: SelectedJson): void;
+}
+export interface SelectedJson extends AbstractEventJson {
+    oldElementId?: string;
+    newElementId?: string;
 }
 //# sourceMappingURL=events_selected.d.ts.map

package/core/events/events_theme_change.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2020 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { AbstractEventJson } from './events_abstract.js';
 import { UiBase } from './events_ui_base.js';
 /**
  * Class for a theme change event.
@@ -23,12 +24,15 @@ export declare class ThemeChange extends UiBase {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): ThemeChangeJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: ThemeChangeJson): void;
+}
+export interface ThemeChangeJson extends AbstractEventJson {
+    themeName: string;
 }
 //# sourceMappingURL=events_theme_change.d.ts.map

package/core/events/events_toolbox_item_select.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2020 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { AbstractEventJson } from './events_abstract.js';
 import { UiBase } from './events_ui_base.js';
 /**
  * Class for a toolbox item select event.
@@ -10,8 +11,8 @@ import { UiBase } from './events_ui_base.js';
  * @alias Blockly.Events.ToolboxItemSelect
  */
 export declare class ToolboxItemSelect extends UiBase {
-    oldItem?: string | null;
-    newItem?: string | null;
+    oldItem?: string;
+    newItem?: string;
     type: string;
     /**
      * @param opt_oldItem The previously selected toolbox item.
@@ -27,12 +28,16 @@ export declare class ToolboxItemSelect extends UiBase {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): ToolboxItemSelectJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: ToolboxItemSelectJson): void;
+}
+export interface ToolboxItemSelectJson extends AbstractEventJson {
+    oldItem?: string;
+    newItem?: string;
 }
 //# sourceMappingURL=events_toolbox_item_select.d.ts.map

package/core/events/events_trashcan_open.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2018 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { AbstractEventJson } from './events_abstract.js';
 import { UiBase } from './events_ui_base.js';
 /**
  * Class for a trashcan open event.
@@ -24,12 +25,15 @@ export declare class TrashcanOpen extends UiBase {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): TrashcanOpenJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: TrashcanOpenJson): void;
+}
+export interface TrashcanOpenJson extends AbstractEventJson {
+    isOpen: boolean;
 }
 //# sourceMappingURL=events_trashcan_open.d.ts.map

package/core/events/events_var_base.d.ts

@@ -4,16 +4,15 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { VariableModel } from '../variable_model.js';
-import { Abstract as AbstractEvent } from './events_abstract.js';
+import { Abstract as AbstractEvent, AbstractEventJson } from './events_abstract.js';
 /**
  * Abstract class for a variable event.
  *
  * @alias Blockly.Events.VarBase
  */
 export declare class VarBase extends AbstractEvent {
-    isBlank: any;
-    varId: string;
-    workspaceId: string;
+    isBlank: boolean;
+    varId?: string;
     /**
      * @param opt_variable The variable this event corresponds to.  Undefined for
      *     a blank event.
@@ -24,12 +23,15 @@ export declare class VarBase extends AbstractEvent {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): VarBaseJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: VarBaseJson): void;
+}
+export interface VarBaseJson extends AbstractEventJson {
+    varId: string;
 }
 //# sourceMappingURL=events_var_base.d.ts.map

package/core/events/events_var_create.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { VariableModel } from '../variable_model.js';
-import { VarBase } from './events_var_base.js';
+import { VarBase, VarBaseJson } from './events_var_base.js';
 /**
  * Class for a variable creation event.
  *
@@ -12,8 +12,8 @@ import { VarBase } from './events_var_base.js';
  */
 export declare class VarCreate extends VarBase {
     type: string;
-    varType: string;
-    varName: string;
+    varType?: string;
+    varName?: string;
     /**
      * @param opt_variable The created variable. Undefined for a blank event.
      */
@@ -23,13 +23,13 @@ export declare class VarCreate extends VarBase {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): VarCreateJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: VarCreateJson): void;
     /**
      * Run a variable creation event.
      *
@@ -37,4 +37,8 @@ export declare class VarCreate extends VarBase {
      */
     run(forward: boolean): void;
 }
+export interface VarCreateJson extends VarBaseJson {
+    varType: string;
+    varName: string;
+}
 //# sourceMappingURL=events_var_create.d.ts.map

package/core/events/events_var_delete.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { VariableModel } from '../variable_model.js';
-import { VarBase } from './events_var_base.js';
+import { VarBase, VarBaseJson } from './events_var_base.js';
 /**
  * Class for a variable deletion event.
  *
@@ -12,8 +12,8 @@ import { VarBase } from './events_var_base.js';
  */
 export declare class VarDelete extends VarBase {
     type: string;
-    varType: string;
-    varName: string;
+    varType?: string;
+    varName?: string;
     /**
      * @param opt_variable The deleted variable. Undefined for a blank event.
      */
@@ -23,13 +23,13 @@ export declare class VarDelete extends VarBase {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): VarDeleteJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: VarDeleteJson): void;
     /**
      * Run a variable deletion event.
      *
@@ -37,4 +37,8 @@ export declare class VarDelete extends VarBase {
      */
     run(forward: boolean): void;
 }
+export interface VarDeleteJson extends VarBaseJson {
+    varType: string;
+    varName: string;
+}
 //# sourceMappingURL=events_var_delete.d.ts.map

package/core/events/events_var_rename.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { VariableModel } from '../variable_model.js';
-import { VarBase } from './events_var_base.js';
+import { VarBase, VarBaseJson } from './events_var_base.js';
 /**
  * Class for a variable rename event.
  *
@@ -12,8 +12,8 @@ import { VarBase } from './events_var_base.js';
  */
 export declare class VarRename extends VarBase {
     type: string;
-    oldName: string;
-    newName: string;
+    oldName?: string;
+    newName?: string;
     /**
      * @param opt_variable The renamed variable. Undefined for a blank event.
      * @param newName The new name the variable will be changed to.
@@ -24,13 +24,13 @@ export declare class VarRename extends VarBase {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): VarRenameJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: VarRenameJson): void;
     /**
      * Run a variable rename event.
      *
@@ -38,4 +38,8 @@ export declare class VarRename extends VarBase {
      */
     run(forward: boolean): void;
 }
+export interface VarRenameJson extends VarBaseJson {
+    oldName: string;
+    newName: string;
+}
 //# sourceMappingURL=events_var_rename.d.ts.map

package/core/events/events_viewport.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2020 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { AbstractEventJson } from './events_abstract.js';
 import { UiBase } from './events_ui_base.js';
 /**
  * Class for a viewport change event.
@@ -32,12 +33,18 @@ export declare class ViewportChange extends UiBase {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): ViewportChangeJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: ViewportChangeJson): void;
+}
+export interface ViewportChangeJson extends AbstractEventJson {
+    viewTop: number;
+    viewLeft: number;
+    scale: number;
+    oldScale: number;
 }
 //# sourceMappingURL=events_viewport.d.ts.map

package/core/events/workspace_events.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Workspace } from '../workspace.js';
-import { Abstract as AbstractEvent } from './events_abstract.js';
+import { Abstract as AbstractEvent, AbstractEventJson } from './events_abstract.js';
 /**
  * Class for a finished loading event.
  * Used to notify the developer when the workspace has finished loading (i.e
@@ -15,10 +15,8 @@ import { Abstract as AbstractEvent } from './events_abstract.js';
  */
 export declare class FinishedLoading extends AbstractEvent {
     isBlank: boolean;
-    workspaceId: string;
     recordUndo: boolean;
     type: string;
-    group: any;
     /**
      * @param opt_workspace The workspace that has finished loading.  Undefined
      *     for a blank event.
@@ -29,12 +27,15 @@ export declare class FinishedLoading extends AbstractEvent {
      *
      * @returns JSON representation.
      */
-    toJson(): any;
+    toJson(): FinishedLoadingJson;
     /**
      * Decode the JSON event.
      *
      * @param json JSON representation.
      */
-    fromJson(json: any): void;
+    fromJson(json: FinishedLoadingJson): void;
+}
+export interface FinishedLoadingJson extends AbstractEventJson {
+    workspaceId: string;
 }
 //# sourceMappingURL=workspace_events.d.ts.map

package/core/field.d.ts

@@ -23,8 +23,6 @@ import { Size } from './utils/size.js';
  * @alias Blockly.Field
  */
 export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLocationWithBlock, IKeyboardAccessible, IRegistrable {
-    /** The default value for this field. */
-    protected DEFAULT_VALUE: any;
     /** Non-breaking space. */
     static readonly NBSP = "\u00A0";
     /**

package/core/gesture.d.ts

@@ -58,19 +58,13 @@ export declare class Gesture {
      * workspaces on a page; this is more accurate than using
      * Blockly.common.getMainWorkspace().
      */
-    protected startWorkspace_: WorkspaceSvg;
+    protected startWorkspace_: WorkspaceSvg | null;
     /**
      * Whether the pointer has at any point moved out of the drag radius.
      * A gesture that exceeds the drag radius is a drag even if it ends exactly
      * at its start point.
      */
     private hasExceededDragRadius_;
-    /** Whether the workspace is currently being dragged. */
-    private isDraggingWorkspace_;
-    /** Whether the block is currently being dragged. */
-    private isDraggingBlock_;
-    /** Whether the bubble is currently being dragged. */
-    private isDraggingBubble_;
     /**
      * A handle to use to unbind a mouse move listener at the end of a drag.
      * Opaque data returned from Blockly.bindEventWithChecks_.
@@ -150,7 +144,10 @@ export declare class Gesture {
      */
     private updateIsDraggingBubble_;
     /**
-     * Update this gesture to record whether a block is being dragged.
+     * Check whether to start a block drag. If a block should be dragged, either
+     * from the flyout or in the workspace, create the necessary BlockDragger and
+     * start the drag.
+     *
      * This function should be called on a mouse/touch move event the first time
      * the drag radius is exceeded.  It should be called no more than once per
      * gesture. If a block should be dragged, either from the flyout or in the
@@ -161,7 +158,9 @@ export declare class Gesture {
      */
     private updateIsDraggingBlock_;
     /**
-     * Update this gesture to record whether a workspace is being dragged.
+     * Check whether to start a workspace drag. If a workspace is being dragged,
+     * create the necessary WorkspaceDragger and start the drag.
+     *
      * This function should be called on a mouse/touch move event the first time
      * the drag radius is exceeded.  It should be called no more than once per
      * gesture. If a workspace is being dragged this function creates the

package/core/grid.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2017 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { GridOptions } from './blockly_options.js';
+import { GridOptions } from './options.js';
 /**
  * Class for a workspace's grid.
  *

package/core/icon.d.ts

@@ -13,7 +13,7 @@ import { Size } from './utils/size.js';
  * @alias Blockly.Icon
  */
 export declare abstract class Icon {
-    protected block_: BlockSvg;
+    protected block_: BlockSvg | null;
     /** The icon SVG group. */
     iconGroup_: SVGGElement | null;
     /** Whether this icon gets hidden when the block is collapsed. */
@@ -25,7 +25,7 @@ export declare abstract class Icon {
     /** Absolute coordinate of icon's center. */
     protected iconXY_: Coordinate | null;
     /** @param block The block associated with this icon. */
-    constructor(block: BlockSvg);
+    constructor(block: BlockSvg | null);
     /** Create the icon on the block. */
     createIcon(): void;
     /** Dispose of this icon. */
@@ -83,5 +83,9 @@ export declare abstract class Icon {
      * @param _visible True if the icon should be visible.
      */
     setVisible(_visible: boolean): void;
+    /**
+     * Returns the block this icon is attached to.
+     */
+    protected getBlock(): BlockSvg;
 }
 //# sourceMappingURL=icon.d.ts.map

package/core/interfaces/i_component.d.ts

@@ -11,7 +11,7 @@
  */
 export interface IComponent {
     /**
-     * The unique id for this component that is used to register with the
+     * The unique ID for this component that is used to register with the
      * ComponentManager.
      */
     id: string;