blockly 9.3.0-beta.0 → 9.3.1

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

@@ -7,8 +7,6 @@ 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;
@@ -39,14 +37,10 @@ declare class TypesContainer {
     INPUT_ROW: number;
     /**
      * A Left Corner Union Type.
-     *
-     * @internal
      */
     LEFT_CORNER: number;
     /**
      * A Right Corner Union Type.
-     *
-     * @internal
      */
     RIGHT_CORNER: number;
     /**
@@ -61,7 +55,6 @@ declare class TypesContainer {
      *
      * @param type The name of the type.
      * @returns The enum flag value associated with that type.
-     * @internal
      */
     getType(type: string): number;
     /**
@@ -69,7 +62,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about a field.
-     * @internal
      */
     isField(elem: Measurable): number;
     /**
@@ -77,7 +69,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about a hat.
-     * @internal
      */
     isHat(elem: Measurable): number;
     /**
@@ -85,7 +76,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about an icon.
-     * @internal
      */
     isIcon(elem: Measurable): number;
     /**
@@ -93,7 +83,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about a spacer.
-     * @internal
      */
     isSpacer(elem: Measurable | Row): number;
     /**
@@ -101,7 +90,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about an in-row spacer.
-     * @internal
      */
     isInRowSpacer(elem: Measurable): number;
     /**
@@ -109,7 +97,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about an input.
-     * @internal
      */
     isInput(elem: Measurable): number;
     /**
@@ -117,7 +104,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about an external input.
-     * @internal
      */
     isExternalInput(elem: Measurable): number;
     /**
@@ -125,7 +111,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about an inline input.
-     * @internal
      */
     isInlineInput(elem: Measurable): number;
     /**
@@ -133,7 +118,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about a statement input.
-     * @internal
      */
     isStatementInput(elem: Measurable): number;
     /**
@@ -141,7 +125,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about a previous connection.
-     * @internal
      */
     isPreviousConnection(elem: Measurable): number;
     /**
@@ -149,7 +132,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about a next connection.
-     * @internal
      */
     isNextConnection(elem: Measurable): number;
     /**
@@ -159,7 +141,6 @@ declare class TypesContainer {
      * @param elem The element to check.
      * @returns 1 if the object stores information about a previous or next
      *     connection.
-     * @internal
      */
     isPreviousOrNextConnection(elem: Measurable): number;
     /**
@@ -167,7 +148,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about a left round corner.
-     * @internal
      */
     isLeftRoundedCorner(elem: Measurable): number;
     /**
@@ -175,7 +155,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about a right round corner.
-     * @internal
      */
     isRightRoundedCorner(elem: Measurable): number;
     /**
@@ -183,7 +162,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about a left square corner.
-     * @internal
      */
     isLeftSquareCorner(elem: Measurable): number;
     /**
@@ -191,7 +169,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about a right square corner.
-     * @internal
      */
     isRightSquareCorner(elem: Measurable): number;
     /**
@@ -199,7 +176,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about a corner.
-     * @internal
      */
     isCorner(elem: Measurable): number;
     /**
@@ -207,7 +183,6 @@ declare class TypesContainer {
      *
      * @param elem The element to check.
      * @returns 1 if the object stores information about a jagged edge.
-     * @internal
      */
     isJaggedEdge(elem: Measurable): number;
     /**
@@ -215,7 +190,6 @@ declare class TypesContainer {
      *
      * @param row The row to check.
      * @returns 1 if the object stores information about a row.
-     * @internal
      */
     isRow(row: Row): number;
     /**
@@ -223,7 +197,6 @@ declare class TypesContainer {
      *
      * @param row The row to check.
      * @returns 1 if the object stores information about a between-row spacer.
-     * @internal
      */
     isBetweenRowSpacer(row: Row): number;
     /**
@@ -231,7 +204,6 @@ declare class TypesContainer {
      *
      * @param row The row to check.
      * @returns 1 if the object stores information about a top row.
-     * @internal
      */
     isTopRow(row: Row): number;
     /**
@@ -239,7 +211,6 @@ declare class TypesContainer {
      *
      * @param row The row to check.
      * @returns 1 if the object stores information about a bottom row.
-     * @internal
      */
     isBottomRow(row: Row): number;
     /**
@@ -247,7 +218,6 @@ declare class TypesContainer {
      *
      * @param row The row to check.
      * @returns 1 if the object stores information about a top or bottom row.
-     * @internal
      */
     isTopOrBottomRow(row: Row): number;
     /**
@@ -255,7 +225,6 @@ declare class TypesContainer {
      *
      * @param row The row to check.
      * @returns 1 if the object stores information about an input row.
-     * @internal
      */
     isInputRow(row: Row): number;
 }

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

@@ -5,12 +5,10 @@
  */
 import { ConstantProvider as BaseConstantProvider } from '../common/constants.js';
 /**
- * An object that provides constants for rendering blocks in the sample.
- *
- * @alias Blockly.minimalist.ConstantProvider
+ * An object that provides constants for rendering blocks in the minimalist
+ * renderer.
  */
 export declare class ConstantProvider extends BaseConstantProvider {
-    /** @internal */
     constructor();
 }
 //# sourceMappingURL=constants.d.ts.map

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

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

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

@@ -12,22 +12,18 @@ 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.minimalist.RenderInfo
  */
 export declare class RenderInfo extends BaseRenderInfo {
     protected renderer_: Renderer;
     /**
      * @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;
 }

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

@@ -11,13 +11,10 @@ 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);
     /**

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

@@ -14,22 +14,18 @@ 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.thrasos.RenderInfo
  */
 export declare class RenderInfo extends BaseRenderInfo {
     protected renderer_: Renderer;
     /**
      * @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;

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

@@ -7,14 +7,14 @@ import type { BlockSvg } from '../../block_svg.js';
 import { Renderer as BaseRenderer } from '../common/renderer.js';
 import { RenderInfo } from './info.js';
 /**
- * The thrasos renderer.
+ * The thrasos renderer. This is a more modern take on the legacy geras
+ * renderer.
  *
- * @alias Blockly.thrasos.Renderer
+ * Thrasos is the ancient Greek spirit of boldness.
  */
 export declare class Renderer extends BaseRenderer {
     /**
      * @param name The renderer name.
-     * @internal
      */
     constructor(name: string);
     /**

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

@@ -20,8 +20,6 @@ export interface InsideCorners {
 }
 /**
  * An object that provides constants for rendering blocks in Zelos mode.
- *
- * @alias Blockly.zelos.ConstantProvider
  */
 export declare class ConstantProvider extends BaseConstantProvider {
     GRID_UNIT: number;
@@ -29,8 +27,6 @@ export declare class ConstantProvider extends BaseConstantProvider {
     CURSOR_COLOUR: string;
     /**
      * Radius of the cursor for input and output connections.
-     *
-     * @internal
      */
     CURSOR_RADIUS: number;
     JAGGED_TEETH_HEIGHT: number;
@@ -50,8 +46,6 @@ export declare class ConstantProvider extends BaseConstantProvider {
      * When a block with the outer shape contains an input block with the inner
      * shape on its left or right edge, the block elements are aligned such that
      * the padding specified is reached.
-     *
-     * @internal
      */
     SHAPE_IN_SHAPE_PADDING: {
         [key: number]: {
@@ -78,8 +72,6 @@ export declare class ConstantProvider extends BaseConstantProvider {
     /**
      * The ID of the selected glow filter, or the empty string if no filter is
      * set.
-     *
-     * @internal
      */
     selectedGlowFilterId: string;
     /**
@@ -89,8 +81,6 @@ export declare class ConstantProvider extends BaseConstantProvider {
     /**
      * The ID of the replacement glow filter, or the empty string if no filter
      * is set.
-     *
-     * @internal
      */
     replacementGlowFilterId: string;
     /**
@@ -112,7 +102,6 @@ export declare class ConstantProvider extends BaseConstantProvider {
      * rectangular reporter block. Null before init is called.
      */
     SQUARED: Shape | null;
-    /** @internal */
     constructor();
     setFontConstants_(theme: Theme): void;
     init(): void;
@@ -128,25 +117,22 @@ export declare class ConstantProvider extends BaseConstantProvider {
      *
      * @returns An object containing sizing and path information about a hexagonal
      *     shape for connections.
-     * @internal
      */
-    makeHexagonal(): Shape;
+    protected 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;
+    protected 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;
+    protected makeSquared(): Shape;
     shapeFor(connection: RenderedConnection): Shape;
     makeNotch(): {
         type: number;

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

@@ -10,8 +10,6 @@ import type { Row } from '../measurables/row.js';
 import type { RenderInfo } from './info.js';
 /**
  * An object that draws a block based on the given rendering information.
- *
- * @alias Blockly.zelos.Drawer
  */
 export declare class Drawer extends BaseDrawer {
     info_: RenderInfo;
@@ -19,7 +17,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/zelos/info.d.ts

@@ -19,8 +19,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.zelos.RenderInfo
  */
 export declare class RenderInfo extends BaseRenderInfo {
     topRow: TopRow;
@@ -35,14 +33,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;
     measure(): void;

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

@@ -11,8 +11,6 @@ import { MarkerSvg as BaseMarkerSvg } from '../common/marker_svg.js';
 import type { ConstantProvider as ZelosConstantProvider } from './constants.js';
 /**
  * Class to draw a marker.
- *
- * @alias Blockly.zelos.MarkerSvg
  */
 export declare class MarkerSvg extends BaseMarkerSvg {
     constants_: ZelosConstantProvider;

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

@@ -11,13 +11,10 @@ import { BottomRow as BaseBottomRow } from '../../../renderers/measurables/botto
  * a block as well as spacing information for the top row.
  * Elements in a bottom row can consist of corners, spacers and next
  * connections.
- *
- * @alias Blockly.zelos.BottomRow
  */
 export declare class BottomRow extends BaseBottomRow {
     /**
      * @param constants The rendering constants provider.
-     * @internal
      */
     constructor(constants: ConstantProvider);
     endsWithElemSpacer(): boolean;

package/core/renderers/zelos/measurables/inputs.d.ts

@@ -9,15 +9,12 @@ import { StatementInput as BaseStatementInput } from '../../../renderers/measura
 /**
  * An object containing information about the space a statement input takes up
  * during rendering.
- *
- * @alias Blockly.zelos.StatementInput
  */
 export declare class StatementInput extends BaseStatementInput {
     connectedBottomNextConnection: boolean;
     /**
      * @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/zelos/measurables/row_elements.d.ts

@@ -8,15 +8,12 @@ import { Measurable } from '../../../renderers/measurables/base.js';
 /**
  * An object containing information about the space a right connection shape
  * takes up during rendering.
- *
- * @alias Blockly.zelos.RightConnectionShape
  */
 export declare class RightConnectionShape extends Measurable {
     height: number;
     width: number;
     /**
      * @param constants The rendering constants provider.
-     * @internal
      */
     constructor(constants: ConstantProvider);
 }

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

@@ -13,13 +13,10 @@ import { TopRow as BaseTopRow } from '../../../renderers/measurables/top_row.js'
  * connections.
  * After this constructor is called, the row will contain all non-spacer
  * elements it needs.
- *
- * @alias Blockly.zelos.TopRow
  */
 export declare class TopRow extends BaseTopRow {
     /**
      * @param constants The rendering constants provider.
-     * @internal
      */
     constructor(constants: ConstantProvider);
     endsWithElemSpacer(): boolean;

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

@@ -11,8 +11,6 @@ import type { ConstantProvider } from './constants.js';
 /**
  * An object that handles creating and setting each of the SVG elements
  * used by the renderer.
- *
- * @alias Blockly.zelos.PathObject
  */
 export declare class PathObject extends BasePathObject {
     /** The selected path of the block. */
@@ -31,13 +29,11 @@ export declare class PathObject extends BasePathObject {
      * with an output connection is drawn.
      */
     outputShapeType: number | null;
-    /** @internal */
     constants: ConstantProvider;
     /**
      * @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(pathString: string): void;
@@ -48,14 +44,10 @@ export declare class PathObject extends BasePathObject {
     updateShapeForInputHighlight(conn: Connection, enable: boolean): void;
     /**
      * Method that's called when the drawer is about to draw the block.
-     *
-     * @internal
      */
     beginDrawing(): void;
     /**
      * Method that's called when the drawer is done drawing.
-     *
-     * @internal
      */
     endDrawing(): void;
     /**
@@ -64,7 +56,6 @@ export declare class PathObject extends BasePathObject {
      *
      * @param name The input name.
      * @param pathString The path.
-     * @internal
      */
     setOutlinePath(name: string, pathString: string): void;
     /**

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

@@ -18,15 +18,15 @@ import { RenderInfo } from './info.js';
 import { MarkerSvg } from './marker_svg.js';
 import { PathObject } from './path_object.js';
 /**
- * The zelos renderer.
+ * The zelos renderer. This renderer emulates Scratch-style and MakeCode-style
+ * rendering.
  *
- * @alias Blockly.zelos.Renderer
+ * Zelos is the ancient Greek spirit of rivalry and emulation.
  */
 export declare class Renderer extends BaseRenderer {
     protected constants_: ConstantProvider;
     /**
      * @param name The renderer name.
-     * @internal
      */
     constructor(name: string);
     /**
@@ -57,7 +57,6 @@ export declare class Renderer extends BaseRenderer {
      * @param workspace The workspace the cursor belongs to.
      * @param marker The marker.
      * @returns The object in charge of drawing the marker.
-     * @internal
      */
     makeMarkerDrawer(workspace: WorkspaceSvg, marker: Marker): MarkerSvg;
     /**
@@ -66,7 +65,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;
     /**

package/core/scrollbar.d.ts

@@ -15,8 +15,6 @@ import type { WorkspaceSvg } from './workspace_svg.js';
  * Class for a pure SVG scrollbar.
  * This technique offers a scrollbar that is guaranteed to work, but may not
  * look or behave like the system's scrollbars.
- *
- * @alias Blockly.Scrollbar
  */
 export declare class Scrollbar {
     private workspace;

package/core/scrollbar_pair.d.ts

@@ -8,8 +8,6 @@ import type { Metrics } from './utils/metrics.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
  * Class for a pair of scrollbars.  Horizontal and vertical.
- *
- * @alias Blockly.ScrollbarPair
  */
 export declare class ScrollbarPair {
     private workspace;

package/core/serialization/blocks.d.ts

@@ -9,8 +9,6 @@ import type { ISerializer } from '../interfaces/i_serializer.js';
 import type { Workspace } from '../workspace.js';
 /**
  * Represents the state of a connection.
- *
- * @alias Blockly.serialization.blocks.ConnectionState
  */
 export interface ConnectionState {
     shadow: State | undefined;
@@ -18,8 +16,6 @@ export interface ConnectionState {
 }
 /**
  * Represents the state of a given block.
- *
- * @alias Blockly.serialization.blocks.State
  */
 export interface State {
     type: string;
@@ -27,6 +23,9 @@ export interface State {
     x?: number;
     y?: number;
     collapsed?: boolean;
+    deletable?: boolean;
+    movable?: boolean;
+    editable?: boolean;
     enabled?: boolean;
     inline?: boolean;
     data?: string;
@@ -58,7 +57,6 @@ export interface State {
  *     exist. True by default.
  * @returns The serialized state of the block, or null if the block could not be
  *     serialied (eg it was an insertion marker).
- * @alias Blockly.serialization.blocks.save
  */
 export declare function save(block: Block, { addCoordinates, addInputBlocks, addNextBlocks, doFullSerialization, }?: {
     addCoordinates?: boolean;
@@ -74,7 +72,6 @@ export declare function save(block: Block, { addCoordinates, addInputBlocks, add
  * @param param1 recordUndo: If true, events triggered by this function will be
  *     undo-able by the user. False by default.
  * @returns The block that was just loaded.
- * @alias Blockly.serialization.blocks.append
  */
 export declare function append(state: State, workspace: Workspace, { recordUndo }?: {
     recordUndo?: boolean;
@@ -94,7 +91,6 @@ export declare function append(state: State, workspace: Workspace, { recordUndo
  *     it is created. False by default. recordUndo: If true, events triggered by
  *     this function will be undo-able by the user. False by default.
  * @returns The block that was just appended.
- * @alias Blockly.serialization.blocks.appendInternal
  * @internal
  */
 export declare function appendInternal(state: State, workspace: Workspace, { parentConnection, isShadow, recordUndo }?: {
@@ -104,8 +100,6 @@ export declare function appendInternal(state: State, workspace: Workspace, { par
 }): Block;
 /**
  * Serializer for saving and loading block state.
- *
- * @alias Blockly.serialization.blocks.BlockSerializer
  */
 export declare class BlockSerializer implements ISerializer {
     priority: number;