blockly 11.0.0-beta.4 → 11.0.0-beta.5

package/browser.js

@@ -0,0 +1,30 @@
+/* eslint-disable */
+;(function(root, factory) {
+  if (typeof define === 'function' && define.amd) { // AMD
+    define(['./core-browser', './msg/en', './blocks', './javascript'], factory);
+  } else if (typeof exports === 'object') { // Node.js
+    module.exports = factory(require('./core-browser'), require('./msg/en'), require('./blocks'), require('./javascript'));
+  } else { // Browser
+    root.Blockly = factory(root.Blockly, root.En, root.BlocklyBlocks, root.BlocklyJS);
+  }
+}(this, function(Blockly, En, BlocklyBlocks, BlocklyJS) {
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview Blockly module for the browser. This includes Blockly core
+ * and built in blocks, the JavaScript code generator and the English block
+ * localization files.
+ */
+
+/* eslint-disable */
+'use strict';
+
+// Include the EN Locale by default.
+Blockly.setLocale(En);
+
+return Blockly;
+}));

package/core/block.d.ts

@@ -18,7 +18,7 @@ import type { Field } from './field.js';
 import { Input } from './inputs/input.js';
 import type { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
 import type { IDeletable } from './interfaces/i_deletable.js';
-import { type IIcon } from './interfaces/i_icon.js';
+import type { IIcon } from './interfaces/i_icon.js';
 import type { MutatorIcon } from './icons/mutator_icon.js';
 import * as Tooltip from './tooltip.js';
 import { Coordinate } from './utils/coordinate.js';
@@ -138,13 +138,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
     /**
      * 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 disposing;
     private readonly xy_;
     isInFlyout: boolean;
     isInMutator: boolean;
@@ -153,8 +147,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
     protected isInsertionMarker_: boolean;
     /** Name of the type of hat. */
     hat?: string;
-    /** Is this block a BlockSVG? */
-    readonly rendered: boolean;
+    rendered: boolean | null;
     /**
      * String for block help, or function that returns a URL. Null for no help.
      */

package/core/block_dragger.d.ts

@@ -31,13 +31,11 @@ export declare class BlockDragger implements IBlockDragger {
     /** Whether the block would be deleted if dropped immediately. */
     protected wouldDeleteBlock_: boolean;
     protected startXY_: Coordinate;
-    /** The parent block at the start of the drag. */
-    private startParentConn;
     /**
-     * The child block at the start of the drag. Only gets set if
-     * `healStack` is true.
+     * @deprecated To be removed in v11. Updating icons is now handled by the
+     *     block's `moveDuringDrag` method.
      */
-    private startChildConn;
+    protected dragIconData_: IconPositionData[];
     /**
      * @param block The block to drag.
      * @param workspace The workspace to drag on.
@@ -139,11 +137,6 @@ export declare class BlockDragger implements IBlockDragger {
      *     at the start of the drag, in pixel units.
      */
     endDrag(e: PointerEvent, currentDragDeltaXY: Coordinate): void;
-    /**
-     * Moves the dragged block back to its original position before the start of
-     * the drag. Reconnects any parent and child blocks.
-     */
-    private moveToOriginalPosition;
     /**
      * Calculates the drag delta and new location values after a block is dragged.
      *
@@ -196,6 +189,13 @@ export declare class BlockDragger implements IBlockDragger {
      * @returns The input coordinate divided by the workspace scale.
      */
     protected pixelsToWorkspaceUnits_(pixelCoord: Coordinate): Coordinate;
+    /**
+     * Move all of the icons connected to this drag.
+     *
+     * @deprecated To be removed in v11. This is now handled by the block's
+     *     `moveDuringDrag` method.
+     */
+    protected dragIcons_(): void;
     /**
      * Get a list of the insertion markers that currently exist.  Drags have 0, 1,
      * or 2 insertion markers.

package/core/block_svg.d.ts

@@ -10,6 +10,7 @@
  */
 import './events/events_selected.js';
 import { Block } from './block.js';
+import { CommentIcon } from './icons/comment_icon.js';
 import type { Connection } from './connection.js';
 import { ConnectionType } from './connection_type.js';
 import { ContextMenuOption, LegacyContextMenuOption } from './contextmenu_registry.js';
@@ -26,6 +27,7 @@ import type { IPathObject } from './renderers/common/i_path_object.js';
 import type { BlockStyle } from './theme.js';
 import { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';
+import { WarningIcon } from './icons/warning_icon.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 import { IconType } from './icons/icon_types.js';
@@ -66,12 +68,17 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
     private warningTextDb;
     /** Block's mutator icon (if any). */
     mutator: MutatorIcon | null;
+    /**
+     * Block's warning icon (if any).
+     *
+     * @deprecated Use `setWarningText` to modify warnings on this block.
+     */
+    warning: WarningIcon | null;
     private svgGroup_;
     style: BlockStyle;
     /** @internal */
     pathObject: IPathObject;
-    /** Is this block a BlockSVG? */
-    readonly rendered = true;
+    rendered: boolean;
     private visuallyDisabled;
     /**
      * Is this block currently rendering? Used to stop recursive render calls
@@ -85,6 +92,11 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
     nextConnection: RenderedConnection;
     previousConnection: RenderedConnection;
     private translation;
+    /**
+     * The ID of the setTimeout callback for bumping neighbours, or 0 if no bump
+     * is currently scheduled.
+     */
+    private bumpNeighboursPid;
     /** Whether this block is currently being dragged. */
     private dragging;
     /**
@@ -337,6 +349,14 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * @internal
      */
     updateDisabled(): void;
+    /**
+     * Get the comment icon attached to this block, or null if the block has no
+     * comment.
+     *
+     * @returns The comment icon attached to this block, or null.
+     * @deprecated Use getIcon. To be remove in v11.
+     */
+    getCommentIcon(): CommentIcon | null;
     /**
      * Set this block's warning text.
      *
@@ -486,7 +506,8 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * Returns connections originating from this block.
      *
      * @param all If true, return all connections even hidden ones.
-     *     Otherwise, for a collapsed block don't return inputs connections.
+     *     Otherwise, for a non-rendered block return an empty list, and for a
+     *     collapsed block don't return inputs connections.
      * @returns Array of connections.
      * @internal
      */
@@ -541,8 +562,14 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      */
     bumpNeighbours(): void;
     /**
-     * Snap to grid, and then bump neighbouring blocks away at the end of the next
-     * render.
+     * Bumps unconnected blocks out of alignment.
+     */
+    private bumpNeighboursInternal;
+    /**
+     * Schedule snapping to grid and bumping neighbours to occur after a brief
+     * delay.
+     *
+     * @internal
      */
     scheduleSnapAndBump(): void;
     /**

package/core/blockly.d.ts

@@ -14,6 +14,7 @@ import { BlockSvg } from './block_svg.js';
 import { BlocklyOptions } from './blockly_options.js';
 import { Blocks } from './blocks.js';
 import * as browserEvents from './browser_events.js';
+import { Bubble } from './bubbles/bubble.js';
 import * as bubbles from './bubbles.js';
 import { BubbleDragger } from './bubble_dragger.js';
 import * as bumpObjects from './bump_objects.js';
@@ -28,7 +29,6 @@ import { ConnectionType } from './connection_type.js';
 import * as ContextMenu from './contextmenu.js';
 import * as ContextMenuItems from './contextmenu_items.js';
 import { ContextMenuRegistry } from './contextmenu_registry.js';
-import * as comments from './comments.js';
 import * as Css from './css.js';
 import { DeleteArea } from './delete_area.js';
 import * as dialog from './dialog.js';
@@ -37,11 +37,14 @@ import * as dropDownDiv from './dropdowndiv.js';
 import * as Events from './events/events.js';
 import * as Extensions from './extensions.js';
 import { Field, FieldConfig, FieldValidator, UnattachedFieldError } from './field.js';
+import { FieldAngle, FieldAngleConfig, FieldAngleFromJsonConfig, FieldAngleValidator } from './field_angle.js';
 import { FieldCheckbox, FieldCheckboxConfig, FieldCheckboxFromJsonConfig, FieldCheckboxValidator } from './field_checkbox.js';
+import { FieldColour, FieldColourConfig, FieldColourFromJsonConfig, FieldColourValidator } from './field_colour.js';
 import { FieldDropdown, FieldDropdownConfig, FieldDropdownFromJsonConfig, FieldDropdownValidator, MenuGenerator, MenuGeneratorFunction, MenuOption } from './field_dropdown.js';
 import { FieldImage, FieldImageConfig, FieldImageFromJsonConfig } from './field_image.js';
 import { FieldLabel, FieldLabelConfig, FieldLabelFromJsonConfig } from './field_label.js';
 import { FieldLabelSerializable } from './field_label_serializable.js';
+import { FieldMultilineInput, FieldMultilineInputConfig, FieldMultilineInputFromJsonConfig, FieldMultilineInputValidator } from './field_multilineinput.js';
 import { FieldNumber, FieldNumberConfig, FieldNumberFromJsonConfig, FieldNumberValidator } from './field_number.js';
 import * as fieldRegistry from './field_registry.js';
 import { FieldTextInput, FieldTextInputConfig, FieldTextInputFromJsonConfig, FieldTextInputValidator } from './field_textinput.js';
@@ -56,10 +59,12 @@ import { Gesture } from './gesture.js';
 import { Grid } from './grid.js';
 import * as icons from './icons.js';
 import { inject } from './inject.js';
+import { Align } from './inputs/align.js';
 import { Input } from './inputs/input.js';
+import { inputTypes } from './inputs/input_types.js';
 import * as inputs from './inputs.js';
 import { InsertionMarkerManager } from './insertion_marker_manager.js';
-import { InsertionMarkerPreviewer } from './insertion_marker_previewer.js';
+import { InsertionMarkerPreviewer } from './connection_previewers/insertion_marker_previewer.js';
 import { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
 import { IASTNodeLocationSvg } from './interfaces/i_ast_node_location_svg.js';
 import { IASTNodeLocationWithBlock } from './interfaces/i_ast_node_location_with_block.js';
@@ -114,6 +119,7 @@ import * as renderManagement from './render_management.js';
 import * as blockRendering from './renderers/common/block_rendering.js';
 import * as constants from './constants.js';
 import * as geras from './renderers/geras/geras.js';
+import * as minimalist from './renderers/minimalist/minimalist.js';
 import * as thrasos from './renderers/thrasos/thrasos.js';
 import * as zelos from './renderers/zelos/zelos.js';
 import { Scrollbar } from './scrollbar.js';
@@ -157,6 +163,21 @@ import { ZoomControls } from './zoom_controls.js';
  * @define {string}
  */
 export declare const VERSION = "uncompiled";
+/**
+ * @see Blockly.Input.Align.LEFT
+ * @deprecated Use `Blockly.inputs.Align.LEFT`. To be removed in v11.
+ */
+export declare const ALIGN_LEFT = Align.LEFT;
+/**
+ * @see Blockly.Input.Align.CENTRE
+ * @deprecated Use `Blockly.inputs.Align.CENTER`. To be removed in v11.
+ */
+export declare const ALIGN_CENTRE = Align.CENTRE;
+/**
+ * @see Blockly.Input.Align.RIGHT
+ * @deprecated Use `Blockly.inputs.Align.RIGHT`. To be removed in v11.
+ */
+export declare const ALIGN_RIGHT = Align.RIGHT;
 /**
  * @see ConnectionType.INPUT_VALUE
  */
@@ -173,6 +194,11 @@ export declare const NEXT_STATEMENT = ConnectionType.NEXT_STATEMENT;
  * @see ConnectionType.PREVIOUS_STATEMENT
  */
 export declare const PREVIOUS_STATEMENT = ConnectionType.PREVIOUS_STATEMENT;
+/**
+ * @see inputTypes.DUMMY_INPUT
+ * @deprecated Use `Blockly.inputs.inputTypes.DUMMY`. To be removed in v11.
+ */
+export declare const DUMMY_INPUT = inputTypes.DUMMY;
 /** Aliases for toolbox positions. */
 /**
  * @see toolbox.Position.TOP
@@ -288,6 +314,7 @@ export { constants };
 export { dialog };
 export { fieldRegistry };
 export { geras };
+export { minimalist };
 export { registry };
 export { thrasos };
 export { uiPosition };
@@ -301,6 +328,8 @@ export { BlockDragger };
 export { BlockSvg };
 export { Blocks };
 export { bubbles };
+/** @deprecated Use Blockly.bubbles.Bubble instead. To be removed in v11. */
+export { Bubble };
 export { BubbleDragger };
 export { CollapsibleToolboxCategory };
 export { ComponentManager };
@@ -309,17 +338,19 @@ export { ConnectionType };
 export { ConnectionChecker };
 export { ConnectionDB };
 export { ContextMenuRegistry };
-export { comments };
 export { Cursor };
 export { DeleteArea };
 export { DragTarget };
 export declare const DropDownDiv: typeof dropDownDiv;
 export { Field, FieldConfig, FieldValidator, UnattachedFieldError };
+export { FieldAngle, FieldAngleConfig, FieldAngleFromJsonConfig, FieldAngleValidator, };
 export { FieldCheckbox, FieldCheckboxConfig, FieldCheckboxFromJsonConfig, FieldCheckboxValidator, };
+export { FieldColour, FieldColourConfig, FieldColourFromJsonConfig, FieldColourValidator, };
 export { FieldDropdown, FieldDropdownConfig, FieldDropdownFromJsonConfig, FieldDropdownValidator, MenuGenerator, MenuGeneratorFunction, MenuOption, };
 export { FieldImage, FieldImageConfig, FieldImageFromJsonConfig };
 export { FieldLabel, FieldLabelConfig, FieldLabelFromJsonConfig };
 export { FieldLabelSerializable };
+export { FieldMultilineInput, FieldMultilineInputConfig, FieldMultilineInputFromJsonConfig, FieldMultilineInputValidator, };
 export { FieldNumber, FieldNumberConfig, FieldNumberFromJsonConfig, FieldNumberValidator, };
 export { FieldTextInput, FieldTextInputConfig, FieldTextInputFromJsonConfig, FieldTextInputValidator, };
 export { FieldVariable, FieldVariableConfig, FieldVariableFromJsonConfig, FieldVariableValidator, };
@@ -402,6 +433,10 @@ export { WorkspaceDragger };
 export { WorkspaceSvg };
 export { ZoomControls };
 export { config };
+/** @deprecated Use Blockly.ConnectionType instead. */
+export declare const connectionTypes: typeof ConnectionType;
 export { inject };
+/** @deprecated Use Blockly.inputs.inputTypes instead. To be removed in v11. */
+export { inputTypes };
 export { serialization };
 //# sourceMappingURL=blockly.d.ts.map

package/core/clipboard.d.ts

@@ -8,6 +8,14 @@ import { BlockPaster } from './clipboard/block_paster.js';
 import { WorkspaceSvg } from './workspace_svg.js';
 import * as registry from './clipboard/registry.js';
 import { Coordinate } from './utils/coordinate.js';
+/**
+ * Copy a copyable element onto the local clipboard.
+ *
+ * @param toCopy The copyable element to be copied.
+ * @deprecated v11. Use `myCopyable.toCopyData()` instead. To be removed v12.
+ * @internal
+ */
+export declare function copy<T extends ICopyData>(toCopy: ICopyable<T>): T | null;
 /**
  * Private version of copy for stubbing in tests.
  */
@@ -27,6 +35,17 @@ export declare function paste<T extends ICopyData>(copyData: T, workspace: Works
  * @returns the pasted thing if the paste was successful, null otherwise.
  */
 export declare function paste(): ICopyable<ICopyData> | null;
+/**
+ * Duplicate this copy-paste-able element.
+ *
+ * @param toDuplicate The element to be duplicated.
+ * @returns The element that was duplicated, or null if the duplication failed.
+ * @deprecated v11. Use
+ *     `Blockly.clipboard.paste(myCopyable.toCopyData(), myWorkspace)` instead.
+ *     To be removed v12.
+ * @internal
+ */
+export declare function duplicate<U extends ICopyData, T extends ICopyable<U> & IHasWorkspace>(toDuplicate: T): T | null;
 /**
  * Private version of duplicate for stubbing in tests.
  */

package/core/{insertion_marker_previewer.d.ts → connection_previewers/insertion_marker_previewer.d.ts}

@@ -3,9 +3,9 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { BlockSvg } from './block_svg.js';
-import { IConnectionPreviewer } from './interfaces/i_connection_previewer.js';
-import { RenderedConnection } from './rendered_connection.js';
+import { BlockSvg } from '../block_svg.js';
+import { IConnectionPreviewer } from '../interfaces/i_connection_previewer.js';
+import { RenderedConnection } from '../rendered_connection.js';
 export declare class InsertionMarkerPreviewer implements IConnectionPreviewer {
     private readonly workspace;
     private fadedBlock;

package/core/events/events_click.d.ts

@@ -13,7 +13,7 @@ import { AbstractEventJson } from './events_abstract.js';
 import { UiBase } from './events_ui_base.js';
 import { Workspace } from '../workspace.js';
 /**
- * Notifies listeners that some blockly element was clicked.
+ * Notifies listeners that ome blockly element was clicked.
  */
 export declare class Click extends UiBase {
     /** The ID of the block that was clicked, if a block was clicked. */

package/core/field_angle.d.ts

@@ -0,0 +1,208 @@
+/**
+ * @license
+ * Copyright 2013 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Field } from './field.js';
+import { FieldInput, FieldInputConfig, FieldInputValidator } from './field_input.js';
+/**
+ * Class for an editable angle field.
+ */
+export declare class FieldAngle extends FieldInput<number> {
+    /** Half the width of protractor image. */
+    static readonly HALF: number;
+    /**
+     * Radius of protractor circle.  Slightly smaller than protractor size since
+     * otherwise SVG crops off half the border at the edges.
+     */
+    static readonly RADIUS: number;
+    /**
+     * Default property describing which direction makes an angle field's value
+     * increase. Angle increases clockwise (true) or counterclockwise (false).
+     */
+    static readonly CLOCKWISE = false;
+    /**
+     * The default offset of 0 degrees (and all angles). Always offsets in the
+     * counterclockwise direction, regardless of the field's clockwise property.
+     * Usually either 0 (0 = right) or 90 (0 = up).
+     */
+    static readonly OFFSET = 0;
+    /**
+     * The default maximum angle to allow before wrapping.
+     * Usually either 360 (for 0 to 359.9) or 180 (for -179.9 to 180).
+     */
+    static readonly WRAP = 360;
+    /**
+     * The default amount to round angles to when using a mouse or keyboard nav
+     * input. Must be a positive integer to support keyboard navigation.
+     */
+    static readonly ROUND = 15;
+    /**
+     * Whether the angle should increase as the angle picker is moved clockwise
+     * (true) or counterclockwise (false).
+     */
+    private clockwise;
+    /**
+     * The offset of zero degrees (and all other angles).
+     */
+    private offset;
+    /**
+     * The maximum angle to allow before wrapping.
+     */
+    private wrap;
+    /**
+     * The amount to round angles to when using a mouse or keyboard nav input.
+     */
+    private round;
+    /**
+     * Array holding info needed to unbind events.
+     * Used for disposing.
+     * Ex: [[node, name, func], [node, name, func]].
+     */
+    private boundEvents;
+    /** Dynamic red line pointing at the value's angle. */
+    private line;
+    /** Dynamic pink area extending from 0 to the value's angle. */
+    private gauge;
+    /** The degree symbol for this field. */
+    protected symbol_: SVGTSpanElement | null;
+    /**
+     * @param value The initial value of the field. Should cast to a number.
+     *     Defaults to 0. 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 validator A function that is called to validate changes to the
+     *     field's value. Takes in a number & returns a validated number, 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/angle#creation}
+     * for a list of properties this parameter supports.
+     */
+    constructor(value?: string | number | typeof Field.SKIP_SETUP, validator?: FieldAngleValidator, config?: FieldAngleConfig);
+    /**
+     * Configure the field based on the given map of options.
+     *
+     * @param config A map of options to configure the field based on.
+     */
+    protected configure_(config: FieldAngleConfig): void;
+    /**
+     * Create the block UI for this field.
+     */
+    initView(): void;
+    /** Updates the angle when the field rerenders. */
+    protected render_(): void;
+    /**
+     * Create and show the angle field's editor.
+     *
+     * @param e Optional mouse event that triggered the field to open,
+     *     or undefined if triggered programmatically.
+     */
+    protected showEditor_(e?: Event): void;
+    /**
+     * Creates the angle dropdown editor.
+     *
+     * @returns The newly created slider.
+     */
+    private dropdownCreate;
+    /** Disposes of events and DOM-references belonging to the angle editor. */
+    private dropdownDispose;
+    /** Hide the editor. */
+    private hide;
+    /**
+     * Set the angle to match the mouse's position.
+     *
+     * @param e Mouse move event.
+     */
+    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
+     * that the text input's value is appropriate.
+     *
+     * @param angle New angle.
+     */
+    private displayMouseOrKeyboardValue;
+    /** Redraw the graph with the current angle. */
+    private updateGraph;
+    /**
+     * Handle key down to the editor.
+     *
+     * @param e Keyboard event.
+     */
+    protected onHtmlInputKeyDown_(e: KeyboardEvent): void;
+    /**
+     * Ensure that the input value is a valid angle.
+     *
+     * @param newValue The input value.
+     * @returns A valid angle, or null if invalid.
+     */
+    protected doClassValidation_(newValue?: any): number | null;
+    /**
+     * Wraps the value so that it is in the range (-360 + wrap, wrap).
+     *
+     * @param value The value to wrap.
+     * @returns The wrapped value.
+     */
+    private wrapValue;
+    /**
+     * Construct a FieldAngle from a JSON arg object.
+     *
+     * @param options A JSON object with options (angle).
+     * @returns The new field instance.
+     * @nocollapse
+     * @internal
+     */
+    static fromJson(options: FieldAngleFromJsonConfig): FieldAngle;
+}
+/**
+ * The two main modes of the angle field.
+ * Compass specifies:
+ *   - clockwise: true
+ *   - offset: 90
+ *   - wrap: 0
+ *   - round: 15
+ *
+ * Protractor specifies:
+ *   - clockwise: false
+ *   - offset: 0
+ *   - wrap: 0
+ *   - round: 15
+ */
+export declare enum Mode {
+    COMPASS = "compass",
+    PROTRACTOR = "protractor"
+}
+/**
+ * Extra configuration options for the angle field.
+ */
+export interface FieldAngleConfig extends FieldInputConfig {
+    mode?: Mode;
+    clockwise?: boolean;
+    offset?: number;
+    wrap?: number;
+    round?: number;
+}
+/**
+ * fromJson configuration options for the angle field.
+ */
+export interface FieldAngleFromJsonConfig extends FieldAngleConfig {
+    angle?: number;
+}
+/**
+ * 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 FieldAngleValidator = FieldInputValidator<number>;
+//# sourceMappingURL=field_angle.d.ts.map