blockly 11.2.0-beta.0 → 11.2.0-beta.2

package/core/block.d.ts

@@ -55,7 +55,7 @@ export declare class Block implements IASTNodeLocation {
      * Colour of the block as HSV hue value (0-360)
      * This may be null if the block colour was not set via a hue number.
      */
-    private hue_;
+    private hue;
     /** Colour of the block in '#RRGGBB' format. */
     protected colour_: string;
     /** Name of the block style. */
@@ -134,10 +134,10 @@ export declare class Block implements IASTNodeLocation {
     contextMenu: boolean;
     protected parentBlock_: this | null;
     protected childBlocks_: this[];
-    private deletable_;
-    private movable_;
-    private editable_;
-    private isShadow_;
+    private deletable;
+    private movable;
+    private editable;
+    private shadow;
     protected collapsed_: boolean;
     protected outputShape_: number | null;
     /**
@@ -150,7 +150,7 @@ export declare class Block implements IASTNodeLocation {
      * @internal
      */
     initialized: boolean;
-    private readonly xy_;
+    private readonly xy;
     isInFlyout: boolean;
     isInMutator: boolean;
     RTL: boolean;
@@ -165,7 +165,7 @@ export declare class Block implements IASTNodeLocation {
      */
     helpUrl: string | (() => string) | null;
     /** A bound callback function to use when the parent workspace changes. */
-    private onchangeWrapper_;
+    private onchangeWrapper;
     /**
      * A count of statement inputs on the block.
      *
@@ -230,7 +230,7 @@ export declare class Block implements IASTNodeLocation {
      * @param opt_healStack Disconnect right-side block and connect to left-side
      *     block.  Defaults to false.
      */
-    private unplugFromRow_;
+    private unplugFromRow;
     /**
      * Returns the connection on the value input that is connected to another
      * block. When an insertion marker is connected to a connection with a block
@@ -240,7 +240,7 @@ export declare class Block implements IASTNodeLocation {
      *
      * @returns The connection on the value input, or null.
      */
-    private getOnlyValueConnection_;
+    private getOnlyValueConnection;
     /**
      * Unplug this statement block from its superior block.  Optionally reconnect
      * the block underneath with the block on top.
@@ -248,7 +248,7 @@ export declare class Block implements IASTNodeLocation {
      * @param opt_healStack Disconnect child statement and reconnect stack.
      *     Defaults to false.
      */
-    private unplugFromStack_;
+    private unplugFromStack;
     /**
      * Returns all connections originating from this block.
      *
@@ -783,14 +783,14 @@ export declare class Block implements IASTNodeLocation {
      * @param json Structured data describing the block.
      * @param warningPrefix Warning prefix string identifying block.
      */
-    private jsonInitColour_;
+    private jsonInitColour;
     /**
      * Initialize the style of this block from the JSON description.
      *
      * @param json Structured data describing the block.
      * @param warningPrefix Warning prefix string identifying block.
      */
-    private jsonInitStyle_;
+    private jsonInitStyle;
     /**
      * Add key/values from mixinObj to this block object. By default, this method
      * will check that the keys in mixinObj will not overwrite existing values in
@@ -812,7 +812,7 @@ export declare class Block implements IASTNodeLocation {
      *     of newline tokens, how should it be aligned?
      * @param warningPrefix Warning prefix string identifying block.
      */
-    private interpolate_;
+    private interpolate;
     /**
      * Validates that the tokens are within the correct bounds, with no
      * duplicates, and that all of the arguments are referred to. Throws errors if
@@ -821,7 +821,7 @@ export declare class Block implements IASTNodeLocation {
      * @param tokens An array of tokens to validate
      * @param argsCount The number of args that need to be referred to.
      */
-    private validateTokens_;
+    private validateTokens;
     /**
      * Inserts args in place of numerical tokens. String args are converted to
      * JSON that defines a label field. Newline characters are converted to
@@ -834,7 +834,7 @@ export declare class Block implements IASTNodeLocation {
      *     or dummy inputs, if necessary.
      * @returns The JSON definitions of field and inputs to add to the block.
      */
-    private interpolateArguments_;
+    private interpolateArguments;
     /**
      * Creates a field from the JSON definition of a field. If a field with the
      * given type cannot be found, this attempts to create a different field using
@@ -843,7 +843,7 @@ export declare class Block implements IASTNodeLocation {
      * @param element The element to try to turn into a field.
      * @returns The field defined by the JSON, or null if one couldn't be created.
      */
-    private fieldFromJson_;
+    private fieldFromJson;
     /**
      * Creates an input from the JSON definition of an input. Sets the input's
      * check and alignment if they are provided.
@@ -854,7 +854,7 @@ export declare class Block implements IASTNodeLocation {
      * @returns The input that has been created, or null if one could not be
      *     created for some reason (should never happen).
      */
-    private inputFromJson_;
+    private inputFromJson;
     /**
      * Returns true if the given string matches one of the input keywords.
      *
@@ -862,7 +862,7 @@ export declare class Block implements IASTNodeLocation {
      * @returns True if the given string matches one of the input keywords, false
      *     otherwise.
      */
-    private isInputKeyword_;
+    private isInputKeyword;
     /**
      * Turns a string into the JSON definition of a label field. If the string
      * becomes an empty string when trimmed, this returns null.
@@ -870,7 +870,7 @@ export declare class Block implements IASTNodeLocation {
      * @param str String to turn into the JSON definition of a label field.
      * @returns The JSON definition or null.
      */
-    private stringToFieldJson_;
+    private stringToFieldJson;
     /**
      * Move a named input to a different location on this block.
      *

package/core/block_svg.d.ts

@@ -91,20 +91,13 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
     private warningTextDb;
     /** Block's mutator icon (if any). */
     mutator: MutatorIcon | null;
-    private svgGroup_;
+    private svgGroup;
     style: BlockStyle;
     /** @internal */
     pathObject: IPathObject;
     /** Is this block a BlockSVG? */
     readonly rendered = true;
     private visuallyDisabled;
-    /**
-     * Is this block currently rendering? Used to stop recursive render calls
-     * from actually triggering a re-render.
-     */
-    private renderIsInProgress_;
-    /** Whether mousedown events have been bound yet. */
-    private eventsInit_;
     workspace: WorkspaceSvg;
     outputConnection: RenderedConnection;
     nextConnection: RenderedConnection;
@@ -238,7 +231,7 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * Makes sure that when the block is collapsed, it is rendered correctly
      * for that state.
      */
-    private updateCollapsed_;
+    private updateCollapsed;
     /**
      * Open the next (or previous) FieldTextInput.
      *
@@ -251,7 +244,7 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      *
      * @param e Pointer down event.
      */
-    private onMouseDown_;
+    private onMouseDown;
     /**
      * Load the block's help page in a new window.
      *

package/core/bubbles/textinput_bubble.d.ts

@@ -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/component_manager.d.ts

@@ -18,7 +18,7 @@ declare class Capability<_T> {
     static DRAG_TARGET: Capability<IDragTarget>;
     static DELETE_AREA: Capability<IDeleteArea>;
     static AUTOHIDEABLE: Capability<IAutoHideable>;
-    private readonly name_;
+    private readonly name;
     /** @param name The name of the component capability. */
     constructor(name: string);
     /**

package/core/connection.d.ts

@@ -102,11 +102,11 @@ export declare class Connection implements IASTNodeLocationWithBlock {
      * Called when an attempted connection fails. NOP by default (i.e. for
      * headless workspaces).
      *
-     * @param _otherConnection Connection that this connection failed to connect
-     *     to.
+     * @param _superiorConnection Connection that this connection failed to connect
+     *     to. The provided connection should be the superior connection.
      * @internal
      */
-    onFailedConnect(_otherConnection: Connection): void;
+    onFailedConnect(_superiorConnection: Connection): void;
     /**
      * Connect this connection to another connection.
      *

package/core/contextmenu_registry.d.ts

@@ -19,7 +19,7 @@ import type { WorkspaceSvg } from './workspace_svg.js';
 export declare class ContextMenuRegistry {
     static registry: ContextMenuRegistry;
     /** Registry of all registered RegistryItems, keyed by ID. */
-    private registry_;
+    private registeredItems;
     /** Resets the existing singleton instance of ContextMenuRegistry. */
     constructor();
     /** Clear and recreate the registry. */

package/core/dragging/block_drag_strategy.d.ts

@@ -96,6 +96,8 @@ export declare class BlockDragStrategy implements IDragStrategy {
      * connections.
      */
     endDrag(e?: PointerEvent): void;
+    /** Disposes of any state at the end of the drag. */
+    private disposeStep;
     /** Connects the given candidate connections. */
     private applyConnections;
     /**

package/core/events/events_block_move.d.ts

@@ -88,7 +88,7 @@ export declare class BlockMove extends BlockBase {
      *
      * @returns Collection of location info.
      */
-    private currentLocation_;
+    private currentLocation;
     /**
      * Does this event record any change of state?
      *

package/core/field.d.ts

@@ -74,18 +74,18 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      * Used to cache the field's tooltip value if setTooltip is called when the
      * field is not yet initialized. Is *not* guaranteed to be accurate.
      */
-    private tooltip_;
+    private tooltip;
     protected size_: Size;
     /**
      * Holds the cursors svg element when the cursor is attached to the field.
      * This is null if there is no cursor on the field.
      */
-    private cursorSvg_;
+    private cursorSvg;
     /**
      * Holds the markers svg element when the marker is attached to the field.
      * This is null if there is no marker on the field.
      */
-    private markerSvg_;
+    private markerSvg;
     /** The rendered field's SVG group element. */
     protected fieldGroup_: SVGGElement | null;
     /** The rendered field's SVG border element. */
@@ -95,7 +95,7 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
     /** The rendered field's text content element. */
     protected textContent_: Text | null;
     /** Mouse down event listener data. */
-    private mouseDownWrapper_;
+    private mouseDownWrapper;
     /** Constants associated with the source block's renderer. */
     protected constants_: ConstantProvider | null;
     /**
@@ -564,7 +564,7 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      * @param fireChangeEvent Whether to fire a change event if the value changes.
      * @returns New value, or an Error object.
      */
-    private processValidation_;
+    private processValidation;
     /**
      * Get the current value of the field.
      *

package/core/field_checkbox.d.ts

@@ -117,7 +117,7 @@ export declare class FieldCheckbox extends Field<CheckboxBool> {
      * @param value The value to convert.
      * @returns The converted value.
      */
-    private convertValueToBool_;
+    private convertValueToBool;
     /**
      * Construct a FieldCheckbox from a JSON arg object.
      *

package/core/field_dropdown.d.ts

@@ -54,6 +54,13 @@ export declare class FieldDropdown extends Field<string> {
     suffixField: string | null;
     private selectedOption;
     clickTarget_: SVGElement | null;
+    /**
+     * The y offset from the top of the field to the top of the image, if an image
+     * is selected.
+     */
+    protected static IMAGE_Y_OFFSET: number;
+    /** The total vertical padding above and below an image. */
+    protected static IMAGE_Y_PADDING: number;
     /**
      * @param menuGenerator A non-empty array of options for a dropdown list, or a
      *     function which generates these options. Also accepts Field.SKIP_SETUP
@@ -196,6 +203,33 @@ export declare class FieldDropdown extends Field<string> {
      * @internal
      */
     static fromJson(options: FieldDropdownFromJsonConfig): FieldDropdown;
+    /**
+     * Factor out common words in statically defined options.
+     * Create prefix and/or suffix labels.
+     */
+    protected trimOptions(options: MenuOption[]): {
+        options: MenuOption[];
+        prefix?: string;
+        suffix?: string;
+    };
+    /**
+     * Use the calculated prefix and suffix lengths to trim all of the options in
+     * the given array.
+     *
+     * @param options Array of option tuples:
+     *     (human-readable text or image, language-neutral name).
+     * @param prefixLength The length of the common prefix.
+     * @param suffixLength The length of the common suffix
+     * @returns A new array with all of the option text trimmed.
+     */
+    private applyTrim;
+    /**
+     * Validates the data structure to be processed as an options list.
+     *
+     * @param options The proposed dropdown options.
+     * @throws {TypeError} If proposed options are incorrectly structured.
+     */
+    protected validateOptions(options: MenuOption[]): void;
 }
 /**
  * Definition of a human-readable image dropdown option.

package/core/field_input.d.ts

@@ -47,9 +47,9 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      */
     protected valueWhenEditorWasOpened_: string | T | null;
     /** Key down event data. */
-    private onKeyDownWrapper_;
+    private onKeyDownWrapper;
     /** Key input event data. */
-    private onKeyInputWrapper_;
+    private onKeyInputWrapper;
     /**
      * Whether the field should consider the whole parent block to be its click
      * target.
@@ -150,13 +150,13 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      * Mobile browsers may have issues with in-line textareas (focus and
      * keyboards).
      */
-    private showPromptEditor_;
+    private showPromptEditor;
     /**
      * Create and show a text input editor that sits directly over the text input.
      *
      * @param quietInput True if editor should be created without focus.
      */
-    private showInlineEditor_;
+    private showInlineEditor;
     /**
      * Create the text input editor widget.
      *
@@ -193,7 +193,7 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      *
      * @param _e Keyboard event.
      */
-    private onHtmlInputChange_;
+    private onHtmlInputChange;
     /**
      * Set the HTML input value and the field's internal value. The difference
      * between this and `setValue` is that this also updates the HTML input

package/core/flyout_base.d.ts

@@ -150,7 +150,7 @@ export declare abstract class Flyout extends DeleteArea implements IAutoHideable
     /**
      * Whether the flyout is visible.
      */
-    private isVisible_;
+    private visible;
     /**
      * Whether the workspace containing this flyout is visible.
      */

package/core/flyout_metrics_manager.d.ts

@@ -29,7 +29,7 @@ export declare class FlyoutMetricsManager extends MetricsManager {
      *
      * @returns The bounding box of the blocks on the workspace.
      */
-    private getBoundingBox_;
+    private getBoundingBox;
     getContentMetrics(opt_getWorkspaceCoordinates?: boolean): {
         height: number;
         width: number;

package/core/generator.d.ts

@@ -19,7 +19,7 @@ import type { Workspace } from './workspace.js';
  * @deprecated
  * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/generating-code}
  * @param block The Block instance to generate code for.
- * @param genearator The CodeGenerator calling the function.
+ * @param generator The CodeGenerator calling the function.
  * @returns A string containing the generated code (for statement blocks),
  *     or a [code, precedence] tuple (for value/expression blocks), or
  *     null if no code should be emitted for block.

package/core/gesture.d.ts

@@ -101,7 +101,7 @@ export declare class Gesture {
     /** The event that most recently updated this gesture. */
     private mostRecentEvent;
     /** Boolean for whether or not this gesture is a multi-touch gesture. */
-    private isMultiTouch_;
+    private multiTouch;
     /** A map of cached points used for tracking multi-touch gestures. */
     private cachedPoints;
     /**

package/core/icons/comment_icon.d.ts

@@ -22,10 +22,8 @@ export declare class CommentIcon extends Icon implements IHasBubble, ISerializab
      * weight values are rendered farther toward the end of the block.
      */
     static readonly WEIGHT = 3;
-    /** The bubble used to show editable text to the user. */
+    /** The bubble used to show comment text to the user. */
     private textInputBubble;
-    /** The bubble used to show non-editable text to the user. */
-    private textBubble;
     /** The text of this comment. */
     private text;
     /** The size of this comment (which is applied to the editable bubble). */
@@ -90,6 +88,7 @@ export declare class CommentIcon extends Icon implements IHasBubble, ISerializab
     private showEditableBubble;
     /** Shows the non editable text bubble for this comment. */
     private showNonEditableBubble;
+    protected createBubble(): void;
     /** Hides any open bubbles owned by this comment. */
     private hideBubble;
     /**

package/core/marker_manager.d.ts

@@ -19,13 +19,13 @@ export declare class MarkerManager {
     /** The name of the local marker. */
     static readonly LOCAL_MARKER = "local_marker_1";
     /** The cursor. */
-    private cursor_;
+    private cursor;
     /** The cursor's SVG element. */
-    private cursorSvg_;
+    private cursorSvg;
     /** The map of markers for the workspace. */
     private markers;
     /** The marker's SVG element. */
-    private markerSvg_;
+    private markerSvg;
     /**
      * @param workspace The workspace for the marker manager.
      * @internal

package/core/options.d.ts

@@ -87,7 +87,7 @@ export declare class Options {
      * @param hasCategories Whether the workspace has categories or not.
      * @returns Normalized move options.
      */
-    private static parseMoveOptions_;
+    private static parseMoveOptions;
     /**
      * Parse the user-specified zoom options, using reasonable defaults where
      * behaviour is unspecified.  See zoom documentation:
@@ -96,7 +96,7 @@ export declare class Options {
      * @param options Dictionary of options.
      * @returns Normalized zoom options.
      */
-    private static parseZoomOptions_;
+    private static parseZoomOptions;
     /**
      * Parse the user-specified grid options, using reasonable defaults where
      * behaviour is unspecified. See grid documentation:
@@ -105,7 +105,7 @@ export declare class Options {
      * @param options Dictionary of options.
      * @returns Normalized grid options.
      */
-    private static parseGridOptions_;
+    private static parseGridOptions;
     /**
      * Parse the user-specified theme options, using the classic theme as a
      * default. https://developers.google.com/blockly/guides/configure/web/themes
@@ -113,7 +113,7 @@ export declare class Options {
      * @param options Dictionary of options.
      * @returns A Blockly Theme.
      */
-    private static parseThemeOptions_;
+    private static parseThemeOptions;
 }
 export declare namespace Options {
     interface GridOptions {

package/core/rendered_connection.d.ts

@@ -60,10 +60,15 @@ export declare class RenderedConnection extends Connection {
      * Move the block(s) belonging to the connection to a point where they don't
      * visually interfere with the specified connection.
      *
-     * @param staticConnection The connection to move away from.
+     * @param superiorConnection The connection to move away from. The provided
+     *     connection should be the superior connection and should not be
+     *     connected to this connection.
+     * @param initiatedByThis Whether or not the block group that was manipulated
+     *     recently causing bump checks is associated with the inferior
+     *     connection. Defaults to false.
      * @internal
      */
-    bumpAwayFrom(staticConnection: RenderedConnection): void;
+    bumpAwayFrom(superiorConnection: RenderedConnection, initiatedByThis?: boolean): void;
     /**
      * Change the connection's coordinates.
      *
@@ -162,11 +167,11 @@ export declare class RenderedConnection extends Connection {
      * Bumps this connection away from the other connection. Called when an
      * attempted connection fails.
      *
-     * @param otherConnection Connection that this connection failed to connect
-     *     to.
+     * @param superiorConnection Connection that this connection failed to connect
+     *     to. The provided connection should be the superior connection.
      * @internal
      */
-    onFailedConnect(otherConnection: Connection): void;
+    onFailedConnect(superiorConnection: Connection): void;
     /**
      * Disconnect two blocks that are connected by this connection.
      *

package/core/scrollbar_pair.d.ts

@@ -15,7 +15,7 @@ export declare class ScrollbarPair {
     vScroll: Scrollbar | null;
     corner_: SVGRectElement | null;
     /** Previously recorded metrics from the workspace. */
-    private oldHostMetrics_;
+    private oldHostMetrics;
     /**
      * @param workspace Workspace to bind the scrollbars to.
      * @param addHorizontal Whether to add a horizontal scrollbar.