blockly 12.0.0-beta.3 → 12.0.0-beta.5

package/core/keyboard_nav/ast_node.d.ts

@@ -80,89 +80,7 @@ export declare class ASTNode {
      * @internal
      */
     isConnection(): boolean;
-    /**
-     * Given an input find the next editable field or an input with a non null
-     * connection in the same block. The current location must be an input
-     * connection.
-     *
-     * @returns The AST node holding the next field or connection or null if there
-     *     is no editable field or input connection after the given input.
-     */
-    private findNextForInput;
-    /**
-     * Given a field find the next editable field or an input with a non null
-     * connection in the same block. The current location must be a field.
-     *
-     * @returns The AST node pointing to the next field or connection or null if
-     *     there is no editable field or input connection after the given input.
-     */
-    private findNextForField;
-    /**
-     * Given an input find the previous editable field or an input with a non null
-     * connection in the same block. The current location must be an input
-     * connection.
-     *
-     * @returns The AST node holding the previous field or connection.
-     */
-    private findPrevForInput;
-    /**
-     * Given a field find the previous editable field or an input with a non null
-     * connection in the same block. The current location must be a field.
-     *
-     * @returns The AST node holding the previous input or field.
-     */
-    private findPrevForField;
-    /**
-     * Navigate between stacks of blocks on the workspace.
-     *
-     * @param forward True to go forward. False to go backwards.
-     * @returns The first block of the next stack or null if there are no blocks
-     *     on the workspace.
-     */
-    private navigateBetweenStacks;
-    /**
-     * Navigate between buttons and stacks of blocks on the flyout workspace.
-     *
-     * @param forward True to go forward. False to go backwards.
-     * @returns The next button, or next stack's first block, or null
-     */
-    private navigateFlyoutContents;
-    /**
-     * Finds the next (or previous if navigating backward) item in the flyout that should be navigated to.
-     *
-     * @param flyoutContents Contents of the current flyout.
-     * @param currentLocation Current ASTNode location.
-     * @param forward True if we're navigating forward, else false.
-     * @returns The next (or previous) FlyoutItem, or null if there is none.
-     */
-    private findNextLocationInFlyout;
-    /**
-     * Finds the top most AST node for a given block.
-     * This is either the previous connection, output connection or block
-     * depending on what kind of connections the block has.
-     *
-     * @param block The block that we want to find the top connection on.
-     * @returns The AST node containing the top connection.
-     */
-    private findTopASTNodeForBlock;
-    /**
-     * Get the AST node pointing to the input that the block is nested under or if
-     * the block is not nested then get the stack AST node.
-     *
-     * @param block The source block of the current location.
-     * @returns The AST node pointing to the input connection or the top block of
-     *     the stack this block is in.
-     */
-    private getOutAstNodeForBlock;
-    /**
-     * Find the first editable field or input with a connection on a given block.
-     *
-     * @param block The source block of the current location.
-     * @returns An AST node pointing to the first field or input.
-     * Null if there are no editable fields or inputs with connections on the
-     * block.
-     */
-    private findFirstFieldOrInput;
+    private getVisibleInputs;
     /**
      * Finds the source block of the location of this node.
      *
@@ -170,36 +88,6 @@ export declare class ASTNode {
      *     workspace or button.
      */
     getSourceBlock(): Block | null;
-    /**
-     * Find the element to the right of the current element in the AST.
-     *
-     * @returns An AST node that wraps the next field, connection, block, or
-     *     workspace. Or null if there is no node to the right.
-     */
-    next(): ASTNode | null;
-    /**
-     * Find the element one level below and all the way to the left of the current
-     * location.
-     *
-     * @returns An AST node that wraps the next field, connection, workspace, or
-     *     block. Or null if there is nothing below this node.
-     */
-    in(): ASTNode | null;
-    /**
-     * Find the element to the left of the current element in the AST.
-     *
-     * @returns An AST node that wraps the previous field, connection, workspace
-     *     or block. Or null if no node exists to the left. null.
-     */
-    prev(): ASTNode | null;
-    /**
-     * Find the next element that is one position above and all the way to the
-     * left of the current location.
-     *
-     * @returns An AST node that wraps the next field, connection, workspace or
-     *     block. Or null if we are at the workspace level.
-     */
-    out(): ASTNode | null;
     /**
      * Whether an AST node of the given type points to a connection.
      *

package/core/keyboard_nav/block_navigation_policy.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from '../block_svg.js';
+import type { INavigable } from '../interfaces/i_navigable.js';
+import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+import type { RenderedConnection } from '../rendered_connection.js';
+/**
+ * Set of rules controlling keyboard navigation from a block.
+ */
+export declare class BlockNavigationPolicy implements INavigationPolicy<BlockSvg> {
+    /**
+     * Returns the first child of the given block.
+     *
+     * @param current The block to return the first child of.
+     * @returns The first field or input of the given block, if any.
+     */
+    getFirstChild(current: BlockSvg): INavigable<unknown> | null;
+    /**
+     * Returns the parent of the given block.
+     *
+     * @param current The block to return the parent of.
+     * @returns The top block of the given block's stack, or the connection to
+     *     which it is attached.
+     */
+    getParent(current: BlockSvg): INavigable<unknown> | null;
+    /**
+     * Returns the next peer node of the given block.
+     *
+     * @param current The block to find the following element of.
+     * @returns The first block of the next stack if the given block is a terminal
+     *     block, or its next connection.
+     */
+    getNextSibling(current: BlockSvg): INavigable<unknown> | null;
+    /**
+     * Returns the previous peer node of the given block.
+     *
+     * @param current The block to find the preceding element of.
+     * @returns The block's previous/output connection, or the last
+     *     connection/block of the previous block stack if it is a root block.
+     */
+    getPreviousSibling(current: BlockSvg): INavigable<unknown> | null;
+    /**
+     * Gets the parent connection on a block.
+     * This is either an output connection, previous connection or undefined.
+     * If both connections exist return the one that is actually connected
+     * to another block.
+     *
+     * @param block The block to find the parent connection on.
+     * @returns The connection connecting to the parent of the block.
+     */
+    protected getParentConnection(block: BlockSvg): RenderedConnection;
+}
+//# sourceMappingURL=block_navigation_policy.d.ts.map

package/core/keyboard_nav/connection_navigation_policy.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from '../block_svg.js';
+import type { INavigable } from '../interfaces/i_navigable.js';
+import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+import type { RenderedConnection } from '../rendered_connection.js';
+/**
+ * Set of rules controlling keyboard navigation from a connection.
+ */
+export declare class ConnectionNavigationPolicy implements INavigationPolicy<RenderedConnection> {
+    /**
+     * Returns the first child of the given connection.
+     *
+     * @param current The connection to return the first child of.
+     * @returns The connection's first child element, or null if not none.
+     */
+    getFirstChild(current: RenderedConnection): INavigable<unknown> | null;
+    /**
+     * Returns the parent of the given connection.
+     *
+     * @param current The connection to return the parent of.
+     * @returns The given connection's parent connection or block.
+     */
+    getParent(current: RenderedConnection): INavigable<unknown> | null;
+    /**
+     * Returns the next element following the given connection.
+     *
+     * @param current The connection to navigate from.
+     * @returns The field, input connection or block following this connection.
+     */
+    getNextSibling(current: RenderedConnection): INavigable<unknown> | null;
+    /**
+     * Returns the element preceding the given connection.
+     *
+     * @param current The connection to navigate from.
+     * @returns The field, input connection or block preceding this connection.
+     */
+    getPreviousSibling(current: RenderedConnection): INavigable<unknown> | null;
+    /**
+     * Gets the parent connection on a block.
+     * This is either an output connection, previous connection or undefined.
+     * If both connections exist return the one that is actually connected
+     * to another block.
+     *
+     * @param block The block to find the parent connection on.
+     * @returns The connection connecting to the parent of the block.
+     */
+    protected getParentConnection(block: BlockSvg): RenderedConnection;
+}
+//# sourceMappingURL=connection_navigation_policy.d.ts.map

package/core/keyboard_nav/field_navigation_policy.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Field } from '../field.js';
+import type { INavigable } from '../interfaces/i_navigable.js';
+import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+/**
+ * Set of rules controlling keyboard navigation from a field.
+ */
+export declare class FieldNavigationPolicy implements INavigationPolicy<Field<any>> {
+    /**
+     * Returns null since fields do not have children.
+     *
+     * @param _current The field to navigate from.
+     * @returns Null.
+     */
+    getFirstChild(_current: Field<any>): INavigable<unknown> | null;
+    /**
+     * Returns the parent block of the given field.
+     *
+     * @param current The field to navigate from.
+     * @returns The given field's parent block.
+     */
+    getParent(current: Field<any>): INavigable<unknown> | null;
+    /**
+     * Returns the next field or input following the given field.
+     *
+     * @param current The field to navigate from.
+     * @returns The next field or input in the given field's block.
+     */
+    getNextSibling(current: Field<any>): INavigable<unknown> | null;
+    /**
+     * Returns the field or input preceding the given field.
+     *
+     * @param current The field to navigate from.
+     * @returns The preceding field or input in the given field's block.
+     */
+    getPreviousSibling(current: Field<any>): INavigable<unknown> | null;
+}
+//# sourceMappingURL=field_navigation_policy.d.ts.map

package/core/keyboard_nav/flyout_button_navigation_policy.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FlyoutButton } from '../flyout_button.js';
+import type { INavigable } from '../interfaces/i_navigable.js';
+import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+/**
+ * Set of rules controlling keyboard navigation from a flyout button.
+ */
+export declare class FlyoutButtonNavigationPolicy implements INavigationPolicy<FlyoutButton> {
+    /**
+     * Returns null since flyout buttons have no children.
+     *
+     * @param _current The FlyoutButton instance to navigate from.
+     * @returns Null.
+     */
+    getFirstChild(_current: FlyoutButton): INavigable<unknown> | null;
+    /**
+     * Returns the parent workspace of the given flyout button.
+     *
+     * @param current The FlyoutButton instance to navigate from.
+     * @returns The given flyout button's parent workspace.
+     */
+    getParent(current: FlyoutButton): INavigable<unknown> | null;
+    /**
+     * Returns null since inter-item navigation is done by FlyoutNavigationPolicy.
+     *
+     * @param _current The FlyoutButton instance to navigate from.
+     * @returns Null.
+     */
+    getNextSibling(_current: FlyoutButton): INavigable<unknown> | null;
+    /**
+     * Returns null since inter-item navigation is done by FlyoutNavigationPolicy.
+     *
+     * @param _current The FlyoutButton instance to navigate from.
+     * @returns Null.
+     */
+    getPreviousSibling(_current: FlyoutButton): INavigable<unknown> | null;
+}
+//# sourceMappingURL=flyout_button_navigation_policy.d.ts.map

package/core/keyboard_nav/flyout_navigation_policy.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IFlyout } from '../interfaces/i_flyout.js';
+import type { INavigable } from '../interfaces/i_navigable.js';
+import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+/**
+ * Generic navigation policy that navigates between items in the flyout.
+ */
+export declare class FlyoutNavigationPolicy<T> implements INavigationPolicy<T> {
+    private policy;
+    private flyout;
+    /**
+     * Creates a new FlyoutNavigationPolicy instance.
+     *
+     * @param policy The policy to defer to for parents/children.
+     * @param flyout The flyout this policy will control navigation in.
+     */
+    constructor(policy: INavigationPolicy<T>, flyout: IFlyout);
+    /**
+     * Returns null to prevent navigating into flyout items.
+     *
+     * @param _current The flyout item to navigate from.
+     * @returns Null to prevent navigating into flyout items.
+     */
+    getFirstChild(_current: T): INavigable<unknown> | null;
+    /**
+     * Returns the parent of the given flyout item.
+     *
+     * @param current The flyout item to navigate from.
+     * @returns The parent of the given flyout item.
+     */
+    getParent(current: T): INavigable<unknown> | null;
+    /**
+     * Returns the next item in the flyout relative to the given item.
+     *
+     * @param current The flyout item to navigate from.
+     * @returns The flyout item following the given one.
+     */
+    getNextSibling(current: T): INavigable<unknown> | null;
+    /**
+     * Returns the previous item in the flyout relative to the given item.
+     *
+     * @param current The flyout item to navigate from.
+     * @returns The flyout item preceding the given one.
+     */
+    getPreviousSibling(current: T): INavigable<unknown> | null;
+}
+//# sourceMappingURL=flyout_navigation_policy.d.ts.map

package/core/keyboard_nav/flyout_separator_navigation_policy.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FlyoutSeparator } from '../flyout_separator.js';
+import type { INavigable } from '../interfaces/i_navigable.js';
+import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+/**
+ * Set of rules controlling keyboard navigation from a flyout separator.
+ * This is a no-op placeholder, since flyout separators can't be navigated to.
+ */
+export declare class FlyoutSeparatorNavigationPolicy implements INavigationPolicy<FlyoutSeparator> {
+    getFirstChild(_current: FlyoutSeparator): INavigable<unknown> | null;
+    getParent(_current: FlyoutSeparator): INavigable<unknown> | null;
+    getNextSibling(_current: FlyoutSeparator): INavigable<unknown> | null;
+    getPreviousSibling(_current: FlyoutSeparator): INavigable<unknown> | null;
+}
+//# sourceMappingURL=flyout_separator_navigation_policy.d.ts.map

package/core/keyboard_nav/line_cursor.d.ts

@@ -11,10 +11,9 @@
  * 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 { INavigable } from '../interfaces/i_navigable.js';
+import { WorkspaceSvg } from '../workspace_svg.js';
 import { Marker } from './marker.js';
 /** Options object for LineCursor instances. */
 export interface CursorOptions {
@@ -28,7 +27,7 @@ export interface CursorOptions {
  * 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;
@@ -42,9 +41,10 @@ export declare class LineCursor extends Marker {
      */
     constructor(workspace: WorkspaceSvg, options?: Partial<CursorOptions>);
     /**
-     * Clean up this cursor.
+     * Registers default navigation policies for Blockly's built-in types with
+     * this cursor's workspace.
      */
-    dispose(): void;
+    protected registerNavigationPolicies(): void;
     /**
      * 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 +52,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(): INavigable<any> | null;
     /**
      * Moves the cursor to the next input connection or field
      * in the pre order traversal.
@@ -60,7 +60,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(): INavigable<any> | null;
     /**
      * Moves the cursor to the previous next connection or previous connection in
      * the pre order traversal.
@@ -68,7 +68,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(): INavigable<any> | null;
     /**
      * Moves the cursor to the previous input connection or field in the pre order
      * traversal.
@@ -76,7 +76,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.
      */
-    out(): ASTNode | null;
+    out(): INavigable<any> | null;
     /**
      * Returns true iff the node to which we would navigate if in() were
      * called, which will be a validInLineNode, is also a validLineNode
@@ -107,11 +107,11 @@ export declare class LineCursor extends Marker {
      * @param node The AST node to check.
      * @returns True if the node should be visited, false otherwise.
      */
-    protected validLineNode(node: ASTNode | null): boolean;
+    protected validLineNode(node: INavigable<any> | 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 node for which validLineNode would return true, plus:
      *
      * - Any block.
      * - Any field that is not a full block field.
@@ -121,7 +121,7 @@ export declare class LineCursor extends Marker {
      * @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;
+    protected validInLineNode(node: INavigable<any> | null): boolean;
     /**
      * Returns true iff the given node can be visited by the cursor.
      * Specifically, if the node is any for which validInLineNode would
@@ -130,7 +130,7 @@ export declare class LineCursor extends Marker {
      * @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;
+    protected validNode(node: INavigable<any> | 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,9 +139,21 @@ 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.
      */
-    getNextNode(node: ASTNode | null, isValid: (p1: ASTNode | null) => boolean): ASTNode | null;
+    private getNextNodeImpl;
+    /**
+     * Get the next node in the AST, optionally allowing for loopback.
+     *
+     * @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 no
+     *     valid node was found.
+     * @returns The next node in the traversal.
+     */
+    getNextNode(node: INavigable<any> | null, isValid: (p1: INavigable<any> | null) => boolean, loop: boolean): INavigable<any> | 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
@@ -150,10 +162,23 @@ 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.
+     */
+    private getPreviousNodeImpl;
+    /**
+     * Get the previous node in the AST, optionally allowing for loopback.
+     *
+     * @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.
      * @returns The previous node in the traversal or null if no previous node
      *     exists.
      */
-    getPreviousNode(node: ASTNode | null, isValid: (p1: ASTNode | null) => boolean): ASTNode | null;
+    getPreviousNode(node: INavigable<any> | null, isValid: (p1: INavigable<any> | null) => boolean, loop: boolean): INavigable<any> | null;
     /**
      * From the given node find either the next valid sibling or the parent's
      * next sibling.
@@ -192,7 +217,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.
@@ -209,18 +234,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(): INavigable<any> | null;
     /**
      * Set the location of the cursor and draw it.
      *
@@ -228,65 +242,8 @@ 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;
+    setCurNode(newNode: INavigable<any> | null): void;
     /**
      * Updates the current node to match the selection.
      *
@@ -298,16 +255,23 @@ export declare class LineCursor extends Marker {
      */
     private updateCurNodeFromSelection;
     /**
-     * Updates the selection from the node.
+     * Updates the current node to match what's currently focused.
      *
-     * 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.
+     * @returns Whether the current node has been set successfully from the
+     *     current focused node.
+     */
+    private updateCurNodeFromFocus;
+    /**
+     * Get the first navigable node on the workspace, or null if none exist.
+     *
+     * @returns The first navigable node on the workspace, or null.
+     */
+    getFirstNode(): INavigable<any> | null;
+    /**
+     * Get the last navigable node on the workspace, or null if none exist.
      *
-     * @param newNode The new node.
+     * @returns The last navigable node on the workspace, or null.
      */
-    private updateSelectionFromNode;
+    getLastNode(): INavigable<any> | null;
 }
 //# sourceMappingURL=line_cursor.d.ts.map