blockly 9.3.2 → 10.0.0-beta.0

package/core/widgetdiv.d.ts

@@ -65,4 +65,9 @@ export declare function hideIfOwner(oldOwner: unknown): void;
  * @internal
  */
 export declare function positionWithAnchor(viewportBBox: Rect, anchorBBox: Rect, widgetSize: Size, rtl: boolean): void;
+/**
+ * Reposition the widget div if the owner of it says to.
+ * If the owner isn't a field, just give up and hide it.
+ */
+export declare function repositionForWindowResize(): void;
 //# sourceMappingURL=widgetdiv.d.ts.map

package/core/workspace.d.ts

@@ -91,8 +91,6 @@ export declare class Workspace implements IASTNodeLocation {
     /**
      * Dispose of this workspace.
      * Unlink from all DOM elements to prevent memory leaks.
-     *
-     * @suppress {checkTypes}
      */
     dispose(): void;
     /**
@@ -342,7 +340,7 @@ export declare class Workspace implements IASTNodeLocation {
      * @param func Function to call.
      * @returns Obsolete return value, ignore.
      */
-    addChangeListener(func: Function): Function;
+    addChangeListener(func: (e: Abstract) => void): Function;
     /**
      * Stop listening for this workspace's changes.
      *
@@ -423,6 +421,14 @@ export declare class Workspace implements IASTNodeLocation {
     setVariableMap(variableMap: VariableMap): void;
     /** Returns the map of all procedures on the workpace. */
     getProcedureMap(): IProcedureMap;
+    /**
+     * Returns the root workspace of this workspace if the workspace has
+     * parent(s).
+     *
+     * E.g. workspaces in flyouts and mini workspace bubbles have parent
+     * workspaces.
+     */
+    getRootWorkspace(): Workspace | null;
     /**
      * Find the workspace with the specified ID.
      *

package/core/workspace_comment.d.ts

@@ -15,9 +15,9 @@ export declare class WorkspaceComment {
     protected height_: number;
     protected width_: number;
     protected RTL: boolean;
-    private deletable_;
-    private movable_;
-    private editable_;
+    private deletable;
+    private movable;
+    private editable;
     protected content_: string;
     /** Whether this comment has been disposed. */
     protected disposed_: boolean;

package/core/workspace_comment_svg.d.ts

@@ -4,7 +4,6 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import './events/events_selected.js';
-import type { BlockDragSurfaceSvg } from './block_drag_surface.js';
 import type { IBoundedElement } from './interfaces/i_bounded_element.js';
 import type { IBubble } from './interfaces/i_bubble.js';
 import type { CopyData, ICopyable } from './interfaces/i_copyable.js';
@@ -27,25 +26,24 @@ export declare class WorkspaceCommentSvg extends WorkspaceComment implements IBo
     private static readonly TOP_OFFSET;
     workspace: WorkspaceSvg;
     /** Mouse up event data. */
-    private onMouseUpWrapper_;
+    private onMouseUpWrapper;
     /** Mouse move event data. */
-    private onMouseMoveWrapper_;
+    private onMouseMoveWrapper;
     /** Whether event handlers have been initialized. */
-    private eventsInit_;
-    private textarea_;
-    private svgRectTarget_;
-    private svgHandleTarget_;
-    private foreignObject_;
-    private resizeGroup_;
-    private deleteGroup_;
-    private deleteIconBorder_;
-    private focused_;
-    private autoLayout_;
-    private readonly svgGroup_;
+    private eventsInit;
+    private textarea;
+    private svgRectTarget;
+    private svgHandleTarget;
+    private foreignObject;
+    private resizeGroup;
+    private deleteGroup;
+    private deleteIconBorder;
+    private focused;
+    private autoLayout;
+    private readonly svgGroup;
     svgRect_: SVGRectElement;
     /** Whether the comment is rendered onscreen and is a part of the DOM. */
-    private rendered_;
-    private readonly useDragSurface_;
+    private rendered;
     /**
      * @param workspace The block's workspace.
      * @param content The content of this workspace comment.
@@ -74,7 +72,7 @@ export declare class WorkspaceCommentSvg extends WorkspaceComment implements IBo
      *
      * @param e Pointer down event.
      */
-    private pathMouseDown_;
+    private pathMouseDown;
     /**
      * Show the context menu for this workspace comment.
      *
@@ -147,23 +145,12 @@ export declare class WorkspaceCommentSvg extends WorkspaceComment implements IBo
      */
     translate(x: number, y: number): void;
     /**
-     * Move this comment to its workspace's drag surface, accounting for
-     * positioning.  Generally should be called at the same time as
-     * setDragging(true).  Does nothing if useDragSurface_ is false.
+     * Move this comment during a drag.
      *
-     * @internal
-     */
-    moveToDragSurface(): void;
-    /**
-     * Move this comment during a drag, taking into account whether we are using a
-     * drag surface to translate blocks.
-     *
-     * @param dragSurface The surface that carries rendered items during a drag,
-     *     or null if no drag surface is in use.
      * @param newLoc The location to translate to, in workspace coordinates.
      * @internal
      */
-    moveDuringDrag(dragSurface: BlockDragSurfaceSvg, newLoc: Coordinate): void;
+    moveDuringDrag(newLoc: Coordinate): void;
     /**
      * Move the bubble group to the specified location in workspace coordinates.
      *
@@ -176,7 +163,7 @@ export declare class WorkspaceCommentSvg extends WorkspaceComment implements IBo
      * Clear the comment of transform="..." attributes.
      * Used when the comment is switching from 3d to 2d transform or vice versa.
      */
-    private clearTransformAttributes_;
+    private clearTransformAttributes;
     /**
      * Returns the coordinates of a bounding box describing the dimensions of this
      * comment.
@@ -286,64 +273,64 @@ export declare class WorkspaceCommentSvg extends WorkspaceComment implements IBo
      *
      * @returns The top-level node of the editor.
      */
-    private createEditor_;
+    private createEditor;
     /** Add the resize icon to the DOM */
-    private addResizeDom_;
+    private addResizeDom;
     /** Add the delete icon to the DOM */
-    private addDeleteDom_;
+    private addDeleteDom;
     /**
      * Handle a pointerdown on comment's resize corner.
      *
      * @param e Pointer down event.
      */
-    private resizeMouseDown_;
+    private resizeMouseDown;
     /**
      * Handle a pointerdown on comment's delete icon.
      *
      * @param e Pointer down event.
      */
-    private deleteMouseDown_;
+    private deleteMouseDown;
     /**
      * Handle a pointerout on comment's delete icon.
      *
      * @param _e Pointer out event.
      */
-    private deleteMouseOut_;
+    private deleteMouseOut;
     /**
      * Handle a pointerup on comment's delete icon.
      *
      * @param e Pointer up event.
      */
-    private deleteMouseUp_;
+    private deleteMouseUp;
     /** Stop binding to the global pointerup and pointermove events. */
-    private unbindDragEvents_;
+    private unbindDragEvents;
     /**
      * Handle a pointerup event while dragging a comment's border or resize
      * handle.
      *
      * @param _e Pointer up event.
      */
-    private resizeMouseUp_;
+    private resizeMouseUp;
     /**
      * Resize this comment to follow the pointer.
      *
      * @param e Pointer move event.
      */
-    private resizeMouseMove_;
+    private resizeMouseMove;
     /**
      * Callback function triggered when the comment has resized.
      * Resize the text area accordingly.
      */
-    private resizeComment_;
+    private resizeComment;
     /**
      * Set size
      *
      * @param width width of the container
      * @param height height of the container
      */
-    private setSize_;
+    private setSize;
     /** Dispose of any rendered comment components. */
-    private disposeInternal_;
+    private disposeInternal;
     /**
      * Set the focus on the text area.
      *

package/core/workspace_dragger.d.ts

@@ -8,9 +8,7 @@ import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for a workspace dragger.  It moves the workspace around when it is
  * being dragged by a mouse or touch.
- * Note that the workspace itself manages whether or not it has a drag surface
- * and how to do translations based on that.  This simply passes the right
- * commands based on events.
+ *
  */
 export declare class WorkspaceDragger {
     private workspace;
@@ -22,7 +20,6 @@ export declare class WorkspaceDragger {
     /**
      * Sever all links from this object.
      *
-     * @suppress {checkTypes}
      * @internal
      */
     dispose(): void;

package/core/workspace_svg.d.ts

@@ -7,7 +7,6 @@ import './events/events_block_create.js';
 import './events/events_theme_change.js';
 import './events/events_viewport.js';
 import type { Block } from './block.js';
-import type { BlockDragSurfaceSvg } from './block_drag_surface.js';
 import type { BlockSvg } from './block_svg.js';
 import * as browserEvents from './browser_events.js';
 import { ComponentManager } from './component_manager.js';
@@ -40,7 +39,6 @@ import type { VariableModel } from './variable_model.js';
 import { Workspace } from './workspace.js';
 import { WorkspaceAudio } from './workspace_audio.js';
 import { WorkspaceComment } from './workspace_comment.js';
-import type { WorkspaceDragSurfaceSvg } from './workspace_drag_surface_svg.js';
 import { ZoomControls } from './zoom_controls.js';
 import { ContextMenuOption } from './contextmenu_registry.js';
 /**
@@ -164,22 +162,6 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      * @internal
      */
     currentGesture_: Gesture | null;
-    /** This workspace's surface for dragging blocks, if it exists. */
-    private readonly blockDragSurface;
-    /** This workspace's drag surface, if it exists. */
-    private readonly workspaceDragSurface;
-    /**
-     * Whether to move workspace to the drag surface when it is dragged.
-     * True if it should move, false if it should be translated directly.
-     */
-    private readonly useWorkspaceDragSurface;
-    /**
-     * Whether the drag surface is actively in use. When true, calls to
-     * translate will translate the drag surface instead of the translating the
-     * workspace directly.
-     * This is set to true in setupDragSurface and to false in resetDragSurface.
-     */
-    private isDragSurfaceActive;
     /**
      * The first parent div with 'injectionDiv' in the name, or null if not set.
      * Access this with getInjectionDiv.
@@ -256,10 +238,8 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
     zoomControls_: ZoomControls | null;
     /**
      * @param options Dictionary of options.
-     * @param opt_blockDragSurface Drag surface for blocks.
-     * @param opt_wsDragSurface Drag surface for the workspace.
      */
-    constructor(options: Options, opt_blockDragSurface?: BlockDragSurfaceSvg, opt_wsDragSurface?: WorkspaceDragSurfaceSvg);
+    constructor(options: Options);
     /**
      * Get the marker manager for this workspace.
      *
@@ -428,8 +408,6 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
     /**
      * Dispose of this workspace.
      * Unlink from all DOM elements to prevent memory leaks.
-     *
-     * @suppress {checkTypes}
      */
     dispose(): void;
     /**
@@ -545,29 +523,6 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      *     the Blockly div.
      */
     translate(x: number, y: number): void;
-    /**
-     * Called at the end of a workspace drag to take the contents
-     * out of the drag surface and put them back into the workspace SVG.
-     * Does nothing if the workspace drag surface is not enabled.
-     *
-     * @internal
-     */
-    resetDragSurface(): void;
-    /**
-     * Called at the beginning of a workspace drag to move contents of
-     * the workspace to the drag surface.
-     * Does nothing if the drag surface is not enabled.
-     *
-     * @internal
-     */
-    setupDragSurface(): void;
-    /**
-     * Gets the drag surface blocks are moved to when a drag is started.
-     *
-     * @returns This workspace's block drag surface, if one is in use.
-     * @internal
-     */
-    getBlockDragSurface(): BlockDragSurfaceSvg | null;
     /**
      * Returns the horizontal offset of the workspace.
      * Intended for LTR/RTL compatibility in XML.
@@ -617,8 +572,6 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      *
      * @param xmlComment XML workspace comment element.
      * @returns The pasted workspace comment.
-     * @suppress {checkTypes} Suppress checks while workspace comments are not
-     * bundled in.
      */
     private pasteWorkspaceComment_;
     /**
@@ -878,6 +831,7 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      * @param comment comment to remove.
      */
     removeTopComment(comment: WorkspaceComment): void;
+    getRootWorkspace(): WorkspaceSvg | null;
     /**
      * Adds a bounded element to the list of top bounded elements.
      *
@@ -999,9 +953,18 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
     /**
      * Close tooltips, context menus, dropdown selections, etc.
      *
-     * @param opt_onlyClosePopups Whether only popups should be closed.
+     * @param onlyClosePopups Whether only popups should be closed. Defaults to
+     *     false.
+     */
+    hideChaff(onlyClosePopups?: boolean): void;
+    /**
+     * Hide any autohideable components (like flyout, trashcan, and any
+     * user-registered components).
+     *
+     * @param onlyClosePopups Whether only popups should be closed. Defaults to
+     *     false.
      */
-    hideChaff(opt_onlyClosePopups?: boolean): void;
+    hideComponents(onlyClosePopups?: boolean): void;
     /**
      * Sets the X/Y translations of a top level workspace.
      *

package/core/xml.d.ts

@@ -56,16 +56,6 @@ export declare function domToText(dom: Node): string;
  * @returns Text representation.
  */
 export declare function domToPrettyText(dom: Node): string;
-/**
- * Converts an XML string into a DOM structure.
- *
- * @param text An XML string.
- * @returns A DOM object representing the singular child of the document
- *     element.
- * @throws if the text doesn't parse.
- * @deprecated Moved to core/utils/xml.js.
- */
-export declare function textToDom(text: string): Element;
 /**
  * Clear the given workspace then decode an XML DOM and
  * create blocks on the workspace.
@@ -81,8 +71,6 @@ export declare function clearWorkspaceAndLoadFromXml(xml: Element, workspace: Wo
  * @param xml XML DOM.
  * @param workspace The workspace.
  * @returns An array containing new block IDs.
- * @suppress {strictModuleDepCheck} Suppress module check while workspace
- * comments are not bundled in.
  */
 export declare function domToWorkspace(xml: Element, workspace: Workspace): string[];
 /**

package/core-browser.js

@@ -22,6 +22,5 @@
 /* eslint-disable */
 'use strict';
 
-
 return Blockly;
 }));

package/core.js

@@ -14,7 +14,6 @@
 /* eslint-disable */
 'use strict';
 
-
 // Override textToDomDocument and provide Node.js alternatives to DOMParser and
 // XMLSerializer.
 if (typeof globalThis.document !== 'object') {