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

package/core/utils/useragent.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * 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

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2018 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * 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.
+ *
+ * @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.
+ * @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.
+ * @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.
+ * @returns The DOM document.
+ * @throws if XML doesn't parse.
+ * @alias Blockly.utils.xml.textToDomDocument
+ */
+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.
+ * @returns Text representation.
+ * @alias Blockly.utils.xml.domToText
+ */
+export declare function domToText(dom: Node): string;
+//# sourceMappingURL=xml.d.ts.map

package/core/utils.d.ts

@@ -0,0 +1,239 @@
+/**
+ * @license
+ * Copyright 2012 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Block } from './block.js';
+import * as browserEvents from './browser_events.js';
+import * as extensions from './extensions.js';
+import * as aria from './utils/aria.js';
+import * as arrayUtils from './utils/array.js';
+import * as colour from './utils/colour.js';
+import { Coordinate } from './utils/coordinate.js';
+import * as deprecation from './utils/deprecation.js';
+import * as dom from './utils/dom.js';
+import * as idGenerator from './utils/idgenerator.js';
+import { KeyCodes } from './utils/keycodes.js';
+import * as math from './utils/math.js';
+import type { Metrics } from './utils/metrics.js';
+import * as object from './utils/object.js';
+import * as parsing from './utils/parsing.js';
+import { Rect } from './utils/rect.js';
+import { Size } from './utils/size.js';
+import * as stringUtils from './utils/string.js';
+import * as style from './utils/style.js';
+import { Svg } from './utils/svg.js';
+import * as svgMath from './utils/svg_math.js';
+import * as svgPaths from './utils/svg_paths.js';
+import * as toolbox from './utils/toolbox.js';
+import * as userAgent from './utils/useragent.js';
+import * as xml from './utils/xml.js';
+import type { WorkspaceSvg } from './workspace_svg.js';
+export { aria, arrayUtils as array, browserEvents, colour, Coordinate, deprecation, dom, extensions, idGenerator, KeyCodes, math, Metrics, object, parsing, Rect, Size, stringUtils as string, style, Svg, svgMath, svgPaths, toolbox, userAgent, xml, };
+/**
+ * Halts the propagation of the event without doing anything else.
+ *
+ * @param e An event.
+ * @deprecated
+ * @alias Blockly.utils.noEvent
+ */
+export declare function noEvent(e: Event): void;
+/**
+ * Returns true if this event is targeting a text input widget?
+ *
+ * @param e An event.
+ * @returns True if text input.
+ * @deprecated Use Blockly.browserEvents.isTargetInput instead.
+ * @alias Blockly.utils.isTargetInput
+ */
+export declare function isTargetInput(e: Event): boolean;
+/**
+ * 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.
+ * @returns Object with .x and .y properties.
+ * @deprecated
+ * @alias Blockly.utils.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.
+ * @returns Object with .x and .y properties.
+ * @deprecated
+ * @alias Blockly.utils.getInjectionDivXY_
+ */
+declare function getInjectionDivXY(element: Element): Coordinate;
+export declare const getInjectionDivXY_: typeof getInjectionDivXY;
+/**
+ * Returns true this event is a right-click.
+ *
+ * @param e Mouse event.
+ * @returns True if right-click.
+ * @deprecated Use Blockly.browserEvents.isRightButton instead.
+ * @alias Blockly.utils.isRightButton
+ */
+export declare function isRightButton(e: Event): boolean;
+/**
+ * Returns the converted coordinates of the given mouse event.
+ * The origin (0,0) is the top-left corner of the Blockly SVG.
+ *
+ * @param e Mouse event.
+ * @param svg SVG element.
+ * @param matrix Inverted screen CTM to use.
+ * @returns Object with .x and .y properties.
+ * @deprecated Use Blockly.browserEvents.mouseToSvg instead;
+ * @alias Blockly.utils.mouseToSvg
+ */
+export declare function mouseToSvg(e: Event, svg: SVGSVGElement, matrix: SVGMatrix | null): SVGPoint;
+/**
+ * Returns the scroll delta of a mouse event in pixel units.
+ *
+ * @param e Mouse event.
+ * @returns Scroll delta object with .x and .y properties.
+ * @deprecated Use Blockly.browserEvents.getScrollDeltaPixels instead.
+ * @alias Blockly.utils.getScrollDeltaPixels
+ */
+export declare function getScrollDeltaPixels(e: WheelEvent): {
+    x: number;
+    y: number;
+};
+/**
+ * Parse a string with any number of interpolation tokens (%1, %2, ...).
+ * It will also replace string table references (e.g., %{bky_my_msg} and
+ * %{BKY_MY_MSG} will both be replaced with the value in
+ * Msg['MY_MSG']). Percentage sign characters '%' may be self-escaped
+ * (e.g., '%%').
+ *
+ * @param message Text which might contain string table references and
+ *     interpolation tokens.
+ * @returns Array of strings and numbers.
+ * @deprecated
+ * @alias Blockly.utils.tokenizeInterpolation
+ */
+export declare function tokenizeInterpolation(message: string): Array<string | number>;
+/**
+ * Replaces string table references in a message, if the message is a string.
+ * For example, "%{bky_my_msg}" and "%{BKY_MY_MSG}" will both be replaced with
+ * the value in Msg['MY_MSG'].
+ *
+ * @param message Message, which may be a string that contains string table
+ *     references.
+ * @returns String with message references replaced.
+ * @deprecated
+ * @alias Blockly.utils.replaceMessageReferences
+ */
+export declare function replaceMessageReferences(message: string | any): string;
+/**
+ * Validates that any %{MSG_KEY} references in the message refer to keys of
+ * the Msg string table.
+ *
+ * @param message Text which might contain string table references.
+ * @returns True if all message references have matching values.
+ *     Otherwise, false.
+ * @deprecated
+ * @alias Blockly.utils.checkMessageReferences
+ */
+export declare function checkMessageReferences(message: string): boolean;
+/**
+ * Generate a unique ID.
+ *
+ * @returns A globally unique ID string.
+ * @deprecated Use Blockly.utils.idGenerator.genUid instead.
+ * @alias Blockly.utils.genUid
+ */
+export declare function genUid(): string;
+/**
+ * Check if 3D transforms are supported by adding an element
+ * and attempting to set the property.
+ *
+ * @returns True if 3D transforms are supported.
+ * @deprecated
+ * @alias Blockly.utils.is3dSupported
+ */
+export declare function is3dSupported(): boolean;
+/**
+ * Get the position of the current viewport in window coordinates.  This takes
+ * scroll into account.
+ *
+ * @returns An object containing window width, height, and scroll position in
+ *     window coordinates.
+ * @alias Blockly.utils.getViewportBBox
+ * @deprecated
+ * @internal
+ */
+export declare function getViewportBBox(): Rect;
+/**
+ * Removes the first occurrence of a particular value from an array.
+ *
+ * @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
+ * @internal
+ */
+export declare function arrayRemove<T>(arr: Array<T>, value: T): boolean;
+/**
+ * Gets the document scroll distance as a coordinate object.
+ * Copied from Closure's goog.dom.getDocumentScroll.
+ *
+ * @returns Object with values 'x' and 'y'.
+ * @deprecated
+ * @alias Blockly.utils.getDocumentScroll
+ */
+export declare function getDocumentScroll(): Coordinate;
+/**
+ * Get a map of all the block's descendants mapping their type to the number of
+ *    children with that type.
+ *
+ * @param block The block to map.
+ * @param opt_stripFollowing Optionally ignore all following statements (blocks
+ *     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
+ * @alias Blockly.utils.getBlockTypeCounts
+ */
+export declare function getBlockTypeCounts(block: Block, opt_stripFollowing?: boolean): {
+    [key: string]: number;
+};
+/**
+ * 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
+ * @deprecated
+ * @returns The workspace coordinates.
+ */
+export declare function screenToWsCoordinates(ws: WorkspaceSvg, screenCoordinates: Coordinate): Coordinate;
+/**
+ * Parse a block colour from a number or string, as provided in a block
+ * definition.
+ *
+ * @param colour HSV hue value (0 to 360), #RRGGBB string, or a message
+ *     reference string pointing to one of those two values.
+ * @returns An object containing the colour as a #RRGGBB string, and the hue if
+ *     the input was an HSV hue value.
+ * @throws {Error} If the colour cannot be parsed.
+ * @deprecated
+ * @alias Blockly.utils.parseBlockColour
+ */
+export declare function parseBlockColour(colour: number | string): {
+    hue: number | null;
+    hex: string;
+};
+/**
+ * Calls a function after the page has loaded, possibly immediately.
+ *
+ * @param fn Function to run.
+ * @throws Error Will throw if no global document can be found (e.g., Node.js).
+ * @deprecated
+ * @alias Blockly.utils.runAfterPageLoad
+ */
+export declare function runAfterPageLoad(fn: () => void): void;
+//# sourceMappingURL=utils.d.ts.map

package/core/variable_map.d.ts

@@ -0,0 +1,158 @@
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import './events/events_var_delete.js';
+import './events/events_var_rename.js';
+import type { Block } from './block.js';
+import { VariableModel } from './variable_model.js';
+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;
+    /**
+     * A map from variable type to list of variable names.  The lists contain
+     * all of the named variables in the workspace, including variables that are
+     * not currently in use.
+     */
+    private variableMap;
+    /** @param workspace The workspace this map belongs to. */
+    constructor(workspace: Workspace);
+    /** Clear the variable map. */
+    clear(): void;
+    /**
+     * Rename the given variable by updating its name in the variable map.
+     *
+     * @param variable Variable to rename.
+     * @param newName New variable name.
+     * @internal
+     */
+    renameVariable(variable: VariableModel, newName: string): void;
+    /**
+     * Rename a variable by updating its name in the variable map. Identify the
+     * variable to rename with the given ID.
+     *
+     * @param id ID of the variable to rename.
+     * @param newName New variable name.
+     */
+    renameVariableById(id: string, newName: string): void;
+    /**
+     * Update the name of the given variable and refresh all references to it.
+     * The new name must not conflict with any existing variable names.
+     *
+     * @param variable Variable to rename.
+     * @param newName New variable name.
+     * @param blocks The list of all blocks in the workspace.
+     */
+    private renameVariableAndUses_;
+    /**
+     * Update the name of the given variable to the same name as an existing
+     * variable.  The two variables are coalesced into a single variable with the
+     * ID of the existing variable that was already using newName. Refresh all
+     * references to the variable.
+     *
+     * @param variable Variable to rename.
+     * @param newName New variable name.
+     * @param conflictVar The variable that was already using newName.
+     * @param blocks The list of all blocks in the workspace.
+     */
+    private renameVariableWithConflict_;
+    /**
+     * Create a variable with a given name, optional type, and optional ID.
+     *
+     * @param name The name of the variable. This must be unique across variables
+     *     and procedures.
+     * @param opt_type The type of the variable like 'int' or 'string'.
+     *     Does not need to be unique. Field_variable can filter variables based
+     * on their type. This will default to '' which is a specific type.
+     * @param opt_id The unique ID of the variable. This will default to a UUID.
+     * @returns The newly created variable.
+     */
+    createVariable(name: string, opt_type?: string | null, opt_id?: string | null): VariableModel;
+    /**
+     * Delete a variable.
+     *
+     * @param variable Variable to delete.
+     */
+    deleteVariable(variable: VariableModel): void;
+    /**
+     * Delete a variables by the passed in ID and all of its uses from this
+     * workspace. May prompt the user for confirmation.
+     *
+     * @param id ID of variable to delete.
+     */
+    deleteVariableById(id: string): void;
+    /**
+     * Deletes a variable and all of its uses from this workspace without asking
+     * the user for confirmation.
+     *
+     * @param variable Variable to delete.
+     * @param uses An array of uses of the variable.
+     * @internal
+     */
+    deleteVariableInternal(variable: VariableModel, uses: Block[]): void;
+    /**
+     * Find the variable by the given name and type and return it.  Return null if
+     *     it is not found.
+     *
+     * @param name The name to check for.
+     * @param opt_type The type of the variable.  If not provided it defaults to
+     *     the empty string, which is a specific type.
+     * @returns The variable with the given name, or null if it was not found.
+     */
+    getVariable(name: string, opt_type?: string | null): VariableModel | null;
+    /**
+     * Find the variable by the given ID and return it.  Return null if not found.
+     *
+     * @param id The ID to check for.
+     * @returns The variable with the given ID.
+     */
+    getVariableById(id: string): VariableModel | null;
+    /**
+     * Get a list containing all of the variables of a specified type. If type is
+     *     null, return list of variables with empty string type.
+     *
+     * @param type Type of the variables to find.
+     * @returns The sought after variables of the passed in type. An empty array
+     *     if none are found.
+     */
+    getVariablesOfType(type: string | null): VariableModel[];
+    /**
+     * Return all variable and potential variable types.  This list always
+     * contains the empty string.
+     *
+     * @param ws The workspace used to look for potential variables. This can be
+     *     different than the workspace stored on this object if the passed in ws
+     *     is a flyout workspace.
+     * @returns List of variable types.
+     * @internal
+     */
+    getVariableTypes(ws: Workspace | null): string[];
+    /**
+     * Return all variables of all types.
+     *
+     * @returns List of variable models.
+     */
+    getAllVariables(): VariableModel[];
+    /**
+     * Returns all of the variable names of all types.
+     *
+     * @returns All of the variable names of all types.
+     */
+    getAllVariableNames(): string[];
+    /**
+     * Find all the uses of a named variable.
+     *
+     * @param id ID of the variable to find.
+     * @returns Array of block usages.
+     */
+    getVariableUsesById(id: string): Block[];
+}
+//# sourceMappingURL=variable_map.d.ts.map

package/core/variable_model.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import './events/events_var_create.js';
+import type { Workspace } from './workspace.js';
+/**
+ * Class for a variable model.
+ * Holds information for the variable including name, ID, and type.
+ *
+ * @see {Blockly.FieldVariable}
+ * @alias Blockly.VariableModel
+ */
+export declare class VariableModel {
+    workspace: Workspace;
+    name: string;
+    type: string;
+    private readonly id_;
+    /**
+     * @param workspace The variable's workspace.
+     * @param name The name of the variable.  This is the user-visible name (e.g.
+     *     'my var' or '私の変数'), not the generated name.
+     * @param opt_type The type of the variable like 'int' or 'string'.
+     *     Does not need to be unique. Field_variable can filter variables based
+     * on their type. This will default to '' which is a specific type.
+     * @param opt_id The unique ID of the variable. This will default to a UUID.
+     */
+    constructor(workspace: Workspace, name: string, opt_type?: string, opt_id?: string);
+    /** @returns The ID for the variable. */
+    getId(): string;
+    /**
+     * A custom compare function for the VariableModel objects.
+     *
+     * @param var1 First variable to compare.
+     * @param var2 Second variable to compare.
+     * @returns -1 if name of var1 is less than name of var2, 0 if equal, and 1 if
+     *     greater.
+     * @internal
+     */
+    static compareByName(var1: VariableModel, var2: VariableModel): number;
+}
+//# sourceMappingURL=variable_model.d.ts.map