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

package/core/renderers/measurables/square_corner.ts

@@ -1,47 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Objects representing a square corner in a row of a rendered
- * block.
- */
-
-/**
- * Objects representing a square corner in a row of a rendered
- * block.
- * @class
- */
-import * as goog from '../../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.blockRendering.SquareCorner');
-
-import type {ConstantProvider} from '../common/constants.js';
-
-import {Measurable} from './base.js';
-import {Types} from './types.js';
-
-
-/**
- * An object containing information about the space a square corner takes up
- * during rendering.
- * @struct
- * @alias Blockly.blockRendering.SquareCorner
- */
-export class SquareCorner extends Measurable {
-  /**
-   * @param constants The rendering constants provider.
-   * @param opt_position The position of this corner.
-   * @internal
-   */
-  constructor(constants: ConstantProvider, opt_position?: string) {
-    super(constants);
-    this.type =
-        (!opt_position || opt_position === 'left' ? Types.LEFT_SQUARE_CORNER :
-                                                    Types.RIGHT_SQUARE_CORNER) |
-        Types.CORNER;
-    this.height = this.constants_.NO_PADDING;
-    this.width = this.constants_.NO_PADDING;
-  }
-}

package/core/renderers/measurables/statement_input.ts

@@ -1,55 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Class representing statement inputs with connections on a
- * rendered block.
- */
-
-/**
- * Class representing statement inputs with connections on a
- * rendered block.
- * @class
- */
-import * as goog from '../../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.blockRendering.StatementInput');
-
-/* eslint-disable-next-line no-unused-vars */
-import type {Input} from '../../input.js';
-import type {ConstantProvider} from '../common/constants.js';
-
-import {InputConnection} from './input_connection.js';
-import {Types} from './types.js';
-
-
-/**
- * An object containing information about the space a statement input takes up
- * during rendering
- * @struct
- * @alias Blockly.blockRendering.StatementInput
- */
-export class StatementInput extends InputConnection {
-  /**
-   * @param constants The rendering constants provider.
-   * @param input The statement input to measure and store information for.
-   * @internal
-   */
-  constructor(constants: ConstantProvider, input: Input) {
-    super(constants, input);
-    this.type |= Types.STATEMENT_INPUT;
-
-    if (!this.connectedBlock) {
-      this.height = this.constants_.EMPTY_STATEMENT_INPUT_HEIGHT;
-    } else {
-      // We allow the dark path to show on the parent block so that the child
-      // block looks embossed.  This takes up an extra pixel in both x and y.
-      this.height =
-          this.connectedBlockHeight + this.constants_.STATEMENT_BOTTOM_SPACER;
-    }
-    this.width = this.constants_.STATEMENT_INPUT_NOTCH_OFFSET +
-        (this.shape.width as number);
-  }
-}

package/core/renderers/measurables/top_row.ts

@@ -1,122 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Object representing a top row on a rendered block.
- */
-
-/**
- * Object representing a top row on a rendered block.
- * @class
- */
-import * as goog from '../../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.blockRendering.TopRow');
-
-import type {BlockSvg} from '../../block_svg.js';
-import type {ConstantProvider} from '../common/constants.js';
-
-import {Hat} from './hat.js';
-import type {PreviousConnection} from './previous_connection.js';
-import {Row} from './row.js';
-import {Types} from './types.js';
-
-
-/**
- * An object containing information about what elements are in the top row of a
- * block as well as sizing information for the top row.
- * Elements in a top row can consist of corners, hats, spacers, and previous
- * connections.
- * After this constructor is called, the row will contain all non-spacer
- * elements it needs.
- * @struct
- * @alias Blockly.blockRendering.TopRow
- */
-export class TopRow extends Row {
-  /**
-   * The starting point for drawing the row, in the y direction.
-   * This allows us to draw hats and similar shapes that don't start at the
-   * origin. Must be non-negative (see #2820).
-   * @internal
-   */
-  capline = 0;
-
-  /** How much the row extends up above its capline. */
-  ascenderHeight = 0;
-
-  /** Whether the block has a previous connection. */
-  hasPreviousConnection = false;
-
-  /** The previous connection on the block, if any. */
-  connection: PreviousConnection|null = null;
-  override widthWithConnectedBlocks: AnyDuringMigration;
-
-  /**
-   * @param constants The rendering constants provider.
-   * @internal
-   */
-  constructor(constants: ConstantProvider) {
-    super(constants);
-
-    this.type |= Types.TOP_ROW;
-  }
-
-  /**
-   * Returns whether or not the top row has a left square corner.
-   * @param block The block whose top row this represents.
-   * @return Whether or not the top row has a left square corner.
-   * @internal
-   */
-  hasLeftSquareCorner(block: BlockSvg): boolean {
-    const hasHat =
-        (block.hat ? block.hat === 'cap' : this.constants_.ADD_START_HATS) &&
-        !block.outputConnection && !block.previousConnection;
-    const prevBlock = block.getPreviousBlock();
-
-    return !!block.outputConnection || hasHat ||
-        (prevBlock ? prevBlock.getNextBlock() === block : false);
-  }
-
-  /**
-   * Returns whether or not the top row has a right square corner.
-   * @param _block The block whose top row this represents.
-   * @return Whether or not the top row has a right square corner.
-   */
-  hasRightSquareCorner(_block: BlockSvg): boolean {
-    return true;
-  }
-
-  override measure() {
-    let height = 0;
-    let width = 0;
-    let ascenderHeight = 0;
-    for (let i = 0; i < this.elements.length; i++) {
-      const elem = this.elements[i];
-      width += elem.width;
-      if (!Types.isSpacer(elem)) {
-        // AnyDuringMigration because:  Property 'isHat' does not exist on type
-        // 'typeof Types'.
-        if ((Types as AnyDuringMigration).isHat(elem) && elem instanceof Hat) {
-          ascenderHeight = Math.max(ascenderHeight, elem.ascenderHeight);
-        } else {
-          height = Math.max(height, elem.height);
-        }
-      }
-    }
-    this.width = Math.max(this.minWidth, width);
-    this.height = Math.max(this.minHeight, height) + ascenderHeight;
-    this.ascenderHeight = ascenderHeight;
-    this.capline = this.ascenderHeight;
-    this.widthWithConnectedBlocks = this.width;
-  }
-
-  override startsWithElemSpacer() {
-    return false;
-  }
-
-  override endsWithElemSpacer() {
-    return false;
-  }
-}

package/core/renderers/measurables/types.ts

@@ -1,332 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Measurable types.
- */
-
-/**
- * Measurable types.
- * @namespace Blockly.blockRendering.Types
- */
-import * as goog from '../../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.blockRendering.Types');
-
-import type {Measurable} from './base.js';
-import type {Row} from './row.js';
-
-
-/**
- * Types of rendering elements.
- * @alias Blockly.blockRendering.Types
- */
-class TypesContainer {
-  [index: string]: number|Function;
-
-  NONE = 0;                       // None
-  FIELD = 1 << 0;                 // Field.
-  HAT = 1 << 1;                   // Hat.
-  ICON = 1 << 2;                  // Icon.
-  SPACER = 1 << 3;                // Spacer.
-  BETWEEN_ROW_SPACER = 1 << 4;    // Between Row Spacer.
-  IN_ROW_SPACER = 1 << 5;         // In Row Spacer.
-  EXTERNAL_VALUE_INPUT = 1 << 6;  // External Value Input.
-  INPUT = 1 << 7;                 // Input.
-  INLINE_INPUT = 1 << 8;          // Inline Input.
-  STATEMENT_INPUT = 1 << 9;       // Statement Input.
-  CONNECTION = 1 << 10;           // Connection.
-  PREVIOUS_CONNECTION = 1 << 11;  // Previous Connection.
-  NEXT_CONNECTION = 1 << 12;      // Next Connection.
-  OUTPUT_CONNECTION = 1 << 13;    // Output Connection.
-  CORNER = 1 << 14;               // Corner.
-  LEFT_SQUARE_CORNER = 1 << 15;   // Square Corner.
-  LEFT_ROUND_CORNER = 1 << 16;    // Round Corner.
-  RIGHT_SQUARE_CORNER = 1 << 17;  // Right Square Corner.
-  RIGHT_ROUND_CORNER = 1 << 18;   // Right Round Corner.
-  JAGGED_EDGE = 1 << 19;          // Jagged Edge.
-  ROW = 1 << 20;                  // Row.
-  TOP_ROW = 1 << 21;              // Top Row.
-  BOTTOM_ROW = 1 << 22;           // Bottom Row.
-  INPUT_ROW = 1 << 23;            // Input Row.
-
-  /**
-   * A Left Corner Union Type.
-   * @internal
-   */
-  LEFT_CORNER = this.LEFT_SQUARE_CORNER | this.LEFT_ROUND_CORNER;
-
-  /**
-   * A Right Corner Union Type.
-   * @internal
-   */
-  RIGHT_CORNER = this.RIGHT_SQUARE_CORNER | this.RIGHT_ROUND_CORNER;
-
-  /**
-   * Next flag value to use for custom rendering element types.
-   * This must be updated to reflect the next enum flag value
-   * to use if additional elements are added to
-   * `Types`.
-   */
-  nextTypeValue_ = 1 << 24;
-
-  /**
-   * Get the enum flag value of an existing type or register a new type.
-   * @param type The name of the type.
-   * @return The enum flag value associated with that type.
-   * @internal
-   */
-  getType(type: string): number {
-    if (!Object.prototype.hasOwnProperty.call(this, type)) {
-      this[type] = this.nextTypeValue_;
-      this.nextTypeValue_ <<= 1;
-    }
-    return this[type] as number;
-  }
-
-  /**
-   * Whether a measurable stores information about a field.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a field.
-   * @internal
-   */
-  isField(elem: Measurable): number {
-    return elem.type & this.FIELD;
-  }
-
-  /**
-   * Whether a measurable stores information about a hat.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a hat.
-   * @internal
-   */
-  isHat(elem: Measurable): number {
-    return elem.type & this.HAT;
-  }
-
-  /**
-   * Whether a measurable stores information about an icon.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about an icon.
-   * @internal
-   */
-  isIcon(elem: Measurable): number {
-    return elem.type & this.ICON;
-  }
-
-  /**
-   * Whether a measurable stores information about a spacer.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a spacer.
-   * @internal
-   */
-  isSpacer(elem: Measurable|Row): number {
-    return elem.type & this.SPACER;
-  }
-
-  /**
-   * Whether a measurable stores information about an in-row spacer.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about an in-row spacer.
-   * @internal
-   */
-  isInRowSpacer(elem: Measurable): number {
-    return elem.type & this.IN_ROW_SPACER;
-  }
-
-  /**
-   * Whether a measurable stores information about an input.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about an input.
-   * @internal
-   */
-  isInput(elem: Measurable): number {
-    return elem.type & this.INPUT;
-  }
-
-  /**
-   * Whether a measurable stores information about an external input.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about an external input.
-   * @internal
-   */
-  isExternalInput(elem: Measurable): number {
-    return elem.type & this.EXTERNAL_VALUE_INPUT;
-  }
-
-  /**
-   * Whether a measurable stores information about an inline input.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about an inline input.
-   * @internal
-   */
-  isInlineInput(elem: Measurable): number {
-    return elem.type & this.INLINE_INPUT;
-  }
-
-  /**
-   * Whether a measurable stores information about a statement input.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a statement input.
-   * @internal
-   */
-  isStatementInput(elem: Measurable): number {
-    return elem.type & this.STATEMENT_INPUT;
-  }
-
-  /**
-   * Whether a measurable stores information about a previous connection.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a previous connection.
-   * @internal
-   */
-  isPreviousConnection(elem: Measurable): number {
-    return elem.type & this.PREVIOUS_CONNECTION;
-  }
-
-  /**
-   * Whether a measurable stores information about a next connection.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a next connection.
-   * @internal
-   */
-  isNextConnection(elem: Measurable): number {
-    return elem.type & this.NEXT_CONNECTION;
-  }
-
-  /**
-   * Whether a measurable stores information about a previous or next
-   * connection.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a previous or next
-   *     connection.
-   * @internal
-   */
-  isPreviousOrNextConnection(elem: Measurable): number {
-    return elem.type & (this.PREVIOUS_CONNECTION | this.NEXT_CONNECTION);
-  }
-
-  /**
-   * Whether a measurable stores information about a left round corner.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a left round corner.
-   * @internal
-   */
-  isLeftRoundedCorner(elem: Measurable): number {
-    return elem.type & this.LEFT_ROUND_CORNER;
-  }
-
-  /**
-   * Whether a measurable stores information about a right round corner.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a right round corner.
-   * @internal
-   */
-  isRightRoundedCorner(elem: Measurable): number {
-    return elem.type & this.RIGHT_ROUND_CORNER;
-  }
-
-  /**
-   * Whether a measurable stores information about a left square corner.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a left square corner.
-   * @internal
-   */
-  isLeftSquareCorner(elem: Measurable): number {
-    return elem.type & this.LEFT_SQUARE_CORNER;
-  }
-
-  /**
-   * Whether a measurable stores information about a right square corner.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a right square corner.
-   * @internal
-   */
-  isRightSquareCorner(elem: Measurable): number {
-    return elem.type & this.RIGHT_SQUARE_CORNER;
-  }
-
-  /**
-   * Whether a measurable stores information about a corner.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a corner.
-   * @internal
-   */
-  isCorner(elem: Measurable): number {
-    return elem.type & this.CORNER;
-  }
-
-  /**
-   * Whether a measurable stores information about a jagged edge.
-   * @param elem The element to check.
-   * @return 1 if the object stores information about a jagged edge.
-   * @internal
-   */
-  isJaggedEdge(elem: Measurable): number {
-    return elem.type & this.JAGGED_EDGE;
-  }
-
-  /**
-   * Whether a measurable stores information about a row.
-   * @param row The row to check.
-   * @return 1 if the object stores information about a row.
-   * @internal
-   */
-  isRow(row: Row): number {
-    return row.type & this.ROW;
-  }
-
-  /**
-   * Whether a measurable stores information about a between-row spacer.
-   * @param row The row to check.
-   * @return 1 if the object stores information about a between-row spacer.
-   * @internal
-   */
-  isBetweenRowSpacer(row: Row): number {
-    return row.type & this.BETWEEN_ROW_SPACER;
-  }
-
-  /**
-   * Whether a measurable stores information about a top row.
-   * @param row The row to check.
-   * @return 1 if the object stores information about a top row.
-   * @internal
-   */
-  isTopRow(row: Row): number {
-    return row.type & this.TOP_ROW;
-  }
-
-  /**
-   * Whether a measurable stores information about a bottom row.
-   * @param row The row to check.
-   * @return 1 if the object stores information about a bottom row.
-   * @internal
-   */
-  isBottomRow(row: Row): number {
-    return row.type & this.BOTTOM_ROW;
-  }
-
-  /**
-   * Whether a measurable stores information about a top or bottom row.
-   * @param row The row to check.
-   * @return 1 if the object stores information about a top or bottom row.
-   * @internal
-   */
-  isTopOrBottomRow(row: Row): number {
-    return row.type & (this.TOP_ROW | this.BOTTOM_ROW);
-  }
-
-  /**
-   * Whether a measurable stores information about an input row.
-   * @param row The row to check.
-   * @return 1 if the object stores information about an input row.
-   * @internal
-   */
-  isInputRow(row: Row): number {
-    return row.type & this.INPUT_ROW;
-  }
-}
-
-export const Types = new TypesContainer();

package/core/renderers/minimalist/constants.ts

@@ -1,32 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview An object that provides constants for rendering blocks in the
- * minimalist renderer.
- */
-
-/**
- * An object that provides constants for rendering blocks in the
- * minimalist renderer.
- * @class
- */
-import * as goog from '../../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.minimalist.ConstantProvider');
-
-import {ConstantProvider as BaseConstantProvider} from '../common/constants.js';
-
-
-/**
- * An object that provides constants for rendering blocks in the sample.
- * @alias Blockly.minimalist.ConstantProvider
- */
-export class ConstantProvider extends BaseConstantProvider {
-  /** @internal */
-  constructor() {
-    super();
-  }
-}

package/core/renderers/minimalist/drawer.ts

@@ -1,38 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Minimalist rendering drawer.
- */
-
-/**
- * Minimalist rendering drawer.
- * @class
- */
-import * as goog from '../../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.minimalist.Drawer');
-
-import type {BlockSvg} from '../../block_svg.js';
-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 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) {
-    super(block, info);
-  }
-}

package/core/renderers/minimalist/info.ts

@@ -1,52 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @fileoverview Minimalist render info object.
- */
-
-/**
- * Minimalist render info object.
- * @class
- */
-import * as goog from '../../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.minimalist.RenderInfo');
-
-import type {BlockSvg} from '../../block_svg.js';
-import {RenderInfo as BaseRenderInfo} from '../common/info.js';
-
-import type {Renderer} from './renderer.js';
-
-
-/**
- * An object containing all sizing information needed to draw this block.
- *
- * 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 class RenderInfo extends BaseRenderInfo {
-  /**
-   * @param renderer The renderer in use.
-   * @param block The block to measure.
-   * @internal
-   */
-  constructor(renderer: Renderer, block: BlockSvg) {
-    super(renderer, block);
-  }
-
-  /**
-   * Get the block renderer in use.
-   * @return The block renderer in use.
-   * @internal
-   */
-  override getRenderer(): Renderer {
-    // AnyDuringMigration because:  Property 'renderer_' does not exist on type
-    // 'RenderInfo'.
-    return (this as AnyDuringMigration).renderer_ as Renderer;
-  }
-}

package/core/renderers/minimalist/minimalist.ts

@@ -1,22 +0,0 @@
-/** @fileoverview Re-exports of Blockly.minimalist.* modules. */
-
-/**
- * @license
- * Copyright 2021 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * Re-exports of Blockly.minimalist.* modules.
- * @namespace Blockly.minimalist
- */
-import * as goog from '../../../closure/goog/goog.js';
-goog.declareModuleId('Blockly.minimalist');
-
-import {ConstantProvider} from './constants.js';
-import {Drawer} from './drawer.js';
-import {RenderInfo} from './info.js';
-import {Renderer} from './renderer.js';
-
-
-export {ConstantProvider, Drawer, Renderer, RenderInfo};