blockly 12.0.0-beta.4 → 12.0.0-beta.6

package/core/keyboard_nav/line_cursor.d.ts

@@ -11,40 +11,22 @@
  * connections and fields.
  * @author aschmiedt@google.com (Abby Schmiedt)
  */
-import type { Block } from '../block.js';
-import type { MarkerSvg } from '../renderers/common/marker_svg.js';
-import type { WorkspaceSvg } from '../workspace_svg.js';
-import { ASTNode } from './ast_node.js';
+import { BlockSvg } from '../block_svg.js';
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
+import { WorkspaceSvg } from '../workspace_svg.js';
 import { Marker } from './marker.js';
-/** Options object for LineCursor instances. */
-export interface CursorOptions {
-    /**
-     * Can the cursor visit all stack connections (next/previous), or
-     * (if false) only unconnected next connections?
-     */
-    stackConnections: boolean;
-}
 /**
  * Class for a line cursor.
  */
 export declare class LineCursor extends Marker {
-    private readonly workspace;
+    protected readonly workspace: WorkspaceSvg;
     type: string;
-    /** Options for this line cursor. */
-    private readonly options;
     /** Locations to try moving the cursor to after a deletion. */
     private potentialNodes;
-    /** Whether the renderer is zelos-style. */
-    private isZelos;
     /**
      * @param workspace The workspace this cursor belongs to.
-     * @param options Cursor options.
      */
-    constructor(workspace: WorkspaceSvg, options?: Partial<CursorOptions>);
-    /**
-     * Clean up this cursor.
-     */
-    dispose(): void;
+    constructor(workspace: WorkspaceSvg);
     /**
      * Moves the cursor to the next previous connection, next connection or block
      * in the pre order traversal. Finds the next node in the pre order traversal.
@@ -52,7 +34,7 @@ export declare class LineCursor extends Marker {
      * @returns The next node, or null if the current node is
      *     not set or there is no next value.
      */
-    next(): ASTNode | null;
+    next(): IFocusableNode | null;
     /**
      * Moves the cursor to the next input connection or field
      * in the pre order traversal.
@@ -60,7 +42,7 @@ export declare class LineCursor extends Marker {
      * @returns The next node, or null if the current node is
      *     not set or there is no next value.
      */
-    in(): ASTNode | null;
+    in(): IFocusableNode | null;
     /**
      * Moves the cursor to the previous next connection or previous connection in
      * the pre order traversal.
@@ -68,7 +50,7 @@ export declare class LineCursor extends Marker {
      * @returns The previous node, or null if the current node
      *     is not set or there is no previous value.
      */
-    prev(): ASTNode | null;
+    prev(): IFocusableNode | null;
     /**
      * Moves the cursor to the previous input connection or field in the pre order
      * traversal.
@@ -76,61 +58,14 @@ export declare class LineCursor extends Marker {
      * @returns The previous node, or null if the current node
      *     is not set or there is no previous value.
      */
-    out(): ASTNode | null;
+    out(): IFocusableNode | null;
     /**
      * Returns true iff the node to which we would navigate if in() were
-     * called, which will be a validInLineNode, is also a validLineNode
-     * - in effect, if the LineCursor is at the end of the 'current
+     * called is the same as the node to which we would navigate if next() were
+     * called - in effect, if the LineCursor is at the end of the 'current
      * line' of the program.
      */
     atEndOfLine(): boolean;
-    /**
-     * Returns true iff the given node represents the "beginning of a
-     * new line of code" (and thus can be visited by pressing the
-     * up/down arrow keys).  Specifically, if the node is for:
-     *
-     * - Any block that is not a value block.
-     * - A top-level value block (one that is unconnected).
-     * - An unconnected next statement input.
-     * - An unconnected 'next' connection - the "blank line at the end".
-     *   This is to facilitate connecting additional blocks to a
-     *   stack/substack.
-     *
-     * If options.stackConnections is true (the default) then allow the
-     * cursor to visit all (useful) stack connection by additionally
-     * returning true for:
-     *
-     *   - Any next statement input
-     *   - Any 'next' connection.
-     *   - An unconnected previous statement input.
-     *
-     * @param node The AST node to check.
-     * @returns True if the node should be visited, false otherwise.
-     */
-    protected validLineNode(node: ASTNode | null): boolean;
-    /**
-     * Returns true iff the given node can be visited by the cursor when
-     * using the left/right arrow keys.  Specifically, if the node is
-     * any node for which valideLineNode would return true, plus:
-     *
-     * - Any block.
-     * - Any field that is not a full block field.
-     * - Any unconnected next or input connection.  This is to
-     *   facilitate connecting additional blocks.
-     *
-     * @param node The AST node to check whether it is valid.
-     * @returns True if the node should be visited, false otherwise.
-     */
-    protected validInLineNode(node: ASTNode | null): boolean;
-    /**
-     * Returns true iff the given node can be visited by the cursor.
-     * Specifically, if the node is any for which validInLineNode would
-     * return true, or if it is a workspace node.
-     *
-     * @param node The AST node to check whether it is valid.
-     * @returns True if the node should be visited, false otherwise.
-     */
-    protected validNode(node: ASTNode | null): boolean;
     /**
      * Uses pre order traversal to navigate the Blockly AST. This will allow
      * a user to easily navigate the entire Blockly AST without having to go in
@@ -139,6 +74,7 @@ export declare class LineCursor extends Marker {
      * @param node The current position in the AST.
      * @param isValid A function true/false depending on whether the given node
      *     should be traversed.
+     * @param visitedNodes A set of previously visited nodes used to avoid cycles.
      * @returns The next node in the traversal.
      */
     private getNextNodeImpl;
@@ -148,11 +84,11 @@ export declare class LineCursor extends Marker {
      * @param node The current position in the AST.
      * @param isValid A function true/false depending on whether the given node
      *     should be traversed.
-     * @param loop Whether to loop around to the beginning of the workspace if
-     *     novalid node was found.
+     * @param loop Whether to loop around to the beginning of the workspace if no
+     *     valid node was found.
      * @returns The next node in the traversal.
      */
-    getNextNode(node: ASTNode | null, isValid: (p1: ASTNode | null) => boolean, loop: boolean): ASTNode | null;
+    getNextNode(node: IFocusableNode | null, isValid: (p1: IFocusableNode | null) => boolean, loop: boolean): IFocusableNode | null;
     /**
      * Reverses the pre order traversal in order to find the previous node. This
      * will allow a user to easily navigate the entire Blockly AST without having
@@ -161,6 +97,7 @@ export declare class LineCursor extends Marker {
      * @param node The current position in the AST.
      * @param isValid A function true/false depending on whether the given node
      *     should be traversed.
+     * @param visitedNodes A set of previously visited nodes used to avoid cycles.
      * @returns The previous node in the traversal or null if no previous node
      *     exists.
      */
@@ -171,20 +108,12 @@ export declare class LineCursor extends Marker {
      * @param node The current position in the AST.
      * @param isValid A function true/false depending on whether the given node
      *     should be traversed.
-     * @param loop Whether to loop around to the end of the workspace if no
-     *     valid node was found.
+     * @param loop Whether to loop around to the end of the workspace if no valid
+     *     node was found.
      * @returns The previous node in the traversal or null if no previous node
      *     exists.
      */
-    getPreviousNode(node: ASTNode | null, isValid: (p1: ASTNode | null) => boolean, loop: boolean): ASTNode | null;
-    /**
-     * From the given node find either the next valid sibling or the parent's
-     * next sibling.
-     *
-     * @param node The current position in the AST.
-     * @returns The next sibling node, the parent's next sibling, or null.
-     */
-    private findSiblingOrParentSibling;
+    getPreviousNode(node: IFocusableNode | null, isValid: (p1: IFocusableNode | null) => boolean, loop: boolean): IFocusableNode | null;
     /**
      * Get the right most child of a node.
      *
@@ -215,7 +144,7 @@ export declare class LineCursor extends Marker {
      *
      * @param deletedBlock The block that is being deleted.
      */
-    preDelete(deletedBlock: Block): void;
+    preDelete(deletedBlock: BlockSvg): void;
     /**
      * Move the cursor to the first valid location in
      * this.potentialNodes, following a block deletion.
@@ -232,18 +161,7 @@ export declare class LineCursor extends Marker {
      *
      * @returns The current field, connection, or block the cursor is on.
      */
-    getCurNode(): ASTNode | null;
-    /**
-     * Sets the object in charge of drawing the marker.
-     *
-     * We want to customize drawing, so rather than directly setting the given
-     * object, we instead set a wrapper proxy object that passes through all
-     * method calls and property accesses except for draw(), which it delegates
-     * to the drawMarker() method in this class.
-     *
-     * @param drawer The object ~in charge of drawing the marker.
-     */
-    setDrawer(drawer: MarkerSvg): void;
+    getCurNode(): IFocusableNode | null;
     /**
      * Set the location of the cursor and draw it.
      *
@@ -251,98 +169,19 @@ export declare class LineCursor extends Marker {
      * this.drawMarker() instead of this.drawer.draw() directly.
      *
      * @param newNode The new location of the cursor.
-     * @param updateSelection If true (the default) we'll update the selection
-     *     too.
-     */
-    setCurNode(newNode: ASTNode | null, updateSelection?: boolean): void;
-    /**
-     * Draw this cursor's marker.
-     *
-     * This is a wrapper around this.drawer.draw (usually implemented by
-     * MarkerSvg.prototype.draw) that will, if newNode is a BLOCK node,
-     * instead call `setSelected` to select it (if it's a regular block)
-     * or `addSelect` (if it's a shadow block, since shadow blocks can't
-     * be selected) instead of using the normal drawer logic.
-     *
-     * TODO(#142): The selection and fake-selection code was originally
-     * a hack added for testing on October 28 2024, because the default
-     * drawer (MarkerSvg) behaviour in Zelos was to draw a box around
-     * the block and all attached child blocks, which was confusing when
-     * navigating stacks.
-     *
-     * Since then we have decided that we probably _do_ in most cases
-     * want navigating to a block to select the block, but more
-     * particularly that we want navigation to move _focus_.  Replace
-     * this selection hack with non-hacky changing of focus once that's
-     * possible.
-     *
-     * @param oldNode The previous node.
-     * @param curNode The current node.
-     * @param realDrawer The object ~in charge of drawing the marker.
-     */
-    private drawMarker;
-    /**
-     * Check whether the node represents a value input connection.
-     *
-     * @param node The node to check
-     * @returns True if the node represents a value input connection.
-     */
-    private isValueInputConnection;
-    /**
-     * Hide the cursor rendering at the given input node.
-     *
-     * @param node The input node to hide.
-     */
-    private hideAtInput;
-    /**
-     * Show the cursor rendering at the given input node.
-     *
-     * @param node The input node to show.
-     */
-    private showAtInput;
-    /**
-     * Event listener that syncs the cursor location to the selected block on
-     * SELECTED events.
-     *
-     * This does not run early enough in all cases so `getCurNode()` also updates
-     * the node from the selection.
-     *
-     * @param event The `Selected` event.
-     */
-    private changeListener;
-    /**
-     * Updates the current node to match the selection.
-     *
-     * Clears the current node if it's on a block but the selection is null.
-     * Sets the node to a block if selected for our workspace.
-     * For shadow blocks selections the parent is used by default (unless we're
-     * already on the shadow block via keyboard) as that's where the visual
-     * selection is.
-     */
-    private updateCurNodeFromSelection;
-    /**
-     * Updates the selection from the node.
-     *
-     * Clears the selection for non-block nodes.
-     * Clears the selection for shadow blocks as the selection is drawn on
-     * the parent but the cursor will be drawn on the shadow block itself.
-     * We need to take care not to later clear the current node due to that null
-     * selection, so we track the latest selection we're in sync with.
-     *
-     * @param newNode The new node.
      */
-    private updateSelectionFromNode;
+    setCurNode(newNode: IFocusableNode | null): void;
     /**
      * Get the first navigable node on the workspace, or null if none exist.
      *
      * @returns The first navigable node on the workspace, or null.
      */
-    getFirstNode(): ASTNode | null;
+    getFirstNode(): IFocusableNode | null;
     /**
      * Get the last navigable node on the workspace, or null if none exist.
      *
      * @returns The last navigable node on the workspace, or null.
      */
-    getLastNode(): ASTNode | null;
+    getLastNode(): IFocusableNode | null;
 }
 //# sourceMappingURL=line_cursor.d.ts.map

package/core/keyboard_nav/marker.d.ts

@@ -9,8 +9,8 @@
  *
  * @class
  */
-import type { MarkerSvg } from '../renderers/common/marker_svg.js';
-import type { ASTNode } from './ast_node.js';
+import { BlockSvg } from '../block_svg.js';
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
 /**
  * Class for a marker.
  * This is used in keyboard navigation to save a location in the Blockly AST.
@@ -19,47 +19,35 @@ export declare class Marker {
     /** The colour of the marker. */
     colour: string | null;
     /** The current location of the marker. */
-    private curNode;
-    /**
-     * The object in charge of drawing the visual representation of the current
-     * node.
-     */
-    private drawer;
+    protected curNode: IFocusableNode | null;
     /** The type of the marker. */
     type: string;
-    /**
-     * Sets the object in charge of drawing the marker.
-     *
-     * @param drawer The object in charge of drawing the marker.
-     */
-    setDrawer(drawer: MarkerSvg): void;
-    /**
-     * Get the current drawer for the marker.
-     *
-     * @returns The object in charge of drawing the marker.
-     */
-    getDrawer(): MarkerSvg | null;
     /**
      * Gets the current location of the marker.
      *
      * @returns The current field, connection, or block the marker is on.
      */
-    getCurNode(): ASTNode | null;
+    getCurNode(): IFocusableNode | null;
     /**
      * Set the location of the marker and call the update method.
      *
      * @param newNode The new location of the marker, or null to remove it.
      */
-    setCurNode(newNode: ASTNode | null): void;
+    setCurNode(newNode: IFocusableNode | null): void;
+    /** Dispose of this marker. */
+    dispose(): void;
     /**
-     * Redraw the current marker.
+     * Returns the block that the given node is a child of.
      *
-     * @internal
+     * @returns The parent block of the node if any, otherwise null.
      */
-    draw(): void;
-    /** Hide the marker SVG. */
-    hide(): void;
-    /** Dispose of this marker. */
-    dispose(): void;
+    getSourceBlockFromNode(node: IFocusableNode | null): BlockSvg | null;
+    /**
+     * Returns the block that this marker's current node is a child of.
+     *
+     * @returns The parent block of the marker's current node if any, otherwise
+     *     null.
+     */
+    getSourceBlock(): BlockSvg | null;
 }
 //# sourceMappingURL=marker.d.ts.map

package/core/keyboard_nav/workspace_navigation_policy.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
+import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+import { WorkspaceSvg } from '../workspace_svg.js';
+/**
+ * Set of rules controlling keyboard navigation from a workspace.
+ */
+export declare class WorkspaceNavigationPolicy implements INavigationPolicy<WorkspaceSvg> {
+    /**
+     * Returns the first child of the given workspace.
+     *
+     * @param current The workspace to return the first child of.
+     * @returns The top block of the first block stack, if any.
+     */
+    getFirstChild(current: WorkspaceSvg): IFocusableNode | null;
+    /**
+     * Returns the parent of the given workspace.
+     *
+     * @param _current The workspace to return the parent of.
+     * @returns Null.
+     */
+    getParent(_current: WorkspaceSvg): IFocusableNode | null;
+    /**
+     * Returns the next sibling of the given workspace.
+     *
+     * @param _current The workspace to return the next sibling of.
+     * @returns Null.
+     */
+    getNextSibling(_current: WorkspaceSvg): IFocusableNode | null;
+    /**
+     * Returns the previous sibling of the given workspace.
+     *
+     * @param _current The workspace to return the previous sibling of.
+     * @returns Null.
+     */
+    getPreviousSibling(_current: WorkspaceSvg): IFocusableNode | null;
+    /**
+     * Returns whether or not the given workspace can be navigated to.
+     *
+     * @param current The instance to check for navigability.
+     * @returns True if the given workspace can be focused.
+     */
+    isNavigable(current: WorkspaceSvg): boolean;
+    /**
+     * Returns whether the given object can be navigated from by this policy.
+     *
+     * @param current The object to check if this policy applies to.
+     * @returns True if the object is a WorkspaceSvg.
+     */
+    isApplicable(current: any): current is WorkspaceSvg;
+}
+//# sourceMappingURL=workspace_navigation_policy.d.ts.map

package/core/layer_manager.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
 import { IRenderedElement } from './interfaces/i_rendered_element.js';
 import { Coordinate } from './utils/coordinate.js';
 import { WorkspaceSvg } from './workspace_svg.js';
@@ -39,13 +40,13 @@ export declare class LayerManager {
      *
      * @internal
      */
-    moveToDragLayer(elem: IRenderedElement): void;
+    moveToDragLayer(elem: IRenderedElement & IFocusableNode): void;
     /**
      * Moves the given element off of the drag layer.
      *
      * @internal
      */
-    moveOffDragLayer(elem: IRenderedElement, layerNum: number): void;
+    moveOffDragLayer(elem: IRenderedElement & IFocusableNode, layerNum: number): void;
     /**
      * Appends the given element to a layer. If the layer does not exist, it is
      * created.

package/core/marker_manager.d.ts

@@ -20,12 +20,8 @@ export declare class MarkerManager {
     static readonly LOCAL_MARKER = "local_marker_1";
     /** The cursor. */
     private cursor;
-    /** The cursor's SVG element. */
-    private cursorSvg;
     /** The map of markers for the workspace. */
     private markers;
-    /** The marker's SVG element. */
-    private markerSvg;
     /**
      * @param workspace The workspace for the marker manager.
      * @internal
@@ -65,28 +61,6 @@ export declare class MarkerManager {
      * @param cursor The cursor used to move around this workspace.
      */
     setCursor(cursor: LineCursor): void;
-    /**
-     * Add the cursor SVG to this workspace SVG group.
-     *
-     * @param cursorSvg The SVG root of the cursor to be added to the workspace
-     *     SVG group.
-     * @internal
-     */
-    setCursorSvg(cursorSvg: SVGElement | null): void;
-    /**
-     * Add the marker SVG to this workspaces SVG group.
-     *
-     * @param markerSvg The SVG root of the marker to be added to the workspace
-     *     SVG group.
-     * @internal
-     */
-    setMarkerSvg(markerSvg: SVGElement | null): void;
-    /**
-     * Redraw the attached cursor SVG if needed.
-     *
-     * @internal
-     */
-    updateMarkers(): void;
     /**
      * Dispose of the marker manager.
      * Go through and delete all markers associated with this marker manager.

package/core/navigator.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
+import type { INavigationPolicy } from './interfaces/i_navigation_policy.js';
+type RuleList<T> = INavigationPolicy<T>[];
+/**
+ * Class responsible for determining where focus should move in response to
+ * keyboard navigation commands.
+ */
+export declare class Navigator {
+    /**
+     * Map from classes to a corresponding ruleset to handle navigation from
+     * instances of that class.
+     */
+    protected rules: RuleList<any>;
+    /**
+     * Adds a navigation ruleset to this Navigator.
+     *
+     * @param policy A ruleset that determines where focus should move starting
+     *     from an instance of its managed class.
+     */
+    addNavigationPolicy(policy: INavigationPolicy<any>): void;
+    /**
+     * Returns the navigation ruleset associated with the given object instance's
+     * class.
+     *
+     * @param current An object to retrieve a navigation ruleset for.
+     * @returns The navigation ruleset of objects of the given object's class, or
+     *     undefined if no ruleset has been registered for the object's class.
+     */
+    private get;
+    /**
+     * Returns the first child of the given object instance, if any.
+     *
+     * @param current The object to retrieve the first child of.
+     * @returns The first child node of the given object, if any.
+     */
+    getFirstChild(current: IFocusableNode): IFocusableNode | null;
+    /**
+     * Returns the parent of the given object instance, if any.
+     *
+     * @param current The object to retrieve the parent of.
+     * @returns The parent node of the given object, if any.
+     */
+    getParent(current: IFocusableNode): IFocusableNode | null;
+    /**
+     * Returns the next sibling of the given object instance, if any.
+     *
+     * @param current The object to retrieve the next sibling node of.
+     * @returns The next sibling node of the given object, if any.
+     */
+    getNextSibling(current: IFocusableNode): IFocusableNode | null;
+    /**
+     * Returns the previous sibling of the given object instance, if any.
+     *
+     * @param current The object to retrieve the previous sibling node of.
+     * @returns The previous sibling node of the given object, if any.
+     */
+    getPreviousSibling(current: IFocusableNode): IFocusableNode | null;
+}
+export {};
+//# sourceMappingURL=navigator.d.ts.map

package/core/rendered_connection.d.ts

@@ -11,11 +11,14 @@
 import type { Block } from './block.js';
 import type { BlockSvg } from './block_svg.js';
 import { Connection } from './connection.js';
+import { IContextMenu } from './interfaces/i_contextmenu.js';
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
+import type { IFocusableTree } from './interfaces/i_focusable_tree.js';
 import { Coordinate } from './utils/coordinate.js';
 /**
  * Class for a connection between blocks that may be rendered on screen.
  */
-export declare class RenderedConnection extends Connection {
+export declare class RenderedConnection extends Connection implements IContextMenu, IFocusableNode {
     sourceBlock_: BlockSvg;
     private readonly db;
     private readonly dbOpposite;
@@ -216,6 +219,26 @@ export declare class RenderedConnection extends Connection {
      * @returns The connection being modified (to allow chaining).
      */
     setCheck(check: string | string[] | null): RenderedConnection;
+    /**
+     * Handles showing the context menu when it is opened on a connection.
+     * Note that typically the context menu can't be opened with the mouse
+     * on a connection, because you can't select a connection. But keyboard
+     * users may open the context menu with a keyboard shortcut.
+     *
+     * @param e Event that triggered the opening of the context menu.
+     */
+    showContextMenu(e: Event): void;
+    /** See IFocusableNode.getFocusableElement. */
+    getFocusableElement(): HTMLElement | SVGElement;
+    /** See IFocusableNode.getFocusableTree. */
+    getFocusableTree(): IFocusableTree;
+    /** See IFocusableNode.onNodeFocus. */
+    onNodeFocus(): void;
+    /** See IFocusableNode.onNodeBlur. */
+    onNodeBlur(): void;
+    /** See IFocusableNode.canBeFocused. */
+    canBeFocused(): boolean;
+    private findHighlightSvg;
 }
 export declare namespace RenderedConnection {
     /**

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

@@ -29,7 +29,6 @@ import { Types } from '../measurables/types.js';
 import { Drawer } from './drawer.js';
 import type { IPathObject } from './i_path_object.js';
 import { RenderInfo } from './info.js';
-import { MarkerSvg } from './marker_svg.js';
 import { PathObject } from './path_object.js';
 import { Renderer } from './renderer.js';
 /**
@@ -59,6 +58,6 @@ export declare function unregister(name: string): void;
 export declare function init(name: string, theme: Theme, opt_rendererOverrides?: {
     [rendererConstant: string]: any;
 }): Renderer;
-export { BottomRow, Connection, Drawer, ExternalValueInput, Field, Hat, Icon, InlineInput, InputConnection, InputRow, InRowSpacer, IPathObject, JaggedEdge, MarkerSvg, Measurable, NextConnection, OutputConnection, PathObject, PreviousConnection, Renderer, RenderInfo, RoundCorner, Row, SpacerRow, SquareCorner, StatementInput, TopRow, Types, };
+export { BottomRow, Connection, Drawer, ExternalValueInput, Field, Hat, Icon, InlineInput, InputConnection, InputRow, InRowSpacer, IPathObject, JaggedEdge, Measurable, NextConnection, OutputConnection, PathObject, PreviousConnection, Renderer, RenderInfo, RoundCorner, Row, SpacerRow, SquareCorner, StatementInput, TopRow, Types, };
 export { BaseShape, ConstantProvider, DynamicShape, InsideCorners, JaggedTeeth, Notch, OutsideCorners, PuzzleTab, StartHat, } from './constants.js';
 //# sourceMappingURL=block_rendering.d.ts.map

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

@@ -141,7 +141,7 @@ export declare class Drawer {
      */
     protected updateConnectionHighlights(): void;
     /** Returns a path to highlight the given connection. */
-    drawConnectionHighlightPath(measurable: Connection): void;
+    drawConnectionHighlightPath(measurable: Connection): SVGElement | undefined;
     /**
      * Returns a path to highlight the given conneciton, assuming it is an
      * input or output connection.