blockly 12.0.0-beta.1 → 12.0.0-beta.3

package/core/menuitem.d.ts

@@ -95,6 +95,13 @@ 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/registry.d.ts

@@ -19,7 +19,7 @@ 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 { LineCursor } from './keyboard_nav/line_cursor.js';
 import type { Options } from './options.js';
 import type { Renderer } from './renderers/common/renderer.js';
 import type { Theme } from './theme.js';
@@ -50,7 +50,7 @@ export declare class Type<_T> {
     toString(): string;
     static CONNECTION_CHECKER: Type<IConnectionChecker>;
     static CONNECTION_PREVIEWER: Type<IConnectionPreviewer>;
-    static CURSOR: Type<Cursor>;
+    static CURSOR: Type<LineCursor>;
     static EVENT: Type<Abstract>;
     static FIELD: Type<Field<any>>;
     static INPUT: Type<Input>;

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

@@ -78,7 +78,7 @@ export declare class MarkerSvg {
      * @param oldNode The previous node the marker was on or null.
      * @param curNode The node that we want to draw the marker for.
      */
-    draw(oldNode: ASTNode, curNode: ASTNode): void;
+    draw(oldNode: ASTNode | null, curNode: ASTNode | null): void;
     /**
      * Update the marker's visible state based on the type of curNode..
      *
@@ -229,7 +229,7 @@ export declare class MarkerSvg {
      * @param oldNode The old node the marker used to be on.
      * @param curNode The new node the marker is currently on.
      */
-    protected fireMarkerEvent(oldNode: ASTNode, curNode: ASTNode): void;
+    protected fireMarkerEvent(oldNode: ASTNode | null, curNode: ASTNode): void;
     /**
      * Get the properties to make a marker blink.
      *

package/core/renderers/zelos/path_object.d.ts

@@ -61,10 +61,11 @@ export declare class PathObject extends BasePathObject {
     /**
      * Create's an outline path for the specified input.
      *
+     * @internal
      * @param name The input name.
      * @returns The SVG outline path.
      */
-    private getOutlinePath;
+    getOutlinePath(name: string): SVGElement;
     /**
      * Remove an outline path that is associated with the specified input.
      *

package/core/separator_flyout_inflater.d.ts

@@ -4,8 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { FlyoutItem } from './flyout_item.js';
+import type { IFlyout } from './interfaces/i_flyout.js';
 import type { IFlyoutInflater } from './interfaces/i_flyout_inflater.js';
-import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * @internal
  */
@@ -29,10 +29,10 @@ export declare class SeparatorFlyoutInflater implements IFlyoutInflater {
      * returned by gapForElement, which knows the default gap, unlike this method.
      *
      * @param _state A JSON representation of a flyout separator.
-     * @param flyoutWorkspace The workspace the separator belongs to.
+     * @param flyout The flyout to create the separator for.
      * @returns A newly created FlyoutSeparator.
      */
-    load(_state: object, flyoutWorkspace: WorkspaceSvg): FlyoutItem;
+    load(_state: object, flyout: IFlyout): FlyoutItem;
     /**
      * Returns the size of the separator. See `load` for more details.
      *

package/core/utils/aria.d.ts

@@ -19,7 +19,8 @@ export declare enum Role {
     PRESENTATION = "presentation",
     ROW = "row",
     TREE = "tree",
-    TREEITEM = "treeitem"
+    TREEITEM = "treeitem",
+    SEPARATOR = "separator"
 }
 /**
  * ARIA states and properties.

package/core/utils/focusable_tree_traverser.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
+import type { IFocusableTree } from '../interfaces/i_focusable_tree.js';
+/**
+ * A helper utility for IFocusableTree implementations to aid with common
+ * tree traversals.
+ */
+export declare class FocusableTreeTraverser {
+    private static readonly ACTIVE_CLASS_NAME;
+    private static readonly PASSIVE_CSS_CLASS_NAME;
+    private static readonly ACTIVE_FOCUS_NODE_CSS_SELECTOR;
+    private static readonly PASSIVE_FOCUS_NODE_CSS_SELECTOR;
+    /**
+     * Returns the current IFocusableNode that is styled (and thus represented) as
+     * having either passive or active focus, only considering HTML and SVG
+     * elements.
+     *
+     * This can match against the tree's root.
+     *
+     * Note that this will never return a node from a nested sub-tree as that tree
+     * should specifically be used to retrieve its focused node.
+     *
+     * @param tree The IFocusableTree in which to search for a focused node.
+     * @returns The IFocusableNode currently with focus, or null if none.
+     */
+    static findFocusedNode(tree: IFocusableTree): IFocusableNode | null;
+    /**
+     * Returns the IFocusableNode corresponding to the specified HTML or SVG
+     * element iff it's the root element or a descendent of the root element of
+     * the specified IFocusableTree.
+     *
+     * If the element exists within the specified tree's DOM structure but does
+     * not directly correspond to a node, the nearest parent node (or the tree's
+     * root) will be returned to represent the provided element.
+     *
+     * If the tree contains another nested IFocusableTree, the nested tree may be
+     * traversed but its nodes will never be returned here per the contract of
+     * IFocusableTree.lookUpFocusableNode.
+     *
+     * The provided element must have a non-null ID that conforms to the contract
+     * mentioned in IFocusableNode.
+     *
+     * @param element The HTML or SVG element being sought.
+     * @param tree The tree under which the provided element may be a descendant.
+     * @returns The matching IFocusableNode, or null if there is no match.
+     */
+    static findFocusableNodeFor(element: HTMLElement | SVGElement, tree: IFocusableTree): IFocusableNode | null;
+}
+//# sourceMappingURL=focusable_tree_traverser.d.ts.map

package/core/utils/toolbox.d.ts

@@ -19,8 +19,6 @@ export interface BlockInfo {
     disabledReasons?: string[];
     enabled?: boolean;
     id?: string;
-    x?: number;
-    y?: number;
     collapsed?: boolean;
     inline?: boolean;
     data?: string;

package/core/workspace.d.ts

@@ -82,6 +82,7 @@ export declare class Workspace implements IASTNodeLocation {
     private readonly typedBlocksDB;
     private variableMap;
     private procedureMap;
+    private readOnly;
     /**
      * Blocks in the flyout can refer to variables that don't exist in the main
      * workspace.  For instance, the "get item in list" block refers to an
@@ -410,7 +411,6 @@ export declare class Workspace implements IASTNodeLocation {
      * These exist in the flyout but not in the workspace.
      *
      * @returns The potential variable map.
-     * @internal
      */
     getPotentialVariableMap(): IVariableMap<IVariableModel<IVariableState>> | null;
     /**
@@ -456,5 +456,17 @@ export declare class Workspace implements IASTNodeLocation {
      */
     static getAll(): Workspace[];
     protected getVariableMapClass(): new (...p1: any[]) => IVariableMap<IVariableModel<IVariableState>>;
+    /**
+     * Returns whether or not this workspace is in readonly mode.
+     *
+     * @returns True if the workspace is readonly, otherwise false.
+     */
+    isReadOnly(): boolean;
+    /**
+     * Sets whether or not this workspace is in readonly mode.
+     *
+     * @param readOnly True to make the workspace readonly, otherwise false.
+     */
+    setIsReadOnly(readOnly: boolean): void;
 }
 //# sourceMappingURL=workspace.d.ts.map

package/core/workspace_svg.d.ts

@@ -27,7 +27,7 @@ import type { IFlyout } from './interfaces/i_flyout.js';
 import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
 import type { IToolbox } from './interfaces/i_toolbox.js';
 import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
-import type { Cursor } from './keyboard_nav/cursor.js';
+import type { LineCursor } from './keyboard_nav/line_cursor.js';
 import type { Marker } from './keyboard_nav/marker.js';
 import { LayerManager } from './layer_manager.js';
 import { MarkerManager } from './marker_manager.js';
@@ -304,7 +304,7 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      *
      * @returns The cursor for the workspace.
      */
-    getCursor(): Cursor | null;
+    getCursor(): LineCursor | null;
     /**
      * Get the block renderer attached to this workspace.
      *
@@ -1003,6 +1003,20 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      * @param className Name of class to remove.
      */
     removeClass(className: string): void;
+    setIsReadOnly(readOnly: boolean): void;
+    /**
+     * Scrolls the provided bounds into view.
+     *
+     * In the case of small workspaces/large bounds, this function prioritizes
+     * getting the top left corner of the bounds into view. It also adds some
+     * padding around the bounds to allow the element to be comfortably in view.
+     *
+     * @internal
+     * @param bounds A rectangle to scroll into view, as best as possible.
+     * @param padding Amount of spacing to put between the bounds and the edge of
+     *     the workspace's viewport.
+     */
+    scrollBoundsIntoView(bounds: Rect, padding?: number): void;
 }
 /**
  * Size the workspace when the contents change.  This also updates

package/dart_compressed.js

@@ -79,7 +79,7 @@ List ${b.FUNCTION_NAME_PLACEHOLDER_}(List list, String type, int direction) {
 }
 `)+"("+c+', "'+a+'", '+d+")",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},lists_split$$module$build$src$generators$dart$lists=function(a,b){let c=b.valueToCode(a,"INPUT",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX);b=b.valueToCode(a,"DELIM",Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";a=a.getFieldValue("MODE");if("SPLIT"===a)c||(c="''"),a="split";else if("JOIN"===a)c||(c="[]"),a="join";else throw Error("Unknown mode: "+a);return[c+
 "."+a+"("+b+")",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},lists_reverse$$module$build$src$generators$dart$lists=function(a,b){return["new List.from("+(b.valueToCode(a,"LIST",Order$$module$build$src$generators$dart$dart_generator.NONE)||"[]")+".reversed)",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},controls_if$$module$build$src$generators$dart$logic=function(a,b){let c=0,d="",e,f;b.STATEMENT_PREFIX&&(d+=b.injectId(b.STATEMENT_PREFIX,a));do f=
-b.valueToCode(a,"IF"+c,Order$$module$build$src$generators$dart$dart_generator.NONE)||"false",e=b.statementToCode(a,"DO"+c),b.STATEMENT_SUFFIX&&(e=b.prefixLines(b.injectId(b.STATEMENT_SUFFIX,a),b.INDENT)+e),d+=(0<c?"else ":"")+"if ("+f+") {\n"+e+"}",c++;while(a.getInput("IF"+c));if(a.getInput("ELSE")||b.STATEMENT_SUFFIX)e=b.statementToCode(a,"ELSE"),b.STATEMENT_SUFFIX&&(e=b.prefixLines(b.injectId(b.STATEMENT_SUFFIX,a),b.INDENT)+e),d+=" else {\n"+e+"}";return d+"\n"},logic_compare$$module$build$src$generators$dart$logic=
+b.valueToCode(a,"IF"+c,Order$$module$build$src$generators$dart$dart_generator.NONE)||"false",e=b.statementToCode(a,"DO"+c),b.STATEMENT_SUFFIX&&(e=b.prefixLines(b.injectId(b.STATEMENT_SUFFIX,a),b.INDENT)+e),d+=(0<c?"else ":"")+"if ("+f+") {\n"+e+"}",c++;while(a.getInput("IF"+c));if(a.getInput("ELSE")||b.STATEMENT_SUFFIX)e=a.getInput("ELSE")?b.statementToCode(a,"ELSE"):"",b.STATEMENT_SUFFIX&&(e=b.prefixLines(b.injectId(b.STATEMENT_SUFFIX,a),b.INDENT)+e),d+=" else {\n"+e+"}";return d+"\n"},logic_compare$$module$build$src$generators$dart$logic=
 function(a,b){const c={EQ:"==",NEQ:"!=",LT:"<",LTE:"<=",GT:">",GTE:">="}[a.getFieldValue("OP")],d="=="===c||"!="===c?Order$$module$build$src$generators$dart$dart_generator.EQUALITY:Order$$module$build$src$generators$dart$dart_generator.RELATIONAL,e=b.valueToCode(a,"A",d)||"0";a=b.valueToCode(a,"B",d)||"0";return[e+" "+c+" "+a,d]},logic_operation$$module$build$src$generators$dart$logic=function(a,b){const c="AND"===a.getFieldValue("OP")?"&&":"||",d="&&"===c?Order$$module$build$src$generators$dart$dart_generator.LOGICAL_AND:
 Order$$module$build$src$generators$dart$dart_generator.LOGICAL_OR;let e=b.valueToCode(a,"A",d);a=b.valueToCode(a,"B",d);e||a?(b="&&"===c?"true":"false",e||(e=b),a||(a=b)):a=e="false";return[e+" "+c+" "+a,d]},logic_negate$$module$build$src$generators$dart$logic=function(a,b){const c=Order$$module$build$src$generators$dart$dart_generator.UNARY_PREFIX;return["!"+(b.valueToCode(a,"BOOL",c)||"true"),c]},logic_boolean$$module$build$src$generators$dart$logic=function(a,b){return["TRUE"===a.getFieldValue("BOOL")?
 "true":"false",Order$$module$build$src$generators$dart$dart_generator.ATOMIC]},logic_null$$module$build$src$generators$dart$logic=function(a,b){return["null",Order$$module$build$src$generators$dart$dart_generator.ATOMIC]},logic_ternary$$module$build$src$generators$dart$logic=function(a,b){const c=b.valueToCode(a,"IF",Order$$module$build$src$generators$dart$dart_generator.CONDITIONAL)||"false",d=b.valueToCode(a,"THEN",Order$$module$build$src$generators$dart$dart_generator.CONDITIONAL)||"null";a=b.valueToCode(a,