blockly 12.4.0 → 12.5.0

package/core/block.d.ts

@@ -0,0 +1,1006 @@
+/**
+ * @license
+ * Copyright 2011 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * The class representing one block.
+ *
+ * @class
+ */
+import './events/events_block_change.js';
+import './events/events_block_create.js';
+import './events/events_block_delete.js';
+import { Connection } from './connection.js';
+import { ConnectionType } from './connection_type.js';
+import type { Abstract } from './events/events_abstract.js';
+import type { Field } from './field.js';
+import { IconType } from './icons/icon_types.js';
+import type { MutatorIcon } from './icons/mutator_icon.js';
+import { Input } from './inputs/input.js';
+import { type IIcon } from './interfaces/i_icon.js';
+import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
+import * as Tooltip from './tooltip.js';
+import { Coordinate } from './utils/coordinate.js';
+import { Size } from './utils/size.js';
+import type { Workspace } from './workspace.js';
+/**
+ * Class for one block.
+ * Not normally called directly, workspace.newBlock() is preferred.
+ */
+export declare class Block {
+    /**
+     * An optional callback method to use whenever the block's parent workspace
+     * changes. This is usually only called from the constructor, the block type
+     * initializer function, or an extension initializer function.
+     */
+    onchange?: ((p1: Abstract) => void) | null;
+    /** The language-neutral ID given to the collapsed input. */
+    static readonly COLLAPSED_INPUT_NAME: string;
+    /** The language-neutral ID given to the collapsed field. */
+    static readonly COLLAPSED_FIELD_NAME: string;
+    /**
+     * Optional text data that round-trips between blocks and XML.
+     * Has no effect. May be used by 3rd parties for meta information.
+     */
+    data: string | null;
+    /**
+     * Has this block been disposed of?
+     *
+     * @internal
+     */
+    disposed: boolean;
+    /**
+     * Colour of the block as HSV hue value (0-360)
+     * This may be null if the block colour was not set via a hue number.
+     */
+    private hue;
+    /** Colour of the block in '#RRGGBB' format. */
+    protected colour_: string;
+    /** Name of the block style. */
+    protected styleName_: string;
+    /** An optional method called during initialization. */
+    init?: () => void;
+    /** An optional method called during disposal. */
+    destroy?: () => void;
+    /**
+     * An optional serialization method for defining how to serialize the
+     * mutation state to XML. This must be coupled with defining
+     * `domToMutation`.
+     */
+    mutationToDom?: (...p1: any[]) => Element;
+    /**
+     * An optional deserialization method for defining how to deserialize the
+     * mutation state from XML. This must be coupled with defining
+     * `mutationToDom`.
+     */
+    domToMutation?: (p1: Element) => void;
+    /**
+     * An optional serialization method for defining how to serialize the
+     * block's extra state (eg mutation state) to something JSON compatible.
+     * This must be coupled with defining `loadExtraState`.
+     *
+     * @param doFullSerialization Whether or not to serialize the full state of
+     *     the extra state (rather than possibly saving a reference to some
+     *     state). This is used during copy-paste. See the
+     *     {@link https://developers.devsite.google.com/blockly/guides/create-custom-blocks/extensions#full_serialization_and_backing_data | block serialization docs}
+     *     for more information.
+     */
+    saveExtraState?: (doFullSerialization?: boolean) => any;
+    /**
+     * An optional serialization method for defining how to deserialize the
+     * block's extra state (eg mutation state) from something JSON compatible.
+     * This must be coupled with defining `saveExtraState`.
+     */
+    loadExtraState?: (p1: any) => void;
+    /**
+     * An optional property for suppressing adding STATEMENT_PREFIX and
+     * STATEMENT_SUFFIX to generated code.
+     */
+    suppressPrefixSuffix: boolean | null;
+    /**
+     * An optional method for declaring developer variables, to be used
+     * by generators.  Developer variables are never shown to the user,
+     * but are declared as global variables in the generated code.
+     *
+     * @returns a list of developer variable names.
+     */
+    getDeveloperVariables?: () => string[];
+    /**
+     * An optional method that reconfigures the block based on the
+     * contents of the mutator dialog.
+     *
+     * @param rootBlock The root block in the mutator flyout.
+     */
+    compose?: (rootBlock: Block) => void;
+    /**
+     * An optional function that populates the mutator flyout with
+     * blocks representing this block's configuration.
+     *
+     * @param workspace The mutator flyout's workspace.
+     * @returns The root block created in the flyout's workspace.
+     */
+    decompose?: (workspace: Workspace) => Block;
+    id: string;
+    outputConnection: Connection | null;
+    nextConnection: Connection | null;
+    previousConnection: Connection | null;
+    inputList: Input[];
+    inputsInline?: boolean;
+    icons: IIcon[];
+    private disabledReasons;
+    tooltip: Tooltip.TipInfo;
+    contextMenu: boolean;
+    protected parentBlock_: this | null;
+    protected childBlocks_: this[];
+    private deletable;
+    private movable;
+    private editable;
+    private shadow;
+    protected collapsed_: boolean;
+    protected outputShape_: number | null;
+    /**
+     * Is the current block currently in the process of being disposed?
+     */
+    protected disposing: boolean;
+    /**
+     * Has this block been fully initialized? E.g. all fields initailized.
+     *
+     * @internal
+     */
+    initialized: boolean;
+    private readonly xy;
+    isInFlyout: boolean;
+    isInMutator: boolean;
+    RTL: boolean;
+    /** True if this block is an insertion marker. */
+    protected isInsertionMarker_: boolean;
+    /** Name of the type of hat. */
+    hat?: string;
+    /** Is this block a BlockSVG? */
+    readonly rendered: boolean;
+    /**
+     * String for block help, or function that returns a URL. Null for no help.
+     */
+    helpUrl: string | (() => string) | null;
+    /** A bound callback function to use when the parent workspace changes. */
+    private onchangeWrapper;
+    /**
+     * A count of statement inputs on the block.
+     *
+     * @internal
+     */
+    statementInputCount: number;
+    type: string;
+    inputsInlineDefault?: boolean;
+    workspace: Workspace;
+    /**
+     * @param workspace The block's workspace.
+     * @param prototypeName Name of the language object containing type-specific
+     *     functions for this block.
+     * @param opt_id Optional ID.  Use this ID if provided, otherwise create a new
+     *     ID.
+     * @throws When the prototypeName is not valid or not allowed.
+     */
+    constructor(workspace: Workspace, prototypeName: string, opt_id?: string);
+    /** Calls the init() function and handles associated event firing, etc. */
+    protected doInit_(): void;
+    /**
+     * Dispose of this block.
+     *
+     * @param healStack If true, then try to heal any gap by connecting the next
+     *     statement with the previous statement.  Otherwise, dispose of all
+     *     children of this block.
+     */
+    dispose(healStack?: boolean): void;
+    /**
+     * Disposes of this block without doing things required by the top block.
+     * E.g. does not fire events, unplug the block, etc.
+     */
+    protected disposeInternal(): void;
+    /**
+     * Returns true if the block is either in the process of being disposed, or
+     * is disposed.
+     *
+     * @internal
+     */
+    isDeadOrDying(): boolean;
+    /**
+     * Call initModel on all fields on the block.
+     * May be called more than once.
+     * Either initModel or initSvg must be called after creating a block and
+     * before the first interaction with it.  Interactions include UI actions
+     * (e.g. clicking and dragging) and firing events (e.g. create, delete, and
+     * change).
+     */
+    initModel(): void;
+    /**
+     * Unplug this block from its superior block.  If this block is a statement,
+     * optionally reconnect the block underneath with the block on top.
+     *
+     * @param opt_healStack Disconnect child statement and reconnect stack.
+     *     Defaults to false.
+     */
+    unplug(opt_healStack?: boolean): void;
+    /**
+     * Unplug this block's output from an input on another block.  Optionally
+     * reconnect the block's parent to the only child block, if possible.
+     *
+     * @param opt_healStack Disconnect right-side block and connect to left-side
+     *     block.  Defaults to false.
+     */
+    private unplugFromRow;
+    /**
+     * Returns the connection on the value input that is connected to another
+     * block. When an insertion marker is connected to a connection with a block
+     * already attached, the connected block is attached to the insertion marker.
+     * Since only one block can be displaced and attached to the insertion marker
+     * this should only ever return one connection.
+     *
+     * @returns The connection on the value input, or null.
+     */
+    private getOnlyValueConnection;
+    /**
+     * Unplug this statement block from its superior block.  Optionally reconnect
+     * the block underneath with the block on top.
+     *
+     * @param opt_healStack Disconnect child statement and reconnect stack.
+     *     Defaults to false.
+     */
+    private unplugFromStack;
+    /**
+     * Returns all connections originating from this block.
+     *
+     * @param _all If true, return all connections even hidden ones.
+     * @returns Array of connections.
+     * @internal
+     */
+    getConnections_(_all: boolean): Connection[];
+    /**
+     * Walks down a stack of blocks and finds the last next connection on the
+     * stack.
+     *
+     * @param ignoreShadows If true,the last connection on a non-shadow block will
+     *     be returned. If false, this will follow shadows to find the last
+     *     connection.
+     * @returns The last next connection on the stack, or null.
+     * @internal
+     */
+    lastConnectionInStack(ignoreShadows: boolean): Connection | null;
+    /**
+     * Bump unconnected blocks out of alignment.  Two blocks which aren't actually
+     * connected should not coincidentally line up on screen.
+     */
+    bumpNeighbours(): void;
+    /**
+     * Return the parent block or null if this block is at the top level. The
+     * parent block is either the block connected to the previous connection (for
+     * a statement block) or the block connected to the output connection (for a
+     * value block).
+     *
+     * @returns The block (if any) that holds the current block.
+     */
+    getParent(): this | null;
+    /**
+     * Return the input that connects to the specified block.
+     *
+     * @param block A block connected to an input on this block.
+     * @returns The input (if any) that connects to the specified block.
+     */
+    getInputWithBlock(block: Block): Input | null;
+    /**
+     * Return the parent block that surrounds the current block, or null if this
+     * block has no surrounding block.  A parent block might just be the previous
+     * statement, whereas the surrounding block is an if statement, while loop,
+     * etc.
+     *
+     * @returns The block (if any) that surrounds the current block.
+     */
+    getSurroundParent(): this | null;
+    /**
+     * Return the next statement block directly connected to this block.
+     *
+     * @returns The next statement block or null.
+     */
+    getNextBlock(): Block | null;
+    /**
+     * Returns the block connected to the previous connection.
+     *
+     * @returns The previous statement block or null.
+     */
+    getPreviousBlock(): Block | null;
+    /**
+     * Return the top-most block in this block's tree.
+     * This will return itself if this block is at the top level.
+     *
+     * @returns The root block.
+     */
+    getRootBlock(): this;
+    /**
+     * Walk up from the given block up through the stack of blocks to find
+     * the top block of the sub stack. If we are nested in a statement input only
+     * find the top-most nested block. Do not go all the way to the root block.
+     *
+     * @returns The top block in a stack.
+     * @internal
+     */
+    getTopStackBlock(): this;
+    /**
+     * Find all the blocks that are directly nested inside this one.
+     * Includes value and statement inputs, as well as any following statement.
+     * Excludes any connection on an output tab or any preceding statement.
+     * Blocks are optionally sorted by position; top to bottom.
+     *
+     * @param ordered Sort the list if true.
+     * @returns Array of blocks.
+     */
+    getChildren(ordered: boolean): Block[];
+    /**
+     * Set parent of this block to be a new block or null.
+     *
+     * @param newParent New parent block.
+     * @internal
+     */
+    setParent(newParent: this | null): void;
+    /**
+     * Find all the blocks that are directly or indirectly nested inside this one.
+     * Includes this block in the list.
+     * Includes value and statement inputs, as well as any following statements.
+     * Excludes any connection on an output tab or any preceding statements.
+     * Blocks are optionally sorted by position; top to bottom.
+     *
+     * @param ordered Sort the list if true.
+     * @returns Flattened array of blocks.
+     */
+    getDescendants(ordered: boolean): this[];
+    /**
+     * Get whether this block is deletable or not.
+     *
+     * @returns True if deletable.
+     */
+    isDeletable(): boolean;
+    /**
+     * Return whether this block's own deletable property is true or false.
+     *
+     * @returns True if the block's deletable property is true, false otherwise.
+     */
+    isOwnDeletable(): boolean;
+    /**
+     * Set whether this block is deletable or not.
+     *
+     * @param deletable True if deletable.
+     */
+    setDeletable(deletable: boolean): void;
+    /**
+     * Get whether this block is movable or not.
+     *
+     * @returns True if movable.
+     * @internal
+     */
+    isMovable(): boolean;
+    /**
+     * Return whether this block's own movable property is true or false.
+     *
+     * @returns True if the block's movable property is true, false otherwise.
+     * @internal
+     */
+    isOwnMovable(): boolean;
+    /**
+     * Set whether this block is movable or not.
+     *
+     * @param movable True if movable.
+     */
+    setMovable(movable: boolean): void;
+    /**
+     * Get whether is block is duplicatable or not. If duplicating this block and
+     * descendants will put this block over the workspace's capacity this block is
+     * not duplicatable. If duplicating this block and descendants will put any
+     * type over their maxInstances this block is not duplicatable.
+     *
+     * @returns True if duplicatable.
+     */
+    isDuplicatable(): boolean;
+    /**
+     * Get whether this block is a shadow block or not.
+     *
+     * @returns True if a shadow.
+     */
+    isShadow(): boolean;
+    /**
+     * Set whether this block is a shadow block or not.
+     * This method is internal and should not be called by users of Blockly. To
+     * create shadow blocks programmatically call connection.setShadowState
+     *
+     * @param shadow True if a shadow.
+     * @internal
+     */
+    setShadow(shadow: boolean): void;
+    /**
+     * Get whether this block is an insertion marker block or not.
+     *
+     * @returns True if an insertion marker.
+     */
+    isInsertionMarker(): boolean;
+    /**
+     * Set whether this block is an insertion marker block or not.
+     * Once set this cannot be unset.
+     *
+     * @param insertionMarker True if an insertion marker.
+     * @internal
+     */
+    setInsertionMarker(insertionMarker: boolean): void;
+    /**
+     * Get whether this block is editable or not.
+     *
+     * @returns True if editable.
+     * @internal
+     */
+    isEditable(): boolean;
+    /**
+     * Return whether this block's own editable property is true or false.
+     *
+     * @returns True if the block's editable property is true, false otherwise.
+     */
+    isOwnEditable(): boolean;
+    /**
+     * Set whether this block is editable or not.
+     *
+     * @param editable True if editable.
+     */
+    setEditable(editable: boolean): void;
+    /**
+     * Returns if this block has been disposed of / deleted.
+     *
+     * @returns True if this block has been disposed of / deleted.
+     */
+    isDisposed(): boolean;
+    /**
+     * @returns True if this block is a value block with a single editable field.
+     * @internal
+     */
+    isSimpleReporter(): boolean;
+    /**
+     * Find the connection on this block that corresponds to the given connection
+     * on the other block.
+     * Used to match connections between a block and its insertion marker.
+     *
+     * @param otherBlock The other block to match against.
+     * @param conn The other connection to match.
+     * @returns The matching connection on this block, or null.
+     * @internal
+     */
+    getMatchingConnection(otherBlock: Block, conn: Connection): Connection | null;
+    /**
+     * Set the URL of this block's help page.
+     *
+     * @param url URL string for block help, or function that returns a URL.  Null
+     *     for no help.
+     */
+    setHelpUrl(url: string | (() => string)): void;
+    /**
+     * Sets the tooltip for this block.
+     *
+     * @param newTip The text for the tooltip, a function that returns the text
+     *     for the tooltip, or a parent object whose tooltip will be used. To not
+     *     display a tooltip pass the empty string.
+     */
+    setTooltip(newTip: Tooltip.TipInfo): void;
+    /**
+     * Returns the tooltip text for this block.
+     *
+     * @returns The tooltip text for this block.
+     */
+    getTooltip(): string;
+    /**
+     * Get the colour of a block.
+     *
+     * @returns #RRGGBB string.
+     */
+    getColour(): string;
+    /**
+     * Get the name of the block style.
+     *
+     * @returns Name of the block style.
+     */
+    getStyleName(): string;
+    /**
+     * Get the HSV hue value of a block.  Null if hue not set.
+     *
+     * @returns Hue value (0-360).
+     */
+    getHue(): number | null;
+    /**
+     * Change the colour of a block.
+     *
+     * @param colour HSV hue value (0 to 360), #RRGGBB string, or a message
+     *     reference string pointing to one of those two values.
+     */
+    setColour(colour: number | string): void;
+    /**
+     * Set the style and colour values of a block.
+     *
+     * @param blockStyleName Name of the block style.
+     */
+    setStyle(blockStyleName: string): void;
+    /**
+     * Sets a callback function to use whenever the block's parent workspace
+     * changes, replacing any prior onchange handler. This is usually only called
+     * from the constructor, the block type initializer function, or an extension
+     * initializer function.
+     *
+     * @param onchangeFn The callback to call when the block's workspace changes.
+     * @throws {Error} if onchangeFn is not falsey and not a function.
+     */
+    setOnChange(onchangeFn: (p1: Abstract) => void): void;
+    /**
+     * Returns the named field from a block.
+     *
+     * @param name The name of the field.
+     * @returns Named field, or null if field does not exist.
+     */
+    getField(name: string): Field | null;
+    /**
+     * Returns a generator that provides every field on the block.
+     *
+     * @returns A generator that can be used to iterate the fields on the block.
+     */
+    getFields(): Generator<Field, undefined, void>;
+    /**
+     * Return all variables referenced by this block.
+     *
+     * @returns List of variable ids.
+     */
+    getVars(): string[];
+    /**
+     * Return all variables referenced by this block.
+     *
+     * @returns List of variable models.
+     * @internal
+     */
+    getVarModels(): IVariableModel<IVariableState>[];
+    /**
+     * Notification that a variable is renaming but keeping the same ID.  If the
+     * variable is in use on this block, rerender to show the new name.
+     *
+     * @param variable The variable being renamed.
+     * @internal
+     */
+    updateVarName(variable: IVariableModel<IVariableState>): void;
+    /**
+     * Notification that a variable is renaming.
+     * If the ID matches one of this block's variables, rename it.
+     *
+     * @param oldId ID of variable to rename.
+     * @param newId ID of new variable.  May be the same as oldId, but with an
+     *     updated name.
+     */
+    renameVarById(oldId: string, newId: string): void;
+    /**
+     * Returns the language-neutral value of the given field.
+     *
+     * @param name The name of the field.
+     * @returns Value of the field or null if field does not exist.
+     */
+    getFieldValue(name: string): any;
+    /**
+     * Sets the value of the given field for this block.
+     *
+     * @param newValue The value to set.
+     * @param name The name of the field to set the value of.
+     */
+    setFieldValue(newValue: any, name: string): void;
+    /**
+     * Set whether this block can chain onto the bottom of another block.
+     *
+     * @param newBoolean True if there can be a previous statement.
+     * @param opt_check Statement type or list of statement types.  Null/undefined
+     *     if any type could be connected.
+     */
+    setPreviousStatement(newBoolean: boolean, opt_check?: string | string[] | null): void;
+    /**
+     * Set whether another block can chain onto the bottom of this block.
+     *
+     * @param newBoolean True if there can be a next statement.
+     * @param opt_check Statement type or list of statement types.  Null/undefined
+     *     if any type could be connected.
+     */
+    setNextStatement(newBoolean: boolean, opt_check?: string | string[] | null): void;
+    /**
+     * Set whether this block returns a value.
+     *
+     * @param newBoolean True if there is an output.
+     * @param opt_check Returned type or list of returned types.  Null or
+     *     undefined if any type could be returned (e.g. variable get).
+     */
+    setOutput(newBoolean: boolean, opt_check?: string | string[] | null): void;
+    /**
+     * Set whether value inputs are arranged horizontally or vertically.
+     *
+     * @param newBoolean True if inputs are horizontal.
+     */
+    setInputsInline(newBoolean: boolean): void;
+    /**
+     * Get whether value inputs are arranged horizontally or vertically.
+     *
+     * @returns True if inputs are horizontal.
+     */
+    getInputsInline(): boolean;
+    /**
+     * Set the block's output shape.
+     *
+     * @param outputShape Value representing an output shape.
+     */
+    setOutputShape(outputShape: number | null): void;
+    /**
+     * Get the block's output shape.
+     *
+     * @returns Value representing output shape if one exists.
+     */
+    getOutputShape(): number | null;
+    /**
+     * Get whether this block is enabled or not. A block is considered enabled
+     * if there aren't any reasons why it would be disabled. A block may still
+     * be disabled for other reasons even if the user attempts to manually
+     * enable it, such as when the block is in an invalid location.
+     *
+     * @returns True if enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Add or remove a reason why the block might be disabled. If a block has
+     * any reasons to be disabled, then the block itself will be considered
+     * disabled. A block could be disabled for multiple independent reasons
+     * simultaneously, such as when the user manually disables it, or the block
+     * is invalid.
+     *
+     * @param disabled If true, then the block should be considered disabled for
+     *     at least the provided reason, otherwise the block is no longer disabled
+     *     for that reason.
+     * @param reason A language-neutral identifier for a reason why the block
+     *     could be disabled. Call this method again with the same identifier to
+     *     update whether the block is currently disabled for this reason.
+     */
+    setDisabledReason(disabled: boolean, reason: string): void;
+    /**
+     * Get whether the block is disabled or not due to parents.
+     * The block's own disabled property is not considered.
+     *
+     * @returns True if disabled.
+     */
+    getInheritedDisabled(): boolean;
+    /**
+     * Get whether the block is currently disabled for the provided reason.
+     *
+     * @param reason A language-neutral identifier for a reason why the block
+     *     could be disabled.
+     * @returns Whether the block is disabled for the provided reason.
+     */
+    hasDisabledReason(reason: string): boolean;
+    /**
+     * Get a set of reasons why the block is currently disabled, if any. If the
+     * block is enabled, this set will be empty.
+     *
+     * @returns The set of reasons why the block is disabled, if any.
+     */
+    getDisabledReasons(): ReadonlySet<string>;
+    /**
+     * Get whether the block is collapsed or not.
+     *
+     * @returns True if collapsed.
+     */
+    isCollapsed(): boolean;
+    /**
+     * Set whether the block is collapsed or not.
+     *
+     * @param collapsed True if collapsed.
+     */
+    setCollapsed(collapsed: boolean): void;
+    /**
+     * Create a human-readable text representation of this block and any children.
+     *
+     * @param opt_maxLength Truncate the string to this length.
+     * @param opt_emptyToken The placeholder string used to denote an empty input.
+     *     If not specified, '?' is used.
+     * @returns Text of block.
+     */
+    toString(opt_maxLength?: number, opt_emptyToken?: string): string;
+    /**
+     * Converts this block into string tokens.
+     *
+     * @param emptyToken The token to use in place of an empty input.
+     *     Defaults to '?'.
+     * @returns The array of string tokens representing this block.
+     */
+    private toTokens;
+    /**
+     * Appends a value input row.
+     *
+     * @param name Language-neutral identifier which may used to find this input
+     *     again.  Should be unique to this block.
+     * @returns The input object created.
+     */
+    appendValueInput(name: string): Input;
+    /**
+     * Appends a statement input row.
+     *
+     * @param name Language-neutral identifier which may used to find this input
+     *     again.  Should be unique to this block.
+     * @returns The input object created.
+     */
+    appendStatementInput(name: string): Input;
+    /**
+     * Appends a dummy input row.
+     *
+     * @param name Optional language-neutral identifier which may used to find
+     *     this input again.  Should be unique to this block.
+     * @returns The input object created.
+     */
+    appendDummyInput(name?: string): Input;
+    /**
+     * Appends an input that ends the row.
+     *
+     * @param name Optional language-neutral identifier which may used to find
+     *     this input again.  Should be unique to this block.
+     * @returns The input object created.
+     */
+    appendEndRowInput(name?: string): Input;
+    /**
+     * Appends the given input row.
+     *
+     * Allows for custom inputs to be appended to the block.
+     */
+    appendInput(input: Input): Input;
+    /**
+     * Appends an input with the given input type and name to the block after
+     * constructing it from the registry.
+     *
+     * @param type The name the input is registered under in the registry.
+     * @param name The name the input will have within the block.
+     * @returns The constucted input, or null if there was no constructor
+     *     associated with the type.
+     */
+    private appendInputFromRegistry;
+    /**
+     * Initialize this block using a cross-platform, internationalization-friendly
+     * JSON description.
+     *
+     * @param json Structured data describing the block.
+     */
+    jsonInit(json: any): void;
+    /**
+     * Initialize the colour of this block from the JSON description.
+     *
+     * @param json Structured data describing the block.
+     * @param warningPrefix Warning prefix string identifying block.
+     */
+    private jsonInitColour;
+    /**
+     * Initialize the style of this block from the JSON description.
+     *
+     * @param json Structured data describing the block.
+     * @param warningPrefix Warning prefix string identifying block.
+     */
+    private jsonInitStyle;
+    /**
+     * Add key/values from mixinObj to this block object. By default, this method
+     * will check that the keys in mixinObj will not overwrite existing values in
+     * the block, including prototype values. This provides some insurance against
+     * mixin / extension incompatibilities with future block features. This check
+     * can be disabled by passing true as the second argument.
+     *
+     * @param mixinObj The key/values pairs to add to this block object.
+     * @param opt_disableCheck Option flag to disable overwrite checks.
+     */
+    mixin(mixinObj: any, opt_disableCheck?: boolean): void;
+    /**
+     * Interpolate a message description onto the block.
+     *
+     * @param message Text contains interpolation tokens (%1, %2, ...) that match
+     *     with fields or inputs defined in the args array.
+     * @param args Array of arguments to be interpolated.
+     * @param implicitAlign If an implicit input is added at the end or in place
+     *     of newline tokens, how should it be aligned?
+     * @param warningPrefix Warning prefix string identifying block.
+     */
+    private interpolate;
+    /**
+     * Validates that the tokens are within the correct bounds, with no
+     * duplicates, and that all of the arguments are referred to. Throws errors if
+     * any of these things are not true.
+     *
+     * @param tokens An array of tokens to validate
+     * @param argsCount The number of args that need to be referred to.
+     */
+    private validateTokens;
+    /**
+     * Inserts args in place of numerical tokens. String args are converted to
+     * JSON that defines a label field. Newline characters are converted to
+     * end-row inputs, and if necessary an extra dummy input is added to the end
+     * of the elements.
+     *
+     * @param tokens The tokens to interpolate
+     * @param args The arguments to insert.
+     * @param implicitAlign The alignment to use for any implicitly added end-row
+     *     or dummy inputs, if necessary.
+     * @returns The JSON definitions of field and inputs to add to the block.
+     */
+    private interpolateArguments;
+    /**
+     * Creates a field from the JSON definition of a field. If a field with the
+     * given type cannot be found, this attempts to create a different field using
+     * the 'alt' property of the JSON definition (if it exists).
+     *
+     * @param element The element to try to turn into a field.
+     * @returns The field defined by the JSON, or null if one couldn't be created.
+     */
+    private fieldFromJson;
+    /**
+     * Creates an input from the JSON definition of an input. Sets the input's
+     * check and alignment if they are provided.
+     *
+     * @param element The JSON to turn into an input.
+     * @param warningPrefix The prefix to add to warnings to help the developer
+     *     debug.
+     * @returns The input that has been created, or null if one could not be
+     *     created for some reason (should never happen).
+     */
+    private inputFromJson;
+    /**
+     * Returns true if the given string matches one of the input keywords.
+     *
+     * @param str The string to check.
+     * @returns True if the given string matches one of the input keywords, false
+     *     otherwise.
+     */
+    private isInputKeyword;
+    /**
+     * Turns a string into the JSON definition of a label field. If the string
+     * becomes an empty string when trimmed, this returns null.
+     *
+     * @param str String to turn into the JSON definition of a label field.
+     * @returns The JSON definition or null.
+     */
+    private stringToFieldJson;
+    /**
+     * Move a named input to a different location on this block.
+     *
+     * @param name The name of the input to move.
+     * @param refName Name of input that should be after the moved input, or null
+     *     to be the input at the end.
+     */
+    moveInputBefore(name: string, refName: string | null): void;
+    /**
+     * Move a numbered input to a different location on this block.
+     *
+     * @param inputIndex Index of the input to move.
+     * @param refIndex Index of input that should be after the moved input.
+     */
+    moveNumberedInputBefore(inputIndex: number, refIndex: number): void;
+    /**
+     * Remove an input from this block.
+     *
+     * @param name The name of the input.
+     * @param opt_quiet True to prevent an error if input is not present.
+     * @returns True if operation succeeds, false if input is not present and
+     *     opt_quiet is true.
+     * @throws {Error} if the input is not present and opt_quiet is not true.
+     */
+    removeInput(name: string, opt_quiet?: boolean): boolean;
+    /**
+     * Fetches the named input object.
+     *
+     * @param name The name of the input.
+     * @returns The input object, or null if input does not exist.
+     */
+    getInput(name: string): Input | null;
+    /**
+     * Fetches the block attached to the named input.
+     *
+     * @param name The name of the input.
+     * @returns The attached value block, or null if the input is either
+     *     disconnected or if the input does not exist.
+     */
+    getInputTargetBlock(name: string): Block | null;
+    /**
+     * Returns the comment on this block (or null if there is no comment).
+     *
+     * @returns Block's comment.
+     */
+    getCommentText(): string | null;
+    /**
+     * Set this block's comment text.
+     *
+     * @param text The text, or null to delete.
+     */
+    setCommentText(text: string | null): void;
+    /**
+     * Set this block's warning text.
+     *
+     * @param _text The text, or null to delete.
+     * @param _opt_id An optional ID for the warning text to be able to maintain
+     *     multiple warnings.
+     */
+    setWarningText(_text: string | null, _opt_id?: string): void;
+    /**
+     * Give this block a mutator dialog.
+     *
+     * @param _mutator A mutator dialog instance or null to remove.
+     */
+    setMutator(_mutator: MutatorIcon): void;
+    /** Adds the given icon to the block. */
+    addIcon<T extends IIcon>(icon: T): T;
+    /**
+     * Removes the icon whose getType matches the given type iconType from the
+     * block.
+     *
+     * @param type The type of the icon to remove from the block.
+     * @returns True if an icon with the given type was found, false otherwise.
+     */
+    removeIcon(type: IconType<IIcon>): boolean;
+    /**
+     * @returns True if an icon with the given type exists on the block,
+     *     false otherwise.
+     */
+    hasIcon(type: IconType<IIcon>): boolean;
+    /**
+     * @param type The type of the icon to retrieve. Prefer passing an `IconType`
+     *     for proper type checking when using typescript.
+     * @returns The icon with the given type if it exists on the block, undefined
+     *     otherwise.
+     */
+    getIcon<T extends IIcon>(type: IconType<T> | string): T | undefined;
+    /** @returns An array of the icons attached to this block. */
+    getIcons(): IIcon[];
+    /**
+     * Return the coordinates of the top-left corner of this block relative to the
+     * drawing surface's origin (0,0), in workspace units.
+     *
+     * @returns Object with .x and .y properties.
+     */
+    getRelativeToSurfaceXY(): Coordinate;
+    /**
+     * Move a block by a relative offset.
+     *
+     * @param dx Horizontal offset, in workspace units.
+     * @param dy Vertical offset, in workspace units.
+     * @param reason Why is this move happening?  'drag', 'bump', 'snap', ...
+     */
+    moveBy(dx: number, dy: number, reason?: string[]): void;
+    /**
+     * Create a connection of the specified type.
+     *
+     * @param type The type of the connection to create.
+     * @returns A new connection of the specified type.
+     * @internal
+     */
+    makeConnection_(type: ConnectionType): Connection;
+    /**
+     * Recursively checks whether all statement and value inputs are filled with
+     * blocks. Also checks all following statement blocks in this stack.
+     *
+     * @param opt_shadowBlocksAreFilled An optional argument controlling whether
+     *     shadow blocks are counted as filled. Defaults to true.
+     * @returns True if all inputs are filled, false otherwise.
+     */
+    allInputsFilled(opt_shadowBlocksAreFilled?: boolean): boolean;
+    /**
+     * This method returns a string describing this Block in developer terms (type
+     * name and ID; English only).
+     *
+     * Intended to on be used in console logs and errors. If you need a string
+     * that uses the user's native language (including block text, field values,
+     * and child blocks), use {@link (Block:class).toString | toString()}.
+     *
+     * @returns The description.
+     */
+    toDevString(): string;
+}
+export declare namespace Block {
+    interface CommentModel {
+        text: string | null;
+        pinned: boolean;
+        size: Size;
+    }
+}
+export type CommentModel = Block.CommentModel;
+//# sourceMappingURL=block.d.ts.map