blockly 8.20220331.0-beta.0 → 9.0.0-beta.1

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

@@ -0,0 +1,264 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Measurable } from './base.js';
+import type { Row } from './row.js';
+/**
+ * Types of rendering elements.
+ *
+ * @alias Blockly.blockRendering.Types
+ */
+declare class TypesContainer {
+    [index: string]: number | Function;
+    NONE: number;
+    FIELD: number;
+    HAT: number;
+    ICON: number;
+    SPACER: number;
+    BETWEEN_ROW_SPACER: number;
+    IN_ROW_SPACER: number;
+    EXTERNAL_VALUE_INPUT: number;
+    INPUT: number;
+    INLINE_INPUT: number;
+    STATEMENT_INPUT: number;
+    CONNECTION: number;
+    PREVIOUS_CONNECTION: number;
+    NEXT_CONNECTION: number;
+    OUTPUT_CONNECTION: number;
+    CORNER: number;
+    LEFT_SQUARE_CORNER: number;
+    LEFT_ROUND_CORNER: number;
+    RIGHT_SQUARE_CORNER: number;
+    RIGHT_ROUND_CORNER: number;
+    JAGGED_EDGE: number;
+    ROW: number;
+    TOP_ROW: number;
+    BOTTOM_ROW: number;
+    INPUT_ROW: number;
+    /**
+     * A Left Corner Union Type.
+     *
+     * @internal
+     */
+    LEFT_CORNER: number;
+    /**
+     * A Right Corner Union Type.
+     *
+     * @internal
+     */
+    RIGHT_CORNER: number;
+    /**
+     * Next flag value to use for custom rendering element types.
+     * This must be updated to reflect the next enum flag value
+     * to use if additional elements are added to
+     * `Types`.
+     */
+    nextTypeValue_: number;
+    /**
+     * Get the enum flag value of an existing type or register a new type.
+     *
+     * @param type The name of the type.
+     * @returns The enum flag value associated with that type.
+     * @internal
+     */
+    getType(type: string): number;
+    /**
+     * Whether a measurable stores information about a field.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a field.
+     * @internal
+     */
+    isField(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a hat.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a hat.
+     * @internal
+     */
+    isHat(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about an icon.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about an icon.
+     * @internal
+     */
+    isIcon(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a spacer.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a spacer.
+     * @internal
+     */
+    isSpacer(elem: Measurable | Row): number;
+    /**
+     * Whether a measurable stores information about an in-row spacer.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about an in-row spacer.
+     * @internal
+     */
+    isInRowSpacer(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about an input.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about an input.
+     * @internal
+     */
+    isInput(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about an external input.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about an external input.
+     * @internal
+     */
+    isExternalInput(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about an inline input.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about an inline input.
+     * @internal
+     */
+    isInlineInput(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a statement input.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a statement input.
+     * @internal
+     */
+    isStatementInput(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a previous connection.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a previous connection.
+     * @internal
+     */
+    isPreviousConnection(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a next connection.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a next connection.
+     * @internal
+     */
+    isNextConnection(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a previous or next
+     * connection.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a previous or next
+     *     connection.
+     * @internal
+     */
+    isPreviousOrNextConnection(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a left round corner.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a left round corner.
+     * @internal
+     */
+    isLeftRoundedCorner(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a right round corner.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a right round corner.
+     * @internal
+     */
+    isRightRoundedCorner(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a left square corner.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a left square corner.
+     * @internal
+     */
+    isLeftSquareCorner(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a right square corner.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a right square corner.
+     * @internal
+     */
+    isRightSquareCorner(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a corner.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a corner.
+     * @internal
+     */
+    isCorner(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a jagged edge.
+     *
+     * @param elem The element to check.
+     * @returns 1 if the object stores information about a jagged edge.
+     * @internal
+     */
+    isJaggedEdge(elem: Measurable): number;
+    /**
+     * Whether a measurable stores information about a row.
+     *
+     * @param row The row to check.
+     * @returns 1 if the object stores information about a row.
+     * @internal
+     */
+    isRow(row: Row): number;
+    /**
+     * Whether a measurable stores information about a between-row spacer.
+     *
+     * @param row The row to check.
+     * @returns 1 if the object stores information about a between-row spacer.
+     * @internal
+     */
+    isBetweenRowSpacer(row: Row): number;
+    /**
+     * Whether a measurable stores information about a top row.
+     *
+     * @param row The row to check.
+     * @returns 1 if the object stores information about a top row.
+     * @internal
+     */
+    isTopRow(row: Row): number;
+    /**
+     * Whether a measurable stores information about a bottom row.
+     *
+     * @param row The row to check.
+     * @returns 1 if the object stores information about a bottom row.
+     * @internal
+     */
+    isBottomRow(row: Row): number;
+    /**
+     * Whether a measurable stores information about a top or bottom row.
+     *
+     * @param row The row to check.
+     * @returns 1 if the object stores information about a top or bottom row.
+     * @internal
+     */
+    isTopOrBottomRow(row: Row): number;
+    /**
+     * Whether a measurable stores information about an input row.
+     *
+     * @param row The row to check.
+     * @returns 1 if the object stores information about an input row.
+     * @internal
+     */
+    isInputRow(row: Row): number;
+}
+export declare const Types: TypesContainer;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ConstantProvider as BaseConstantProvider } from '../common/constants.js';
+/**
+ * An object that provides constants for rendering blocks in the sample.
+ *
+ * @alias Blockly.minimalist.ConstantProvider
+ */
+export declare class ConstantProvider extends BaseConstantProvider {
+    /** @internal */
+    constructor();
+}
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from '../../block_svg.js';
+import { Drawer as BaseDrawer } from '../common/drawer.js';
+import type { RenderInfo } from './info.js';
+/**
+ * An object that draws a block based on the given rendering information.
+ *
+ * @alias Blockly.minimalist.Drawer
+ */
+export declare class Drawer extends BaseDrawer {
+    /**
+     * @param block The block to render.
+     * @param info An object containing all information needed to render this
+     *     block.
+     * @internal
+     */
+    constructor(block: BlockSvg, info: RenderInfo);
+}
+//# sourceMappingURL=drawer.d.ts.map

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

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from '../../block_svg.js';
+import { RenderInfo as BaseRenderInfo } from '../common/info.js';
+import type { Renderer } from './renderer.js';
+/**
+ * An object containing all sizing information needed to draw this block.
+ *
+ * This measure pass does not propagate changes to the block (although fields
+ * may choose to rerender when getSize() is called).  However, calling it
+ * repeatedly may be expensive.
+ *
+ * @alias Blockly.minimalist.RenderInfo
+ */
+export declare class RenderInfo extends BaseRenderInfo {
+    /**
+     * @param renderer The renderer in use.
+     * @param block The block to measure.
+     * @internal
+     */
+    constructor(renderer: Renderer, block: BlockSvg);
+    /**
+     * Get the block renderer in use.
+     *
+     * @returns The block renderer in use.
+     * @internal
+     */
+    getRenderer(): Renderer;
+}
+//# sourceMappingURL=info.d.ts.map

package/core/renderers/minimalist/minimalist.d.ts

@@ -0,0 +1,7 @@
+/** @file Re-exports of Blockly.minimalist.* modules. */
+import { ConstantProvider } from './constants.js';
+import { Drawer } from './drawer.js';
+import { RenderInfo } from './info.js';
+import { Renderer } from './renderer.js';
+export { ConstantProvider, Drawer, Renderer, RenderInfo };
+//# sourceMappingURL=minimalist.d.ts.map

package/core/renderers/minimalist/renderer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from '../../block_svg.js';
+import type { RenderInfo as BaseRenderInfo } from '../common/info.js';
+import { Renderer as BaseRenderer } from '../common/renderer.js';
+import { ConstantProvider } from './constants.js';
+import { Drawer } from './drawer.js';
+import { RenderInfo } from './info.js';
+/**
+ * The minimalist renderer.
+ *
+ * @alias Blockly.minimalist.Renderer
+ */
+export declare class Renderer extends BaseRenderer {
+    /**
+     * @param name The renderer name.
+     * @internal
+     */
+    constructor(name: string);
+    /**
+     * Create a new instance of the renderer's constant provider.
+     *
+     * @returns The constant provider.
+     */
+    protected makeConstants_(): ConstantProvider;
+    /**
+     * Create a new instance of the renderer's render info object.
+     *
+     * @param block The block to measure.
+     * @returns The render info object.
+     */
+    protected makeRenderInfo_(block: BlockSvg): RenderInfo;
+    /**
+     * Create a new instance of the renderer's drawer.
+     *
+     * @param block The block to render.
+     * @param info An object containing all information needed to render this
+     *     block.
+     * @returns The drawer.
+     */
+    protected makeDrawer_(block: BlockSvg, info: BaseRenderInfo): Drawer;
+}
+//# sourceMappingURL=renderer.d.ts.map

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

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from '../../block_svg.js';
+import { RenderInfo as BaseRenderInfo } from '../common/info.js';
+import type { Measurable } from '../measurables/base.js';
+import type { Row } from '../measurables/row.js';
+import type { Renderer } from './renderer.js';
+/**
+ * An object containing all sizing information needed to draw this block.
+ *
+ * This measure pass does not propagate changes to the block (although fields
+ * may choose to rerender when getSize() is called).  However, calling it
+ * repeatedly may be expensive.
+ *
+ * @alias Blockly.thrasos.RenderInfo
+ */
+export declare class RenderInfo extends BaseRenderInfo {
+    widthWithChildren: any;
+    height: any;
+    startY: any;
+    /**
+     * @param renderer The renderer in use.
+     * @param block The block to measure.
+     * @internal
+     */
+    constructor(renderer: Renderer, block: BlockSvg);
+    /**
+     * Get the block renderer in use.
+     *
+     * @returns The block renderer in use.
+     * @internal
+     */
+    getRenderer(): Renderer;
+    addElemSpacing_(): void;
+    getInRowSpacing_(prev: Measurable | null, next: Measurable | null): number;
+    getSpacerRowHeight_(prev: Row, next: Row): number;
+    getElemCenterline_(row: Row, elem: Measurable): number;
+    finalize_(): void;
+}
+//# sourceMappingURL=info.d.ts.map

package/core/renderers/thrasos/renderer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from '../../block_svg.js';
+import { Renderer as BaseRenderer } from '../common/renderer.js';
+import { RenderInfo } from './info.js';
+/**
+ * The thrasos renderer.
+ *
+ * @alias Blockly.thrasos.Renderer
+ */
+export declare class Renderer extends BaseRenderer {
+    /**
+     * @param name The renderer name.
+     * @internal
+     */
+    constructor(name: string);
+    /**
+     * Create a new instance of the renderer's render info object.
+     *
+     * @param block The block to measure.
+     * @returns The render info object.
+     */
+    protected makeRenderInfo_(block: BlockSvg): RenderInfo;
+}
+//# sourceMappingURL=renderer.d.ts.map

package/core/renderers/thrasos/thrasos.d.ts

@@ -0,0 +1,5 @@
+/** @file Re-exports of Blockly.thrasos.* modules. */
+import { RenderInfo } from './info.js';
+import { Renderer } from './renderer.js';
+export { Renderer, RenderInfo };
+//# sourceMappingURL=thrasos.d.ts.map

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

@@ -0,0 +1,194 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+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';
+/** An object containing sizing and path information about inside corners. */
+export interface InsideCorners {
+    width: number;
+    height: number;
+    pathTop: string;
+    pathBottom: string;
+    rightWidth: number;
+    rightHeight: number;
+    pathTopRight: string;
+    pathBottomRight: string;
+}
+/**
+ * An object that provides constants for rendering blocks in Zelos mode.
+ *
+ * @alias Blockly.zelos.ConstantProvider
+ */
+export declare class ConstantProvider extends BaseConstantProvider {
+    GRID_UNIT: number;
+    SMALL_PADDING: any;
+    MEDIUM_PADDING: any;
+    MEDIUM_LARGE_PADDING: any;
+    LARGE_PADDING: any;
+    CORNER_RADIUS: any;
+    NOTCH_WIDTH: any;
+    NOTCH_HEIGHT: any;
+    NOTCH_OFFSET_LEFT: any;
+    STATEMENT_INPUT_NOTCH_OFFSET: any;
+    MIN_BLOCK_WIDTH: any;
+    MIN_BLOCK_HEIGHT: any;
+    EMPTY_STATEMENT_INPUT_HEIGHT: any;
+    TAB_OFFSET_FROM_TOP: number;
+    TOP_ROW_MIN_HEIGHT: any;
+    TOP_ROW_PRECEDES_STATEMENT_MIN_HEIGHT: any;
+    BOTTOM_ROW_MIN_HEIGHT: any;
+    BOTTOM_ROW_AFTER_STATEMENT_MIN_HEIGHT: any;
+    STATEMENT_BOTTOM_SPACER: any;
+    STATEMENT_INPUT_SPACER_MIN_WIDTH: number;
+    STATEMENT_INPUT_PADDING_LEFT: any;
+    EMPTY_INLINE_INPUT_PADDING: any;
+    EMPTY_INLINE_INPUT_HEIGHT: any;
+    DUMMY_INPUT_MIN_HEIGHT: any;
+    DUMMY_INPUT_SHADOW_MIN_HEIGHT: any;
+    CURSOR_WS_WIDTH: any;
+    CURSOR_COLOUR: string;
+    /**
+     * Radius of the cursor for input and output connections.
+     *
+     * @internal
+     */
+    CURSOR_RADIUS: number;
+    JAGGED_TEETH_HEIGHT: number;
+    JAGGED_TEETH_WIDTH: number;
+    START_HAT_HEIGHT: number;
+    START_HAT_WIDTH: number;
+    SHAPES: {
+        HEXAGONAL: number;
+        ROUND: number;
+        SQUARE: number;
+        PUZZLE: number;
+        NOTCH: number;
+    };
+    SHAPE_IN_SHAPE_PADDING: any;
+    FULL_BLOCK_FIELDS: boolean;
+    FIELD_TEXT_FONTSIZE: any;
+    FIELD_TEXT_FONTWEIGHT: string;
+    FIELD_TEXT_FONTFAMILY: string;
+    FIELD_BORDER_RECT_RADIUS: any;
+    FIELD_BORDER_RECT_X_PADDING: any;
+    FIELD_BORDER_RECT_Y_PADDING: any;
+    FIELD_BORDER_RECT_HEIGHT: any;
+    FIELD_DROPDOWN_BORDER_RECT_HEIGHT: any;
+    FIELD_DROPDOWN_NO_BORDER_RECT_SHADOW: boolean;
+    FIELD_DROPDOWN_COLOURED_DIV: boolean;
+    FIELD_DROPDOWN_SVG_ARROW: boolean;
+    FIELD_DROPDOWN_SVG_ARROW_PADDING: any;
+    FIELD_TEXTINPUT_BOX_SHADOW: boolean;
+    FIELD_COLOUR_FULL_BLOCK: boolean;
+    FIELD_COLOUR_DEFAULT_WIDTH: any;
+    FIELD_COLOUR_DEFAULT_HEIGHT: any;
+    FIELD_CHECKBOX_X_OFFSET: any;
+    MAX_DYNAMIC_CONNECTION_SHAPE_WIDTH: number;
+    /** The selected glow colour. */
+    SELECTED_GLOW_COLOUR: string;
+    /** The size of the selected glow. */
+    SELECTED_GLOW_SIZE: number;
+    /** The replacement glow colour. */
+    REPLACEMENT_GLOW_COLOUR: string;
+    /** The size of the selected glow. */
+    REPLACEMENT_GLOW_SIZE: number;
+    /**
+     * The ID of the selected glow filter, or the empty string if no filter is
+     * set.
+     *
+     * @internal
+     */
+    selectedGlowFilterId: string;
+    /**
+     * The <filter> element to use for a selected glow, or null if not set.
+     */
+    private selectedGlowFilter_;
+    /**
+     * The ID of the replacement glow filter, or the empty string if no filter
+     * is set.
+     *
+     * @internal
+     */
+    replacementGlowFilterId: string;
+    /**
+     * The <filter> element to use for a replacement glow, or null if not set.
+     */
+    private replacementGlowFilter_;
+    /**
+     * The object containing information about the hexagon used for a boolean
+     * reporter block. Null before init is called.
+     */
+    HEXAGONAL: Shape | null;
+    /**
+     * The object containing information about the hexagon used for a number or
+     * string reporter block. Null before init is called.
+     */
+    ROUNDED: Shape | null;
+    /**
+     * The object containing information about the hexagon used for a
+     * rectangular reporter block. Null before init is called.
+     */
+    SQUARED: Shape | null;
+    /** @internal */
+    constructor();
+    setFontConstants_(theme: Theme): void;
+    init(): void;
+    setDynamicProperties_(theme: Theme): void;
+    dispose(): void;
+    makeStartHat(): {
+        height: number;
+        width: number;
+        path: string;
+    };
+    /**
+     * Create sizing and path information about a hexagonal shape.
+     *
+     * @returns An object containing sizing and path information about a hexagonal
+     *     shape for connections.
+     * @internal
+     */
+    makeHexagonal(): Shape;
+    /**
+     * Create sizing and path information about a rounded shape.
+     *
+     * @returns An object containing sizing and path information about a rounded
+     *     shape for connections.
+     * @internal
+     */
+    makeRounded(): Shape;
+    /**
+     * Create sizing and path information about a squared shape.
+     *
+     * @returns An object containing sizing and path information about a squared
+     *     shape for connections.
+     * @internal
+     */
+    makeSquared(): Shape;
+    shapeFor(connection: RenderedConnection): Shape;
+    makeNotch(): {
+        type: number;
+        width: any;
+        height: any;
+        pathLeft: string;
+        pathRight: string;
+    };
+    makeInsideCorners(): {
+        width: any;
+        height: any;
+        pathTop: string;
+        pathBottom: string;
+        rightWidth: any;
+        rightHeight: any;
+        pathTopRight: string;
+        pathBottomRight: string;
+    };
+    generateSecondaryColour_(colour: string): string;
+    generateTertiaryColour_(colour: string): string;
+    createDom(svg: SVGElement, tagName: string, selector: string): void;
+    getCSS_(selector: string): string[];
+}
+//# sourceMappingURL=constants.d.ts.map