blockly 12.0.0 → 12.0.1-beta.1

package/core/comments/rendered_workspace_comment.d.ts

@@ -9,6 +9,7 @@ import { IContextMenu } from '../interfaces/i_contextmenu.js';
 import { ICopyable } from '../interfaces/i_copyable.js';
 import { IDeletable } from '../interfaces/i_deletable.js';
 import { IDraggable } from '../interfaces/i_draggable.js';
+import { IFocusableNode } from '../interfaces/i_focusable_node.js';
 import type { IFocusableTree } from '../interfaces/i_focusable_tree.js';
 import { IRenderedElement } from '../interfaces/i_rendered_element.js';
 import { ISelectable } from '../interfaces/i_selectable.js';
@@ -17,7 +18,7 @@ import { Rect } from '../utils/rect.js';
 import { Size } from '../utils/size.js';
 import { WorkspaceSvg } from '../workspace_svg.js';
 import { WorkspaceComment } from './workspace_comment.js';
-export declare class RenderedWorkspaceComment extends WorkspaceComment implements IBoundedElement, IRenderedElement, IDraggable, ISelectable, IDeletable, ICopyable<WorkspaceCommentCopyData>, IContextMenu {
+export declare class RenderedWorkspaceComment extends WorkspaceComment implements IBoundedElement, IRenderedElement, IDraggable, ISelectable, IDeletable, ICopyable<WorkspaceCommentCopyData>, IContextMenu, IFocusableNode {
     /** The class encompassing the svg elements making up the workspace comment. */
     private view;
     readonly workspace: WorkspaceSvg;

package/core/dropdowndiv.d.ts

@@ -95,9 +95,14 @@ export declare function setColour(backgroundColour: string, borderColour: string
  * @param block Block to position the drop-down around.
  * @param opt_onHide Optional callback for when the drop-down is hidden.
  * @param opt_secondaryYOffset Optional Y offset for above-block positioning.
+ * @param manageEphemeralFocus Whether ephemeral focus should be managed
+ *     according to the drop-down div's lifetime. Note that if a false value is
+ *     passed in here then callers should manage ephemeral focus directly
+ *     otherwise focus may not properly restore when the widget closes. Defaults
+ *     to true.
  * @returns True if the menu rendered below block; false if above.
  */
-export declare function showPositionedByBlock<T>(field: Field<T>, block: BlockSvg, opt_onHide?: () => void, opt_secondaryYOffset?: number): boolean;
+export declare function showPositionedByBlock<T>(field: Field<T>, block: BlockSvg, opt_onHide?: () => void, opt_secondaryYOffset?: number, manageEphemeralFocus?: boolean): boolean;
 /**
  * Shortcut to show and place the drop-down with positioning determined
  * by a particular field. The primary position will be below the field,
@@ -107,9 +112,14 @@ export declare function showPositionedByBlock<T>(field: Field<T>, block: BlockSv
  * @param field The field to position the dropdown against.
  * @param opt_onHide Optional callback for when the drop-down is hidden.
  * @param opt_secondaryYOffset Optional Y offset for above-block positioning.
+ * @param manageEphemeralFocus Whether ephemeral focus should be managed
+ *     according to the drop-down div's lifetime. Note that if a false value is
+ *     passed in here then callers should manage ephemeral focus directly
+ *     otherwise focus may not properly restore when the widget closes. Defaults
+ *     to true.
  * @returns True if the menu rendered below block; false if above.
  */
-export declare function showPositionedByField<T>(field: Field<T>, opt_onHide?: () => void, opt_secondaryYOffset?: number): boolean;
+export declare function showPositionedByField<T>(field: Field<T>, opt_onHide?: () => void, opt_secondaryYOffset?: number, manageEphemeralFocus?: boolean): boolean;
 /**
  * Show and place the drop-down.
  * The drop-down is placed with an absolute "origin point" (x, y) - i.e.,

package/core/field_image.d.ts

@@ -92,6 +92,12 @@ export declare class FieldImage extends Field<string> {
      * @param alt New alt text.
      */
     setAlt(alt: string | null): void;
+    /**
+     * Check whether this field should be clickable.
+     *
+     * @returns Whether this field is clickable.
+     */
+    isClickable(): boolean;
     /**
      * If field click is called, and click handler defined,
      * call the handler.

package/core/focus_manager.d.ts

@@ -55,6 +55,7 @@ export declare class FocusManager {
     private currentlyHoldsEphemeralFocus;
     private lockFocusStateChanges;
     private recentlyLostAllFocus;
+    private isUpdatingFocusedNode;
     constructor(addGlobalEventListener: (type: string, listener: EventListener) => void);
     /**
      * Registers a new IFocusableTree for automatic focus management.

package/core/icons/icon.d.ts

@@ -72,5 +72,11 @@ export declare abstract class Icon implements IIcon {
     onNodeBlur(): void;
     /** See IFocusableNode.canBeFocused. */
     canBeFocused(): boolean;
+    /**
+     * Returns the block that this icon is attached to.
+     *
+     * @returns The block this icon is attached to.
+     */
+    getSourceBlock(): Block;
 }
 //# sourceMappingURL=icon.d.ts.map

package/core/keyboard_nav/block_navigation_policy.d.ts

@@ -29,7 +29,7 @@ export declare class BlockNavigationPolicy implements INavigationPolicy<BlockSvg
      * 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
+     * @returns The first node of the next input/stack if the given block is a terminal
      *     block, or its next connection.
      */
     getNextSibling(current: BlockSvg): IFocusableNode | null;

package/core/keyboard_nav/icon_navigation_policy.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Icon } from '../icons/icon.js';
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
+import type { INavigationPolicy } from '../interfaces/i_navigation_policy.js';
+/**
+ * Set of rules controlling keyboard navigation from an icon.
+ */
+export declare class IconNavigationPolicy implements INavigationPolicy<Icon> {
+    /**
+     * Returns the first child of the given icon.
+     *
+     * @param _current The icon to return the first child of.
+     * @returns Null.
+     */
+    getFirstChild(_current: Icon): IFocusableNode | null;
+    /**
+     * Returns the parent of the given icon.
+     *
+     * @param current The icon to return the parent of.
+     * @returns The source block of the given icon.
+     */
+    getParent(current: Icon): IFocusableNode | null;
+    /**
+     * Returns the next peer node of the given icon.
+     *
+     * @param current The icon to find the following element of.
+     * @returns The next icon, field or input following this icon, if any.
+     */
+    getNextSibling(current: Icon): IFocusableNode | null;
+    /**
+     * Returns the previous peer node of the given icon.
+     *
+     * @param current The icon to find the preceding element of.
+     * @returns The icon's previous icon, if any.
+     */
+    getPreviousSibling(current: Icon): IFocusableNode | null;
+    /**
+     * Returns whether or not the given icon can be navigated to.
+     *
+     * @param current The instance to check for navigability.
+     * @returns True if the given icon can be focused.
+     */
+    isNavigable(current: Icon): 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 an Icon.
+     */
+    isApplicable(current: any): current is Icon;
+}
+//# sourceMappingURL=icon_navigation_policy.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blockly",
-  "version": "12.0.0",
+  "version": "12.0.1-beta.1",
   "description": "Blockly is a library for building visual programming editors.",
   "keywords": [
     "blockly"
@@ -68,7 +68,7 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@blockly/block-test": "^6.0.4",
-    "@blockly/dev-tools": "^8.0.6",
+    "@blockly/dev-tools": "^9.0.0",
     "@blockly/theme-modern": "^6.0.3",
     "@hyperjump/browser": "^1.1.4",
     "@hyperjump/json-schema": "^1.5.0",
@@ -99,7 +99,7 @@
     "http-server": "^14.0.0",
     "json5": "^2.2.0",
     "markdown-tables-to-json": "^0.1.7",
-    "mocha": "^10.0.0",
+    "mocha": "^11.3.0",
     "patch-package": "^8.0.0",
     "prettier": "^3.3.3",
     "prettier-plugin-organize-imports": "^4.0.0",