blockly 11.0.0-beta.5 → 11.0.0-beta.7

package/core/interfaces/i_deletable.d.ts

@@ -13,5 +13,11 @@ export interface IDeletable {
      * @returns True if deletable.
      */
     isDeletable(): boolean;
+    /** Disposes of this object, cleaning up any references or DOM elements. */
+    dispose(): void;
+    /** Visually indicates that the object is pending deletion. */
+    setDeleteStyle(wouldDelete: boolean): void;
 }
+/** Returns whether the given object is an IDeletable. */
+export declare function isDeletable(obj: any): obj is IDeletable;
 //# sourceMappingURL=i_deletable.d.ts.map

package/core/interfaces/i_delete_area.d.ts

@@ -17,10 +17,9 @@ export interface IDeleteArea extends IDragTarget {
      * before onDragEnter/onDragOver/onDragExit.
      *
      * @param element The block or bubble currently being dragged.
-     * @param couldConnect Whether the element could could connect to another.
      * @returns Whether the element provided would be deleted if dropped on this
      *     area.
      */
-    wouldDelete(element: IDraggable, couldConnect: boolean): boolean;
+    wouldDelete(element: IDraggable): boolean;
 }
 //# sourceMappingURL=i_delete_area.d.ts.map

package/core/interfaces/i_draggable.d.ts

@@ -3,10 +3,54 @@
  * Copyright 2021 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { IDeletable } from './i_deletable.js';
+import { Coordinate } from '../utils/coordinate';
 /**
- * The interface for an object that can be dragged.
+ * Represents an object that can be dragged.
  */
-export interface IDraggable extends IDeletable {
+export interface IDraggable extends IDragStrategy {
+    /**
+     * Returns the current location of the draggable in workspace
+     * coordinates.
+     *
+     * @returns Coordinate of current location on workspace.
+     */
+    getRelativeToSurfaceXY(): Coordinate;
 }
+export interface IDragStrategy {
+    /** Returns true iff the element is currently movable. */
+    isMovable(): boolean;
+    /**
+     * Handles any drag startup (e.g moving elements to the front of the
+     * workspace).
+     *
+     * @param e PointerEvent that started the drag; can be used to
+     *     check modifier keys, etc.  May be missing when dragging is
+     *     triggered programatically rather than by user.
+     */
+    startDrag(e?: PointerEvent): void;
+    /**
+     * Handles moving elements to the new location, and updating any
+     * visuals based on that (e.g connection previews for blocks).
+     *
+     * @param newLoc Workspace coordinate to which the draggable has
+     *     been dragged.
+     * @param e PointerEvent that continued the drag.  Can be
+     *     used to check modifier keys, etc.
+     */
+    drag(newLoc: Coordinate, e?: PointerEvent): void;
+    /**
+     * Handles any drag cleanup, including e.g. connecting or deleting
+     * blocks.
+     *
+     * @param newLoc Workspace coordinate at which the drag finished.
+     *     been dragged.
+     * @param e PointerEvent that finished the drag.  Can be
+     *     used to check modifier keys, etc.
+     */
+    endDrag(e?: PointerEvent): void;
+    /** Moves the draggable back to where it was at the start of the drag. */
+    revertDrag(): void;
+}
+/** Returns whether the given object is an IDraggable or not. */
+export declare function isDraggable(obj: any): obj is IDraggable;
 //# sourceMappingURL=i_draggable.d.ts.map

package/core/interfaces/i_dragger.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Coordinate } from '../utils/coordinate';
+export interface IDragger {
+    /**
+     * Handles any drag startup.
+     *
+     * @param e PointerEvent that started the drag.
+     */
+    onDragStart(e: PointerEvent): void;
+    /**
+     * Handles dragging, including calculating where the element should
+     * actually be moved to.
+     *
+     * @param e PointerEvent that continued the drag.
+     * @param totalDelta The total distance, in pixels, that the mouse
+     *     has moved since the start of the drag.
+     */
+    onDrag(e: PointerEvent, totalDelta: Coordinate): void;
+    /**
+     * Handles any drag cleanup.
+     *
+     * @param e PointerEvent that finished the drag.
+     * @param totalDelta The total distance, in pixels, that the mouse
+     *     has moved since the start of the drag.
+     */
+    onDragEnd(e: PointerEvent, totalDelta: Coordinate): void;
+}
+//# sourceMappingURL=i_dragger.d.ts.map

package/core/interfaces/i_has_bubble.d.ts

@@ -7,7 +7,7 @@ export interface IHasBubble {
     /** @returns True if the bubble is currently open, false otherwise. */
     bubbleIsVisible(): boolean;
     /** Sets whether the bubble is open or not. */
-    setBubbleVisible(visible: boolean): void;
+    setBubbleVisible(visible: boolean): Promise<void>;
 }
 /** Type guard that checks whether the given object is a IHasBubble. */
 export declare function hasBubble(obj: any): obj is IHasBubble;

package/core/interfaces/i_parameter_model.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2022 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { ParameterState } from '../serialization/procedures';
 import { IProcedureModel } from './i_procedure_model';
 /**
  * A data model for a procedure.
@@ -33,5 +34,11 @@ export interface IParameterModel {
     getId(): string;
     /** Sets the procedure model this parameter is associated with. */
     setProcedureModel(model: IProcedureModel): this;
+    /**
+     * Serializes the state of the parameter to JSON.
+     *
+     * @returns JSON serializable state of the parameter.
+     */
+    saveState(): ParameterState;
 }
 //# sourceMappingURL=i_parameter_model.d.ts.map

package/core/interfaces/i_procedure_model.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2022 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { State } from '../serialization/procedures.js';
 import { IParameterModel } from './i_parameter_model.js';
 /**
  * A data model for a procedure.
@@ -48,5 +49,11 @@ export interface IProcedureModel {
      * disabled, all procedure caller blocks should be disabled as well.
      */
     getEnabled(): boolean;
+    /**
+     * Serializes the state of the procedure to JSON.
+     *
+     * @returns JSON serializable state of the procedure.
+     */
+    saveState(): State;
 }
 //# sourceMappingURL=i_procedure_model.d.ts.map

package/core/interfaces/i_selectable.d.ts

@@ -3,16 +3,18 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { IDeletable } from './i_deletable.js';
-import type { IMovable } from './i_movable.js';
+import type { Workspace } from '../workspace.js';
 /**
  * The interface for an object that is selectable.
  */
-export interface ISelectable extends IDeletable, IMovable {
+export interface ISelectable {
     id: string;
+    workspace: Workspace;
     /** Select this.  Highlight it visually. */
     select(): void;
     /** Unselect this.  Unhighlight it visually. */
     unselect(): void;
 }
+/** Checks whether the given object is an ISelectable. */
+export declare function isSelectable(obj: Object): obj is ISelectable;
 //# sourceMappingURL=i_selectable.d.ts.map

package/core/internal_constants.d.ts

@@ -9,13 +9,6 @@
  * @internal
  */
 export declare const COLLAPSE_CHARS = 30;
-/**
- * When dragging a block out of a stack, split the stack in two (true), or drag
- * out the block healing the stack (false).
- *
- * @internal
- */
-export declare const DRAG_STACK = true;
 /**
  * Lookup table for determining the opposite type of a connection.
  *

package/core/keyboard_nav/ast_node.d.ts

@@ -16,6 +16,7 @@ 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
@@ -119,6 +120,13 @@ export declare class ASTNode {
      *     on the workspace.
      */
     private navigateBetweenStacks;
+    /**
+     * Navigate between buttons and stacks of blocks on the flyout workspace.
+     *
+     * @param forward True to go forward. False to go backwards.
+     * @returns The next button, or next stack's first block, or null
+     */
+    private navigateFlyoutContents;
     /**
      * Finds the top most AST node for a given block.
      * This is either the previous connection, output connection or block
@@ -150,7 +158,7 @@ export declare class ASTNode {
      * Finds the source block of the location of this node.
      *
      * @returns The source block of the location, or null if the node is of type
-     *     workspace.
+     *     workspace or button.
      */
     getSourceBlock(): Block | null;
     /**
@@ -232,6 +240,16 @@ export declare class ASTNode {
      *     stack.
      */
     static createStackNode(topBlock: Block): ASTNode | null;
+    /**
+     * Create an AST node of type button. A button in this case refers
+     * specifically to a button in a flyout.
+     *
+     * @param button A top block has no parent and can be found in the list
+     *     returned by workspace.getTopBlocks().
+     * @returns An AST node of type stack that points to the top block on the
+     *     stack.
+     */
+    static createButtonNode(button: FlyoutButton): ASTNode | null;
     /**
      * Creates an AST node pointing to a workspace.
      *
@@ -262,7 +280,8 @@ export declare namespace ASTNode {
         NEXT = "next",
         PREVIOUS = "previous",
         STACK = "stack",
-        WORKSPACE = "workspace"
+        WORKSPACE = "workspace",
+        BUTTON = "button"
     }
 }
 export type Params = ASTNode.Params;

package/core/options.d.ts

@@ -32,6 +32,7 @@ export declare class Options {
     pathToMedia: string;
     hasCategories: boolean;
     moveOptions: MoveOptions;
+    /** @deprecated  January 2019 */
     hasScrollbars: boolean;
     hasTrashcan: boolean;
     maxTrashcanContents: number;

package/core/registry.d.ts

@@ -5,7 +5,6 @@
  */
 import type { Abstract } from './events/events_abstract.js';
 import type { Field } from './field.js';
-import type { IBlockDragger } from './interfaces/i_block_dragger.js';
 import type { IConnectionChecker } from './interfaces/i_connection_checker.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
 import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
@@ -21,6 +20,7 @@ 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]: {
@@ -58,7 +58,7 @@ export declare class Type<_T> {
     static FLYOUTS_VERTICAL_TOOLBOX: Type<IFlyout>;
     static FLYOUTS_HORIZONTAL_TOOLBOX: Type<IFlyout>;
     static METRICS_MANAGER: Type<IMetricsManager>;
-    static BLOCK_DRAGGER: Type<IBlockDragger>;
+    static DRAGGER: Type<IDragger>;
     /** @internal */
     static SERIALIZER: Type<ISerializer>;
     /** @internal */

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

@@ -38,13 +38,6 @@ export declare class Drawer {
      * required.
      */
     draw(): void;
-    /**
-     * Hide icons that were marked as hidden.
-     *
-     * @deprecated Manually hiding icons is no longer necessary. To be removed
-     *     in v11.
-     */
-    protected hideHiddenIcons_(): void;
     /**
      * Save sizing information back to the block
      * Most of the rendering information can be thrown away at the end of the

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

@@ -148,6 +148,13 @@ export declare class MarkerSvg {
      * @param curNode The node to draw the marker for.
      */
     protected showWithStack_(curNode: ASTNode): void;
+    /**
+     * Position and display the marker for a flyout button.
+     * This is a box with extra padding around the button.
+     *
+     * @param curNode The node to draw the marker for.
+     */
+    protected showWithButton_(curNode: ASTNode): void;
     /** Show the current marker. */
     protected showCurrent_(): void;
     /**************************

package/core/renderers/measurables/icon.d.ts

@@ -12,11 +12,6 @@ import { Measurable } from './base.js';
  */
 export declare class Icon extends Measurable {
     icon: BlocklyIcon;
-    /**
-     * @deprecated Will be removed in v11. Create a subclass of the Icon
-     *     measurable if this data is necessary for you.
-     */
-    isVisible: boolean;
     flipRtl: boolean;
     /**
      * An object containing information about the space an icon takes up during

package/core/serialization/priorities.d.ts

@@ -15,4 +15,6 @@ export declare const PROCEDURES = 75;
  * The priority for deserializing blocks.
  */
 export declare const BLOCKS = 50;
+/** The priority for deserializing workspace comments. */
+export declare const WORKSPACE_COMMENTS = 25;
 //# sourceMappingURL=priorities.d.ts.map

package/core/serialization/procedures.d.ts

@@ -7,63 +7,65 @@ import { IParameterModel } from '../interfaces/i_parameter_model.js';
 import { IProcedureModel } from '../interfaces/i_procedure_model.js';
 import type { ISerializer } from '../interfaces/i_serializer.js';
 import type { Workspace } from '../workspace.js';
-/**
- * Representation of a procedure data model.
- */
+/** Represents the state of a procedure model. */
 export interface State {
     id: string;
     name: string;
     returnTypes: string[] | null;
     parameters?: ParameterState[];
+    [key: string]: unknown;
 }
-/**
- * Representation of a parameter data model.
- */
+/** Represents the state of a parameter model. */
 export interface ParameterState {
     id: string;
     name: string;
     types?: string[];
+    [key: string]: unknown;
 }
 /**
  * A newable signature for an IProcedureModel.
  *
  * Refer to
- * https://www.typescriptlang.org/docs/handbook/2/generics.html#using-class-types-in-generics
+ * https://www.typescriptlang.org/docs/handbook/interfaces.html#difference-between-the-static-and-instance-sides-of-classes
  * for what is going on with this.
  */
-type ProcedureModelConstructor<ProcedureModel extends IProcedureModel> = new (workspace: Workspace, name: string, id: string) => ProcedureModel;
+interface ProcedureModelConstructor<ProcedureModel extends IProcedureModel> {
+    new (workspace: Workspace, name: string, id: string): ProcedureModel;
+    /**
+     * Deserializes the JSON state and returns a procedure model.
+     *
+     * @param state The state to deserialize.
+     * @param workspace The workspace to load the procedure model into.
+     * @returns The constructed procedure model.
+     */
+    loadState(state: Object, workspace: Workspace): ProcedureModel;
+}
 /**
  * A newable signature for an IParameterModel.
  *
  * Refer to
- * https://www.typescriptlang.org/docs/handbook/2/generics.html#using-class-types-in-generics
+ * https://www.typescriptlang.org/docs/handbook/interfaces.html#difference-between-the-static-and-instance-sides-of-classes
  * for what is going on with this.
  */
-type ParameterModelConstructor<ParameterModel extends IParameterModel> = new (workspace: Workspace, name: string, id: string) => ParameterModel;
+interface ParameterModelConstructor<ParameterModel extends IParameterModel> {
+    new (workspace: Workspace, name: string, id: string): ParameterModel;
+    /**
+     * Deserializes the JSON state and returns a parameter model.
+     *
+     * @param state The state to deserialize.
+     * @param workspace The workspace to load the parameter model into.
+     * @returns The constructed parameter model.
+     */
+    loadState(state: Object, workspace: Workspace): ParameterModel;
+}
 /**
  * Serializes the given IProcedureModel to JSON.
- *
- * @internal
  */
 export declare function saveProcedure(proc: IProcedureModel): State;
-/**
- * Serializes the given IParameterModel to JSON.
- *
- * @internal
- */
-export declare function saveParameter(param: IParameterModel): ParameterState;
 /**
  * Deserializes the given procedure model State from JSON.
- *
- * @internal
  */
 export declare function loadProcedure<ProcedureModel extends IProcedureModel, ParameterModel extends IParameterModel>(procedureModelClass: ProcedureModelConstructor<ProcedureModel>, parameterModelClass: ParameterModelConstructor<ParameterModel>, state: State, workspace: Workspace): ProcedureModel;
-/**
- * Deserializes the given ParameterState from JSON.
- *
- * @internal
- */
-export declare function loadParameter<ParameterModel extends IParameterModel>(parameterModelClass: ParameterModelConstructor<ParameterModel>, state: ParameterState, workspace: Workspace): ParameterModel;
 /** Serializer for saving and loading procedure state. */
 export declare class ProcedureSerializer<ProcedureModel extends IProcedureModel, ParameterModel extends IParameterModel> implements ISerializer {
     private readonly procedureModelClass;

package/core/serialization/workspace_comments.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ISerializer } from '../interfaces/i_serializer.js';
+import { Workspace } from '../workspace.js';
+import { WorkspaceComment } from '../comments/workspace_comment.js';
+export interface State {
+    id?: string;
+    text?: string;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    collapsed?: boolean;
+    editable?: boolean;
+    movable?: boolean;
+    deletable?: boolean;
+}
+/** Serializes the state of the given comment to JSON. */
+export declare function save(comment: WorkspaceComment, { addCoordinates, saveIds, }?: {
+    addCoordinates?: boolean;
+    saveIds?: boolean;
+}): State;
+/** Appends the comment defined by the given state to the given workspace. */
+export declare function append(state: State, workspace: Workspace, { recordUndo }?: {
+    recordUndo?: boolean;
+}): WorkspaceComment;
+/** Serializer for saving and loading workspace comment state. */
+export declare class WorkspaceCommentSerializer implements ISerializer {
+    priority: number;
+    /**
+     * Returns the state of all workspace comments in the given workspace.
+     */
+    save(workspace: Workspace): State[] | null;
+    /**
+     * Deserializes the comments defined by the given state into the given
+     * workspace.
+     */
+    load(state: State[], workspace: Workspace): void;
+    /** Disposes of any comments that exist on the given workspace. */
+    clear(workspace: Workspace): void;
+}
+//# sourceMappingURL=workspace_comments.d.ts.map

package/core/serialization.d.ts

@@ -13,6 +13,7 @@ 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, ISerializer, };
+export { blocks, exceptions, priorities, procedures, registry, variables, workspaces, workspaceComments, ISerializer, };
 //# sourceMappingURL=serialization.d.ts.map

package/core/toolbox/toolbox.d.ts

@@ -187,11 +187,10 @@ export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeybo
      * before onDragEnter/onDragOver/onDragExit.
      *
      * @param element The block or bubble currently being dragged.
-     * @param _couldConnect Whether the element could could connect to another.
      * @returns Whether the element provided would be deleted if dropped on this
      *     area.
      */
-    wouldDelete(element: IDraggable, _couldConnect: boolean): boolean;
+    wouldDelete(element: IDraggable): boolean;
     /**
      * Handles when a cursor with a block or bubble enters this drag target.
      *

package/core/utils/dom.d.ts

@@ -86,15 +86,6 @@ export declare function removeNode(node: Node | null): Node | null;
  * @param refNode Existing element to precede new node.
  */
 export declare function insertAfter(newNode: Element, refNode: Element): void;
-/**
- * Whether a node contains another node.
- *
- * @param parent The node that should contain the other node.
- * @param descendant The node to test presence of.
- * @returns Whether the parent node contains the descendant node.
- * @deprecated Use native 'contains' DOM method.
- */
-export declare function containsNode(parent: Node, descendant: Node): boolean;
 /**
  * Sets the CSS transform property on an element. This function sets the
  * non-vendor-prefixed and vendor-prefixed versions for backwards compatibility

package/core/utils/keycodes.d.ts

@@ -16,7 +16,7 @@ export declare enum KeyCodes {
     MAC_ENTER = 3,
     BACKSPACE = 8,
     TAB = 9,
-    NUM_CENTER = 12,
+    NUM_CENTER = 12,// NUMLOCK on FF/Safari Mac
     ENTER = 13,
     SHIFT = 16,
     CTRL = 17,
@@ -25,18 +25,18 @@ export declare enum KeyCodes {
     CAPS_LOCK = 20,
     ESC = 27,
     SPACE = 32,
-    PAGE_UP = 33,
-    PAGE_DOWN = 34,
-    END = 35,
-    HOME = 36,
-    LEFT = 37,
-    UP = 38,
-    RIGHT = 39,
-    DOWN = 40,
-    PLUS_SIGN = 43,
+    PAGE_UP = 33,// also NUM_NORTH_EAST
+    PAGE_DOWN = 34,// also NUM_SOUTH_EAST
+    END = 35,// also NUM_SOUTH_WEST
+    HOME = 36,// also NUM_NORTH_WEST
+    LEFT = 37,// also NUM_WEST
+    UP = 38,// also NUM_NORTH
+    RIGHT = 39,// also NUM_EAST
+    DOWN = 40,// also NUM_SOUTH
+    PLUS_SIGN = 43,// NOT numpad plus
     PRINT_SCREEN = 44,
-    INSERT = 45,
-    DELETE = 46,
+    INSERT = 45,// also NUM_INSERT
+    DELETE = 46,// also NUM_DELETE
     ZERO = 48,
     ONE = 49,
     TWO = 50,
@@ -47,11 +47,11 @@ export declare enum KeyCodes {
     SEVEN = 55,
     EIGHT = 56,
     NINE = 57,
-    FF_SEMICOLON = 59,
-    FF_EQUALS = 61,
-    FF_DASH = 173,
+    FF_SEMICOLON = 59,// Firefox (Gecko) fires this for semicolon instead of 186
+    FF_EQUALS = 61,// Firefox (Gecko) fires this for equals instead of 187
+    FF_DASH = 173,// Firefox (Gecko) fires this for dash instead of 189
     FF_HASH = 163,
-    QUESTION_MARK = 63,
+    QUESTION_MARK = 63,// needs localization
     AT_SIGN = 64,
     A = 65,
     B = 66,
@@ -79,7 +79,7 @@ export declare enum KeyCodes {
     X = 88,
     Y = 89,
     Z = 90,
-    META = 91,
+    META = 91,// WIN_KEY_LEFT
     WIN_KEY_RIGHT = 92,
     CONTEXT_MENU = 93,
     NUM_ZERO = 96,
@@ -113,22 +113,22 @@ export declare enum KeyCodes {
     SCROLL_LOCK = 145,
     FIRST_MEDIA_KEY = 166,
     LAST_MEDIA_KEY = 183,
-    SEMICOLON = 186,
-    DASH = 189,
-    EQUALS = 187,
-    COMMA = 188,
-    PERIOD = 190,
-    SLASH = 191,
-    APOSTROPHE = 192,
-    TILDE = 192,
-    SINGLE_QUOTE = 222,
-    OPEN_SQUARE_BRACKET = 219,
-    BACKSLASH = 220,
-    CLOSE_SQUARE_BRACKET = 221,
+    SEMICOLON = 186,// needs localization
+    DASH = 189,// needs localization
+    EQUALS = 187,// needs localization
+    COMMA = 188,// needs localization
+    PERIOD = 190,// needs localization
+    SLASH = 191,// needs localization
+    APOSTROPHE = 192,// needs localization
+    TILDE = 192,// needs localization
+    SINGLE_QUOTE = 222,// needs localization
+    OPEN_SQUARE_BRACKET = 219,// needs localization
+    BACKSLASH = 220,// needs localization
+    CLOSE_SQUARE_BRACKET = 221,// needs localization
     WIN_KEY = 224,
-    MAC_FF_META = 224,
-    MAC_WK_CMD_LEFT = 91,
-    MAC_WK_CMD_RIGHT = 93,
+    MAC_FF_META = 224,// Firefox (Gecko) fires this for the meta key instead of 91
+    MAC_WK_CMD_LEFT = 91,// WebKit Left Command key fired, same as META
+    MAC_WK_CMD_RIGHT = 93,// WebKit Right Command key fired, different from META
     WIN_IME = 229,
     VK_NONAME = 252,
     PHANTOM = 255

package/core/utils/size.d.ts

@@ -30,5 +30,15 @@ export declare class Size {
      *     are null.
      */
     static equals(a: Size | null, b: Size | null): boolean;
+    /**
+     * Returns a new size with the maximum width and height values out of both
+     * sizes.
+     */
+    static max(a: Size, b: Size): Size;
+    /**
+     * Returns a new size with the minimum width and height values out of both
+     * sizes.
+     */
+    static min(a: Size, b: Size): Size;
 }
 //# sourceMappingURL=size.d.ts.map

package/core/utils/string.d.ts

@@ -3,16 +3,6 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Fast prefix-checker.
- * Copied from Closure's goog.string.startsWith.
- *
- * @param str The string to check.
- * @param prefix A string to look for at the start of `str`.
- * @returns True if `str` begins with `prefix`.
- * @deprecated Use built-in **string.startsWith** instead.
- */
-export declare function startsWith(str: string, prefix: string): boolean;
 /**
  * Given an array of strings, return the length of the shortest one.
  *