blockly 9.0.0-beta.1 → 9.0.0-beta.3

package/core/toolbox/category.d.ts

@@ -6,7 +6,7 @@
 import type { ICollapsibleToolboxItem } from '../interfaces/i_collapsible_toolbox_item.js';
 import type { ISelectableToolboxItem } from '../interfaces/i_selectable_toolbox_item.js';
 import type { IToolbox } from '../interfaces/i_toolbox.js';
-import * as toolbox from '../utils/toolbox.js';
+import type { CategoryInfo, FlyoutDefinition, FlyoutItemInfoArray } from '../utils/toolbox.js';
 import { ToolboxItem } from './toolbox_item.js';
 /**
  * Class for a category in a toolbox.
@@ -25,7 +25,7 @@ export declare class ToolboxCategory extends ToolboxItem implements ISelectableT
      * of the category when it is selected.
      */
     static defaultBackgroundColour: string;
-    toolboxItemDef_: toolbox.CategoryInfo;
+    toolboxItemDef_: CategoryInfo;
     /** The name that will be displayed on the category. */
     protected name_: string;
     /** The colour of the category. */
@@ -46,7 +46,7 @@ export declare class ToolboxCategory extends ToolboxItem implements ISelectableT
     /** True if this category is disabled, false otherwise. */
     protected isDisabled_: boolean;
     /** The flyout items for this category. */
-    protected flyoutItems_: string | toolbox.FlyoutItemInfoArray;
+    protected flyoutItems_: string | FlyoutItemInfoArray;
     /**
      * @param categoryDef The information needed to create a category in the
      *     toolbox.
@@ -54,7 +54,7 @@ export declare class ToolboxCategory extends ToolboxItem implements ISelectableT
      * @param opt_parent The parent category or null if the category does not have
      *     a parent.
      */
-    constructor(categoryDef: toolbox.CategoryInfo, parentToolbox: IToolbox, opt_parent?: ICollapsibleToolboxItem);
+    constructor(categoryDef: CategoryInfo, parentToolbox: IToolbox, opt_parent?: ICollapsibleToolboxItem);
     /**
      * Initializes the toolbox item.
      * This includes creating the DOM and updating the state of any items based
@@ -76,13 +76,13 @@ export declare class ToolboxCategory extends ToolboxItem implements ISelectableT
      *
      * @param categoryDef The information needed to create a category.
      */
-    protected parseContents_(categoryDef: toolbox.CategoryInfo): void;
+    protected parseContents_(categoryDef: CategoryInfo): void;
     /**
      * Parses the non-contents parts of the category def.
      *
      * @param categoryDef The information needed to create a category.
      */
-    protected parseCategoryDef_(categoryDef: toolbox.CategoryInfo): void;
+    protected parseCategoryDef_(categoryDef: CategoryInfo): void;
     /**
      * Creates the DOM for the category.
      *
@@ -137,7 +137,7 @@ export declare class ToolboxCategory extends ToolboxItem implements ISelectableT
      * @param categoryDef The object holding information on the category.
      * @returns The hex colour for the category.
      */
-    protected getColour_(categoryDef: toolbox.CategoryInfo): string;
+    protected getColour_(categoryDef: CategoryInfo): string;
     /**
      * Sets the colour for the category using the style name and returns the new
      * colour as a hex string.
@@ -237,7 +237,7 @@ export declare class ToolboxCategory extends ToolboxItem implements ISelectableT
      *
      * @returns The definition of items to be displayed in the flyout.
      */
-    getContents(): toolbox.FlyoutItemInfoArray | string;
+    getContents(): FlyoutItemInfoArray | string;
     /**
      * Updates the contents to be displayed in the flyout.
      * If the flyout is open when the contents are updated, refreshSelection on
@@ -246,20 +246,21 @@ export declare class ToolboxCategory extends ToolboxItem implements ISelectableT
      * @param contents The contents to be displayed in the flyout. A string can be
      *     supplied to create a dynamic category.
      */
-    updateFlyoutContents(contents: toolbox.FlyoutDefinition | string): void;
+    updateFlyoutContents(contents: FlyoutDefinition | string): void;
     dispose(): void;
 }
 export declare namespace ToolboxCategory {
     /** All the CSS class names that are used to create a category. */
     interface CssConfig {
-        container: string | undefined;
-        row: string | undefined;
-        rowcontentcontainer: string | undefined;
-        icon: string | undefined;
-        label: string | undefined;
-        selected: string | undefined;
-        openicon: string | undefined;
-        closedicon: string | undefined;
+        container?: string;
+        row?: string;
+        rowcontentcontainer?: string;
+        icon?: string;
+        label?: string;
+        contents?: string;
+        selected?: string;
+        openicon?: string;
+        closedicon?: string;
     }
 }
 export declare type CssConfig = ToolboxCategory.CssConfig;

package/core/toolbox/toolbox.d.ts

@@ -26,7 +26,7 @@ import type { WorkspaceSvg } from '../workspace_svg.js';
  */
 export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeyboardAccessible, IStyleable, IToolbox {
     /**
-     * The unique id for this component that is used to register with the
+     * The unique ID for this component that is used to register with the
      * ComponentManager.
      */
     id: string;

package/core/touch_gesture.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2017 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import * as browserEvents from './browser_events.js';
 import { Gesture } from './gesture.js';
 import { Coordinate } from './utils/coordinate.js';
 /**
@@ -32,8 +33,8 @@ export declare class TouchGesture extends Gesture {
     private onStartWrapper_;
     /** Boolean for whether or not the workspace supports pinch-zoom. */
     private isPinchZoomEnabled_;
-    onMoveWrapper_: any;
-    onUpWrapper_: any;
+    onMoveWrapper_: browserEvents.Data | null;
+    onUpWrapper_: browserEvents.Data | null;
     /**
      * Start a gesture: update the workspace to indicate that a gesture is in
      * progress and bind mousemove and mouseup handlers.

package/core/utils/coordinate.d.ts

@@ -45,7 +45,7 @@ export declare class Coordinate {
      * @param b A Coordinate.
      * @returns True iff the coordinates are equal, or if both are null.
      */
-    static equals(a: Coordinate | null, b: Coordinate | null): boolean;
+    static equals(a?: Coordinate | null, b?: Coordinate | null): boolean;
     /**
      * Returns the distance between two coordinates.
      *

package/core/utils/dom.d.ts

@@ -43,10 +43,13 @@ export declare enum NodeType {
  * @returns if name is a string or a more specific type if it a member of Svg.
  * @alias Blockly.utils.dom.createSvgElement
  */
-export declare function createSvgElement<T extends SVGElement>(name: string | Svg<T>, attrs: any, opt_parent?: Element | null): T;
+export declare function createSvgElement<T extends SVGElement>(name: string | Svg<T>, attrs: {
+    [key: string]: string | number;
+}, opt_parent?: Element | null): T;
 /**
  * Add a CSS class to a element.
- * Similar to Closure's goog.dom.classes.add, except it handles SVG elements.
+ *
+ * Handles multiple space-separated classes for legacy reasons.
  *
  * @param element DOM element to add class to.
  * @param className Name of class to add.
@@ -55,7 +58,7 @@ export declare function createSvgElement<T extends SVGElement>(name: string | Sv
  */
 export declare function addClass(element: Element, className: string): boolean;
 /**
- * Removes multiple calsses from an element.
+ * Removes multiple classes from an element.
  *
  * @param element DOM element to remove classes from.
  * @param classNames A string of one or multiple class names for an element.
@@ -64,7 +67,8 @@ export declare function addClass(element: Element, className: string): boolean;
 export declare function removeClasses(element: Element, classNames: string): void;
 /**
  * Remove a CSS class from a element.
- * Similar to Closure's goog.dom.classes.remove, except it handles SVG elements.
+ *
+ * Handles multiple space-separated classes for legacy reasons.
  *
  * @param element DOM element to remove class from.
  * @param className Name of class to remove.
@@ -74,7 +78,6 @@ export declare function removeClasses(element: Element, classNames: string): voi
 export declare function removeClass(element: Element, className: string): boolean;
 /**
  * Checks if an element has the specified CSS class.
- * Similar to Closure's goog.dom.classes.has, except it handles SVG elements.
  *
  * @param element DOM element to check.
  * @param className Name of class to check.
@@ -117,7 +120,7 @@ export declare function containsNode(parent: Node, descendant: Node): boolean;
  * @param transform The value of the CSS `transform` property.
  * @alias Blockly.utils.dom.setCssTransform
  */
-export declare function setCssTransform(element: Element, transform: string): void;
+export declare function setCssTransform(element: HTMLElement | SVGElement, transform: string): void;
 /**
  * Start caching text widths. Every call to this function MUST also call
  * stopTextWidthCache. Caches must not survive between execution threads.
@@ -152,7 +155,7 @@ export declare function getTextWidth(textElement: SVGTextElement): number;
  * @returns Width of element.
  * @alias Blockly.utils.dom.getFastTextWidth
  */
-export declare function getFastTextWidth(textElement: Element, fontSize: number, fontWeight: string, fontFamily: string): number;
+export declare function getFastTextWidth(textElement: SVGTextElement, fontSize: number, fontWeight: string, fontFamily: string): number;
 /**
  * Gets the width of a text element using a faster method than `getTextWidth`.
  * This method requires that we know the text element's font family and size in
@@ -167,7 +170,7 @@ export declare function getFastTextWidth(textElement: Element, fontSize: number,
  * @returns Width of element.
  * @alias Blockly.utils.dom.getFastTextWidthWithSizeString
  */
-export declare function getFastTextWidthWithSizeString(textElement: Element, fontSize: string, fontWeight: string, fontFamily: string): number;
+export declare function getFastTextWidthWithSizeString(textElement: SVGTextElement, fontSize: string, fontWeight: string, fontFamily: string): number;
 /**
  * Measure a font's metrics. The height and baseline values.
  *

package/core/utils/idgenerator.d.ts

@@ -14,7 +14,7 @@ export declare const TEST_ONLY: {
 };
 /**
  * Generate the next unique element IDs.
- * IDs are compatible with the HTML4 id attribute restrictions:
+ * IDs are compatible with the HTML4 'id' attribute restrictions:
  * Use only ASCII letters, digits, '_', '-' and '.'
  *
  * For UUIDs use genUid (below) instead; this ID generator should

package/core/zoom_controls.d.ts

@@ -16,7 +16,7 @@ import type { WorkspaceSvg } from './workspace_svg.js';
 export declare class ZoomControls implements IPositionable {
     private readonly workspace;
     /**
-     * The unique id for this component that is used to register with the
+     * The unique ID for this component that is used to register with the
      * ComponentManager.
      */
     id: string;

package/core-browser.js

@@ -22,12 +22,6 @@
 /* eslint-disable */
 'use strict';
 
-// Add a helper method to set the Blockly locale.
-Blockly.setLocale = function (locale) {
-  Object.keys(locale).forEach(function (k) {
-    Blockly.Msg[k] = locale[k];
-  });
-};
 
 return Blockly;
 })); 

package/core.js

@@ -14,12 +14,6 @@
 /* eslint-disable */
 'use strict';
 
-// Add a helper method to set the Blockly locale.
-Blockly.setLocale = function (locale) {
-  Object.keys(locale).forEach(function (k) {
-    Blockly.Msg[k] = locale[k];
-  });
-};
 
 // Override textToDomDocument and provide Node.js alternatives to DOMParser and
 // XMLSerializer.

package/dart.d.ts

@@ -4,5 +4,4 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-declare const dart: any;
-export = dart;
+export declare const dartGenerator: any;

package/javascript.d.ts

@@ -4,5 +4,4 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-declare const javascript: any;
-export = javascript;
+export declare const javascriptGenerator: any;

package/lua.d.ts

@@ -4,5 +4,4 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-declare const lua: any;
-export = lua;
+export declare const luaGenerator: any;

package/msg/ab.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/ace.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/af.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/am.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/ar.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/ast.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/az.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/ba.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/bcc.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/be-tarask.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/be.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/bg.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/bn.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/br.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/bs.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/ca.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/cdo.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/constants.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2020 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview Type definitions for the Blockly constants locale.
+ * @author samelh@google.com (Sam El-Husseini)
+ */
+
+/// <reference path="msg.d.ts" />
+
+import BlocklyMsg = Blockly.Msg;
+export = BlocklyMsg;
+

package/msg/cs.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/da.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/de.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/diq.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/dty.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/ee.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/el.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/en-gb.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/en.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/eo.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/es.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/et.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/eu.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/fa.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/fi.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/fo.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/fr.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/frr.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+

package/msg/gl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './msg';
+