blockly 9.1.0 → 9.2.0

package/core/events/events_var_delete.d.ts

@@ -5,6 +5,7 @@
  */
 import type { VariableModel } from '../variable_model.js';
 import { VarBase, VarBaseJson } from './events_var_base.js';
+import type { Workspace } from '../workspace.js';
 /**
  * Class for a variable deletion event.
  *
@@ -30,6 +31,16 @@ export declare class VarDelete extends VarBase {
      * @param json JSON representation.
      */
     fromJson(json: VarDeleteJson): void;
+    /**
+     * Deserializes the JSON event.
+     *
+     * @param event The event to append new properties to. Should be a subclass
+     *     of VarDelete, but we can't specify that due to the fact that parameters
+     *     to static methods in subclasses must be supertypes of parameters to
+     *     static methods in superclasses.
+     * @internal
+     */
+    static fromJson(json: VarDeleteJson, workspace: Workspace, event?: any): VarDelete;
     /**
      * Run a variable deletion event.
      *

package/core/events/events_var_rename.d.ts

@@ -5,6 +5,7 @@
  */
 import type { VariableModel } from '../variable_model.js';
 import { VarBase, VarBaseJson } from './events_var_base.js';
+import type { Workspace } from '../workspace.js';
 /**
  * Class for a variable rename event.
  *
@@ -31,6 +32,16 @@ export declare class VarRename extends VarBase {
      * @param json JSON representation.
      */
     fromJson(json: VarRenameJson): void;
+    /**
+     * Deserializes the JSON event.
+     *
+     * @param event The event to append new properties to. Should be a subclass
+     *     of VarRename, but we can't specify that due to the fact that parameters
+     *     to static methods in subclasses must be supertypes of parameters to
+     *     static methods in superclasses.
+     * @internal
+     */
+    static fromJson(json: VarRenameJson, workspace: Workspace, event?: any): VarRename;
     /**
      * Run a variable rename event.
      *

package/core/events/events_viewport.d.ts

@@ -5,6 +5,7 @@
  */
 import { AbstractEventJson } from './events_abstract.js';
 import { UiBase } from './events_ui_base.js';
+import type { Workspace } from '../workspace.js';
 /**
  * Class for a viewport change event.
  *
@@ -40,6 +41,16 @@ export declare class ViewportChange extends UiBase {
      * @param json JSON representation.
      */
     fromJson(json: ViewportChangeJson): void;
+    /**
+     * Deserializes the JSON event.
+     *
+     * @param event The event to append new properties to. Should be a subclass
+     *     of Viewport, but we can't specify that due to the fact that parameters
+     *     to static methods in subclasses must be supertypes of parameters to
+     *     static methods in superclasses.
+     * @internal
+     */
+    static fromJson(json: ViewportChangeJson, workspace: Workspace, event?: any): ViewportChange;
 }
 export interface ViewportChangeJson extends AbstractEventJson {
     viewTop: number;

package/core/events/utils.d.ts

@@ -180,6 +180,22 @@ export declare const COMMENT_MOVE = "comment_move";
  * @alias Blockly.Events.utils.FINISHED_LOADING
  */
 export declare const FINISHED_LOADING = "finished_loading";
+/** Name of event that creates a procedure model. */
+export declare const PROCEDURE_CREATE = "procedure_create";
+/** Name of event that deletes a procedure model. */
+export declare const PROCEDURE_DELETE = "procedure_delete";
+/** Name of event that renames a procedure model. */
+export declare const PROCEDURE_RENAME = "procedure_rename";
+/** Name of event that enables/disables a procedure model. */
+export declare const PROCEDURE_ENABLE = "procedure_enable";
+/** Name of event that changes the returntype of a procedure model. */
+export declare const PROCEDURE_CHANGE_RETURN = "procedure_change_return";
+/** Name of event that creates a procedure parameter. */
+export declare const PROCEDURE_PARAMETER_CREATE = "procedure_parameter_create";
+/** Name of event that deletes a procedure parameter. */
+export declare const PROCEDURE_PARAMETER_DELETE = "procedure_parameter_delete";
+/** Name of event that renames a procedure parameter. */
+export declare const PROCEDURE_PARAMETER_RENAME = "procedure_parameter_rename";
 /**
  * Type of events that cause objects to be bumped back into the visible
  * portion of the workspace.
@@ -189,7 +205,7 @@ export declare const FINISHED_LOADING = "finished_loading";
  *
  * @alias Blockly.Events.utils.BumpEvent
  */
-export declare type BumpEvent = BlockCreate | BlockMove | CommentCreate | CommentMove;
+export type BumpEvent = BlockCreate | BlockMove | CommentCreate | CommentMove;
 /**
  * List of events that cause objects to be bumped back into the visible
  * portion of the workspace.

package/core/field.d.ts

@@ -17,12 +17,23 @@ import type { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';
 import { Sentinel } from './utils/sentinel.js';
 import { Size } from './utils/size.js';
+export type FieldValidator<T = any> = (value?: T) => T | null | undefined;
 /**
  * Abstract class for an editable field.
  *
  * @alias Blockly.Field
  */
-export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLocationWithBlock, IKeyboardAccessible, IRegistrable {
+export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IASTNodeLocationWithBlock, IKeyboardAccessible, IRegistrable {
+    /**
+     * To overwrite the default value which is set in **Field**, directly update
+     * the prototype.
+     *
+     * Example:
+     * ```typescript
+     * FieldImage.prototype.DEFAULT_VALUE = null;
+     * ```
+     */
+    DEFAULT_VALUE: T | null;
     /** Non-breaking space. */
     static readonly NBSP = "\u00A0";
     /**
@@ -36,9 +47,9 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
      * Static labels are usually unnamed.
      */
     name?: string;
-    protected value_: any;
+    protected value_: T | null;
     /** Validation function called when user edits an editable field. */
-    protected validator_: Function | null;
+    protected validator_: FieldValidator<T> | null;
     /**
      * Used to cache the field's tooltip value if setTooltip is called when the
      * field is not yet initialized. Is *not* guaranteed to be accurate.
@@ -124,7 +135,7 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
      *    Refer to the individual field's documentation for a list of properties
      * this parameter supports.
      */
-    constructor(value: any, opt_validator?: Function | null, opt_config?: FieldConfig);
+    constructor(value: T | Sentinel, opt_validator?: FieldValidator<T> | null, opt_config?: FieldConfig);
     /**
      * Process the configuration map passed to the field.
      *
@@ -319,7 +330,7 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
      * @param handler The validator function or null to clear a previous
      *     validator.
      */
-    setValidator(handler: Function): void;
+    setValidator(handler: FieldValidator<T>): void;
     /**
      * Gets the validation function for editable fields, or null if not set.
      *
@@ -509,11 +520,11 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
      */
     protected doValueInvalid_(_invalidValue: any): void;
     /**
-     * Handle a mouse down event on a field.
+     * Handle a pointerdown event on a field.
      *
-     * @param e Mouse down event.
+     * @param e Pointer down event.
      */
-    protected onMouseDown_(e: Event): void;
+    protected onMouseDown_(e: PointerEvent): void;
     /**
      * Sets the tooltip for this field.
      *
@@ -614,7 +625,7 @@ export interface FieldConfig {
  * For use by Field and descendants of Field. Constructors can change
  * in descendants, though they should contain all of Field's prototype methods.
  */
-export declare type FieldProto = Pick<typeof Field, 'prototype'>;
+export type FieldProto = Pick<typeof Field, 'prototype'>;
 /**
  * Represents an error where the field is trying to access its block or
  * information about its block before it has actually been attached to said

package/core/field_angle.d.ts

@@ -3,15 +3,15 @@
  * Copyright 2013 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { FieldTextInputConfig, FieldTextInput } from './field_textinput.js';
+import { FieldInput, FieldInputConfig, FieldInputValidator } from './field_input.js';
 import type { Sentinel } from './utils/sentinel.js';
+export type FieldAngleValidator = FieldInputValidator<number>;
 /**
  * Class for an editable angle field.
  *
  * @alias Blockly.FieldAngle
  */
-export declare class FieldAngle extends FieldTextInput {
-    /** The default value for this field. */
+export declare class FieldAngle extends FieldInput<number> {
     /**
      * The default amount to round angles to when using a mouse or keyboard nav
      * input. Must be a positive integer to support keyboard navigation.
@@ -89,7 +89,7 @@ export declare class FieldAngle extends FieldTextInput {
      * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/angle#creation}
      * for a list of properties this parameter supports.
      */
-    constructor(opt_value?: string | number | Sentinel, opt_validator?: Function, opt_config?: FieldAngleConfig);
+    constructor(opt_value?: string | number | Sentinel, opt_validator?: FieldAngleValidator, opt_config?: FieldAngleConfig);
     /**
      * Configure the field based on the given map of options.
      *
@@ -122,7 +122,7 @@ export declare class FieldAngle extends FieldTextInput {
      *
      * @param e Mouse move event.
      */
-    protected onMouseMove_(e: Event): void;
+    protected onMouseMove_(e: PointerEvent): void;
     /**
      * Handles and displays values that are input via mouse or arrow key input.
      * These values need to be rounded and wrapped before being displayed so
@@ -184,7 +184,7 @@ export declare enum Mode {
 /**
  * Extra configuration options for the angle field.
  */
-export interface FieldAngleConfig extends FieldTextInputConfig {
+export interface FieldAngleConfig extends FieldInputConfig {
     mode?: Mode;
     clockwise?: boolean;
     offset?: number;

package/core/field_checkbox.d.ts

@@ -4,14 +4,15 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import './events/events_block_change.js';
-import { FieldConfig, Field } from './field.js';
+import { Field, FieldConfig, FieldValidator } from './field.js';
 import type { Sentinel } from './utils/sentinel.js';
+export type FieldCheckboxValidator = FieldValidator<boolean>;
 /**
  * Class for a checkbox field.
  *
  * @alias Blockly.FieldCheckbox
  */
-export declare class FieldCheckbox extends Field {
+export declare class FieldCheckbox extends Field<boolean> {
     /** Default character for the checkmark. */
     static readonly CHECK_CHAR = "\u2713";
     private checkChar_;
@@ -39,7 +40,7 @@ export declare class FieldCheckbox extends Field {
      * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/checkbox#creation}
      * for a list of properties this parameter supports.
      */
-    constructor(opt_value?: string | boolean | Sentinel, opt_validator?: Function, opt_config?: FieldCheckboxConfig);
+    constructor(opt_value?: string | boolean | Sentinel, opt_validator?: FieldCheckboxValidator, opt_config?: FieldCheckboxConfig);
     /**
      * Configure the field based on the given map of options.
      *

package/core/field_colour.d.ts

@@ -4,14 +4,15 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import './events/events_block_change.js';
-import { FieldConfig, Field } from './field.js';
+import { Field, FieldConfig, FieldValidator } from './field.js';
 import type { Sentinel } from './utils/sentinel.js';
+export type FieldColourValidator = FieldValidator<string>;
 /**
  * Class for a colour input field.
  *
  * @alias Blockly.FieldColour
  */
-export declare class FieldColour extends Field {
+export declare class FieldColour extends Field<string> {
     /**
      * An array of colour strings for the palette.
      * Copied from goog.ui.ColorPicker.SIMPLE_GRID_COLORS
@@ -85,7 +86,7 @@ export declare class FieldColour extends Field {
      * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/colour}
      * for a list of properties this parameter supports.
      */
-    constructor(opt_value?: string | Sentinel, opt_validator?: Function, opt_config?: FieldColourConfig);
+    constructor(opt_value?: string | Sentinel, opt_validator?: FieldColourValidator, opt_config?: FieldColourConfig);
     /**
      * Configure the field based on the given map of options.
      *

package/core/field_dropdown.d.ts

@@ -3,16 +3,17 @@
  * Copyright 2012 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { FieldConfig, Field } from './field.js';
+import { Field, FieldConfig, FieldValidator } from './field.js';
 import { Menu } from './menu.js';
 import { MenuItem } from './menuitem.js';
 import type { Sentinel } from './utils/sentinel.js';
+export type FieldDropdownValidator = FieldValidator<string>;
 /**
  * Class for an editable dropdown field.
  *
  * @alias Blockly.FieldDropdown
  */
-export declare class FieldDropdown extends Field {
+export declare class FieldDropdown extends Field<string> {
     /** Horizontal distance that a checkmark overhangs the dropdown. */
     static CHECKMARK_OVERHANG: number;
     /**
@@ -73,7 +74,7 @@ export declare class FieldDropdown extends Field {
      * for a list of properties this parameter supports.
      * @throws {TypeError} If `menuGenerator` options are incorrectly structured.
      */
-    constructor(menuGenerator: MenuGenerator, opt_validator?: Function, opt_config?: FieldConfig);
+    constructor(menuGenerator: MenuGenerator, opt_validator?: FieldDropdownValidator, opt_config?: FieldConfig);
     constructor(menuGenerator: Sentinel);
     /**
      * Sets the field's value based on the given XML element. Should only be
@@ -217,17 +218,17 @@ export interface ImageProperties {
  * readable value (text or image), and the second element is the language-
  * neutral value.
  */
-export declare type MenuOption = [string | ImageProperties, string];
+export type MenuOption = [string | ImageProperties, string];
 /**
  * A function that generates an array of menu options for FieldDropdown
  * or its descendants.
  */
-export declare type MenuGeneratorFunction = (this: FieldDropdown) => MenuOption[];
+export type MenuGeneratorFunction = (this: FieldDropdown) => MenuOption[];
 /**
  * Either an array of menu options or a function that generates an array of
  * menu options for FieldDropdown or its descendants.
  */
-export declare type MenuGenerator = MenuOption[] | MenuGeneratorFunction;
+export type MenuGenerator = MenuOption[] | MenuGeneratorFunction;
 /**
  * fromJson config for the dropdown field.
  */

package/core/field_image.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2012 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { FieldConfig, Field } from './field.js';
+import { Field, FieldConfig } from './field.js';
 import type { Sentinel } from './utils/sentinel.js';
 import { Size } from './utils/size.js';
 /**
@@ -11,7 +11,7 @@ import { Size } from './utils/size.js';
  *
  * @alias Blockly.FieldImage
  */
-export declare class FieldImage extends Field {
+export declare class FieldImage extends Field<string> {
     /**
      * Vertical padding below the image, which is included in the reported height
      * of the field.

package/core/field_input.d.ts

@@ -0,0 +1,229 @@
+/**
+ * @license
+ * Copyright 2012 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import './events/events_block_change.js';
+import { Field, FieldConfig, FieldValidator } from './field.js';
+import type { Sentinel } from './utils/sentinel.js';
+import type { WorkspaceSvg } from './workspace_svg.js';
+export type InputTypes = string | number;
+export type FieldInputValidator<T extends InputTypes> = FieldValidator<T>;
+/**
+ * Class for an editable text field.
+ *
+ * @alias Blockly.FieldInput
+ */
+export declare abstract class FieldInput<T extends InputTypes> extends Field<T> {
+    /**
+     * Pixel size of input border radius.
+     * Should match blocklyText's border-radius in CSS.
+     */
+    static BORDERRADIUS: number;
+    /** Allow browser to spellcheck this field. */
+    protected spellcheck_: boolean;
+    /** The HTML input element. */
+    protected htmlInput_: HTMLInputElement | null;
+    /** True if the field's value is currently being edited via the UI. */
+    protected isBeingEdited_: boolean;
+    /**
+     * True if the value currently displayed in the field's editory UI is valid.
+     */
+    protected isTextValid_: boolean;
+    /** Key down event data. */
+    private onKeyDownWrapper_;
+    /** Key input event data. */
+    private onKeyInputWrapper_;
+    /**
+     * Whether the field should consider the whole parent block to be its click
+     * target.
+     */
+    fullBlockClickTarget_: boolean | null;
+    /** The workspace that this field belongs to. */
+    protected workspace_: WorkspaceSvg | null;
+    /**
+     * Serializable fields are saved by the serializer, non-serializable fields
+     * are not. Editable fields should also be serializable.
+     */
+    SERIALIZABLE: boolean;
+    /** Mouse cursor style when over the hotspot that initiates the editor. */
+    CURSOR: string;
+    clickTarget_: any;
+    value_: any;
+    isDirty_: any;
+    /**
+     * @param opt_value The initial value of the field. Should cast to a string.
+     *     Defaults to an empty string if null or undefined. Also accepts
+     *     Field.SKIP_SETUP if you wish to skip setup (only used by subclasses
+     *     that want to handle configuration and setting the field value after
+     *     their own constructors have run).
+     * @param opt_validator A function that is called to validate changes to the
+     *     field's value. Takes in a string & returns a validated string, or null
+     *     to abort the change.
+     * @param opt_config A map of options used to configure the field.
+     *     See the [field creation documentation]{@link
+     * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/text-input#creation}
+     * for a list of properties this parameter supports.
+     */
+    constructor(opt_value?: string | Sentinel, opt_validator?: FieldInputValidator<T> | null, opt_config?: FieldInputConfig);
+    protected configure_(config: FieldInputConfig): void;
+    /** @internal */
+    initView(): void;
+    /**
+     * Ensure that the input value casts to a valid string.
+     *
+     * @param opt_newValue The input value.
+     * @returns A valid string, or null if invalid.
+     */
+    protected doClassValidation_(opt_newValue?: any): any;
+    /**
+     * Called by setValue if the text input is not valid. If the field is
+     * currently being edited it reverts value of the field to the previous
+     * value while allowing the display text to be handled by the htmlInput_.
+     *
+     * @param _invalidValue The input value that was determined to be invalid.
+     *    This is not used by the text input because its display value is stored
+     * on the htmlInput_.
+     */
+    protected doValueInvalid_(_invalidValue: any): void;
+    /**
+     * Called by setValue if the text input is valid. Updates the value of the
+     * field, and updates the text of the field if it is not currently being
+     * edited (i.e. handled by the htmlInput_).
+     *
+     * @param newValue The value to be saved. The default validator guarantees
+     *     that this is a string.
+     */
+    protected doValueUpdate_(newValue: any): void;
+    /**
+     * Updates text field to match the colour/style of the block.
+     *
+     * @internal
+     */
+    applyColour(): void;
+    /**
+     * Updates the colour of the htmlInput given the current validity of the
+     * field's value.
+     */
+    protected render_(): void;
+    /**
+     * Set whether this field is spellchecked by the browser.
+     *
+     * @param check True if checked.
+     */
+    setSpellcheck(check: boolean): void;
+    /**
+     * Show an editor for the field.
+     * Shows the inline free-text editor on top of the text by default.
+     * Shows a prompt editor for mobile browsers if the modalInputs option is
+     * enabled.
+     *
+     * @param _opt_e Optional mouse event that triggered the field to open, or
+     *     undefined if triggered programmatically.
+     * @param opt_quietInput True if editor should be created without focus.
+     *     Defaults to false.
+     */
+    protected showEditor_(_opt_e?: Event, opt_quietInput?: boolean): void;
+    /**
+     * Create and show a text input editor that is a prompt (usually a popup).
+     * Mobile browsers may have issues with in-line textareas (focus and
+     * keyboards).
+     */
+    private showPromptEditor_;
+    /**
+     * Create and show a text input editor that sits directly over the text input.
+     *
+     * @param quietInput True if editor should be created without focus.
+     */
+    private showInlineEditor_;
+    /**
+     * Create the text input editor widget.
+     *
+     * @returns The newly created text input editor.
+     */
+    protected widgetCreate_(): HTMLElement;
+    /**
+     * Closes the editor, saves the results, and disposes of any events or
+     * DOM-references belonging to the editor.
+     */
+    protected widgetDispose_(): void;
+    /**
+     * A callback triggered when the user is done editing the field via the UI.
+     *
+     * @param _value The new value of the field.
+     */
+    onFinishEditing_(_value: any): void;
+    /**
+     * Bind handlers for user input on the text input field's editor.
+     *
+     * @param htmlInput The htmlInput to which event handlers will be bound.
+     */
+    protected bindInputEvents_(htmlInput: HTMLElement): void;
+    /** Unbind handlers for user input and workspace size changes. */
+    protected unbindInputEvents_(): void;
+    /**
+     * Handle key down to the editor.
+     *
+     * @param e Keyboard event.
+     */
+    protected onHtmlInputKeyDown_(e: Event): void;
+    /**
+     * Handle a change to the editor.
+     *
+     * @param _e Keyboard event.
+     */
+    private onHtmlInputChange_;
+    /**
+     * Set the HTML input value and the field's internal value. The difference
+     * between this and `setValue` is that this also updates the HTML input
+     * value whilst editing.
+     *
+     * @param newValue New value.
+     */
+    protected setEditorValue_(newValue: any): void;
+    /** Resize the editor to fit the text. */
+    protected resizeEditor_(): void;
+    /**
+     * Returns whether or not the field is tab navigable.
+     *
+     * @returns True if the field is tab navigable.
+     */
+    isTabNavigable(): boolean;
+    /**
+     * Use the `getText_` developer hook to override the field's text
+     * representation. When we're currently editing, return the current HTML value
+     * instead. Otherwise, return null which tells the field to use the default
+     * behaviour (which is a string cast of the field's value).
+     *
+     * @returns The HTML value if we're editing, otherwise null.
+     */
+    protected getText_(): string | null;
+    /**
+     * Transform the provided value into a text to show in the HTML input.
+     * Override this method if the field's HTML input representation is different
+     * than the field's value. This should be coupled with an override of
+     * `getValueFromEditorText_`.
+     *
+     * @param value The value stored in this field.
+     * @returns The text to show on the HTML input.
+     */
+    protected getEditorText_(value: any): string;
+    /**
+     * Transform the text received from the HTML input into a value to store
+     * in this field.
+     * Override this method if the field's HTML input representation is different
+     * than the field's value. This should be coupled with an override of
+     * `getEditorText_`.
+     *
+     * @param text Text received from the HTML input.
+     * @returns The value to store.
+     */
+    protected getValueFromEditorText_(text: string): any;
+}
+/**
+ * Config options for the input field.
+ */
+export interface FieldInputConfig extends FieldConfig {
+    spellcheck?: boolean;
+}
+//# sourceMappingURL=field_input.d.ts.map

package/core/field_label.d.ts

@@ -3,14 +3,14 @@
  * Copyright 2012 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { FieldConfig, Field } from './field.js';
+import { Field, FieldConfig } from './field.js';
 import type { Sentinel } from './utils/sentinel.js';
 /**
  * Class for a non-editable, non-serializable text field.
  *
  * @alias Blockly.FieldLabel
  */
-export declare class FieldLabel extends Field {
+export declare class FieldLabel extends Field<string> {
     /** The html class name to use for this field. */
     private class_;
     /**

package/core/field_label_serializable.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { FieldLabelConfig, FieldLabelFromJsonConfig, FieldLabel } from './field_label.js';
+import { FieldLabel, FieldLabelConfig, FieldLabelFromJsonConfig } from './field_label.js';
 /**
  * Class for a non-editable, serializable text field.
  *

package/core/field_multilineinput.d.ts

@@ -3,8 +3,9 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { FieldTextInputConfig, FieldTextInput } from './field_textinput.js';
+import { FieldTextInput, FieldTextInputConfig, FieldTextInputValidator } from './field_textinput.js';
 import type { Sentinel } from './utils/sentinel.js';
+export type FieldMultilineInputValidator = FieldTextInputValidator;
 /**
  * Class for an editable text area field.
  *
@@ -38,7 +39,7 @@ export declare class FieldMultilineInput extends FieldTextInput {
      * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/multiline-text-input#creation}
      * for a list of properties this parameter supports.
      */
-    constructor(opt_value?: string | Sentinel, opt_validator?: Function, opt_config?: FieldMultilineInputConfig);
+    constructor(opt_value?: string | Sentinel, opt_validator?: FieldMultilineInputValidator, opt_config?: FieldMultilineInputConfig);
     protected configure_(config: FieldMultilineInputConfig): void;
     /**
      * Serializes this field's value to XML. Should only be called by Blockly.Xml.