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

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

@@ -1,4 +1,4 @@
-/** @fileoverview Re-exports of Blockly.geras.* modules. */
+/** @file Re-exports of Blockly.geras.* modules. */
 import { ConstantProvider } from './constants.js';
 import { Drawer } from './drawer.js';
 import { HighlightConstantProvider } from './highlight_constants.js';
@@ -8,4 +8,5 @@ import { InlineInput } from './measurables/inline_input.js';
 import { StatementInput } from './measurables/statement_input.js';
 import { PathObject } from './path_object.js';
 import { Renderer } from './renderer.js';
-export { ConstantProvider, Drawer, HighlightConstantProvider, Highlighter, InlineInput, PathObject, Renderer, RenderInfo, StatementInput };
+export { ConstantProvider, Drawer, HighlightConstantProvider, Highlighter, InlineInput, PathObject, Renderer, RenderInfo, StatementInput, };
+//# sourceMappingURL=geras.d.ts.map

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

@@ -46,6 +46,7 @@ export interface JaggedTeeth {
  * Some highlights are simple offsets of the parent paths and can be generated
  * programmatically.  Others, especially on curves, are just made out of piles
  * of constants and are hard to tweak.
+ *
  * @alias Blockly.geras.HighlightConstantProvider
  */
 export declare class HighlightConstantProvider {
@@ -66,43 +67,45 @@ export declare class HighlightConstantProvider {
     constructor(constants: ConstantProvider);
     /**
      * Initialize shape objects based on the constants set in the constructor.
+     *
      * @internal
      */
     init(): void;
     /**
-     * @return An object containing sizing and path information about inside
+     * @returns An object containing sizing and path information about inside
      *     corner highlights.
      * @internal
      */
     makeInsideCorner(): InsideCorner;
     /**
-     * @return An object containing sizing and path information about outside
+     * @returns An object containing sizing and path information about outside
      *     corner highlights.
      * @internal
      */
     makeOutsideCorner(): OutsideCorner;
     /**
-     * @return An object containing sizing and path information about puzzle tab
+     * @returns An object containing sizing and path information about puzzle tab
      *     highlights.
      * @internal
      */
     makePuzzleTab(): PuzzleTab;
     /**
-     * @return An object containing sizing and path information about notch
+     * @returns An object containing sizing and path information about notch
      *     highlights.
      * @internal
      */
     makeNotch(): Notch;
     /**
-     * @return An object containing sizing and path information about collapsed
+     * @returns An object containing sizing and path information about collapsed
      *     block edge highlights.
      * @internal
      */
     makeJaggedTeeth(): JaggedTeeth;
     /**
-     * @return An object containing sizing and path information about start
+     * @returns An object containing sizing and path information about start
      *     highlights.
      * @internal
      */
     makeStartHat(): StartHat;
 }
+//# sourceMappingURL=highlight_constants.d.ts.map

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

@@ -20,6 +20,7 @@ import type { InlineInput } from './measurables/inline_input.js';
  * position of each part of the block.  The resulting paths are not continuous
  * or closed paths.  The highlights for tabs and notches are loosely based on
  * tab and notch shapes, but are not exactly the same.
+ *
  * @alias Blockly.geras.Highlighter
  */
 export declare class Highlighter {
@@ -44,55 +45,65 @@ export declare class Highlighter {
     constructor(info: RenderInfo);
     /**
      * Get the steps for the highlight path.
-     * @return The steps for the highlight path.
+     *
+     * @returns The steps for the highlight path.
      * @internal
      */
     getPath(): string;
     /**
      * Add a highlight to the top corner of a block.
+     *
      * @param row The top row of the block.
      * @internal
      */
     drawTopCorner(row: TopRow): void;
     /**
      * Add a highlight on a jagged edge for a collapsed block.
+     *
      * @param row  The row to highlight.
      * @internal
      */
     drawJaggedEdge_(row: Row): void;
     /**
      * Add a highlight on a value input.
+     *
      * @param row The row the input belongs to.
      * @internal
      */
     drawValueInput(row: Row): void;
     /**
      * Add a highlight on a statement input.
+     *
      * @param row The row to highlight.
      * @internal
      */
     drawStatementInput(row: Row): void;
     /**
      * Add a highlight on the right side of a row.
+     *
      * @param row The row to highlight.
      * @internal
      */
     drawRightSideRow(row: Row): void;
     /**
      * Add a highlight to the bottom row.
+     *
      * @param row The row to highlight.
      * @internal
      */
     drawBottomRow(row: BottomRow): void;
     /**
      * Draw the highlight on the left side of the block.
+     *
      * @internal
      */
     drawLeft(): void;
     /**
      * Add a highlight to an inline input.
+     *
      * @param input The input to highlight.
      * @internal
      */
     drawInlineInput(input: InlineInput): void;
 }
+//# sourceMappingURL=highlighter.d.ts.map

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

@@ -16,6 +16,7 @@ import type { Renderer } from './renderer.js';
  * 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.geras.RenderInfo
  */
 export declare class RenderInfo extends BaseRenderInfo {
@@ -29,7 +30,8 @@ export declare class RenderInfo extends BaseRenderInfo {
     constructor(renderer: Renderer, block: BlockSvg);
     /**
      * Get the block renderer in use.
-     * @return The block renderer in use.
+     *
+     * @returns The block renderer in use.
      * @internal
      */
     getRenderer(): Renderer;
@@ -43,3 +45,4 @@ export declare class RenderInfo extends BaseRenderInfo {
     getDesiredRowWidth_(row: Row): number;
     finalize_(): void;
 }
+//# sourceMappingURL=info.d.ts.map

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

@@ -10,6 +10,7 @@ import type { ConstantProvider as GerasConstantProvider } from '../constants.js'
 /**
  * An object containing information about the space an inline input takes up
  * during rendering.
+ *
  * @alias Blockly.geras.InlineInput
  */
 export declare class InlineInput extends BaseInlineInput {
@@ -21,3 +22,4 @@ export declare class InlineInput extends BaseInlineInput {
      */
     constructor(constants: BaseConstantProvider, input: Input);
 }
+//# sourceMappingURL=inline_input.d.ts.map

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

@@ -10,6 +10,7 @@ import type { ConstantProvider as GerasConstantProvider } from '../constants.js'
 /**
  * An object containing information about the space a statement input takes up
  * during rendering.
+ *
  * @alias Blockly.geras.StatementInput
  */
 export declare class StatementInput extends BaseStatementInput {
@@ -21,3 +22,4 @@ export declare class StatementInput extends BaseStatementInput {
      */
     constructor(constants: BaseConstantProvider, input: Input);
 }
+//# sourceMappingURL=statement_input.d.ts.map

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

@@ -10,6 +10,7 @@ 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 {
@@ -20,6 +21,7 @@ export declare class PathObject extends BasePathObject {
     svgPathLight: SVGElement;
     /**
      * The colour of the dark path on the block in '#RRGGBB' format.
+     *
      * @internal
      */
     colourDark: string;
@@ -34,6 +36,7 @@ export declare class PathObject extends BasePathObject {
     setPath(mainPath: string): void;
     /**
      * Set the highlight path generated by the renderer onto the SVG element.
+     *
      * @param highlightPath The highlight path.
      * @internal
      */
@@ -45,3 +48,4 @@ export declare class PathObject extends BasePathObject {
     updateShadow_(shadow: boolean): void;
     updateDisabled_(disabled: boolean): void;
 }
+//# sourceMappingURL=path_object.d.ts.map

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

@@ -14,6 +14,7 @@ import { RenderInfo } from './info.js';
 import { PathObject } from './path_object.js';
 /**
  * The geras renderer.
+ *
  * @alias Blockly.geras.Renderer
  */
 export declare class Renderer extends BaseRenderer {
@@ -27,43 +28,52 @@ export declare class Renderer extends BaseRenderer {
     /**
      * Initialize the renderer.  Geras has a highlight provider in addition to
      * the normal constant provider.
+     *
      * @internal
      */
-    init(theme: Theme, opt_rendererOverrides: any): void;
+    init(theme: Theme, opt_rendererOverrides?: {
+        [rendererConstant: string]: any;
+    }): void;
     refreshDom(svg: SVGElement, theme: Theme): void;
     makeConstants_(): ConstantProvider;
     /**
      * Create a new instance of the renderer's render info object.
+     *
      * @param block The block to measure.
-     * @return The render info object.
+     * @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.
-     * @return The drawer.
+     * @returns The drawer.
      */
     protected makeDrawer_(block: BlockSvg, info: BaseRenderInfo): Drawer;
     /**
      * Create a new instance of a renderer path object.
+     *
      * @param root The root SVG element.
      * @param style The style object to use for colouring.
-     * @return The renderer path object.
+     * @returns The renderer path object.
      * @internal
      */
     makePathObject(root: SVGElement, style: BlockStyle): PathObject;
     /**
      * Create a new instance of the renderer's highlight constant provider.
-     * @return The highlight constant provider.
+     *
+     * @returns The highlight constant provider.
      */
     protected makeHighlightConstants_(): HighlightConstantProvider;
     /**
      * Get the renderer's highlight constant provider.  We assume that when this
      * is called, the renderer has already been initialized.
-     * @return The highlight constant provider.
+     *
+     * @returns The highlight constant provider.
      * @internal
      */
     getHighlightConstants(): HighlightConstantProvider;
 }
+//# sourceMappingURL=renderer.d.ts.map

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

@@ -8,6 +8,7 @@ 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 {
@@ -25,3 +26,4 @@ export declare class Measurable {
      */
     constructor(constants: ConstantProvider);
 }
+//# sourceMappingURL=base.d.ts.map

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

@@ -12,17 +12,19 @@ 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.
- * @struct
+ *
  * @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;
@@ -30,6 +32,7 @@ export declare class BottomRow extends Row {
      * 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;
@@ -45,17 +48,20 @@ export declare class BottomRow extends Row {
     constructor(constants: ConstantProvider);
     /**
      * Returns whether or not the bottom row has a left square corner.
+     *
      * @param block The block whose bottom row this represents.
-     * @return Whether or not the bottom row has a left square corner.
+     * @returns Whether or not the bottom row has a left square corner.
      */
     hasLeftSquareCorner(block: BlockSvg): boolean;
     /**
      * Returns whether or not the bottom row has a right square corner.
+     *
      * @param _block The block whose bottom row this represents.
-     * @return Whether or not the bottom row has a right square corner.
+     * @returns Whether or not the bottom row has a right square corner.
      */
     hasRightSquareCorner(_block: BlockSvg): boolean;
     measure(): void;
     startsWithElemSpacer(): boolean;
     endsWithElemSpacer(): boolean;
 }
+//# sourceMappingURL=bottom_row.d.ts.map

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

@@ -9,6 +9,7 @@ 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 {
@@ -23,3 +24,4 @@ export declare class Connection extends Measurable {
      */
     constructor(constants: ConstantProvider, connectionModel: RenderedConnection);
 }
+//# sourceMappingURL=connection.d.ts.map

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

@@ -9,7 +9,7 @@ import { InputConnection } from './input_connection.js';
 /**
  * An object containing information about the space an external value input
  * takes up during rendering
- * @struct
+ *
  * @alias Blockly.blockRendering.ExternalValueInput
  */
 export declare class ExternalValueInput extends InputConnection {
@@ -25,3 +25,4 @@ export declare class ExternalValueInput extends InputConnection {
      */
     constructor(constants: ConstantProvider, input: Input);
 }
+//# sourceMappingURL=external_value_input.d.ts.map

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

@@ -10,7 +10,7 @@ import { Measurable } from './base.js';
 /**
  * An object containing information about the space a field takes up during
  * rendering
- * @struct
+ *
  * @alias Blockly.blockRendering.Field
  */
 export declare class Field extends Measurable {
@@ -28,3 +28,4 @@ export declare class Field extends Measurable {
      */
     constructor(constants: ConstantProvider, field: BlocklyField, parentInput: Input);
 }
+//# sourceMappingURL=field.d.ts.map

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

@@ -8,7 +8,7 @@ import { Measurable } from './base.js';
 /**
  * An object containing information about the space a hat takes up during
  * rendering.
- * @struct
+ *
  * @alias Blockly.blockRendering.Hat
  */
 export declare class Hat extends Measurable {
@@ -19,3 +19,4 @@ export declare class Hat extends Measurable {
      */
     constructor(constants: ConstantProvider);
 }
+//# sourceMappingURL=hat.d.ts.map

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

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

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

@@ -8,7 +8,7 @@ import { Measurable } from './base.js';
 /**
  * An object containing information about a spacer between two elements on a
  * row.
- * @struct
+ *
  * @alias Blockly.blockRendering.InRowSpacer
  */
 export declare class InRowSpacer extends Measurable {
@@ -19,3 +19,4 @@ export declare class InRowSpacer extends Measurable {
      */
     constructor(constants: ConstantProvider, width: number);
 }
+//# sourceMappingURL=in_row_spacer.d.ts.map

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

@@ -9,7 +9,7 @@ import { InputConnection } from './input_connection.js';
 /**
  * An object containing information about the space an inline input takes up
  * during rendering
- * @struct
+ *
  * @alias Blockly.blockRendering.InlineInput
  */
 export declare class InlineInput extends InputConnection {
@@ -22,3 +22,4 @@ export declare class InlineInput extends InputConnection {
      */
     constructor(constants: ConstantProvider, input: Input);
 }
+//# sourceMappingURL=inline_input.d.ts.map

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

@@ -10,6 +10,7 @@ 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 {
@@ -27,3 +28,4 @@ export declare class InputConnection extends Connection {
      */
     constructor(constants: ConstantProvider, input: Input);
 }
+//# sourceMappingURL=input_connection.d.ts.map

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

@@ -7,12 +7,13 @@ 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.
- * @struct
+ *
  * @alias Blockly.blockRendering.InputRow
  */
 export declare class InputRow extends Row {
     /**
      * The total width of all blocks connected to this row.
+     *
      * @internal
      */
     connectedBlockWidths: number;
@@ -23,8 +24,10 @@ export declare class InputRow extends Row {
     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

@@ -8,7 +8,7 @@ import { Measurable } from './base.js';
 /**
  * An object containing information about the jagged edge of a collapsed block
  * takes up during rendering
- * @struct
+ *
  * @alias Blockly.blockRendering.JaggedEdge
  */
 export declare class JaggedEdge extends Measurable {
@@ -18,3 +18,4 @@ export declare class JaggedEdge extends Measurable {
      */
     constructor(constants: ConstantProvider);
 }
+//# sourceMappingURL=jagged_edge.d.ts.map

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

@@ -9,7 +9,7 @@ import { Connection } from './connection.js';
 /**
  * An object containing information about the space a next connection takes
  * up during rendering.
- * @struct
+ *
  * @alias Blockly.blockRendering.NextConnection
  */
 export declare class NextConnection extends Connection {
@@ -21,3 +21,4 @@ export declare class NextConnection extends Connection {
      */
     constructor(constants: ConstantProvider, connectionModel: RenderedConnection);
 }
+//# sourceMappingURL=next_connection.d.ts.map

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

@@ -9,7 +9,7 @@ import { Connection } from './connection.js';
 /**
  * An object containing information about the space an output connection takes
  * up during rendering.
- * @struct
+ *
  * @alias Blockly.blockRendering.OutputConnection
  */
 export declare class OutputConnection extends Connection {
@@ -24,3 +24,4 @@ export declare class OutputConnection extends Connection {
      */
     constructor(constants: ConstantProvider, connectionModel: RenderedConnection);
 }
+//# sourceMappingURL=output_connection.d.ts.map

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

@@ -9,7 +9,7 @@ import { Connection } from './connection.js';
 /**
  * An object containing information about the space a previous connection takes
  * up during rendering.
- * @struct
+ *
  * @alias Blockly.blockRendering.PreviousConnection
  */
 export declare class PreviousConnection extends Connection {
@@ -21,3 +21,4 @@ export declare class PreviousConnection extends Connection {
      */
     constructor(constants: ConstantProvider, connectionModel: RenderedConnection);
 }
+//# sourceMappingURL=previous_connection.d.ts.map

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

@@ -8,7 +8,7 @@ import { Measurable } from './base.js';
 /**
  * An object containing information about the space a rounded corner takes up
  * during rendering.
- * @struct
+ *
  * @alias Blockly.blockRendering.RoundCorner
  */
 export declare class RoundCorner extends Measurable {
@@ -19,3 +19,4 @@ export declare class RoundCorner extends Measurable {
      */
     constructor(constants: ConstantProvider, opt_position?: string);
 }
+//# sourceMappingURL=round_corner.d.ts.map