blockly 11.1.1 → 11.2.0-beta.1

package/core/block.d.ts

@@ -15,16 +15,16 @@ import { Connection } from './connection.js';
 import { ConnectionType } from './connection_type.js';
 import type { Abstract } from './events/events_abstract.js';
 import type { Field } from './field.js';
+import { IconType } from './icons/icon_types.js';
+import type { MutatorIcon } from './icons/mutator_icon.js';
 import { Input } from './inputs/input.js';
 import type { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
 import { type IIcon } from './interfaces/i_icon.js';
-import type { MutatorIcon } from './icons/mutator_icon.js';
 import * as Tooltip from './tooltip.js';
 import { Coordinate } from './utils/coordinate.js';
 import { Size } from './utils/size.js';
 import type { VariableModel } from './variable_model.js';
 import type { Workspace } from './workspace.js';
-import { IconType } from './icons/icon_types.js';
 /**
  * Class for one block.
  * Not normally called directly, workspace.newBlock() is preferred.
@@ -100,22 +100,28 @@ export declare class Block implements IASTNodeLocation {
      */
     suppressPrefixSuffix: boolean | null;
     /**
-     * An optional property for declaring developer variables.  Return a list of
-     * variable names for use by generators.  Developer variables are never
-     * shown to the user, but are declared as global variables in the generated
-     * code.
+     * An optional method for declaring developer variables, to be used
+     * by generators.  Developer variables are never shown to the user,
+     * but are declared as global variables in the generated code.
+     *
+     * @returns a list of developer variable names.
      */
     getDeveloperVariables?: () => string[];
     /**
-     * An optional function that reconfigures the block based on the contents of
-     * the mutator dialog.
+     * An optional method that reconfigures the block based on the
+     * contents of the mutator dialog.
+     *
+     * @param rootBlock The root block in the mutator flyout.
      */
-    compose?: (p1: Block) => void;
+    compose?: (rootBlock: Block) => void;
     /**
-     * An optional function that populates the mutator's dialog with
-     * this block's components.
+     * An optional function that populates the mutator flyout with
+     * blocks representing this block's configuration.
+     *
+     * @param workspace The mutator flyout's workspace.
+     * @returns The root block created in the flyout's workspace.
      */
-    decompose?: (p1: Workspace) => Block;
+    decompose?: (workspace: Workspace) => Block;
     id: string;
     outputConnection: Connection | null;
     nextConnection: Connection | null;
@@ -157,7 +163,7 @@ export declare class Block implements IASTNodeLocation {
     /**
      * String for block help, or function that returns a URL. Null for no help.
      */
-    helpUrl: string | Function | null;
+    helpUrl: string | (() => string) | null;
     /** A bound callback function to use when the parent workspace changes. */
     private onchangeWrapper_;
     /**
@@ -471,7 +477,7 @@ export declare class Block implements IASTNodeLocation {
      * @param url URL string for block help, or function that returns a URL.  Null
      *     for no help.
      */
-    setHelpUrl(url: string | Function): void;
+    setHelpUrl(url: string | (() => string)): void;
     /**
      * Sets the tooltip for this block.
      *

package/core/block_svg.d.ts

@@ -10,28 +10,28 @@
  */
 import './events/events_selected.js';
 import { Block } from './block.js';
+import { IDeletable } from './blockly.js';
+import { BlockCopyData } from './clipboard/block_paster.js';
 import type { Connection } from './connection.js';
 import { ConnectionType } from './connection_type.js';
 import { ContextMenuOption, LegacyContextMenuOption } from './contextmenu_registry.js';
 import type { Field } from './field.js';
+import { IconType } from './icons/icon_types.js';
+import { MutatorIcon } from './icons/mutator_icon.js';
 import type { Input } from './inputs/input.js';
 import type { IASTNodeLocationSvg } from './interfaces/i_ast_node_location_svg.js';
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
 import type { ICopyable } from './interfaces/i_copyable.js';
 import type { IDragStrategy, IDraggable } from './interfaces/i_draggable.js';
 import { IIcon } from './interfaces/i_icon.js';
-import { MutatorIcon } from './icons/mutator_icon.js';
 import { RenderedConnection } from './rendered_connection.js';
 import type { IPathObject } from './renderers/common/i_path_object.js';
 import type { BlockStyle } from './theme.js';
 import { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';
+import { FlyoutItemInfo } from './utils/toolbox.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
-import { IconType } from './icons/icon_types.js';
-import { BlockCopyData } from './clipboard/block_paster.js';
-import { IDeletable } from './blockly.js';
-import { FlyoutItemInfo } from './utils/toolbox.js';
 /**
  * Class for a block's SVG representation.
  * Not normally called directly, workspace.newBlock() is preferred.
@@ -49,7 +49,23 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      */
     static readonly COLLAPSED_WARNING_ID = "TEMP_COLLAPSED_WARNING_";
     decompose?: (p1: Workspace) => BlockSvg;
-    saveConnections?: (p1: BlockSvg) => void;
+    /**
+     * An optional method which saves a record of blocks connected to
+     * this block so they can be later restored after this block is
+     * recoomposed (reconfigured).  Typically records the connected
+     * blocks on properties on blocks in the mutator flyout, so that
+     * rearranging those component blocks will automatically rearrange
+     * the corresponding connected blocks on this block after this block
+     * is recomposed.
+     *
+     * To keep the saved connection information up-to-date, MutatorIcon
+     * arranges for an event listener to call this method any time the
+     * mutator flyout is open and a change occurs on this block's
+     * workspace.
+     *
+     * @param rootBlock The root block in the mutator flyout.
+     */
+    saveConnections?: (rootBlock: BlockSvg) => void;
     customContextMenu?: (p1: Array<ContextMenuOption | LegacyContextMenuOption>) => void;
     /**
      * Height of this block, not including any statement blocks above or below.
@@ -61,6 +77,13 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * Width is in workspace units.
      */
     width: number;
+    /**
+     * Width of this block, not including any connected value blocks.
+     * Width is in workspace units.
+     *
+     * @internal
+     */
+    childlessWidth: number;
     /**
      * Map from IDs for warnings text to PIDs of functions to apply them.
      * Used to be able to maintain multiple warnings.
@@ -125,7 +148,7 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
     getColourTertiary(): string | undefined;
     /** Selects this block. Highlights the block visually. */
     select(): void;
-    /** Unselects this block. Unhighlights the blockv visually.   */
+    /** Unselects this block. Unhighlights the block visually. */
     unselect(): void;
     /**
      * Sets the parent of this block to be a new block or null.
@@ -191,6 +214,15 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * @returns Object with coordinates of the bounding box.
      */
     getBoundingRectangle(): Rect;
+    /**
+     * Returns the coordinates of a bounding box describing the dimensions of this
+     * block alone.
+     * Coordinate system: workspace coordinates.
+     *
+     * @returns Object with coordinates of the bounding box.
+     */
+    getBoundingRectangleWithoutChildren(): Rect;
+    private getBoundingRectangleWithDimensions;
     /**
      * Notify every input on this block to mark its fields as dirty.
      * A dirty field is a field that needs to be re-rendered.
@@ -433,10 +465,11 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * <g> tags do not respect z-index so SVG renders them in the
      * order that they are in the DOM.  By placing this block first within the
      * block group's <g>, it will render on top of any other blocks.
+     * Use sparingly, this method is expensive because it reorders the DOM
+     * nodes.
      *
-     * @param blockOnly: True to only move this block to the front without
+     * @param blockOnly True to only move this block to the front without
      *     adjusting its parents.
-     * @internal
      */
     bringToFront(blockOnly?: boolean): void;
     /**

package/core/blockly.d.ts

@@ -16,6 +16,7 @@ import * as browserEvents from './browser_events.js';
 import * as bubbles from './bubbles.js';
 import * as bumpObjects from './bump_objects.js';
 import * as clipboard from './clipboard.js';
+import * as comments from './comments.js';
 import * as common from './common.js';
 import { ComponentManager } from './component_manager.js';
 import { config } from './config.js';
@@ -23,15 +24,15 @@ import { Connection } from './connection.js';
 import { ConnectionChecker } from './connection_checker.js';
 import { ConnectionDB } from './connection_db.js';
 import { ConnectionType } from './connection_type.js';
+import * as constants from './constants.js';
 import * as ContextMenu from './contextmenu.js';
 import * as ContextMenuItems from './contextmenu_items.js';
 import { ContextMenuRegistry } from './contextmenu_registry.js';
-import * as comments from './comments.js';
 import * as Css from './css.js';
 import { DeleteArea } from './delete_area.js';
 import * as dialog from './dialog.js';
-import * as dragging from './dragging.js';
 import { DragTarget } from './drag_target.js';
+import * as dragging from './dragging.js';
 import * as dropDownDiv from './dropdowndiv.js';
 import * as Events from './events/events.js';
 import * as Extensions from './extensions.js';
@@ -55,8 +56,8 @@ import { Gesture } from './gesture.js';
 import { Grid } from './grid.js';
 import * as icons from './icons.js';
 import { inject } from './inject.js';
-import { Input } from './inputs/input.js';
 import * as inputs from './inputs.js';
+import { Input } from './inputs/input.js';
 import { InsertionMarkerManager } from './insertion_marker_manager.js';
 import { InsertionMarkerPreviewer } from './insertion_marker_previewer.js';
 import { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
@@ -70,12 +71,12 @@ import { IComponent } from './interfaces/i_component.js';
 import { IConnectionChecker } from './interfaces/i_connection_checker.js';
 import { IConnectionPreviewer } from './interfaces/i_connection_previewer.js';
 import { IContextMenu } from './interfaces/i_contextmenu.js';
-import { ICopyable, isCopyable, ICopyData } from './interfaces/i_copyable.js';
+import { ICopyData, ICopyable, isCopyable } from './interfaces/i_copyable.js';
 import { IDeletable, isDeletable } from './interfaces/i_deletable.js';
 import { IDeleteArea } from './interfaces/i_delete_area.js';
 import { IDragTarget } from './interfaces/i_drag_target.js';
+import { IDragStrategy, IDraggable, isDraggable } from './interfaces/i_draggable.js';
 import { IDragger } from './interfaces/i_dragger.js';
-import { IDraggable, isDraggable, IDragStrategy } from './interfaces/i_draggable.js';
 import { IFlyout } from './interfaces/i_flyout.js';
 import { IHasBubble, hasBubble } from './interfaces/i_has_bubble.js';
 import { IIcon, isIcon } from './interfaces/i_icon.js';
@@ -99,8 +100,9 @@ import { BasicCursor } from './keyboard_nav/basic_cursor.js';
 import { Cursor } from './keyboard_nav/cursor.js';
 import { Marker } from './keyboard_nav/marker.js';
 import { TabNavigateCursor } from './keyboard_nav/tab_navigate_cursor.js';
-import { MarkerManager } from './marker_manager.js';
 import type { LayerManager } from './layer_manager.js';
+import * as layers from './layers.js';
+import { MarkerManager } from './marker_manager.js';
 import { Menu } from './menu.js';
 import { MenuItem } from './menuitem.js';
 import { MetricsManager } from './metrics_manager.js';
@@ -110,10 +112,9 @@ import { Options } from './options.js';
 import * as uiPosition from './positionable_helpers.js';
 import * as Procedures from './procedures.js';
 import * as registry from './registry.js';
-import { RenderedConnection } from './rendered_connection.js';
 import * as renderManagement from './render_management.js';
+import { RenderedConnection } from './rendered_connection.js';
 import * as blockRendering from './renderers/common/block_rendering.js';
-import * as constants from './constants.js';
 import * as geras from './renderers/geras/geras.js';
 import * as thrasos from './renderers/thrasos/thrasos.js';
 import * as zelos from './renderers/zelos/zelos.js';
@@ -261,144 +262,7 @@ export declare const VARIABLE_DYNAMIC_CATEGORY_NAME: string;
  * procedure blocks.
  */
 export declare const PROCEDURE_CATEGORY_NAME: string;
-export { browserEvents };
-export { ContextMenu };
-export { ContextMenuItems };
-export { Css };
-export { Events };
-export { Extensions };
-export { Procedures };
-export { Procedures as procedures };
-export { ShortcutItems };
-export { Themes };
-export { Tooltip };
-export { Touch };
-export { Variables };
-export { VariablesDynamic };
-export { WidgetDiv };
-export { Xml };
-export { blockAnimations };
-export { blockRendering };
-export { bumpObjects };
-export { clipboard };
-export { common };
-export { constants };
-export { dialog };
-export { fieldRegistry };
-export { geras };
-export { registry };
-export { thrasos };
-export { uiPosition };
-export { utils };
-export { zelos };
-export { ASTNode };
-export { BasicCursor };
-export { Block };
-export { BlocklyOptions };
-export { BlockSvg };
-export { Blocks };
-export { bubbles };
-export { CollapsibleToolboxCategory };
-export { ComponentManager };
-export { Connection };
-export { ConnectionType };
-export { ConnectionChecker };
-export { ConnectionDB };
-export { ContextMenuRegistry };
-export { comments };
-export { Cursor };
-export { DeleteArea };
-export { dragging };
-export { DragTarget };
+export { ASTNode, BasicCursor, Block, BlockSvg, BlocklyOptions, Blocks, CollapsibleToolboxCategory, ComponentManager, Connection, ConnectionChecker, ConnectionDB, ConnectionType, ContextMenu, ContextMenuItems, ContextMenuRegistry, Css, Cursor, DeleteArea, DragTarget, Events, Extensions, Procedures, ShortcutItems, Themes, Tooltip, Touch, Variables, VariablesDynamic, WidgetDiv, Xml, blockAnimations, blockRendering, browserEvents, bubbles, bumpObjects, clipboard, comments, common, constants, dialog, dragging, fieldRegistry, geras, Procedures as procedures, registry, thrasos, uiPosition, utils, zelos, };
 export declare const DropDownDiv: typeof dropDownDiv;
-export { Field, FieldConfig, FieldValidator, UnattachedFieldError };
-export { FieldCheckbox, FieldCheckboxConfig, FieldCheckboxFromJsonConfig, FieldCheckboxValidator, };
-export { FieldDropdown, FieldDropdownConfig, FieldDropdownFromJsonConfig, FieldDropdownValidator, MenuGenerator, MenuGeneratorFunction, MenuOption, };
-export { FieldImage, FieldImageConfig, FieldImageFromJsonConfig };
-export { FieldLabel, FieldLabelConfig, FieldLabelFromJsonConfig };
-export { FieldLabelSerializable };
-export { FieldNumber, FieldNumberConfig, FieldNumberFromJsonConfig, FieldNumberValidator, };
-export { FieldTextInput, FieldTextInputConfig, FieldTextInputFromJsonConfig, FieldTextInputValidator, };
-export { FieldVariable, FieldVariableConfig, FieldVariableFromJsonConfig, FieldVariableValidator, };
-export { Flyout };
-export { FlyoutButton };
-export { FlyoutMetricsManager };
-export { CodeGenerator };
-export { CodeGenerator as Generator };
-export { Gesture };
-export { Grid };
-export { HorizontalFlyout };
-export { IASTNodeLocation };
-export { IASTNodeLocationSvg };
-export { IASTNodeLocationWithBlock };
-export { IAutoHideable };
-export { IBoundedElement };
-export { IBubble };
-export { ICollapsibleToolboxItem };
-export { IComponent };
-export { IConnectionChecker };
-export { IConnectionPreviewer };
-export { IContextMenu };
-export { icons };
-export { ICopyable, isCopyable, ICopyData };
-export { IDeletable, isDeletable };
-export { IDeleteArea };
-export { IDragTarget };
-export { IDragger };
-export { IDraggable, isDraggable, IDragStrategy };
-export { IFlyout };
-export { IHasBubble, hasBubble };
-export { IIcon, isIcon };
-export { IKeyboardAccessible };
-export { IMetricsManager };
-export { IMovable };
-export { Input };
-export { inputs };
-export { InsertionMarkerManager };
-export { InsertionMarkerPreviewer };
-export { IObservable, isObservable };
-export { IPaster, isPaster };
-export { IPositionable };
-export { IRegistrable };
-export { IRenderedElement, isRenderedElement };
-export { ISelectable, isSelectable };
-export { ISelectableToolboxItem };
-export { ISerializable, isSerializable };
-export { IStyleable };
-export { IToolbox };
-export { IToolboxItem };
-export { IVariableBackedParameterModel, isVariableBackedParameterModel };
-export { Marker };
-export { MarkerManager };
-export { LayerManager };
-export { Menu };
-export { MenuItem };
-export { MetricsManager };
-export { Msg, setLocale };
-export { Names };
-export { Options };
-export { RenderedConnection };
-export { renderManagement };
-export { Scrollbar };
-export { ScrollbarPair };
-export { ShortcutRegistry };
-export { TabNavigateCursor };
-export { Theme };
-export { ThemeManager };
-export { Toolbox };
-export { ToolboxCategory };
-export { ToolboxItem };
-export { ToolboxSeparator };
-export { Trashcan };
-export { VariableMap };
-export { VariableModel };
-export { VerticalFlyout };
-export { Workspace };
-export { WorkspaceAudio };
-export { WorkspaceDragger };
-export { WorkspaceSvg };
-export { ZoomControls };
-export { config };
-export { inject };
-export { serialization };
+export { CodeGenerator, Field, FieldCheckbox, FieldCheckboxConfig, FieldCheckboxFromJsonConfig, FieldCheckboxValidator, FieldConfig, FieldDropdown, FieldDropdownConfig, FieldDropdownFromJsonConfig, FieldDropdownValidator, FieldImage, FieldImageConfig, FieldImageFromJsonConfig, FieldLabel, FieldLabelConfig, FieldLabelFromJsonConfig, FieldLabelSerializable, FieldNumber, FieldNumberConfig, FieldNumberFromJsonConfig, FieldNumberValidator, FieldTextInput, FieldTextInputConfig, FieldTextInputFromJsonConfig, FieldTextInputValidator, FieldValidator, FieldVariable, FieldVariableConfig, FieldVariableFromJsonConfig, FieldVariableValidator, Flyout, FlyoutButton, FlyoutMetricsManager, CodeGenerator as Generator, Gesture, Grid, HorizontalFlyout, IASTNodeLocation, IASTNodeLocationSvg, IASTNodeLocationWithBlock, IAutoHideable, IBoundedElement, IBubble, ICollapsibleToolboxItem, IComponent, IConnectionChecker, IConnectionPreviewer, IContextMenu, ICopyData, ICopyable, IDeletable, IDeleteArea, IDragStrategy, IDragTarget, IDraggable, IDragger, IFlyout, IHasBubble, IIcon, IKeyboardAccessible, IMetricsManager, IMovable, IObservable, IPaster, IPositionable, IRegistrable, IRenderedElement, ISelectable, ISelectableToolboxItem, ISerializable, IStyleable, IToolbox, IToolboxItem, IVariableBackedParameterModel, Input, InsertionMarkerManager, InsertionMarkerPreviewer, LayerManager, Marker, MarkerManager, Menu, MenuGenerator, MenuGeneratorFunction, MenuItem, MenuOption, MetricsManager, Msg, Names, Options, RenderedConnection, Scrollbar, ScrollbarPair, ShortcutRegistry, TabNavigateCursor, Theme, ThemeManager, Toolbox, ToolboxCategory, ToolboxItem, ToolboxSeparator, Trashcan, UnattachedFieldError, VariableMap, VariableModel, VerticalFlyout, Workspace, WorkspaceAudio, WorkspaceDragger, WorkspaceSvg, ZoomControls, config, hasBubble, icons, inject, inputs, isCopyable, isDeletable, isDraggable, isIcon, isObservable, isPaster, isRenderedElement, isSelectable, isSerializable, isVariableBackedParameterModel, layers, renderManagement, serialization, setLocale, };
 //# sourceMappingURL=blockly.d.ts.map

package/core/blockly_options.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2016 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { Theme, ITheme } from './theme.js';
-import type { WorkspaceSvg } from './workspace_svg.js';
+import type { ITheme, Theme } from './theme.js';
 import type { ToolboxDefinition } from './utils/toolbox.js';
+import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Blockly options.
  */

package/core/browser_events.d.ts

@@ -23,7 +23,7 @@ export type Data = [EventTarget, string, (e: Event) => void][];
  *     simultaneous touches.  False by default.
  * @returns Opaque data that can be passed to unbindEvent_.
  */
-export declare function conditionalBind(node: EventTarget, name: string, thisObject: Object | null, func: Function, opt_noCaptureIdentifier?: boolean): Data;
+export declare function conditionalBind(node: EventTarget, name: string, thisObject: object | null, func: Function, opt_noCaptureIdentifier?: boolean): Data;
 /**
  * Bind an event handler that should be called regardless of whether it is part
  * of the active touch stream.
@@ -36,7 +36,7 @@ export declare function conditionalBind(node: EventTarget, name: string, thisObj
  * @param func Function to call when event is triggered.
  * @returns Opaque data that can be passed to unbindEvent_.
  */
-export declare function bind(node: EventTarget, name: string, thisObject: Object | null, func: Function): Data;
+export declare function bind(node: EventTarget, name: string, thisObject: object | null, func: Function): Data;
 /**
  * Unbind one or more events event from a function call.
  *

package/core/bubbles/bubble.d.ts

@@ -3,12 +3,12 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { ISelectable } from '../blockly.js';
 import { IBubble } from '../interfaces/i_bubble.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { Size } from '../utils/size.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
-import { ISelectable } from '../blockly.js';
 /**
  * The abstract pop-up bubble class. This creates a UI that looks like a speech
  * bubble, where it has a "tail" that points to the block, and a "head" that
@@ -96,7 +96,7 @@ export declare abstract class Bubble implements IBubble, ISelectable {
     protected getColour(): string;
     /** Sets the colour of the background and tail of this bubble. */
     setColour(colour: string): void;
-    /** Passes the pointer event off to the gesture system. */
+    /** Brings the bubble to the front and passes the pointer event off to the gesture system. */
     private onMouseDown;
     /** Positions the bubble relative to its anchor. Does not render its tail. */
     protected positionRelativeToAnchor(): void;

package/core/bubbles/mini_workspace_bubble.d.ts

@@ -3,13 +3,13 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Abstract as AbstractEvent } from '../events/events_abstract.js';
 import type { BlocklyOptions } from '../blockly_options.js';
-import { Bubble } from './bubble.js';
-import { Coordinate } from '../utils/coordinate.js';
+import { Abstract as AbstractEvent } from '../events/events_abstract.js';
 import { Options } from '../options.js';
+import { Coordinate } from '../utils/coordinate.js';
 import type { Rect } from '../utils/rect.js';
 import type { WorkspaceSvg } from '../workspace_svg.js';
+import { Bubble } from './bubble.js';
 /**
  * A bubble that contains a mini-workspace which can hold arbitrary blocks.
  * Used by the mutator icon.

package/core/bubbles/text_bubble.d.ts

@@ -3,10 +3,10 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Bubble } from './bubble.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
+import { Bubble } from './bubble.js';
 /**
  * A bubble that displays non-editable text. Used by the warning icon.
  */

package/core/bubbles/textinput_bubble.d.ts

@@ -3,11 +3,11 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Bubble } from './bubble.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { Size } from '../utils/size.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
+import { Bubble } from './bubble.js';
 /**
  * A bubble that displays editable text. It can also be resized by the user.
  * Used by the comment icon.
@@ -42,6 +42,7 @@ export declare class TextInputBubble extends Bubble {
     private readonly DEFAULT_SIZE;
     /** The minimum size of this bubble, including borders. */
     private readonly MIN_SIZE;
+    private editable;
     /**
      * @param workspace The workspace this bubble belongs to.
      * @param anchor The anchor location of the thing this bubble is attached to.
@@ -54,6 +55,10 @@ export declare class TextInputBubble extends Bubble {
     getText(): string;
     /** Sets the text of this bubble. Calls change listeners. */
     setText(text: string): void;
+    /** Sets whether or not the text in the bubble is editable. */
+    setEditable(editable: boolean): void;
+    /** Returns whether or not the text in the bubble is editable. */
+    isEditable(): boolean;
     /** Adds a change listener to be notified when this bubble's text changes. */
     addTextChangeListener(listener: () => void): void;
     /** Adds a change listener to be notified when this bubble's size changes. */

package/core/bubbles.d.ts

@@ -4,8 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Bubble } from './bubbles/bubble.js';
+import { MiniWorkspaceBubble } from './bubbles/mini_workspace_bubble.js';
 import { TextBubble } from './bubbles/text_bubble.js';
 import { TextInputBubble } from './bubbles/textinput_bubble.js';
-import { MiniWorkspaceBubble } from './bubbles/mini_workspace_bubble.js';
-export { Bubble, TextBubble, TextInputBubble, MiniWorkspaceBubble };
+export { Bubble, MiniWorkspaceBubble, TextBubble, TextInputBubble };
 //# sourceMappingURL=bubbles.d.ts.map

package/core/clipboard/workspace_comment_paster.d.ts

@@ -3,12 +3,12 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { IPaster } from '../interfaces/i_paster.js';
+import { RenderedWorkspaceComment } from '../comments/rendered_workspace_comment.js';
 import { ICopyData } from '../interfaces/i_copyable.js';
+import { IPaster } from '../interfaces/i_paster.js';
+import * as commentSerialiation from '../serialization/workspace_comments.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
-import * as commentSerialiation from '../serialization/workspace_comments.js';
-import { RenderedWorkspaceComment } from '../comments/rendered_workspace_comment.js';
 export declare class WorkspaceCommentPaster implements IPaster<WorkspaceCommentCopyData, RenderedWorkspaceComment> {
     static TYPE: string;
     paste(copyData: WorkspaceCommentCopyData, workspace: WorkspaceSvg, coordinate?: Coordinate): RenderedWorkspaceComment | null;

package/core/clipboard.d.ts

@@ -3,11 +3,11 @@
  * Copyright 2021 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { ICopyData, ICopyable } from './interfaces/i_copyable.js';
 import { BlockPaster } from './clipboard/block_paster.js';
-import { WorkspaceSvg } from './workspace_svg.js';
 import * as registry from './clipboard/registry.js';
+import type { ICopyData, ICopyable } from './interfaces/i_copyable.js';
 import { Coordinate } from './utils/coordinate.js';
+import { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Private version of copy for stubbing in tests.
  */

package/core/comments/comment_view.d.ts

@@ -4,9 +4,9 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { IRenderedElement } from '../interfaces/i_rendered_element.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Size } from '../utils/size.js';
+import { WorkspaceSvg } from '../workspace_svg.js';
 export declare class CommentView implements IRenderedElement {
     private readonly workspace;
     /** The root group element of the comment view. */
@@ -65,6 +65,8 @@ export declare class CommentView implements IRenderedElement {
     private disposing;
     /** Whether this comment view has been disposed or not. */
     private disposed;
+    /** Size of this comment when the resize drag was initiated. */
+    private preResizeSize?;
     constructor(workspace: WorkspaceSvg);
     /**
      * Creates the rect we use for highlighting the comment when it's selected.
@@ -92,6 +94,11 @@ export declare class CommentView implements IRenderedElement {
      * Sets the size of the comment in workspace units, and updates the view
      * elements to reflect the new size.
      */
+    setSizeWithoutFiringEvents(size: Size): void;
+    /**
+     * Sets the size of the comment in workspace units, updates the view
+     * elements to reflect the new size, and triggers size change listeners.
+     */
     setSize(size: Size): void;
     /**
      * Calculates the minimum size for the uncollapsed comment based on text
@@ -128,7 +135,7 @@ export declare class CommentView implements IRenderedElement {
     private updateResizeHandlePosition;
     /**
      * Triggers listeners when the size of the comment changes, either
-     * progrmatically or manually by the user.
+     * programmatically or manually by the user.
      */
     private onSizeChange;
     /**
@@ -189,7 +196,7 @@ export declare class CommentView implements IRenderedElement {
     removeTextChangeListener(listener: () => void): void;
     /**
      * Triggers listeners when the text of the comment changes, either
-     * progrmatically or manually by the user.
+     * programmatically or manually by the user.
      */
     private onTextChange;
     /** Updates the preview text element to reflect the given text. */

package/core/comments/rendered_workspace_comment.d.ts

@@ -3,19 +3,19 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { WorkspaceComment } from './workspace_comment.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
-import { Coordinate } from '../utils/coordinate.js';
-import { Rect } from '../utils/rect.js';
-import { Size } from '../utils/size.js';
+import { WorkspaceCommentCopyData } from '../clipboard/workspace_comment_paster.js';
 import { IBoundedElement } from '../interfaces/i_bounded_element.js';
-import { IRenderedElement } from '../interfaces/i_rendered_element.js';
+import { IContextMenu } from '../interfaces/i_contextmenu.js';
+import { ICopyable } from '../interfaces/i_copyable.js';
+import { IDeletable } from '../interfaces/i_deletable.js';
 import { IDraggable } from '../interfaces/i_draggable.js';
+import { IRenderedElement } from '../interfaces/i_rendered_element.js';
 import { ISelectable } from '../interfaces/i_selectable.js';
-import { IDeletable } from '../interfaces/i_deletable.js';
-import { ICopyable } from '../interfaces/i_copyable.js';
-import { WorkspaceCommentCopyData } from '../clipboard/workspace_comment_paster.js';
-import { IContextMenu } from '../interfaces/i_contextmenu.js';
+import { Coordinate } from '../utils/coordinate.js';
+import { Rect } from '../utils/rect.js';
+import { Size } from '../utils/size.js';
+import { WorkspaceSvg } from '../workspace_svg.js';
+import { WorkspaceComment } from './workspace_comment.js';
 export declare class RenderedWorkspaceComment extends WorkspaceComment implements IBoundedElement, IRenderedElement, IDraggable, ISelectable, IDeletable, ICopyable<WorkspaceCommentCopyData>, IContextMenu {
     /** The class encompassing the svg elements making up the workspace comment. */
     private view;