blockly 7.20210930.0-beta.3 → 7.20211209.0-beta.2

package/blockly.d.ts

@@ -6,7 +6,6 @@
 
 /**
  * @fileoverview Type definitions for Blockly.
- * @author samelh@google.com (Sam El-Husseini)
  */
 
 export = Blockly;
@@ -124,21 +123,6 @@ declare module Block {
 }
 
 
-declare module exports {
-
-    /** @package */
-    var disposeUiEffect: any /*missing*/;
-
-    /** @package */
-    var connectionUiEffect: any /*missing*/;
-
-    /** @package */
-    var disconnectUiEffect: any /*missing*/;
-
-    /** @package */
-    var disconnectUiStop: any /*missing*/;
-}
-
 
 
 
@@ -176,6 +160,15 @@ declare module exports {
      */
     var VERSION: any /*missing*/;
 
+    /**
+     * Returns the dimensions of the specified SVG image.
+     * @param {!SVGElement} svg SVG image.
+     * @return {!Size} Contains width and height properties.
+     * @deprecated Use workspace.setCachedParentSvgSize. (2021 March 5)
+     * @alias Blockly.svgSize
+     */
+    function svgSize(svg: SVGElement): Size;
+
     /**
      * Copy a block or workspace comment onto the local clipboard.
      * @param {!ICopyable} toCopy Block or Workspace Comment to be copied.
@@ -210,6 +203,14 @@ declare module exports {
      */
     function getMainWorkspace(): Workspace;
 
+    /**
+     * Define blocks from an array of JSON block definitions, as might be generated
+     * by the Blockly Developer Tools.
+     * @param {!Array<!Object>} jsonArray An array of JSON block definitions.
+     * @alias Blockly.defineBlocksWithJsonArray
+     */
+    function defineBlocksWithJsonArray(jsonArray: Object[]): void;
+
     /**
      * Set the parent container.  This is the container element that the WidgetDiv,
      * DropDownDiv, and Tooltip are rendered into the first time `Blockly.inject`
@@ -229,31 +230,37 @@ declare module exports {
 
     /**
      * @see browserEvents.bind
+     * @alias Blockly.bindEvent_
      */
     var bindEvent_: any /*missing*/;
 
     /**
      * @see browserEvents.unbind
+     * @alias Blockly.unbindEvent_
      */
     var unbindEvent_: any /*missing*/;
 
     /**
      * @see browserEvents.conditionalBind
+     * @alias Blockly.bindEventWithChecks_
      */
     var bindEventWithChecks_: any /*missing*/;
 
     /**
-     * @see constants.ALIGN.LEFT
+     * @see Blockly.Input.Align.LEFT
+     * @alias Blockly.ALIGN_LEFT
      */
     var ALIGN_LEFT: any /*missing*/;
 
     /**
-     * @see constants.ALIGN.CENTRE
+     * @see Blockly.Input.Align.CENTRE
+     * @alias Blockly.ALIGN_CENTRE
      */
     var ALIGN_CENTRE: any /*missing*/;
 
     /**
-     * @see constants.ALIGN.RIGHT
+     * @see Blockly.Input.Align.RIGHT
+     * @alias Blockly.ALIGN_RIGHT
      */
     var ALIGN_RIGHT: any /*missing*/;
 
@@ -264,49 +271,85 @@ declare module exports {
 
     /**
      * @see ConnectionType.INPUT_VALUE
+     * @alias Blockly.INPUT_VALUE
      */
     var INPUT_VALUE: any /*missing*/;
 
     /**
      * @see ConnectionType.OUTPUT_VALUE
+     * @alias Blockly.OUTPUT_VALUE
      */
     var OUTPUT_VALUE: any /*missing*/;
 
     /**
      * @see ConnectionType.NEXT_STATEMENT
+     * @alias Blockly.NEXT_STATEMENT
      */
     var NEXT_STATEMENT: any /*missing*/;
 
     /**
      * @see ConnectionType.PREVIOUS_STATEMENT
+     * @alias Blockly.PREVIOUS_STATEMENT
      */
     var PREVIOUS_STATEMENT: any /*missing*/;
 
     /**
      * @see inputTypes.DUMMY_INPUT
+     * @alias Blockly.DUMMY_INPUT
      */
     var DUMMY_INPUT: any /*missing*/;
 
     /**
      * @see toolbox.Position.TOP
+     * @alias Blockly.TOOLBOX_AT_TOP
      */
     var TOOLBOX_AT_TOP: any /*missing*/;
 
     /**
      * @see toolbox.Position.BOTTOM
+     * @alias Blockly.TOOLBOX_AT_BOTTOM
      */
     var TOOLBOX_AT_BOTTOM: any /*missing*/;
 
     /**
      * @see toolbox.Position.LEFT
+     * @alias Blockly.TOOLBOX_AT_LEFT
      */
     var TOOLBOX_AT_LEFT: any /*missing*/;
 
     /**
      * @see toolbox.Position.RIGHT
+     * @alias Blockly.TOOLBOX_AT_RIGHT
      */
     var TOOLBOX_AT_RIGHT: any /*missing*/;
 
+    /**
+     * String for use in the "custom" attribute of a category in toolbox XML.
+     * This string indicates that the category should be dynamically populated with
+     * variable blocks.
+     * @const {string}
+     * @alias Blockly.VARIABLE_CATEGORY_NAME
+     */
+    var VARIABLE_CATEGORY_NAME: any /*missing*/;
+
+    /**
+     * String for use in the "custom" attribute of a category in toolbox XML.
+     * This string indicates that the category should be dynamically populated with
+     * variable blocks.
+     * @const {string}
+     * @alias Blockly.VARIABLE_DYNAMIC_CATEGORY_NAME
+     */
+    var VARIABLE_DYNAMIC_CATEGORY_NAME: any /*missing*/;
+
+    /**
+     * String for use in the "custom" attribute of a category in toolbox XML.
+     * This string indicates that the category should be dynamically populated with
+     * procedure blocks.
+     * @const {string}
+     * @alias Blockly.PROCEDURE_CATEGORY_NAME
+     */
+    var PROCEDURE_CATEGORY_NAME: any /*missing*/;
+
     /** @deprecated Use Blockly.ConnectionType instead. */
     var connectionTypes: any /*missing*/;
 }
@@ -366,18 +409,6 @@ declare module Bubble {
 
 
 
-declare module exports {
-
-    /** @package */
-    var copy: any /*missing*/;
-
-    /** @package */
-    var paste: any /*missing*/;
-
-    /** @package */
-    var duplicate: any /*missing*/;
-}
-
 
 
 declare module exports {
@@ -476,18 +507,6 @@ declare module ConnectionDB {
 
 
 
-declare module exports {
-
-    /** @package */
-    var commentDeleteOption: any /*missing*/;
-
-    /** @package */
-    var commentDuplicateOption: any /*missing*/;
-
-    /** @package */
-    var workspaceCommentOption: any /*missing*/;
-}
-
 
 
 declare module ContextMenuRegistry {
@@ -1052,12 +1071,6 @@ declare module FieldNumber {
 }
 
 
-declare module exports {
-
-    /** @package */
-    var fromJson: any /*missing*/;
-}
-
 
 declare module FieldTextInput {
 
@@ -1188,12 +1201,6 @@ declare module MarkerManager {
     var LOCAL_MARKER: string;
 }
 
-declare module  {
-
-    /** @package */
-    var exports: any /*missing*/;
-}
-
 
 
 
@@ -1386,36 +1393,6 @@ declare module Options {
 }
 
 
-declare module exports {
-
-    /** @package */
-    var verticalPosition: any /*missing*/;
-
-    /** @package */
-    var horizontalPosition: any /*missing*/;
-
-    /** @package */
-    var Position: any /*missing*/;
-
-    /** @package */
-    var bumpDirection: any /*missing*/;
-
-    /** @package */
-    var getStartPositionRect: any /*missing*/;
-
-    /** @package */
-    var getCornerOppositeToolbox: any /*missing*/;
-
-    /** @package */
-    var bumpPositionRect: any /*missing*/;
-}
-
-
-declare module exports {
-
-    /** @package */
-    var mutatorOpenListener: any /*missing*/;
-}
 
 
 declare module Type {
@@ -1503,12 +1480,6 @@ declare module Scrollbar {
 
 
 
-declare module exports {
-
-    /** @package */
-    var registerDefaultShortcuts: any /*missing*/;
-}
-
 
 declare module ShortcutRegistry {
 
@@ -1645,33 +1616,6 @@ declare module ThemeManager {
 }
 
 
-declare module exports {
-
-    /** @deprecated September 2021 */
-    var visible: any /*missing*/;
-
-    /** @deprecated September 2021 */
-    var DIV: any /*missing*/;
-
-    /** @package */
-    var dispose: any /*missing*/;
-
-    /** @package */
-    var block: any /*missing*/;
-
-    /** @package */
-    var unblock: any /*missing*/;
-}
-
-
-declare module exports {
-
-    /** @package */
-    var longStart: any /*missing*/;
-
-    /** @package */
-    var longStop: any /*missing*/;
-}
 
 
 declare module TouchGesture {
@@ -1691,18 +1635,6 @@ declare module TouchGesture {
 
 
 
-declare module exports {
-
-    /** @package */
-    var getViewportBBox: any /*missing*/;
-
-    /** @package */
-    var arrayRemove: any /*missing*/;
-
-    /** @package */
-    var screenToWsCoordinates: any /*missing*/;
-}
-
 
 
 declare module VariableModel {
@@ -1719,23 +1651,8 @@ declare module VariableModel {
 }
 
 
-declare module exports {
-
-    /** @package */
-    var getAddedVariables: any /*missing*/;
-}
-
-
-
-
-declare module exports {
 
-    /** @deprecated September 2021 */
-    var DIV: any /*missing*/;
 
-    /** @package */
-    var positionWithAnchor: any /*missing*/;
-}
 
 
 declare module Workspace {
@@ -1821,16 +1738,6 @@ declare module WorkspaceCommentSvg {
 
 
 
-declare module exports {
-
-    /**
-     * Sets whether the next event should be added to the undo stack.
-     * @type {boolean}
-     * @deprecated September 2021
-     */
-    var recordUndo: boolean;
-}
-
 
 
 
@@ -1881,14 +1788,74 @@ declare module CommentBase {
 
 
 
-declare module exports {
 
-    /** @package */
-    var getDescendantIds: any /*missing*/;
+
+
+
+
+
+
+
+
+
+declare module IComponent {
+
+    /**
+     * The unique id for this component that is used to register with the
+     * ComponentManager.
+     * @type {string}
+     */
+    var id: string;
+}
+
+
+
+
+declare module ICopyable {
+
+    /**
+     * Copy Metadata.
+     * @typedef {{
+     *            saveInfo:(!Object|!Element),
+     *            source:WorkspaceSvg,
+     *            typeCounts:?Object
+     *          }}
+     */
+    interface CopyData {
+        saveInfo: Object|Element;
+        source: WorkspaceSvg;
+        typeCounts: Object
+    }
+}
+
+
+
+
+
+
+
+
+
+
+
+
+declare module IRegistrableField {
+
+    /**
+     * @typedef {function(!Object): Field}
+     */
+    interface fromJson {
+        (_0: Object): Field
+    }
 }
 
 
 
+
+
+
+
+
 declare module ASTNode {
 
     /**
@@ -1989,78 +1956,6 @@ declare module BasicCursor {
 
 
 
-
-
-
-
-
-
-declare module IComponent {
-
-    /**
-     * The unique id for this component that is used to register with the
-     * ComponentManager.
-     * @type {string}
-     */
-    var id: string;
-}
-
-
-
-
-declare module ICopyable {
-
-    /**
-     * Copy Metadata.
-     * @typedef {{
-     *            saveInfo:(!Object|!Element),
-     *            source:WorkspaceSvg,
-     *            typeCounts:?Object
-     *          }}
-     */
-    interface CopyData {
-        saveInfo: Object|Element;
-        source: WorkspaceSvg;
-        typeCounts: Object
-    }
-}
-
-
-
-
-
-
-
-
-
-
-
-
-declare module IRegistrableField {
-
-    /**
-     * @typedef {function(!Object): Field}
-     */
-    interface fromJson {
-        (_0: Object): Field
-    }
-}
-
-
-
-
-
-
-
-
-declare module exports {
-
-    /** @package */
-    var appendInternal: any /*missing*/;
-}
-
-
-
 declare module exports {
 
     /**
@@ -2201,6 +2096,7 @@ declare module ToolboxSeparator {
 
 
 
+
 declare module Coordinate {
 
     /**
@@ -2247,12 +2143,6 @@ declare module Coordinate {
 }
 
 
-declare module exports {
-
-    /** @package */
-    var warn: any /*missing*/;
-}
-
 
 
 declare module exports {
@@ -2283,6 +2173,7 @@ declare module internal {
 
 
 
+
 declare module Size {
 
     /**
@@ -2441,90 +2332,90 @@ declare module Svg {
 
 
 
-declare module exports {
-
-    /** @package */
-    var convertToolboxDefToJson: any /*missing*/;
-
-    /** @package */
-    var convertFlyoutDefToJsonArray: any /*missing*/;
-
-    /** @package */
-    var hasCategories: any /*missing*/;
-
-    /** @package */
-    var isCategoryCollapsible: any /*missing*/;
-}
 
 
 declare module exports {
 
-    /** @const {string}
+    /**
+     * @const {string}
      * @alias Blockly.utils.userAgent.raw
      */
     var raw: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.IE
      */
     var IE: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.EDGE
      */
     var EDGE: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.JavaFx
      */
     var JavaFx: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.CHROME
      */
     var CHROME: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.WEBKIT
      */
     var WEBKIT: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.GECKO
      */
     var GECKO: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.ANDROID
      */
     var ANDROID: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.IPAD
      */
     var IPAD: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.IPOD
      */
     var IPOD: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.IPHONE
      */
     var IPHONE: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.MAC
      */
     var MAC: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.TABLET
      */
     var TABLET: any /*missing*/;
 
-    /** @const {boolean}
+    /**
+     * @const {boolean}
      * @alias Blockly.utils.userAgent.MOBILE
      */
     var MOBILE: any /*missing*/;
@@ -2532,34 +2423,7 @@ declare module exports {
 
 
 
-declare module exports {
 
-    /** @package */
-    var isDebuggerEnabled: any /*missing*/;
-
-    /** @package */
-    var startDebugger: any /*missing*/;
-
-    /** @package */
-    var stopDebugger: any /*missing*/;
-
-    /** @package */
-    var init: any /*missing*/;
-}
-
-
-
-declare module exports {
-
-    /** @package */
-    var isDebuggerEnabled: any /*missing*/;
-
-    /** @package */
-    var startDebugger: any /*missing*/;
-
-    /** @package */
-    var stopDebugger: any /*missing*/;
-}
 
 
 declare module Debug {
@@ -3140,45 +3004,6 @@ declare module Blockly.Msg {
     /** @type {string} */
     var CONTROLS_IF_ELSE_TOOLTIP: string;
 
-    /** @type {string} */
-    var IOS_OK: string;
-
-    /** @type {string} */
-    var IOS_CANCEL: string;
-
-    /** @type {string} */
-    var IOS_ERROR: string;
-
-    /** @type {string} */
-    var IOS_PROCEDURES_INPUTS: string;
-
-    /** @type {string} */
-    var IOS_PROCEDURES_ADD_INPUT: string;
-
-    /** @type {string} */
-    var IOS_PROCEDURES_ALLOW_STATEMENTS: string;
-
-    /** @type {string} */
-    var IOS_PROCEDURES_DUPLICATE_INPUTS_ERROR: string;
-
-    /** @type {string} */
-    var IOS_VARIABLES_ADD_VARIABLE: string;
-
-    /** @type {string} */
-    var IOS_VARIABLES_ADD_BUTTON: string;
-
-    /** @type {string} */
-    var IOS_VARIABLES_RENAME_BUTTON: string;
-
-    /** @type {string} */
-    var IOS_VARIABLES_DELETE_BUTTON: string;
-
-    /** @type {string} */
-    var IOS_VARIABLES_VARIABLE_NAME: string;
-
-    /** @type {string} */
-    var IOS_VARIABLES_EMPTY_NAME_ERROR: string;
-
     /** @type {string} */
     var LOGIC_COMPARE_HELPURL: string;