blockly 9.3.0-beta.0 → 9.3.0

package/core/utils/toolbox.d.ts

@@ -9,8 +9,6 @@ import type { CssConfig as SeparatorCssConfig } from '../toolbox/separator.js';
 /**
  * The information needed to create a block in the toolbox.
  * Note that disabled has a different type for backwards compatibility.
- *
- * @alias Blockly.utils.toolbox.BlockInfo
  */
 export interface BlockInfo {
     kind: string;
@@ -39,8 +37,6 @@ export interface BlockInfo {
 }
 /**
  * The information needed to create a separator in the toolbox.
- *
- * @alias Blockly.utils.toolbox.SeparatorInfo
  */
 export interface SeparatorInfo {
     kind: string;
@@ -50,8 +46,6 @@ export interface SeparatorInfo {
 }
 /**
  * The information needed to create a button in the toolbox.
- *
- * @alias Blockly.utils.toolbox.ButtonInfo
  */
 export interface ButtonInfo {
     kind: string;
@@ -60,8 +54,6 @@ export interface ButtonInfo {
 }
 /**
  * The information needed to create a label in the toolbox.
- *
- * @alias Blockly.utils.toolbox.LabelInfo
  */
 export interface LabelInfo {
     kind: string;
@@ -70,14 +62,10 @@ export interface LabelInfo {
 }
 /**
  * The information needed to create either a button or a label in the flyout.
- *
- * @alias Blockly.utils.toolbox.ButtonOrLabelInfo
  */
 export type ButtonOrLabelInfo = ButtonInfo | LabelInfo;
 /**
  * The information needed to create a category in the toolbox.
- *
- * @alias Blockly.utils.toolbox.StaticCategoryInfo
  */
 export interface StaticCategoryInfo {
     kind: string;
@@ -88,11 +76,10 @@ export interface StaticCategoryInfo {
     colour: string | undefined;
     cssconfig: CategoryCssConfig | undefined;
     hidden: string | undefined;
+    expanded?: string | boolean;
 }
 /**
  * The information needed to create a custom category.
- *
- * @alias Blockly.utils.toolbox.DynamicCategoryInfo
  */
 export interface DynamicCategoryInfo {
     kind: string;
@@ -102,29 +89,22 @@ export interface DynamicCategoryInfo {
     colour: string | undefined;
     cssconfig: CategoryCssConfig | undefined;
     hidden: string | undefined;
+    expanded?: string | boolean;
 }
 /**
  * The information needed to create either a dynamic or static category.
- *
- * @alias Blockly.utils.toolbox.CategoryInfo
  */
 export type CategoryInfo = StaticCategoryInfo | DynamicCategoryInfo;
 /**
  * Any information that can be used to create an item in the toolbox.
- *
- * @alias Blockly.utils.toolbox.ToolboxItemInfo
  */
 export type ToolboxItemInfo = FlyoutItemInfo | StaticCategoryInfo;
 /**
  * All the different types that can be displayed in a flyout.
- *
- * @alias Blockly.utils.toolbox.FlyoutItemInfo
  */
 export type FlyoutItemInfo = BlockInfo | SeparatorInfo | ButtonInfo | LabelInfo | DynamicCategoryInfo;
 /**
  * The JSON definition of a toolbox.
- *
- * @alias Blockly.utils.toolbox.ToolboxInfo
  */
 export interface ToolboxInfo {
     kind?: string;
@@ -132,26 +112,18 @@ export interface ToolboxInfo {
 }
 /**
  * An array holding flyout items.
- *
- * @alias Blockly.utils.toolbox.FlyoutItemInfoArray
  */
 export type FlyoutItemInfoArray = FlyoutItemInfo[];
 /**
  * All of the different types that can create a toolbox.
- *
- * @alias Blockly.utils.toolbox.ToolboxDefinition
  */
 export type ToolboxDefinition = Node | ToolboxInfo | string;
 /**
  * All of the different types that can be used to show items in a flyout.
- *
- * @alias Blockly.utils.toolbox.FlyoutDefinition
  */
 export type FlyoutDefinition = FlyoutItemInfoArray | NodeList | ToolboxInfo | Node[];
 /**
  * Position of the toolbox and/or flyout relative to the workspace.
- *
- * @alias Blockly.utils.toolbox.Position
  */
 export declare enum Position {
     TOP = 0,
@@ -164,7 +136,6 @@ export declare enum Position {
  *
  * @param toolboxDef The definition of the toolbox in one of its many forms.
  * @returns Object holding information for creating a toolbox.
- * @alias Blockly.utils.toolbox.convertToolboxDefToJson
  * @internal
  */
 export declare function convertToolboxDefToJson(toolboxDef: ToolboxDefinition | null): ToolboxInfo | null;
@@ -173,7 +144,6 @@ export declare function convertToolboxDefToJson(toolboxDef: ToolboxDefinition |
  *
  * @param flyoutDef The definition of the flyout in one of its many forms.
  * @returns A list of flyout items.
- * @alias Blockly.utils.toolbox.convertFlyoutDefToJsonArray
  * @internal
  */
 export declare function convertFlyoutDefToJsonArray(flyoutDef: FlyoutDefinition | null): FlyoutItemInfoArray;
@@ -182,7 +152,6 @@ export declare function convertFlyoutDefToJsonArray(flyoutDef: FlyoutDefinition
  *
  * @param toolboxJson Object holding information for creating a toolbox.
  * @returns True if the toolbox has categories.
- * @alias Blockly.utils.toolbox.hasCategories
  * @internal
  */
 export declare function hasCategories(toolboxJson: ToolboxInfo | null): boolean;
@@ -195,7 +164,6 @@ declare function hasCategoriesInternal(toolboxJson: ToolboxInfo | null): boolean
  *
  * @param categoryInfo Object holing information for creating a category.
  * @returns True if the category has subcategories.
- * @alias Blockly.utils.toolbox.isCategoryCollapsible
  * @internal
  */
 export declare function isCategoryCollapsible(categoryInfo: CategoryInfo): boolean;
@@ -204,7 +172,6 @@ export declare function isCategoryCollapsible(categoryInfo: CategoryInfo): boole
  *
  * @param toolboxDef DOM tree of blocks, or text representation of same.
  * @returns DOM tree of blocks, or null.
- * @alias Blockly.utils.toolbox.parseToolboxTree
  */
 export declare function parseToolboxTree(toolboxDef: Element | null | string): Element | null;
 export declare const TEST_ONLY: {

package/core/utils/useragent.d.ts

@@ -3,20 +3,12 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/** @alias Blockly.utils.userAgent.raw */
 export declare const raw: string;
-/** @alias Blockly.utils.userAgent.JavaFx */
 export declare const JavaFx: boolean;
-/** @alias Blockly.utils.userAgent.GECKO */
 export declare const GECKO: boolean;
-/** @alias Blockly.utils.userAgent.ANDROID */
 export declare const ANDROID: boolean;
-/** @alias Blockly.utils.userAgent.IPAD */
 export declare const IPAD: boolean;
-/** @alias Blockly.utils.userAgent.IPHONE */
 export declare const IPHONE: boolean;
-/** @alias Blockly.utils.userAgent.MAC */
 export declare const MAC: boolean;
-/** @alias Blockly.utils.userAgent.MOBILE */
 export declare const MOBILE: boolean;
 //# sourceMappingURL=useragent.d.ts.map

package/core/utils/xml.d.ts

@@ -44,8 +44,6 @@ export declare function injectDependencies(dependencies: {
 }): void;
 /**
  * Namespace for Blockly's XML.
- *
- * @alias Blockly.utils.xml.NAME_SPACE
  */
 export declare const NAME_SPACE = "https://developers.google.com/blockly/xml";
 /**
@@ -53,7 +51,6 @@ export declare const NAME_SPACE = "https://developers.google.com/blockly/xml";
  *
  * @returns The document object.
  * @deprecated No longer provided by Blockly.
- * @alias Blockly.utils.xml.getDocument
  */
 export declare function getDocument(): Document;
 /**
@@ -61,7 +58,6 @@ export declare function getDocument(): Document;
  *
  * @param xmlDocument The document object to use.
  * @deprecated No longer provided by Blockly.
- * @alias Blockly.utils.xml.setDocument
  */
 export declare function setDocument(xmlDocument: Document): void;
 /**
@@ -69,7 +65,6 @@ export declare function setDocument(xmlDocument: Document): void;
  *
  * @param tagName Name of DOM element.
  * @returns New DOM element.
- * @alias Blockly.utils.xml.createElement
  */
 export declare function createElement(tagName: string): Element;
 /**
@@ -77,16 +72,23 @@ export declare function createElement(tagName: string): Element;
  *
  * @param text Text content.
  * @returns New DOM text node.
- * @alias Blockly.utils.xml.createTextNode
  */
 export declare function createTextNode(text: string): Text;
+/**
+ * Converts an XML string into a DOM structure.
+ *
+ * @param text An XML string.
+ * @returns A DOM object representing the singular child of the document
+ *     element.
+ * @throws if the text doesn't parse.
+ */
+export declare function textToDom(text: string): Element;
 /**
  * Converts an XML string into a DOM tree.
  *
  * @param text XML string.
  * @returns The DOM document.
  * @throws if XML doesn't parse.
- * @alias Blockly.utils.xml.textToDomDocument
  */
 export declare function textToDomDocument(text: string): Document;
 /**
@@ -95,7 +97,6 @@ export declare function textToDomDocument(text: string): Document;
  *
  * @param dom A tree of XML nodes.
  * @returns Text representation.
- * @alias Blockly.utils.xml.domToText
  */
 export declare function domToText(dom: Node): string;
 export {};

package/core/utils.d.ts

@@ -37,7 +37,6 @@ export { aria, arrayUtils as array, browserEvents, colour, Coordinate, deprecati
  * @param element SVG element to find the coordinates of.
  * @returns Object with .x and .y properties.
  * @deprecated Use **Blockly.utils.svgMath.getRelativeXY** instead.
- * @alias Blockly.utils.getRelativeXY
  */
 export declare function getRelativeXY(element: Element): Coordinate;
 /**
@@ -48,7 +47,6 @@ export declare function getRelativeXY(element: Element): Coordinate;
  *     of the div Blockly was injected into, the behaviour is undefined.
  * @returns Object with .x and .y properties.
  * @deprecated Use **Blockly.utils.svgMath.getInjectionDivXY** instead.
- * @alias Blockly.utils.getInjectionDivXY_
  */
 declare function getInjectionDivXY(element: Element): Coordinate;
 export declare const getInjectionDivXY_: typeof getInjectionDivXY;
@@ -63,7 +61,6 @@ export declare const getInjectionDivXY_: typeof getInjectionDivXY;
  *     interpolation tokens.
  * @returns Array of strings and numbers.
  * @deprecated Use **Blockly.utils.parsing.tokenizeInterpolation** instead.
- * @alias Blockly.utils.tokenizeInterpolation
  */
 export declare function tokenizeInterpolation(message: string): Array<string | number>;
 /**
@@ -75,7 +72,6 @@ export declare function tokenizeInterpolation(message: string): Array<string | n
  *     references.
  * @returns String with message references replaced.
  * @deprecated Use **Blockly.utils.parsing.replaceMessageReferences** instead.
- * @alias Blockly.utils.replaceMessageReferences
  */
 export declare function replaceMessageReferences(message: string | any): string;
 /**
@@ -86,7 +82,6 @@ export declare function replaceMessageReferences(message: string | any): string;
  * @returns True if all message references have matching values.
  *     Otherwise, false.
  * @deprecated Use **Blockly.utils.parsing.checkMessageReferences** instead.
- * @alias Blockly.utils.checkMessageReferences
  */
 export declare function checkMessageReferences(message: string): boolean;
 /**
@@ -95,7 +90,6 @@ export declare function checkMessageReferences(message: string): boolean;
  *
  * @returns True if 3D transforms are supported.
  * @deprecated Use **Blockly.utils.svgMath.is3dSupported** instead.
- * @alias Blockly.utils.is3dSupported
  */
 export declare function is3dSupported(): boolean;
 /**
@@ -104,7 +98,6 @@ export declare function is3dSupported(): boolean;
  *
  * @returns An object containing window width, height, and scroll position in
  *     window coordinates.
- * @alias Blockly.utils.getViewportBBox
  * @deprecated Use **Blockly.utils.svgMath.getViewportBBox** instead.
  * @internal
  */
@@ -115,7 +108,6 @@ export declare function getViewportBBox(): Rect;
  * @param arr Array from which to remove value.
  * @param value Value to remove.
  * @returns True if an element was removed.
- * @alias Blockly.utils.arrayRemove
  * @deprecated Use **Blockly.array.removeElem** instead.
  * @internal
  */
@@ -126,7 +118,6 @@ export declare function arrayRemove<T>(arr: Array<T>, value: T): boolean;
  *
  * @returns Object with values 'x' and 'y'.
  * @deprecated Use **Blockly.utils.svgMath.getDocumentScroll** instead.
- * @alias Blockly.utils.getDocumentScroll
  */
 export declare function getDocumentScroll(): Coordinate;
 /**
@@ -138,7 +129,6 @@ export declare function getDocumentScroll(): Coordinate;
  *     that are not inside a value or statement input of the block).
  * @returns Map of types to type counts for descendants of the bock.
  * @deprecated Use **Blockly.common.getBlockTypeCounts** instead.
- * @alias Blockly.utils.getBlockTypeCounts
  */
 export declare function getBlockTypeCounts(block: Block, opt_stripFollowing?: boolean): {
     [key: string]: number;
@@ -163,7 +153,6 @@ export declare function screenToWsCoordinates(ws: WorkspaceSvg, screenCoordinate
  *     the input was an HSV hue value.
  * @throws {Error} If the colour cannot be parsed.
  * @deprecated Use **Blockly.utils.parsing.parseBlockColour** instead.
- * @alias Blockly.utils.parseBlockColour
  */
 export declare function parseBlockColour(colour: number | string): {
     hue: number | null;
@@ -175,7 +164,6 @@ export declare function parseBlockColour(colour: number | string): {
  * @param fn Function to run.
  * @throws Error Will throw if no global document can be found (e.g., Node.js).
  * @deprecated No longer provided by Blockly.
- * @alias Blockly.utils.runAfterPageLoad
  */
 export declare function runAfterPageLoad(fn: () => void): void;
 //# sourceMappingURL=utils.d.ts.map

package/core/variable_map.d.ts

@@ -12,8 +12,6 @@ import type { Workspace } from './workspace.js';
  * Class for a variable map.  This contains a dictionary data structure with
  * variable types as keys and lists of variables as values.  The list of
  * variables are the type indicated by the key.
- *
- * @alias Blockly.VariableMap
  */
 export declare class VariableMap {
     workspace: Workspace;
@@ -25,7 +23,7 @@ export declare class VariableMap {
     private variableMap;
     /** @param workspace The workspace this map belongs to. */
     constructor(workspace: Workspace);
-    /** Clear the variable map. */
+    /** Clear the variable map.  Fires events for every deletion. */
     clear(): void;
     /**
      * Rename the given variable by updating its name in the variable map.

package/core/variable_model.d.ts

@@ -10,7 +10,6 @@ import type { Workspace } from './workspace.js';
  * Holds information for the variable including name, ID, and type.
  *
  * @see {Blockly.FieldVariable}
- * @alias Blockly.VariableModel
  */
 export declare class VariableModel {
     workspace: Workspace;

package/core/variables.d.ts

@@ -12,8 +12,6 @@ import type { WorkspaceSvg } from './workspace_svg.js';
  * variable blocks.
  * See also Blockly.Procedures.CATEGORY_NAME and
  * Blockly.VariablesDynamic.CATEGORY_NAME.
- *
- * @alias Blockly.Variables.CATEGORY_NAME
  */
 export declare const CATEGORY_NAME = "VARIABLE";
 /**
@@ -24,7 +22,6 @@ export declare const CATEGORY_NAME = "VARIABLE";
  *
  * @param ws The workspace to search for variables.
  * @returns Array of variable models.
- * @alias Blockly.Variables.allUsedVarModels
  */
 export declare function allUsedVarModels(ws: Workspace): VariableModel[];
 /**
@@ -37,7 +34,6 @@ export declare function allUsedVarModels(ws: Workspace): VariableModel[];
  *
  * @param workspace The workspace to search.
  * @returns A list of non-duplicated variable names.
- * @alias Blockly.Variables.allDeveloperVariables
  */
 export declare function allDeveloperVariables(workspace: Workspace): string[];
 /**
@@ -46,7 +42,6 @@ export declare function allDeveloperVariables(workspace: Workspace): string[];
  *
  * @param workspace The workspace containing variables.
  * @returns Array of XML elements.
- * @alias Blockly.Variables.flyoutCategory
  */
 export declare function flyoutCategory(workspace: WorkspaceSvg): Element[];
 /**
@@ -54,10 +49,8 @@ export declare function flyoutCategory(workspace: WorkspaceSvg): Element[];
  *
  * @param workspace The workspace containing variables.
  * @returns Array of XML block elements.
- * @alias Blockly.Variables.flyoutCategoryBlocks
  */
 export declare function flyoutCategoryBlocks(workspace: Workspace): Element[];
-/** @alias Blockly.Variables.VAR_LETTER_OPTIONS */
 export declare const VAR_LETTER_OPTIONS = "ijkmnopqrstuvwxyzabcdefgh";
 /**
  * Return a new variable name that is not yet being used. This will try to
@@ -67,7 +60,6 @@ export declare const VAR_LETTER_OPTIONS = "ijkmnopqrstuvwxyzabcdefgh";
  *
  * @param workspace The workspace to be unique in.
  * @returns New variable name.
- * @alias Blockly.Variables.generateUniqueName
  */
 export declare function generateUniqueName(workspace: Workspace): string;
 /**
@@ -82,7 +74,6 @@ declare function generateUniqueNameInternal(workspace: Workspace): string;
  * @param startChar The character to start the search at.
  * @param usedNames A list of all of the used names.
  * @returns A unique name that is not present in the usedNames array.
- * @alias Blockly.Variables.generateUniqueNameFromOptions
  */
 export declare function generateUniqueNameFromOptions(startChar: string, usedNames: string[]): string;
 /**
@@ -100,7 +91,6 @@ export declare function generateUniqueNameFromOptions(startChar: string, usedNam
  *     an existing variable was chosen.
  * @param opt_type The type of the variable like 'int', 'string', or ''. This
  *     will default to '', which is a specific type.
- * @alias Blockly.Variables.createVariableButtonHandler
  */
 export declare function createVariableButtonHandler(workspace: Workspace, opt_callback?: (p1?: string | null) => void, opt_type?: string): void;
 /**
@@ -113,7 +103,6 @@ export declare function createVariableButtonHandler(workspace: Workspace, opt_ca
  * @param opt_callback A callback. It will be passed an acceptable new variable
  *     name, or null if change is to be aborted (cancel button), or undefined if
  *     an existing variable was chosen.
- * @alias Blockly.Variables.renameVariable
  */
 export declare function renameVariable(workspace: Workspace, variable: VariableModel, opt_callback?: (p1?: string | null) => void): void;
 /**
@@ -123,7 +112,6 @@ export declare function renameVariable(workspace: Workspace, variable: VariableM
  * @param defaultText The default value to show in the prompt's field.
  * @param callback A callback. It will be passed the new variable name, or null
  *     if the user picked something illegal.
- * @alias Blockly.Variables.promptName
  */
 export declare function promptName(promptText: string, defaultText: string, callback: (p1: string | null) => void): void;
 /**
@@ -132,15 +120,26 @@ export declare function promptName(promptText: string, defaultText: string, call
  * @param name The name to search for.
  * @param workspace The workspace to search for the variable.
  * @returns The variable with the given name, or null if none was found.
- * @alias Blockly.Variables.nameUsedWithAnyType
  */
 export declare function nameUsedWithAnyType(name: string, workspace: Workspace): VariableModel | null;
+/**
+ * Returns the name of the procedure with a conflicting parameter name, or null
+ * if one does not exist.
+ *
+ * This checks the procedure map if it contains models, and the legacy procedure
+ * blocks otherwise.
+ *
+ * @param oldName The old name of the variable.
+ * @param newName The proposed name of the variable.
+ * @param workspace The workspace to search for conflicting parameters.
+ * @internal
+ */
+export declare function nameUsedWithConflictingParam(oldName: string, newName: string, workspace: Workspace): string | null;
 /**
  * Generate DOM objects representing a variable field.
  *
  * @param variableModel The variable model to represent.
  * @returns The generated DOM.
- * @alias Blockly.Variables.generateVariableFieldDom
  */
 export declare function generateVariableFieldDom(variableModel: VariableModel): Element;
 /**
@@ -154,7 +153,6 @@ export declare function generateVariableFieldDom(variableModel: VariableModel):
  * @param opt_type The type to use to look up or create the variable.
  * @returns The variable corresponding to the given ID or name + type
  *     combination.
- * @alias Blockly.Variables.getOrCreateVariablePackage
  */
 export declare function getOrCreateVariablePackage(workspace: Workspace, id: string | null, opt_name?: string, opt_type?: string): VariableModel;
 /**
@@ -171,7 +169,6 @@ export declare function getOrCreateVariablePackage(workspace: Workspace, id: str
  *     Only used if lookup by ID fails.
  * @returns The variable corresponding to the given ID or name + type
  *     combination, or null if not found.
- * @alias Blockly.Variables.getVariable
  */
 export declare function getVariable(workspace: Workspace, id: string | null, opt_name?: string, opt_type?: string): VariableModel | null;
 /**
@@ -185,7 +182,6 @@ export declare function getVariable(workspace: Workspace, id: string | null, opt
  * @returns The new array of variables that were freshly added to the workspace
  *     after creating the new block, or [] if no new variables were added to the
  *     workspace.
- * @alias Blockly.Variables.getAddedVariables
  * @internal
  */
 export declare function getAddedVariables(workspace: Workspace, originalVariables: VariableModel[]): VariableModel[];

package/core/variables_dynamic.d.ts

@@ -12,8 +12,6 @@ import type { FlyoutButton } from './flyout_button.js';
  * variable blocks.
  * See also Blockly.Variables.CATEGORY_NAME and
  * Blockly.Procedures.CATEGORY_NAME.
- *
- * @alias Blockly.VariablesDynamic.CATEGORY_NAME
  */
 export declare const CATEGORY_NAME = "VARIABLE_DYNAMIC";
 /**
@@ -43,7 +41,6 @@ export declare const onCreateVariableButtonClick_Colour: typeof colourButtonClic
  *
  * @param workspace The workspace containing variables.
  * @returns Array of XML elements.
- * @alias Blockly.VariablesDynamic.flyoutCategory
  */
 export declare function flyoutCategory(workspace: WorkspaceSvg): Element[];
 /**
@@ -51,7 +48,6 @@ export declare function flyoutCategory(workspace: WorkspaceSvg): Element[];
  *
  * @param workspace The workspace containing variables.
  * @returns Array of XML block elements.
- * @alias Blockly.VariablesDynamic.flyoutCategoryBlocks
  */
 export declare function flyoutCategoryBlocks(workspace: Workspace): Element[];
 export {};

package/core/warning.d.ts

@@ -8,8 +8,6 @@ import type { BlockSvg } from './block_svg.js';
 import { Icon } from './icon.js';
 /**
  * Class for a warning.
- *
- * @alias Blockly.Warning
  */
 export declare class Warning extends Icon {
     private text;

package/core/widgetdiv.d.ts

@@ -9,21 +9,17 @@ import type { Size } from './utils/size.js';
  * Returns the HTML container for editor widgets.
  *
  * @returns The editor widget container.
- * @alias Blockly.WidgetDiv.getDiv
  */
 export declare function getDiv(): HTMLDivElement | null;
 /**
  * Allows unit tests to reset the div. Do not use outside of tests.
  *
  * @param newDiv The new value for the DIV field.
- * @alias Blockly.WidgetDiv.testOnly_setDiv
  * @internal
  */
 export declare function testOnly_setDiv(newDiv: HTMLDivElement | null): void;
 /**
  * Create the widget div and inject it onto the page.
- *
- * @alias Blockly.WidgetDiv.createDom
  */
 export declare function createDom(): void;
 /**
@@ -33,20 +29,16 @@ export declare function createDom(): void;
  * @param rtl Right-to-left (true) or left-to-right (false).
  * @param newDispose Optional cleanup function to be run when the widget is
  *     closed.
- * @alias Blockly.WidgetDiv.show
  */
 export declare function show(newOwner: unknown, rtl: boolean, newDispose: () => void): void;
 /**
  * Destroy the widget and hide the div.
- *
- * @alias Blockly.WidgetDiv.hide
  */
 export declare function hide(): void;
 /**
  * Is the container visible?
  *
  * @returns True if visible.
- * @alias Blockly.WidgetDiv.isVisible
  */
 export declare function isVisible(): boolean;
 /**
@@ -54,7 +46,6 @@ export declare function isVisible(): boolean;
  * object.
  *
  * @param oldOwner The object that was using this container.
- * @alias Blockly.WidgetDiv.hideIfOwner
  */
 export declare function hideIfOwner(oldOwner: unknown): void;
 /**
@@ -71,7 +62,6 @@ export declare function hideIfOwner(oldOwner: unknown): void;
  *     window coordinates.
  * @param rtl Whether the workspace is in RTL mode.  This determines horizontal
  *     alignment.
- * @alias Blockly.WidgetDiv.positionWithAnchor
  * @internal
  */
 export declare function positionWithAnchor(viewportBBox: Rect, anchorBBox: Rect, widgetSize: Size, rtl: boolean): void;

package/core/workspace.d.ts

@@ -18,8 +18,6 @@ import { IProcedureMap } from './interfaces/i_procedure_map.js';
 /**
  * Class for a workspace.  This is a data structure that contains blocks.
  * There is no UI, and can be created headlessly.
- *
- * @alias Blockly.Workspace
  */
 export declare class Workspace implements IASTNodeLocation {
     /**
@@ -303,7 +301,9 @@ export declare class Workspace implements IASTNodeLocation {
      *     to be created).
      * @returns True if there is capacity for the given map, false otherwise.
      */
-    isCapacityAvailable(typeCountsMap: any): boolean;
+    isCapacityAvailable(typeCountsMap: {
+        [key: string]: number;
+    }): boolean;
     /**
      * Checks if the workspace has any limits on the maximum number of blocks,
      *    or the maximum number of blocks of specific types.

package/core/workspace_audio.d.ts

@@ -6,8 +6,6 @@
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for loading, storing, and playing audio for a workspace.
- *
- * @alias Blockly.WorkspaceAudio
  */
 export declare class WorkspaceAudio {
     private parentWorkspace;

package/core/workspace_comment.d.ts

@@ -7,8 +7,6 @@ import { Coordinate } from './utils/coordinate.js';
 import type { Workspace } from './workspace.js';
 /**
  * Class for a workspace comment.
- *
- * @alias Blockly.WorkspaceComment
  */
 export declare class WorkspaceComment {
     workspace: Workspace;
@@ -75,7 +73,7 @@ export declare class WorkspaceComment {
      *   This is not valid if the comment is currently being dragged.
      * @internal
      */
-    getXY(): Coordinate;
+    getRelativeToSurfaceXY(): Coordinate;
     /**
      * Move a comment by a relative offset.
      *