blockly 9.3.3 → 10.0.0-beta.0

package/core/comment.d.ts

@@ -1,115 +0,0 @@
-/**
- * @license
- * Copyright 2011 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import './events/events_block_change.js';
-import './events/events_bubble_open.js';
-import type { BlockSvg } from './block_svg.js';
-import { Icon } from './icon.js';
-import type { Size } from './utils/size.js';
-/**
- * Class for a comment.
- */
-export declare class Comment extends Icon {
-    private readonly model;
-    /**
-     * The model's text value at the start of an edit.
-     * Used to tell if an event should be fired at the end of an edit.
-     */
-    private cachedText;
-    /**
-     * Array holding info needed to unbind events.
-     * Used for disposing.
-     * Ex: [[node, name, func], [node, name, func]].
-     */
-    private boundEvents;
-    /**
-     * The SVG element that contains the text edit area, or null if not created.
-     */
-    private foreignObject;
-    /** The editable text area, or null if not created. */
-    private textarea_;
-    /** The top-level node of the comment text, or null if not created. */
-    private paragraphElement_;
-    /** @param block The block associated with this comment. */
-    constructor(block: BlockSvg);
-    /**
-     * Draw the comment icon.
-     *
-     * @param group The icon group.
-     */
-    protected drawIcon_(group: Element): void;
-    /**
-     * Create the editor for the comment's bubble.
-     *
-     * @returns The top-level node of the editor.
-     */
-    private createEditor;
-    /** Add or remove editability of the comment. */
-    updateEditable(): void;
-    /**
-     * Callback function triggered when the bubble has resized.
-     * Resize the text area accordingly.
-     */
-    private onBubbleResize;
-    /**
-     * Resizes the text area to match the size defined on the model (which is
-     * the size of the bubble).
-     */
-    private resizeTextarea;
-    /**
-     * Show or hide the comment bubble.
-     *
-     * @param visible True if the bubble should be visible.
-     */
-    setVisible(visible: boolean): void;
-    /** Show the bubble. Handles deciding if it should be editable or not. */
-    private createBubble;
-    /** Show an editable bubble. */
-    private createEditableBubble;
-    /**
-     * Show a non-editable bubble.
-     */
-    private createNonEditableBubble;
-    /**
-     * Dispose of the bubble.
-     */
-    private disposeBubble;
-    /**
-     * Callback fired when an edit starts.
-     *
-     * Bring the comment to the top of the stack when clicked on. Also cache the
-     * current text so it can be used to fire a change event.
-     *
-     * @param _e Mouse up event.
-     */
-    private startEdit;
-    /**
-     * Get the dimensions of this comment's bubble.
-     *
-     * @returns Object with width and height properties.
-     */
-    getBubbleSize(): Size;
-    /**
-     * Size this comment's bubble.
-     *
-     * @param width Width of the bubble.
-     * @param height Height of the bubble.
-     */
-    setBubbleSize(width: number, height: number): void;
-    /**
-     * Update the comment's view to match the model.
-     *
-     * @internal
-     */
-    updateText(): void;
-    /**
-     * Dispose of this comment.
-     *
-     * If you want to receive a comment "delete" event (newValue: null), then this
-     * should not be called directly. Instead call block.setCommentText(null);
-     */
-    dispose(): void;
-}
-//# sourceMappingURL=comment.d.ts.map

package/core/events/events_ui.d.ts

@@ -1,40 +0,0 @@
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { Block } from '../block.js';
-import { UiBase } from './events_ui_base.js';
-/**
- * Class for a UI event.
- *
- * @deprecated December 2020. Instead use a more specific UI event.
- */
-export declare class Ui extends UiBase {
-    blockId: any;
-    element: any;
-    oldValue: any;
-    newValue: any;
-    type: string;
-    /**
-     * @param opt_block The affected block.  Null for UI events that do not have
-     *     an associated block.  Undefined for a blank event.
-     * @param opt_element One of 'selected', 'comment', 'mutatorOpen', etc.
-     * @param opt_oldValue Previous value of element.
-     * @param opt_newValue New value of element.
-     */
-    constructor(opt_block?: Block | null, opt_element?: string, opt_oldValue?: any, opt_newValue?: any);
-    /**
-     * Encode the event as JSON.
-     *
-     * @returns JSON representation.
-     */
-    toJson(): any;
-    /**
-     * Decode the JSON event.
-     *
-     * @param json JSON representation.
-     */
-    fromJson(json: any): void;
-}
-//# sourceMappingURL=events_ui.d.ts.map

package/core/icon.d.ts

@@ -1,89 +0,0 @@
-/**
- * @license
- * Copyright 2013 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { BlockSvg } from './block_svg.js';
-import type { Bubble } from './bubble.js';
-import { Coordinate } from './utils/coordinate.js';
-import { Size } from './utils/size.js';
-/**
- * Class for an icon.
- */
-export declare abstract class Icon {
-    protected block_: BlockSvg | null;
-    /** The icon SVG group. */
-    iconGroup_: SVGGElement | null;
-    /** Whether this icon gets hidden when the block is collapsed. */
-    collapseHidden: boolean;
-    /** Height and width of icons. */
-    readonly SIZE = 17;
-    /** Bubble UI (if visible). */
-    protected bubble_: Bubble | null;
-    /** Absolute coordinate of icon's center. */
-    protected iconXY_: Coordinate | null;
-    /** @param block The block associated with this icon. */
-    constructor(block: BlockSvg | null);
-    /** Create the icon on the block. */
-    createIcon(): void;
-    /** Dispose of this icon. */
-    dispose(): void;
-    /** Add or remove the UI indicating if this icon may be clicked or not. */
-    updateEditable(): void;
-    /**
-     * Is the associated bubble visible?
-     *
-     * @returns True if the bubble is visible.
-     */
-    isVisible(): boolean;
-    /**
-     * Clicking on the icon toggles if the bubble is visible.
-     *
-     * @param e Mouse click event.
-     */
-    protected iconClick_(e: PointerEvent): void;
-    /** Change the colour of the associated bubble to match its block. */
-    applyColour(): void;
-    /**
-     * Notification that the icon has moved.  Update the arrow accordingly.
-     *
-     * @param xy Absolute location in workspace coordinates.
-     */
-    setIconLocation(xy: Coordinate): void;
-    /**
-     * Notification that the icon has moved, but we don't really know where.
-     * Recompute the icon's location from scratch.
-     */
-    computeIconLocation(): void;
-    /**
-     * Returns the center of the block's icon relative to the surface.
-     *
-     * @returns Object with x and y properties in workspace coordinates.
-     */
-    getIconLocation(): Coordinate | null;
-    /**
-     * Get the size of the icon as used for rendering.
-     * This differs from the actual size of the icon, because it bulges slightly
-     * out of its row rather than increasing the height of its row.
-     *
-     * @returns Height and width.
-     */
-    getCorrectedSize(): Size;
-    /**
-     * Draw the icon.
-     *
-     * @param _group The icon group.
-     */
-    protected drawIcon_(_group: Element): void;
-    /**
-     * Show or hide the bubble.
-     *
-     * @param _visible True if the bubble should be visible.
-     */
-    setVisible(_visible: boolean): void;
-    /**
-     * @returns The block this icon is attached to.
-     */
-    protected getBlock(): BlockSvg;
-}
-//# sourceMappingURL=icon.d.ts.map

package/core/mutator.d.ts

@@ -1,142 +0,0 @@
-/**
- * @license
- * Copyright 2012 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import './events/events_bubble_open.js';
-import type { Block } from './block.js';
-import type { BlockSvg } from './block_svg.js';
-import type { Connection } from './connection.js';
-import type { Abstract } from './events/events_abstract.js';
-import { Icon } from './icon.js';
-import { Options } from './options.js';
-import type { WorkspaceSvg } from './workspace_svg.js';
-/**
- * Class for a mutator dialog.
- */
-export declare class Mutator extends Icon {
-    private quarkNames;
-    /**
-     * Workspace in the mutator's bubble.
-     * Due to legacy code in procedure block definitions, this name
-     * cannot change.
-     */
-    private workspace_;
-    /** Width of workspace. */
-    private workspaceWidth;
-    /** Height of workspace. */
-    private workspaceHeight;
-    /**
-     * The SVG element that is the parent of the mutator workspace, or null if
-     * not created.
-     */
-    private svgDialog;
-    /**
-     * The root block of the mutator workspace, created by decomposing the
-     * source block.
-     */
-    private rootBlock;
-    /**
-     * Function registered on the main workspace to update the mutator contents
-     * when the main workspace changes.
-     */
-    private sourceListener;
-    /**
-     * The PID associated with the updateWorkpace_ timeout, or null if no timeout
-     * is currently running.
-     */
-    private updateWorkspacePid;
-    /** @param quarkNames List of names of sub-blocks for flyout. */
-    constructor(quarkNames: string[], block?: BlockSvg);
-    /**
-     * Set the block this mutator is associated with.
-     *
-     * @param block The block associated with this mutator.
-     * @internal
-     */
-    setBlock(block: BlockSvg): void;
-    /**
-     * Returns the workspace inside this mutator icon's bubble.
-     *
-     * @returns The workspace inside this mutator icon's bubble or null if the
-     *     mutator isn't open.
-     * @internal
-     */
-    getWorkspace(): WorkspaceSvg | null;
-    /**
-     * Draw the mutator icon.
-     *
-     * @param group The icon group.
-     */
-    protected drawIcon_(group: Element): void;
-    /**
-     * Clicking on the icon toggles if the mutator bubble is visible.
-     * Disable if block is uneditable.
-     *
-     * @param e Mouse click event.
-     */
-    protected iconClick_(e: PointerEvent): void;
-    /**
-     * Create the editor for the mutator's bubble.
-     *
-     * @returns The top-level node of the editor.
-     */
-    private createEditor;
-    /**
-     * @internal
-     */
-    newWorkspaceSvg(options: Options): WorkspaceSvg;
-    /** Add or remove the UI indicating if this icon may be clicked or not. */
-    updateEditable(): void;
-    /** Resize the bubble to match the size of the workspace. */
-    private resizeBubble;
-    /** A method handler for when the bubble is moved. */
-    private onBubbleMove;
-    /**
-     * Show or hide the mutator bubble.
-     *
-     * @param visible True if the bubble should be visible.
-     */
-    setVisible(visible: boolean): void;
-    /**
-     * Fired whenever a change is made to the mutator's workspace.
-     *
-     * @param e Custom data for event.
-     */
-    private workspaceChanged;
-    /**
-     * Returns whether the given event in the mutator workspace should be ignored
-     * when deciding whether to update the workspace and compose the block or not.
-     *
-     * @param e The event.
-     * @returns Whether to ignore the event or not.
-     */
-    shouldIgnoreMutatorEvent_(e: Abstract): boolean;
-    /**
-     * Updates the source block when the mutator's blocks are changed.
-     * Bump down any block that's too high.
-     */
-    private updateWorkspace;
-    /** Dispose of this mutator. */
-    dispose(): void;
-    /** Update the styles on all blocks in the mutator. */
-    updateBlockStyle(): void;
-    /**
-     * Reconnect an block to a mutated input.
-     *
-     * @param connectionChild Connection on child block.
-     * @param block Parent block.
-     * @param inputName Name of input on parent block.
-     * @returns True iff a reconnection was made, false otherwise.
-     */
-    static reconnect(connectionChild: Connection, block: Block, inputName: string): boolean;
-    /**
-     * Get the parent workspace of a workspace that is inside a mutator, taking
-     * into account whether it is a flyout.
-     *
-     * @param workspace The workspace that is inside a mutator.
-     * @returns The mutator's parent workspace or null.
-     */
-    static findParentWs(workspace: WorkspaceSvg): WorkspaceSvg | null;
-}
-//# sourceMappingURL=mutator.d.ts.map

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

@@ -1,29 +0,0 @@
-/**
- * @license
- * Copyright 2021 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Returns whether the debugger is turned on.
- *
- * @returns Whether the debugger is turned on.
- * @internal
- */
-export declare function isDebuggerEnabled(): boolean;
-/**
- * Turn on the blocks debugger.
- *
- * @deprecated March 2022. Use the rendering debugger in @blockly/dev-tools.
- * See https://www.npmjs.com/package/@blockly/dev-tools for more information.
- * @internal
- */
-export declare function startDebugger(): void;
-/**
- * Turn off the blocks debugger.
- *
- * @deprecated March 2022. Use the rendering debugger in @blockly/dev-tools.
- * See https://www.npmjs.com/package/@blockly/dev-tools for more information.
- * @internal
- */
-export declare function stopDebugger(): void;
-//# sourceMappingURL=debug.d.ts.map

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

@@ -1,117 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { BlockSvg } from '../../block_svg.js';
-import type { RenderedConnection } from '../../rendered_connection.js';
-import type { Measurable } from '../measurables/base.js';
-import type { InRowSpacer } from '../measurables/in_row_spacer.js';
-import type { Row } from '../measurables/row.js';
-import type { ConstantProvider } from './constants.js';
-import type { RenderInfo } from './info.js';
-/**
- * An object that renders rectangles and dots for debugging rendering code.
- */
-export declare class Debug {
-    private readonly constants;
-    /**
-     * Configuration object containing booleans to enable and disable debug
-     * rendering of specific rendering components.
-     */
-    static config: {
-        rowSpacers: boolean;
-        elemSpacers: boolean;
-        rows: boolean;
-        elems: boolean;
-        connections: boolean;
-        blockBounds: boolean;
-        connectedBlockBounds: boolean;
-        render: boolean;
-    };
-    /** An array of SVG elements that have been created by this object. */
-    private debugElements_;
-    /**
-     * The SVG root of the block that is being rendered.  Debug elements will
-     * be attached to this root.
-     */
-    private svgRoot_;
-    private randomColour_;
-    /**
-     * @param constants The renderer's constants.
-     */
-    constructor(constants: ConstantProvider);
-    /**
-     * Remove all elements the this object created on the last pass.
-     */
-    protected clearElems(): void;
-    /**
-     * Draw a debug rectangle for a spacer (empty) row.
-     *
-     * @param row The row to render.
-     * @param cursorY The y position of the top of the row.
-     * @param isRtl Whether the block is rendered RTL.
-     */
-    protected drawSpacerRow(row: Row, cursorY: number, isRtl: boolean): void;
-    /**
-     * Draw a debug rectangle for a horizontal spacer.
-     *
-     * @param elem The spacer to render.
-     * @param rowHeight The height of the container row.
-     * @param isRtl Whether the block is rendered RTL.
-     */
-    protected drawSpacerElem(elem: InRowSpacer, rowHeight: number, isRtl: boolean): void;
-    /**
-     * Draw a debug rectangle for an in-row element.
-     *
-     * @param elem The element to render.
-     * @param isRtl Whether the block is rendered RTL.
-     */
-    protected drawRenderedElem(elem: Measurable, isRtl: boolean): void;
-    /**
-     * Draw a circle at the location of the given connection.  Inputs and outputs
-     * share the same colours, as do previous and next.  When positioned correctly
-     * a connected pair will look like a bullseye.
-     *
-     * @param conn The connection to circle.
-     * @suppress {visibility} Suppress visibility of conn.offsetInBlock_ since
-     * this is a debug module.
-     */
-    protected drawConnection(conn: RenderedConnection): void;
-    /**
-     * Draw a debug rectangle for a non-empty row.
-     *
-     * @param row The non-empty row to render.
-     * @param cursorY The y position of the top of the row.
-     * @param isRtl Whether the block is rendered RTL.
-     */
-    protected drawRenderedRow(row: Row, cursorY: number, isRtl: boolean): void;
-    /**
-     * Draw debug rectangles for a non-empty row and all of its subcomponents.
-     *
-     * @param row The non-empty row to render.
-     * @param cursorY The y position of the top of the row.
-     * @param isRtl Whether the block is rendered RTL.
-     */
-    protected drawRowWithElements(row: Row, cursorY: number, isRtl: boolean): void;
-    /**
-     * Draw a debug rectangle around the entire block.
-     *
-     * @param info Rendering information about the block to debug.
-     */
-    protected drawBoundingBox(info: RenderInfo): void;
-    /**
-     * Do all of the work to draw debug information for the whole block.
-     *
-     * @param block The block to draw debug information for.
-     * @param info Rendering information about the block to debug.
-     */
-    drawDebug(block: BlockSvg, info: RenderInfo): void;
-    /**
-     * Show a debug filter to highlight that a block has been rendered.
-     *
-     * @param svgPath The block's SVG path.
-     */
-    protected drawRender(svgPath: SVGElement): void;
-}
-//# sourceMappingURL=debugger.d.ts.map

package/core/warning.d.ts

@@ -1,53 +0,0 @@
-/**
- * @license
- * Copyright 2012 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import './events/events_bubble_open.js';
-import type { BlockSvg } from './block_svg.js';
-import { Icon } from './icon.js';
-/**
- * Class for a warning.
- */
-export declare class Warning extends Icon {
-    private text;
-    /** The top-level node of the warning text, or null if not created. */
-    private paragraphElement;
-    /** Does this icon get hidden when the block is collapsed? */
-    collapseHidden: boolean;
-    /** @param block The block associated with this warning. */
-    constructor(block: BlockSvg);
-    /**
-     * Draw the warning icon.
-     *
-     * @param group The icon group.
-     */
-    protected drawIcon_(group: Element): void;
-    /**
-     * Show or hide the warning bubble.
-     *
-     * @param visible True if the bubble should be visible.
-     */
-    setVisible(visible: boolean): void;
-    /** Show the bubble. */
-    private createBubble;
-    /** Dispose of the bubble and references to it. */
-    private disposeBubble;
-    /**
-     * Set this warning's text.
-     *
-     * @param text Warning text (or '' to delete). This supports linebreaks.
-     * @param id An ID for this text entry to be able to maintain multiple
-     *     warnings.
-     */
-    setText(text: string, id: string): void;
-    /**
-     * Get this warning's texts.
-     *
-     * @returns All texts concatenated into one string.
-     */
-    getText(): string;
-    /** Dispose of this warning. */
-    dispose(): void;
-}
-//# sourceMappingURL=warning.d.ts.map