blockly 9.3.0-beta.0 → 9.3.1

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

@@ -12,13 +12,10 @@ import { RenderedConnection } from '../../rendered_connection.js';
  *
  * @param _root The root SVG element.
  * @param _constants The renderer's constants.
- * @alias Blockly.blockRendering.IPathObject
  */
 export interface IPathObject {
     /**
      * The primary path of the block.
-     *
-     * @internal
      */
     svgPath: SVGElement;
     /** The renderer's constant provider. */
@@ -39,7 +36,6 @@ export interface IPathObject {
      * Set the path generated by the renderer onto the respective SVG element.
      *
      * @param pathString The path.
-     * @internal
      */
     setPath(pathString: string): void;
     /**
@@ -47,20 +43,16 @@ export interface IPathObject {
      * the paths belong to a shadow block.
      *
      * @param block The source block.
-     * @internal
      */
     applyColour(block: BlockSvg): void;
     /**
      * Update the style.
      *
      * @param blockStyle The block style to use.
-     * @internal
      */
     setStyle(blockStyle: BlockStyle): void;
     /**
      * Flip the SVG paths in RTL.
-     *
-     * @internal
      */
     flipRTL(): void;
     /**
@@ -68,7 +60,6 @@ export interface IPathObject {
      *
      * @param cursorSvg The SVG root of the cursor to be added to the block SVG
      *     group.
-     * @internal
      */
     setCursorSvg(cursorSvg: SVGElement): void;
     /**
@@ -76,7 +67,6 @@ export interface IPathObject {
      *
      * @param markerSvg The SVG root of the marker to be added to the block SVG
      *     group.
-     * @internal
      */
     setMarkerSvg(markerSvg: SVGElement): void;
     /**
@@ -84,14 +74,12 @@ export interface IPathObject {
      * often used to visually mark blocks currently being executed.
      *
      * @param highlighted True if highlighted.
-     * @internal
      */
     updateHighlighted(highlighted: boolean): void;
     /**
      * Add or remove styling showing that a block is selected.
      *
      * @param enable True if selection is enabled, false otherwise.
-     * @internal
      */
     updateSelected(enabled: boolean): void;
     /**
@@ -99,21 +87,18 @@ export interface IPathObject {
      *
      * @param enable True if the block is being dragged over a delete area, false
      *     otherwise.
-     * @internal
      */
     updateDraggingDelete(enabled: boolean): void;
     /**
      * Add or remove styling showing that a block is an insertion marker.
      *
      * @param enable True if the block is an insertion marker, false otherwise.
-     * @internal
      */
     updateInsertionMarker(enabled: boolean): void;
     /**
      * Add or remove styling showing that a block is movable.
      *
      * @param enable True if the block is movable, false otherwise.
-     * @internal
      */
     updateMovable(enabled: boolean): void;
     /**
@@ -122,7 +107,6 @@ export interface IPathObject {
      * Otherwise it will bump.
      *
      * @param enable True if styling should be added.
-     * @internal
      */
     updateReplacementFade(enabled: boolean): void;
     /**
@@ -131,7 +115,6 @@ export interface IPathObject {
      *
      * @param conn The connection on the input to highlight.
      * @param enable True if styling should be added.
-     * @internal
      */
     updateShapeForInputHighlight(conn: RenderedConnection, enable: boolean): void;
 }

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

@@ -21,8 +21,6 @@ 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.blockRendering.RenderInfo
  */
 export declare class RenderInfo {
     block_: BlockSvg;
@@ -57,14 +55,12 @@ export declare class RenderInfo {
     /**
      * @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;
     /**
@@ -74,8 +70,6 @@ export declare class RenderInfo {
      * 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.
-     *
-     * @internal
      */
     measure(): void;
     /**
@@ -85,16 +79,12 @@ export declare class RenderInfo {
     protected createRows_(): void;
     /**
      * Create all non-spacer elements that belong on the top row.
-     *
-     * @internal
      */
-    populateTopRow_(): void;
+    protected populateTopRow_(): void;
     /**
      * Create all non-spacer elements that belong on the bottom row.
-     *
-     * @internal
      */
-    populateBottomRow_(): void;
+    protected populateBottomRow_(): void;
     /**
      * Add an input element to the active row, if needed, and record the type of
      * the input on the row.

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

@@ -11,9 +11,8 @@ import type { RenderedConnection } from '../../rendered_connection.js';
 import type { WorkspaceSvg } from '../../workspace_svg.js';
 import type { ConstantProvider, Notch, PuzzleTab } from './constants.js';
 /**
- * Class for a marker.
- *
- * @alias Blockly.blockRendering.MarkerSvg
+ * Class for a marker, containing methods for graphically rendering a marker as
+ * SVG.
  */
 export declare class MarkerSvg {
     private readonly workspace;
@@ -64,7 +63,6 @@ export declare class MarkerSvg {
      * Create the DOM element for the marker.
      *
      * @returns The marker controls SVG group.
-     * @internal
      */
     createDom(): SVGElement;
     /**

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

@@ -11,49 +11,36 @@ import type { IPathObject } from './i_path_object.js';
 /**
  * An object that handles creating and setting each of the SVG elements
  * used by the renderer.
- *
- * @alias Blockly.blockRendering.PathObject
  */
 export declare class PathObject implements IPathObject {
     svgRoot: SVGElement;
-    /** @internal */
     svgPath: SVGElement;
     /**
      * Holds the cursors svg element when the cursor is attached to the block.
      * This is null if there is no cursor on the block.
-     *
-     * @internal
      */
     cursorSvg: SVGElement | null;
     /**
      * Holds the markers svg element when the marker is attached to the block.
      * This is null if there is no marker on the block.
-     *
-     * @internal
      */
     markerSvg: SVGElement | null;
-    /** @internal */
     constants: ConstantProvider;
-    /** @internal */
     style: BlockStyle;
     /**
      * @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);
     /**
      * Set the path generated by the renderer onto the respective SVG element.
      *
      * @param pathString The path.
-     * @internal
      */
     setPath(pathString: string): void;
     /**
      * Flip the SVG paths in RTL.
-     *
-     * @internal
      */
     flipRTL(): void;
     /**
@@ -61,7 +48,6 @@ export declare class PathObject implements IPathObject {
      *
      * @param cursorSvg The SVG root of the cursor to be added to the block SVG
      *     group.
-     * @internal
      */
     setCursorSvg(cursorSvg: SVGElement): void;
     /**
@@ -69,7 +55,6 @@ export declare class PathObject implements IPathObject {
      *
      * @param markerSvg The SVG root of the marker to be added to the block SVG
      *     group.
-     * @internal
      */
     setMarkerSvg(markerSvg: SVGElement): void;
     /**
@@ -77,14 +62,12 @@ export declare class PathObject implements IPathObject {
      * the paths belong to a shadow block.
      *
      * @param block The source block.
-     * @internal
      */
     applyColour(block: BlockSvg): void;
     /**
      * Set the style.
      *
      * @param blockStyle The block style to use.
-     * @internal
      */
     setStyle(blockStyle: BlockStyle): void;
     /**
@@ -100,7 +83,6 @@ export declare class PathObject implements IPathObject {
      * often used to visually mark blocks currently being executed.
      *
      * @param enable True if highlighted.
-     * @internal
      */
     updateHighlighted(enable: boolean): void;
     /**
@@ -119,7 +101,6 @@ export declare class PathObject implements IPathObject {
      * Add or remove styling showing that a block is selected.
      *
      * @param enable True if selection is enabled, false otherwise.
-     * @internal
      */
     updateSelected(enable: boolean): void;
     /**
@@ -127,21 +108,18 @@ export declare class PathObject implements IPathObject {
      *
      * @param enable True if the block is being dragged over a delete area, false
      *     otherwise.
-     * @internal
      */
     updateDraggingDelete(enable: boolean): void;
     /**
      * Add or remove styling showing that a block is an insertion marker.
      *
      * @param enable True if the block is an insertion marker, false otherwise.
-     * @internal
      */
     updateInsertionMarker(enable: boolean): void;
     /**
      * Add or remove styling showing that a block is movable.
      *
      * @param enable True if the block is movable, false otherwise.
-     * @internal
      */
     updateMovable(enable: boolean): void;
     /**
@@ -150,7 +128,6 @@ export declare class PathObject implements IPathObject {
      * Otherwise it will bump.
      *
      * @param enable True if styling should be added.
-     * @internal
      */
     updateReplacementFade(enable: boolean): void;
     /**
@@ -159,7 +136,6 @@ export declare class PathObject implements IPathObject {
      *
      * @param _conn The connection on the input to highlight.
      * @param _enable True if styling should be added.
-     * @internal
      */
     updateShapeForInputHighlight(_conn: Connection, _enable: boolean): void;
 }

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

@@ -19,30 +19,23 @@ import { RenderInfo } from './info.js';
 import { MarkerSvg } from './marker_svg.js';
 /**
  * The base class for a block renderer.
- *
- * @alias Blockly.blockRendering.Renderer
  */
 export declare class Renderer implements IRegistrable {
     /** The renderer's constant provider. */
     protected constants_: ConstantProvider;
-    /** @internal */
-    name: string;
+    protected name: string;
     /**
      * Rendering constant overrides, passed in through options.
-     *
-     * @internal
      */
-    overrides: object | null;
+    protected overrides: object | null;
     /**
      * @param name The renderer name.
-     * @internal
      */
     constructor(name: string);
     /**
      * Gets the class name that identifies this renderer.
      *
      * @returns The CSS class name.
-     * @internal
      */
     getClassName(): string;
     /**
@@ -50,13 +43,14 @@ export declare class Renderer implements IRegistrable {
      *
      * @param theme The workspace theme object.
      * @param opt_rendererOverrides Rendering constant overrides.
-     * @internal
      */
     init(theme: Theme, opt_rendererOverrides?: {
         [rendererConstant: string]: any;
     }): void;
     /**
      * Create any DOM elements that this renderer needs.
+     * If you need to create additional DOM elements, override the
+     * {@link ConstantProvider#createDom} method instead.
      *
      * @param svg The root of the workspace's SVG.
      * @param theme The workspace theme object.
@@ -68,14 +62,11 @@ export declare class Renderer implements IRegistrable {
      *
      * @param svg The root of the workspace's SVG.
      * @param theme The workspace theme object.
-     * @internal
      */
     refreshDom(svg: SVGElement, theme: Theme): void;
     /**
      * Dispose of this renderer.
      * Delete all DOM elements that this renderer and its constants created.
-     *
-     * @internal
      */
     dispose(): void;
     /**
@@ -114,7 +105,6 @@ export declare class Renderer implements IRegistrable {
      * @param workspace The workspace the marker belongs to.
      * @param marker The marker.
      * @returns The object in charge of drawing the marker.
-     * @internal
      */
     makeMarkerDrawer(workspace: WorkspaceSvg, marker: Marker): MarkerSvg;
     /**
@@ -123,7 +113,6 @@ export declare class Renderer implements IRegistrable {
      * @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): IPathObject;
     /**
@@ -131,7 +120,6 @@ export declare class Renderer implements IRegistrable {
      * called, the renderer has already been initialized.
      *
      * @returns The constant provider.
-     * @internal
      */
     getConstants(): ConstantProvider;
     /**
@@ -139,7 +127,6 @@ export declare class Renderer implements IRegistrable {
      *
      * @param _conn The connection to determine whether or not to highlight.
      * @returns True if we should highlight the connection.
-     * @internal
      */
     shouldHighlightConnection(_conn: Connection): boolean;
     /**
@@ -153,9 +140,8 @@ export declare class Renderer implements IRegistrable {
      * @param orphanBlock The orphan block that wants to find a home.
      * @param localType The type of the connection being dragged.
      * @returns Whether there is a home for the orphan or not.
-     * @internal
      */
-    orphanCanConnectAtEnd(topBlock: BlockSvg, orphanBlock: BlockSvg, localType: number): boolean;
+    protected orphanCanConnectAtEnd(topBlock: BlockSvg, orphanBlock: BlockSvg, localType: number): boolean;
     /**
      * Chooses a connection preview method based on the available connection, the
      * current dragged connection, and the block being dragged.
@@ -164,7 +150,6 @@ export declare class Renderer implements IRegistrable {
      * @param local The connection currently being dragged.
      * @param topBlock The block currently being dragged.
      * @returns The preview type to display.
-     * @internal
      */
     getConnectionPreviewMethod(closest: RenderedConnection, local: RenderedConnection, topBlock: BlockSvg): PreviewType;
     /**

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

@@ -6,8 +6,6 @@
 import { ConstantProvider as BaseConstantProvider } from '../common/constants.js';
 /**
  * An object that provides constants for rendering blocks in Geras mode.
- *
- * @alias Blockly.geras.ConstantProvider
  */
 export declare class ConstantProvider extends BaseConstantProvider {
     FIELD_TEXT_BASELINE_CENTER: boolean;
@@ -18,9 +16,6 @@ export declare class ConstantProvider extends BaseConstantProvider {
      */
     MAX_BOTTOM_WIDTH: number;
     STATEMENT_BOTTOM_SPACER: number;
-    /**
-     * @internal
-     */
     constructor();
     getCSS_(selector: string): string[];
 }

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

@@ -11,9 +11,8 @@ import { Highlighter } from './highlighter.js';
 import type { RenderInfo } from './info.js';
 import type { InlineInput } from './measurables/inline_input.js';
 /**
- * An object that draws a block based on the given rendering information.
- *
- * @alias Blockly.geras.Drawer
+ * An object that draws a block based on the given rendering information,
+ * customized for the geras renderer.
  */
 export declare class Drawer extends BaseDrawer {
     highlighter_: Highlighter;
@@ -22,7 +21,6 @@ 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);
     draw(): void;

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

@@ -46,8 +46,6 @@ 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 {
     constantProvider: ConstantProvider;
@@ -62,50 +60,41 @@ export declare class HighlightConstantProvider {
     START_HAT: StartHat;
     /**
      * @param constants The rendering constants provider.
-     * @internal
      */
     constructor(constants: ConstantProvider);
     /**
      * Initialize shape objects based on the constants set in the constructor.
-     *
-     * @internal
      */
     init(): void;
     /**
      * @returns An object containing sizing and path information about inside
      *     corner highlights.
-     * @internal
      */
-    makeInsideCorner(): InsideCorner;
+    protected makeInsideCorner(): InsideCorner;
     /**
      * @returns An object containing sizing and path information about outside
      *     corner highlights.
-     * @internal
      */
-    makeOutsideCorner(): OutsideCorner;
+    protected makeOutsideCorner(): OutsideCorner;
     /**
      * @returns An object containing sizing and path information about puzzle tab
      *     highlights.
-     * @internal
      */
-    makePuzzleTab(): PuzzleTab;
+    protected makePuzzleTab(): PuzzleTab;
     /**
      * @returns An object containing sizing and path information about notch
      *     highlights.
-     * @internal
      */
-    makeNotch(): Notch;
+    protected makeNotch(): Notch;
     /**
      * @returns An object containing sizing and path information about collapsed
      *     block edge highlights.
-     * @internal
      */
-    makeJaggedTeeth(): JaggedTeeth;
+    protected makeJaggedTeeth(): JaggedTeeth;
     /**
      * @returns An object containing sizing and path information about start
      *     highlights.
-     * @internal
      */
-    makeStartHat(): StartHat;
+    protected makeStartHat(): StartHat;
 }
 //# sourceMappingURL=highlight_constants.d.ts.map

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

@@ -20,8 +20,6 @@ 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 {
     info_: RenderInfo;
@@ -40,69 +38,58 @@ export declare class Highlighter {
     /**
      * @param info An object containing all information needed to render this
      *     block.
-     * @internal
      */
     constructor(info: RenderInfo);
     /**
      * Get 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;
 }

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

@@ -11,13 +11,12 @@ import type { Row } from '../measurables/row.js';
 import type { ConstantProvider } from './constants.js';
 import type { Renderer } from './renderer.js';
 /**
- * An object containing all sizing information needed to draw this block.
+ * An object containing all sizing information needed to draw this block,
+ * customized for the geras renderer.
  *
  * 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 {
     constants_: ConstantProvider;
@@ -25,14 +24,12 @@ 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;
     populateBottomRow_(): void;

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

@@ -10,15 +10,12 @@ 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 {
     constants_: GerasConstantProvider;
     /**
      * @param constants The rendering constants provider.
      * @param input The inline input to measure and store information for.
-     * @internal
      */
     constructor(constants: BaseConstantProvider, input: Input);
 }

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

@@ -10,15 +10,12 @@ 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 {
     constants_: GerasConstantProvider;
     /**
      * @param constants The rendering constants provider.
      * @param input The statement input to measure and store information for.
-     * @internal
      */
     constructor(constants: BaseConstantProvider, input: Input);
 }