blockly 11.1.1 → 11.2.0-beta.0

package/core/component_manager.d.ts

@@ -92,6 +92,12 @@ export declare class ComponentManager {
     getComponents<T extends IComponent>(capability: string | Capability<T>, sorted: boolean): T[];
 }
 export declare namespace ComponentManager {
+    enum ComponentWeight {
+        TOOLBOX_WEIGHT = 0,
+        FLYOUT_WEIGHT = 1,
+        TRASHCAN_WEIGHT = 2,
+        ZOOM_CONTROLS_WEIGHT = 3
+    }
     /** An object storing component information. */
     interface ComponentDatum {
         component: IComponent;
@@ -99,6 +105,8 @@ export declare namespace ComponentManager {
         weight: number;
     }
 }
+export type ComponentWeight = ComponentManager.ComponentWeight;
+export declare const ComponentWeight: typeof ComponentManager.ComponentWeight;
 export type ComponentDatum = ComponentManager.ComponentDatum;
 export {};
 //# sourceMappingURL=component_manager.d.ts.map

package/core/dragging/block_drag_strategy.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { BlockSvg } from '../block_svg.js';
 import { IDragStrategy } from '../interfaces/i_draggable.js';
 import { Coordinate } from '../utils.js';
-import { BlockSvg } from '../block_svg.js';
 export declare class BlockDragStrategy implements IDragStrategy {
     private block;
     private workspace;
@@ -25,6 +25,8 @@ export declare class BlockDragStrategy implements IDragStrategy {
      * block, to add to the drag location. In workspace units.
      */
     private dragOffset;
+    /** Was there already an event group in progress when the drag started? */
+    private inGroup;
     constructor(block: BlockSvg);
     /** Returns true if the block is currently movable. False otherwise. */
     isMovable(): boolean;

package/core/dragging/bubble_drag_strategy.d.ts

@@ -3,13 +3,15 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { IBubble, WorkspaceSvg } from '../blockly.js';
 import { IDragStrategy } from '../interfaces/i_draggable.js';
 import { Coordinate } from '../utils.js';
-import { IBubble, WorkspaceSvg } from '../blockly.js';
 export declare class BubbleDragStrategy implements IDragStrategy {
     private bubble;
     private workspace;
     private startLoc;
+    /** Was there already an event group in progress when the drag started? */
+    private inGroup;
     constructor(bubble: IBubble, workspace: WorkspaceSvg);
     isMovable(): boolean;
     startDrag(): void;

package/core/dragging/comment_drag_strategy.d.ts

@@ -3,18 +3,25 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { RenderedWorkspaceComment } from '../comments.js';
 import { IDragStrategy } from '../interfaces/i_draggable.js';
 import { Coordinate } from '../utils.js';
-import { RenderedWorkspaceComment } from '../comments.js';
 export declare class CommentDragStrategy implements IDragStrategy {
     private comment;
     private startLoc;
     private workspace;
+    /** Was there already an event group in progress when the drag started? */
+    private inGroup;
     constructor(comment: RenderedWorkspaceComment);
     isMovable(): boolean;
     startDrag(): void;
     drag(newLoc: Coordinate): void;
     endDrag(): void;
+    /** Fire a UI event at the start of a comment drag. */
+    private fireDragStartEvent;
+    /** Fire a UI event at the end of a comment drag. */
+    private fireDragEndEvent;
+    /** Fire a move event at the end of a comment drag. */
     private fireMoveEvent;
     revertDrag(): void;
 }

package/core/dragging/dragger.d.ts

@@ -3,10 +3,10 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { IDragTarget } from '../interfaces/i_drag_target.js';
 import { IDeletable } from '../interfaces/i_deletable.js';
-import { IDragger } from '../interfaces/i_dragger.js';
+import { IDragTarget } from '../interfaces/i_drag_target.js';
 import { IDraggable } from '../interfaces/i_draggable.js';
+import { IDragger } from '../interfaces/i_dragger.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
 export declare class Dragger implements IDragger {

package/core/dragging.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Dragger } from './dragging/dragger.js';
 import { BlockDragStrategy } from './dragging/block_drag_strategy.js';
 import { BubbleDragStrategy } from './dragging/bubble_drag_strategy.js';
 import { CommentDragStrategy } from './dragging/comment_drag_strategy.js';
-export { Dragger, BlockDragStrategy, BubbleDragStrategy, CommentDragStrategy };
+import { Dragger } from './dragging/dragger.js';
+export { BlockDragStrategy, BubbleDragStrategy, CommentDragStrategy, Dragger };
 //# sourceMappingURL=dragging.d.ts.map

package/core/dropdowndiv.d.ts

@@ -97,7 +97,7 @@ export declare function setColour(backgroundColour: string, borderColour: string
  * @param opt_secondaryYOffset Optional Y offset for above-block positioning.
  * @returns True if the menu rendered below block; false if above.
  */
-export declare function showPositionedByBlock<T>(field: Field<T>, block: BlockSvg, opt_onHide?: Function, opt_secondaryYOffset?: number): boolean;
+export declare function showPositionedByBlock<T>(field: Field<T>, block: BlockSvg, opt_onHide?: () => void, opt_secondaryYOffset?: number): boolean;
 /**
  * Shortcut to show and place the drop-down with positioning determined
  * by a particular field. The primary position will be below the field,
@@ -109,7 +109,7 @@ export declare function showPositionedByBlock<T>(field: Field<T>, block: BlockSv
  * @param opt_secondaryYOffset Optional Y offset for above-block positioning.
  * @returns True if the menu rendered below block; false if above.
  */
-export declare function showPositionedByField<T>(field: Field<T>, opt_onHide?: Function, opt_secondaryYOffset?: number): boolean;
+export declare function showPositionedByField<T>(field: Field<T>, opt_onHide?: () => void, opt_secondaryYOffset?: number): boolean;
 /**
  * Show and place the drop-down.
  * The drop-down is placed with an absolute "origin point" (x, y) - i.e.,
@@ -129,7 +129,7 @@ export declare function showPositionedByField<T>(field: Field<T>, opt_onHide?: F
  * @returns True if the menu rendered at the primary origin point.
  * @internal
  */
-export declare function show<T>(newOwner: Field<T>, rtl: boolean, primaryX: number, primaryY: number, secondaryX: number, secondaryY: number, opt_onHide?: Function): boolean;
+export declare function show<T>(newOwner: Field<T>, rtl: boolean, primaryX: number, primaryY: number, secondaryX: number, secondaryY: number, opt_onHide?: () => void): boolean;
 /**
  * Get the x positions for the left side of the DropDownDiv and the arrow,
  * accounting for the bounds of the workspace.

package/core/events/events.d.ts

@@ -3,131 +3,71 @@
  * Copyright 2016 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Abstract, AbstractEventJson } from './events_abstract.js';
-import { BlockBase, BlockBaseJson } from './events_block_base.js';
-import { BlockChange, BlockChangeJson } from './events_block_change.js';
-import { BlockCreate, BlockCreateJson } from './events_block_create.js';
-import { BlockDelete, BlockDeleteJson } from './events_block_delete.js';
-import { BlockDrag, BlockDragJson } from './events_block_drag.js';
-import { BlockFieldIntermediateChange, BlockFieldIntermediateChangeJson } from './events_block_field_intermediate_change.js';
-import { BlockMove, BlockMoveJson } from './events_block_move.js';
-import { BubbleOpen, BubbleOpenJson, BubbleType } from './events_bubble_open.js';
-import { Click, ClickJson, ClickTarget } from './events_click.js';
-import { CommentBase, CommentBaseJson } from './events_comment_base.js';
-import { CommentChange, CommentChangeJson } from './events_comment_change.js';
-import { CommentCreate, CommentCreateJson } from './events_comment_create.js';
-import { CommentDelete } from './events_comment_delete.js';
-import { CommentMove, CommentMoveJson } from './events_comment_move.js';
-import { CommentCollapse, CommentCollapseJson } from './events_comment_collapse.js';
-import { MarkerMove, MarkerMoveJson } from './events_marker_move.js';
-import { Selected, SelectedJson } from './events_selected.js';
-import { ThemeChange, ThemeChangeJson } from './events_theme_change.js';
-import { ToolboxItemSelect, ToolboxItemSelectJson } from './events_toolbox_item_select.js';
-import { TrashcanOpen, TrashcanOpenJson } from './events_trashcan_open.js';
-import { UiBase } from './events_ui_base.js';
-import { VarBase, VarBaseJson } from './events_var_base.js';
-import { VarCreate, VarCreateJson } from './events_var_create.js';
-import { VarDelete, VarDeleteJson } from './events_var_delete.js';
-import { VarRename, VarRenameJson } from './events_var_rename.js';
-import { ViewportChange, ViewportChangeJson } from './events_viewport.js';
-import * as eventUtils from './utils.js';
-import { FinishedLoading } from './workspace_events.js';
-export { Abstract };
-export { AbstractEventJson };
-export { BubbleOpen };
-export { BubbleOpenJson };
-export { BubbleType };
-export { BlockBase };
-export { BlockBaseJson };
-export { BlockChange };
-export { BlockChangeJson };
-export { BlockCreate };
-export { BlockCreateJson };
-export { BlockDelete };
-export { BlockDeleteJson };
-export { BlockDrag };
-export { BlockDragJson };
-export { BlockFieldIntermediateChange };
-export { BlockFieldIntermediateChangeJson };
-export { BlockMove };
-export { BlockMoveJson };
-export { Click };
-export { ClickJson };
-export { ClickTarget };
-export { CommentBase };
-export { CommentBaseJson };
-export { CommentChange };
-export { CommentChangeJson };
-export { CommentCreate };
-export { CommentCreateJson };
-export { CommentDelete };
-export { CommentMove };
-export { CommentMoveJson };
-export { CommentCollapse };
-export { CommentCollapseJson };
-export { FinishedLoading };
-export { MarkerMove };
-export { MarkerMoveJson };
-export { Selected };
-export { SelectedJson };
-export { ThemeChange };
-export { ThemeChangeJson };
-export { ToolboxItemSelect };
-export { ToolboxItemSelectJson };
-export { TrashcanOpen };
-export { TrashcanOpenJson };
-export { UiBase };
-export { VarBase };
-export { VarBaseJson };
-export { VarCreate };
-export { VarCreateJson };
-export { VarDelete };
-export { VarDeleteJson };
-export { VarRename };
-export { VarRenameJson };
-export { ViewportChange };
-export { ViewportChangeJson };
-export declare const BLOCK_CHANGE = "change";
-export declare const BLOCK_CREATE = "create";
-export declare const BLOCK_DELETE = "delete";
-export declare const BLOCK_DRAG = "drag";
-export declare const BLOCK_MOVE = "move";
-export declare const BLOCK_FIELD_INTERMEDIATE_CHANGE = "block_field_intermediate_change";
-export declare const BUBBLE_OPEN = "bubble_open";
-export type BumpEvent = eventUtils.BumpEvent;
-export declare const BUMP_EVENTS: string[];
-export declare const CHANGE = "change";
-export declare const CLICK = "click";
-export declare const COMMENT_CHANGE = "comment_change";
-export declare const COMMENT_CREATE = "comment_create";
-export declare const COMMENT_DELETE = "comment_delete";
-export declare const COMMENT_MOVE = "comment_move";
-export declare const CREATE = "create";
-export declare const DELETE = "delete";
-export declare const FINISHED_LOADING = "finished_loading";
-export declare const MARKER_MOVE = "marker_move";
-export declare const MOVE = "move";
-export declare const SELECTED = "selected";
-export declare const THEME_CHANGE = "theme_change";
-export declare const TOOLBOX_ITEM_SELECT = "toolbox_item_select";
-export declare const TRASHCAN_OPEN = "trashcan_open";
-export declare const UI = "ui";
-export declare const VAR_CREATE = "var_create";
-export declare const VAR_DELETE = "var_delete";
-export declare const VAR_RENAME = "var_rename";
-export declare const VIEWPORT_CHANGE = "viewport_change";
-export declare const clearPendingUndo: typeof eventUtils.clearPendingUndo;
-export declare const disable: typeof eventUtils.disable;
-export declare const enable: typeof eventUtils.enable;
-export declare const filter: typeof eventUtils.filter;
-export declare const fire: typeof eventUtils.fire;
-export declare const fromJson: typeof eventUtils.fromJson;
-export declare const getDescendantIds: typeof eventUtils.getDescendantIds;
-export declare const get: typeof eventUtils.get;
-export declare const getGroup: typeof eventUtils.getGroup;
-export declare const getRecordUndo: typeof eventUtils.getRecordUndo;
-export declare const isEnabled: typeof eventUtils.isEnabled;
-export declare const setGroup: typeof eventUtils.setGroup;
-export declare const setRecordUndo: typeof eventUtils.setRecordUndo;
-export declare const disableOrphans: typeof eventUtils.disableOrphans;
+import { EventType } from './type.js';
+export { Abstract, AbstractEventJson } from './events_abstract.js';
+export { BlockBase, BlockBaseJson } from './events_block_base.js';
+export { BlockChange, BlockChangeJson } from './events_block_change.js';
+export { BlockCreate, BlockCreateJson } from './events_block_create.js';
+export { BlockDelete, BlockDeleteJson } from './events_block_delete.js';
+export { BlockDrag, BlockDragJson } from './events_block_drag.js';
+export { BlockFieldIntermediateChange, BlockFieldIntermediateChangeJson, } from './events_block_field_intermediate_change.js';
+export { BlockMove, BlockMoveJson } from './events_block_move.js';
+export { BubbleOpen, BubbleOpenJson, BubbleType } from './events_bubble_open.js';
+export { Click, ClickJson, ClickTarget } from './events_click.js';
+export { CommentBase, CommentBaseJson } from './events_comment_base.js';
+export { CommentChange, CommentChangeJson } from './events_comment_change.js';
+export { CommentCollapse, CommentCollapseJson, } from './events_comment_collapse.js';
+export { CommentCreate, CommentCreateJson } from './events_comment_create.js';
+export { CommentDelete } from './events_comment_delete.js';
+export { CommentDrag, CommentDragJson } from './events_comment_drag.js';
+export { CommentMove, CommentMoveJson } from './events_comment_move.js';
+export { CommentResize, CommentResizeJson } from './events_comment_resize.js';
+export { MarkerMove, MarkerMoveJson } from './events_marker_move.js';
+export { Selected, SelectedJson } from './events_selected.js';
+export { ThemeChange, ThemeChangeJson } from './events_theme_change.js';
+export { ToolboxItemSelect, ToolboxItemSelectJson, } from './events_toolbox_item_select.js';
+export { TrashcanOpen, TrashcanOpenJson } from './events_trashcan_open.js';
+export { UiBase } from './events_ui_base.js';
+export { VarBase, VarBaseJson } from './events_var_base.js';
+export { VarCreate, VarCreateJson } from './events_var_create.js';
+export { VarDelete, VarDeleteJson } from './events_var_delete.js';
+export { VarRename, VarRenameJson } from './events_var_rename.js';
+export { ViewportChange, ViewportChangeJson } from './events_viewport.js';
+export { FinishedLoading } from './workspace_events.js';
+export type { BumpEvent } from './utils.js';
+export declare const BLOCK_CHANGE = EventType.BLOCK_CHANGE;
+export declare const BLOCK_CREATE = EventType.BLOCK_CREATE;
+export declare const BLOCK_DELETE = EventType.BLOCK_DELETE;
+export declare const BLOCK_DRAG = EventType.BLOCK_DRAG;
+export declare const BLOCK_MOVE = EventType.BLOCK_MOVE;
+export declare const BLOCK_FIELD_INTERMEDIATE_CHANGE = EventType.BLOCK_FIELD_INTERMEDIATE_CHANGE;
+export declare const BUBBLE_OPEN = EventType.BUBBLE_OPEN;
+/** @deprecated Use BLOCK_CHANGE instead */
+export declare const CHANGE = EventType.BLOCK_CHANGE;
+export declare const CLICK = EventType.CLICK;
+export declare const COMMENT_CHANGE = EventType.COMMENT_CHANGE;
+export declare const COMMENT_CREATE = EventType.COMMENT_CREATE;
+export declare const COMMENT_DELETE = EventType.COMMENT_DELETE;
+export declare const COMMENT_MOVE = EventType.COMMENT_MOVE;
+export declare const COMMENT_RESIZE = EventType.COMMENT_RESIZE;
+export declare const COMMENT_DRAG = EventType.COMMENT_DRAG;
+/** @deprecated Use BLOCK_CREATE instead */
+export declare const CREATE = EventType.BLOCK_CREATE;
+/** @deprecated Use BLOCK_DELETE instead */
+export declare const DELETE = EventType.BLOCK_DELETE;
+export declare const FINISHED_LOADING = EventType.FINISHED_LOADING;
+export declare const MARKER_MOVE = EventType.MARKER_MOVE;
+/** @deprecated Use BLOCK_MOVE instead */
+export declare const MOVE = EventType.BLOCK_MOVE;
+export declare const SELECTED = EventType.SELECTED;
+export declare const THEME_CHANGE = EventType.THEME_CHANGE;
+export declare const TOOLBOX_ITEM_SELECT = EventType.TOOLBOX_ITEM_SELECT;
+export declare const TRASHCAN_OPEN = EventType.TRASHCAN_OPEN;
+export declare const UI = EventType.UI;
+export declare const VAR_CREATE = EventType.VAR_CREATE;
+export declare const VAR_DELETE = EventType.VAR_DELETE;
+export declare const VAR_RENAME = EventType.VAR_RENAME;
+export declare const VIEWPORT_CHANGE = EventType.VIEWPORT_CHANGE;
+export { BUMP_EVENTS } from './type.js';
+export { clearPendingUndo, disable, disableOrphans, enable, filter, fire, fromJson, get, getDescendantIds, getGroup, getRecordUndo, isEnabled, setGroup, setRecordUndo, } from './utils.js';
 //# sourceMappingURL=events.d.ts.map

package/core/events/events_abstract.d.ts

@@ -62,7 +62,6 @@ export declare abstract class Abstract {
      *
      * @returns The workspace the event belongs to.
      * @throws {Error} if workspace is null.
-     * @internal
      */
     getEventWorkspace_(): Workspace;
 }

package/core/events/events_block_change.d.ts

@@ -12,12 +12,13 @@ import type { Block } from '../block.js';
 import type { BlockSvg } from '../block_svg.js';
 import { Workspace } from '../workspace.js';
 import { BlockBase, BlockBaseJson } from './events_block_base.js';
+import { EventType } from './type.js';
 /**
  * Notifies listeners when some element of a block has changed (e.g.
  * field values, comments, etc).
  */
 export declare class BlockChange extends BlockBase {
-    type: string;
+    type: EventType;
     /**
      * The element that changed; one of 'field', 'comment', 'collapsed',
      * 'disabled', 'inline', or 'mutation'

package/core/events/events_block_create.d.ts

@@ -10,14 +10,15 @@
  */
 import type { Block } from '../block.js';
 import * as blocks from '../serialization/blocks.js';
-import { BlockBase, BlockBaseJson } from './events_block_base.js';
 import { Workspace } from '../workspace.js';
+import { BlockBase, BlockBaseJson } from './events_block_base.js';
+import { EventType } from './type.js';
 /**
  * Notifies listeners when a block (or connected stack of blocks) is
  * created.
  */
 export declare class BlockCreate extends BlockBase {
-    type: string;
+    type: EventType;
     /** The XML representation of the created block(s). */
     xml?: Element | DocumentFragment;
     /** The JSON respresentation of the created block(s). */

package/core/events/events_block_delete.d.ts

@@ -10,8 +10,9 @@
  */
 import type { Block } from '../block.js';
 import * as blocks from '../serialization/blocks.js';
-import { BlockBase, BlockBaseJson } from './events_block_base.js';
 import { Workspace } from '../workspace.js';
+import { BlockBase, BlockBaseJson } from './events_block_base.js';
+import { EventType } from './type.js';
 /**
  * Notifies listeners when a block (or connected stack of blocks) is
  * deleted.
@@ -25,7 +26,7 @@ export declare class BlockDelete extends BlockBase {
     ids?: string[];
     /** True if the deleted block was a shadow block, false otherwise. */
     wasShadow?: boolean;
-    type: string;
+    type: EventType;
     /** @param opt_block The deleted block.  Undefined for a blank event. */
     constructor(opt_block?: Block);
     /**

package/core/events/events_block_drag.d.ts

@@ -9,9 +9,10 @@
  * @class
  */
 import type { Block } from '../block.js';
+import { Workspace } from '../workspace.js';
 import { AbstractEventJson } from './events_abstract.js';
 import { UiBase } from './events_ui_base.js';
-import { Workspace } from '../workspace.js';
+import { EventType } from './type.js';
 /**
  * Notifies listeners when a block is being manually dragged/dropped.
  */
@@ -25,7 +26,7 @@ export declare class BlockDrag extends UiBase {
      * with the block ID) being dragged.
      */
     blocks?: Block[];
-    type: string;
+    type: EventType;
     /**
      * @param opt_block The top block in the stack that is being dragged.
      *     Undefined for a blank event.

package/core/events/events_block_field_intermediate_change.d.ts

@@ -12,13 +12,14 @@
 import type { Block } from '../block.js';
 import { Workspace } from '../workspace.js';
 import { BlockBase, BlockBaseJson } from './events_block_base.js';
+import { EventType } from './type.js';
 /**
  * Notifies listeners when the value of a block's field has changed but the
  * change is not yet complete, and is expected to be followed by a block change
  * event.
  */
 export declare class BlockFieldIntermediateChange extends BlockBase {
-    type: string;
+    type: EventType;
     recordUndo: boolean;
     /** The name of the field that changed. */
     name?: string;

package/core/events/events_block_move.d.ts

@@ -10,14 +10,15 @@
  */
 import type { Block } from '../block.js';
 import { Coordinate } from '../utils/coordinate.js';
-import { BlockBase, BlockBaseJson } from './events_block_base.js';
 import type { Workspace } from '../workspace.js';
+import { BlockBase, BlockBaseJson } from './events_block_base.js';
+import { EventType } from './type.js';
 /**
  * Notifies listeners when a block is moved. This could be from one
  * connection to another, or from one location on the workspace to another.
  */
 export declare class BlockMove extends BlockBase {
-    type: string;
+    type: EventType;
     /** The ID of the old parent block. Undefined if it was a top-level block. */
     oldParentId?: string;
     /**

package/core/events/events_bubble_open.d.ts

@@ -8,10 +8,11 @@
  *
  * @class
  */
-import type { AbstractEventJson } from './events_abstract.js';
 import type { BlockSvg } from '../block_svg.js';
-import { UiBase } from './events_ui_base.js';
 import type { Workspace } from '../workspace.js';
+import type { AbstractEventJson } from './events_abstract.js';
+import { UiBase } from './events_ui_base.js';
+import { EventType } from './type.js';
 /**
  * Class for a bubble open event.
  */
@@ -22,7 +23,7 @@ export declare class BubbleOpen extends UiBase {
     isOpen?: boolean;
     /** The type of bubble; one of 'mutator', 'comment', or 'warning'. */
     bubbleType?: BubbleType;
-    type: string;
+    type: EventType;
     /**
      * @param opt_block The associated block. Undefined for a blank event.
      * @param opt_isOpen Whether the bubble is opening (false if closing).

package/core/events/events_click.d.ts

@@ -9,9 +9,10 @@
  * @class
  */
 import type { Block } from '../block.js';
+import { Workspace } from '../workspace.js';
 import { AbstractEventJson } from './events_abstract.js';
 import { UiBase } from './events_ui_base.js';
-import { Workspace } from '../workspace.js';
+import { EventType } from './type.js';
 /**
  * Notifies listeners that some blockly element was clicked.
  */
@@ -23,7 +24,7 @@ export declare class Click extends UiBase {
      * or 'zoom_controls'.
      */
     targetType?: ClickTarget;
-    type: string;
+    type: EventType;
     /**
      * @param opt_block The affected block. Null for click events that do not have
      *     an associated block (i.e. workspace click). Undefined for a blank

package/core/events/events_comment_base.d.ts

@@ -9,10 +9,10 @@
  * @class
  */
 import type { WorkspaceComment } from '../comments/workspace_comment.js';
+import type { Workspace } from '../workspace.js';
 import { Abstract as AbstractEvent, AbstractEventJson } from './events_abstract.js';
 import type { CommentCreate } from './events_comment_create.js';
 import type { CommentDelete } from './events_comment_delete.js';
-import type { Workspace } from '../workspace.js';
 /**
  * Abstract class for a comment event.
  */

package/core/events/events_comment_change.d.ts

@@ -3,14 +3,20 @@
  * Copyright 2018 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+/**
+ * Class for comment change event.
+ *
+ * @class
+ */
 import type { WorkspaceComment } from '../comments/workspace_comment.js';
-import { CommentBase, CommentBaseJson } from './events_comment_base.js';
 import type { Workspace } from '../workspace.js';
+import { CommentBase, CommentBaseJson } from './events_comment_base.js';
+import { EventType } from './type.js';
 /**
  * Notifies listeners that the contents of a workspace comment has changed.
  */
 export declare class CommentChange extends CommentBase {
-    type: string;
+    type: EventType;
     /** The previous contents of the comment. */
     oldContents_?: string;
     /** The new contents of the comment. */

package/core/events/events_comment_collapse.d.ts

@@ -4,11 +4,12 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { WorkspaceComment } from '../comments/workspace_comment.js';
-import { CommentBase, CommentBaseJson } from './events_comment_base.js';
 import type { Workspace } from '../workspace.js';
+import { CommentBase, CommentBaseJson } from './events_comment_base.js';
+import { EventType } from './type.js';
 export declare class CommentCollapse extends CommentBase {
     newCollapsed?: boolean | undefined;
-    type: string;
+    type: EventType;
     constructor(comment?: WorkspaceComment, newCollapsed?: boolean | undefined);
     /**
      * Encode the event as JSON.

package/core/events/events_comment_create.d.ts

@@ -3,15 +3,21 @@
  * Copyright 2018 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+/**
+ * Class for comment creation event.
+ *
+ * @class
+ */
 import type { WorkspaceComment } from '../comments/workspace_comment.js';
 import * as comments from '../serialization/workspace_comments.js';
-import { CommentBase, CommentBaseJson } from './events_comment_base.js';
 import type { Workspace } from '../workspace.js';
+import { CommentBase, CommentBaseJson } from './events_comment_base.js';
+import { EventType } from './type.js';
 /**
  * Notifies listeners that a workspace comment was created.
  */
 export declare class CommentCreate extends CommentBase {
-    type: string;
+    type: EventType;
     /** The XML representation of the created workspace comment. */
     xml?: Element | DocumentFragment;
     /** The JSON representation of the created workspace comment. */

package/core/events/events_comment_delete.d.ts

@@ -3,15 +3,21 @@
  * Copyright 2018 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+/**
+ * Class for comment deletion event.
+ *
+ * @class
+ */
 import type { WorkspaceComment } from '../comments/workspace_comment.js';
 import * as comments from '../serialization/workspace_comments.js';
-import { CommentBase, CommentBaseJson } from './events_comment_base.js';
 import type { Workspace } from '../workspace.js';
+import { CommentBase, CommentBaseJson } from './events_comment_base.js';
+import { EventType } from './type.js';
 /**
  * Notifies listeners that a workspace comment has been deleted.
  */
 export declare class CommentDelete extends CommentBase {
-    type: string;
+    type: EventType;
     /** The XML representation of the deleted workspace comment. */
     xml?: Element;
     /** The JSON representation of the created workspace comment. */