blockly 9.0.0-beta.0 → 9.0.0-beta.1

package/core/utils/string.d.ts

@@ -6,50 +6,57 @@
 /**
  * Fast prefix-checker.
  * Copied from Closure's goog.string.startsWith.
+ *
  * @param str The string to check.
  * @param prefix A string to look for at the start of `str`.
- * @return True if `str` begins with `prefix`.
+ * @returns True if `str` begins with `prefix`.
  * @alias Blockly.utils.string.startsWith
  * @deprecated April 2022. Use built-in string.startsWith.
  */
 export declare function startsWith(str: string, prefix: string): boolean;
 /**
  * Given an array of strings, return the length of the shortest one.
+ *
  * @param array Array of strings.
- * @return Length of shortest string.
+ * @returns Length of shortest string.
  * @alias Blockly.utils.string.shortestStringLength
  */
 export declare function shortestStringLength(array: string[]): number;
 /**
  * Given an array of strings, return the length of the common prefix.
  * Words may not be split.  Any space after a word is included in the length.
+ *
  * @param array Array of strings.
  * @param opt_shortest Length of shortest string.
- * @return Length of common prefix.
+ * @returns Length of common prefix.
  * @alias Blockly.utils.string.commonWordPrefix
  */
 export declare function commonWordPrefix(array: string[], opt_shortest?: number): number;
 /**
  * Given an array of strings, return the length of the common suffix.
  * Words may not be split.  Any space after a word is included in the length.
+ *
  * @param array Array of strings.
  * @param opt_shortest Length of shortest string.
- * @return Length of common suffix.
+ * @returns Length of common suffix.
  * @alias Blockly.utils.string.commonWordSuffix
  */
 export declare function commonWordSuffix(array: string[], opt_shortest?: number): number;
 /**
  * Wrap text to the specified width.
+ *
  * @param text Text to wrap.
  * @param limit Width to wrap each line.
- * @return Wrapped text.
+ * @returns Wrapped text.
  * @alias Blockly.utils.string.wrap
  */
 export declare function wrap(text: string, limit: number): string;
 /**
  * Is the given string a number (includes negative and decimals).
+ *
  * @param str Input string.
- * @return True if number, false otherwise.
+ * @returns True if number, false otherwise.
  * @alias Blockly.utils.string.isNumber
  */
 export declare function isNumber(str: string): boolean;
+//# sourceMappingURL=string.d.ts.map

package/core/utils/style.d.ts

@@ -9,8 +9,9 @@ import { Size } from './size.js';
 /**
  * Gets the height and width of an element.
  * Similar to Closure's goog.style.getSize
+ *
  * @param element Element to get size of.
- * @return Object with width/height properties.
+ * @returns Object with width/height properties.
  * @alias Blockly.utils.style.getSize
  */
 export declare function getSize(element: Element): Size;
@@ -19,16 +20,15 @@ export declare function getSize(element: Element): Size;
  */
 declare function getSizeInternal(element: Element): Size;
 /**
- * Retrieves a computed style value of a node. It returns empty string if the
- * value cannot be computed (which will be the case in Internet Explorer) or
- * "none" if the property requested is an SVG one and it has not been
+ * Retrieves a computed style value of a node. It returns empty string
+ * if the property requested is an SVG one and it has not been
  * explicitly set (firefox and webkit).
  *
  * Copied from Closure's goog.style.getComputedStyle
  *
  * @param element Element to get style of.
  * @param property Property to get (camel-case).
- * @return Style value.
+ * @returns Style value.
  * @alias Blockly.utils.style.getComputedStyle
  */
 export declare function getComputedStyle(element: Element, property: string): string;
@@ -40,53 +40,33 @@ export declare function getComputedStyle(element: Element, property: string): st
  *
  * @param element Element to get style of.
  * @param style Property to get (camel-case).
- * @return Style value.
+ * @returns Style value.
  * @alias Blockly.utils.style.getCascadedStyle
  */
 export declare function getCascadedStyle(element: Element, style: string): string;
 /**
  * Returns a Coordinate object relative to the top-left of the HTML document.
  * Similar to Closure's goog.style.getPageOffset
+ *
  * @param el Element to get the page offset for.
- * @return The page offset.
+ * @returns The page offset.
  * @alias Blockly.utils.style.getPageOffset
  */
 export declare function getPageOffset(el: Element): Coordinate;
 /**
  * Calculates the viewport coordinates relative to the document.
  * Similar to Closure's goog.style.getViewportPageOffset
- * @return The page offset of the viewport.
+ *
+ * @returns The page offset of the viewport.
  * @alias Blockly.utils.style.getViewportPageOffset
  */
 export declare function getViewportPageOffset(): Coordinate;
-/**
- * Shows or hides an element from the page. Hiding the element is done by
- * setting the display property to "none", removing the element from the
- * rendering hierarchy so it takes up no space. To show the element, the default
- * inherited display property is restored (defined either in stylesheets or by
- * the browser's default style rules).
- * Copied from Closure's goog.style.getViewportPageOffset
- *
- * @param el Element to show or hide.
- * @param isShown True to render the element in its default style, false to
- *     disable rendering the element.
- * @alias Blockly.utils.style.setElementShown
- */
-export declare function setElementShown(el: Element, isShown: any): void;
-/**
- * Returns true if the element is using right to left (RTL) direction.
- * Copied from Closure's goog.style.isRightToLeft
- *
- * @param el The element to test.
- * @return True for right to left, false for left to right.
- * @alias Blockly.utils.style.isRightToLeft
- */
-export declare function isRightToLeft(el: Element): boolean;
 /**
  * Gets the computed border widths (on all sides) in pixels
  * Copied from Closure's goog.style.getBorderBox
+ *
  * @param element  The element to get the border widths for.
- * @return The computed border widths.
+ * @returns The computed border widths.
  * @alias Blockly.utils.style.getBorderBox
  */
 export declare function getBorderBox(element: Element): Rect;
@@ -117,7 +97,7 @@ export declare function scrollIntoContainerView(element: Element, container: Ele
  *     scroll element will be used.
  * @param opt_center Whether to center the element in the container.
  *     Defaults to false.
- * @return The new scroll position of the container.
+ * @returns The new scroll position of the container.
  * @alias Blockly.utils.style.getContainerOffsetToScrollInto
  */
 export declare function getContainerOffsetToScrollInto(element: Element, container: Element, opt_center?: boolean): Coordinate;
@@ -125,3 +105,4 @@ export declare const TEST_ONLY: {
     getSizeInternal: typeof getSizeInternal;
 };
 export {};
+//# sourceMappingURL=style.d.ts.map

package/core/utils/svg.d.ts

@@ -5,9 +5,10 @@
  */
 /**
  * A name with the type of the SVG element stored in the generic.
+ *
  * @alias Blockly.utils.Svg
  */
-export declare class Svg<T> {
+export declare class Svg<_T> {
     private readonly tagName;
     /** @internal */
     static ANIMATE: Svg<SVGAnimateElement>;
@@ -62,7 +63,9 @@ export declare class Svg<T> {
     constructor(tagName: string);
     /**
      * Returns the SVG element tag name.
-     * @return The name.
+     *
+     * @returns The name.
      */
     toString(): string;
 }
+//# sourceMappingURL=svg.d.ts.map

package/core/utils/svg_math.d.ts

@@ -10,31 +10,35 @@ import { Size } from './size.js';
 /**
  * Return the coordinates of the top-left corner of this element relative to
  * its parent.  Only for SVG elements and children (e.g. rect, g, path).
+ *
  * @param element SVG element to find the coordinates of.
- * @return Object with .x and .y properties.
+ * @returns Object with .x and .y properties.
  * @alias Blockly.utils.svgMath.getRelativeXY
  */
 export declare function getRelativeXY(element: Element): Coordinate;
 /**
  * Return the coordinates of the top-left corner of this element relative to
  * the div Blockly was injected into.
+ *
  * @param element SVG element to find the coordinates of. If this is not a child
  *     of the div Blockly was injected into, the behaviour is undefined.
- * @return Object with .x and .y properties.
+ * @returns Object with .x and .y properties.
  * @alias Blockly.utils.svgMath.getInjectionDivXY
  */
 export declare function getInjectionDivXY(element: Element): Coordinate;
 /**
  * Check if 3D transforms are supported by adding an element
  * and attempting to set the property.
- * @return True if 3D transforms are supported.
+ *
+ * @returns True if 3D transforms are supported.
  * @alias Blockly.utils.svgMath.is3dSupported
  */
 export declare function is3dSupported(): boolean;
 /**
  * Get the position of the current viewport in window coordinates.  This takes
  * scroll into account.
- * @return An object containing window width, height, and scroll position in
+ *
+ * @returns An object containing window width, height, and scroll position in
  *     window coordinates.
  * @alias Blockly.utils.svgMath.getViewportBBox
  * @internal
@@ -43,23 +47,26 @@ export declare function getViewportBBox(): Rect;
 /**
  * Gets the document scroll distance as a coordinate object.
  * Copied from Closure's goog.dom.getDocumentScroll.
- * @return Object with values 'x' and 'y'.
+ *
+ * @returns Object with values 'x' and 'y'.
  * @alias Blockly.utils.svgMath.getDocumentScroll
  */
 export declare function getDocumentScroll(): Coordinate;
 /**
  * Converts screen coordinates to workspace coordinates.
+ *
  * @param ws The workspace to find the coordinates on.
  * @param screenCoordinates The screen coordinates to be converted to workspace
  *     coordinates
- * @return The workspace coordinates.
+ * @returns The workspace coordinates.
  * @alias Blockly.utils.svgMath.screenToWsCoordinates
  */
 export declare function screenToWsCoordinates(ws: WorkspaceSvg, screenCoordinates: Coordinate): Coordinate;
 /**
  * Returns the dimensions of the specified SVG image.
+ *
  * @param svg SVG image.
- * @return Contains width and height properties.
+ * @returns Contains width and height properties.
  * @deprecated Use workspace.getCachedParentSvgSize. (2021 March 5)
  * @alias Blockly.utils.svgMath.svgSize
  */
@@ -68,3 +75,4 @@ export declare const TEST_ONLY: {
     XY_REGEX: RegExp;
     XY_STYLE_REGEX: RegExp;
 };
+//# sourceMappingURL=svg_math.d.ts.map

package/core/utils/svg_paths.d.ts

@@ -1,15 +1,17 @@
 /**
- * @fileoverview Methods for creating parts of SVG path strings.  See
- * developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
  */
 /**
  * Create a string representing the given x, y pair.  It does not matter whether
  * the coordinate is relative or absolute.  The result has leading
  * and trailing spaces, and separates the x and y coordinates with a comma but
  * no space.
+ *
  * @param x The x coordinate.
  * @param y The y coordinate.
- * @return A string of the format ' x,y '
+ * @returns A string of the format ' x,y '
  * @alias Blockly.utils.svgPaths.point
  */
 export declare function point(x: number, y: number): string;
@@ -17,12 +19,13 @@ export declare function point(x: number, y: number): string;
  * Draw a cubic or quadratic curve.  See
  * developer.mozilla.org/en-US/docs/Web/SVG/Attribute/d#Cubic_B%C3%A9zier_Curve
  * These coordinates are unitless and hence in the user coordinate system.
+ *
  * @param command The command to use.
  *     Should be one of: c, C, s, S, q, Q.
  * @param points  An array containing all of the points to pass to the curve
  *     command, in order.  The points are represented as strings of the format '
  *     x, y '.
- * @return A string defining one or more Bezier curves.  See the MDN
+ * @returns A string defining one or more Bezier curves.  See the MDN
  *     documentation for exact format.
  * @alias Blockly.utils.svgPaths.curve
  */
@@ -32,9 +35,10 @@ export declare function curve(command: string, points: string[]): string;
  * The coordinates are absolute.
  * These coordinates are unitless and hence in the user coordinate system.
  * See developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths#Line_commands
+ *
  * @param x The absolute x coordinate.
  * @param y The absolute y coordinate.
- * @return A string of the format ' M x,y '
+ * @returns A string of the format ' M x,y '
  * @alias Blockly.utils.svgPaths.moveTo
  */
 export declare function moveTo(x: number, y: number): string;
@@ -43,9 +47,10 @@ export declare function moveTo(x: number, y: number): string;
  * Coordinates are relative.
  * These coordinates are unitless and hence in the user coordinate system.
  * See developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths#Line_commands
+ *
  * @param dx The relative x coordinate.
  * @param dy The relative y coordinate.
- * @return A string of the format ' m dx,dy '
+ * @returns A string of the format ' m dx,dy '
  * @alias Blockly.utils.svgPaths.moveBy
  */
 export declare function moveBy(dx: number, dy: number): string;
@@ -54,9 +59,10 @@ export declare function moveBy(dx: number, dy: number): string;
  * point shifted by dx along the x-axis and dy along the y-axis.
  * These coordinates are unitless and hence in the user coordinate system.
  * See developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths#Line_commands
+ *
  * @param dx The relative x coordinate.
  * @param dy The relative y coordinate.
- * @return A string of the format ' l dx,dy '
+ * @returns A string of the format ' l dx,dy '
  * @alias Blockly.utils.svgPaths.lineTo
  */
 export declare function lineTo(dx: number, dy: number): string;
@@ -65,9 +71,10 @@ export declare function lineTo(dx: number, dy: number): string;
  * equivalent to a series of 'l' commands.
  * These coordinates are unitless and hence in the user coordinate system.
  * See developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths#Line_commands
+ *
  * @param points An array containing all of the points to draw lines to, in
  *     order.  The points are represented as strings of the format ' dx,dy '.
- * @return A string of the format ' l (dx,dy)+ '
+ * @returns A string of the format ' l (dx,dy)+ '
  * @alias Blockly.utils.svgPaths.line
  */
 export declare function line(points: string[]): string;
@@ -77,11 +84,12 @@ export declare function line(points: string[]): string;
  * relative or absolute.
  * These coordinates are unitless and hence in the user coordinate system.
  * See developer.mozilla.org/en-US/docs/Web/SVG/Attribute/d#LineTo_path_commands
+ *
  * @param command The command to prepend to the coordinate.  This should be one
  *     of: V, v, H, h.
  * @param val The coordinate to pass to the command.  It may be absolute or
  *     relative.
- * @return A string of the format ' command val '
+ * @returns A string of the format ' command val '
  * @alias Blockly.utils.svgPaths.lineOnAxis
  */
 export declare function lineOnAxis(command: string, val: number): string;
@@ -89,13 +97,15 @@ export declare function lineOnAxis(command: string, val: number): string;
  * Draw an elliptical arc curve.
  * These coordinates are unitless and hence in the user coordinate system.
  * See developer.mozilla.org/en-US/docs/Web/SVG/Attribute/d#Elliptical_Arc_Curve
+ *
  * @param command The command string.  Either 'a' or 'A'.
  * @param flags The flag string.  See the MDN documentation for a description
  *     and examples.
  * @param radius The radius of the arc to draw.
  * @param point The point to move the cursor to after drawing the arc, specified
  *     either in absolute or relative coordinates depending on the command.
- * @return A string of the format 'command radius radius flags point'
+ * @returns A string of the format 'command radius radius flags point'
  * @alias Blockly.utils.svgPaths.arc
  */
 export declare function arc(command: string, flags: string, radius: number, point: string): string;
+//# sourceMappingURL=svg_paths.d.ts.map

package/core/utils/toolbox.d.ts

@@ -9,6 +9,7 @@ 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 {
@@ -38,6 +39,7 @@ export interface BlockInfo {
 }
 /**
  * The information needed to create a separator in the toolbox.
+ *
  * @alias Blockly.utils.toolbox.SeparatorInfo
  */
 export interface SeparatorInfo {
@@ -48,6 +50,7 @@ export interface SeparatorInfo {
 }
 /**
  * The information needed to create a button in the toolbox.
+ *
  * @alias Blockly.utils.toolbox.ButtonInfo
  */
 export interface ButtonInfo {
@@ -57,6 +60,7 @@ export interface ButtonInfo {
 }
 /**
  * The information needed to create a label in the toolbox.
+ *
  * @alias Blockly.utils.toolbox.LabelInfo
  */
 export interface LabelInfo {
@@ -66,11 +70,13 @@ export interface LabelInfo {
 }
 /**
  * The information needed to create either a button or a label in the flyout.
+ *
  * @alias Blockly.utils.toolbox.ButtonOrLabelInfo
  */
 export declare type ButtonOrLabelInfo = ButtonInfo | LabelInfo;
 /**
  * The information needed to create a category in the toolbox.
+ *
  * @alias Blockly.utils.toolbox.StaticCategoryInfo
  */
 export interface StaticCategoryInfo {
@@ -85,6 +91,7 @@ export interface StaticCategoryInfo {
 }
 /**
  * The information needed to create a custom category.
+ *
  * @alias Blockly.utils.toolbox.DynamicCategoryInfo
  */
 export interface DynamicCategoryInfo {
@@ -98,21 +105,25 @@ export interface DynamicCategoryInfo {
 }
 /**
  * The information needed to create either a dynamic or static category.
+ *
  * @alias Blockly.utils.toolbox.CategoryInfo
  */
 export declare type CategoryInfo = StaticCategoryInfo | DynamicCategoryInfo;
 /**
  * Any information that can be used to create an item in the toolbox.
+ *
  * @alias Blockly.utils.toolbox.ToolboxItemInfo
  */
 export declare type ToolboxItemInfo = FlyoutItemInfo | StaticCategoryInfo;
 /**
  * All the different types that can be displayed in a flyout.
+ *
  * @alias Blockly.utils.toolbox.FlyoutItemInfo
  */
 export declare type FlyoutItemInfo = BlockInfo | SeparatorInfo | ButtonInfo | LabelInfo | DynamicCategoryInfo;
 /**
  * The JSON definition of a toolbox.
+ *
  * @alias Blockly.utils.toolbox.ToolboxInfo
  */
 export interface ToolboxInfo {
@@ -121,21 +132,25 @@ export interface ToolboxInfo {
 }
 /**
  * An array holding flyout items.
+ *
  * @alias Blockly.utils.toolbox.FlyoutItemInfoArray
  */
 export declare type FlyoutItemInfoArray = FlyoutItemInfo[];
 /**
  * All of the different types that can create a toolbox.
+ *
  * @alias Blockly.utils.toolbox.ToolboxDefinition
  */
 export declare 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 declare 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 {
@@ -146,24 +161,27 @@ export declare enum Position {
 }
 /**
  * Converts the toolbox definition into toolbox JSON.
+ *
  * @param toolboxDef The definition of the toolbox in one of its many forms.
- * @return Object holding information for creating a toolbox.
+ * @returns Object holding information for creating a toolbox.
  * @alias Blockly.utils.toolbox.convertToolboxDefToJson
  * @internal
  */
 export declare function convertToolboxDefToJson(toolboxDef: ToolboxDefinition | null): ToolboxInfo | null;
 /**
  * Converts the flyout definition into a list of flyout items.
+ *
  * @param flyoutDef The definition of the flyout in one of its many forms.
- * @return A list of flyout items.
+ * @returns A list of flyout items.
  * @alias Blockly.utils.toolbox.convertFlyoutDefToJsonArray
  * @internal
  */
 export declare function convertFlyoutDefToJsonArray(flyoutDef: FlyoutDefinition | null): FlyoutItemInfoArray;
 /**
  * Whether or not the toolbox definition has categories.
+ *
  * @param toolboxJson Object holding information for creating a toolbox.
- * @return True if the toolbox has categories.
+ * @returns True if the toolbox has categories.
  * @alias Blockly.utils.toolbox.hasCategories
  * @internal
  */
@@ -174,16 +192,18 @@ export declare function hasCategories(toolboxJson: ToolboxInfo | null): boolean;
 declare function hasCategoriesInternal(toolboxJson: ToolboxInfo | null): boolean;
 /**
  * Whether or not the category is collapsible.
+ *
  * @param categoryInfo Object holing information for creating a category.
- * @return True if the category has subcategories.
+ * @returns True if the category has subcategories.
  * @alias Blockly.utils.toolbox.isCategoryCollapsible
  * @internal
  */
 export declare function isCategoryCollapsible(categoryInfo: CategoryInfo): boolean;
 /**
  * Parse the provided toolbox tree into a consistent DOM format.
+ *
  * @param toolboxDef DOM tree of blocks, or text representation of same.
- * @return DOM tree of blocks, or null.
+ * @returns DOM tree of blocks, or null.
  * @alias Blockly.utils.toolbox.parseToolboxTree
  */
 export declare function parseToolboxTree(toolboxDef: Element | null | string): Element | null;
@@ -191,3 +211,4 @@ export declare const TEST_ONLY: {
     hasCategoriesInternal: typeof hasCategoriesInternal;
 };
 export {};
+//# sourceMappingURL=toolbox.d.ts.map

package/core/utils/useragent.d.ts

@@ -5,29 +5,18 @@
  */
 /** @alias Blockly.utils.userAgent.raw */
 export declare const raw: string;
-/** @alias Blockly.utils.userAgent.IE */
-export declare const IE: boolean;
-/** @alias Blockly.utils.userAgent.EDGE */
-export declare const EDGE: boolean;
 /** @alias Blockly.utils.userAgent.JavaFx */
 export declare const JavaFx: boolean;
-/** @alias Blockly.utils.userAgent.CHROME */
-export declare const CHROME: boolean;
-/** @alias Blockly.utils.userAgent.WEBKIT */
-export declare const WEBKIT: 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.IPOD */
-export declare const IPOD: 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.TABLET */
-export declare const TABLET: boolean;
 /** @alias Blockly.utils.userAgent.MOBILE */
 export declare const MOBILE: boolean;
+//# sourceMappingURL=useragent.d.ts.map

package/core/utils/xml.d.ts

@@ -5,39 +5,45 @@
  */
 /**
  * Namespace for Blockly's XML.
+ *
  * @alias Blockly.utils.xml.NAME_SPACE
  */
 export declare const NAME_SPACE = "https://developers.google.com/blockly/xml";
 /**
  * Get the document object to use for XML serialization.
- * @return The document object.
+ *
+ * @returns The document object.
  * @alias Blockly.utils.xml.getDocument
  */
 export declare function getDocument(): Document;
 /**
  * Get the document object to use for XML serialization.
+ *
  * @param document The document object to use.
  * @alias Blockly.utils.xml.setDocument
  */
 export declare function setDocument(document: Document): void;
 /**
  * Create DOM element for XML.
+ *
  * @param tagName Name of DOM element.
- * @return New DOM element.
+ * @returns New DOM element.
  * @alias Blockly.utils.xml.createElement
  */
 export declare function createElement(tagName: string): Element;
 /**
  * Create text element for XML.
+ *
  * @param text Text content.
- * @return New DOM text node.
+ * @returns New DOM text node.
  * @alias Blockly.utils.xml.createTextNode
  */
 export declare function createTextNode(text: string): Text;
 /**
  * Converts an XML string into a DOM tree.
+ *
  * @param text XML string.
- * @return The DOM document.
+ * @returns The DOM document.
  * @throws if XML doesn't parse.
  * @alias Blockly.utils.xml.textToDomDocument
  */
@@ -45,8 +51,10 @@ export declare function textToDomDocument(text: string): Document;
 /**
  * Converts a DOM structure into plain text.
  * Currently the text format is fairly ugly: all one line with no whitespace.
+ *
  * @param dom A tree of XML nodes.
- * @return Text representation.
+ * @returns Text representation.
  * @alias Blockly.utils.xml.domToText
  */
 export declare function domToText(dom: Node): string;
+//# sourceMappingURL=xml.d.ts.map