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

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

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ConstantProvider } from '../common/constants.js';
+import { Measurable } from './base.js';
+/**
+ * An object containing information about a spacer between two elements on a
+ * row.
+ *
+ * @alias Blockly.blockRendering.InRowSpacer
+ */
+export declare class InRowSpacer extends Measurable {
+    /**
+     * @param constants The rendering constants provider.
+     * @param width The width of the spacer.
+     * @internal
+     */
+    constructor(constants: ConstantProvider, width: number);
+}
+//# sourceMappingURL=in_row_spacer.d.ts.map

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

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Input } from '../../input.js';
+import type { ConstantProvider } from '../common/constants.js';
+import { InputConnection } from './input_connection.js';
+/**
+ * An object containing information about the space an inline input takes up
+ * during rendering
+ *
+ * @alias Blockly.blockRendering.InlineInput
+ */
+export declare class InlineInput extends InputConnection {
+    connectionHeight: number;
+    connectionWidth: number;
+    /**
+     * @param constants The rendering constants provider.
+     * @param input The inline input to measure and store information for.
+     * @internal
+     */
+    constructor(constants: ConstantProvider, input: Input);
+}
+//# sourceMappingURL=inline_input.d.ts.map

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

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from '../../block_svg.js';
+import type { Input } from '../../input.js';
+import type { ConstantProvider } from '../common/constants.js';
+import { Connection } from './connection.js';
+/**
+ * The base class to represent an input that takes up space on a block
+ * during rendering
+ *
+ * @alias Blockly.blockRendering.InputConnection
+ */
+export declare class InputConnection extends Connection {
+    input: Input;
+    align: number;
+    connectedBlock: BlockSvg | null;
+    connectedBlockWidth: number;
+    connectedBlockHeight: number;
+    connectionOffsetX: number;
+    connectionOffsetY: number;
+    /**
+     * @param constants The rendering constants provider.
+     * @param input The input to measure and store information for.
+     * @internal
+     */
+    constructor(constants: ConstantProvider, input: Input);
+}
+//# sourceMappingURL=input_connection.d.ts.map

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

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ConstantProvider } from '../common/constants.js';
+import { Row } from './row.js';
+/**
+ * An object containing information about a row that holds one or more inputs.
+ *
+ * @alias Blockly.blockRendering.InputRow
+ */
+export declare class InputRow extends Row {
+    /**
+     * The total width of all blocks connected to this row.
+     *
+     * @internal
+     */
+    connectedBlockWidths: number;
+    /**
+     * @param constants The rendering constants provider.
+     * @internal
+     */
+    constructor(constants: ConstantProvider);
+    /**
+     * Inspect all subcomponents and populate all size properties on the row.
+     *
+     * @internal
+     */
+    measure(): void;
+    endsWithElemSpacer(): boolean;
+}
+//# sourceMappingURL=input_row.d.ts.map

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

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ConstantProvider } from '../common/constants.js';
+import { Measurable } from './base.js';
+/**
+ * An object containing information about the jagged edge of a collapsed block
+ * takes up during rendering
+ *
+ * @alias Blockly.blockRendering.JaggedEdge
+ */
+export declare class JaggedEdge extends Measurable {
+    /**
+     * @param constants The rendering constants provider.
+     * @internal
+     */
+    constructor(constants: ConstantProvider);
+}
+//# sourceMappingURL=jagged_edge.d.ts.map

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

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { RenderedConnection } from '../../rendered_connection.js';
+import type { ConstantProvider } from '../common/constants.js';
+import { Connection } from './connection.js';
+/**
+ * An object containing information about the space a next connection takes
+ * up during rendering.
+ *
+ * @alias Blockly.blockRendering.NextConnection
+ */
+export declare class NextConnection extends Connection {
+    /**
+     * @param constants The rendering constants provider.
+     * @param connectionModel The connection object on the block that this
+     *     represents.
+     * @internal
+     */
+    constructor(constants: ConstantProvider, connectionModel: RenderedConnection);
+}
+//# sourceMappingURL=next_connection.d.ts.map

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

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { RenderedConnection } from '../../rendered_connection.js';
+import type { ConstantProvider } from '../common/constants.js';
+import { Connection } from './connection.js';
+/**
+ * An object containing information about the space an output connection takes
+ * up during rendering.
+ *
+ * @alias Blockly.blockRendering.OutputConnection
+ */
+export declare class OutputConnection extends Connection {
+    startX: number;
+    connectionOffsetY: number;
+    connectionOffsetX: number;
+    /**
+     * @param constants The rendering constants provider.
+     * @param connectionModel The connection object on the block that this
+     *     represents.
+     * @internal
+     */
+    constructor(constants: ConstantProvider, connectionModel: RenderedConnection);
+}
+//# sourceMappingURL=output_connection.d.ts.map

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

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { RenderedConnection } from '../../rendered_connection.js';
+import type { ConstantProvider } from '../common/constants.js';
+import { Connection } from './connection.js';
+/**
+ * An object containing information about the space a previous connection takes
+ * up during rendering.
+ *
+ * @alias Blockly.blockRendering.PreviousConnection
+ */
+export declare class PreviousConnection extends Connection {
+    /**
+     * @param constants The rendering constants provider.
+     * @param connectionModel The connection object on the block that this
+     *     represents.
+     * @internal
+     */
+    constructor(constants: ConstantProvider, connectionModel: RenderedConnection);
+}
+//# sourceMappingURL=previous_connection.d.ts.map

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

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ConstantProvider } from '../common/constants.js';
+import { Measurable } from './base.js';
+/**
+ * An object containing information about the space a rounded corner takes up
+ * during rendering.
+ *
+ * @alias Blockly.blockRendering.RoundCorner
+ */
+export declare class RoundCorner extends Measurable {
+    /**
+     * @param constants The rendering constants provider.
+     * @param opt_position The position of this corner.
+     * @internal
+     */
+    constructor(constants: ConstantProvider, opt_position?: string);
+}
+//# sourceMappingURL=round_corner.d.ts.map

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

@@ -0,0 +1,163 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ConstantProvider } from '../common/constants.js';
+import type { Measurable } from './base.js';
+import type { InRowSpacer } from './in_row_spacer.js';
+import type { InputConnection } from './input_connection.js';
+/**
+ * An object representing a single row on a rendered block and all of its
+ * subcomponents.
+ *
+ * @alias Blockly.blockRendering.Row
+ */
+export declare class Row {
+    /** @internal */
+    type: number;
+    /**
+     * An array of elements contained in this row.
+     *
+     * @internal
+     */
+    elements: Measurable[];
+    /**
+     * The height of the row.
+     *
+     * @internal
+     */
+    height: number;
+    /**
+     * The width of the row, from the left edge of the block to the right.
+     * Does not include child blocks unless they are inline.
+     *
+     * @internal
+     */
+    width: number;
+    /**
+     * The minimum height of the row.
+     *
+     * @internal
+     */
+    minHeight: number;
+    /**
+     * The minimum width of the row, from the left edge of the block to the
+     * right. Does not include child blocks unless they are inline.
+     *
+     * @internal
+     */
+    minWidth: number;
+    /**
+     * The width of the row, from the left edge of the block to the edge of the
+     * block or any connected child blocks.
+     *
+     * @internal
+     */
+    widthWithConnectedBlocks: number;
+    /**
+     * The Y position of the row relative to the origin of the block's svg
+     * group.
+     *
+     * @internal
+     */
+    yPos: number;
+    /**
+     * The X position of the row relative to the origin of the block's svg
+     * group.
+     *
+     * @internal
+     */
+    xPos: number;
+    /**
+     * Whether the row has any external inputs.
+     *
+     * @internal
+     */
+    hasExternalInput: boolean;
+    /**
+     * Whether the row has any statement inputs.
+     *
+     * @internal
+     */
+    hasStatement: boolean;
+    /**
+     * Where the left edge of all of the statement inputs on the block should
+     * be. This makes sure that statement inputs which are proceded by fields
+     * of varius widths are all aligned.
+     */
+    statementEdge: number;
+    /**
+     * Whether the row has any inline inputs.
+     *
+     * @internal
+     */
+    hasInlineInput: boolean;
+    /**
+     * Whether the row has any dummy inputs.
+     *
+     * @internal
+     */
+    hasDummyInput: boolean;
+    /**
+     * Whether the row has a jagged edge.
+     *
+     * @internal
+     */
+    hasJaggedEdge: boolean;
+    notchOffset: number;
+    /**
+     * Alignment of the row.
+     *
+     * @internal
+     */
+    align: number | null;
+    protected readonly constants_: ConstantProvider;
+    /**
+     * @param constants The rendering constants provider.
+     * @internal
+     */
+    constructor(constants: ConstantProvider);
+    /**
+     * Get the last input on this row, if it has one.
+     *
+     * @returns The last input on the row, or null.
+     * @internal
+     */
+    getLastInput(): InputConnection;
+    /**
+     * Inspect all subcomponents and populate all size properties on the row.
+     *
+     * @internal
+     */
+    measure(): void;
+    /**
+     * Determines whether this row should start with an element spacer.
+     *
+     * @returns Whether the row should start with a spacer.
+     * @internal
+     */
+    startsWithElemSpacer(): boolean;
+    /**
+     * Determines whether this row should end with an element spacer.
+     *
+     * @returns Whether the row should end with a spacer.
+     * @internal
+     */
+    endsWithElemSpacer(): boolean;
+    /**
+     * Convenience method to get the first spacer element on this row.
+     *
+     * @returns The first spacer element on this row.
+     * @internal
+     */
+    getFirstSpacer(): InRowSpacer;
+    /**
+     * Convenience method to get the last spacer element on this row.
+     *
+     * @returns The last spacer element on this row.
+     * @internal
+     */
+    getLastSpacer(): InRowSpacer;
+}
+//# sourceMappingURL=row.d.ts.map

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

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ConstantProvider } from '../common/constants.js';
+import { InRowSpacer } from './in_row_spacer.js';
+import { Row } from './row.js';
+/**
+ * An object containing information about a spacer between two rows.
+ *
+ * @alias Blockly.blockRendering.SpacerRow
+ */
+export declare class SpacerRow extends Row {
+    height: number;
+    width: number;
+    followsStatement: boolean;
+    precedesStatement: boolean;
+    widthWithConnectedBlocks: number;
+    elements: InRowSpacer[];
+    /**
+     * @param constants The rendering constants provider.
+     * @param height The height of the spacer.
+     * @param width The width of the spacer.
+     * @internal
+     */
+    constructor(constants: ConstantProvider, height: number, width: number);
+    measure(): void;
+}
+//# sourceMappingURL=spacer_row.d.ts.map

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

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ConstantProvider } from '../common/constants.js';
+import { Measurable } from './base.js';
+/**
+ * An object containing information about the space a square corner takes up
+ * during rendering.
+ *
+ * @alias Blockly.blockRendering.SquareCorner
+ */
+export declare class SquareCorner extends Measurable {
+    /**
+     * @param constants The rendering constants provider.
+     * @param opt_position The position of this corner.
+     * @internal
+     */
+    constructor(constants: ConstantProvider, opt_position?: string);
+}
+//# sourceMappingURL=square_corner.d.ts.map

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

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Input } from '../../input.js';
+import type { ConstantProvider } from '../common/constants.js';
+import { InputConnection } from './input_connection.js';
+/**
+ * An object containing information about the space a statement input takes up
+ * during rendering
+ *
+ * @alias Blockly.blockRendering.StatementInput
+ */
+export declare class StatementInput extends InputConnection {
+    /**
+     * @param constants The rendering constants provider.
+     * @param input The statement input to measure and store information for.
+     * @internal
+     */
+    constructor(constants: ConstantProvider, input: Input);
+}
+//# sourceMappingURL=statement_input.d.ts.map

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

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from '../../block_svg.js';
+import type { ConstantProvider } from '../common/constants.js';
+import type { PreviousConnection } from './previous_connection.js';
+import { Row } from './row.js';
+/**
+ * An object containing information about what elements are in the top row of a
+ * block as well as sizing information for the top row.
+ * Elements in a top row can consist of corners, hats, spacers, and previous
+ * connections.
+ * After this constructor is called, the row will contain all non-spacer
+ * elements it needs.
+ *
+ * @alias Blockly.blockRendering.TopRow
+ */
+export declare class TopRow extends Row {
+    /**
+     * The starting point for drawing the row, in the y direction.
+     * This allows us to draw hats and similar shapes that don't start at the
+     * origin. Must be non-negative (see #2820).
+     *
+     * @internal
+     */
+    capline: number;
+    /** How much the row extends up above its capline. */
+    ascenderHeight: number;
+    /** Whether the block has a previous connection. */
+    hasPreviousConnection: boolean;
+    /** The previous connection on the block, if any. */
+    connection: PreviousConnection | null;
+    widthWithConnectedBlocks: any;
+    /**
+     * @param constants The rendering constants provider.
+     * @internal
+     */
+    constructor(constants: ConstantProvider);
+    /**
+     * Returns whether or not the top row has a left square corner.
+     *
+     * @param block The block whose top row this represents.
+     * @returns Whether or not the top row has a left square corner.
+     * @internal
+     */
+    hasLeftSquareCorner(block: BlockSvg): boolean;
+    /**
+     * Returns whether or not the top row has a right square corner.
+     *
+     * @param _block The block whose top row this represents.
+     * @returns Whether or not the top row has a right square corner.
+     */
+    hasRightSquareCorner(_block: BlockSvg): boolean;
+    measure(): void;
+    startsWithElemSpacer(): boolean;
+    endsWithElemSpacer(): boolean;
+}
+//# sourceMappingURL=top_row.d.ts.map