blockly 12.3.1 → 12.4.1

package/core/browser_events.d.ts

@@ -21,9 +21,12 @@ export type Data = [EventTarget, string, (e: Event) => void][];
  * @param opt_noCaptureIdentifier True if triggering on this event should not
  *     block execution of other event handlers on this touch or other
  *     simultaneous touches.  False by default.
+ * @param options An object with options controlling the behavior of the event
+ *    listener. Passed through directly as the third argument to
+ *     `addEventListener`.
  * @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, options?: AddEventListenerOptions): Data;
 /**
  * Bind an event handler that should be called regardless of whether it is part
  * of the active touch stream.
@@ -34,9 +37,12 @@ export declare function conditionalBind(node: EventTarget, name: string, thisObj
  * @param name Event name to listen to (e.g. 'mousedown').
  * @param thisObject The value of 'this' in the function.
  * @param func Function to call when event is triggered.
+ * @param options An object with options controlling the behavior of the event
+ *    listener. Passed through directly as the third argument to
+ *     `addEventListener`.
  * @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, options?: AddEventListenerOptions): Data;
 /**
  * Unbind one or more events event from a function call.
  *

package/core/contextmenu_registry.d.ts

@@ -86,6 +86,7 @@ export declare namespace ContextMenuRegistry {
         scopeType?: ScopeType;
         weight: number;
         id: string;
+        preconditionFn?: (p1: Scope, menuOpenEvent: Event) => string;
     }
     /**
      * A representation of a normal, clickable menu item in the registry.
@@ -100,8 +101,8 @@ export declare namespace ContextMenuRegistry {
          */
         callback: (scope: Scope, menuOpenEvent: Event, menuSelectEvent: Event, location: Coordinate) => void;
         displayText: ((p1: Scope) => string | HTMLElement) | string | HTMLElement;
-        preconditionFn: (p1: Scope, menuOpenEvent: Event) => string;
         separator?: never;
+        preconditionFn: (p1: Scope, menuOpenEvent: Event) => string;
     }
     /**
      * A representation of a menu separator item in the registry.
@@ -110,7 +111,6 @@ export declare namespace ContextMenuRegistry {
         separator: true;
         callback?: never;
         displayText?: never;
-        preconditionFn?: never;
     }
     /**
      * A menu item as entered in the registry.

package/core/dragging/block_drag_strategy.d.ts

@@ -35,6 +35,15 @@ export declare class BlockDragStrategy implements IDragStrategy {
      * from any parent blocks.
      */
     startDrag(e?: PointerEvent): void;
+    /**
+     * Returns an array of visible bubbles attached to the given block or its
+     * descendants.
+     *
+     * @param block The block to identify open bubbles on.
+     * @returns An array of all currently visible bubbles on the given block or
+     *    its descendants.
+     */
+    private getVisibleBubbles;
     /**
      * Get whether the drag should act on a single block or a block stack.
      *

package/core/flyout_base.d.ts

@@ -104,6 +104,11 @@ export declare abstract class Flyout extends DeleteArea implements IAutoHideable
      * to reflow when elements in the flyout workspace change.
      */
     private reflowWrapper;
+    /**
+     * If true, prevents the reflow wrapper from running. Used to prevent infinite
+     * recursion.
+     */
+    private inhibitReflowWrapper;
     /**
      * List of flyout elements.
      */
@@ -372,13 +377,6 @@ export declare abstract class Flyout extends DeleteArea implements IAutoHideable
      * @internal
      */
     isScrollable(): boolean;
-    /**
-     * Copy a block from the flyout to the workspace and position it correctly.
-     *
-     * @param oldBlock The flyout block to copy.
-     * @returns The new block in the main workspace.
-     */
-    private placeNewBlock;
     /**
      * Serialize a block to JSON.
      *

package/core/flyout_button.d.ts

@@ -24,9 +24,10 @@ export declare class FlyoutButton implements IBoundedElement, IRenderedElement,
     static TEXT_MARGIN_Y: number;
     /** The radius of the flyout button's borders. */
     static BORDER_RADIUS: number;
+    /** The key to the function called when this button is activated. */
+    readonly callbackKey: string;
     private readonly text;
     private readonly position;
-    private readonly callbackKey;
     private readonly cssClass;
     /** Mouse up event data. */
     private onMouseDownWrapper;

package/core/gesture.d.ts

@@ -332,11 +332,6 @@ export declare class Gesture {
      * @param _e A pointerup event.
      */
     private doWorkspaceClick;
-    /**
-     * Move the dragged/clicked block to the front of the workspace so that it is
-     * not occluded by other blocks.
-     */
-    private bringBlockToFront;
     /**
      * Record the field that a gesture started on.
      *

package/core/icons/icon.d.ts

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Block } from '../block.js';
+import type { IContextMenu } from '../interfaces/i_contextmenu.js';
 import type { IFocusableTree } from '../interfaces/i_focusable_tree.js';
 import type { IIcon } from '../interfaces/i_icon.js';
 import * as tooltip from '../tooltip.js';
@@ -16,7 +17,7 @@ import type { IconType } from './icon_types.js';
  * block (such as warnings or comments) as opposed to fields, which provide
  * "actual" information, related to how a block functions.
  */
-export declare abstract class Icon implements IIcon {
+export declare abstract class Icon implements IIcon, IContextMenu {
     protected sourceBlock: Block;
     /**
      * The position of this icon relative to its blocks top-start,
@@ -78,5 +79,6 @@ export declare abstract class Icon implements IIcon {
      * @returns The block this icon is attached to.
      */
     getSourceBlock(): Block;
+    showContextMenu(e: PointerEvent): void;
 }
 //# sourceMappingURL=icon.d.ts.map

package/core/interfaces/i_contextmenu.d.ts

@@ -11,4 +11,6 @@ export interface IContextMenu {
      */
     showContextMenu(e: Event): void;
 }
+/** @returns true if the given object implements IContextMenu. */
+export declare function hasContextMenu(obj: any): obj is IContextMenu;
 //# sourceMappingURL=i_contextmenu.d.ts.map

package/core/layer_manager.d.ts

@@ -38,15 +38,24 @@ export declare class LayerManager {
      * Moves the given element to the drag layer, which exists on top of all other
      * layers, and the drag surface.
      *
+     * @param elem The element to move onto the drag layer.
+     * @param focus Whether or not to focus the element post-move.
+     *
      * @internal
      */
-    moveToDragLayer(elem: IRenderedElement & IFocusableNode): void;
+    moveToDragLayer(elem: IRenderedElement & IFocusableNode, focus?: boolean): void;
     /**
      * Moves the given element off of the drag layer.
      *
+     * @param elem The element to move off of the drag layer.
+     * @param layerNum The identifier of the layer to move the element onto.
+     *     Should be a constant from layers.ts.
+     * @param focus Whether or not the element should be focused once moved onto
+     *     the destination layer.
+     *
      * @internal
      */
-    moveOffDragLayer(elem: IRenderedElement & IFocusableNode, layerNum: number): void;
+    moveOffDragLayer(elem: IRenderedElement & IFocusableNode, layerNum: number, focus?: boolean): void;
     /**
      * Appends the given element to a layer. If the layer does not exist, it is
      * created.
@@ -82,5 +91,11 @@ export declare class LayerManager {
      * @internal
      */
     getBubbleLayer(): SVGGElement;
+    /**
+     * Returns the drag layer.
+     *
+     * @internal
+     */
+    getDragLayer(): SVGGElement | undefined;
 }
 //# sourceMappingURL=layer_manager.d.ts.map

package/core/menuitem.d.ts

@@ -135,5 +135,13 @@ export declare class MenuItem {
      * @internal
      */
     onAction(fn: (p1: MenuItem, menuSelectEvent: Event) => void, obj: object): void;
+    /**
+     * Adds or removes the checkmark indicator on this menu item.
+     * The indicator is present even if this menu item is not checked, as long
+     * as it is checkable; its visibility is controlled with CSS.
+     *
+     * @param add True to add the checkmark indicator, false to remove it.
+     */
+    private toggleHasCheckbox;
 }
 //# sourceMappingURL=menuitem.d.ts.map

package/core/rendered_connection.d.ts

@@ -8,7 +8,6 @@
  *
  * @class
  */
-import type { Block } from './block.js';
 import type { BlockSvg } from './block_svg.js';
 import { Connection } from './connection.js';
 import { IContextMenu } from './interfaces/i_contextmenu.js';
@@ -164,7 +163,7 @@ export declare class RenderedConnection extends Connection implements IContextMe
      *
      * @returns List of blocks to render.
      */
-    startTrackingAll(): Block[];
+    startTrackingAll(): BlockSvg[];
     /**
      * Behaviour after a connection attempt fails.
      * Bumps this connection away from the other connection. Called when an

package/core/toolbox/toolbox.d.ts

@@ -60,6 +60,8 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     protected boundEvents_: browserEvents.Data[];
     /** The workspace this toolbox is on. */
     protected readonly workspace_: WorkspaceSvg;
+    /** Whether the mouse is currently being clicked. */
+    private mouseDown;
     /** @param workspace The workspace in which to create new blocks. */
     constructor(workspace: WorkspaceSvg);
     /**

package/core/workspace_audio.d.ts

@@ -3,6 +3,12 @@
  * Copyright 2017 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+/**
+ * Object in charge of loading, storing, and playing audio for a
+ *     workspace.
+ *
+ * @class
+ */
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for loading, storing, and playing audio for a workspace.
@@ -15,6 +21,8 @@ export declare class WorkspaceAudio {
     private lastSound;
     /** Whether the audio is muted or not. */
     private muted;
+    /** Audio context used for playback. */
+    private readonly context?;
     /**
      * @param parentWorkspace The parent of the workspace this audio object
      *     belongs to, or null.
@@ -29,18 +37,11 @@ export declare class WorkspaceAudio {
     /**
      * Load an audio file.  Cache it, ready for instantaneous playing.
      *
-     * @param filenames List of file types in decreasing order of preference (i.e.
-     *     increasing size).  E.g. ['media/go.mp3', 'media/go.wav'] Filenames
-     *     include path from Blockly's root.  File extensions matter.
+     * @param filenames Single-item array containing the URL for the sound file.
+     *     Any items after the first item are ignored.
      * @param name Name of sound.
      */
-    load(filenames: string[], name: string): void;
-    /**
-     * Preload all the audio files so that they play quickly when asked for.
-     *
-     * @internal
-     */
-    preload(): void;
+    load(filenames: string[], name: string): Promise<void>;
     /**
      * Play a named sound at specified volume.  If volume is not specified,
      * use full volume (1).
@@ -48,7 +49,7 @@ export declare class WorkspaceAudio {
      * @param name Name of sound.
      * @param opt_volume Volume of sound (0-1).
      */
-    play(name: string, opt_volume?: number): void;
+    play(name: string, opt_volume?: number): Promise<void>;
     /**
      * @param muted If true, mute sounds. Otherwise, play them.
      */

package/core/workspace_dragger.d.ts

@@ -22,12 +22,6 @@ export declare class WorkspaceDragger {
     protected startScrollXY_: Coordinate;
     /** @param workspace The workspace to drag. */
     constructor(workspace: WorkspaceSvg);
-    /**
-     * Sever all links from this object.
-     *
-     * @internal
-     */
-    dispose(): void;
     /**
      * Start dragging the workspace.
      *

package/core/workspace_svg.d.ts

@@ -975,7 +975,7 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
      *     valid gesture exists.
      * @internal
      */
-    getGesture(e: PointerEvent): Gesture | null;
+    getGesture(e?: PointerEvent): Gesture | null;
     /**
      * Clear the reference to the current gesture.
      *

package/dart_compressed.js

@@ -305,7 +305,7 @@ a[a.ASSIGNMENT=16]="ASSIGNMENT";a[a.NONE=99]="NONE"})(Order$$module$build$src$ge
 var DartGenerator$$module$build$src$generators$dart$dart_generator=class extends $.CodeGenerator$$module$build$src$core$generator{constructor(a="Dart"){super(a);this.isInitialized=!1;for(const b in Order$$module$build$src$generators$dart$dart_generator)a=Order$$module$build$src$generators$dart$dart_generator[b],typeof a!=="string"&&(this["ORDER_"+b]=a);this.addReservedWords("assert,break,case,catch,class,const,continue,default,do,else,enum,extends,false,final,finally,for,if,in,is,new,null,rethrow,return,super,switch,this,throw,true,try,var,void,while,with,print,identityHashCode,identical,BidirectionalIterator,Comparable,double,Function,int,Invocation,Iterable,Iterator,List,Map,Match,num,Pattern,RegExp,Set,StackTrace,String,StringSink,Type,bool,DateTime,Deprecated,Duration,Expando,Null,Object,RuneIterator,Runes,Stopwatch,StringBuffer,Symbol,Uri,Comparator,AbstractClassInstantiationError,ArgumentError,AssertionError,CastError,ConcurrentModificationError,CyclicInitializationError,Error,Exception,FallThroughError,FormatException,IntegerDivisionByZeroException,NoSuchMethodError,NullThrownError,OutOfMemoryError,RangeError,StackOverflowError,StateError,TypeError,UnimplementedError,UnsupportedError")}init(a){super.init(a);
 this.nameDB_?this.nameDB_.reset():this.nameDB_=new $.Names$$module$build$src$core$names(this.RESERVED_WORDS_);this.nameDB_.setVariableMap(a.getVariableMap());this.nameDB_.populateVariables(a);this.nameDB_.populateProcedures(a);const b=[];var c=$.allDeveloperVariables$$module$build$src$core$variables(a);for(let d=0;d<c.length;d++)b.push(this.nameDB_.getName(c[d],$.NameType$$module$build$src$core$names.DEVELOPER_VARIABLE));a=$.allUsedVarModels$$module$build$src$core$variables(a);for(c=0;c<a.length;c++)b.push(this.nameDB_.getName(a[c].getId(),
 $.NameType$$module$build$src$core$names.VARIABLE));b.length&&(this.definitions_.variables="var "+b.join(", ")+";");this.isInitialized=!0}finish(a){a&&(a=this.prefixLines(a,this.INDENT));a="main() {\n"+a+"}";const b=[],c=[];for(let d in this.definitions_){const e=this.definitions_[d];e.match(/^import\s/)?b.push(e):c.push(e)}a=super.finish(a);this.isInitialized=!1;this.nameDB_.reset();return(b.join("\n")+"\n\n"+c.join("\n\n")).replace(/\n\n+/g,"\n\n").replace(/\n*$/,"\n\n\n")+a}scrubNakedValue(a){return a+
-";\n"}quote_(a){a=a.replace(/\\/g,"\\\\").replace(/\n/g,"\\\n").replace(/\$/g,"\\$").replace(/'/g,"\\'");return"'"+a+"'"}multiline_quote_(a){return a.split(/\n/g).map(this.quote_).join(" + '\\n' + \n")}scrub_(a,b,c=!1){let d="";if(!a.outputConnection||!a.outputConnection.targetConnection){var e=a.getCommentText();e&&(e=$.wrap$$module$build$src$core$utils$string(e,this.COMMENT_WRAP-3),d=a.getProcedureDef?d+this.prefixLines(e+"\n","/// "):d+this.prefixLines(e+"\n","// "));for(let f=0;f<a.inputList.length;f++)a.inputList[f].type===
+";\n"}quote_(a){a=a.replace(/\\/g,"\\\\").replace(/\n/g,"\\\n").replace(/\$/g,"\\$").replace(/'/g,"\\'");return"'"+a+"'"}multiline_quote_(a){return a.split(/\n/g).map(this.quote_).join(" + '\\n' + \n")}scrub_(a,b,c=!1){let d="";if(!a.outputConnection||!a.outputConnection.targetConnection){var e=a.getCommentText();e&&(e=$.wrap$$module$build$src$core$utils$string(e,this.COMMENT_WRAP-3),d="getProcedureDef"in a?d+this.prefixLines(e+"\n","/// "):d+this.prefixLines(e+"\n","// "));for(let f=0;f<a.inputList.length;f++)a.inputList[f].type===
 $.inputTypes$$module$build$src$core$inputs$input_types.VALUE&&(e=a.inputList[f].connection.targetBlock())&&(e=this.allNestedComments(e))&&(d+=this.prefixLines(e,"// "))}a=a.nextConnection&&a.nextConnection.targetBlock();c=c?"":this.blockToCode(a);return d+b+c}getAdjusted(a,b,c=0,d=!1,e=Order$$module$build$src$generators$dart$dart_generator.NONE){a.workspace.options.oneBasedIndex&&c--;const f=a.workspace.options.oneBasedIndex?"1":"0";let g=e;c?g=Order$$module$build$src$generators$dart$dart_generator.ADDITIVE:
 d&&(g=Order$$module$build$src$generators$dart$dart_generator.UNARY_PREFIX);a=this.valueToCode(a,b,g)||f;if(c===0&&!d)return a;if($.isNumber$$module$build$src$core$utils$string(a))return a=String(Number(a)+c),d&&(a=String(-Number(a))),a;c>0?a=`${a} + ${c}`:c<0&&(a=`${a} - ${-c}`);d&&(a=c?`-(${a})`:`-${a}`);Math.floor(e)>=Math.floor(g)&&(a=`(${a})`);return a}},module$build$src$generators$dart$dart_generator={};module$build$src$generators$dart$dart_generator.DartGenerator=DartGenerator$$module$build$src$generators$dart$dart_generator;
 module$build$src$generators$dart$dart_generator.Order=Order$$module$build$src$generators$dart$dart_generator;var module$build$src$generators$dart$lists={};module$build$src$generators$dart$lists.lists_create_empty=lists_create_empty$$module$build$src$generators$dart$lists;module$build$src$generators$dart$lists.lists_create_with=lists_create_with$$module$build$src$generators$dart$lists;module$build$src$generators$dart$lists.lists_getIndex=lists_getIndex$$module$build$src$generators$dart$lists;module$build$src$generators$dart$lists.lists_getSublist=lists_getSublist$$module$build$src$generators$dart$lists;