blockly 9.2.1 → 9.3.0

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;

package/core/serialization/exceptions.d.ts

@@ -5,14 +5,12 @@
  */
 import type { Block } from '../block.js';
 import type { State } from './blocks.js';
-/** @alias Blockly.serialization.exceptions.DeserializationError */
 export declare class DeserializationError extends Error {
 }
 /**
  * Represents an error where the serialized state is expected to provide a
  * block type, but it is not provided.
  *
- * @alias Blockly.serialization.exceptions.MissingBlockType
  */
 export declare class MissingBlockType extends DeserializationError {
     state: State;
@@ -25,8 +23,6 @@ export declare class MissingBlockType extends DeserializationError {
 /**
  * Represents an error where deserialization encountered a block that did
  * not have a connection that was defined in the serialized state.
- *
- * @alias Blockly.serialization.exceptions.MissingConnection
  */
 export declare class MissingConnection extends DeserializationError {
     block: Block;
@@ -43,8 +39,6 @@ export declare class MissingConnection extends DeserializationError {
 /**
  * Represents an error where deserialization tried to connect two connections
  * that were not compatible.
- *
- * @alias Blockly.serialization.exceptions.BadConnectionCheck
  */
 export declare class BadConnectionCheck extends DeserializationError {
     childBlock: Block;
@@ -64,8 +58,6 @@ export declare class BadConnectionCheck extends DeserializationError {
  * was deserializing children of a shadow.
  * This is an error because it is an invariant of Blockly that shadow blocks
  * do not have real children.
- *
- * @alias Blockly.serialization.exceptions.RealChildOfShadow
  */
 export declare class RealChildOfShadow extends DeserializationError {
     state: State;

package/core/serialization/priorities.d.ts

@@ -5,8 +5,6 @@
  */
 /**
  * The priority for deserializing variables.
- *
- * @alias Blockly.serialization.priorities.VARIABLES
  */
 export declare const VARIABLES = 100;
 /**
@@ -15,8 +13,6 @@ export declare const VARIABLES = 100;
 export declare const PROCEDURES = 75;
 /**
  * The priority for deserializing blocks.
- *
- * @alias Blockly.serialization.priorities.BLOCKS
  */
 export declare const BLOCKS = 50;
 //# sourceMappingURL=priorities.d.ts.map

package/core/serialization/procedures.d.ts

@@ -6,8 +6,6 @@
 import { IParameterModel } from '../interfaces/i_parameter_model.js';
 import { IProcedureModel } from '../interfaces/i_procedure_model.js';
 import type { ISerializer } from '../interfaces/i_serializer.js';
-import { ObservableProcedureModel } from '../procedures/observable_procedure_model.js';
-import { ObservableParameterModel } from '../procedures/observable_parameter_model.js';
 import type { Workspace } from '../workspace.js';
 /**
  * Representation of a procedure data model.
@@ -93,10 +91,5 @@ export declare class ProcedureSerializer<ProcedureModel extends IProcedureModel,
     /** Disposes of any procedure models that exist on the workspace. */
     clear(workspace: Workspace): void;
 }
-/**
- * A ProcedureSerializer that deserializes to create the built-in
- * ObservableProcedureModels and ObservableParameterModels.
- */
-export declare const observableProcedureSerializer: ProcedureSerializer<ObservableProcedureModel, ObservableParameterModel>;
 export {};
 //# sourceMappingURL=procedures.d.ts.map

package/core/serialization/registry.d.ts

@@ -10,14 +10,12 @@ import type { ISerializer } from '../interfaces/i_serializer.js';
  *
  * @param name The name of the serializer to register.
  * @param serializer The serializer to register.
- * @alias Blockly.serialization.registry.register
  */
 export declare function register(name: string, serializer: ISerializer): void;
 /**
  * Unregisters the serializer associated with the given name.
  *
  * @param name The name of the serializer to unregister.
- * @alias Blockly.serialization.registry.unregister
  */
 export declare function unregister(name: string): void;
 //# sourceMappingURL=registry.d.ts.map

package/core/serialization/variables.d.ts

@@ -7,8 +7,6 @@ import type { ISerializer } from '../interfaces/i_serializer.js';
 import type { Workspace } from '../workspace.js';
 /**
  * Represents the state of a given variable.
- *
- * @alias Blockly.serialization.variables.State
  */
 export interface State {
     name: string;
@@ -17,8 +15,6 @@ export interface State {
 }
 /**
  * Serializer for saving and loading variable state.
- *
- * @alias Blockly.serialization.variables.VariableSerializer
  */
 export declare class VariableSerializer implements ISerializer {
     priority: number;

package/core/serialization/workspaces.d.ts

@@ -9,7 +9,6 @@ import type { Workspace } from '../workspace.js';
  *
  * @param workspace The workspace to serialize.
  * @returns The serialized state of the workspace.
- * @alias Blockly.serialization.workspaces.save
  */
 export declare function save(workspace: Workspace): {
     [key: string]: any;
@@ -21,7 +20,6 @@ export declare function save(workspace: Workspace): {
  * @param workspace The workspace to add the new state to.
  * @param param1 recordUndo: If true, events triggered by this function will be
  *     undo-able by the user. False by default.
- * @alias Blockly.serialization.workspaces.load
  */
 export declare function load(state: {
     [key: string]: any;

package/core/shortcut_items.d.ts

@@ -5,8 +5,6 @@
  */
 /**
  * Object holding the names of the default shortcut items.
- *
- * @alias Blockly.ShortcutItems.names
  */
 export declare enum names {
     ESCAPE = "escape",
@@ -19,52 +17,37 @@ export declare enum names {
 }
 /**
  * Keyboard shortcut to hide chaff on escape.
- *
- * @alias Blockly.ShortcutItems.registerEscape
  */
 export declare function registerEscape(): void;
 /**
  * Keyboard shortcut to delete a block on delete or backspace
- *
- * @alias Blockly.ShortcutItems.registerDelete
  */
 export declare function registerDelete(): void;
 /**
  * Keyboard shortcut to copy a block on ctrl+c, cmd+c, or alt+c.
- *
- * @alias Blockly.ShortcutItems.registerCopy
  */
 export declare function registerCopy(): void;
 /**
  * Keyboard shortcut to copy and delete a block on ctrl+x, cmd+x, or alt+x.
- *
- * @alias Blockly.ShortcutItems.registerCut
  */
 export declare function registerCut(): void;
 /**
  * Keyboard shortcut to paste a block on ctrl+v, cmd+v, or alt+v.
- *
- * @alias Blockly.ShortcutItems.registerPaste
  */
 export declare function registerPaste(): void;
 /**
  * Keyboard shortcut to undo the previous action on ctrl+z, cmd+z, or alt+z.
- *
- * @alias Blockly.ShortcutItems.registerUndo
  */
 export declare function registerUndo(): void;
 /**
  * Keyboard shortcut to redo the previous action on ctrl+shift+z, cmd+shift+z,
  * or alt+shift+z.
- *
- * @alias Blockly.ShortcutItems.registerRedo
  */
 export declare function registerRedo(): void;
 /**
  * Registers all default keyboard shortcut item. This should be called once per
  * instance of KeyboardShortcutRegistry.
  *
- * @alias Blockly.ShortcutItems.registerDefaultShortcuts
  * @internal
  */
 export declare function registerDefaultShortcuts(): void;

package/core/shortcut_registry.d.ts

@@ -9,8 +9,6 @@ import type { Workspace } from './workspace.js';
  * Class for the registry of keyboard shortcuts. This is intended to be a
  * singleton. You should not create a new instance, and only access this class
  * from ShortcutRegistry.registry.
- *
- * @alias Blockly.ShortcutRegistry
  */
 export declare class ShortcutRegistry {
     static readonly registry: ShortcutRegistry;

package/core/sprites.d.ts

@@ -6,8 +6,6 @@
 /**
  * Contains the path to a single png tat holds the images for the trashcan
  * as well as the zoom controls.
- *
- * @alias Blockly.sprite.SPRITE
  */
 export declare const SPRITE: {
     width: number;

package/core/theme/classic.d.ts

@@ -7,8 +7,6 @@ import { Theme } from '../theme.js';
 /**
  * Classic theme.
  * Contains multi-coloured border to create shadow effect.
- *
- * @alias Blockly.Themes.Classic
  */
 export declare const Classic: Theme;
 //# sourceMappingURL=classic.d.ts.map

package/core/theme/zelos.d.ts

@@ -6,8 +6,6 @@
 import { Theme } from '../theme.js';
 /**
  * Zelos theme.
- *
- * @alias Blockly.Themes.Zelos
  */
 export declare const Zelos: Theme;
 //# sourceMappingURL=zelos.d.ts.map