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

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

@@ -20,6 +20,7 @@ export interface InsideCorners {
 }
 /**
  * An object that provides constants for rendering blocks in Zelos mode.
+ *
  * @alias Blockly.zelos.ConstantProvider
  */
 export declare class ConstantProvider extends BaseConstantProvider {
@@ -52,6 +53,7 @@ export declare class ConstantProvider extends BaseConstantProvider {
     CURSOR_COLOUR: string;
     /**
      * Radius of the cursor for input and output connections.
+     *
      * @internal
      */
     CURSOR_RADIUS: number;
@@ -97,6 +99,7 @@ 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;
@@ -107,6 +110,7 @@ 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;
@@ -142,21 +146,24 @@ export declare class ConstantProvider extends BaseConstantProvider {
     };
     /**
      * Create sizing and path information about a hexagonal shape.
-     * @return An object containing sizing and path information about a hexagonal
+     *
+     * @returns An object containing sizing and path information about a hexagonal
      *     shape for connections.
      * @internal
      */
     makeHexagonal(): Shape;
     /**
      * Create sizing and path information about a rounded shape.
-     * @return An object containing sizing and path information about a rounded
+     *
+     * @returns An object containing sizing and path information about a rounded
      *     shape for connections.
      * @internal
      */
     makeRounded(): Shape;
     /**
      * Create sizing and path information about a squared shape.
-     * @return An object containing sizing and path information about a squared
+     *
+     * @returns An object containing sizing and path information about a squared
      *     shape for connections.
      * @internal
      */
@@ -184,3 +191,4 @@ export declare class ConstantProvider extends BaseConstantProvider {
     createDom(svg: SVGElement, tagName: string, selector: string): void;
     getCSS_(selector: string): string[];
 }
+//# sourceMappingURL=constants.d.ts.map

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

@@ -10,6 +10,7 @@ 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 {
@@ -27,6 +28,7 @@ export declare class Drawer extends BaseDrawer {
     /**
      * Add steps for the right side of a row that does not have value or
      * statement input connections.
+     *
      * @param row The row to draw the side of.
      */
     protected drawRightSideRow_(row: Row): void;
@@ -45,3 +47,4 @@ export declare class Drawer extends BaseDrawer {
     drawInlineInput_(input: InlineInput): void;
     drawStatementInput_(row: Row): void;
 }
+//# sourceMappingURL=drawer.d.ts.map

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

@@ -1,6 +1,7 @@
 /**
- * @fileoverview Makecode/scratch-style renderer.
- * Zelos: spirit of eager rivalry, emulation, envy, jealousy, and zeal.
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
  */
 import type { BlockSvg } from '../../block_svg.js';
 import { Input } from '../../input.js';
@@ -18,6 +19,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.zelos.RenderInfo
  */
 export declare class RenderInfo extends BaseRenderInfo {
@@ -38,7 +40,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;
@@ -53,7 +56,7 @@ export declare class RenderInfo extends BaseRenderInfo {
     addAlignmentPadding_(row: Row, missingSpace: number): void;
     /**
      * Adjust the x position of fields to bump all non-label fields in the first
-     * row past the notch position.  This must be called before ``computeBounds``
+     * row past the notch position.  This must be called before `computeBounds`
      * is called.
      */
     protected adjustXPosition_(): void;
@@ -74,8 +77,9 @@ export declare class RenderInfo extends BaseRenderInfo {
     /**
      * Calculate the spacing to reduce the left and right edges by based on the
      * outer and inner connection shape.
+     *
      * @param elem The first or last element on a block.
-     * @return The amount of spacing to reduce the first or last spacer.
+     * @returns The amount of spacing to reduce the first or last spacer.
      */
     protected getNegativeSpacing_(elem: Measurable): number;
     /**
@@ -86,3 +90,4 @@ export declare class RenderInfo extends BaseRenderInfo {
     protected finalizeVerticalAlignment_(): void;
     finalize_(): void;
 }
+//# sourceMappingURL=info.d.ts.map

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

@@ -11,6 +11,7 @@ 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 {
@@ -24,6 +25,7 @@ export declare class MarkerSvg extends BaseMarkerSvg {
     constructor(workspace: WorkspaceSvg, constants: BaseConstantProvider, marker: Marker);
     /**
      * Position and display the marker for an input or an output connection.
+     *
      * @param curNode The node to draw the marker for.
      */
     private showWithInputOutput_;
@@ -31,11 +33,13 @@ export declare class MarkerSvg extends BaseMarkerSvg {
     showWithInput_(curNode: ASTNode): void;
     /**
      * Draw a rectangle around the block.
+     *
      * @param curNode The current node of the marker.
      */
     showWithBlock_(curNode: ASTNode): void;
     /**
      * Position the circle we use for input and output connections.
+     *
      * @param x The x position of the circle.
      * @param y The y position of the circle.
      */
@@ -44,3 +48,4 @@ export declare class MarkerSvg extends BaseMarkerSvg {
     createDomInternal_(): SVGGElement;
     applyColour_(curNode: ASTNode): void;
 }
+//# sourceMappingURL=marker_svg.d.ts.map

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

@@ -11,6 +11,7 @@ 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 {
@@ -25,3 +26,4 @@ export declare class BottomRow extends BaseBottomRow {
     /** Render a round corner unless the block has an output connection. */
     hasRightSquareCorner(block: BlockSvg): false;
 }
+//# sourceMappingURL=bottom_row.d.ts.map

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

@@ -9,6 +9,7 @@ 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 {
@@ -21,3 +22,4 @@ export declare class StatementInput extends BaseStatementInput {
      */
     constructor(constants: ConstantProvider, input: Input);
 }
+//# sourceMappingURL=inputs.d.ts.map

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

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

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

@@ -13,6 +13,7 @@ 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 {
@@ -27,3 +28,4 @@ export declare class TopRow extends BaseTopRow {
     /** Render a round corner unless the block has an output connection. */
     hasRightSquareCorner(block: BlockSvg): false;
 }
+//# sourceMappingURL=top_row.d.ts.map

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

@@ -11,6 +11,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.zelos.PathObject
  */
 export declare class PathObject extends BasePathObject {
@@ -47,17 +48,20 @@ 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;
     /**
      * Set the path generated by the renderer for an outline path on the
      * respective outline path SVG element.
+     *
      * @param name The input name.
      * @param pathString The path.
      * @internal
@@ -65,13 +69,16 @@ export declare class PathObject extends BasePathObject {
     setOutlinePath(name: string, pathString: string): void;
     /**
      * Create's an outline path for the specified input.
+     *
      * @param name The input name.
-     * @return The SVG outline path.
+     * @returns The SVG outline path.
      */
     private getOutlinePath_;
     /**
      * Remove an outline path that is associated with the specified input.
+     *
      * @param name The input name.
      */
     private removeOutlinePath_;
 }
+//# sourceMappingURL=path_object.d.ts.map

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

@@ -19,6 +19,7 @@ import { MarkerSvg } from './marker_svg.js';
 import { PathObject } from './path_object.js';
 /**
  * The zelos renderer.
+ *
  * @alias Blockly.zelos.Renderer
  */
 export declare class Renderer extends BaseRenderer {
@@ -30,45 +31,52 @@ export declare class Renderer extends BaseRenderer {
     constructor(name: string);
     /**
      * Create a new instance of the renderer's constant provider.
-     * @return The constant provider.
+     *
+     * @returns The constant provider.
      */
     protected 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 the renderer's cursor drawer.
+     *
      * @param workspace The workspace the cursor belongs to.
      * @param marker The marker.
-     * @return The object in charge of drawing the marker.
+     * @returns The object in charge of drawing the marker.
      * @internal
      */
     makeMarkerDrawer(workspace: WorkspaceSvg, marker: Marker): MarkerSvg;
     /**
      * 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;
     /**
      * Get the current renderer's constant provider.  We assume that when this is
      * called, the renderer has already been initialized.
-     * @return The constant provider.
+     *
+     * @returns The constant provider.
      */
     getConstants(): ConstantProvider;
     shouldHighlightConnection(conn: Connection): boolean;
     getConnectionPreviewMethod(closest: RenderedConnection, local: RenderedConnection, topBlock: BlockSvg): InsertionMarkerManager.PREVIEW_TYPE;
 }
+//# sourceMappingURL=renderer.d.ts.map

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

@@ -1,4 +1,4 @@
-/** @fileoverview Re-exports of Blockly.zelos.* modules. */
+/** @file Re-exports of Blockly.zelos.* modules. */
 import { ConstantProvider } from './constants.js';
 import { Drawer } from './drawer.js';
 import { RenderInfo } from './info.js';
@@ -9,4 +9,5 @@ import { RightConnectionShape } from './measurables/row_elements.js';
 import { TopRow } from './measurables/top_row.js';
 import { PathObject } from './path_object.js';
 import { Renderer } from './renderer.js';
-export { BottomRow, ConstantProvider, Drawer, MarkerSvg, PathObject, Renderer, RenderInfo, RightConnectionShape, StatementInput, TopRow };
+export { BottomRow, ConstantProvider, Drawer, MarkerSvg, PathObject, Renderer, RenderInfo, RightConnectionShape, StatementInput, TopRow, };
+//# sourceMappingURL=zelos.d.ts.map

package/core/scrollbar.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2011 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import * as browserEvents from './browser_events.js';
 import { Coordinate } from './utils/coordinate.js';
 import type { Metrics } from './utils/metrics.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
@@ -14,6 +15,7 @@ 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 {
@@ -27,6 +29,7 @@ export declare class Scrollbar {
     /**
      * Default margin around the scrollbar (between the scrollbar and the edge of
      * the viewport in pixels).
+     *
      * @internal
      */
     static readonly DEFAULT_SCROLLBAR_MARGIN = 0.5;
@@ -36,6 +39,7 @@ export declare class Scrollbar {
     private oldHostMetrics_;
     /**
      * The ratio of handle position offset to workspace content displacement.
+     *
      * @internal
      */
     ratio: number;
@@ -73,8 +77,10 @@ export declare class Scrollbar {
     position: Coordinate;
     lengthAttribute_: string;
     positionAttribute_: string;
-    onMouseDownBarWrapper_: any;
-    onMouseDownHandleWrapper_: any;
+    onMouseDownBarWrapper_: browserEvents.Data | null;
+    onMouseDownHandleWrapper_: browserEvents.Data | null;
+    onMouseUpWrapper_: browserEvents.Data | null;
+    onMouseMoveWrapper_: browserEvents.Data | null;
     /**
      * @param workspace Workspace to bind the scrollbar to.
      * @param horizontal True if horizontal, false if vertical.
@@ -86,38 +92,44 @@ export declare class Scrollbar {
     /**
      * Dispose of this scrollbar.
      * Unlink from all DOM elements to prevent memory leaks.
+     *
      * @suppress {checkTypes}
      */
     dispose(): void;
     /**
      * Constrain the handle's length within the minimum (0) and maximum
      * (scrollbar background) values allowed for the scrollbar.
+     *
      * @param value Value that is potentially out of bounds, in CSS pixels.
-     * @return Constrained value, in CSS pixels.
+     * @returns Constrained value, in CSS pixels.
      */
     private constrainHandleLength_;
     /**
      * Set the length of the scrollbar's handle and change the SVG attribute
      * accordingly.
+     *
      * @param newLength The new scrollbar handle length in CSS pixels.
      */
     private setHandleLength_;
     /**
      * Constrain the handle's position within the minimum (0) and maximum values
      * allowed for the scrollbar.
+     *
      * @param value Value that is potentially out of bounds, in CSS pixels.
-     * @return Constrained value, in CSS pixels.
+     * @returns Constrained value, in CSS pixels.
      */
     private constrainHandlePosition_;
     /**
      * Set the offset of the scrollbar's handle from the scrollbar's position, and
      * change the SVG attribute accordingly.
+     *
      * @param newPosition The new scrollbar handle offset in CSS pixels.
      */
     setHandlePosition(newPosition: number): void;
     /**
      * Set the size of the scrollbar's background and change the SVG attribute
      * accordingly.
+     *
      * @param newSize The new scrollbar background length in CSS pixels.
      */
     private setScrollbarLength_;
@@ -125,6 +137,7 @@ export declare class Scrollbar {
      * Set the position of the scrollbar's SVG group in CSS pixels relative to the
      * scrollbar's origin.  This sets the scrollbar's location within the
      * workspace.
+     *
      * @param x The new x coordinate.
      * @param y The new y coordinate.
      * @internal
@@ -132,6 +145,7 @@ export declare class Scrollbar {
     setPosition(x: number, y: number): void;
     /**
      * Recalculate the scrollbar's location and its length.
+     *
      * @param opt_metrics A data structure of from the describing all the required
      *     dimensions.  If not provided, it will be fetched from the host object.
      */
@@ -139,13 +153,15 @@ export declare class Scrollbar {
     /**
      * Returns whether the a resizeView is necessary by comparing the passed
      * hostMetrics with cached old host metrics.
+     *
      * @param hostMetrics A data structure describing all the required dimensions,
      *     possibly fetched from the host object.
-     * @return Whether a resizeView is necessary.
+     * @returns Whether a resizeView is necessary.
      */
     private requiresViewResize_;
     /**
      * Recalculate a horizontal scrollbar's location and length.
+     *
      * @param hostMetrics A data structure describing all the required dimensions,
      *     possibly fetched from the host object.
      */
@@ -154,6 +170,7 @@ export declare class Scrollbar {
      * Recalculate a horizontal scrollbar's location on the screen and path
      * length. This should be called when the layout or size of the window has
      * changed.
+     *
      * @param hostMetrics A data structure describing all the required dimensions,
      *     possibly fetched from the host object.
      */
@@ -161,12 +178,14 @@ export declare class Scrollbar {
     /**
      * Recalculate a horizontal scrollbar's location within its path and length.
      * This should be called when the contents of the workspace have changed.
+     *
      * @param hostMetrics A data structure describing all the required dimensions,
      *     possibly fetched from the host object.
      */
     resizeContentHorizontal(hostMetrics: Metrics): void;
     /**
      * Recalculate a vertical scrollbar's location and length.
+     *
      * @param hostMetrics A data structure describing all the required dimensions,
      *     possibly fetched from the host object.
      */
@@ -174,6 +193,7 @@ export declare class Scrollbar {
     /**
      * Recalculate a vertical scrollbar's location on the screen and path length.
      * This should be called when the layout or size of the window has changed.
+     *
      * @param hostMetrics A data structure describing all the required dimensions,
      *     possibly fetched from the host object.
      */
@@ -181,6 +201,7 @@ export declare class Scrollbar {
     /**
      * Recalculate a vertical scrollbar's location within its path and length.
      * This should be called when the contents of the workspace have changed.
+     *
      * @param hostMetrics A data structure describing all the required dimensions,
      *     possibly fetched from the host object.
      */
@@ -188,24 +209,28 @@ export declare class Scrollbar {
     /**
      * Create all the DOM elements required for a scrollbar.
      * The resulting widget is not sized.
+     *
      * @param opt_class A class to be applied to this scrollbar.
      */
     private createDom_;
     /**
      * Is the scrollbar visible.  Non-paired scrollbars disappear when they aren't
      * needed.
-     * @return True if visible.
+     *
+     * @returns True if visible.
      */
     isVisible(): boolean;
     /**
      * Set whether the scrollbar's container is visible and update
      * display accordingly if visibility has changed.
+     *
      * @param visible Whether the container is visible
      */
     setContainerVisible(visible: boolean): void;
     /**
      * Set whether the scrollbar is visible.
      * Only applies to non-paired scrollbars.
+     *
      * @param visible True if visible.
      */
     setVisible(visible: boolean): void;
@@ -219,18 +244,21 @@ export declare class Scrollbar {
     /**
      * Scroll by one pageful.
      * Called when scrollbar background is clicked.
+     *
      * @param e Mouse down event.
      */
     private onMouseDownBar_;
     /**
      * Start a dragging operation.
      * Called when scrollbar handle is clicked.
+     *
      * @param e Mouse down event.
      */
     private onMouseDownHandle_;
     /**
      * Drag the scrollbar's handle.
-     * @param e Mouse up event.
+     *
+     * @param e Mouse move event.
      */
     private onMouseMoveHandle_;
     /** Release the scrollbar handle and reset state accordingly. */
@@ -242,7 +270,8 @@ export declare class Scrollbar {
     private cleanUp_;
     /**
      * Helper to calculate the ratio of handle position to scrollbar view size.
-     * @return Ratio.
+     *
+     * @returns Ratio.
      * @internal
      */
     getRatio_(): number;
@@ -253,6 +282,7 @@ export declare class Scrollbar {
     private updateMetrics_;
     /**
      * Set the scrollbar handle's position.
+     *
      * @param value The content displacement, relative to the view in pixels.
      * @param updateMetrics Whether to update metrics on this set call.
      *    Defaults to true.
@@ -263,6 +293,7 @@ export declare class Scrollbar {
      * relative to the injection div origin. This is for times when the scrollbar
      * is used in an object whose origin isn't the same as the main workspace
      * (e.g. in a flyout.)
+     *
      * @param x The x coordinate of the scrollbar's origin, in CSS pixels.
      * @param y The y coordinate of the scrollbar's origin, in CSS pixels.
      */
@@ -271,7 +302,8 @@ export declare class Scrollbar {
      * @param first An object containing computed measurements of a workspace.
      * @param second Another object containing computed measurements of a
      *     workspace.
-     * @return Whether the two sets of metrics are equivalent.
+     * @returns Whether the two sets of metrics are equivalent.
      */
     private static metricsAreEquivalent_;
 }
+//# sourceMappingURL=scrollbar.d.ts.map