blockly 11.1.0 → 11.2.0-beta.0

package/core/interfaces/i_toolbox.d.ts

@@ -3,11 +3,11 @@
  * Copyright 2020 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { IRegistrable } from './i_registrable.js';
-import type { IToolboxItem } from './i_toolbox_item.js';
 import type { ToolboxInfo } from '../utils/toolbox.js';
-import type { IFlyout } from './i_flyout.js';
 import type { WorkspaceSvg } from '../workspace_svg.js';
+import type { IFlyout } from './i_flyout.js';
+import type { IRegistrable } from './i_registrable.js';
+import type { IToolboxItem } from './i_toolbox_item.js';
 /**
  * Interface for a toolbox.
  */

package/core/keyboard_nav/ast_node.d.ts

@@ -12,11 +12,11 @@
 import { Block } from '../block.js';
 import type { Connection } from '../connection.js';
 import type { Field } from '../field.js';
+import { FlyoutButton } from '../flyout_button.js';
 import type { Input } from '../inputs/input.js';
 import type { IASTNodeLocation } from '../interfaces/i_ast_node_location.js';
 import { Coordinate } from '../utils/coordinate.js';
 import type { Workspace } from '../workspace.js';
-import { FlyoutButton } from '../flyout_button.js';
 /**
  * Class for an AST node.
  * It is recommended that you use one of the createNode methods instead of

package/core/layer_manager.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2023 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { WorkspaceSvg } from './workspace_svg.js';
 import { IRenderedElement } from './interfaces/i_rendered_element.js';
 import { Coordinate } from './utils/coordinate.js';
+import { WorkspaceSvg } from './workspace_svg.js';
 /** @internal */
 export declare class LayerManager {
     private workspace;

package/core/layers.d.ts

@@ -6,13 +6,11 @@
 /**
  * The layer to place blocks on.
  *
- * @internal
  */
 export declare const BLOCK = 50;
 /**
  * The layer to place bubbles on.
  *
- * @internal
  */
 export declare const BUBBLE = 100;
 //# sourceMappingURL=layers.d.ts.map

package/core/procedures.d.ts

@@ -7,11 +7,11 @@ import './events/events_block_change.js';
 import type { Block } from './block.js';
 import type { Abstract } from './events/events_abstract.js';
 import { Field } from './field.js';
+import { ProcedureTuple } from './interfaces/i_legacy_procedure_blocks.js';
 import { IParameterModel } from './interfaces/i_parameter_model.js';
+import { IProcedureBlock, isProcedureBlock } from './interfaces/i_procedure_block.js';
 import { IProcedureMap } from './interfaces/i_procedure_map.js';
 import { IProcedureModel } from './interfaces/i_procedure_model.js';
-import { IProcedureBlock, isProcedureBlock } from './interfaces/i_procedure_block.js';
-import { ProcedureTuple } from './interfaces/i_legacy_procedure_blocks.js';
 import { ObservableProcedureMap } from './observable_procedure_map.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
@@ -101,5 +101,5 @@ export declare function mutateCallers(defBlock: Block): void;
  * @returns The procedure definition block, or null not found.
  */
 export declare function getDefinition(name: string, workspace: Workspace): Block | null;
-export { ObservableProcedureMap, IParameterModel, IProcedureBlock, isProcedureBlock, IProcedureMap, IProcedureModel, ProcedureTuple, };
+export { IParameterModel, IProcedureBlock, IProcedureMap, IProcedureModel, isProcedureBlock, ObservableProcedureMap, ProcedureTuple, };
 //# sourceMappingURL=procedures.d.ts.map

package/core/registry.d.ts

@@ -5,11 +5,15 @@
  */
 import type { Abstract } from './events/events_abstract.js';
 import type { Field } from './field.js';
+import type { Input } from './inputs/input.js';
 import type { IConnectionChecker } from './interfaces/i_connection_checker.js';
+import type { IConnectionPreviewer } from './interfaces/i_connection_previewer.js';
+import type { ICopyable } from './interfaces/i_copyable.js';
+import type { IDragger } from './interfaces/i_dragger.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
-import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
 import type { IIcon } from './interfaces/i_icon.js';
-import type { Input } from './inputs/input.js';
+import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
+import type { IPaster } from './interfaces/i_paster.js';
 import type { ISerializer } from './interfaces/i_serializer.js';
 import type { IToolbox } from './interfaces/i_toolbox.js';
 import type { Cursor } from './keyboard_nav/cursor.js';
@@ -17,10 +21,6 @@ import type { Options } from './options.js';
 import type { Renderer } from './renderers/common/renderer.js';
 import type { Theme } from './theme.js';
 import type { ToolboxItem } from './toolbox/toolbox_item.js';
-import type { IPaster } from './interfaces/i_paster.js';
-import type { ICopyable } from './interfaces/i_copyable.js';
-import type { IConnectionPreviewer } from './interfaces/i_connection_previewer.js';
-import type { IDragger } from './interfaces/i_dragger.js';
 export declare const TEST_ONLY: {
     typeMap: {
         [key: string]: {

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

@@ -39,7 +39,7 @@ import { Renderer } from './renderer.js';
  * @param rendererClass The new renderer class to register.
  * @throws {Error} if a renderer with the same name has already been registered.
  */
-export declare function register(name: string, rendererClass: Function): void;
+export declare function register(name: string, rendererClass: new (name: string) => Renderer): void;
 /**
  * Unregisters the renderer registered with the given name.
  *
@@ -59,33 +59,6 @@ export declare function unregister(name: string): void;
 export declare function init(name: string, theme: Theme, opt_rendererOverrides?: {
     [rendererConstant: string]: any;
 }): Renderer;
-export { BottomRow };
-export { Connection };
-export { Drawer };
-export { ExternalValueInput };
-export { Field };
-export { Hat };
-export { Icon };
-export { InRowSpacer };
-export { InlineInput };
-export { InputConnection };
-export { InputRow };
-export { IPathObject };
-export { JaggedEdge };
-export { MarkerSvg };
-export { Measurable };
-export { NextConnection };
-export { OutputConnection };
-export { PathObject };
-export { PreviousConnection };
-export { Renderer };
-export { RenderInfo };
-export { RoundCorner };
-export { Row };
-export { SpacerRow };
-export { SquareCorner };
-export { StatementInput };
-export { TopRow };
-export { Types };
-export { OutsideCorners, InsideCorners, StartHat, Notch, PuzzleTab, JaggedTeeth, BaseShape, DynamicShape, ConstantProvider, } from './constants.js';
+export { BottomRow, Connection, Drawer, ExternalValueInput, Field, Hat, Icon, InlineInput, InputConnection, InputRow, InRowSpacer, IPathObject, JaggedEdge, MarkerSvg, Measurable, NextConnection, OutputConnection, PathObject, PreviousConnection, Renderer, RenderInfo, RoundCorner, Row, SpacerRow, SquareCorner, StatementInput, TopRow, Types, };
+export { BaseShape, ConstantProvider, DynamicShape, InsideCorners, JaggedTeeth, Notch, OutsideCorners, PuzzleTab, StartHat, } from './constants.js';
 //# sourceMappingURL=block_rendering.d.ts.map

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

@@ -3,11 +3,11 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { BlockStyle } from '../../theme.js';
 import type { BlockSvg } from '../../block_svg.js';
-import type { ConstantProvider } from './constants.js';
 import type { RenderedConnection } from '../../rendered_connection.js';
+import type { BlockStyle } from '../../theme.js';
 import type { Coordinate } from '../../utils/coordinate.js';
+import type { ConstantProvider } from './constants.js';
 /**
  * An interface for a block's path object.
  *

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

@@ -8,6 +8,7 @@ import { Input } from '../../inputs/input.js';
 import type { RenderedConnection } from '../../rendered_connection.js';
 import type { Measurable } from '../measurables/base.js';
 import { BottomRow } from '../measurables/bottom_row.js';
+import { Connection } from '../measurables/connection.js';
 import { InputRow } from '../measurables/input_row.js';
 import { OutputConnection } from '../measurables/output_connection.js';
 import type { Row } from '../measurables/row.js';
@@ -15,7 +16,6 @@ import { SpacerRow } from '../measurables/spacer_row.js';
 import { TopRow } from '../measurables/top_row.js';
 import type { ConstantProvider } from './constants.js';
 import type { Renderer } from './renderer.js';
-import { Connection } from '../measurables/connection.js';
 /**
  * An object containing all sizing information needed to draw this block.
  *

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

@@ -15,13 +15,13 @@ import type { ConstantProvider, Notch, PuzzleTab } from './constants.js';
  * SVG.
  */
 export declare class MarkerSvg {
-    private readonly workspace;
-    private readonly marker;
+    protected readonly workspace: WorkspaceSvg;
+    protected readonly marker: Marker;
     /**
      * The workspace, field, or block that the marker SVG element should be
      * attached to.
      */
-    private parent;
+    protected parent: IASTNodeLocationSvg | null;
     /** The current SVG element for the marker. */
     currentMarkerSvg: SVGElement | null;
     colour_: string;
@@ -94,7 +94,7 @@ export declare class MarkerSvg {
      *
      * @param curNode The node to draw the marker for.
      */
-    private showWithBlockPrevOutput;
+    protected showWithBlockPrevOutput(curNode: ASTNode): void;
     /**
      * Position and display the marker for a block.
      *
@@ -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.
      */
-    private fireMarkerEvent;
+    protected fireMarkerEvent(oldNode: ASTNode, curNode: ASTNode): void;
     /**
      * Get the properties to make a marker blink.
      *

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

@@ -5,8 +5,8 @@
  */
 import type { RenderedConnection } from '../../rendered_connection.js';
 import type { Theme } from '../../theme.js';
-import { ConstantProvider as BaseConstantProvider } from '../common/constants.js';
 import type { Shape } from '../common/constants.js';
+import { ConstantProvider as BaseConstantProvider } from '../common/constants.js';
 /** An object containing sizing and path information about inside corners. */
 export interface InsideCorners {
     width: number;

package/core/serialization/procedures.d.ts

@@ -38,7 +38,7 @@ interface ProcedureModelConstructor<ProcedureModel extends IProcedureModel> {
      * @param workspace The workspace to load the procedure model into.
      * @returns The constructed procedure model.
      */
-    loadState(state: Object, workspace: Workspace): ProcedureModel;
+    loadState(state: object, workspace: Workspace): ProcedureModel;
 }
 /**
  * A newable signature for an IParameterModel.
@@ -56,7 +56,7 @@ interface ParameterModelConstructor<ParameterModel extends IParameterModel> {
      * @param workspace The workspace to load the parameter model into.
      * @returns The constructed parameter model.
      */
-    loadState(state: Object, workspace: Workspace): ParameterModel;
+    loadState(state: object, workspace: Workspace): ParameterModel;
 }
 /**
  * Serializes the given IProcedureModel to JSON.

package/core/serialization/workspace_comments.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2024 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { WorkspaceComment } from '../comments/workspace_comment.js';
 import { ISerializer } from '../interfaces/i_serializer.js';
 import { Workspace } from '../workspace.js';
-import type { WorkspaceComment } from '../comments/workspace_comment.js';
 export interface State {
     id?: string;
     text?: string;

package/core/serialization.d.ts

@@ -6,14 +6,14 @@
 /**
  * Serialization methods.
  */
+import { ISerializer } from './interfaces/i_serializer.js';
 import * as blocks from './serialization/blocks.js';
 import * as exceptions from './serialization/exceptions.js';
 import * as priorities from './serialization/priorities.js';
 import * as procedures from './serialization/procedures.js';
 import * as registry from './serialization/registry.js';
 import * as variables from './serialization/variables.js';
-import * as workspaces from './serialization/workspaces.js';
 import * as workspaceComments from './serialization/workspace_comments.js';
-import { ISerializer } from './interfaces/i_serializer.js';
-export { blocks, exceptions, priorities, procedures, registry, variables, workspaces, workspaceComments, ISerializer, };
+import * as workspaces from './serialization/workspaces.js';
+export { blocks, exceptions, ISerializer, priorities, procedures, registry, variables, workspaceComments, workspaces, };
 //# sourceMappingURL=serialization.d.ts.map

package/core/toolbox/toolbox.d.ts

@@ -3,14 +3,9 @@
  * Copyright 2020 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Toolbox from whence to create blocks.
- *
- * @class
- */
-import '../events/events_toolbox_item_select.js';
 import * as browserEvents from '../browser_events.js';
 import { DeleteArea } from '../delete_area.js';
+import '../events/events_toolbox_item_select.js';
 import type { IAutoHideable } from '../interfaces/i_autohideable.js';
 import type { IDraggable } from '../interfaces/i_draggable.js';
 import type { IFlyout } from '../interfaces/i_flyout.js';

package/core/tooltip.d.ts

@@ -11,7 +11,7 @@
  */
 export type TipInfo = string | {
     tooltip: any;
-} | (() => TipInfo | string | Function);
+} | (() => TipInfo | string);
 /**
  * A function that renders custom tooltip UI.
  * 1st parameter: the div element to render content into.

package/core/trashcan.d.ts

@@ -3,13 +3,8 @@
  * Copyright 2011 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Object representing a trash can icon.
- *
- * @class
- */
-import './events/events_trashcan_open.js';
 import { DeleteArea } from './delete_area.js';
+import './events/events_trashcan_open.js';
 import type { IAutoHideable } from './interfaces/i_autohideable.js';
 import type { IDraggable } from './interfaces/i_draggable.js';
 import type { IFlyout } from './interfaces/i_flyout.js';

package/core/utils/size.d.ts

@@ -29,7 +29,7 @@ export declare class Size {
      * @returns True iff the sizes have equal widths and equal heights, or if both
      *     are null.
      */
-    static equals(a: Size | null, b: Size | null): boolean;
+    static equals(a?: Size | null, b?: Size | null): boolean;
     /**
      * Returns a new size with the maximum width and height values out of both
      * sizes.

package/core/variables_dynamic.d.ts

@@ -3,9 +3,9 @@
  * Copyright 2017 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { FlyoutButton } from './flyout_button.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
-import type { FlyoutButton } from './flyout_button.js';
 /**
  * String for use in the "custom" attribute of a category in toolbox XML.
  * This string indicates that the category should be dynamically populated with

package/core/workspace.d.ts

@@ -10,16 +10,16 @@
  */
 import './connection_checker.js';
 import type { Block } from './block.js';
+import { WorkspaceComment } from './comments/workspace_comment.js';
 import type { ConnectionDB } from './connection_db.js';
 import type { Abstract } from './events/events_abstract.js';
 import type { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
 import type { IConnectionChecker } from './interfaces/i_connection_checker.js';
+import { IProcedureMap } from './interfaces/i_procedure_map.js';
 import { Options } from './options.js';
 import type * as toolbox from './utils/toolbox.js';
 import { VariableMap } from './variable_map.js';
 import type { VariableModel } from './variable_model.js';
-import { WorkspaceComment } from './comments/workspace_comment.js';
-import { IProcedureMap } from './interfaces/i_procedure_map.js';
 /**
  * Class for a workspace.  This is a data structure that contains blocks.
  * There is no UI, and can be created headlessly.
@@ -353,13 +353,13 @@ export declare class Workspace implements IASTNodeLocation {
      * @param func Function to call.
      * @returns Obsolete return value, ignore.
      */
-    addChangeListener(func: (e: Abstract) => void): Function;
+    addChangeListener(func: (e: Abstract) => void): (e: Abstract) => void;
     /**
      * Stop listening for this workspace's changes.
      *
      * @param func Function to stop calling.
      */
-    removeChangeListener(func: Function): void;
+    removeChangeListener(func: (e: Abstract) => void): void;
     /**
      * Fire a change event.
      *
@@ -393,7 +393,6 @@ export declare class Workspace implements IASTNodeLocation {
      *
      * @param id ID of comment to find.
      * @returns The sought after comment, or null if not found.
-     * @internal
      */
     getCommentById(id: string): WorkspaceComment | null;
     /**

package/core/workspace_svg.d.ts

@@ -14,7 +14,9 @@ import './events/events_viewport.js';
 import type { Block } from './block.js';
 import type { BlockSvg } from './block_svg.js';
 import * as browserEvents from './browser_events.js';
+import { WorkspaceComment } from './comments/workspace_comment.js';
 import { ComponentManager } from './component_manager.js';
+import { ContextMenuOption } from './contextmenu_registry.js';
 import type { FlyoutButton } from './flyout_button.js';
 import { Gesture } from './gesture.js';
 import { Grid } from './grid.js';
@@ -26,6 +28,7 @@ import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
 import type { IToolbox } from './interfaces/i_toolbox.js';
 import type { Cursor } from './keyboard_nav/cursor.js';
 import type { Marker } from './keyboard_nav/marker.js';
+import { LayerManager } from './layer_manager.js';
 import { MarkerManager } from './marker_manager.js';
 import { Options } from './options.js';
 import type { Renderer } from './renderers/common/renderer.js';
@@ -42,10 +45,7 @@ import * as toolbox from './utils/toolbox.js';
 import type { VariableModel } from './variable_model.js';
 import { Workspace } from './workspace.js';
 import { WorkspaceAudio } from './workspace_audio.js';
-import { WorkspaceComment } from './comments/workspace_comment.js';
 import { ZoomControls } from './zoom_controls.js';
-import { ContextMenuOption } from './contextmenu_registry.js';
-import { LayerManager } from './layer_manager.js';
 /**
  * Class for a workspace.  This is an onscreen area with optional trashcan,
  * scrollbars, bubbles, and dragging.

package/core/xml.d.ts

@@ -4,10 +4,10 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Block } from './block.js';
+import { WorkspaceComment } from './comments/workspace_comment.js';
 import type { VariableModel } from './variable_model.js';
 import type { Workspace } from './workspace.js';
 import { WorkspaceSvg } from './workspace_svg.js';
-import { WorkspaceComment } from './comments/workspace_comment.js';
 /**
  * Encode a block tree as XML.
  *