blockly 11.0.0-beta.6 → 11.0.0-beta.8

package/core/block_dragger.d.ts

@@ -1,212 +0,0 @@
-/**
- * @license
- * Copyright 2017 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Methods for dragging a block visually.
- *
- * @class
- */
-import './events/events_block_drag.js';
-import type { BlockSvg } from './block_svg.js';
-import type { Icon } from './icons/icon.js';
-import type { IBlockDragger } from './interfaces/i_block_dragger.js';
-import { Coordinate } from './utils/coordinate.js';
-import type { WorkspaceSvg } from './workspace_svg.js';
-import { IConnectionPreviewer } from './blockly.js';
-/**
- * Class for a block dragger.  It moves blocks around the workspace when they
- * are being dragged by a mouse or touch.
- */
-export declare class BlockDragger implements IBlockDragger {
-    /** The top block in the stack that is being dragged. */
-    protected draggingBlock_: BlockSvg;
-    protected connectionPreviewer: IConnectionPreviewer;
-    /** The workspace on which the block is being dragged. */
-    protected workspace_: WorkspaceSvg;
-    /** Which drag area the mouse pointer is over, if any. */
-    private dragTarget_;
-    private connectionCandidate;
-    /** Whether the block would be deleted if dropped immediately. */
-    protected wouldDeleteBlock_: boolean;
-    protected startXY_: Coordinate;
-    /** The parent block at the start of the drag. */
-    private startParentConn;
-    /**
-     * The child block at the start of the drag. Only gets set if
-     * `healStack` is true.
-     */
-    private startChildConn;
-    /**
-     * @param block The block to drag.
-     * @param workspace The workspace to drag on.
-     */
-    constructor(block: BlockSvg, workspace: WorkspaceSvg);
-    /**
-     * Sever all links from this object.
-     *
-     * @internal
-     */
-    dispose(): void;
-    /**
-     * Start dragging a block.
-     *
-     * @param currentDragDeltaXY How far the pointer has moved from the position
-     *     at mouse down, in pixel units.
-     * @param healStack Whether or not to heal the stack after disconnecting.
-     */
-    startDrag(currentDragDeltaXY: Coordinate, healStack: boolean): void;
-    /**
-     * Whether or not we should disconnect the block when a drag is started.
-     *
-     * @param healStack Whether or not to heal the stack after disconnecting.
-     * @returns True to disconnect the block, false otherwise.
-     */
-    protected shouldDisconnect_(healStack: boolean): boolean;
-    /**
-     * Disconnects the block and moves it to a new location.
-     *
-     * @param healStack Whether or not to heal the stack after disconnecting.
-     * @param currentDragDeltaXY How far the pointer has moved from the position
-     *     at mouse down, in pixel units.
-     */
-    protected disconnectBlock_(healStack: boolean, currentDragDeltaXY: Coordinate): void;
-    /** Fire a UI event at the start of a block drag. */
-    protected fireDragStartEvent_(): void;
-    /**
-     * Execute a step of block dragging, based on the given event.  Update the
-     * display accordingly.
-     *
-     * @param e The most recent move event.
-     * @param delta How far the pointer has moved from the position
-     *     at the start of the drag, in pixel units.
-     */
-    drag(e: PointerEvent, delta: Coordinate): void;
-    /**
-     * @param draggingBlock The block being dragged.
-     * @param dragDelta How far the pointer has moved from the position
-     *     at the start of the drag, in pixel units.
-     */
-    private moveBlock;
-    private updateDragTargets;
-    /**
-     * Returns true if we would delete the block if it was dropped at this time,
-     * false otherwise.
-     *
-     * @param e The most recent move event.
-     * @param draggingBlock The block being dragged.
-     * @param delta How far the pointer has moved from the position
-     *     at the start of the drag, in pixel units.
-     */
-    private wouldDeleteBlock;
-    /**
-     * @param draggingBlock The block being dragged.
-     * @param dragDelta How far the pointer has moved from the position
-     *     at the start of the drag, in pixel units.
-     */
-    private updateConnectionPreview;
-    /**
-     * Returns true if the given orphan block can connect at the end of the
-     * top block's stack or row, false otherwise.
-     */
-    private orphanCanConnectAtEnd;
-    /**
-     * Returns true if the current candidate is better than the new candidate.
-     *
-     * We slightly prefer the current candidate even if it is farther away.
-     */
-    private currCandidateIsBetter;
-    /**
-     * Returns the closest valid candidate connection, if one can be found.
-     *
-     * Valid neighbour connections are within the configured start radius, with a
-     * compatible type (input, output, etc) and connection check.
-     */
-    private getConnectionCandidate;
-    /**
-     * Returns all of the connections we might connect to blocks on the workspace.
-     *
-     * Includes any connections on the dragging block, and any last next
-     * connection on the stack (if one exists).
-     */
-    private getLocalConnections;
-    /**
-     * Finish a block drag and put the block back on the workspace.
-     *
-     * @param e The pointerup event.
-     * @param currentDragDeltaXY How far the pointer has moved from the position
-     *     at the start of the drag, in pixel units.
-     */
-    endDrag(e: PointerEvent, currentDragDeltaXY: Coordinate): void;
-    /**
-     * Moves the dragged block back to its original position before the start of
-     * the drag. Reconnects any parent and child blocks.
-     */
-    private moveToOriginalPosition;
-    /**
-     * Calculates the drag delta and new location values after a block is dragged.
-     *
-     * @param currentDragDeltaXY How far the pointer has moved from the start of
-     *     the drag, in pixel units.
-     * @returns New location after drag. delta is in workspace units. newLocation
-     *     is the new coordinate where the block should end up.
-     */
-    protected getNewLocationAfterDrag_(currentDragDeltaXY: Coordinate): {
-        delta: Coordinate;
-        newLocation: Coordinate;
-    };
-    /**
-     * May delete the dragging block, if allowed. If `this.wouldDeleteBlock_` is
-     * not true, the block will not be deleted. This should be called at the end
-     * of a block drag.
-     *
-     * @returns True if the block was deleted.
-     */
-    protected maybeDeleteBlock_(): boolean;
-    /**
-     * Updates the necessary information to place a block at a certain location.
-     */
-    protected updateBlockAfterMove_(): void;
-    private applyConnections;
-    /** Fire a UI event at the end of a block drag. */
-    protected fireDragEndEvent_(): void;
-    /**
-     * Adds or removes the style of the cursor for the toolbox.
-     * This is what changes the cursor to display an x when a deletable block is
-     * held over the toolbox.
-     *
-     * @param isEnd True if we are at the end of a drag, false otherwise.
-     */
-    protected updateToolboxStyle_(isEnd: boolean): void;
-    /** Fire a move event at the end of a block drag. */
-    protected fireMoveEvent_(): void;
-    /**
-     * Update the cursor (and possibly the trash can lid) to reflect whether the
-     * dragging block would be deleted if released immediately.
-     */
-    protected updateCursorDuringBlockDrag_(): void;
-    /**
-     * Convert a coordinate object from pixels to workspace units, including a
-     * correction for mutator workspaces.
-     * This function does not consider differing origins.  It simply scales the
-     * input's x and y values.
-     *
-     * @param pixelCoord A coordinate with x and y values in CSS pixel units.
-     * @returns The input coordinate divided by the workspace scale.
-     */
-    protected pixelsToWorkspaceUnits_(pixelCoord: Coordinate): Coordinate;
-    /**
-     * Get a list of the insertion markers that currently exist.  Drags have 0, 1,
-     * or 2 insertion markers.
-     *
-     * @returns A possibly empty list of insertion marker blocks.
-     */
-    getInsertionMarkers(): BlockSvg[];
-}
-/** Data about the position of a given icon. */
-export interface IconPositionData {
-    location: Coordinate;
-    icon: Icon;
-}
-//# sourceMappingURL=block_dragger.d.ts.map

package/core/bubble_dragger.d.ts

@@ -1,77 +0,0 @@
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { IBubble } from './interfaces/i_bubble.js';
-import { Coordinate } from './utils/coordinate.js';
-import type { WorkspaceSvg } from './workspace_svg.js';
-/**
- * Class for a bubble dragger.  It moves things on the bubble canvas around the
- * workspace when they are being dragged by a mouse or touch.  These can be
- * block comments, mutators, warnings, or workspace comments.
- */
-export declare class BubbleDragger {
-    private bubble;
-    private workspace;
-    /** Which drag target the mouse pointer is over, if any. */
-    private dragTarget_;
-    /** Whether the bubble would be deleted if dropped immediately. */
-    private wouldDeleteBubble_;
-    private readonly startXY_;
-    /**
-     * @param bubble The item on the bubble canvas to drag.
-     * @param workspace The workspace to drag on.
-     */
-    constructor(bubble: IBubble, workspace: WorkspaceSvg);
-    /**
-     * Start dragging a bubble.
-     *
-     * @internal
-     */
-    startBubbleDrag(): void;
-    /**
-     * Execute a step of bubble dragging, based on the given event.  Update the
-     * display accordingly.
-     *
-     * @param e The most recent move event.
-     * @param currentDragDeltaXY How far the pointer has moved from the position
-     *     at the start of the drag, in pixel units.
-     * @internal
-     */
-    dragBubble(e: PointerEvent, currentDragDeltaXY: Coordinate): void;
-    /**
-     * Whether ending the drag would delete the bubble.
-     *
-     * @param dragTarget The drag target that the bubblee is currently over.
-     * @returns Whether dropping the bubble immediately would delete the block.
-     */
-    private shouldDelete_;
-    /**
-     * Update the cursor (and possibly the trash can lid) to reflect whether the
-     * dragging bubble would be deleted if released immediately.
-     */
-    private updateCursorDuringBubbleDrag_;
-    /**
-     * Finish a bubble drag and put the bubble back on the workspace.
-     *
-     * @param e The pointerup event.
-     * @param currentDragDeltaXY How far the pointer has moved from the position
-     *     at the start of the drag, in pixel units.
-     * @internal
-     */
-    endBubbleDrag(e: PointerEvent, currentDragDeltaXY: Coordinate): void;
-    /** Fire a move event at the end of a bubble drag. */
-    private fireMoveEvent_;
-    /**
-     * Convert a coordinate object from pixels to workspace units, including a
-     * correction for mutator workspaces.
-     * This function does not consider differing origins.  It simply scales the
-     * input's x and y values.
-     *
-     * @param pixelCoord A coordinate with x and y values in CSS pixel units.
-     * @returns The input coordinate divided by the workspace scale.
-     */
-    private pixelsToWorkspaceUnits_;
-}
-//# sourceMappingURL=bubble_dragger.d.ts.map

package/core/interfaces/i_block_dragger.d.ts

@@ -1,47 +0,0 @@
-/**
- * @license
- * Copyright 2021 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { Coordinate } from '../utils/coordinate.js';
-import type { BlockSvg } from '../block_svg.js';
-/**
- * A block dragger interface.
- */
-export interface IBlockDragger {
-    /**
-     * Start dragging a block.
-     *
-     * @param currentDragDeltaXY How far the pointer has moved from the position
-     *     at mouse down, in pixel units.
-     * @param healStack Whether or not to heal the stack after disconnecting.
-     */
-    startDrag(currentDragDeltaXY: Coordinate, healStack: boolean): void;
-    /**
-     * Execute a step of block dragging, based on the given event.  Update the
-     * display accordingly.
-     *
-     * @param e The most recent move event.
-     * @param currentDragDeltaXY How far the pointer has moved from the position
-     *     at the start of the drag, in pixel units.
-     */
-    drag(e: Event, currentDragDeltaXY: Coordinate): void;
-    /**
-     * Finish a block drag and put the block back on the workspace.
-     *
-     * @param e The mouseup/touchend event.
-     * @param currentDragDeltaXY How far the pointer has moved from the position
-     *     at the start of the drag, in pixel units.
-     */
-    endDrag(e: Event, currentDragDeltaXY: Coordinate): void;
-    /**
-     * Get a list of the insertion markers that currently exist.  Drags have 0, 1,
-     * or 2 insertion markers.
-     *
-     * @returns A possibly empty list of insertion marker blocks.
-     */
-    getInsertionMarkers(): BlockSvg[];
-    /** Sever all links from this object and do any necessary cleanup. */
-    dispose(): void;
-}
-//# sourceMappingURL=i_block_dragger.d.ts.map