blockly 10.0.0-beta.0 → 10.0.1

package/core/blockly.d.ts

@@ -14,7 +14,8 @@ 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 './bubble_old.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';
 import * as clipboard from './clipboard.js';
@@ -56,14 +57,12 @@ import { VerticalFlyout } from './flyout_vertical.js';
 import { CodeGenerator } from './generator.js';
 import { Gesture } from './gesture.js';
 import { Grid } from './grid.js';
-import { Icon } from './icons/icon.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 { DummyInput } from './inputs/dummy_input.js';
-import { StatementInput } from './inputs/statement_input.js';
-import { ValueInput } from './inputs/value_input.js';
+import * as inputs from './inputs.js';
 import { InsertionMarkerManager } from './insertion_marker_manager.js';
 import { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
 import { IASTNodeLocationSvg } from './interfaces/i_ast_node_location_svg.js';
@@ -82,6 +81,8 @@ import { IDeleteArea } from './interfaces/i_delete_area.js';
 import { IDragTarget } from './interfaces/i_drag_target.js';
 import { IDraggable } from './interfaces/i_draggable.js';
 import { IFlyout } from './interfaces/i_flyout.js';
+import { IHasBubble, hasBubble } from './interfaces/i_has_bubble.js';
+import { IIcon, isIcon } from './interfaces/i_icon.js';
 import { IKeyboardAccessible } from './interfaces/i_keyboard_accessible.js';
 import { IMetricsManager } from './interfaces/i_metrics_manager.js';
 import { IMovable } from './interfaces/i_movable.js';
@@ -90,6 +91,7 @@ import { IPositionable } from './interfaces/i_positionable.js';
 import { IRegistrable } from './interfaces/i_registrable.js';
 import { ISelectable } from './interfaces/i_selectable.js';
 import { ISelectableToolboxItem } from './interfaces/i_selectable_toolbox_item.js';
+import { ISerializable, isSerializable } from './interfaces/i_serializable.js';
 import { IStyleable } from './interfaces/i_styleable.js';
 import { IToolbox } from './interfaces/i_toolbox.js';
 import { IToolboxItem } from './interfaces/i_toolbox_item.js';
@@ -160,16 +162,19 @@ import { ZoomControls } from './zoom_controls.js';
 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 = Input.Align.LEFT;
+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 = Input.Align.CENTRE;
+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 = Input.Align.RIGHT;
+export declare const ALIGN_RIGHT = Align.RIGHT;
 /**
  * @see ConnectionType.INPUT_VALUE
  */
@@ -188,6 +193,7 @@ export declare const NEXT_STATEMENT = ConnectionType.NEXT_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. */
@@ -318,6 +324,8 @@ export { BlocklyOptions };
 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 };
@@ -362,7 +370,6 @@ export { ICollapsibleToolboxItem };
 export { IComponent };
 export { IConnectionChecker };
 export { IContextMenu };
-export { Icon };
 export { icons };
 export { ICopyable };
 export { IDeletable };
@@ -370,23 +377,20 @@ export { IDeleteArea };
 export { IDragTarget };
 export { IDraggable };
 export { IFlyout };
+export { IHasBubble, hasBubble };
+export { IIcon, isIcon };
 export { IKeyboardAccessible };
 export { IMetricsManager };
 export { IMovable };
 export { Input };
-export declare const inputs: {
-    Input: typeof Input;
-    inputTypes: typeof inputTypes;
-    DummyInput: typeof DummyInput;
-    StatementInput: typeof StatementInput;
-    ValueInput: typeof ValueInput;
-};
+export { inputs };
 export { InsertionMarkerManager };
 export { IObservable, isObservable };
 export { IPositionable };
 export { IRegistrable };
 export { ISelectable };
 export { ISelectableToolboxItem };
+export { ISerializable, isSerializable };
 export { IStyleable };
 export { IToolbox };
 export { IToolboxItem };
@@ -426,6 +430,7 @@ 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/bubbles/bubble.d.ts

@@ -8,6 +8,11 @@ import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { Size } from '../utils/size.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
+/**
+ * The abstract pop-up bubble class. This creates a UI that looks like a speech
+ * bubble, where it has a "tail" that points to the block, and a "head" that
+ * displays arbitrary svg elements.
+ */
 export declare abstract class Bubble implements IBubble {
     protected readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;

package/core/bubbles/mini_workspace_bubble.d.ts

@@ -10,6 +10,10 @@ import { Coordinate } from '../utils/coordinate.js';
 import { Options } from '../options.js';
 import type { Rect } from '../utils/rect.js';
 import type { WorkspaceSvg } from '../workspace_svg.js';
+/**
+ * A bubble that contains a mini-workspace which can hold arbitrary blocks.
+ * Used by the mutator icon.
+ */
 export declare class MiniWorkspaceBubble extends Bubble {
     protected readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;

package/core/bubbles/text_bubble.d.ts

@@ -7,6 +7,9 @@ import { Bubble } from './bubble.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
+/**
+ * A bubble that displays non-editable text. Used by the warning icon.
+ */
 export declare class TextBubble extends Bubble {
     private text;
     protected readonly workspace: WorkspaceSvg;

package/core/bubbles/textinput_bubble.d.ts

@@ -8,6 +8,10 @@ import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { Size } from '../utils/size.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
+/**
+ * A bubble that displays editable text. It can also be resized by the user.
+ * Used by the comment icon.
+ */
 export declare class TextInputBubble extends Bubble {
     protected readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;

package/core/bubbles.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bubble } from './bubbles/bubble.js';
+import { TextBubble } from './bubbles/text_bubble.js';
+import { TextInputBubble } from './bubbles/textinput_bubble.js';
+import { MiniWorkspaceBubble } from './bubbles/mini_workspace_bubble.js';
+export { Bubble, TextBubble, TextInputBubble, MiniWorkspaceBubble };
+//# sourceMappingURL=bubbles.d.ts.map

package/core/events/events.d.ts

@@ -9,6 +9,7 @@ import { BlockChange, BlockChangeJson } from './events_block_change.js';
 import { BlockCreate, BlockCreateJson } from './events_block_create.js';
 import { BlockDelete, BlockDeleteJson } from './events_block_delete.js';
 import { BlockDrag, BlockDragJson } from './events_block_drag.js';
+import { BlockFieldIntermediateChange, BlockFieldIntermediateChangeJson } from './events_block_field_intermediate_change.js';
 import { BlockMove, BlockMoveJson } from './events_block_move.js';
 import { BubbleOpen, BubbleOpenJson, BubbleType } from './events_bubble_open.js';
 import { Click, ClickJson, ClickTarget } from './events_click.js';
@@ -45,6 +46,8 @@ export { BlockDelete };
 export { BlockDeleteJson };
 export { BlockDrag };
 export { BlockDragJson };
+export { BlockFieldIntermediateChange };
+export { BlockFieldIntermediateChangeJson };
 export { BlockMove };
 export { BlockMoveJson };
 export { Click };
@@ -86,6 +89,7 @@ export declare const BLOCK_CREATE = "create";
 export declare const BLOCK_DELETE = "delete";
 export declare const BLOCK_DRAG = "drag";
 export declare const BLOCK_MOVE = "move";
+export declare const BLOCK_FIELD_INTERMEDIATE_CHANGE = "block_field_intermediate_change";
 export declare const BUBBLE_OPEN = "bubble_open";
 export type BumpEvent = eventUtils.BumpEvent;
 export declare const BUMP_EVENTS: string[];

package/core/events/events_block_field_intermediate_change.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Block } from '../block.js';
+import { Workspace } from '../workspace.js';
+import { BlockBase, BlockBaseJson } from './events_block_base.js';
+/**
+ * Notifies listeners when the value of a block's field has changed but the
+ * change is not yet complete, and is expected to be followed by a block change
+ * event.
+ */
+export declare class BlockFieldIntermediateChange extends BlockBase {
+    type: string;
+    recordUndo: boolean;
+    /** The name of the field that changed. */
+    name?: string;
+    /** The original value of the element. */
+    oldValue: unknown;
+    /** The new value of the element. */
+    newValue: unknown;
+    /**
+     * @param opt_block The changed block. Undefined for a blank event.
+     * @param opt_name Name of the field affected.
+     * @param opt_oldValue Previous value of element.
+     * @param opt_newValue New value of element.
+     */
+    constructor(opt_block?: Block, opt_name?: string, opt_oldValue?: unknown, opt_newValue?: unknown);
+    /**
+     * Encode the event as JSON.
+     *
+     * @returns JSON representation.
+     */
+    toJson(): BlockFieldIntermediateChangeJson;
+    /**
+     * Deserializes the JSON event.
+     *
+     * @param event The event to append new properties to. Should be a subclass
+     *     of BlockFieldIntermediateChange, 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: BlockFieldIntermediateChangeJson, workspace: Workspace, event?: any): BlockFieldIntermediateChange;
+    /**
+     * Does this event record any change of state?
+     *
+     * @returns False if something changed.
+     */
+    isNull(): boolean;
+}
+export interface BlockFieldIntermediateChangeJson extends BlockBaseJson {
+    name: string;
+    newValue: unknown;
+    oldValue: unknown;
+}
+//# sourceMappingURL=events_block_field_intermediate_change.d.ts.map

package/core/events/utils.d.ts

@@ -46,6 +46,11 @@ export declare const CHANGE = "change";
  * Name of event that changes a block.
  */
 export declare const BLOCK_CHANGE = "change";
+/**
+ * Name of event representing an in-progress change to a field of a block, which
+ * is expected to be followed by a block change event.
+ */
+export declare const BLOCK_FIELD_INTERMEDIATE_CHANGE = "block_field_intermediate_change";
 /**
  * Name of event that moves a block. Will be deprecated for BLOCK_MOVE.
  */

package/core/field.d.ts

@@ -519,9 +519,12 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      * than this method.
      *
      * @param newValue New value.
+     * @param fireChangeEvent Whether to fire a change event. Defaults to true.
+     *     Should usually be true unless the change will be reported some other
+     *     way, e.g. an intermediate field change event.
      * @sealed
      */
-    setValue(newValue: any): void;
+    setValue(newValue: any, fireChangeEvent?: boolean): void;
     /**
      * Process the result of validation.
      *

package/core/field_input.d.ts

@@ -34,6 +34,12 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      * True if the value currently displayed in the field's editory UI is valid.
      */
     protected isTextValid_: boolean;
+    /**
+     * The intial value of the field when the user opened an editor to change its
+     * value. When the editor is disposed, an event will be fired that uses this
+     * as the event's oldValue.
+     */
+    protected valueWhenEditorWasOpened_: string | T | null;
     /** Key down event data. */
     private onKeyDownWrapper_;
     /** Key input event data. */
@@ -171,8 +177,11 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      * value whilst editing.
      *
      * @param newValue New value.
+     * @param fireChangeEvent Whether to fire a change event. Defaults to true.
+     *     Should usually be true unless the change will be reported some other
+     *     way, e.g. an intermediate field change event.
      */
-    protected setEditorValue_(newValue: any): void;
+    protected setEditorValue_(newValue: any, fireChangeEvent?: boolean): void;
     /** Resize the editor to fit the text. */
     protected resizeEditor_(): void;
     /**

package/core/icons/comment_icon.d.ts

@@ -10,6 +10,9 @@ import { Icon } from './icon.js';
 import type { IHasBubble } from '../interfaces/i_has_bubble.js';
 import type { ISerializable } from '../interfaces/i_serializable.js';
 import { Size } from '../utils/size.js';
+/**
+ * An icon which allows the user to add comment text to a block.
+ */
 export declare class CommentIcon extends Icon implements IHasBubble, ISerializable {
     protected readonly sourceBlock: Block;
     /** The type string used to identify this icon. */

package/core/icons/exceptions.d.ts

@@ -4,6 +4,9 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { IIcon } from '../interfaces/i_icon.js';
+/**
+ * Thrown when you add more than one icon of the same type to a block.
+ */
 export declare class DuplicateIconType extends Error {
     icon: IIcon;
     /**

package/core/icons/icon.d.ts

@@ -8,6 +8,12 @@ import type { IIcon } from '../interfaces/i_icon.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Size } from '../utils/size.js';
 import type { IconType } from './icon_types.js';
+/**
+ * The abstract icon class. Icons are visual elements that live in the top-start
+ * corner of the block. Usually they provide more "meta" information about a
+ * block (such as warnings or comments) as opposed to fields, which provide
+ * "actual" information, related to how a block functions.
+ */
 export declare abstract class Icon implements IIcon {
     protected sourceBlock: Block;
     /**
@@ -34,5 +40,11 @@ export declare abstract class Icon implements IIcon {
     private updateSvgRootOffset;
     onLocationChange(blockOrigin: Coordinate): void;
     onClick(): void;
+    /**
+     * Sets the visibility of the icon's bubble if one exists.
+     *
+     * @deprecated Use `setBubbleVisible` instead. To be removed in v11.
+     */
+    setVisible(visibility: boolean): void;
 }
 //# sourceMappingURL=icon.d.ts.map

package/core/icons/icon_types.d.ts

@@ -7,6 +7,9 @@ import { IIcon } from '../interfaces/i_icon.js';
 import { CommentIcon } from './comment_icon.js';
 import { MutatorIcon } from './mutator_icon.js';
 import { WarningIcon } from './warning_icon.js';
+/**
+ * Defines the type of an icon, so that it can be retrieved from block.getIcon
+ */
 export declare class IconType<_T extends IIcon> {
     private readonly name;
     /** @param name The name of the registry type. */

package/core/icons/mutator_icon.d.ts

@@ -13,6 +13,12 @@ import { Icon } from './icon.js';
 import { Size } from '../utils/size.js';
 import type { WorkspaceSvg } from '../workspace_svg.js';
 import { IconType } from './icon_types.js';
+/**
+ * An icon that allows the user to change the shape of the block.
+ *
+ * For example, it could be used to add additional fields or inputs to
+ * the block.
+ */
 export declare class MutatorIcon extends Icon implements IHasBubble {
     private readonly flyoutBlockTypes;
     protected readonly sourceBlock: BlockSvg;
@@ -71,7 +77,10 @@ export declare class MutatorIcon extends Icon implements IHasBubble {
     static isIgnorableMutatorEvent(e: Abstract): boolean;
     /** Recomposes the source block based on changes to the mini workspace. */
     private recomposeSourceBlock;
-    /** @internal */
+    /**
+     * @returns The workspace of the mini workspace bubble, if the bubble is
+     *     currently open.
+     */
     getWorkspace(): WorkspaceSvg | undefined;
     /**
      * Reconnects the given connection to the mutated input on the given block.

package/core/icons/warning_icon.d.ts

@@ -9,6 +9,12 @@ import { Icon } from './icon.js';
 import type { IHasBubble } from '../interfaces/i_has_bubble.js';
 import { Size } from '../utils.js';
 import { IconType } from './icon_types.js';
+/**
+ * An icon that warns the user that something is wrong with their block.
+ *
+ * For example, this could be used to warn them about incorrect field values,
+ * or incorrect placement of the block (putting it somewhere it doesn't belong).
+ */
 export declare class WarningIcon extends Icon implements IHasBubble {
     protected readonly sourceBlock: BlockSvg;
     /** The type string used to identify this icon. */

package/core/icons.d.ts

@@ -3,10 +3,12 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { CommentIcon } from './icons/comment_icon.js';
-import * as exceptions from './icons/exceptions.js';
-import * as registry from './icons/registry.js';
+import { Icon } from './icons/icon.js';
+import { CommentIcon, CommentState } from './icons/comment_icon.js';
 import { MutatorIcon } from './icons/mutator_icon.js';
+import { WarningIcon } from './icons/warning_icon.js';
 import { IconType } from './icons/icon_types.js';
-export { CommentIcon, exceptions, registry, MutatorIcon, IconType };
+import * as exceptions from './icons/exceptions.js';
+import * as registry from './icons/registry.js';
+export { Icon, CommentIcon, CommentState, MutatorIcon, WarningIcon, IconType, exceptions, registry, };
 //# sourceMappingURL=icons.d.ts.map

package/core/inputs/align.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2012 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Enum for alignment of inputs.
+ */
+export declare enum Align {
+    LEFT = -1,
+    CENTRE = 0,
+    RIGHT = 1
+}
+//# sourceMappingURL=align.d.ts.map

package/core/inputs/input.d.ts

@@ -10,9 +10,7 @@ import type { Connection } from '../connection.js';
 import type { ConnectionType } from '../connection_type.js';
 import type { Field } from '../field.js';
 import { inputTypes } from './input_types.js';
-/**
- * Class for an input with an optional field.
- */
+/** Class for an input with optional fields. */
 export declare class Input {
     name: string;
     private sourceBlock;
@@ -136,6 +134,7 @@ export declare namespace Input {
     /**
      * Enum for alignment of inputs.
      *
+     * @deprecated Use Blockly.inputs.Align. To be removed in v11.
      */
     enum Align {
         LEFT = -1,
@@ -143,6 +142,10 @@ export declare namespace Input {
         RIGHT = 1
     }
 }
+/** @deprecated Use Blockly.inputs.Align. To be removed in v11. */
+/** @suppress {deprecated} */
 export type Align = Input.Align;
+/** @deprecated Use Blockly.inputs.Align. To be removed in v11. */
+/** @suppress {deprecated} */
 export declare const Align: typeof Input.Align;
 //# sourceMappingURL=input.d.ts.map

package/core/inputs.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Align } from './inputs/align.js';
+import { Input } from './inputs/input.js';
+import { DummyInput } from './inputs/dummy_input.js';
+import { StatementInput } from './inputs/statement_input.js';
+import { ValueInput } from './inputs/value_input.js';
+import { inputTypes } from './inputs/input_types.js';
+export { Align, Input, DummyInput, StatementInput, ValueInput, inputTypes };
+//# sourceMappingURL=inputs.d.ts.map

package/core/main.d.ts

@@ -1,2 +1,5 @@
+declare const Blockly: any;
 declare const Msg: any;
+declare const colour: any;
+declare const deprecation: any;
 //# sourceMappingURL=main.d.ts.map

package/core/renderers/minimalist/constants.d.ts

@@ -7,8 +7,15 @@ import { ConstantProvider as BaseConstantProvider } from '../common/constants.js
 /**
  * An object that provides constants for rendering blocks in the minimalist
  * renderer.
+ *
+ * @deprecated Use Blockly.blockRendering.ConstantProvider instead.
+ *     To be removed in v11.
  */
 export declare class ConstantProvider extends BaseConstantProvider {
+    /**
+     * @deprecated Use Blockly.blockRendering.ConstantProvider instead.
+     *     To be removed in v11.
+     */
     constructor();
 }
 //# sourceMappingURL=constants.d.ts.map

package/core/renderers/minimalist/drawer.d.ts

@@ -8,12 +8,18 @@ import { Drawer as BaseDrawer } from '../common/drawer.js';
 import type { RenderInfo } from './info.js';
 /**
  * An object that draws a block based on the given rendering information.
+ *
+ * @deprecated Use Blockly.blockRendering.Drawer instead.
+ *     To be removed in v11.
  */
 export declare class Drawer extends BaseDrawer {
     /**
      * @param block The block to render.
      * @param info An object containing all information needed to render this
      *     block.
+     *
+     * @deprecated Use Blockly.blockRendering.Drawer instead.
+     *     To be removed in v11.
      */
     constructor(block: BlockSvg, info: RenderInfo);
 }

package/core/renderers/minimalist/info.d.ts

@@ -12,12 +12,17 @@ import type { Renderer } from './renderer.js';
  * This measure pass does not propagate changes to the block (although fields
  * may choose to rerender when getSize() is called).  However, calling it
  * repeatedly may be expensive.
+ *
+ * @deprecated Use Blockly.blockRendering.RenderInfo instead. To be removed
+ *     in v11.
  */
 export declare class RenderInfo extends BaseRenderInfo {
     protected renderer_: Renderer;
     /**
      * @param renderer The renderer in use.
      * @param block The block to measure.
+     * @deprecated Use Blockly.blockRendering.RenderInfo instead. To be removed
+     *     in v11.
      */
     constructor(renderer: Renderer, block: BlockSvg);
     /**

package/core/renderers/minimalist/renderer.d.ts

@@ -11,10 +11,15 @@ import { Drawer } from './drawer.js';
 import { RenderInfo } from './info.js';
 /**
  * The minimalist renderer.
+ *
+ * @deprecated Use Blockly.blockRendering.Renderer instead. To be removed
+ *     in v11.
  */
 export declare class Renderer extends BaseRenderer {
     /**
      * @param name The renderer name.
+     * @deprecated Use Blockly.blockRendering.Renderer instead. To be removed
+     *     in v11.
      */
     constructor(name: string);
     /**