blockly 11.2.0-beta.1 → 12.0.0-beta.0

package/core/flyout_button.d.ts

@@ -9,13 +9,16 @@
  * @class
  */
 import type { IASTNodeLocationSvg } from './blockly.js';
+import type { IBoundedElement } from './interfaces/i_bounded_element.js';
+import type { IRenderedElement } from './interfaces/i_rendered_element.js';
 import { Coordinate } from './utils/coordinate.js';
+import { Rect } from './utils/rect.js';
 import type * as toolbox from './utils/toolbox.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for a button or label in the flyout.
  */
-export declare class FlyoutButton implements IASTNodeLocationSvg {
+export declare class FlyoutButton implements IASTNodeLocationSvg, IBoundedElement, IRenderedElement {
     private readonly workspace;
     private readonly targetWorkspace;
     private readonly isFlyoutLabel;
@@ -30,6 +33,7 @@ export declare class FlyoutButton implements IASTNodeLocationSvg {
     private readonly callbackKey;
     private readonly cssClass;
     /** Mouse up event data. */
+    private onMouseDownWrapper;
     private onMouseUpWrapper;
     info: toolbox.ButtonOrLabelInfo;
     /** The width of the button's rect. */
@@ -53,11 +57,6 @@ export declare class FlyoutButton implements IASTNodeLocationSvg {
      * @internal
      */
     constructor(workspace: WorkspaceSvg, targetWorkspace: WorkspaceSvg, json: toolbox.ButtonOrLabelInfo, isFlyoutLabel: boolean);
-    /**
-     * Create the button elements.
-     *
-     * @returns The button's SVG group.
-     */
     createDom(): SVGElement;
     /** Correctly position the flyout button and make it visible. */
     show(): void;
@@ -70,6 +69,14 @@ export declare class FlyoutButton implements IASTNodeLocationSvg {
      * @param y The new y coordinate.
      */
     moveTo(x: number, y: number): void;
+    /**
+     * Move the element by a relative offset.
+     *
+     * @param dx Horizontal offset in workspace units.
+     * @param dy Vertical offset in workspace units.
+     * @param _reason Why is this move happening?  'user', 'bump', 'snap'...
+     */
+    moveBy(dx: number, dy: number, _reason?: string[]): void;
     /** @returns Whether or not the button is a label. */
     isLabel(): boolean;
     /**
@@ -79,6 +86,13 @@ export declare class FlyoutButton implements IASTNodeLocationSvg {
      * @internal
      */
     getPosition(): Coordinate;
+    /**
+     * Returns the coordinates of a bounded element describing the dimensions of
+     * the element. Coordinate system: workspace coordinates.
+     *
+     * @returns Object with coordinates of the bounded element.
+     */
+    getBoundingRectangle(): Rect;
     /** @returns Text of the button. */
     getButtonText(): string;
     /**
@@ -114,5 +128,10 @@ export declare class FlyoutButton implements IASTNodeLocationSvg {
      * @param e Pointer up event.
      */
     private onMouseUp;
+    private onMouseDown;
+    /**
+     * @returns The root SVG element of this rendered element.
+     */
+    getSvgRoot(): SVGGElement;
 }
 //# sourceMappingURL=flyout_button.d.ts.map

package/core/flyout_horizontal.d.ts

@@ -56,10 +56,9 @@ export declare class HorizontalFlyout extends Flyout {
     /**
      * Lay out the blocks in the flyout.
      *
-     * @param contents The blocks and buttons to lay out.
-     * @param gaps The visible gaps between blocks.
+     * @param contents The flyout items to lay out.
      */
-    protected layout_(contents: FlyoutItem[], gaps: number[]): void;
+    protected layout_(contents: FlyoutItem[]): void;
     /**
      * Determine if a drag delta is toward the workspace, based on the position
      * and orientation of the flyout. This is used in determineDragIntention_ to

package/core/flyout_metrics_manager.d.ts

@@ -29,7 +29,7 @@ export declare class FlyoutMetricsManager extends MetricsManager {
      *
      * @returns The bounding box of the blocks on the workspace.
      */
-    private getBoundingBox_;
+    private getBoundingBox;
     getContentMetrics(opt_getWorkspaceCoordinates?: boolean): {
         height: number;
         width: number;

package/core/flyout_separator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IBoundedElement } from './interfaces/i_bounded_element.js';
+import { Rect } from './utils/rect.js';
+/**
+ * Representation of a gap between elements in a flyout.
+ */
+export declare class FlyoutSeparator implements IBoundedElement {
+    private gap;
+    private axis;
+    private x;
+    private y;
+    /**
+     * Creates a new separator.
+     *
+     * @param gap The amount of space this separator should occupy.
+     * @param axis The axis along which this separator occupies space.
+     */
+    constructor(gap: number, axis: SeparatorAxis);
+    /**
+     * Returns the bounding box of this separator.
+     *
+     * @returns The bounding box of this separator.
+     */
+    getBoundingRectangle(): Rect;
+    /**
+     * Repositions this separator.
+     *
+     * @param dx The distance to move this separator on the X axis.
+     * @param dy The distance to move this separator on the Y axis.
+     * @param _reason The reason this move was initiated.
+     */
+    moveBy(dx: number, dy: number, _reason?: string[]): void;
+}
+/**
+ * Representation of an axis along which a separator occupies space.
+ */
+export declare const enum SeparatorAxis {
+    X = "x",
+    Y = "y"
+}
+//# sourceMappingURL=flyout_separator.d.ts.map

package/core/flyout_vertical.d.ts

@@ -57,10 +57,9 @@ export declare class VerticalFlyout extends Flyout {
     /**
      * Lay out the blocks in the flyout.
      *
-     * @param contents The blocks and buttons to lay out.
-     * @param gaps The visible gaps between blocks.
+     * @param contents The flyout items to lay out.
      */
-    protected layout_(contents: FlyoutItem[], gaps: number[]): void;
+    protected layout_(contents: FlyoutItem[]): void;
     /**
      * Determine if a drag delta is toward the workspace, based on the position
      * and orientation of the flyout. This is used in determineDragIntention_ to
@@ -80,7 +79,7 @@ export declare class VerticalFlyout extends Flyout {
      */
     getClientRect(): Rect | null;
     /**
-     * Compute width of flyout.  toolbox.Position mat under each block.
+     * Compute width of flyout.
      * For RTL: Lay out the blocks and buttons to be right-aligned.
      */
     protected reflowInternal_(): void;

package/core/generator.d.ts

@@ -19,7 +19,7 @@ import type { Workspace } from './workspace.js';
  * @deprecated
  * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/generating-code}
  * @param block The Block instance to generate code for.
- * @param genearator The CodeGenerator calling the function.
+ * @param generator The CodeGenerator calling the function.
  * @returns A string containing the generated code (for statement blocks),
  *     or a [code, precedence] tuple (for value/expression blocks), or
  *     null if no code should be emitted for block.

package/core/gesture.d.ts

@@ -101,7 +101,7 @@ export declare class Gesture {
     /** The event that most recently updated this gesture. */
     private mostRecentEvent;
     /** Boolean for whether or not this gesture is a multi-touch gesture. */
-    private isMultiTouch_;
+    private multiTouch;
     /** A map of cached points used for tracking multi-touch gestures. */
     private cachedPoints;
     /**

package/core/grid.d.ts

@@ -113,9 +113,12 @@ export declare class Grid {
      * @param rnd A random ID to append to the pattern's ID.
      * @param gridOptions The object containing grid configuration.
      * @param defs The root SVG element for this workspace's defs.
+     * @param injectionDiv The div containing the parent workspace and all related
+     *   workspaces and block containers. CSS variables representing SVG patterns
+     *   will be scoped to this container.
      * @returns The SVG element for the grid pattern.
      * @internal
      */
-    static createDom(rnd: string, gridOptions: GridOptions, defs: SVGElement): SVGElement;
+    static createDom(rnd: string, gridOptions: GridOptions, defs: SVGElement, injectionDiv?: HTMLElement): SVGElement;
 }
 //# sourceMappingURL=grid.d.ts.map

package/core/icons/comment_icon.d.ts

@@ -28,6 +28,8 @@ export declare class CommentIcon extends Icon implements IHasBubble, ISerializab
     private text;
     /** The size of this comment (which is applied to the editable bubble). */
     private bubbleSize;
+    /** The location of the comment bubble in workspace coordinates. */
+    private bubbleLocation?;
     /**
      * The visibility of the bubble for this comment.
      *
@@ -60,6 +62,14 @@ export declare class CommentIcon extends Icon implements IHasBubble, ISerializab
     setBubbleSize(size: Size): void;
     /** @returns the size of the editable bubble for this comment. */
     getBubbleSize(): Size;
+    /**
+     * Sets the location of the comment bubble in the workspace.
+     */
+    setBubbleLocation(location: Coordinate): void;
+    /**
+     * @returns the location of the comment bubble in the workspace.
+     */
+    getBubbleLocation(): Coordinate | undefined;
     /**
      * @returns the state of the comment as a JSON serializable value if the
      * comment has text. Otherwise returns null.
@@ -79,6 +89,7 @@ export declare class CommentIcon extends Icon implements IHasBubble, ISerializab
      * input bubble.
      */
     onSizeChange(): void;
+    onBubbleLocationChange(): void;
     bubbleIsVisible(): boolean;
     setBubbleVisible(visible: boolean): Promise<void>;
     /**
@@ -112,5 +123,9 @@ export interface CommentState {
     height?: number;
     /** The width of the comment bubble. */
     width?: number;
+    /** The X coordinate of the comment bubble. */
+    x?: number;
+    /** The Y coordinate of the comment bubble. */
+    y?: number;
 }
 //# sourceMappingURL=comment_icon.d.ts.map

package/core/interfaces/i_comment_icon.d.ts

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { CommentState } from '../icons/comment_icon.js';
+import { Coordinate } from '../utils/coordinate.js';
 import { Size } from '../utils/size.js';
 import { IHasBubble } from './i_has_bubble.js';
 import { IIcon } from './i_icon.js';
@@ -13,6 +14,8 @@ export interface ICommentIcon extends IIcon, IHasBubble, ISerializable {
     getText(): string;
     setBubbleSize(size: Size): void;
     getBubbleSize(): Size;
+    setBubbleLocation(location: Coordinate): void;
+    getBubbleLocation(): Coordinate | undefined;
     saveState(): CommentState;
     loadState(state: CommentState): void;
 }

package/core/interfaces/i_flyout_inflater.d.ts

@@ -0,0 +1,39 @@
+import type { WorkspaceSvg } from '../workspace_svg.js';
+import type { IBoundedElement } from './i_bounded_element.js';
+export interface IFlyoutInflater {
+    /**
+     * Loads the object represented by the given state onto the workspace.
+     *
+     * Note that this method's interface is identical to that in ISerializer, to
+     * allow for code reuse.
+     *
+     * @param state A JSON representation of an element to inflate on the flyout.
+     * @param flyoutWorkspace The flyout's workspace, where the inflated element
+     *    should be created. If the inflated element is an `IRenderedElement` it
+     *    itself or the inflater should append it to the workspace; the flyout
+     *    will not do so itself. The flyout is responsible for positioning the
+     *    element, however.
+     * @returns The newly inflated flyout element.
+     */
+    load(state: object, flyoutWorkspace: WorkspaceSvg): IBoundedElement;
+    /**
+     * Returns the amount of spacing that should follow the element corresponding
+     * to the given JSON representation.
+     *
+     * @param state A JSON representation of the element preceding the gap.
+     * @param defaultGap The default gap for elements in this flyout.
+     * @returns The gap that should follow the given element.
+     */
+    gapForElement(state: object, defaultGap: number): number;
+    /**
+     * Disposes of the given element.
+     *
+     * If the element in question resides on the flyout workspace, it should remove
+     * itself. Implementers are not otherwise required to fully dispose of the
+     * element; it may be e.g. cached for performance purposes.
+     *
+     * @param element The flyout element to dispose of.
+     */
+    disposeElement(element: IBoundedElement): void;
+}
+//# sourceMappingURL=i_flyout_inflater.d.ts.map

package/core/interfaces/i_toolbox.d.ts

@@ -77,7 +77,7 @@ export interface IToolbox extends IRegistrable {
      */
     setVisible(isVisible: boolean): void;
     /**
-     * Selects the toolbox item by it's position in the list of toolbox items.
+     * Selects the toolbox item by its position in the list of toolbox items.
      *
      * @param position The position of the item to select.
      */
@@ -88,6 +88,13 @@ export interface IToolbox extends IRegistrable {
      * @returns The selected item, or null if no item is currently selected.
      */
     getSelectedItem(): IToolboxItem | null;
+    /**
+     * Sets the selected item.
+     *
+     * @param item The toolbox item to select, or null to remove the current
+     *     selection.
+     */
+    setSelectedItem(item: IToolboxItem | null): void;
     /** Disposes of this toolbox. */
     dispose(): void;
 }

package/core/interfaces/i_variable_backed_parameter_model.d.ts

@@ -3,12 +3,12 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { VariableModel } from '../variable_model.js';
 import { IParameterModel } from './i_parameter_model.js';
+import type { IVariableModel, IVariableState } from './i_variable_model.js';
 /** Interface for a parameter model that holds a variable model. */
 export interface IVariableBackedParameterModel extends IParameterModel {
     /** Returns the variable model held by this type. */
-    getVariableModel(): VariableModel;
+    getVariableModel(): IVariableModel<IVariableState>;
 }
 /**
  * Returns whether the given object is a variable holder or not.

package/core/interfaces/i_variable_map.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IVariableModel, IVariableState } from './i_variable_model.js';
+/**
+ * Variable maps are container objects responsible for storing and managing the
+ * set of variables referenced on a workspace.
+ *
+ * Any of these methods may define invariants about which names and types are
+ * legal, and throw if they are not met.
+ */
+export interface IVariableMap<T extends IVariableModel<IVariableState>> {
+    getVariableById(id: string): T | null;
+    /**
+     * Returns the variable with the given name, or null if not found. If `type`
+     * is provided, the variable's type must also match, or null should be
+     * returned.
+     */
+    getVariable(name: string, type?: string): T | null;
+    getAllVariables(): T[];
+    /**
+     * Returns a list of all of the variables of the given type managed by this
+     * variable map.
+     */
+    getVariablesOfType(type: string): T[];
+    /**
+     * Returns a list of the set of types of the variables managed by this
+     * variable map.
+     */
+    getTypes(): string[];
+    /**
+     * Creates a new variable with the given name. If ID is not specified, the
+     * variable map should create one. Returns the new variable.
+     */
+    createVariable(name: string, id?: string, type?: string | null): T;
+    addVariable(variable: T): void;
+    /**
+     * Changes the name of the given variable to the name provided and returns the
+     * renamed variable.
+     */
+    renameVariable(variable: T, newName: string): T;
+    changeVariableType(variable: T, newType: string): T;
+    deleteVariable(variable: T): void;
+    clear(): void;
+}
+//# sourceMappingURL=i_variable_map.d.ts.map

package/core/interfaces/i_variable_model.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Workspace } from '../workspace.js';
+export interface IVariableModel<T extends IVariableState> {
+    getId(): string;
+    getName(): string;
+    /**
+     * Returns the type of the variable like 'int' or 'string'.  Does not need to be
+     * unique. This will default to '' which is a specific type.
+     */
+    getType(): string;
+    setName(name: string): this;
+    setType(type: string): this;
+    getWorkspace(): Workspace;
+    save(): T;
+}
+export interface IVariableModelStatic<T extends IVariableState> {
+    new (workspace: Workspace, name: string, type?: string, id?: string): IVariableModel<T>;
+    /**
+     * Creates a new IVariableModel corresponding to the given state on the
+     * specified workspace. This method must be static in your implementation.
+     */
+    load(state: T, workspace: Workspace): IVariableModel<T>;
+}
+/**
+ * Represents the state of a given variable.
+ */
+export interface IVariableState {
+    name: string;
+    id: string;
+    type?: string;
+}
+//# sourceMappingURL=i_variable_model.d.ts.map

package/core/label_flyout_inflater.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IBoundedElement } from './interfaces/i_bounded_element.js';
+import type { IFlyoutInflater } from './interfaces/i_flyout_inflater.js';
+import type { WorkspaceSvg } from './workspace_svg.js';
+/**
+ * Class responsible for creating labels for flyouts.
+ */
+export declare class LabelFlyoutInflater implements IFlyoutInflater {
+    /**
+     * Inflates a flyout label from the given state and adds it to the flyout.
+     *
+     * @param state A JSON representation of a flyout label.
+     * @param flyoutWorkspace The workspace to create the label on.
+     * @returns A FlyoutButton configured as a label.
+     */
+    load(state: object, flyoutWorkspace: WorkspaceSvg): IBoundedElement;
+    /**
+     * Returns the amount of space that should follow this label.
+     *
+     * @param state A JSON representation of a flyout label.
+     * @param defaultGap The default spacing for flyout items.
+     * @returns The amount of space that should follow this label.
+     */
+    gapForElement(state: object, defaultGap: number): number;
+    /**
+     * Disposes of the given label.
+     *
+     * @param element The flyout label to dispose of.
+     */
+    disposeElement(element: IBoundedElement): void;
+}
+//# sourceMappingURL=label_flyout_inflater.d.ts.map

package/core/marker_manager.d.ts

@@ -19,13 +19,13 @@ export declare class MarkerManager {
     /** The name of the local marker. */
     static readonly LOCAL_MARKER = "local_marker_1";
     /** The cursor. */
-    private cursor_;
+    private cursor;
     /** The cursor's SVG element. */
-    private cursorSvg_;
+    private cursorSvg;
     /** The map of markers for the workspace. */
     private markers;
     /** The marker's SVG element. */
-    private markerSvg_;
+    private markerSvg;
     /**
      * @param workspace The workspace for the marker manager.
      * @internal

package/core/menuitem.d.ts

@@ -95,13 +95,6 @@ export declare class MenuItem {
      * @internal
      */
     setChecked(checked: boolean): void;
-    /**
-     * Highlights or unhighlights the component.
-     *
-     * @param highlight Whether to highlight or unhighlight the component.
-     * @internal
-     */
-    setHighlighted(highlight: boolean): void;
     /**
      * Returns true if the menu item is enabled, false otherwise.
      *

package/core/names.d.ts

@@ -3,7 +3,13 @@
  * Copyright 2012 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { VariableMap } from './variable_map.js';
+/**
+ * Utility functions for handling variable and procedure names.
+ *
+ * @class
+ */
+import type { IVariableMap } from './interfaces/i_variable_map.js';
+import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
 import type { Workspace } from './workspace.js';
 /**
  * Class for a database of entity names (variables, procedures, etc).
@@ -40,7 +46,7 @@ export declare class Names {
      *
      * @param map The map to track.
      */
-    setVariableMap(map: VariableMap): void;
+    setVariableMap(map: IVariableMap<IVariableModel<IVariableState>>): void;
     /**
      * Get the name for a user-defined variable, based on its ID.
      * This should only be used for variables of NameType VARIABLE.

package/core/options.d.ts

@@ -87,7 +87,7 @@ export declare class Options {
      * @param hasCategories Whether the workspace has categories or not.
      * @returns Normalized move options.
      */
-    private static parseMoveOptions_;
+    private static parseMoveOptions;
     /**
      * Parse the user-specified zoom options, using reasonable defaults where
      * behaviour is unspecified.  See zoom documentation:
@@ -96,7 +96,7 @@ export declare class Options {
      * @param options Dictionary of options.
      * @returns Normalized zoom options.
      */
-    private static parseZoomOptions_;
+    private static parseZoomOptions;
     /**
      * Parse the user-specified grid options, using reasonable defaults where
      * behaviour is unspecified. See grid documentation:
@@ -105,7 +105,7 @@ export declare class Options {
      * @param options Dictionary of options.
      * @returns Normalized grid options.
      */
-    private static parseGridOptions_;
+    private static parseGridOptions;
     /**
      * Parse the user-specified theme options, using the classic theme as a
      * default. https://developers.google.com/blockly/guides/configure/web/themes
@@ -113,7 +113,7 @@ export declare class Options {
      * @param options Dictionary of options.
      * @returns A Blockly Theme.
      */
-    private static parseThemeOptions_;
+    private static parseThemeOptions;
 }
 export declare namespace Options {
     interface GridOptions {

package/core/registry.d.ts

@@ -11,11 +11,14 @@ import type { IConnectionPreviewer } from './interfaces/i_connection_previewer.j
 import type { ICopyable } from './interfaces/i_copyable.js';
 import type { IDragger } from './interfaces/i_dragger.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
+import type { IFlyoutInflater } from './interfaces/i_flyout_inflater.js';
 import type { IIcon } from './interfaces/i_icon.js';
 import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
 import type { IPaster } from './interfaces/i_paster.js';
 import type { ISerializer } from './interfaces/i_serializer.js';
 import type { IToolbox } from './interfaces/i_toolbox.js';
+import type { IVariableMap } from './interfaces/i_variable_map.js';
+import type { IVariableModel, IVariableModelStatic, IVariableState } from './interfaces/i_variable_model.js';
 import type { Cursor } from './keyboard_nav/cursor.js';
 import type { Options } from './options.js';
 import type { Renderer } from './renderers/common/renderer.js';
@@ -57,6 +60,7 @@ export declare class Type<_T> {
     static TOOLBOX_ITEM: Type<ToolboxItem>;
     static FLYOUTS_VERTICAL_TOOLBOX: Type<IFlyout>;
     static FLYOUTS_HORIZONTAL_TOOLBOX: Type<IFlyout>;
+    static FLYOUT_INFLATER: Type<IFlyoutInflater>;
     static METRICS_MANAGER: Type<IMetricsManager>;
     /**
      * Type for an IDragger. Formerly behavior was mostly covered by
@@ -69,6 +73,8 @@ export declare class Type<_T> {
     static ICON: Type<IIcon>;
     /** @internal */
     static PASTER: Type<IPaster<ICopyable.ICopyData, ICopyable<ICopyable.ICopyData>>>;
+    static VARIABLE_MODEL: Type<IVariableModelStatic<IVariableState>>;
+    static VARIABLE_MAP: Type<IVariableMap<IVariableModel<IVariableState>>>;
 }
 /**
  * Registers a class based on a type and name.

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

@@ -424,8 +424,13 @@ export declare class ConstantProvider {
      * @param svg The root of the workspace's SVG.
      * @param tagName The name to use for the CSS style tag.
      * @param selector The CSS selector to use.
+     * @param injectionDivIfIsParent The div containing the parent workspace and
+     *   all related workspaces and block containers, if this renderer is for the
+     *   parent workspace. CSS variables representing SVG patterns will be scoped
+     *   to this container. Child workspaces should not override the CSS variables
+     *   created by the parent and thus do not need access to the injection div.
      */
-    createDom(svg: SVGElement, tagName: string, selector: string): void;
+    createDom(svg: SVGElement, tagName: string, selector: string, injectionDivIfIsParent?: HTMLElement): void;
     /**
      * Create a filter for highlighting the currently rendering block during
      * render debugging.

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

@@ -39,19 +39,6 @@ export interface IPathObject {
      * @param pathString The path.
      */
     setPath(pathString: string): void;
-    /**
-     * Apply the stored colours to the block's path, taking into account whether
-     * the paths belong to a shadow block.
-     *
-     * @param block The source block.
-     */
-    applyColour(block: BlockSvg): void;
-    /**
-     * Update the style.
-     *
-     * @param blockStyle The block style to use.
-     */
-    setStyle(blockStyle: BlockStyle): void;
     /**
      * Flip the SVG paths in RTL.
      */
@@ -104,9 +91,22 @@ export interface IPathObject {
     updateMovable(enabled: boolean): void;
     /** Adds the given path as a connection highlight for the given connection. */
     addConnectionHighlight?(connection: RenderedConnection, connectionPath: string, offset: Coordinate, rtl: boolean): void;
+    /**
+     * Apply the stored colours to the block's path, taking into account whether
+     * the paths belong to a shadow block.
+     *
+     * @param block The source block.
+     */
+    applyColour?(block: BlockSvg): void;
     /**
      * Removes any highlight associated with the given connection, if it exists.
      */
     removeConnectionHighlight?(connection: RenderedConnection): void;
+    /**
+     * Update the style.
+     *
+     * @param blockStyle The block style to use.
+     */
+    setStyle?(blockStyle: BlockStyle): void;
 }
 //# sourceMappingURL=i_path_object.d.ts.map