blockly 9.3.0-beta.0 → 9.3.0

package/core/serialization/exceptions.d.ts

@@ -5,14 +5,12 @@
  */
 import type { Block } from '../block.js';
 import type { State } from './blocks.js';
-/** @alias Blockly.serialization.exceptions.DeserializationError */
 export declare class DeserializationError extends Error {
 }
 /**
  * Represents an error where the serialized state is expected to provide a
  * block type, but it is not provided.
  *
- * @alias Blockly.serialization.exceptions.MissingBlockType
  */
 export declare class MissingBlockType extends DeserializationError {
     state: State;
@@ -25,8 +23,6 @@ export declare class MissingBlockType extends DeserializationError {
 /**
  * Represents an error where deserialization encountered a block that did
  * not have a connection that was defined in the serialized state.
- *
- * @alias Blockly.serialization.exceptions.MissingConnection
  */
 export declare class MissingConnection extends DeserializationError {
     block: Block;
@@ -43,8 +39,6 @@ export declare class MissingConnection extends DeserializationError {
 /**
  * Represents an error where deserialization tried to connect two connections
  * that were not compatible.
- *
- * @alias Blockly.serialization.exceptions.BadConnectionCheck
  */
 export declare class BadConnectionCheck extends DeserializationError {
     childBlock: Block;
@@ -64,8 +58,6 @@ export declare class BadConnectionCheck extends DeserializationError {
  * was deserializing children of a shadow.
  * This is an error because it is an invariant of Blockly that shadow blocks
  * do not have real children.
- *
- * @alias Blockly.serialization.exceptions.RealChildOfShadow
  */
 export declare class RealChildOfShadow extends DeserializationError {
     state: State;

package/core/serialization/priorities.d.ts

@@ -5,8 +5,6 @@
  */
 /**
  * The priority for deserializing variables.
- *
- * @alias Blockly.serialization.priorities.VARIABLES
  */
 export declare const VARIABLES = 100;
 /**
@@ -15,8 +13,6 @@ export declare const VARIABLES = 100;
 export declare const PROCEDURES = 75;
 /**
  * The priority for deserializing blocks.
- *
- * @alias Blockly.serialization.priorities.BLOCKS
  */
 export declare const BLOCKS = 50;
 //# sourceMappingURL=priorities.d.ts.map

package/core/serialization/registry.d.ts

@@ -10,14 +10,12 @@ import type { ISerializer } from '../interfaces/i_serializer.js';
  *
  * @param name The name of the serializer to register.
  * @param serializer The serializer to register.
- * @alias Blockly.serialization.registry.register
  */
 export declare function register(name: string, serializer: ISerializer): void;
 /**
  * Unregisters the serializer associated with the given name.
  *
  * @param name The name of the serializer to unregister.
- * @alias Blockly.serialization.registry.unregister
  */
 export declare function unregister(name: string): void;
 //# sourceMappingURL=registry.d.ts.map

package/core/serialization/variables.d.ts

@@ -7,8 +7,6 @@ import type { ISerializer } from '../interfaces/i_serializer.js';
 import type { Workspace } from '../workspace.js';
 /**
  * Represents the state of a given variable.
- *
- * @alias Blockly.serialization.variables.State
  */
 export interface State {
     name: string;
@@ -17,8 +15,6 @@ export interface State {
 }
 /**
  * Serializer for saving and loading variable state.
- *
- * @alias Blockly.serialization.variables.VariableSerializer
  */
 export declare class VariableSerializer implements ISerializer {
     priority: number;

package/core/serialization/workspaces.d.ts

@@ -9,7 +9,6 @@ import type { Workspace } from '../workspace.js';
  *
  * @param workspace The workspace to serialize.
  * @returns The serialized state of the workspace.
- * @alias Blockly.serialization.workspaces.save
  */
 export declare function save(workspace: Workspace): {
     [key: string]: any;
@@ -21,7 +20,6 @@ export declare function save(workspace: Workspace): {
  * @param workspace The workspace to add the new state to.
  * @param param1 recordUndo: If true, events triggered by this function will be
  *     undo-able by the user. False by default.
- * @alias Blockly.serialization.workspaces.load
  */
 export declare function load(state: {
     [key: string]: any;

package/core/shortcut_items.d.ts

@@ -5,8 +5,6 @@
  */
 /**
  * Object holding the names of the default shortcut items.
- *
- * @alias Blockly.ShortcutItems.names
  */
 export declare enum names {
     ESCAPE = "escape",
@@ -19,52 +17,37 @@ export declare enum names {
 }
 /**
  * Keyboard shortcut to hide chaff on escape.
- *
- * @alias Blockly.ShortcutItems.registerEscape
  */
 export declare function registerEscape(): void;
 /**
  * Keyboard shortcut to delete a block on delete or backspace
- *
- * @alias Blockly.ShortcutItems.registerDelete
  */
 export declare function registerDelete(): void;
 /**
  * Keyboard shortcut to copy a block on ctrl+c, cmd+c, or alt+c.
- *
- * @alias Blockly.ShortcutItems.registerCopy
  */
 export declare function registerCopy(): void;
 /**
  * Keyboard shortcut to copy and delete a block on ctrl+x, cmd+x, or alt+x.
- *
- * @alias Blockly.ShortcutItems.registerCut
  */
 export declare function registerCut(): void;
 /**
  * Keyboard shortcut to paste a block on ctrl+v, cmd+v, or alt+v.
- *
- * @alias Blockly.ShortcutItems.registerPaste
  */
 export declare function registerPaste(): void;
 /**
  * Keyboard shortcut to undo the previous action on ctrl+z, cmd+z, or alt+z.
- *
- * @alias Blockly.ShortcutItems.registerUndo
  */
 export declare function registerUndo(): void;
 /**
  * Keyboard shortcut to redo the previous action on ctrl+shift+z, cmd+shift+z,
  * or alt+shift+z.
- *
- * @alias Blockly.ShortcutItems.registerRedo
  */
 export declare function registerRedo(): void;
 /**
  * Registers all default keyboard shortcut item. This should be called once per
  * instance of KeyboardShortcutRegistry.
  *
- * @alias Blockly.ShortcutItems.registerDefaultShortcuts
  * @internal
  */
 export declare function registerDefaultShortcuts(): void;

package/core/shortcut_registry.d.ts

@@ -9,8 +9,6 @@ import type { Workspace } from './workspace.js';
  * Class for the registry of keyboard shortcuts. This is intended to be a
  * singleton. You should not create a new instance, and only access this class
  * from ShortcutRegistry.registry.
- *
- * @alias Blockly.ShortcutRegistry
  */
 export declare class ShortcutRegistry {
     static readonly registry: ShortcutRegistry;

package/core/sprites.d.ts

@@ -6,8 +6,6 @@
 /**
  * Contains the path to a single png tat holds the images for the trashcan
  * as well as the zoom controls.
- *
- * @alias Blockly.sprite.SPRITE
  */
 export declare const SPRITE: {
     width: number;

package/core/theme/classic.d.ts

@@ -7,8 +7,6 @@ import { Theme } from '../theme.js';
 /**
  * Classic theme.
  * Contains multi-coloured border to create shadow effect.
- *
- * @alias Blockly.Themes.Classic
  */
 export declare const Classic: Theme;
 //# sourceMappingURL=classic.d.ts.map

package/core/theme/zelos.d.ts

@@ -6,8 +6,6 @@
 import { Theme } from '../theme.js';
 /**
  * Zelos theme.
- *
- * @alias Blockly.Themes.Zelos
  */
 export declare const Zelos: Theme;
 //# sourceMappingURL=zelos.d.ts.map

package/core/theme.d.ts

@@ -18,8 +18,6 @@ export interface ITheme {
 }
 /**
  * Class for a theme.
- *
- * @alias Blockly.Theme
  */
 export declare class Theme implements ITheme {
     name: string;

package/core/theme_manager.d.ts

@@ -8,8 +8,6 @@ import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for storing and updating a workspace's theme and UI components.
- *
- * @alias Blockly.ThemeManager
  */
 export declare class ThemeManager {
     private readonly workspace;
@@ -17,7 +15,6 @@ export declare class ThemeManager {
     /** A list of workspaces that are subscribed to this theme. */
     private subscribedWorkspaces_;
     private componentDB;
-    owner_: any;
     /**
      * @param workspace The main workspace.
      * @param theme The workspace theme.
@@ -63,14 +60,14 @@ export declare class ThemeManager {
      * @param propertyName The inline style property name to update.
      * @internal
      */
-    subscribe(element: Element, componentName: string, propertyName: string): void;
+    subscribe(element: HTMLElement | SVGElement, componentName: string, propertyName: string): void;
     /**
      * Unsubscribe an element to changes to the selected theme.
      *
      * @param element The element to unsubscribe.
      * @internal
      */
-    unsubscribe(element: Element): void;
+    unsubscribe(element: HTMLElement | SVGElement): void;
     /**
      * Dispose of this theme manager.
      *
@@ -82,7 +79,7 @@ export declare class ThemeManager {
 export declare namespace ThemeManager {
     /** The type for a Blockly UI Component. */
     interface Component {
-        element: Element;
+        element: HTMLElement | SVGElement;
         propertyName: string;
     }
 }

package/core/toolbox/category.d.ts

@@ -10,8 +10,6 @@ import type { CategoryInfo, FlyoutDefinition, FlyoutItemInfoArray } from '../uti
 import { ToolboxItem } from './toolbox_item.js';
 /**
  * Class for a category in a toolbox.
- *
- * @alias Blockly.ToolboxCategory
  */
 export declare class ToolboxCategory extends ToolboxItem implements ISelectableToolboxItem {
     /** Name used for registering a toolbox category. */
@@ -30,15 +28,15 @@ export declare class ToolboxCategory extends ToolboxItem implements ISelectableT
     protected name_: string;
     /** The colour of the category. */
     protected colour_: string;
-    /** The html container for the category. */
+    /** The HTML container for the category. */
     protected htmlDiv_: HTMLDivElement | null;
-    /** The html element for the category row. */
+    /** The HTML element for the category row. */
     protected rowDiv_: HTMLDivElement | null;
-    /** The html element that holds children elements of the category row. */
+    /** The HTML element that holds children elements of the category row. */
     protected rowContents_: HTMLDivElement | null;
-    /** The html element for the toolbox icon. */
+    /** The HTML element for the toolbox icon. */
     protected iconDom_: Element | null;
-    /** The html element for the toolbox label. */
+    /** The HTML element for the toolbox label. */
     protected labelDom_: Element | null;
     protected cssConfig_: CssConfig;
     /** True if the category is meant to be hidden, false otherwise. */

package/core/toolbox/collapsible_category.d.ts

@@ -10,8 +10,6 @@ import * as toolbox from '../utils/toolbox.js';
 import { ToolboxCategory } from './category.js';
 /**
  * Class for a category in a toolbox that can be collapsed.
- *
- * @alias Blockly.CollapsibleToolboxCategory
  */
 export declare class CollapsibleToolboxCategory extends ToolboxCategory implements ICollapsibleToolboxItem {
     /** Name used for registering a collapsible toolbox category. */
@@ -22,8 +20,6 @@ export declare class CollapsibleToolboxCategory extends ToolboxCategory implemen
     protected expanded_: boolean;
     /** The child toolbox items for this category. */
     protected toolboxItems_: IToolboxItem[];
-    flyoutItems_: any;
-    isHidden_: any;
     /**
      * @param categoryDef The information needed to create a category in the
      *     toolbox.

package/core/toolbox/separator.d.ts

@@ -9,8 +9,6 @@ import { ToolboxItem } from './toolbox_item.js';
 /**
  * Class for a toolbox separator. This is the thin visual line that appears on
  * the toolbox. This item is not interactable.
- *
- * @alias Blockly.ToolboxSeparator
  */
 export declare class ToolboxSeparator extends ToolboxItem {
     /** Name used for registering a toolbox separator. */

package/core/toolbox/toolbox.d.ts

@@ -21,8 +21,6 @@ import type { WorkspaceSvg } from '../workspace_svg.js';
 /**
  * Class for a Toolbox.
  * Creates the toolbox's DOM.
- *
- * @alias Blockly.Toolbox
  */
 export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeyboardAccessible, IStyleable, IToolbox {
     /**
@@ -32,9 +30,9 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
     id: string;
     protected toolboxDef_: toolbox.ToolboxInfo;
     private readonly horizontalLayout_;
-    /** The html container for the toolbox. */
+    /** The HTML container for the toolbox. */
     HtmlDiv: HTMLDivElement | null;
-    /** The html container for the contents of a toolbox. */
+    /** The HTML container for the contents of a toolbox. */
     protected contentsDiv_: HTMLDivElement | null;
     /** Whether the Toolbox is visible. */
     protected isVisible_: boolean;
@@ -61,7 +59,6 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
      * Ex: [[node, name, func], [node, name, func]].
      */
     protected boundEvents_: browserEvents.Data[];
-    wouldDelete_: any;
     /** The workspace this toolbox is on. */
     protected readonly workspace_: WorkspaceSvg;
     /** @param workspace The workspace in which to create new blocks. */

package/core/toolbox/toolbox_item.d.ts

@@ -10,8 +10,6 @@ import type * as toolbox from '../utils/toolbox.js';
 import type { WorkspaceSvg } from '../workspace_svg.js';
 /**
  * Class for an item in the toolbox.
- *
- * @alias Blockly.ToolboxItem
  */
 export declare class ToolboxItem implements IToolboxItem {
     protected id_: string;

package/core/tooltip.d.ts

@@ -8,8 +8,6 @@
  * Either a string, an object containing a tooltip property, or a function which
  * returns either a string, or another arbitrarily nested function which
  * eventually unwinds to a string.
- *
- * @alias Blockly.Tooltip.TipInfo
  */
 export type TipInfo = string | {
     tooltip: any;
@@ -19,8 +17,6 @@ export type TipInfo = string | {
  * 1st parameter: the div element to render content into.
  * 2nd parameter: the element being moused over (i.e., the element for which the
  * tooltip should be shown).
- *
- * @alias Blockly.Tooltip.CustomTooltip
  */
 export type CustomTooltip = (p1: Element, p2: Element) => any;
 /**
@@ -28,7 +24,6 @@ export type CustomTooltip = (p1: Element, p2: Element) => any;
  * tooltip UI.
  *
  * @param customFn A custom tooltip used to render an alternate tooltip UI.
- * @alias Blockly.Tooltip.setCustomTooltip
  */
 export declare function setCustomTooltip(customFn: CustomTooltip): void;
 /**
@@ -41,50 +36,36 @@ export declare function getCustomTooltip(): CustomTooltip | undefined;
  * Returns whether or not a tooltip is showing
  *
  * @returns True if a tooltip is showing
- * @alias Blockly.Tooltip.isVisible
  */
 export declare function isVisible(): boolean;
 /**
  * Maximum width (in characters) of a tooltip.
- *
- * @alias Blockly.Tooltip.LIMIT
  */
 export declare const LIMIT = 50;
 /**
  * Horizontal offset between mouse cursor and tooltip.
- *
- * @alias Blockly.Tooltip.OFFSET_X
  */
 export declare const OFFSET_X = 0;
 /**
  * Vertical offset between mouse cursor and tooltip.
- *
- * @alias Blockly.Tooltip.OFFSET_Y
  */
 export declare const OFFSET_Y = 10;
 /**
  * Radius mouse can move before killing tooltip.
- *
- * @alias Blockly.Tooltip.RADIUS_OK
  */
 export declare const RADIUS_OK = 10;
 /**
  * Delay before tooltip appears.
- *
- * @alias Blockly.Tooltip.HOVER_MS
  */
 export declare const HOVER_MS = 750;
 /**
  * Horizontal padding between tooltip and screen edge.
- *
- * @alias Blockly.Tooltip.MARGINS
  */
 export declare const MARGINS = 5;
 /**
  * Returns the HTML tooltip container.
  *
  * @returns The HTML tooltip container.
- * @alias Blockly.Tooltip.getDiv
  */
 export declare function getDiv(): HTMLDivElement | null;
 /**
@@ -92,47 +73,38 @@ export declare function getDiv(): HTMLDivElement | null;
  *
  * @param object The object to get the tooltip text of.
  * @returns The tooltip text of the element.
- * @alias Blockly.Tooltip.getTooltipOfObject
  */
 export declare function getTooltipOfObject(object: any | null): string;
 /**
  * Create the tooltip div and inject it onto the page.
- *
- * @alias Blockly.Tooltip.createDom
  */
 export declare function createDom(): void;
 /**
  * Binds the required mouse events onto an SVG element.
  *
  * @param element SVG element onto which tooltip is to be bound.
- * @alias Blockly.Tooltip.bindMouseEvents
  */
 export declare function bindMouseEvents(element: Element): void;
 /**
  * Unbinds tooltip mouse events from the SVG element.
  *
  * @param element SVG element onto which tooltip is bound.
- * @alias Blockly.Tooltip.unbindMouseEvents
  */
 export declare function unbindMouseEvents(element: Element | null): void;
 /**
  * Dispose of the tooltip.
  *
- * @alias Blockly.Tooltip.dispose
  * @internal
  */
 export declare function dispose(): void;
 /**
  * Hide the tooltip.
- *
- * @alias Blockly.Tooltip.hide
  */
 export declare function hide(): void;
 /**
  * Hide any in-progress tooltips and block showing new tooltips until the next
  * call to unblock().
  *
- * @alias Blockly.Tooltip.block
  * @internal
  */
 export declare function block(): void;
@@ -140,7 +112,6 @@ export declare function block(): void;
  * Unblock tooltips: allow them to be scheduled and shown according to their own
  * logic.
  *
- * @alias Blockly.Tooltip.unblock
  * @internal
  */
 export declare function unblock(): void;

package/core/touch.d.ts

@@ -23,8 +23,6 @@ export declare const TOUCH_ENABLED: boolean;
 /**
  * The TOUCH_MAP lookup dictionary specifies additional touch events to fire,
  * in conjunction with mouse events.
- *
- * @alias Blockly.Touch.TOUCH_MAP
  */
 export declare const TOUCH_MAP: {
     [key: string]: string[];
@@ -38,7 +36,6 @@ export declare const TOUCH_MAP: {
  *
  * @param e Touch start event.
  * @param gesture The gesture that triggered this longStart.
- * @alias Blockly.Touch.longStart
  * @internal
  */
 export declare function longStart(e: PointerEvent, gesture: Gesture): void;
@@ -46,7 +43,6 @@ export declare function longStart(e: PointerEvent, gesture: Gesture): void;
  * Nope, that's not a long-press.  Either touchend or touchcancel was fired,
  * or a drag hath begun.  Kill the queued long-press task.
  *
- * @alias Blockly.Touch.longStop
  * @internal
  */
 export declare function longStop(): void;
@@ -54,8 +50,6 @@ export declare function longStop(): void;
  * Clear the touch identifier that tracks which touch stream to pay attention
  * to.  This ends the current drag/gesture and allows other pointers to be
  * captured.
- *
- * @alias Blockly.Touch.clearTouchIdentifier
  */
 export declare function clearTouchIdentifier(): void;
 /**
@@ -66,7 +60,6 @@ export declare function clearTouchIdentifier(): void;
  * @param e The event to check.
  * @returns True if this event should be passed through to the registered
  *     handler; false if it should be blocked.
- * @alias Blockly.Touch.shouldHandleEvent
  */
 export declare function shouldHandleEvent(e: Event): boolean;
 /**
@@ -74,7 +67,6 @@ export declare function shouldHandleEvent(e: Event): boolean;
  *
  * @param e Pointer event.
  * @returns The pointerId of the event.
- * @alias Blockly.Touch.getTouchIdentifierFromEvent
  */
 export declare function getTouchIdentifierFromEvent(e: PointerEvent): string;
 /**
@@ -86,7 +78,6 @@ export declare function getTouchIdentifierFromEvent(e: PointerEvent): string;
  * @param e Pointer event.
  * @returns Whether the identifier on the event matches the current saved
  *     identifier.
- * @alias Blockly.Touch.checkTouchIdentifier
  */
 export declare function checkTouchIdentifier(e: PointerEvent): boolean;
 /**
@@ -94,7 +85,6 @@ export declare function checkTouchIdentifier(e: PointerEvent): boolean;
  * make a touch event work in a mouse event handler.
  *
  * @param e A touch event.
- * @alias Blockly.Touch.setClientFromTouch
  */
 export declare function setClientFromTouch(e: Event | PseudoEvent): void;
 /**
@@ -102,7 +92,6 @@ export declare function setClientFromTouch(e: Event | PseudoEvent): void;
  *
  * @param e An event.
  * @returns True if it is a mouse, touch, or pointer event; false otherwise.
- * @alias Blockly.Touch.isMouseOrTouchEvent
  */
 export declare function isMouseOrTouchEvent(e: Event | PseudoEvent): boolean;
 /**
@@ -110,7 +99,6 @@ export declare function isMouseOrTouchEvent(e: Event | PseudoEvent): boolean;
  *
  * @param e An event.
  * @returns True if it is a touch or pointer event; false otherwise.
- * @alias Blockly.Touch.isTouchEvent
  */
 export declare function isTouchEvent(e: Event | PseudoEvent): boolean;
 /**
@@ -121,7 +109,6 @@ export declare function isTouchEvent(e: Event | PseudoEvent): boolean;
  * @returns An array of events or pseudo events.
  *     Each pseudo-touch event will have exactly one changed touch and there
  * will be no real touch events.
- * @alias Blockly.Touch.splitEventByTouches
  */
 export declare function splitEventByTouches(e: Event): Array<Event | PseudoEvent>;
 export {};

package/core/trashcan.d.ts

@@ -14,8 +14,6 @@ import { Rect } from './utils/rect.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for a trash can.
- *
- * @alias Blockly.Trashcan
  */
 export declare class Trashcan extends DeleteArea implements IAutoHideable, IPositionable {
     private workspace;

package/core/utils/aria.d.ts

@@ -6,8 +6,6 @@
 /**
  * ARIA role values.
  * Copied from Closure's goog.a11y.aria.Role
- *
- * @alias Blockly.utils.aria.Role
  */
 export declare enum Role {
     GRID = "grid",
@@ -26,8 +24,6 @@ export declare enum Role {
 /**
  * ARIA states and properties.
  * Copied from Closure's goog.a11y.aria.State
- *
- * @alias Blockly.utils.aria.State
  */
 export declare enum State {
     ACTIVEDESCENDANT = "activedescendant",
@@ -53,7 +49,6 @@ export declare enum State {
  *
  * @param element DOM node to set role of.
  * @param roleName Role name.
- * @alias Blockly.utils.aria.setRole
  */
 export declare function setRole(element: Element, roleName: Role): void;
 /**
@@ -65,7 +60,6 @@ export declare function setRole(element: Element, roleName: Role): void;
  *     Automatically adds prefix 'aria-' to the state name if the attribute is
  * not an extra attribute.
  * @param value Value for the state attribute.
- * @alias Blockly.utils.aria.setState
  */
 export declare function setState(element: Element, stateName: State, value: string | boolean | number | string[]): void;
 //# sourceMappingURL=aria.d.ts.map

package/core/utils/array.d.ts

@@ -9,7 +9,6 @@
  * @param arr Array from which to remove value.
  * @param value Value to remove.
  * @returns True if an element was removed.
- * @alias Blockly.array.removeElem
  * @internal
  */
 export declare function removeElem<T>(arr: Array<T>, value: T): boolean;