blockly 9.3.0-beta.0 → 9.3.0

package/core/renderers/geras/path_object.d.ts

@@ -10,26 +10,19 @@ import type { ConstantProvider } from './constants.js';
 /**
  * An object that handles creating and setting each of the SVG elements
  * used by the renderer.
- *
- * @alias Blockly.geras.PathObject
  */
 export declare class PathObject extends BasePathObject {
     constants: ConstantProvider;
-    /** @internal */
     svgPathDark: SVGElement;
-    /** @internal */
     svgPathLight: SVGElement;
     /**
      * The colour of the dark path on the block in '#RRGGBB' format.
-     *
-     * @internal
      */
     colourDark: string;
     /**
      * @param root The root SVG element.
      * @param style The style object to use for colouring.
      * @param constants The renderer's constants.
-     * @internal
      */
     constructor(root: SVGElement, style: BlockStyle, constants: ConstantProvider);
     setPath(mainPath: string): void;
@@ -37,7 +30,6 @@ export declare class PathObject extends BasePathObject {
      * Set the highlight path generated by the renderer onto the SVG element.
      *
      * @param highlightPath The highlight path.
-     * @internal
      */
     setHighlightPath(highlightPath: string): void;
     flipRTL(): void;

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

@@ -13,23 +13,23 @@ import { HighlightConstantProvider } from './highlight_constants.js';
 import { RenderInfo } from './info.js';
 import { PathObject } from './path_object.js';
 /**
- * The geras renderer.
+ * The geras renderer. This renderer was designed to be backwards compatible
+ * with pre-2019 Blockly. Newer projects that are not constrained by backwards
+ * compatibility should use thrasos, which is a more modern take on this
+ * renderer.
  *
- * @alias Blockly.geras.Renderer
+ * Geras is the ancient Greek spirit of old age.
  */
 export declare class Renderer extends BaseRenderer {
     /** The renderer's highlight constant provider. */
     private highlightConstants_;
     /**
      * @param name The renderer name.
-     * @internal
      */
     constructor(name: string);
     /**
      * Initialize the renderer.  Geras has a highlight provider in addition to
      * the normal constant provider.
-     *
-     * @internal
      */
     init(theme: Theme, opt_rendererOverrides?: {
         [rendererConstant: string]: any;
@@ -58,7 +58,6 @@ export declare class Renderer extends BaseRenderer {
      * @param root The root SVG element.
      * @param style The style object to use for colouring.
      * @returns The renderer path object.
-     * @internal
      */
     makePathObject(root: SVGElement, style: BlockStyle): PathObject;
     /**
@@ -72,7 +71,6 @@ export declare class Renderer extends BaseRenderer {
      * is called, the renderer has already been initialized.
      *
      * @returns The highlight constant provider.
-     * @internal
      */
     getHighlightConstants(): HighlightConstantProvider;
 }

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

@@ -8,8 +8,6 @@ import type { ConstantProvider } from '../common/constants.js';
  * The base class to represent a part of a block that takes up space during
  * rendering.  The constructor for each non-spacer Measurable records the size
  * of the block element (e.g. field, statement input).
- *
- * @alias Blockly.blockRendering.Measurable
  */
 export declare class Measurable {
     width: number;
@@ -22,7 +20,6 @@ export declare class Measurable {
     protected readonly constants_: ConstantProvider;
     /**
      * @param constants The rendering constants provider.
-     * @internal
      */
     constructor(constants: ConstantProvider);
 }

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

@@ -12,28 +12,20 @@ import { Row } from './row.js';
  * a block as well as spacing information for the bottom row.
  * Elements in a bottom row can consist of corners, spacers and next
  * connections.
- *
- * @alias Blockly.blockRendering.BottomRow
  */
 export declare class BottomRow extends Row {
     /**
      * Whether this row has a next connection.
-     *
-     * @internal
      */
     hasNextConnection: boolean;
     /**
      * The next connection on the row, if any.
-     *
-     * @internal
      */
     connection: NextConnection | null;
     /**
      * The amount that the bottom of the block extends below the horizontal
      * edge, e.g. because of a next connection.  Must be non-negative (see
      * #2820).
-     *
-     * @internal
      */
     descenderHeight: number;
     /**
@@ -43,7 +35,6 @@ export declare class BottomRow extends Row {
     baseline: number;
     /**
      * @param constants The rendering constants provider.
-     * @internal
      */
     constructor(constants: ConstantProvider);
     /**

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

@@ -9,8 +9,6 @@ import { Measurable } from './base.js';
 /**
  * The base class to represent a connection and the space that it takes up on
  * the block.
- *
- * @alias Blockly.blockRendering.Connection
  */
 export declare class Connection extends Measurable {
     connectionModel: RenderedConnection;
@@ -20,7 +18,6 @@ export declare class Connection extends Measurable {
      * @param constants The rendering constants provider.
      * @param connectionModel The connection object on the block that this
      *     represents.
-     * @internal
      */
     constructor(constants: ConstantProvider, connectionModel: RenderedConnection);
 }

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

@@ -9,8 +9,6 @@ import { InputConnection } from './input_connection.js';
 /**
  * An object containing information about the space an external value input
  * takes up during rendering
- *
- * @alias Blockly.blockRendering.ExternalValueInput
  */
 export declare class ExternalValueInput extends InputConnection {
     height: number;
@@ -21,7 +19,6 @@ export declare class ExternalValueInput extends InputConnection {
     /**
      * @param constants The rendering constants provider.
      * @param input The external value input to measure and store information for.
-     * @internal
      */
     constructor(constants: ConstantProvider, input: Input);
 }

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

@@ -10,8 +10,6 @@ import { Measurable } from './base.js';
 /**
  * An object containing information about the space a field takes up during
  * rendering
- *
- * @alias Blockly.blockRendering.Field
  */
 export declare class Field extends Measurable {
     field: BlocklyField;
@@ -24,7 +22,6 @@ export declare class Field extends Measurable {
      * @param constants The rendering constants provider.
      * @param field The field to measure and store information for.
      * @param parentInput The parent input for the field.
-     * @internal
      */
     constructor(constants: ConstantProvider, field: BlocklyField, parentInput: Input);
 }

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

@@ -8,14 +8,11 @@ import { Measurable } from './base.js';
 /**
  * An object containing information about the space a hat takes up during
  * rendering.
- *
- * @alias Blockly.blockRendering.Hat
  */
 export declare class Hat extends Measurable {
     ascenderHeight: number;
     /**
      * @param constants The rendering constants provider.
-     * @internal
      */
     constructor(constants: ConstantProvider);
 }

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

@@ -8,9 +8,7 @@ import type { ConstantProvider } from '../common/constants.js';
 import { Measurable } from './base.js';
 /**
  * An object containing information about the space an icon takes up during
- * rendering
- *
- * @alias Blockly.blockRendering.Icon
+ * rendering.
  */
 export declare class Icon extends Measurable {
     icon: BlocklyIcon;
@@ -18,11 +16,10 @@ export declare class Icon extends Measurable {
     flipRtl: boolean;
     /**
      * An object containing information about the space an icon takes up during
-     * rendering
+     * rendering.
      *
      * @param constants The rendering constants provider.
      * @param icon The icon to measure and store information for.
-     * @internal
      */
     constructor(constants: ConstantProvider, icon: BlocklyIcon);
 }

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

@@ -8,14 +8,11 @@ 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);
 }

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

@@ -8,9 +8,7 @@ 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
+ * during rendering.
  */
 export declare class InlineInput extends InputConnection {
     connectionHeight: number;
@@ -18,7 +16,6 @@ export declare class InlineInput extends InputConnection {
     /**
      * @param constants The rendering constants provider.
      * @param input The inline input to measure and store information for.
-     * @internal
      */
     constructor(constants: ConstantProvider, input: Input);
 }

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

@@ -9,9 +9,7 @@ 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
+ * during rendering.
  */
 export declare class InputConnection extends Connection {
     input: Input;
@@ -24,7 +22,6 @@ export declare class InputConnection extends Connection {
     /**
      * @param constants The rendering constants provider.
      * @param input The input to measure and store information for.
-     * @internal
      */
     constructor(constants: ConstantProvider, input: Input);
 }

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

@@ -7,25 +7,18 @@ 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;

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

@@ -6,15 +6,12 @@
 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
+ * An object containing information about the space the jagged edge of a
+ * collapsed block takes up during rendering.
  */
 export declare class JaggedEdge extends Measurable {
     /**
      * @param constants The rendering constants provider.
-     * @internal
      */
     constructor(constants: ConstantProvider);
 }

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

@@ -9,15 +9,12 @@ 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);
 }

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

@@ -9,8 +9,6 @@ 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;
@@ -20,7 +18,6 @@ export declare class OutputConnection 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);
 }

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

@@ -9,15 +9,12 @@ 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);
 }

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

@@ -8,14 +8,11 @@ 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);
 }

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

@@ -10,75 +10,52 @@ 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;
     /**
@@ -89,74 +66,58 @@ export declare class Row {
     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 | null;
     /**
      * 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 | null;
     /**
      * Convenience method to get the last spacer element on this row.
      *
      * @returns The last spacer element on this row.
-     * @internal
      */
     getLastSpacer(): InRowSpacer | null;
 }

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

@@ -8,8 +8,6 @@ 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;
@@ -22,7 +20,6 @@ export declare class SpacerRow extends Row {
      * @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;

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

@@ -8,14 +8,11 @@ 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);
 }

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

@@ -9,14 +9,11 @@ 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);
 }

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

@@ -14,16 +14,12 @@ import { Row } from './row.js';
  * 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. */
@@ -34,7 +30,6 @@ export declare class TopRow extends Row {
     connection: PreviousConnection | null;
     /**
      * @param constants The rendering constants provider.
-     * @internal
      */
     constructor(constants: ConstantProvider);
     /**
@@ -42,7 +37,6 @@ export declare class TopRow extends Row {
      *
      * @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;
     /**