blockly 9.2.0 → 9.3.0-beta.0

package/core/events/events_viewport.d.ts

@@ -7,14 +7,27 @@ 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.
+ * Notifies listeners that the workspace surface's position or scale has
+ * changed.
+ *
+ * Does not notify when the workspace itself resizes.
  *
  * @alias Blockly.Events.ViewportChange
  */
 export declare class ViewportChange extends UiBase {
+    /**
+     * Top edge of the visible portion of the workspace, relative to the
+     * workspace origin.
+     */
     viewTop?: number;
+    /**
+     * The left edge of the visible portion of the workspace, relative to
+     * the workspace origin.
+     */
     viewLeft?: number;
+    /** The scale of the workpace. */
     scale?: number;
+    /** The previous scale of the workspace. */
     oldScale?: number;
     type: string;
     /**

package/core/events/utils.d.ts

@@ -180,22 +180,6 @@ 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.

package/core/events/workspace_events.d.ts

@@ -6,10 +6,8 @@
 import type { Workspace } from '../workspace.js';
 import { Abstract as AbstractEvent, AbstractEventJson } from './events_abstract.js';
 /**
- * Class for a finished loading event.
- * Used to notify the developer when the workspace has finished loading (i.e
- * domToWorkspace).
- * Finished loading events do not record undo or redo.
+ * Notifies listeners when the workspace has finished deserializing from
+ * JSON/XML.
  *
  * @alias Blockly.Events.FinishedLoading
  */

package/core/field.d.ts

@@ -17,11 +17,29 @@ 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;
+/**
+ * A function that is called to validate changes to the field's value before
+ * they are set.
+ *
+ * **NOTE:** Validation returns one option between `T`, `null`, and `undefined`.
+ *
+ * @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 FieldValidator<T = any> = (newValue: T) => T | null | undefined;
 /**
  * Abstract class for an editable field.
  *
  * @alias Blockly.Field
+ * @typeParam T - The value stored on the field.
  */
 export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IASTNodeLocationWithBlock, IKeyboardAccessible, IRegistrable {
     /**
@@ -42,6 +60,7 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      * instead.
      */
     static readonly SKIP_SETUP: Sentinel;
+    static isSentinel<T>(value: T | Sentinel): value is Sentinel;
     /**
      * Name of field.  Unique within each block.
      * Static labels are usually unnamed.
@@ -336,7 +355,7 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      *
      * @returns Validation function, or null.
      */
-    getValidator(): Function | null;
+    getValidator(): FieldValidator<T> | null;
     /**
      * Gets the group element for this editable field.
      * Used for measuring the size and for positioning.
@@ -495,22 +514,36 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      *
      * @returns Current value.
      */
-    getValue(): any;
+    getValue(): T | null;
     /**
-     * Used to validate a value. Returns input by default. Can be overridden by
-     * subclasses, see FieldDropdown.
+     * Validate the changes to a field's value before they are set. See
+     * **FieldDropdown** for an example of subclass implementation.
+     *
+     * **NOTE:** Validation returns one option between `T`, `null`, and
+     * `undefined`. **Field**'s implementation will never return `undefined`, but
+     * it is valid for a subclass to return `undefined` if the new value is
+     * compatible with `T`.
+     *
+     * @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.
      *
-     * @param opt_newValue The value to be validated.
-     * @returns The validated value, same as input by default.
+     * - `undefined` to set `newValue` as is.
      */
-    protected doClassValidation_(opt_newValue?: any): any;
+    protected doClassValidation_(newValue: T): T | null | undefined;
+    protected doClassValidation_(newValue?: any): T | null;
     /**
      * Used to update the value of a field. Can be overridden by subclasses to do
      * custom storage of values/updating of external things.
      *
      * @param newValue The value to be saved.
      */
-    protected doValueUpdate_(newValue: any): void;
+    protected doValueUpdate_(newValue: T): void;
     /**
      * Used to notify the field an invalid value was input. Can be overridden by
      * subclasses, see FieldTextInput.

package/core/field_angle.d.ts

@@ -138,7 +138,7 @@ export declare class FieldAngle extends FieldInput<number> {
      *
      * @param e Keyboard event.
      */
-    protected onHtmlInputKeyDown_(e: Event): void;
+    protected onHtmlInputKeyDown_(e: KeyboardEvent): void;
     /**
      * Ensure that the input value is a valid angle.
      *

package/core/field_checkbox.d.ts

@@ -6,13 +6,15 @@
 import './events/events_block_change.js';
 import { Field, FieldConfig, FieldValidator } from './field.js';
 import type { Sentinel } from './utils/sentinel.js';
-export type FieldCheckboxValidator = FieldValidator<boolean>;
+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<boolean> {
+export declare class FieldCheckbox extends Field<CheckboxBool> {
     /** Default character for the checkmark. */
     static readonly CHECK_CHAR = "\u2713";
     private checkChar_;
@@ -25,7 +27,11 @@ export declare class FieldCheckbox extends Field<boolean> {
      * Mouse cursor style when over the hotspot that initiates editability.
      */
     CURSOR: string;
-    value_: any;
+    /**
+     * NOTE: The default value is set in `Field`, so maintain that value instead
+     * of overwriting it here or in the constructor.
+     */
+    value_: boolean | null;
     /**
      * @param opt_value The initial value of the field. Should either be 'TRUE',
      *     'FALSE' or a boolean. Defaults to 'FALSE'. Also accepts
@@ -40,7 +46,7 @@ export declare class FieldCheckbox extends Field<boolean> {
      * 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?: FieldCheckboxValidator, opt_config?: FieldCheckboxConfig);
+    constructor(opt_value?: CheckboxBool | Sentinel, opt_validator?: FieldCheckboxValidator, opt_config?: FieldCheckboxConfig);
     /**
      * Configure the field based on the given map of options.
      *
@@ -77,26 +83,26 @@ export declare class FieldCheckbox extends Field<boolean> {
      * @param opt_newValue The input value.
      * @returns A valid value ('TRUE' or 'FALSE), or null if invalid.
      */
-    protected doClassValidation_(opt_newValue?: any): string | null;
+    protected doClassValidation_(opt_newValue?: any): BoolString | null;
     /**
      * Update the value of the field, and update the checkElement.
      *
      * @param newValue The value to be saved. The default validator guarantees
      *     that this is a either 'TRUE' or 'FALSE'.
      */
-    protected doValueUpdate_(newValue: any): void;
+    protected doValueUpdate_(newValue: BoolString): void;
     /**
      * Get the value of this field, either 'TRUE' or 'FALSE'.
      *
      * @returns The value of this field.
      */
-    getValue(): string;
+    getValue(): BoolString;
     /**
      * Get the boolean value of this field.
      *
      * @returns The boolean value of this field.
      */
-    getValueBoolean(): boolean;
+    getValueBoolean(): boolean | null;
     /**
      * Get the text of this field. Used when the block is collapsed.
      *
@@ -135,4 +141,5 @@ export interface FieldCheckboxConfig extends FieldConfig {
 export interface FieldCheckboxFromJsonConfig extends FieldCheckboxConfig {
     checked?: boolean;
 }
+export {};
 //# sourceMappingURL=field_checkbox.d.ts.map

package/core/field_colour.d.ts

@@ -69,9 +69,6 @@ export declare class FieldColour extends Field<string> {
      * setting. By default use the global constants for columns.
      */
     private columns_;
-    size_: any;
-    clickTarget_: any;
-    value_: any;
     /**
      * @param opt_value The initial value of the field. Should be in '#rrggbb'
      *     format. Defaults to the first value in the default colour array. Also
@@ -113,7 +110,7 @@ export declare class FieldColour extends Field<string> {
      * @param newValue The value to be saved. The default validator guarantees
      *     that this is a colour in '#rrggbb' format.
      */
-    protected doValueUpdate_(newValue: any): void;
+    protected doValueUpdate_(newValue: string): void;
     /**
      * Get the text for this field.  Used when the block is collapsed.
      *

package/core/field_dropdown.d.ts

@@ -154,14 +154,14 @@ export declare class FieldDropdown extends Field<string> {
      * @param opt_newValue The input value.
      * @returns A valid language-neutral option, or null if invalid.
      */
-    protected doClassValidation_(opt_newValue?: MenuOption[1]): string | null;
+    protected doClassValidation_(opt_newValue?: string): string | null;
     /**
      * Update the value of this dropdown field.
      *
      * @param newValue The value to be saved. The default validator guarantees
      *     that this is one of the valid dropdown options.
      */
-    protected doValueUpdate_(newValue: MenuOption[1]): void;
+    protected doValueUpdate_(newValue: string): void;
     /**
      * Updates the dropdown arrow to match the colour/style of the block.
      *

package/core/field_image.d.ts

@@ -38,7 +38,6 @@ export declare class FieldImage extends Field<string> {
     private flipRtl_;
     /** Alt text of this image. */
     private altText_;
-    value_: any;
     /**
      * @param src The URL of the image.
      *     Also accepts Field.SKIP_SETUP if you wish to skip setup (only used by
@@ -82,7 +81,7 @@ export declare class FieldImage extends Field<string> {
      * @param newValue The value to be saved. The default validator guarantees
      *     that this is a string.
      */
-    protected doValueUpdate_(newValue: any): void;
+    protected doValueUpdate_(newValue: string): void;
     /**
      * Get whether to flip this image in RTL
      *

package/core/field_input.d.ts

@@ -8,13 +8,14 @@ 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>;
+export type FieldInputValidator<T extends InputTypes> = FieldValidator<string | T>;
 /**
- * Class for an editable text field.
+ * Abstract class for an editable input field.
  *
  * @alias Blockly.FieldInput
+ * @typeParam T - The value stored on the field.
  */
-export declare abstract class FieldInput<T extends InputTypes> extends Field<T> {
+export declare abstract class FieldInput<T extends InputTypes> extends Field<string | T> {
     /**
      * Pixel size of input border radius.
      * Should match blocklyText's border-radius in CSS.
@@ -48,9 +49,6 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<T>
     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
@@ -69,13 +67,6 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<T>
     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
@@ -94,7 +85,7 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<T>
      * @param newValue The value to be saved. The default validator guarantees
      *     that this is a string.
      */
-    protected doValueUpdate_(newValue: any): void;
+    protected doValueUpdate_(newValue: string | T): void;
     /**
      * Updates text field to match the colour/style of the block.
      *
@@ -166,7 +157,7 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<T>
      *
      * @param e Keyboard event.
      */
-    protected onHtmlInputKeyDown_(e: Event): void;
+    protected onHtmlInputKeyDown_(e: KeyboardEvent): void;
     /**
      * Handle a change to the editor.
      *

package/core/field_multilineinput.d.ts

@@ -94,7 +94,7 @@ export declare class FieldMultilineInput extends FieldTextInput {
      * @param newValue The value to be saved. The default validator guarantees
      *     that this is a string.
      */
-    protected doValueUpdate_(newValue: any): void;
+    protected doValueUpdate_(newValue: string): void;
     /** Updates the text of the textElement. */
     protected render_(): void;
     /** Updates the size of the field based on the text. */
@@ -135,7 +135,7 @@ export declare class FieldMultilineInput extends FieldTextInput {
      *
      * @param e Keyboard event.
      */
-    protected onHtmlInputKeyDown_(e: Event): void;
+    protected onHtmlInputKeyDown_(e: KeyboardEvent): void;
     /**
      * Construct a FieldMultilineInput from a JSON arg object,
      * dereferencing any string table references.

package/core/field_textinput.d.ts

@@ -7,6 +7,11 @@ import './events/events_block_change.js';
 import { FieldInput, FieldInputConfig, FieldInputValidator } from './field_input.js';
 import type { Sentinel } from './utils/sentinel.js';
 export type FieldTextInputValidator = FieldInputValidator<string>;
+/**
+ * Class for an editable text field.
+ *
+ * @alias Blockly.FieldTextInput
+ */
 export declare class FieldTextInput extends FieldInput<string> {
     /**
      * @param opt_value The initial value of the field. Should cast to a string.
@@ -23,6 +28,13 @@ export declare class FieldTextInput extends FieldInput<string> {
      * for a list of properties this parameter supports.
      */
     constructor(opt_value?: string | Sentinel, opt_validator?: FieldTextInputValidator | null, opt_config?: FieldInputConfig);
+    /**
+     * 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): string | null;
     /**
      * Construct a FieldTextInput from a JSON arg object,
      * dereferencing any string table references.

package/core/field_variable.d.ts

@@ -139,7 +139,7 @@ export declare class FieldVariable extends FieldDropdown {
      *
      * @returns Validation function, or null.
      */
-    getValidator(): Function | null;
+    getValidator(): FieldVariableValidator | null;
     /**
      * Ensure that the ID belongs to a valid variable of an allowed type.
      *
@@ -155,7 +155,7 @@ export declare class FieldVariable extends FieldDropdown {
      *
      * @param newId The value to be saved.
      */
-    protected doValueUpdate_(newId: any): void;
+    protected doValueUpdate_(newId: string): void;
     /**
      * Check whether the given variable type is allowed on this field.
      *

package/core/gesture.d.ts

@@ -360,7 +360,7 @@ export declare class Gesture {
      * @param field The field the gesture started on.
      * @internal
      */
-    setStartField(field: Field): void;
+    setStartField<T>(field: Field<T>): void;
     /**
      * Record the bubble that a gesture started on
      *

package/core/interfaces/i_block_dragger.d.ts

@@ -12,7 +12,7 @@ import type { BlockSvg } from '../block_svg.js';
  */
 export interface IBlockDragger {
     /**
-     * Start dragging a block.  This includes moving it to the drag surface.
+     * Start dragging a block.
      *
      * @param currentDragDeltaXY How far the pointer has moved from the position
      *     at mouse down, in pixel units.

package/core/interfaces/i_bubble.d.ts

@@ -4,7 +4,6 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Coordinate } from '../utils/coordinate.js';
-import type { BlockDragSurfaceSvg } from '../block_drag_surface.js';
 import type { IContextMenu } from './i_contextmenu.js';
 import type { IDraggable } from './i_draggable.js';
 /**
@@ -41,14 +40,11 @@ export interface IBubble extends IDraggable, IContextMenu {
      */
     setDragging(dragging: boolean): void;
     /**
-     * Move this bubble during a drag, taking into account whether or not there is
-     * a drag surface.
+     * Move this bubble during a drag.
      *
-     * @param dragSurface The surface that carries rendered items during a drag,
-     *     or null if no drag surface is in use.
      * @param newLoc The location to translate to, in workspace coordinates.
      */
-    moveDuringDrag(dragSurface: BlockDragSurfaceSvg | null, newLoc: Coordinate): void;
+    moveDuringDrag(newLoc: Coordinate): void;
     /**
      * Move the bubble to the specified location in workspace coordinates.
      *

package/core/interfaces/i_metrics_manager.d.ts

@@ -34,11 +34,14 @@ export interface IMetricsManager {
      */
     getScrollMetrics(opt_getWorkspaceCoordinates?: boolean, opt_viewMetrics?: ContainerRegion, opt_contentMetrics?: ContainerRegion): ContainerRegion;
     /**
-     * Gets the width and the height of the flyout on the workspace in pixel
-     * coordinates. Returns 0 for the width and height if the workspace has a
-     * category toolbox instead of a simple toolbox.
+     * Gets the width and the height of the flyout in pixel
+     * coordinates. By default, will get metrics for either a simple flyout (owned
+     * directly by the workspace) or for the flyout owned by the toolbox. If you
+     * pass `opt_own` as `true` then only metrics for the simple flyout will be
+     * returned, and it will return 0 for the width and height if the workspace
+     * has a category toolbox instead of a simple toolbox.
      *
-     * @param opt_own Whether to only return the workspace's own flyout.
+     * @param opt_own Whether to only return the workspace's own flyout metrics.
      * @returns The width and height of the flyout.
      */
     getFlyoutMetrics(opt_own?: boolean): ToolboxMetrics;
@@ -46,8 +49,7 @@ export interface IMetricsManager {
      * Gets the width, height and position of the toolbox on the workspace in
      * pixel coordinates. Returns 0 for the width and height if the workspace has
      * a simple toolbox instead of a category toolbox. To get the width and height
-     * of a
-     * simple toolbox @see {@link IMetricsManager#getFlyoutMetrics}.
+     * of a simple toolbox, see {@link IMetricsManager#getFlyoutMetrics}.
      *
      * @returns The object with the width, height and position of the toolbox.
      */

package/core/interfaces/i_procedure_block.d.ts

@@ -4,9 +4,12 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Block } from '../block.js';
+import { IProcedureModel } from './i_procedure_model.js';
 /** The interface for a block which models a procedure. */
 export interface IProcedureBlock {
+    getProcedureModel(): IProcedureModel;
     doProcedureUpdate(): void;
+    isProcedureDef(): boolean;
 }
 /** A type guard which checks if the given block is a procedure block. */
 export declare function isProcedureBlock(block: Block | IProcedureBlock): block is IProcedureBlock;

package/core/metrics_manager.d.ts

@@ -30,11 +30,14 @@ export declare class MetricsManager implements IMetricsManager {
      */
     protected getDimensionsPx_(elem: IToolbox | null | IFlyout): Size;
     /**
-     * Gets the width and the height of the flyout on the workspace in pixel
-     * coordinates. Returns 0 for the width and height if the workspace has a
-     * category toolbox instead of a simple toolbox.
+     * Gets the width and the height of the flyout in pixel
+     * coordinates. By default, will get metrics for either a simple flyout (owned
+     * directly by the workspace) or for the flyout owned by the toolbox. If you
+     * pass `opt_own` as `true` then only metrics for the simple flyout will be
+     * returned, and it will return 0 for the width and height if the workspace
+     * has a category toolbox instead of a simple toolbox.
      *
-     * @param opt_own Whether to only return the workspace's own flyout.
+     * @param opt_own Whether to only return the workspace's own flyout metrics.
      * @returns The width and height of the flyout.
      */
     getFlyoutMetrics(opt_own?: boolean): ToolboxMetrics;
@@ -42,8 +45,7 @@ export declare class MetricsManager implements IMetricsManager {
      * Gets the width, height and position of the toolbox on the workspace in
      * pixel coordinates. Returns 0 for the width and height if the workspace has
      * a simple toolbox instead of a category toolbox. To get the width and height
-     * of a
-     * simple toolbox @see {@link MetricsManager#getFlyoutMetrics}.
+     * of a simple toolbox, see {@link MetricsManager#getFlyoutMetrics}.
      *
      * @returns The object with the width, height and position of the toolbox.
      */

package/core/{procedures/observable_procedure_map.d.ts → observable_procedure_map.d.ts}

@@ -3,12 +3,11 @@
  * Copyright 2022 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { IProcedureMap } from '../interfaces/i_procedure_map.js';
-import type { IProcedureModel } from '../interfaces/i_procedure_model.js';
-import type { Workspace } from '../workspace.js';
+import { IProcedureMap } from './interfaces/i_procedure_map.js';
+import type { IProcedureModel } from './interfaces/i_procedure_model.js';
 export declare class ObservableProcedureMap extends Map<string, IProcedureModel> implements IProcedureMap {
-    private readonly workspace;
-    constructor(workspace: Workspace);
+    /** @internal */
+    constructor();
     /**
      * Adds the given procedure model to the procedure map.
      */

package/core/procedures.d.ts

@@ -7,9 +7,11 @@ import './events/events_block_change.js';
 import type { Block } from './block.js';
 import type { Abstract } from './events/events_abstract.js';
 import { Field } from './field.js';
-import { ObservableProcedureMap } from './procedures/observable_procedure_map.js';
-import { ObservableProcedureModel } from './procedures/observable_procedure_model.js';
-import { ObservableParameterModel } from './procedures/observable_parameter_model.js';
+import { IParameterModel } from './interfaces/i_parameter_model.js';
+import { IProcedureMap } from './interfaces/i_procedure_map.js';
+import { IProcedureModel } from './interfaces/i_procedure_model.js';
+import { IProcedureBlock, isProcedureBlock } from './interfaces/i_procedure_block.js';
+import { ObservableProcedureMap } from './observable_procedure_map.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
@@ -125,5 +127,5 @@ export declare function mutateCallers(defBlock: Block): void;
  * @alias Blockly.Procedures.getDefinition
  */
 export declare function getDefinition(name: string, workspace: Workspace): Block | null;
-export { ObservableProcedureMap, ObservableProcedureModel, ObservableParameterModel, };
+export { ObservableProcedureMap, IParameterModel, IProcedureBlock, isProcedureBlock, IProcedureMap, IProcedureModel, };
 //# sourceMappingURL=procedures.d.ts.map

package/core/serialization/procedures.d.ts

@@ -6,8 +6,6 @@
 import { IParameterModel } from '../interfaces/i_parameter_model.js';
 import { IProcedureModel } from '../interfaces/i_procedure_model.js';
 import type { ISerializer } from '../interfaces/i_serializer.js';
-import { ObservableProcedureModel } from '../procedures/observable_procedure_model.js';
-import { ObservableParameterModel } from '../procedures/observable_parameter_model.js';
 import type { Workspace } from '../workspace.js';
 /**
  * Representation of a procedure data model.
@@ -93,10 +91,5 @@ export declare class ProcedureSerializer<ProcedureModel extends IProcedureModel,
     /** Disposes of any procedure models that exist on the workspace. */
     clear(workspace: Workspace): void;
 }
-/**
- * A ProcedureSerializer that deserializes to create the built-in
- * ObservableProcedureModels and ObservableParameterModels.
- */
-export declare const observableProcedureSerializer: ProcedureSerializer<ObservableProcedureModel, ObservableParameterModel>;
 export {};
 //# sourceMappingURL=procedures.d.ts.map

package/core/utils/sentinel.d.ts

@@ -9,5 +9,10 @@
  * @alias Blockly.utils.Sentinel
  */
 export declare class Sentinel {
+    /**
+     * Provide a unique key so that type guarding properly excludes values like
+     * string.
+     */
+    UNIQUE_KEY?: never;
 }
 //# sourceMappingURL=sentinel.d.ts.map