@cp949/phyx-blockly 12.5.1-p1 → 13.4.0-patch.1

package/core/bubbles/bubble.d.ts

@@ -3,21 +3,28 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { IBubble } from '../interfaces/i_bubble.js';
+import type { IBoundedElement } from '../interfaces/i_bounded_element.js';
+import type { IBubble } from '../interfaces/i_bubble.js';
 import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
 import type { IFocusableTree } from '../interfaces/i_focusable_tree.js';
 import type { IHasBubble } from '../interfaces/i_has_bubble.js';
-import { ISelectable } from '../interfaces/i_selectable.js';
+import type { ISelectable } from '../interfaces/i_selectable.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { Size } from '../utils/size.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
+import type { WorkspaceSvg } from '../workspace_svg.js';
+/**
+ * Represents a either a string or a function that, when called, can provide a
+ * custom ARIA string to represent a bubble, or null if the default fallback
+ * should be used. See setAriaLabelProvider for more context.
+ */
+export type AriaLabelProvider = string | ((bubble: Bubble) => string | null);
 /**
  * The abstract pop-up bubble class. This creates a UI that looks like a speech
  * bubble, where it has a "tail" that points to the block, and a "head" that
  * displays arbitrary svg elements.
  */
-export declare abstract class Bubble implements IBubble, ISelectable, IFocusableNode {
+export declare abstract class Bubble implements IBubble, ISelectable, IFocusableNode, IBoundedElement {
     readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;
     protected ownerRect?: Rect | undefined;
@@ -65,6 +72,7 @@ export declare abstract class Bubble implements IBubble, ISelectable, IFocusable
     private relativeLeft;
     private dragStrategy;
     private focusableElement;
+    private ariaLabelProvider;
     /**
      * @param workspace The workspace this bubble belongs to.
      * @param anchor The anchor location of the thing this bubble is attached to.
@@ -126,6 +134,14 @@ export declare abstract class Bubble implements IBubble, ISelectable, IFocusable
      * @internal
      */
     moveTo(x: number, y: number): void;
+    /**
+     * Moves the bubble by the given amounts in the x and y directions.
+     *
+     * @param dx The distance to move along the x axis.
+     * @param dy The distance to move along the y axis.
+     * @param _reason A description of why this move is happening.
+     */
+    moveBy(dx: number, dy: number, _reason?: string[]): void;
     /**
      * Positions the bubble "optimally" so that the most of it is visible and
      * it does not overlap the rect (if provided).
@@ -182,6 +198,12 @@ export declare abstract class Bubble implements IBubble, ISelectable, IFocusable
     bringToFront(): boolean;
     /** @internal */
     getRelativeToSurfaceXY(): Coordinate;
+    /**
+     * Returns the bounds of this bubble.
+     *
+     * @returns A bounding box for this bubble.
+     */
+    getBoundingRectangle(): Rect;
     /** @internal */
     getSvgRoot(): SVGElement;
     /**
@@ -201,7 +223,7 @@ export declare abstract class Bubble implements IBubble, ISelectable, IFocusable
     /** Returns whether this bubble is movable or not. */
     isMovable(): boolean;
     /** Starts a drag on the bubble. */
-    startDrag(): void;
+    startDrag(): IBubble;
     /** Drags the bubble to the given location. */
     drag(newLoc: Coordinate): void;
     /** Ends the drag on the bubble. */
@@ -224,5 +246,37 @@ export declare abstract class Bubble implements IBubble, ISelectable, IFocusable
      * Returns the object that owns/hosts this bubble, if any.
      */
     getOwner(): (IHasBubble & IFocusableNode) | undefined;
+    /**
+     * Recomputes the ARIA label and role for this bubble. This is automatically called
+     * during initialization, but implementations may find it useful to call this if
+     * the bubble's label should be changed.
+     *
+     * Bubbles use a default non-specific label unless they're customized otherwise
+     * which is the responsibility of the bubble's owner rather than bubble
+     * implementations. Customization can be done via setAriaLabelProvider.
+     */
+    protected recomputeAriaContext(): void;
+    /**
+     * Sets a custom ARIA label provider for this bubble, or null if it should be reset
+     * to use the default method.
+     *
+     * Bubbles do not compute ARIA labels specifically to their implementation since
+     * they can be rather general-purpose. Instead, owners of the specific bubble
+     * instance (such as an icon) are responsible for defining custom label providers
+     * for their bubbles.
+     *
+     * Note that calling this isn't sufficient for it to actually be used.
+     * recomputeAriaContext will likely also need to be called to actually apply the
+     * custom label to the bubble's focusable element.
+     */
+    setAriaLabelProvider(provider: AriaLabelProvider | null): void;
+    /**
+     * Returns the ARIA label to use for this bubble based on the provider set via
+     * setAriaLabelProvider. This will return null if the provider is absent or
+     * returns null.
+     *
+     * @returns The ARIA label to use for this bubble, or null if one is not provided.
+     */
+    getAriaLabel(): string | null;
 }
 //# sourceMappingURL=bubble.d.ts.map

package/core/bubbles/mini_workspace_bubble.d.ts

@@ -4,9 +4,11 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { BlocklyOptions } from '../blockly_options.js';
-import { Abstract as AbstractEvent } from '../events/events_abstract.js';
+import type { Abstract as AbstractEvent } from '../events/events_abstract.js';
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
+import type { IHasBubble } from '../interfaces/i_has_bubble.js';
 import { Options } from '../options.js';
-import { Coordinate } from '../utils/coordinate.js';
+import type { Coordinate } from '../utils/coordinate.js';
 import type { Rect } from '../utils/rect.js';
 import type { WorkspaceSvg } from '../workspace_svg.js';
 import { Bubble } from './bubble.js';
@@ -18,6 +20,7 @@ export declare class MiniWorkspaceBubble extends Bubble {
     readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;
     protected ownerRect?: Rect | undefined;
+    protected owner?: (IHasBubble & IFocusableNode) | undefined;
     /**
      * The minimum amount of change to the mini workspace view to trigger
      * resizing the bubble.
@@ -38,7 +41,7 @@ export declare class MiniWorkspaceBubble extends Bubble {
      */
     private autoLayout;
     /** @internal */
-    constructor(workspaceOptions: BlocklyOptions, workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined);
+    constructor(workspaceOptions: BlocklyOptions, workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined, owner?: (IHasBubble & IFocusableNode) | undefined);
     dispose(): void;
     /** @internal */
     getWorkspace(): WorkspaceSvg;
@@ -80,5 +83,10 @@ export declare class MiniWorkspaceBubble extends Bubble {
     moveTo(x: number, y: number): void;
     /** @internal */
     newWorkspaceSvg(options: Options): WorkspaceSvg;
+    /**
+     * Handles the user acting on this bubble via keyboard navigation by focusing
+     * the mutator workspace.
+     */
+    performAction(): void;
 }
 //# sourceMappingURL=mini_workspace_bubble.d.ts.map

package/core/bubbles/text_bubble.d.ts

@@ -3,9 +3,11 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Coordinate } from '../utils/coordinate.js';
-import { Rect } from '../utils/rect.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
+import type { IHasBubble } from '../interfaces/i_has_bubble.js';
+import type { Coordinate } from '../utils/coordinate.js';
+import type { Rect } from '../utils/rect.js';
+import type { WorkspaceSvg } from '../workspace_svg.js';
 import { Bubble } from './bubble.js';
 /**
  * A bubble that displays non-editable text. Used by the warning icon.
@@ -15,8 +17,9 @@ export declare class TextBubble extends Bubble {
     readonly workspace: WorkspaceSvg;
     protected anchor: Coordinate;
     protected ownerRect?: Rect | undefined;
+    protected owner?: (IHasBubble & IFocusableNode) | undefined;
     private paragraph;
-    constructor(text: string, workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined);
+    constructor(text: string, workspace: WorkspaceSvg, anchor: Coordinate, ownerRect?: Rect | undefined, owner?: (IHasBubble & IFocusableNode) | undefined);
     /** @returns the current text of this text bubble. */
     getText(): string;
     /** Sets the current text of this text bubble, and updates the display. */

package/core/bubbles/textinput_bubble.d.ts

@@ -9,7 +9,7 @@ import type { IHasBubble } from '../interfaces/i_has_bubble.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
 import { Size } from '../utils/size.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
+import type { WorkspaceSvg } from '../workspace_svg.js';
 import { Bubble } from './bubble.js';
 /**
  * A bubble that displays editable text. It can also be resized by the user.
@@ -43,6 +43,7 @@ export declare class TextInputBubble extends Bubble {
     private editable;
     /** View responsible for supporting text editing. */
     private editor;
+    private readonly textChangeListener;
     /**
      * @param workspace The workspace this bubble belongs to.
      * @param anchor The anchor location of the thing this bubble is attached to.
@@ -98,5 +99,14 @@ export declare class TextInputBubble extends Bubble {
      * @internal
      */
     getEditor(): CommentEditor;
+    /**
+     * Handles the user acting on this bubble via keyboard navigation by focusing
+     * the comment editor.
+     */
+    performAction(): void;
+    /**
+     * Dispose of this bubble.
+     */
+    dispose(): void;
 }
 //# sourceMappingURL=textinput_bubble.d.ts.map

package/core/clipboard/block_paster.d.ts

@@ -3,12 +3,12 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { BlockSvg } from '../block_svg.js';
-import { ICopyData } from '../interfaces/i_copyable.js';
-import { IPaster } from '../interfaces/i_paster.js';
-import { State } from '../serialization/blocks.js';
+import type { BlockSvg } from '../block_svg.js';
+import type { ICopyData } from '../interfaces/i_copyable.js';
+import type { IPaster } from '../interfaces/i_paster.js';
+import type { State } from '../serialization/blocks.js';
 import { Coordinate } from '../utils/coordinate.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
+import type { WorkspaceSvg } from '../workspace_svg.js';
 export declare class BlockPaster implements IPaster<BlockCopyData, BlockSvg> {
     static TYPE: string;
     paste(copyData: BlockCopyData, workspace: WorkspaceSvg, coordinate?: Coordinate): BlockSvg | null;

package/core/clipboard/registry.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { ICopyable, ICopyData } from '../interfaces/i_copyable.js';
+import type { ICopyable, ICopyData } from '../interfaces/i_copyable.js';
 import type { IPaster } from '../interfaces/i_paster.js';
 /**
  * Registers the given paster so that it cna be used for pasting.

package/core/clipboard/workspace_comment_paster.d.ts

@@ -3,12 +3,12 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { RenderedWorkspaceComment } from '../comments/rendered_workspace_comment.js';
-import { ICopyData } from '../interfaces/i_copyable.js';
-import { IPaster } from '../interfaces/i_paster.js';
+import type { RenderedWorkspaceComment } from '../comments/rendered_workspace_comment.js';
+import type { ICopyData } from '../interfaces/i_copyable.js';
+import type { IPaster } from '../interfaces/i_paster.js';
 import * as commentSerialiation from '../serialization/workspace_comments.js';
 import { Coordinate } from '../utils/coordinate.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
+import type { WorkspaceSvg } from '../workspace_svg.js';
 export declare class WorkspaceCommentPaster implements IPaster<WorkspaceCommentCopyData, RenderedWorkspaceComment> {
     static TYPE: string;
     paste(copyData: WorkspaceCommentCopyData, workspace: WorkspaceSvg, coordinate?: Coordinate): RenderedWorkspaceComment | null;

package/core/clipboard.d.ts

@@ -6,7 +6,7 @@
 import { BlockCopyData, BlockPaster } from './clipboard/block_paster.js';
 import * as registry from './clipboard/registry.js';
 import type { ICopyData, ICopyable } from './interfaces/i_copyable.js';
-import { Coordinate } from './utils/coordinate.js';
+import type { Coordinate } from './utils/coordinate.js';
 import { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Copy a copyable item, and record its data and the workspace it was

package/core/comments/collapse_comment_bar_button.d.ts

@@ -14,10 +14,6 @@ export declare const COMMENT_COLLAPSE_BAR_BUTTON_FOCUS_IDENTIFIER = "_collapse_b
  * Button that toggles the collapsed state of a comment.
  */
 export declare class CollapseCommentBarButton extends CommentBarButton {
-    protected readonly id: string;
-    protected readonly workspace: WorkspaceSvg;
-    protected readonly container: SVGGElement;
-    protected readonly commentView: CommentView;
     /**
      * Opaque ID used to unbind event handlers during disposal.
      */
@@ -48,5 +44,12 @@ export declare class CollapseCommentBarButton extends CommentBarButton {
      * @param e The event that triggered this action.
      */
     performAction(e?: Event): void;
+    /**
+     * Returns the ARIA label to use for this button (defaults to null). Note that this
+     * method will only be called and apply when recomputeAriaContext is called.
+     *
+     * @returns The ARIA label to use for this button, or null to use a default.
+     */
+    protected getAriaLabel(): string;
 }
 //# sourceMappingURL=collapse_comment_bar_button.d.ts.map

package/core/comments/comment_bar_button.d.ts

@@ -11,7 +11,7 @@ import type { CommentView } from './comment_view.js';
  * Button displayed on a comment's top bar.
  */
 export declare abstract class CommentBarButton implements IFocusableNode {
-    protected readonly id: string;
+    readonly id: string;
     protected readonly workspace: WorkspaceSvg;
     protected readonly container: SVGGElement;
     protected readonly commentView: CommentView;
@@ -58,5 +58,19 @@ export declare abstract class CommentBarButton implements IFocusableNode {
     onNodeBlur(): void;
     /** Returns whether this button can be focused. True if it is visible. */
     canBeFocused(): boolean;
+    /**
+     * Recomputes the ARIA label and role for this button. Note that this is not
+     * automatically called during initialization and must be called once a button's
+     * focusable element (icon) is initialized. Implementations may also find it useful
+     * to call this if the button's label should be changed.
+     */
+    protected recomputeAriaContext(): void;
+    /**
+     * Returns the ARIA label to use for this button (defaults to null). Note that this
+     * method will only be called and apply when recomputeAriaContext is called.
+     *
+     * @returns The ARIA label to use for this button, or null to use a default.
+     */
+    protected getAriaLabel(): string | null;
 }
 //# sourceMappingURL=comment_bar_button.d.ts.map

package/core/comments/comment_editor.d.ts

@@ -3,10 +3,12 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { IFocusableNode } from '../interfaces/i_focusable_node.js';
-import { IFocusableTree } from '../interfaces/i_focusable_tree.js';
-import { Size } from '../utils/size.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
+import type { BlockSvg } from '../block_svg.js';
+import type { IFocusableNode } from '../interfaces/i_focusable_node.js';
+import type { IFocusableTree } from '../interfaces/i_focusable_tree.js';
+import type { Size } from '../utils/size.js';
+import type { WorkspaceSvg } from '../workspace_svg.js';
+import type { RenderedWorkspaceComment } from './rendered_workspace_comment.js';
 /**
  * String added to the ID of a workspace comment to identify
  * the focusable node for the comment editor.
@@ -16,7 +18,7 @@ export declare const COMMENT_EDITOR_FOCUS_IDENTIFIER = "_comment_textarea_";
 export declare class CommentEditor implements IFocusableNode {
     workspace: WorkspaceSvg;
     private onFinishEditing?;
-    id?: string;
+    id: string;
     /** The foreignObject containing the HTML text area. */
     private foreignObject;
     /** The text area where the user can type. */
@@ -25,13 +27,26 @@ export declare class CommentEditor implements IFocusableNode {
     private textChangeListeners;
     /** The current text of the comment. Updates on text area change. */
     private text;
-    constructor(workspace: WorkspaceSvg, commentId?: string, onFinishEditing?: (() => void) | undefined);
+    /** The parent object that owns this comment editor. */
+    private parent?;
+    constructor(workspace: WorkspaceSvg, commentId: string, onFinishEditing?: (() => void) | undefined);
     /** Gets the dom structure for this comment editor. */
     getDom(): SVGForeignObjectElement;
     /** Gets the current text of the comment. */
     getText(): string;
     /** Sets the current text of the comment and fires change listeners. */
     setText(text: string): void;
+    /**
+     * Sets the parent object that owns this comment editor.
+     *
+     * @param newParent The parent of this comment editor.
+     * @internal
+     */
+    setParent(newParent: BlockSvg | RenderedWorkspaceComment): void;
+    /**
+     * Returns the parent object that owns this comment editor, if any.
+     */
+    getParent(): BlockSvg | RenderedWorkspaceComment | undefined;
     /**
      * Triggers listeners when the text of the comment changes, either
      * programmatically or manually by the user.

package/core/comments/comment_view.d.ts

@@ -3,12 +3,12 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { IFocusableNode } from '../interfaces/i_focusable_node';
-import { IRenderedElement } from '../interfaces/i_rendered_element.js';
+import type { IRenderedElement } from '../interfaces/i_rendered_element.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Size } from '../utils/size.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
-import { CommentBarButton } from './comment_bar_button.js';
+import type { WorkspaceSvg } from '../workspace_svg.js';
+import type { CommentBarButton } from './comment_bar_button.js';
+import { CommentEditor } from './comment_editor.js';
 export declare class CommentView implements IRenderedElement {
     readonly workspace: WorkspaceSvg;
     readonly commentId: string;
@@ -84,7 +84,7 @@ export declare class CommentView implements IRenderedElement {
      *
      * @returns The FocusableNode representing the editor portion of this comment.
      */
-    getEditorFocusableNode(): IFocusableNode;
+    getEditorFocusableNode(): CommentEditor;
     /** Creates the DOM elements for the comment resize handle. */
     private createResizeHandle;
     /** Returns the root SVG group element of the comment view. */

package/core/comments/delete_comment_bar_button.d.ts

@@ -14,10 +14,6 @@ export declare const COMMENT_DELETE_BAR_BUTTON_FOCUS_IDENTIFIER = "_delete_bar_b
  * Button that deletes a comment.
  */
 export declare class DeleteCommentBarButton extends CommentBarButton {
-    protected readonly id: string;
-    protected readonly workspace: WorkspaceSvg;
-    protected readonly container: SVGGElement;
-    protected readonly commentView: CommentView;
     /**
      * Opaque ID used to unbind event handlers during disposal.
      */
@@ -48,5 +44,12 @@ export declare class DeleteCommentBarButton extends CommentBarButton {
      * @param e The event that triggered this action.
      */
     performAction(e?: Event): void;
+    /**
+     * Returns the ARIA label to use for this button (defaults to null). Note that this
+     * method will only be called and apply when recomputeAriaContext is called.
+     *
+     * @returns The ARIA label to use for this button, or null to use a default.
+     */
+    protected getAriaLabel(): string;
 }
 //# sourceMappingURL=delete_comment_bar_button.d.ts.map

package/core/comments/rendered_workspace_comment.d.ts

@@ -3,20 +3,20 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { WorkspaceCommentCopyData } from '../clipboard/workspace_comment_paster.js';
-import { IBoundedElement } from '../interfaces/i_bounded_element.js';
-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 { WorkspaceCommentCopyData } from '../clipboard/workspace_comment_paster.js';
+import type { IBoundedElement } from '../interfaces/i_bounded_element.js';
+import type { IContextMenu } from '../interfaces/i_contextmenu.js';
+import type { ICopyable } from '../interfaces/i_copyable.js';
+import type { IDeletable } from '../interfaces/i_deletable.js';
+import type { IDraggable } from '../interfaces/i_draggable.js';
+import type { 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';
+import type { IRenderedElement } from '../interfaces/i_rendered_element.js';
+import type { ISelectable } from '../interfaces/i_selectable.js';
 import { Coordinate } from '../utils/coordinate.js';
 import { Rect } from '../utils/rect.js';
-import { Size } from '../utils/size.js';
-import { WorkspaceSvg } from '../workspace_svg.js';
+import type { Size } from '../utils/size.js';
+import type { WorkspaceSvg } from '../workspace_svg.js';
 import { CommentView } from './comment_view.js';
 import { WorkspaceComment } from './workspace_comment.js';
 export declare class RenderedWorkspaceComment extends WorkspaceComment implements IBoundedElement, IRenderedElement, IDraggable, ISelectable, IDeletable, ICopyable<WorkspaceCommentCopyData>, IContextMenu, IFocusableNode {
@@ -83,7 +83,7 @@ export declare class RenderedWorkspaceComment extends WorkspaceComment implement
     /** Returns whether this comment is movable or not. */
     isMovable(): boolean;
     /** Starts a drag on the comment. */
-    startDrag(): void;
+    startDrag(): RenderedWorkspaceComment;
     /** Drags the comment to the given location. */
     drag(newLoc: Coordinate): void;
     /** Ends the drag on the comment. */
@@ -117,5 +117,10 @@ export declare class RenderedWorkspaceComment extends WorkspaceComment implement
     onNodeBlur(): void;
     /** See IFocusableNode.canBeFocused. */
     canBeFocused(): boolean;
+    /**
+     * Handles the user acting on this comment via keyboard navigation.
+     * Expands the comment and focuses its editor.
+     */
+    performAction(): void;
 }
 //# sourceMappingURL=rendered_workspace_comment.d.ts.map

package/core/comments/workspace_comment.d.ts

@@ -4,8 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Coordinate } from '../utils/coordinate.js';
-import { Size } from '../utils/size.js';
-import { Workspace } from '../workspace.js';
+import type { Size } from '../utils/size.js';
+import type { Workspace } from '../workspace.js';
 export declare class WorkspaceComment {
     readonly workspace: Workspace;
     /** The unique identifier for this comment. */

package/core/common.d.ts

@@ -4,9 +4,9 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Block } from './block.js';
-import { BlockDefinition } from './blocks.js';
+import type { BlockDefinition } from './blocks.js';
 import type { Connection } from './connection.js';
-import { ISelectable } from './interfaces/i_selectable.js';
+import type { ISelectable } from './interfaces/i_selectable.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
@@ -33,6 +33,13 @@ export declare function registerWorkspace(workspace: Workspace): void;
  *
  * @param workspace
  */
+export declare function unregisterWorkspace(workspace: Workspace): void;
+/**
+ * Unregister a workspace from the workspace db.
+ *
+ * @deprecated v13: use Blockly.common.unregisterWorkspace
+ * @param workspace
+ */
 export declare function unregisterWorkpace(workspace: Workspace): void;
 /**
  * Returns the last used top level workspace (based on focus).  Try not to use
@@ -79,7 +86,7 @@ export declare function fireSelectedEvent(newSelection: ISelectable | null): voi
  *
  * @returns The parent container.
  */
-export declare function getParentContainer(): Element | null;
+export declare function getParentContainer(workspace?: Workspace): Element | null;
 /**
  * Set the parent container.  This is the container element that the WidgetDiv,
  * DropDownDiv, and Tooltip are rendered into the first time `Blockly.inject`

package/core/component_manager.d.ts

@@ -12,12 +12,14 @@ import type { IAutoHideable } from './interfaces/i_autohideable.js';
 import type { IComponent } from './interfaces/i_component.js';
 import type { IDeleteArea } from './interfaces/i_delete_area.js';
 import type { IDragTarget } from './interfaces/i_drag_target.js';
+import type { IFocusableNode } from './interfaces/i_focusable_node.js';
 import type { IPositionable } from './interfaces/i_positionable.js';
 declare class Capability<_T> {
     static POSITIONABLE: Capability<IPositionable>;
     static DRAG_TARGET: Capability<IDragTarget>;
     static DELETE_AREA: Capability<IDeleteArea>;
     static AUTOHIDEABLE: Capability<IAutoHideable>;
+    static FOCUSABLE: Capability<IFocusableNode>;
     private readonly name;
     /** @param name The name of the component capability. */
     constructor(name: string);

package/core/config.d.ts

@@ -4,21 +4,47 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 /**
- * All the values that we expect developers to be able to change
- * before injecting Blockly.
+ * Object holding all the values on Blockly that we expect developers to be
+ * able to change.
  */
-interface Config {
+export declare const config: {
+    /**
+     * Number of pixels the mouse must move before a drag starts.
+     *
+     */
     dragRadius: number;
+    /**
+     * Number of pixels the mouse must move before a drag/scroll starts from the
+     * flyout.  Because the drag-intention is determined when this is reached, it
+     * is larger than dragRadius so that the drag-direction is clearer.
+     *
+     */
     flyoutDragRadius: number;
+    /**
+     * Maximum misalignment between connections for them to snap together.
+     * Default is 28.
+     *
+     */
     snapRadius: number;
+    /**
+     * Maximum misalignment between connections for them to snap together.
+     * This should be the same as the snap radius.
+     * Default is 28.
+     *
+     */
+    connectingSnapRadius: number;
+    /**
+     * How much to prefer staying connected to the current connection over moving
+     * to a new connection.  The current previewed connection is considered to be
+     * this much closer to the matching connection on the block than it actually
+     * is.
+     *
+     */
     currentConnectionPreference: number;
+    /**
+     * Delay in ms between trigger and bumping unconnected block out of alignment.
+     *
+     */
     bumpDelay: number;
-    connectingSnapRadius: number;
-}
-/**
- * Object holding all the values on Blockly that we expect developers to be
- * able to change.
- */
-export declare const config: Config;
-export {};
+};
 //# sourceMappingURL=config.d.ts.map