blockly 9.3.0-beta.0 → 9.3.1

package/core/field_checkbox.d.ts

@@ -5,14 +5,10 @@
  */
 import './events/events_block_change.js';
 import { Field, FieldConfig, FieldValidator } from './field.js';
-import type { Sentinel } from './utils/sentinel.js';
 type BoolString = 'TRUE' | 'FALSE';
 type CheckboxBool = BoolString | boolean;
-export type FieldCheckboxValidator = FieldValidator<CheckboxBool>;
 /**
  * Class for a checkbox field.
- *
- * @alias Blockly.FieldCheckbox
  */
 export declare class FieldCheckbox extends Field<CheckboxBool> {
     /** Default character for the checkmark. */
@@ -33,20 +29,20 @@ export declare class FieldCheckbox extends Field<CheckboxBool> {
      */
     value_: boolean | null;
     /**
-     * @param opt_value The initial value of the field. Should either be 'TRUE',
+     * @param value The initial value of the field. Should either be 'TRUE',
      *     'FALSE' or a boolean. Defaults to 'FALSE'. 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
+     * @param validator  A function that is called to validate changes to the
      *     field's value. Takes in a value ('TRUE' or 'FALSE') & returns a
      *     validated value ('TRUE' or 'FALSE'), or null to abort the change.
-     * @param opt_config A map of options used to configure the field.
+     * @param 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/checkbox#creation}
      * for a list of properties this parameter supports.
      */
-    constructor(opt_value?: CheckboxBool | Sentinel, opt_validator?: FieldCheckboxValidator, opt_config?: FieldCheckboxConfig);
+    constructor(value?: CheckboxBool | typeof Field.SKIP_SETUP, validator?: FieldCheckboxValidator, config?: FieldCheckboxConfig);
     /**
      * Configure the field based on the given map of options.
      *
@@ -80,10 +76,10 @@ export declare class FieldCheckbox extends Field<CheckboxBool> {
     /**
      * Ensure that the input value is valid ('TRUE' or 'FALSE').
      *
-     * @param opt_newValue The input value.
+     * @param newValue The input value.
      * @returns A valid value ('TRUE' or 'FALSE), or null if invalid.
      */
-    protected doClassValidation_(opt_newValue?: any): BoolString | null;
+    protected doClassValidation_(newValue?: any): BoolString | null;
     /**
      * Update the value of the field, and update the checkElement.
      *
@@ -141,5 +137,21 @@ export interface FieldCheckboxConfig extends FieldConfig {
 export interface FieldCheckboxFromJsonConfig extends FieldCheckboxConfig {
     checked?: boolean;
 }
+/**
+ * A function that is called to validate changes to the field's value before
+ * they are set.
+ *
+ * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @param newValue The value to be validated.
+ * @returns One of three instructions for setting the new value: `T`, `null`,
+ * or `undefined`.
+ *
+ * - `T` to set this function's returned value instead of `newValue`.
+ *
+ * - `null` to invoke `doValueInvalid_` and not set a value.
+ *
+ * - `undefined` to set `newValue` as is.
+ */
+export type FieldCheckboxValidator = FieldValidator<CheckboxBool>;
 export {};
 //# sourceMappingURL=field_checkbox.d.ts.map

package/core/field_colour.d.ts

@@ -5,12 +5,8 @@
  */
 import './events/events_block_change.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<string> {
     /**
@@ -31,19 +27,15 @@ export declare class FieldColour extends Field<string> {
      */
     static COLUMNS: number;
     /** The field's colour picker element. */
-    private picker_;
+    private picker;
     /** Index of the currently highlighted element. */
-    private highlightedIndex_;
-    /** Mouse click event data. */
-    private onClickWrapper_;
-    /** Mouse move event data. */
-    private onMouseMoveWrapper_;
-    /** Mouse enter event data. */
-    private onMouseEnterWrapper_;
-    /** Mouse leave event data. */
-    private onMouseLeaveWrapper_;
-    /** Key down event data. */
-    private onKeyDownWrapper_;
+    private highlightedIndex;
+    /**
+     * Array holding info needed to unbind events.
+     * Used for disposing.
+     * Ex: [[node, name, func], [node, name, func]].
+     */
+    private boundEvents;
     /**
      * Serializable fields are saved by the serializer, non-serializable fields
      * are not. Editable fields should also be serializable.
@@ -58,32 +50,32 @@ export declare class FieldColour extends Field<string> {
      */
     protected isDirty_: boolean;
     /** Array of colours used by this field.  If null, use the global list. */
-    private colours_;
+    private colours;
     /**
      * Array of colour tooltips used by this field.  If null, use the global
      * list.
      */
-    private titles_;
+    private titles;
     /**
      * Number of colour columns used by this field.  If 0, use the global
      * setting. By default use the global constants for columns.
      */
-    private columns_;
+    private columns;
     /**
-     * @param opt_value The initial value of the field. Should be in '#rrggbb'
+     * @param value The initial value of the field. Should be in '#rrggbb'
      *     format. Defaults to the first value in the default colour array. 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
+     * @param validator A function that is called to validate changes to the
      *     field's value. Takes in a colour string & returns a validated colour
-     *     string ('#rrggbb' format), or null to abort the change.Blockly.
-     * @param opt_config A map of options used to configure the field.
+     *     string ('#rrggbb' format), or null to abort the change.
+     * @param 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/colour}
      * for a list of properties this parameter supports.
      */
-    constructor(opt_value?: string | Sentinel, opt_validator?: FieldColourValidator, opt_config?: FieldColourConfig);
+    constructor(value?: string | typeof Field.SKIP_SETUP, validator?: FieldColourValidator, config?: FieldColourConfig);
     /**
      * Configure the field based on the given map of options.
      *
@@ -96,14 +88,19 @@ export declare class FieldColour extends Field<string> {
      * @internal
      */
     initView(): void;
+    /**
+     * Updates text field to match the colour/style of the block.
+     *
+     * @internal
+     */
     applyColour(): void;
     /**
      * Ensure that the input value is a valid colour.
      *
-     * @param opt_newValue The input value.
+     * @param newValue The input value.
      * @returns A valid colour, or null if invalid.
      */
-    protected doClassValidation_(opt_newValue?: any): string | null;
+    protected doClassValidation_(newValue?: any): string | null;
     /**
      * Update the value of this colour field, and update the displayed colour.
      *
@@ -122,11 +119,11 @@ export declare class FieldColour extends Field<string> {
      *
      * @param colours Array of colours for this block, or null to use default
      *     (FieldColour.COLOURS).
-     * @param opt_titles Optional array of colour tooltips, or null to use default
+     * @param titles Optional array of colour tooltips, or null to use default
      *     (FieldColour.TITLES).
      * @returns Returns itself (for method chaining).
      */
-    setColours(colours: string[], opt_titles?: string[]): FieldColour;
+    setColours(colours: string[], titles?: string[]): FieldColour;
     /**
      * Set a custom grid size for this field.
      *
@@ -142,51 +139,51 @@ export declare class FieldColour extends Field<string> {
      *
      * @param e Mouse event.
      */
-    private onClick_;
+    private onClick;
     /**
      * Handle a key down event. Navigate around the grid with the
      * arrow keys. Enter selects the highlighted colour.
      *
      * @param e Keyboard event.
      */
-    private onKeyDown_;
+    private onKeyDown;
     /**
      * Move the currently highlighted position by dx and dy.
      *
-     * @param dx Change of x
-     * @param dy Change of y
+     * @param dx Change of x.
+     * @param dy Change of y.
      */
-    private moveHighlightBy_;
+    private moveHighlightBy;
     /**
      * Handle a mouse move event. Highlight the hovered colour.
      *
      * @param e Mouse event.
      */
-    private onMouseMove_;
+    private onMouseMove;
     /** Handle a mouse enter event. Focus the picker. */
-    private onMouseEnter_;
+    private onMouseEnter;
     /**
      * Handle a mouse leave event. Blur the picker and unhighlight
      * the currently highlighted colour.
      */
-    private onMouseLeave_;
+    private onMouseLeave;
     /**
      * Returns the currently highlighted item (if any).
      *
      * @returns Highlighted item (null if none).
      */
-    private getHighlighted_;
+    private getHighlighted;
     /**
      * Update the currently highlighted cell.
      *
-     * @param cell the new cell to highlight
-     * @param index the index of the new cell
+     * @param cell The new cell to highlight.
+     * @param index The index of the new cell.
      */
-    private setHighlightedCell_;
+    private setHighlightedCell;
     /** Create a colour picker dropdown editor. */
-    private dropdownCreate_;
+    private dropdownCreate;
     /** Disposes of events and DOM-references belonging to the colour editor. */
-    private dropdownDispose_;
+    private dropdownDispose;
     /**
      * Construct a FieldColour from a JSON arg object.
      *
@@ -211,4 +208,20 @@ export interface FieldColourConfig extends FieldConfig {
 export interface FieldColourFromJsonConfig extends FieldColourConfig {
     colour?: string;
 }
+/**
+ * A function that is called to validate changes to the field's value before
+ * they are set.
+ *
+ * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @param newValue The value to be validated.
+ * @returns One of three instructions for setting the new value: `T`, `null`,
+ * or `undefined`.
+ *
+ * - `T` to set this function's returned value instead of `newValue`.
+ *
+ * - `null` to invoke `doValueInvalid_` and not set a value.
+ *
+ * - `undefined` to set `newValue` as is.
+ */
+export type FieldColourValidator = FieldValidator<string>;
 //# sourceMappingURL=field_colour.d.ts.map

package/core/field_dropdown.d.ts

@@ -6,12 +6,8 @@
 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<string> {
     /** Horizontal distance that a checkmark overhangs the dropdown. */
@@ -64,18 +60,18 @@ export declare class FieldDropdown extends Field<string> {
      *     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
+     * @param validator A function that is called to validate changes to the
      *     field's value. Takes in a language-neutral dropdown option & returns a
      *     validated language-neutral dropdown option, or null to abort the
      *     change.
-     * @param opt_config A map of options used to configure the field.
+     * @param 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/dropdown#creation}
      * for a list of properties this parameter supports.
      * @throws {TypeError} If `menuGenerator` options are incorrectly structured.
      */
-    constructor(menuGenerator: MenuGenerator, opt_validator?: FieldDropdownValidator, opt_config?: FieldConfig);
-    constructor(menuGenerator: Sentinel);
+    constructor(menuGenerator: MenuGenerator, validator?: FieldDropdownValidator, config?: FieldDropdownConfig);
+    constructor(menuGenerator: typeof Field.SKIP_SETUP);
     /**
      * Sets the field's value based on the given XML element. Should only be
      * called by Blockly.Xml.
@@ -110,16 +106,16 @@ export declare class FieldDropdown extends Field<string> {
     /**
      * Create a dropdown menu under the text.
      *
-     * @param opt_e Optional mouse event that triggered the field to open, or
+     * @param e Optional mouse event that triggered the field to open, or
      *     undefined if triggered programmatically.
      */
-    protected showEditor_(opt_e?: MouseEvent): void;
+    protected showEditor_(e?: MouseEvent): void;
     /** Create the dropdown editor. */
     private dropdownCreate_;
     /**
      * Disposes of events and DOM-references belonging to the dropdown editor.
      */
-    private dropdownDispose_;
+    protected dropdownDispose_(): void;
     /**
      * Handle an action in the dropdown menu.
      *
@@ -141,20 +137,20 @@ export declare class FieldDropdown extends Field<string> {
     /**
      * Return a list of the options for this dropdown.
      *
-     * @param opt_useCache For dynamic options, whether or not to use the cached
+     * @param useCache For dynamic options, whether or not to use the cached
      *     options or to re-generate them.
      * @returns A non-empty array of option tuples:
      *     (human-readable text or image, language-neutral name).
      * @throws {TypeError} If generated options are incorrectly structured.
      */
-    getOptions(opt_useCache?: boolean): MenuOption[];
+    getOptions(useCache?: boolean): MenuOption[];
     /**
      * Ensure that the input value is a valid language-neutral option.
      *
-     * @param opt_newValue The input value.
+     * @param newValue The input value.
      * @returns A valid language-neutral option, or null if invalid.
      */
-    protected doClassValidation_(opt_newValue?: string): string | null;
+    protected doClassValidation_(newValue?: string): string | null;
     /**
      * Update the value of this dropdown field.
      *
@@ -188,8 +184,8 @@ export declare class FieldDropdown extends Field<string> {
     private positionSVGArrow_;
     /**
      * Use the `getText_` developer hook to override the field's text
-     * representation.  Get the selected option text. If the selected option is an
-     * image we return the image alt text.
+     * representation.  Get the selected option text.  If the selected option is
+     * an image we return the image alt text.
      *
      * @returns Selected option text.
      */
@@ -229,10 +225,30 @@ export type MenuGeneratorFunction = (this: FieldDropdown) => MenuOption[];
  * menu options for FieldDropdown or its descendants.
  */
 export type MenuGenerator = MenuOption[] | MenuGeneratorFunction;
+/**
+ * Config options for the dropdown field.
+ */
+export type FieldDropdownConfig = FieldConfig;
 /**
  * fromJson config for the dropdown field.
  */
-export interface FieldDropdownFromJsonConfig extends FieldConfig {
+export interface FieldDropdownFromJsonConfig extends FieldDropdownConfig {
     options?: MenuOption[];
 }
+/**
+ * A function that is called to validate changes to the field's value before
+ * they are set.
+ *
+ * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @param newValue The value to be validated.
+ * @returns One of three instructions for setting the new value: `T`, `null`,
+ * or `undefined`.
+ *
+ * - `T` to set this function's returned value instead of `newValue`.
+ *
+ * - `null` to invoke `doValueInvalid_` and not set a value.
+ *
+ * - `undefined` to set `newValue` as is.
+ */
+export type FieldDropdownValidator = FieldValidator<string>;
 //# sourceMappingURL=field_dropdown.d.ts.map

package/core/field_image.d.ts

@@ -4,12 +4,9 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Field, FieldConfig } from './field.js';
-import type { Sentinel } from './utils/sentinel.js';
 import { Size } from './utils/size.js';
 /**
  * Class for an image on a block.
- *
- * @alias Blockly.FieldImage
  */
 export declare class FieldImage extends Field<string> {
     /**
@@ -45,16 +42,16 @@ export declare class FieldImage extends Field<string> {
      * after their own constructors have run).
      * @param width Width of the image.
      * @param height Height of the image.
-     * @param opt_alt Optional alt text for when block is collapsed.
-     * @param opt_onClick Optional function to be called when the image is
-     *     clicked. If opt_onClick is defined, opt_alt must also be defined.
-     * @param opt_flipRtl Whether to flip the icon in RTL.
-     * @param opt_config A map of options used to configure the field.
+     * @param alt Optional alt text for when block is collapsed.
+     * @param onClick Optional function to be called when the image is
+     *     clicked. If onClick is defined, alt must also be defined.
+     * @param flipRtl Whether to flip the icon in RTL.
+     * @param 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/image#creation}
      * for a list of properties this parameter supports.
      */
-    constructor(src: string | Sentinel, width: string | number, height: string | number, opt_alt?: string, opt_onClick?: (p1: FieldImage) => any, opt_flipRtl?: boolean, opt_config?: FieldImageConfig);
+    constructor(src: string | typeof Field.SKIP_SETUP, width: string | number, height: string | number, alt?: string, onClick?: (p1: FieldImage) => void, flipRtl?: boolean, config?: FieldImageConfig);
     /**
      * Configure the field based on the given map of options.
      *
@@ -71,10 +68,10 @@ export declare class FieldImage extends Field<string> {
     /**
      * Ensure that the input value (the source URL) is a string.
      *
-     * @param opt_newValue The input value.
+     * @param newValue The input value.
      * @returns A string, or null if invalid.
      */
-    protected doClassValidation_(opt_newValue?: any): string | null;
+    protected doClassValidation_(newValue?: any): string | null;
     /**
      * Update the value of this image field, and update the displayed image.
      *
@@ -105,7 +102,7 @@ export declare class FieldImage extends Field<string> {
      * @param func The function that is called when the image is clicked, or null
      *     to remove.
      */
-    setOnClickHandler(func: ((p1: FieldImage) => any) | null): void;
+    setOnClickHandler(func: ((p1: FieldImage) => void) | null): void;
     /**
      * Use the `getText_` developer hook to override the field's text
      * representation.

package/core/field_input.d.ts

@@ -5,15 +5,18 @@
  */
 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<string | T>;
+/**
+ * Supported types for FieldInput subclasses.
+ *
+ * @internal
+ */
+type InputTypes = string | number;
 /**
  * Abstract class for an editable input field.
  *
- * @alias Blockly.FieldInput
  * @typeParam T - The value stored on the field.
+ * @internal
  */
 export declare abstract class FieldInput<T extends InputTypes> extends Field<string | T> {
     /**
@@ -50,20 +53,20 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
     /** Mouse cursor style when over the hotspot that initiates the editor. */
     CURSOR: string;
     /**
-     * @param opt_value The initial value of the field. Should cast to a string.
+     * @param 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
+     * @param 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.
+     * @param 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);
+    constructor(value?: string | typeof Field.SKIP_SETUP, validator?: FieldInputValidator<T> | null, config?: FieldInputConfig);
     protected configure_(config: FieldInputConfig): void;
     /** @internal */
     initView(): void;
@@ -109,12 +112,12 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      * 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
+     * @param _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.
+     * @param quietInput True if editor should be created without focus.
      *     Defaults to false.
      */
-    protected showEditor_(_opt_e?: Event, opt_quietInput?: boolean): void;
+    protected showEditor_(_e?: Event, 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
@@ -213,8 +216,28 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
 }
 /**
  * Config options for the input field.
+ *
+ * @internal
  */
 export interface FieldInputConfig extends FieldConfig {
     spellcheck?: boolean;
 }
+/**
+ * A function that is called to validate changes to the field's value before
+ * they are set.
+ *
+ * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @param newValue The value to be validated.
+ * @returns One of three instructions for setting the new value: `T`, `null`,
+ * or `undefined`.
+ *
+ * - `T` to set this function's returned value instead of `newValue`.
+ *
+ * - `null` to invoke `doValueInvalid_` and not set a value.
+ *
+ * - `undefined` to set `newValue` as is.
+ * @internal
+ */
+export type FieldInputValidator<T extends InputTypes> = FieldValidator<string | T>;
+export {};
 //# sourceMappingURL=field_input.d.ts.map

package/core/field_label.d.ts

@@ -4,14 +4,11 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 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<string> {
-    /** The html class name to use for this field. */
+    /** The HTML class name to use for this field. */
     private class_;
     /**
      * Editable fields usually show some sort of UI indicating they are
@@ -19,18 +16,18 @@ export declare class FieldLabel extends Field<string> {
      */
     EDITABLE: boolean;
     /**
-     * @param opt_value The initial value of the field. Should cast to a string.
+     * @param 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_class Optional CSS class for the field's text.
-     * @param opt_config A map of options used to configure the field.
+     * @param textClass Optional CSS class for the field's text.
+     * @param 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/label#creation}
      * for a list of properties this parameter supports.
      */
-    constructor(opt_value?: string | Sentinel, opt_class?: string, opt_config?: FieldLabelConfig);
+    constructor(value?: string | typeof Field.SKIP_SETUP, textClass?: string, config?: FieldLabelConfig);
     protected configure_(config: FieldLabelConfig): void;
     /**
      * Create block UI for this label.
@@ -41,10 +38,10 @@ export declare class FieldLabel extends Field<string> {
     /**
      * Ensure that the input value casts to a valid string.
      *
-     * @param opt_newValue The input value.
+     * @param newValue The input value.
      * @returns A valid string, or null if invalid.
      */
-    protected doClassValidation_(opt_newValue?: any): string | null;
+    protected doClassValidation_(newValue?: any): string | null;
     /**
      * Set the CSS class applied to the field's textElement_.
      *

package/core/field_label_serializable.d.ts

@@ -6,8 +6,6 @@
 import { FieldLabel, FieldLabelConfig, FieldLabelFromJsonConfig } from './field_label.js';
 /**
  * Class for a non-editable, serializable text field.
- *
- * @alias Blockly.FieldLabelSerializable
  */
 export declare class FieldLabelSerializable extends FieldLabel {
     /**
@@ -22,15 +20,15 @@ export declare class FieldLabelSerializable extends FieldLabel {
      */
     SERIALIZABLE: boolean;
     /**
-     * @param opt_value The initial value of the field. Should cast to a string.
+     * @param value The initial value of the field. Should cast to a string.
      *     Defaults to an empty string if null or undefined.
-     * @param opt_class Optional CSS class for the field's text.
-     * @param opt_config A map of options used to configure the field.
+     * @param textClass Optional CSS class for the field's text.
+     * @param 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/label-serializable#creation}
      * for a list of properties this parameter supports.
      */
-    constructor(opt_value?: string, opt_class?: string, opt_config?: FieldLabelConfig);
+    constructor(value?: string, textClass?: string, config?: FieldLabelConfig);
     /**
      * Construct a FieldLabelSerializable from a JSON arg object,
      * dereferencing any string table references.