blockly 12.3.0-beta.0 → 12.3.0

package/core/block.d.ts

@@ -542,7 +542,7 @@ export declare class Block {
     /**
      * Returns a generator that provides every field on the block.
      *
-     * @yields A generator that can be used to iterate the fields on the block.
+     * @returns A generator that can be used to iterate the fields on the block.
      */
     getFields(): Generator<Field, undefined, void>;
     /**

package/core/field.d.ts

@@ -86,9 +86,6 @@ export declare abstract class Field<T = any> implements IKeyboardAccessible, IRe
      * through to super, but it must exist per the JS spec.
      */
     protected get size_(): Size;
-    /**
-     * Sets the size of this field.
-     */
     protected set size_(newValue: Size);
     /** The rendered field's SVG group element. */
     protected fieldGroup_: SVGGElement | null;

package/core/field_input.d.ts

@@ -62,10 +62,6 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      * are not. Editable fields should also be serializable.
      */
     SERIALIZABLE: boolean;
-    /**
-     * Sets the size of this field. Although this appears to be a no-op, it must
-     * exist since the getter is overridden below.
-     */
     protected set size_(newValue: Size);
     /**
      * Returns the size of this field, with a minimum width of 14.
@@ -229,6 +225,14 @@ export declare abstract class FieldInput<T extends InputTypes> extends Field<str
      *     div.
      */
     repositionForWindowResize(): boolean;
+    /**
+     * Position a field's text element after a size change.  This handles both LTR
+     * and RTL positioning.
+     *
+     * @param xMargin x offset to use when positioning the text element.
+     * @param contentWidth The content width.
+     */
+    protected positionTextElement_(xMargin: number, contentWidth: number): void;
     /**
      * Use the `getText_` developer hook to override the field's text
      * representation. When we're currently editing, return the current HTML value

package/core/field_registry.d.ts

@@ -48,8 +48,8 @@ export interface RegistrableField {
  * @param type The field type name as used in the JSON definition.
  * @param fieldClass The field class containing a fromJson function that can
  *     construct an instance of the field.
- * @throws {Error} if the type name is empty, the field is already registered,
- *     or the fieldClass is not an object containing a fromJson function.
+ * @throws {Error} if the type name is empty or the fieldClass is not an object
+ *     containing a fromJson function.
  */
 export declare function register(type: string, fieldClass: RegistrableField): void;
 /**

package/core/focus_manager.d.ts

@@ -155,6 +155,8 @@ export declare class FocusManager {
      * Note that this may update the specified node's element's tabindex to ensure
      * that it can be properly read out by screenreaders while focused.
      *
+     * The focused node will not be automatically scrolled into view.
+     *
      * @param focusableNode The node that should receive active focus.
      */
     focusNode(focusableNode: IFocusableNode): void;
@@ -175,6 +177,8 @@ export declare class FocusManager {
      * the returned lambda is called. Additionally, only 1 ephemeral focus context
      * can be active at any given time (attempting to activate more than one
      * simultaneously will result in an error being thrown).
+     *
+     * This method does not scroll the ephemerally focused element into view.
      */
     takeEphemeralFocus(focusableElement: HTMLElement | SVGElement): ReturnEphemeralFocus;
     /**

package/core/interfaces/i_focusable_node.d.ts

@@ -55,6 +55,9 @@ export interface IFocusableNode {
      * they should avoid the following:
      * - Creating or removing DOM elements (including via the renderer or drawer).
      * - Affecting focus via DOM focus() calls or the FocusManager.
+     *
+     * Implementations may consider scrolling themselves into view here; that is
+     * not handled by the focus manager.
      */
     onNodeFocus(): void;
     /**

package/core/keyboard_nav/line_cursor.d.ts

@@ -13,7 +13,7 @@
  */
 import { BlockSvg } from '../block_svg.js';
 import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
+import type { WorkspaceSvg } from '../workspace_svg.js';
 import { Marker } from './marker.js';
 /**
  * Class for a line cursor.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blockly",
-  "version": "12.3.0-beta.0",
+  "version": "12.3.0",
   "description": "Blockly is a library for building visual programming editors.",
   "keywords": [
     "blockly"
@@ -76,12 +76,13 @@
     "@microsoft/api-extractor": "^7.29.5",
     "ajv": "^8.17.1",
     "async-done": "^2.0.0",
-    "chai": "^5.1.1",
+    "chai": "^6.0.1",
     "concurrently": "^9.0.1",
     "eslint": "^9.15.0",
     "eslint-config-google": "^0.14.0",
     "eslint-config-prettier": "^10.1.1",
     "eslint-plugin-jsdoc": "^52.0.2",
+    "eslint-plugin-mocha": "^11.1.0",
     "eslint-plugin-prettier": "^5.2.1",
     "glob": "^11.0.1",
     "globals": "^16.0.0",
@@ -104,6 +105,7 @@
     "patch-package": "^8.0.0",
     "prettier": "^3.3.3",
     "prettier-plugin-organize-imports": "^4.0.0",
+    "puppeteer-core": "^24.17.0",
     "readline-sync": "^1.4.10",
     "rimraf": "^5.0.0",
     "typescript": "^5.3.3",