blockly 10.1.2 → 10.2.0-beta.1

package/core/block.d.ts

@@ -76,8 +76,14 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * An optional serialization method for defining how to serialize the
      * block's extra state (eg mutation state) to something JSON compatible.
      * This must be coupled with defining `loadExtraState`.
+     *
+     * @param doFullSerialization Whether or not to serialize the full state of
+     *     the extra state (rather than possibly saving a reference to some
+     *     state). This is used during copy-paste. See the
+     *     {@link https://developers.devsite.google.com/blockly/guides/create-custom-blocks/extensions#full_serialization_and_backing_data | block serialization docs}
+     *     for more information.
      */
-    saveExtraState?: () => any;
+    saveExtraState?: (doFullSerialization?: boolean) => any;
     /**
      * An optional serialization method for defining how to deserialize the
      * block's extra state (eg mutation state) from something JSON compatible.
@@ -674,6 +680,14 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * @returns The input object created.
      */
     appendDummyInput(name?: string): Input;
+    /**
+     * Appends an input that ends the row.
+     *
+     * @param name Optional language-neutral identifier which may used to find
+     *     this input again.  Should be unique to this block.
+     * @returns The input object created.
+     */
+    appendEndRowInput(name?: string): Input;
     /**
      * Appends the given input row.
      *
@@ -728,8 +742,8 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * @param message Text contains interpolation tokens (%1, %2, ...) that match
      *     with fields or inputs defined in the args array.
      * @param args Array of arguments to be interpolated.
-     * @param lastDummyAlign If a dummy input is added at the end, how should it
-     *     be aligned?
+     * @param implicitAlign If an implicit input is added at the end or in place
+     *     of newline tokens, how should it be aligned?
      * @param warningPrefix Warning prefix string identifying block.
      */
     private interpolate_;
@@ -744,13 +758,14 @@ export declare class Block implements IASTNodeLocation, IDeletable {
     private validateTokens_;
     /**
      * Inserts args in place of numerical tokens. String args are converted to
-     * JSON that defines a label field. If necessary an extra dummy input is added
-     * to the end of the elements.
+     * JSON that defines a label field. Newline characters are converted to
+     * end-row inputs, and if necessary an extra dummy input is added to the end
+     * of the elements.
      *
      * @param tokens The tokens to interpolate
      * @param args The arguments to insert.
-     * @param lastDummyAlign The alignment the added dummy input should have, if
-     *     we are required to add one.
+     * @param implicitAlign The alignment to use for any implicitly added end-row
+     *     or dummy inputs, if necessary.
      * @returns The JSON definitions of field and inputs to add to the block.
      */
     private interpolateArguments_;

package/core/block_svg.d.ts

@@ -13,7 +13,7 @@ import type { Field } from './field.js';
 import type { Input } from './inputs/input.js';
 import type { IASTNodeLocationSvg } from './interfaces/i_ast_node_location_svg.js';
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
-import type { CopyData, ICopyable } from './interfaces/i_copyable.js';
+import type { ICopyable } from './interfaces/i_copyable.js';
 import type { IDraggable } from './interfaces/i_draggable.js';
 import { IIcon } from './interfaces/i_icon.js';
 import { MutatorIcon } from './icons/mutator_icon.js';
@@ -26,11 +26,12 @@ 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';
+import { BlockCopyData } from './clipboard/block_paster.js';
 /**
  * Class for a block's SVG representation.
  * Not normally called directly, workspace.newBlock() is preferred.
  */
-export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBoundedElement, ICopyable, IDraggable {
+export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBoundedElement, ICopyable<BlockCopyData>, IDraggable {
     /**
      * Constant for identifying rows that are to be rendered inline.
      * Don't collide with Blockly.inputTypes.
@@ -322,9 +323,8 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * Encode a block for copying.
      *
      * @returns Copy metadata, or null if the block is an insertion marker.
-     * @internal
      */
-    toCopyData(): CopyData | null;
+    toCopyData(): BlockCopyData | null;
     /**
      * Updates the colour of the block to match the block's state.
      *
@@ -350,10 +350,10 @@ export declare class BlockSvg extends Block implements IASTNodeLocationSvg, IBou
      * Set this block's warning text.
      *
      * @param text The text, or null to delete.
-     * @param opt_id An optional ID for the warning text to be able to maintain
+     * @param id An optional ID for the warning text to be able to maintain
      *     multiple warnings.
      */
-    setWarningText(text: string | null, opt_id?: string): void;
+    setWarningText(text: string | null, id?: string): void;
     /**
      * Give this block a mutator dialog.
      *

package/core/blockly.d.ts

@@ -75,7 +75,7 @@ import { ICollapsibleToolboxItem } from './interfaces/i_collapsible_toolbox_item
 import { IComponent } from './interfaces/i_component.js';
 import { IConnectionChecker } from './interfaces/i_connection_checker.js';
 import { IContextMenu } from './interfaces/i_contextmenu.js';
-import { ICopyable } from './interfaces/i_copyable.js';
+import { ICopyable, isCopyable } from './interfaces/i_copyable.js';
 import { IDeletable } from './interfaces/i_deletable.js';
 import { IDeleteArea } from './interfaces/i_delete_area.js';
 import { IDragTarget } from './interfaces/i_drag_target.js';
@@ -87,6 +87,7 @@ import { IKeyboardAccessible } from './interfaces/i_keyboard_accessible.js';
 import { IMetricsManager } from './interfaces/i_metrics_manager.js';
 import { IMovable } from './interfaces/i_movable.js';
 import { IObservable, isObservable } from './interfaces/i_observable.js';
+import { IPaster, isPaster } from './interfaces/i_paster.js';
 import { IPositionable } from './interfaces/i_positionable.js';
 import { IRegistrable } from './interfaces/i_registrable.js';
 import { ISelectable } from './interfaces/i_selectable.js';
@@ -371,7 +372,7 @@ export { IComponent };
 export { IConnectionChecker };
 export { IContextMenu };
 export { icons };
-export { ICopyable };
+export { ICopyable, isCopyable };
 export { IDeletable };
 export { IDeleteArea };
 export { IDragTarget };
@@ -386,6 +387,7 @@ export { Input };
 export { inputs };
 export { InsertionMarkerManager };
 export { IObservable, isObservable };
+export { IPaster, isPaster };
 export { IPositionable };
 export { IRegistrable };
 export { ISelectable };

package/core/clipboard/block_paster.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BlockSvg } from '../block_svg.js';
+import { ICopyData } from '../interfaces/i_copyable.js';
+import { IPaster } from '../interfaces/i_paster.js';
+import { State } from '../serialization/blocks.js';
+import { Coordinate } from '../utils/coordinate.js';
+import { WorkspaceSvg } from '../workspace_svg.js';
+export declare class BlockPaster implements IPaster<BlockCopyData, BlockSvg> {
+    static TYPE: string;
+    paste(copyData: BlockCopyData, workspace: WorkspaceSvg, coordinate?: Coordinate): BlockSvg | null;
+}
+/**
+ * Moves the given block to a location where it does not: (1) overlap exactly
+ * with any other blocks, or (2) look like it is connected to any other blocks.
+ *
+ * Exported for testing.
+ *
+ * @param block The block to move to an unambiguous location.
+ * @internal
+ */
+export declare function moveBlockToNotConflict(block: BlockSvg): void;
+export interface BlockCopyData extends ICopyData {
+    blockState: State;
+    typeCounts: {
+        [key: string]: number;
+    };
+}
+//# sourceMappingURL=block_paster.d.ts.map

package/core/clipboard/registry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ICopyable, ICopyData } from '../interfaces/i_copyable.js';
+import type { IPaster } from '../interfaces/i_paster.js';
+/**
+ * Registers the given paster so that it cna be used for pasting.
+ *
+ * @param type The type of the paster to register, e.g. 'block', 'comment', etc.
+ * @param paster The paster to register.
+ */
+export declare function register<U extends ICopyData, T extends ICopyable<U>>(type: string, paster: IPaster<U, T>): void;
+/**
+ * Unregisters the paster associated with the given type.
+ *
+ * @param type The type of the paster to unregister.
+ */
+export declare function unregister(type: string): void;
+//# sourceMappingURL=registry.d.ts.map

package/core/clipboard/workspace_comment_paster.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IPaster } from '../interfaces/i_paster.js';
+import { ICopyData } from '../interfaces/i_copyable.js';
+import { Coordinate } from '../utils/coordinate.js';
+import { WorkspaceSvg } from '../workspace_svg.js';
+import { WorkspaceCommentSvg } from '../workspace_comment_svg.js';
+export declare class WorkspaceCommentPaster implements IPaster<WorkspaceCommentCopyData, WorkspaceCommentSvg> {
+    static TYPE: string;
+    paste(copyData: WorkspaceCommentCopyData, workspace: WorkspaceSvg, coordinate?: Coordinate): WorkspaceCommentSvg;
+}
+export interface WorkspaceCommentCopyData extends ICopyData {
+    commentState: Element;
+}
+//# sourceMappingURL=workspace_comment_paster.d.ts.map

package/core/clipboard.d.ts

@@ -3,41 +3,59 @@
  * Copyright 2021 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { ICopyable } from './interfaces/i_copyable.js';
+import type { ICopyData, ICopyable } from './interfaces/i_copyable.js';
+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 block or workspace comment onto the local clipboard.
+ * Copy a copyable element onto the local clipboard.
  *
- * @param toCopy Block or Workspace Comment to be copied.
+ * @param toCopy The copyable element to be copied.
+ * @deprecated v11. Use `myCopyable.toCopyData()` instead. To be removed v12.
  * @internal
  */
-export declare function copy(toCopy: ICopyable): void;
+export declare function copy<T extends ICopyData>(toCopy: ICopyable<T>): T | null;
 /**
  * Private version of copy for stubbing in tests.
  */
-declare function copyInternal(toCopy: ICopyable): void;
+declare function copyInternal<T extends ICopyData>(toCopy: ICopyable<T>): T | null;
 /**
- * Paste a block or workspace comment on to the main workspace.
+ * Paste a pasteable element into the workspace.
  *
+ * @param copyData The data to paste into the workspace.
+ * @param workspace The workspace to paste the data into.
+ * @param coordinate The location to paste the thing at.
  * @returns The pasted thing if the paste was successful, null otherwise.
- * @internal
  */
-export declare function paste(): ICopyable | null;
+export declare function paste<T extends ICopyData>(copyData: T, workspace: WorkspaceSvg, coordinate?: Coordinate): ICopyable<T> | null;
+/**
+ * Pastes the last copied ICopyable into the workspace.
+ *
+ * @returns the pasted thing if the paste was successful, null otherwise.
+ */
+export declare function paste(): ICopyable<ICopyData> | null;
 /**
- * Duplicate this block and its children, or a workspace comment.
+ * Duplicate this copy-paste-able element.
  *
- * @param toDuplicate Block or Workspace Comment to be duplicated.
- * @returns The block or workspace comment that was duplicated, or null if the
- *     duplication failed.
+ * @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(toDuplicate: ICopyable): ICopyable | null;
+export declare function duplicate<U extends ICopyData, T extends ICopyable<U> & IHasWorkspace>(toDuplicate: T): T | null;
 /**
  * Private version of duplicate for stubbing in tests.
  */
-declare function duplicateInternal(toDuplicate: ICopyable): ICopyable | null;
+declare function duplicateInternal<U extends ICopyData, T extends ICopyable<U> & IHasWorkspace>(toDuplicate: T): T | null;
+interface IHasWorkspace {
+    workspace: WorkspaceSvg;
+}
 export declare const TEST_ONLY: {
     duplicateInternal: typeof duplicateInternal;
     copyInternal: typeof copyInternal;
 };
-export {};
+export { BlockPaster, registry };
 //# sourceMappingURL=clipboard.d.ts.map

package/core/common.d.ts

@@ -4,9 +4,9 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Block } from './block.js';
+import { ISelectable } from './blockly.js';
 import { BlockDefinition } from './blocks.js';
 import type { Connection } from './connection.js';
-import type { ICopyable } from './interfaces/i_copyable.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
@@ -51,7 +51,7 @@ export declare function setMainWorkspace(workspace: Workspace): void;
 /**
  * Returns the currently selected copyable object.
  */
-export declare function getSelected(): ICopyable | null;
+export declare function getSelected(): ISelectable | null;
 /**
  * Sets the currently selected block. This function does not visually mark the
  * block as selected or fire the required events. If you wish to
@@ -60,7 +60,7 @@ export declare function getSelected(): ICopyable | null;
  * @param newSelection The newly selected block.
  * @internal
  */
-export declare function setSelected(newSelection: ICopyable | null): void;
+export declare function setSelected(newSelection: ISelectable | null): void;
 /**
  * Get the container element in which to render the WidgetDiv, DropDownDiv and
  * Tooltip.

package/core/field.d.ts

@@ -236,6 +236,9 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      * @param _doFullSerialization If true, this signals to the field that if it
      *     normally just saves a reference to some state (eg variable fields) it
      *     should instead serialize the full state of the thing being referenced.
+     *     See the
+     *     {@link https://developers.devsite.google.com/blockly/guides/create-custom-blocks/fields/customizing-fields/creating#full_serialization_and_backing_data | field serialization docs}
+     *     for more information.
      * @returns JSON serializable state.
      * @internal
      */

package/core/inputs/end_row_input.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Block } from '../block.js';
+import { Input } from './input.js';
+import { inputTypes } from './input_types.js';
+/**
+ * Represents an input on a block that is always the last input in the row. Any
+ * following input will be rendered on the next row even if the block has inline
+ * inputs. Any newline character in a JSON block definition's message will
+ * automatically be parsed as an end-row input.
+ */
+export declare class EndRowInput extends Input {
+    name: string;
+    readonly type = inputTypes.END_ROW;
+    /**
+     * @param name Language-neutral identifier which may used to find this input
+     *     again.
+     * @param block The block containing this input.
+     */
+    constructor(name: string, block: Block);
+}
+//# sourceMappingURL=end_row_input.d.ts.map

package/core/inputs/input_types.d.ts

@@ -10,6 +10,7 @@ export declare enum inputTypes {
     VALUE = 1,
     STATEMENT = 3,
     DUMMY = 5,
-    CUSTOM = 6
+    CUSTOM = 6,
+    END_ROW = 7
 }
 //# sourceMappingURL=input_types.d.ts.map

package/core/inputs.d.ts

@@ -6,8 +6,9 @@
 import { Align } from './inputs/align.js';
 import { Input } from './inputs/input.js';
 import { DummyInput } from './inputs/dummy_input.js';
+import { EndRowInput } from './inputs/end_row_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 };
+export { Align, Input, DummyInput, EndRowInput, StatementInput, ValueInput, inputTypes, };
 //# sourceMappingURL=inputs.d.ts.map

package/core/interfaces/i_copyable.d.ts

@@ -3,25 +3,21 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { WorkspaceSvg } from '../workspace_svg.js';
 import type { ISelectable } from './i_selectable.js';
-export interface ICopyable extends ISelectable {
+export interface ICopyable<T extends ICopyData> extends ISelectable {
     /**
      * Encode for copying.
      *
      * @returns Copy metadata.
-     * @internal
      */
-    toCopyData(): CopyData | null;
+    toCopyData(): T | null;
 }
 export declare namespace ICopyable {
-    interface CopyData {
-        saveInfo: Object | Element;
-        source: WorkspaceSvg;
-        typeCounts: {
-            [key: string]: number;
-        } | null;
+    interface ICopyData {
+        paster: string;
     }
 }
-export type CopyData = ICopyable.CopyData;
+export type ICopyData = ICopyable.ICopyData;
+/** @returns true if the given object is copyable. */
+export declare function isCopyable(obj: any): obj is ICopyable<ICopyData>;
 //# sourceMappingURL=i_copyable.d.ts.map

package/core/interfaces/i_paster.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Coordinate } from '../utils/coordinate.js';
+import { WorkspaceSvg } from '../workspace_svg.js';
+import { ICopyable, ICopyData } from './i_copyable.js';
+/** An object that can paste data into a workspace. */
+export interface IPaster<U extends ICopyData, T extends ICopyable<U>> {
+    paste(copyData: U, workspace: WorkspaceSvg, coordinate?: Coordinate): T | null;
+}
+/** @returns True if the given object is a paster. */
+export declare function isPaster(obj: any): obj is IPaster<ICopyData, ICopyable<ICopyData>>;
+//# sourceMappingURL=i_paster.d.ts.map

package/core/registry.d.ts

@@ -18,6 +18,8 @@ import type { Options } from './options.js';
 import type { Renderer } from './renderers/common/renderer.js';
 import type { Theme } from './theme.js';
 import type { ToolboxItem } from './toolbox/toolbox_item.js';
+import { IPaster } from './interfaces/i_paster.js';
+import { ICopyable } from './interfaces/i_copyable.js';
 export declare const TEST_ONLY: {
     typeMap: {
         [key: string]: {
@@ -59,6 +61,8 @@ export declare class Type<_T> {
     static SERIALIZER: Type<ISerializer>;
     /** @internal */
     static ICON: Type<IIcon>;
+    /** @internal */
+    static PASTER: Type<IPaster<ICopyable.ICopyData, ICopyable<ICopyable.ICopyData>>>;
 }
 /**
  * Registers a class based on a type and name.

package/core/renderers/common/block_rendering.d.ts

@@ -26,7 +26,6 @@ import { SquareCorner } from '../measurables/square_corner.js';
 import { StatementInput } from '../measurables/statement_input.js';
 import { TopRow } from '../measurables/top_row.js';
 import { Types } from '../measurables/types.js';
-import { ConstantProvider } from './constants.js';
 import { Drawer } from './drawer.js';
 import type { IPathObject } from './i_path_object.js';
 import { RenderInfo } from './info.js';
@@ -62,7 +61,6 @@ export declare function init(name: string, theme: Theme, opt_rendererOverrides?:
 }): Renderer;
 export { BottomRow };
 export { Connection };
-export { ConstantProvider };
 export { Drawer };
 export { ExternalValueInput };
 export { Field };
@@ -89,4 +87,5 @@ export { SquareCorner };
 export { StatementInput };
 export { TopRow };
 export { Types };
+export { OutsideCorners, InsideCorners, StartHat, Notch, PuzzleTab, JaggedTeeth, BaseShape, DynamicShape, ConstantProvider, } from './constants.js';
 //# sourceMappingURL=block_rendering.d.ts.map

package/core/renderers/measurables/row.d.ts

@@ -69,7 +69,7 @@ export declare class Row {
      */
     hasInlineInput: boolean;
     /**
-     * Whether the row has any dummy inputs.
+     * Whether the row has any dummy inputs or end-row inputs.
      */
     hasDummyInput: boolean;
     /**

package/core/shortcut_registry.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { KeyCodes } from './utils/keycodes.js';
-import type { Workspace } from './workspace.js';
+import { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for the registry of keyboard shortcuts. This is intended to be a
  * singleton. You should not create a new instance, and only access this class
@@ -103,7 +103,7 @@ export declare class ShortcutRegistry {
      * @param e The key down event.
      * @returns True if the event was handled, false otherwise.
      */
-    onKeyDown(workspace: Workspace, e: KeyboardEvent): boolean;
+    onKeyDown(workspace: WorkspaceSvg, e: KeyboardEvent): boolean;
     /**
      * Gets the shortcuts registered to the given key code.
      *
@@ -146,9 +146,9 @@ export declare class ShortcutRegistry {
 }
 export declare namespace ShortcutRegistry {
     interface KeyboardShortcut {
-        callback?: (p1: Workspace, p2: Event, p3: KeyboardShortcut) => boolean;
+        callback?: (p1: WorkspaceSvg, p2: Event, p3: KeyboardShortcut) => boolean;
         name: string;
-        preconditionFn?: (p1: Workspace) => boolean;
+        preconditionFn?: (p1: WorkspaceSvg) => boolean;
         metadata?: object;
         keyCodes?: (number | string)[];
         allowCollision?: boolean;

package/core/utils/parsing.d.ts

@@ -8,7 +8,8 @@
  * It will also replace string table references (e.g., %{bky_my_msg} and
  * %{BKY_MY_MSG} will both be replaced with the value in
  * Msg['MY_MSG']). Percentage sign characters '%' may be self-escaped
- * (e.g., '%%').
+ * (e.g., '%%'). Newline characters will also be output as string tokens
+ * containing a single newline character.
  *
  * @param message Text which might contain string table references and
  *     interpolation tokens.

package/core/workspace_comment_svg.d.ts

@@ -6,15 +6,16 @@
 import './events/events_selected.js';
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
 import type { IBubble } from './interfaces/i_bubble.js';
-import type { CopyData, ICopyable } from './interfaces/i_copyable.js';
+import type { ICopyable } from './interfaces/i_copyable.js';
 import { Coordinate } from './utils/coordinate.js';
 import { Rect } from './utils/rect.js';
 import { WorkspaceComment } from './workspace_comment.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
+import { WorkspaceCommentCopyData } from './clipboard/workspace_comment_paster.js';
 /**
  * Class for a workspace comment's SVG representation.
  */
-export declare class WorkspaceCommentSvg extends WorkspaceComment implements IBoundedElement, IBubble, ICopyable {
+export declare class WorkspaceCommentSvg extends WorkspaceComment implements IBoundedElement, IBubble, ICopyable<WorkspaceCommentCopyData> {
     /**
      * The width and height to use to size a workspace comment when it is first
      * added, before it has been edited by the user.
@@ -249,9 +250,8 @@ export declare class WorkspaceCommentSvg extends WorkspaceComment implements IBo
      * Encode a comment for copying.
      *
      * @returns Copy metadata.
-     * @internal
      */
-    toCopyData(): CopyData;
+    toCopyData(): WorkspaceCommentCopyData;
     /**
      * Returns a bounding box describing the dimensions of this comment.
      *

package/core/workspace_svg.d.ts

@@ -15,7 +15,7 @@ import { Gesture } from './gesture.js';
 import { Grid } from './grid.js';
 import type { IASTNodeLocationSvg } from './interfaces/i_ast_node_location_svg.js';
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
-import type { ICopyable } from './interfaces/i_copyable.js';
+import type { ICopyData, ICopyable } from './interfaces/i_copyable.js';
 import type { IDragTarget } from './interfaces/i_drag_target.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
 import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
@@ -559,8 +559,10 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      *
      * @param state The representation of the thing to paste.
      * @returns The pasted thing, or null if the paste was not successful.
+     * @deprecated v10. Use `Blockly.clipboard.paste` instead. To be removed in
+     *     v11.
      */
-    paste(state: any | Element | DocumentFragment): ICopyable | null;
+    paste(state: any | Element | DocumentFragment): ICopyable<ICopyData> | null;
     /**
      * Paste the provided block onto the workspace.
      *

package/dart_compressed.js

@@ -276,7 +276,7 @@ int ${b.FUNCTION_NAME_PLACEHOLDER_}(num a, num b) {
 }
 `)+"("+c+", "+a+")",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},math_random_float$$module$build$src$generators$dart$math=function(a,b){b.definitions_.import_dart_math="import 'dart:math' as Math;";return["new Math.Random().nextDouble()",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},math_atan2$$module$build$src$generators$dart$math=function(a,b){b.definitions_.import_dart_math="import 'dart:math' as Math;";const c=b.valueToCode(a,"X",Order$$module$build$src$generators$dart$dart_generator.NONE)||
 "0";return["Math.atan2("+(b.valueToCode(a,"Y",Order$$module$build$src$generators$dart$dart_generator.NONE)||"0")+", "+c+") / Math.pi * 180",Order$$module$build$src$generators$dart$dart_generator.MULTIPLICATIVE]},procedures_defreturn$$module$build$src$generators$dart$procedures=function(a,b){const c=b.nameDB_.getName(a.getFieldValue("NAME"),$.NameType$$module$build$src$core$names.PROCEDURE);var d="";b.STATEMENT_PREFIX&&(d+=b.injectId(b.STATEMENT_PREFIX,a));b.STATEMENT_SUFFIX&&(d+=b.injectId(b.STATEMENT_SUFFIX,
-a));d&&(d=b.prefixLines(d,b.INDENT));let e="";b.INFINITE_LOOP_TRAP&&(e=b.prefixLines(b.injectId(b.INFINITE_LOOP_TRAP,a),b.INDENT));const f=b.statementToCode(a,"STACK");let g=b.valueToCode(a,"RETURN",Order$$module$build$src$generators$dart$dart_generator.NONE)||"",h="";f&&g&&(h=d);g&&(g=b.INDENT+"return "+g+";\n");const k=g?"dynamic":"void",l=[],n=a.getVars();for(let m=0;m<n.length;m++)l[m]=b.nameDB_.getName(n[m],$.NameType$$module$build$src$core$names.VARIABLE);d=k+" "+c+"("+l.join(", ")+") {\n"+
+a));d&&(d=b.prefixLines(d,b.INDENT));let e="";b.INFINITE_LOOP_TRAP&&(e=b.prefixLines(b.injectId(b.INFINITE_LOOP_TRAP,a),b.INDENT));const f=b.statementToCode(a,"STACK");let g=b.valueToCode(a,"RETURN",Order$$module$build$src$generators$dart$dart_generator.NONE)||"",h="";f&&g&&(h=d);g&&(g=b.INDENT+"return "+g+";\n");const k=g?"dynamic":"void",l=[],m=a.getVars();for(let n=0;n<m.length;n++)l[n]=b.nameDB_.getName(m[n],$.NameType$$module$build$src$core$names.VARIABLE);d=k+" "+c+"("+l.join(", ")+") {\n"+
 d+e+f+h+g+"}";d=b.scrub_(a,d);b.definitions_["%"+c]=d;return null},procedures_callreturn$$module$build$src$generators$dart$procedures=function(a,b){const c=b.nameDB_.getName(a.getFieldValue("NAME"),$.NameType$$module$build$src$core$names.PROCEDURE),d=[],e=a.getVars();for(let f=0;f<e.length;f++)d[f]=b.valueToCode(a,"ARG"+f,Order$$module$build$src$generators$dart$dart_generator.NONE)||"null";return[c+"("+d.join(", ")+")",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},procedures_callnoreturn$$module$build$src$generators$dart$procedures=
 function(a,b){return b.forBlock.procedures_callreturn(a,b)[0]+";\n"},procedures_ifreturn$$module$build$src$generators$dart$procedures=function(a,b){let c="if ("+(b.valueToCode(a,"CONDITION",Order$$module$build$src$generators$dart$dart_generator.NONE)||"false")+") {\n";b.STATEMENT_SUFFIX&&(c+=b.prefixLines(b.injectId(b.STATEMENT_SUFFIX,a),b.INDENT));a.hasReturnValue_?(a=b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.NONE)||"null",c+=b.INDENT+"return "+a+";\n"):c+=b.INDENT+
 "return;\n";return c+"}\n"},text$$module$build$src$generators$dart$text=function(a,b){return[b.quote_(a.getFieldValue("TEXT")),Order$$module$build$src$generators$dart$dart_generator.ATOMIC]},text_multiline$$module$build$src$generators$dart$text=function(a,b){a=b.multiline_quote_(a.getFieldValue("TEXT"));b=-1!==a.indexOf("+")?Order$$module$build$src$generators$dart$dart_generator.ADDITIVE:Order$$module$build$src$generators$dart$dart_generator.ATOMIC;return[a,b]},text_join$$module$build$src$generators$dart$text=

package/javascript_compressed.js

@@ -213,7 +213,7 @@ function ${b.FUNCTION_NAME_PLACEHOLDER_}(a, b) {
 }
 `)+"("+c+", "+a+")",Order$$module$build$src$generators$javascript$javascript_generator.FUNCTION_CALL]},math_random_float$$module$build$src$generators$javascript$math=function(a,b){return["Math.random()",Order$$module$build$src$generators$javascript$javascript_generator.FUNCTION_CALL]},math_atan2$$module$build$src$generators$javascript$math=function(a,b){const c=b.valueToCode(a,"X",Order$$module$build$src$generators$javascript$javascript_generator.NONE)||"0";return["Math.atan2("+(b.valueToCode(a,"Y",
 Order$$module$build$src$generators$javascript$javascript_generator.NONE)||"0")+", "+c+") / Math.PI * 180",Order$$module$build$src$generators$javascript$javascript_generator.DIVISION]},procedures_defreturn$$module$build$src$generators$javascript$procedures=function(a,b){const c=b.nameDB_.getName(a.getFieldValue("NAME"),$.NameType$$module$build$src$core$names.PROCEDURE);var d="";b.STATEMENT_PREFIX&&(d+=b.injectId(b.STATEMENT_PREFIX,a));b.STATEMENT_SUFFIX&&(d+=b.injectId(b.STATEMENT_SUFFIX,a));d&&(d=
-b.prefixLines(d,b.INDENT));let e="";b.INFINITE_LOOP_TRAP&&(e=b.prefixLines(b.injectId(b.INFINITE_LOOP_TRAP,a),b.INDENT));const f=b.statementToCode(a,"STACK");let g=b.valueToCode(a,"RETURN",Order$$module$build$src$generators$javascript$javascript_generator.NONE)||"",h="";f&&g&&(h=d);g&&(g=b.INDENT+"return "+g+";\n");const k=[],l=a.getVars();for(let n=0;n<l.length;n++)k[n]=b.nameDB_.getName(l[n],$.NameType$$module$build$src$core$names.VARIABLE);d="function "+c+"("+k.join(", ")+") {\n"+d+e+f+h+g+"}";
+b.prefixLines(d,b.INDENT));let e="";b.INFINITE_LOOP_TRAP&&(e=b.prefixLines(b.injectId(b.INFINITE_LOOP_TRAP,a),b.INDENT));const f=b.statementToCode(a,"STACK");let g=b.valueToCode(a,"RETURN",Order$$module$build$src$generators$javascript$javascript_generator.NONE)||"",h="";f&&g&&(h=d);g&&(g=b.INDENT+"return "+g+";\n");const k=[],l=a.getVars();for(let m=0;m<l.length;m++)k[m]=b.nameDB_.getName(l[m],$.NameType$$module$build$src$core$names.VARIABLE);d="function "+c+"("+k.join(", ")+") {\n"+d+e+f+h+g+"}";
 d=b.scrub_(a,d);b.definitions_["%"+c]=d;return null},procedures_callreturn$$module$build$src$generators$javascript$procedures=function(a,b){const c=b.nameDB_.getName(a.getFieldValue("NAME"),$.NameType$$module$build$src$core$names.PROCEDURE),d=[],e=a.getVars();for(let f=0;f<e.length;f++)d[f]=b.valueToCode(a,"ARG"+f,Order$$module$build$src$generators$javascript$javascript_generator.NONE)||"null";return[c+"("+d.join(", ")+")",Order$$module$build$src$generators$javascript$javascript_generator.FUNCTION_CALL]},
 procedures_callnoreturn$$module$build$src$generators$javascript$procedures=function(a,b){return b.forBlock.procedures_callreturn(a,b)[0]+";\n"},procedures_ifreturn$$module$build$src$generators$javascript$procedures=function(a,b){let c="if ("+(b.valueToCode(a,"CONDITION",Order$$module$build$src$generators$javascript$javascript_generator.NONE)||"false")+") {\n";b.STATEMENT_SUFFIX&&(c+=b.prefixLines(b.injectId(b.STATEMENT_SUFFIX,a),b.INDENT));a.hasReturnValue_?(a=b.valueToCode(a,"VALUE",Order$$module$build$src$generators$javascript$javascript_generator.NONE)||
 "null",c+=b.INDENT+"return "+a+";\n"):c+=b.INDENT+"return;\n";return c+"}\n"},text$$module$build$src$generators$javascript$text=function(a,b){return[b.quote_(a.getFieldValue("TEXT")),Order$$module$build$src$generators$javascript$javascript_generator.ATOMIC]},text_multiline$$module$build$src$generators$javascript$text=function(a,b){a=b.multiline_quote_(a.getFieldValue("TEXT"));b=-1!==a.indexOf("+")?Order$$module$build$src$generators$javascript$javascript_generator.ADDITION:Order$$module$build$src$generators$javascript$javascript_generator.ATOMIC;

package/lua_compressed.js

@@ -275,7 +275,7 @@ end
 function(a,b){const c=b.valueToCode(a,"VALUE",Order$$module$build$src$generators$lua$lua_generator.NONE)||"0",d=b.valueToCode(a,"LOW",Order$$module$build$src$generators$lua$lua_generator.NONE)||"-math.huge";a=b.valueToCode(a,"HIGH",Order$$module$build$src$generators$lua$lua_generator.NONE)||"math.huge";return["math.min(math.max("+c+", "+d+"), "+a+")",Order$$module$build$src$generators$lua$lua_generator.HIGH]},math_random_int$$module$build$src$generators$lua$math=function(a,b){const c=b.valueToCode(a,
 "FROM",Order$$module$build$src$generators$lua$lua_generator.NONE)||"0";a=b.valueToCode(a,"TO",Order$$module$build$src$generators$lua$lua_generator.NONE)||"0";return["math.random("+c+", "+a+")",Order$$module$build$src$generators$lua$lua_generator.HIGH]},math_random_float$$module$build$src$generators$lua$math=function(a,b){return["math.random()",Order$$module$build$src$generators$lua$lua_generator.HIGH]},math_atan2$$module$build$src$generators$lua$math=function(a,b){const c=b.valueToCode(a,"X",Order$$module$build$src$generators$lua$lua_generator.NONE)||
 "0";return["math.deg(math.atan2("+(b.valueToCode(a,"Y",Order$$module$build$src$generators$lua$lua_generator.NONE)||"0")+", "+c+"))",Order$$module$build$src$generators$lua$lua_generator.HIGH]},procedures_defreturn$$module$build$src$generators$lua$procedures=function(a,b){const c=b.nameDB_.getName(a.getFieldValue("NAME"),$.NameType$$module$build$src$core$names.PROCEDURE);var d="";b.STATEMENT_PREFIX&&(d+=b.injectId(b.STATEMENT_PREFIX,a));b.STATEMENT_SUFFIX&&(d+=b.injectId(b.STATEMENT_SUFFIX,a));d&&(d=
-b.prefixLines(d,b.INDENT));let e="";b.INFINITE_LOOP_TRAP&&(e=b.prefixLines(b.injectId(b.INFINITE_LOOP_TRAP,a),b.INDENT));let f=b.statementToCode(a,"STACK"),g=b.valueToCode(a,"RETURN",Order$$module$build$src$generators$lua$lua_generator.NONE)||"",h="";f&&g&&(h=d);g?g=b.INDENT+"return "+g+"\n":f||(f="");const k=[],l=a.getVars();for(let n=0;n<l.length;n++)k[n]=b.nameDB_.getName(l[n],$.NameType$$module$build$src$core$names.VARIABLE);d="function "+c+"("+k.join(", ")+")\n"+d+e+f+h+g+"end\n";d=b.scrub_(a,
+b.prefixLines(d,b.INDENT));let e="";b.INFINITE_LOOP_TRAP&&(e=b.prefixLines(b.injectId(b.INFINITE_LOOP_TRAP,a),b.INDENT));let f=b.statementToCode(a,"STACK"),g=b.valueToCode(a,"RETURN",Order$$module$build$src$generators$lua$lua_generator.NONE)||"",h="";f&&g&&(h=d);g?g=b.INDENT+"return "+g+"\n":f||(f="");const k=[],l=a.getVars();for(let m=0;m<l.length;m++)k[m]=b.nameDB_.getName(l[m],$.NameType$$module$build$src$core$names.VARIABLE);d="function "+c+"("+k.join(", ")+")\n"+d+e+f+h+g+"end\n";d=b.scrub_(a,
 d);b.definitions_["%"+c]=d;return null},procedures_callreturn$$module$build$src$generators$lua$procedures=function(a,b){const c=b.nameDB_.getName(a.getFieldValue("NAME"),$.NameType$$module$build$src$core$names.PROCEDURE),d=[],e=a.getVars();for(let f=0;f<e.length;f++)d[f]=b.valueToCode(a,"ARG"+f,Order$$module$build$src$generators$lua$lua_generator.NONE)||"nil";return[c+"("+d.join(", ")+")",Order$$module$build$src$generators$lua$lua_generator.HIGH]},procedures_callnoreturn$$module$build$src$generators$lua$procedures=
 function(a,b){return b.forBlock.procedures_callreturn(a,b)[0]+"\n"},procedures_ifreturn$$module$build$src$generators$lua$procedures=function(a,b){let c="if "+(b.valueToCode(a,"CONDITION",Order$$module$build$src$generators$lua$lua_generator.NONE)||"false")+" then\n";b.STATEMENT_SUFFIX&&(c+=b.prefixLines(b.injectId(b.STATEMENT_SUFFIX,a),b.INDENT));a.hasReturnValue_?(a=b.valueToCode(a,"VALUE",Order$$module$build$src$generators$lua$lua_generator.NONE)||"nil",c+=b.INDENT+"return "+a+"\n"):c+=b.INDENT+
 "return\n";return c+"end\n"},text$$module$build$src$generators$lua$text=function(a,b){return[b.quote_(a.getFieldValue("TEXT")),Order$$module$build$src$generators$lua$lua_generator.ATOMIC]},text_multiline$$module$build$src$generators$lua$text=function(a,b){a=b.multiline_quote_(a.getFieldValue("TEXT"));b=-1!==a.indexOf("..")?Order$$module$build$src$generators$lua$lua_generator.CONCATENATION:Order$$module$build$src$generators$lua$lua_generator.ATOMIC;return[a,b]},text_join$$module$build$src$generators$lua$text=