blockly 11.0.0-beta.6 → 11.0.0-beta.8

package/core/interfaces/i_selectable.d.ts

@@ -3,16 +3,18 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { IDeletable } from './i_deletable.js';
-import type { IMovable } from './i_movable.js';
+import type { Workspace } from '../workspace.js';
 /**
  * The interface for an object that is selectable.
  */
-export interface ISelectable extends IDeletable, IMovable {
+export interface ISelectable {
     id: string;
+    workspace: Workspace;
     /** Select this.  Highlight it visually. */
     select(): void;
     /** Unselect this.  Unhighlight it visually. */
     unselect(): void;
 }
+/** Checks whether the given object is an ISelectable. */
+export declare function isSelectable(obj: Object): obj is ISelectable;
 //# sourceMappingURL=i_selectable.d.ts.map

package/core/internal_constants.d.ts

@@ -9,13 +9,6 @@
  * @internal
  */
 export declare const COLLAPSE_CHARS = 30;
-/**
- * When dragging a block out of a stack, split the stack in two (true), or drag
- * out the block healing the stack (false).
- *
- * @internal
- */
-export declare const DRAG_STACK = true;
 /**
  * Lookup table for determining the opposite type of a connection.
  *

package/core/keyboard_nav/ast_node.d.ts

@@ -16,6 +16,7 @@ import type { Input } from '../inputs/input.js';
 import type { IASTNodeLocation } from '../interfaces/i_ast_node_location.js';
 import { Coordinate } from '../utils/coordinate.js';
 import type { Workspace } from '../workspace.js';
+import { FlyoutButton } from '../flyout_button.js';
 /**
  * Class for an AST node.
  * It is recommended that you use one of the createNode methods instead of
@@ -119,6 +120,13 @@ export declare class ASTNode {
      *     on the workspace.
      */
     private navigateBetweenStacks;
+    /**
+     * Navigate between buttons and stacks of blocks on the flyout workspace.
+     *
+     * @param forward True to go forward. False to go backwards.
+     * @returns The next button, or next stack's first block, or null
+     */
+    private navigateFlyoutContents;
     /**
      * Finds the top most AST node for a given block.
      * This is either the previous connection, output connection or block
@@ -150,7 +158,7 @@ export declare class ASTNode {
      * Finds the source block of the location of this node.
      *
      * @returns The source block of the location, or null if the node is of type
-     *     workspace.
+     *     workspace or button.
      */
     getSourceBlock(): Block | null;
     /**
@@ -232,6 +240,16 @@ export declare class ASTNode {
      *     stack.
      */
     static createStackNode(topBlock: Block): ASTNode | null;
+    /**
+     * Create an AST node of type button. A button in this case refers
+     * specifically to a button in a flyout.
+     *
+     * @param button A top block has no parent and can be found in the list
+     *     returned by workspace.getTopBlocks().
+     * @returns An AST node of type stack that points to the top block on the
+     *     stack.
+     */
+    static createButtonNode(button: FlyoutButton): ASTNode | null;
     /**
      * Creates an AST node pointing to a workspace.
      *
@@ -262,7 +280,8 @@ export declare namespace ASTNode {
         NEXT = "next",
         PREVIOUS = "previous",
         STACK = "stack",
-        WORKSPACE = "workspace"
+        WORKSPACE = "workspace",
+        BUTTON = "button"
     }
 }
 export type Params = ASTNode.Params;

package/core/registry.d.ts

@@ -5,7 +5,6 @@
  */
 import type { Abstract } from './events/events_abstract.js';
 import type { Field } from './field.js';
-import type { IBlockDragger } from './interfaces/i_block_dragger.js';
 import type { IConnectionChecker } from './interfaces/i_connection_checker.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
 import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
@@ -21,6 +20,7 @@ import type { ToolboxItem } from './toolbox/toolbox_item.js';
 import type { IPaster } from './interfaces/i_paster.js';
 import type { ICopyable } from './interfaces/i_copyable.js';
 import type { IConnectionPreviewer } from './interfaces/i_connection_previewer.js';
+import type { IDragger } from './interfaces/i_dragger.js';
 export declare const TEST_ONLY: {
     typeMap: {
         [key: string]: {
@@ -58,7 +58,11 @@ export declare class Type<_T> {
     static FLYOUTS_VERTICAL_TOOLBOX: Type<IFlyout>;
     static FLYOUTS_HORIZONTAL_TOOLBOX: Type<IFlyout>;
     static METRICS_MANAGER: Type<IMetricsManager>;
-    static BLOCK_DRAGGER: Type<IBlockDragger>;
+    /**
+     * Type for an IDragger. Formerly behavior was mostly covered by
+     * BlockDraggeers, which is why the name is inaccurate.
+     */
+    static BLOCK_DRAGGER: Type<IDragger>;
     /** @internal */
     static SERIALIZER: Type<ISerializer>;
     /** @internal */

package/core/renderers/common/marker_svg.d.ts

@@ -148,6 +148,13 @@ export declare class MarkerSvg {
      * @param curNode The node to draw the marker for.
      */
     protected showWithStack_(curNode: ASTNode): void;
+    /**
+     * Position and display the marker for a flyout button.
+     * This is a box with extra padding around the button.
+     *
+     * @param curNode The node to draw the marker for.
+     */
+    protected showWithButton_(curNode: ASTNode): void;
     /** Show the current marker. */
     protected showCurrent_(): void;
     /**************************

package/core/toolbox/toolbox.d.ts

@@ -187,11 +187,10 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
      * before onDragEnter/onDragOver/onDragExit.
      *
      * @param element The block or bubble currently being dragged.
-     * @param _couldConnect Whether the element could could connect to another.
      * @returns Whether the element provided would be deleted if dropped on this
      *     area.
      */
-    wouldDelete(element: IDraggable, _couldConnect: boolean): boolean;
+    wouldDelete(element: IDraggable): boolean;
     /**
      * Handles when a cursor with a block or bubble enters this drag target.
      *

package/core/workspace_comment_svg.d.ts

@@ -10,7 +10,6 @@
  */
 import './events/events_selected.js';
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
-import type { IBubble } from './interfaces/i_bubble.js';
 import type { ICopyable } from './interfaces/i_copyable.js';
 import { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';
@@ -20,7 +19,7 @@ import { WorkspaceCommentCopyData } from './clipboard/workspace_comment_paster.j
 /**
  * Class for a workspace comment's SVG representation.
  */
-export declare class WorkspaceCommentSvg extends WorkspaceComment implements IBoundedElement, IBubble, ICopyable<WorkspaceCommentCopyData> {
+export declare class WorkspaceCommentSvg extends WorkspaceComment implements IBoundedElement, ICopyable<WorkspaceCommentCopyData> {
     /**
      * The width and height to use to size a workspace comment when it is first
      * added, before it has been edited by the user.

package/core/workspace_svg.d.ts

@@ -497,8 +497,6 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
     updateScreenCalculationsIfScrolled(): void;
     /**
      * @returns The layer manager for this workspace.
-     *
-     * @internal
      */
     getLayerManager(): LayerManager | null;
     /**

package/core/xml.d.ts

@@ -7,6 +7,7 @@ import type { Block } from './block.js';
 import type { VariableModel } from './variable_model.js';
 import type { Workspace } from './workspace.js';
 import { WorkspaceSvg } from './workspace_svg.js';
+import { WorkspaceComment } from './comments/workspace_comment.js';
 /**
  * Encode a block tree as XML.
  *
@@ -16,6 +17,8 @@ import { WorkspaceSvg } from './workspace_svg.js';
  * @returns XML DOM element.
  */
 export declare function workspaceToDom(workspace: Workspace, skipId?: boolean): Element;
+/** Serializes the given workspace comment to XML. */
+export declare function saveWorkspaceComment(comment: WorkspaceComment, skipId?: boolean): Element;
 /**
  * Encode a list of variables as XML.
  *
@@ -74,6 +77,8 @@ export declare function clearWorkspaceAndLoadFromXml(xml: Element, workspace: Wo
  * @returns An array containing new block IDs.
  */
 export declare function domToWorkspace(xml: Element, workspace: Workspace): string[];
+/** Deserializes the given comment state into the given workspace. */
+export declare function loadWorkspaceComment(elem: Element, workspace: Workspace): WorkspaceComment;
 /**
  * Decode an XML DOM and create blocks on the workspace. Position the new
  * blocks immediately below prior blocks, aligned by their starting edge.

package/dart_compressed.js

@@ -226,19 +226,19 @@ int ${b.FUNCTION_NAME_PLACEHOLDER_}(num a, num b) {
 }
 `)+"("+c+", "+a+")",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},math_random_float$$module$build$src$generators$dart$math=function(a,b){b.definitions_.import_dart_math="import 'dart:math' as Math;";return["new Math.Random().nextDouble()",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},math_atan2$$module$build$src$generators$dart$math=function(a,b){b.definitions_.import_dart_math="import 'dart:math' as Math;";const c=b.valueToCode(a,"X",Order$$module$build$src$generators$dart$dart_generator.NONE)||
 "0";return["Math.atan2("+(b.valueToCode(a,"Y",Order$$module$build$src$generators$dart$dart_generator.NONE)||"0")+", "+c+") / Math.pi * 180",Order$$module$build$src$generators$dart$dart_generator.MULTIPLICATIVE]},procedures_defreturn$$module$build$src$generators$dart$procedures=function(a,b){const c=b.getProcedureName(a.getFieldValue("NAME"));var d="";b.STATEMENT_PREFIX&&(d+=b.injectId(b.STATEMENT_PREFIX,a));b.STATEMENT_SUFFIX&&(d+=b.injectId(b.STATEMENT_SUFFIX,a));d&&(d=b.prefixLines(d,b.INDENT));
-let e="";b.INFINITE_LOOP_TRAP&&(e=b.prefixLines(b.injectId(b.INFINITE_LOOP_TRAP,a),b.INDENT));const f=b.statementToCode(a,"STACK");let g=b.valueToCode(a,"RETURN",Order$$module$build$src$generators$dart$dart_generator.NONE)||"",h="";f&&g&&(h=d);g&&(g=b.INDENT+"return "+g+";\n");const k=g?"dynamic":"void",l=[],m=a.getVars();for(let n=0;n<m.length;n++)l[n]=b.getVariableName(m[n]);d=k+" "+c+"("+l.join(", ")+") {\n"+d+e+f+h+g+"}";d=b.scrub_(a,d);b.definitions_["%"+c]=d;return null},procedures_callreturn$$module$build$src$generators$dart$procedures=
-function(a,b){const c=b.getProcedureName(a.getFieldValue("NAME")),d=[],e=a.getVars();for(let f=0;f<e.length;f++)d[f]=b.valueToCode(a,"ARG"+f,Order$$module$build$src$generators$dart$dart_generator.NONE)||"null";return[c+"("+d.join(", ")+")",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},procedures_callnoreturn$$module$build$src$generators$dart$procedures=function(a,b){return b.forBlock.procedures_callreturn(a,b)[0]+";\n"},procedures_ifreturn$$module$build$src$generators$dart$procedures=
-function(a,b){let c="if ("+(b.valueToCode(a,"CONDITION",Order$$module$build$src$generators$dart$dart_generator.NONE)||"false")+") {\n";b.STATEMENT_SUFFIX&&(c+=b.prefixLines(b.injectId(b.STATEMENT_SUFFIX,a),b.INDENT));a.hasReturnValue_?(a=b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.NONE)||"null",c+=b.INDENT+"return "+a+";\n"):c+=b.INDENT+"return;\n";return c+"}\n"},text$$module$build$src$generators$dart$text=function(a,b){return[b.quote_(a.getFieldValue("TEXT")),
-Order$$module$build$src$generators$dart$dart_generator.ATOMIC]},text_join$$module$build$src$generators$dart$text=function(a,b){switch(a.itemCount_){case 0:return["''",Order$$module$build$src$generators$dart$dart_generator.ATOMIC];case 1:return[(b.valueToCode(a,"ADD0",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+".toString()",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX];default:const c=Array(a.itemCount_);for(let d=0;d<a.itemCount_;d++)c[d]=
-b.valueToCode(a,"ADD"+d,Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";return["["+c.join(",")+"].join()",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]}},text_append$$module$build$src$generators$dart$text=function(a,b){const c=b.getVariableName(a.getFieldValue("VAR"));a=b.valueToCode(a,"TEXT",Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";return c+" = ["+c+", "+a+"].join();\n"},text_length$$module$build$src$generators$dart$text=function(a,
-b){return[(b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+".length",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},text_isEmpty$$module$build$src$generators$dart$text=function(a,b){return[(b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+".isEmpty",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},text_indexOf$$module$build$src$generators$dart$text=
+let e="";b.INFINITE_LOOP_TRAP&&(e=b.prefixLines(b.injectId(b.INFINITE_LOOP_TRAP,a),b.INDENT));let f="";a.getInput("STACK")&&(f=b.statementToCode(a,"STACK"));let g="";a.getInput("RETURN")&&(g=b.valueToCode(a,"RETURN",Order$$module$build$src$generators$dart$dart_generator.NONE)||"");let h="";f&&g&&(h=d);g&&(g=b.INDENT+"return "+g+";\n");const k=g?"dynamic":"void",l=[],m=a.getVars();for(let n=0;n<m.length;n++)l[n]=b.getVariableName(m[n]);d=k+" "+c+"("+l.join(", ")+") {\n"+d+e+f+h+g+"}";d=b.scrub_(a,
+d);b.definitions_["%"+c]=d;return null},procedures_callreturn$$module$build$src$generators$dart$procedures=function(a,b){const c=b.getProcedureName(a.getFieldValue("NAME")),d=[],e=a.getVars();for(let f=0;f<e.length;f++)d[f]=b.valueToCode(a,"ARG"+f,Order$$module$build$src$generators$dart$dart_generator.NONE)||"null";return[c+"("+d.join(", ")+")",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},procedures_callnoreturn$$module$build$src$generators$dart$procedures=function(a,b){return b.forBlock.procedures_callreturn(a,
+b)[0]+";\n"},procedures_ifreturn$$module$build$src$generators$dart$procedures=function(a,b){let c="if ("+(b.valueToCode(a,"CONDITION",Order$$module$build$src$generators$dart$dart_generator.NONE)||"false")+") {\n";b.STATEMENT_SUFFIX&&(c+=b.prefixLines(b.injectId(b.STATEMENT_SUFFIX,a),b.INDENT));a.hasReturnValue_?(a=b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.NONE)||"null",c+=b.INDENT+"return "+a+";\n"):c+=b.INDENT+"return;\n";return c+"}\n"},text$$module$build$src$generators$dart$text=
+function(a,b){return[b.quote_(a.getFieldValue("TEXT")),Order$$module$build$src$generators$dart$dart_generator.ATOMIC]},text_join$$module$build$src$generators$dart$text=function(a,b){switch(a.itemCount_){case 0:return["''",Order$$module$build$src$generators$dart$dart_generator.ATOMIC];case 1:return[(b.valueToCode(a,"ADD0",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+".toString()",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX];default:const c=Array(a.itemCount_);
+for(let d=0;d<a.itemCount_;d++)c[d]=b.valueToCode(a,"ADD"+d,Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";return["["+c.join(",")+"].join()",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]}},text_append$$module$build$src$generators$dart$text=function(a,b){const c=b.getVariableName(a.getFieldValue("VAR"));a=b.valueToCode(a,"TEXT",Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";return c+" = ["+c+", "+a+"].join();\n"},text_length$$module$build$src$generators$dart$text=
+function(a,b){return[(b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+".length",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},text_isEmpty$$module$build$src$generators$dart$text=function(a,b){return[(b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+".isEmpty",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},text_indexOf$$module$build$src$generators$dart$text=
 function(a,b){const c="FIRST"===a.getFieldValue("END")?"indexOf":"lastIndexOf",d=b.valueToCode(a,"FIND",Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";b=(b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+"."+c+"("+d+")";return a.workspace.options.oneBasedIndex?[b+" + 1",Order$$module$build$src$generators$dart$dart_generator.ADDITIVE]:[b,Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},text_charAt$$module$build$src$generators$dart$text=
 function(a,b){const c=a.getFieldValue("WHERE")||"FROM_START",d=b.valueToCode(a,"VALUE","FIRST"===c||"FROM_START"===c?Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX:Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";switch(c){case "FIRST":return[d+"[0]",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX];case "FROM_START":return a=b.getAdjusted(a,"AT"),[d+"["+a+"]",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX];case "LAST":case "FROM_END":return a=
-b.getAdjusted(a,"AT",1),[b.provideFunction_("text_get_from_end",`
+"LAST"===c?1:b.getAdjusted(a,"AT",1),[`${b.provideFunction_("text_get_from_end",`
 String ${b.FUNCTION_NAME_PLACEHOLDER_}(String text, num x) {
   return text[text.length - x];
 }
-`)+"("+d+", "+a+")",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX];case "RANDOM":return b.definitions_.import_dart_math="import 'dart:math' as Math;",[b.provideFunction_("text_random_letter",`
+`)}(${d}, ${a})`,Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX];case "RANDOM":return b.definitions_.import_dart_math="import 'dart:math' as Math;",[b.provideFunction_("text_random_letter",`
 String ${b.FUNCTION_NAME_PLACEHOLDER_}(String text) {
   int x = new Math.Random().nextInt(text.length);
   return text[x];