blockly 12.5.1 → 13.0.0-beta.0

package/core/flyout_navigator.d.ts

@@ -1,11 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { IFlyout } from './interfaces/i_flyout.js';
-import { Navigator } from './navigator.js';
-export declare class FlyoutNavigator extends Navigator {
-    constructor(flyout: IFlyout);
-}
-//# sourceMappingURL=flyout_navigator.d.ts.map

package/core/keyboard_nav/flyout_navigation_policy.d.ts

@@ -1,65 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { IFlyout } from '../interfaces/i_flyout.js';
-import type { IFocusableNode } from '../interfaces/i_focusable_node.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): IFocusableNode | 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): IFocusableNode | 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): IFocusableNode | 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): IFocusableNode | null;
-    /**
-     * Returns whether or not the given flyout item can be navigated to.
-     *
-     * @param current The instance to check for navigability.
-     * @returns True if the given flyout item can be focused.
-     */
-    isNavigable(current: T): 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 BlockSvg.
-     */
-    isApplicable(current: any): current is T;
-}
-//# sourceMappingURL=flyout_navigation_policy.d.ts.map

package/core/keyboard_nav/line_cursor.d.ts

@@ -1,187 +0,0 @@
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * @fileoverview The class representing a line cursor.
- * A line cursor tries to traverse the blocks and connections on a block as if
- * they were lines of code in a text editor. Previous and next traverse previous
- * connections, next connections and blocks, while in and out traverse input
- * connections and fields.
- * @author aschmiedt@google.com (Abby Schmiedt)
- */
-import { BlockSvg } from '../block_svg.js';
-import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
-import type { WorkspaceSvg } from '../workspace_svg.js';
-import { Marker } from './marker.js';
-/**
- * Class for a line cursor.
- */
-export declare class LineCursor extends Marker {
-    protected readonly workspace: WorkspaceSvg;
-    type: string;
-    /** Locations to try moving the cursor to after a deletion. */
-    private potentialNodes;
-    /**
-     * @param workspace The workspace this cursor belongs to.
-     */
-    constructor(workspace: WorkspaceSvg);
-    /**
-     * Moves the cursor to the next block or workspace comment in the pre-order
-     * traversal.
-     *
-     * @returns The next node, or null if the current node is not set or there is
-     *     no next value.
-     */
-    next(): IFocusableNode | null;
-    /**
-     * Moves the cursor to the next input connection or field
-     * in the pre order traversal.
-     *
-     * @returns The next node, or null if the current node is
-     *     not set or there is no next value.
-     */
-    in(): IFocusableNode | null;
-    /**
-     * Moves the cursor to the previous block or workspace comment in the
-     * pre-order traversal.
-     *
-     * @returns The previous node, or null if the current node is not set or there
-     *     is no previous value.
-     */
-    prev(): IFocusableNode | null;
-    /**
-     * Moves the cursor to the previous input connection or field in the pre order
-     * traversal.
-     *
-     * @returns The previous node, or null if the current node
-     *     is not set or there is no previous value.
-     */
-    out(): IFocusableNode | null;
-    /**
-     * Returns true iff the node to which we would navigate if in() were
-     * 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;
-    /**
-     * 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
-     * and out levels on the tree.
-     *
-     * @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;
-    /**
-     * 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: 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
-     * to go in and out levels on the tree.
-     *
-     * @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: IFocusableNode | null, isValid: (p1: IFocusableNode | null) => boolean, loop: boolean): IFocusableNode | null;
-    /**
-     * Get the right most child of a node.
-     *
-     * @param node The node to find the right most child of.
-     * @returns The right most child of the given node, or the node if no child
-     *     exists.
-     */
-    private getRightMostChild;
-    /**
-     * Prepare for the deletion of a block by making a list of nodes we
-     * could move the cursor to afterwards and save it to
-     * this.potentialNodes.
-     *
-     * After the deletion has occurred, call postDelete to move it to
-     * the first valid node on that list.
-     *
-     * The locations to try (in order of preference) are:
-     *
-     * - The current location.
-     * - The connection to which the deleted block is attached.
-     * - The block connected to the next connection of the deleted block.
-     * - The parent block of the deleted block.
-     * - A location on the workspace beneath the deleted block.
-     *
-     * N.B.: When block is deleted, all of the blocks conneccted to that
-     * block's inputs are also deleted, but not blocks connected to its
-     * next connection.
-     *
-     * @param deletedBlock The block that is being deleted.
-     */
-    preDelete(deletedBlock: BlockSvg): void;
-    /**
-     * Move the cursor to the first valid location in
-     * this.potentialNodes, following a block deletion.
-     */
-    postDelete(): void;
-    /**
-     * Get the current location of the cursor.
-     *
-     * Overrides normal Marker getCurNode to update the current node from the
-     * selected block. This typically happens via the selection listener but that
-     * is not called immediately when `Gesture` calls
-     * `Blockly.common.setSelected`. In particular the listener runs after showing
-     * the context menu.
-     *
-     * @returns The current field, connection, or block the cursor is on.
-     */
-    getCurNode(): IFocusableNode | null;
-    /**
-     * Set the location of the cursor and draw it.
-     *
-     * Overrides normal Marker setCurNode logic to call
-     * this.drawMarker() instead of this.drawer.draw() directly.
-     *
-     * @param newNode The new location of the cursor.
-     */
-    setCurNode(newNode: IFocusableNode): 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(): 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(): IFocusableNode | null;
-}
-//# sourceMappingURL=line_cursor.d.ts.map

package/core/keyboard_nav/marker.d.ts

@@ -1,53 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * The class representing a marker.
- * Used primarily for keyboard navigation to show a marked location.
- *
- * @class
- */
-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.
- */
-export declare class Marker {
-    /** The colour of the marker. */
-    colour: string | null;
-    /** The current location of the marker. */
-    protected curNode: IFocusableNode | null;
-    /** The type of the marker. */
-    type: string;
-    /**
-     * Gets the current location of the marker.
-     *
-     * @returns The current field, connection, or block the marker is on.
-     */
-    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: IFocusableNode | null): void;
-    /** Dispose of this marker. */
-    dispose(): void;
-    /**
-     * Returns the block that the given node is a child of.
-     *
-     * @returns The parent block of the node if any, otherwise null.
-     */
-    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/marker_manager.d.ts

@@ -1,72 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Object in charge of managing markers and the cursor.
- *
- * @class
- */
-import { LineCursor } from './keyboard_nav/line_cursor.js';
-import type { Marker } from './keyboard_nav/marker.js';
-import type { WorkspaceSvg } from './workspace_svg.js';
-/**
- * Class to manage the multiple markers and the cursor on a workspace.
- */
-export declare class MarkerManager {
-    private readonly workspace;
-    /** The name of the local marker. */
-    static readonly LOCAL_MARKER = "local_marker_1";
-    /** The cursor. */
-    private cursor;
-    /** The map of markers for the workspace. */
-    private markers;
-    /**
-     * @param workspace The workspace for the marker manager.
-     * @internal
-     */
-    constructor(workspace: WorkspaceSvg);
-    /**
-     * Register the marker by adding it to the map of markers.
-     *
-     * @param id A unique identifier for the marker.
-     * @param marker The marker to register.
-     */
-    registerMarker(id: string, marker: Marker): void;
-    /**
-     * Unregister the marker by removing it from the map of markers.
-     *
-     * @param id The ID of the marker to unregister.
-     */
-    unregisterMarker(id: string): void;
-    /**
-     * Get the cursor for the workspace.
-     *
-     * @returns The cursor for this workspace.
-     */
-    getCursor(): LineCursor;
-    /**
-     * Get a single marker that corresponds to the given ID.
-     *
-     * @param id A unique identifier for the marker.
-     * @returns The marker that corresponds to the given ID, or null if none
-     *     exists.
-     */
-    getMarker(id: string): Marker | null;
-    /**
-     * Sets the cursor and initializes the drawer for use with keyboard
-     * navigation.
-     *
-     * @param cursor The cursor used to move around this workspace.
-     */
-    setCursor(cursor: LineCursor): void;
-    /**
-     * Dispose of the marker manager.
-     * Go through and delete all markers associated with this marker manager.
-     *
-     * @internal
-     */
-    dispose(): void;
-}
-//# sourceMappingURL=marker_manager.d.ts.map

package/core/navigator.d.ts

@@ -1,65 +0,0 @@
-/**
- * @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