scratch-blocks 2.0.0-beta.1 → 2.0.0-beta.2

package/blockly-rc/core/renderers/zelos/info.ts

@@ -1,652 +0,0 @@
-/**
- * @license
- * Copyright 2019 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-// Former goog.module ID: Blockly.zelos.RenderInfo
-
-import type {BlockSvg} from '../../block_svg.js';
-import {DummyInput} from '../../inputs/dummy_input.js';
-import {EndRowInput} from '../../inputs/end_row_input.js';
-import {FieldImage} from '../../field_image.js';
-import {FieldLabel} from '../../field_label.js';
-import {FieldTextInput} from '../../field_textinput.js';
-import {Input} from '../../inputs/input.js';
-import {Align} from '../../inputs/align.js';
-import {RenderInfo as BaseRenderInfo} from '../common/info.js';
-import type {Measurable} from '../measurables/base.js';
-import {Field} from '../measurables/field.js';
-import {InRowSpacer} from '../measurables/in_row_spacer.js';
-import {InputConnection} from '../measurables/input_connection.js';
-import {StatementInput} from '../../inputs/statement_input.js';
-import type {Row} from '../measurables/row.js';
-import type {SpacerRow} from '../measurables/spacer_row.js';
-import {Types} from '../measurables/types.js';
-import {ValueInput} from '../../inputs/value_input.js';
-
-import type {ConstantProvider, InsideCorners} from './constants.js';
-import {BottomRow} from './measurables/bottom_row.js';
-import {StatementInput as StatementInputMeasurable} from './measurables/inputs.js';
-import {RightConnectionShape} from './measurables/row_elements.js';
-import {TopRow} from './measurables/top_row.js';
-import type {PathObject} from './path_object.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.
- */
-export class RenderInfo extends BaseRenderInfo {
-  override topRow: TopRow;
-  override bottomRow: BottomRow;
-  override constants_: ConstantProvider;
-  override renderer_: Renderer;
-
-  override isInline = true;
-  isMultiRow: boolean;
-  hasStatementInput: boolean;
-  rightSide: RightConnectionShape | null;
-  private readonly rightAlignedDummyInputs: WeakMap<Row, Input>;
-
-  /**
-   * @param renderer The renderer in use.
-   * @param block The block to measure.
-   */
-  constructor(renderer: Renderer, block: BlockSvg) {
-    super(renderer, block);
-
-    this.renderer_ = renderer;
-
-    this.constants_ = this.renderer_.getConstants();
-
-    /**
-     * An object with rendering information about the top row of the block.
-     */
-    this.topRow = new TopRow(this.constants_);
-
-    /**
-     * An object with rendering information about the bottom row of the block.
-     */
-    this.bottomRow = new BottomRow(this.constants_);
-
-    /**
-     * Whether the block should be rendered as a multi-line block, either
-     * because it's not inline or because it has been collapsed.
-     */
-    this.isMultiRow = !block.getInputsInline() || block.isCollapsed();
-
-    /**
-     * Whether or not the block has a statement input in one of its rows.
-     */
-    this.hasStatementInput = block.statementInputCount > 0;
-
-    /**
-     * An object with rendering information about the right connection shape.
-     */
-    this.rightSide = this.outputConnection
-      ? new RightConnectionShape(this.constants_)
-      : null;
-
-    /**
-     * A map of rows to right aligned dummy inputs within those rows. Used to
-     * add padding between left and right aligned inputs.
-     */
-    this.rightAlignedDummyInputs = new WeakMap();
-  }
-
-  /**
-   * Get the block renderer in use.
-   *
-   * @returns The block renderer in use.
-   */
-  override getRenderer(): Renderer {
-    return this.renderer_ as Renderer;
-  }
-
-  override measure() {
-    // Modifying parent measure method to add `adjustXPosition_`.
-    this.createRows_();
-    this.addElemSpacing_();
-    this.addRowSpacing_();
-    this.adjustXPosition_();
-    this.computeBounds_();
-    this.alignRowElements_();
-    this.finalize_();
-  }
-
-  override shouldStartNewRow_(currInput: Input, prevInput: Input): boolean {
-    // If this is the first input, just add to the existing row.
-    // That row is either empty or has some icons in it.
-    if (!prevInput) {
-      return false;
-    }
-    // If the previous input was an end-row input, then any following input
-    // should always be rendered on the next row.
-    if (prevInput instanceof EndRowInput) {
-      return true;
-    }
-    // A statement input or an input following one always gets a new row.
-    if (
-      currInput instanceof StatementInput ||
-      prevInput instanceof StatementInput
-    ) {
-      return true;
-    }
-    // Value, dummy, and end-row inputs get new row if inputs are not inlined.
-    if (
-      currInput instanceof ValueInput ||
-      currInput instanceof DummyInput ||
-      currInput instanceof EndRowInput
-    ) {
-      return !this.isInline || this.isMultiRow;
-    }
-    return false;
-  }
-
-  override getDesiredRowWidth_(row: Row): number {
-    if (row.hasStatement) {
-      const rightCornerWidth =
-        (this.constants_.INSIDE_CORNERS as InsideCorners).rightWidth || 0;
-      return this.width - this.startX - rightCornerWidth;
-    }
-    return super.getDesiredRowWidth_(row);
-  }
-
-  override getInRowSpacing_(
-    prev: Measurable | null,
-    next: Measurable | null,
-  ): number {
-    if (!prev || !next) {
-      // No need for padding at the beginning or end of the row if the
-      // output shape is dynamic.
-      if (
-        this.outputConnection &&
-        this.outputConnection.isDynamicShape &&
-        !this.hasStatementInput &&
-        !this.bottomRow.hasNextConnection
-      ) {
-        return this.constants_.NO_PADDING;
-      }
-    }
-    if (!prev) {
-      // Statement input padding.
-      if (next && Types.isStatementInput(next)) {
-        return this.constants_.STATEMENT_INPUT_PADDING_LEFT;
-      }
-    }
-    // Spacing between a rounded corner and a previous or next connection.
-    if (prev && Types.isLeftRoundedCorner(prev) && next) {
-      if (Types.isPreviousConnection(next) || Types.isNextConnection(next)) {
-        return next.notchOffset - this.constants_.CORNER_RADIUS;
-      }
-    }
-    // Spacing between a square corner and a hat.
-    if (prev && Types.isLeftSquareCorner(prev) && next && Types.isHat(next)) {
-      return this.constants_.NO_PADDING;
-    }
-    return this.constants_.MEDIUM_PADDING;
-  }
-
-  override getSpacerRowHeight_(prev: Row, next: Row): number {
-    // If we have an empty block add a spacer to increase the height.
-    if (Types.isTopRow(prev) && Types.isBottomRow(next)) {
-      return this.constants_.EMPTY_BLOCK_SPACER_HEIGHT;
-    }
-    const followsStatement = Types.isInputRow(prev) && prev.hasStatement;
-    const precedesStatement = Types.isInputRow(next) && next.hasStatement;
-    if (precedesStatement || followsStatement) {
-      const cornerHeight =
-        (this.constants_.INSIDE_CORNERS as InsideCorners).rightHeight || 0;
-      const height = Math.max(this.constants_.NOTCH_HEIGHT, cornerHeight);
-      return precedesStatement && followsStatement
-        ? Math.max(height, this.constants_.DUMMY_INPUT_MIN_HEIGHT)
-        : height;
-    }
-    // Top and bottom rows act as a spacer so we don't need any extra padding.
-    if (Types.isTopRow(prev)) {
-      const topRow = prev as TopRow;
-      if (
-        !topRow.hasPreviousConnection &&
-        (!this.outputConnection || this.hasStatementInput)
-      ) {
-        return Math.abs(
-          this.constants_.NOTCH_HEIGHT - this.constants_.CORNER_RADIUS,
-        );
-      }
-      return this.constants_.NO_PADDING;
-    }
-    if (Types.isBottomRow(next)) {
-      const bottomRow = next as BottomRow;
-      if (!this.outputConnection) {
-        const topHeight =
-          Math.max(
-            this.topRow.minHeight,
-            Math.max(
-              this.constants_.NOTCH_HEIGHT,
-              this.constants_.CORNER_RADIUS,
-            ),
-          ) - this.constants_.CORNER_RADIUS;
-        return topHeight;
-      } else if (!bottomRow.hasNextConnection && this.hasStatementInput) {
-        return Math.abs(
-          this.constants_.NOTCH_HEIGHT - this.constants_.CORNER_RADIUS,
-        );
-      }
-      return this.constants_.NO_PADDING;
-    }
-    return this.constants_.MEDIUM_PADDING;
-  }
-
-  override getSpacerRowWidth_(prev: Row, next: Row): number {
-    const width = this.width - this.startX;
-    if (
-      (Types.isInputRow(prev) && prev.hasStatement) ||
-      (Types.isInputRow(next) && next.hasStatement)
-    ) {
-      return Math.max(width, this.constants_.STATEMENT_INPUT_SPACER_MIN_WIDTH);
-    }
-    return width;
-  }
-
-  override getElemCenterline_(row: Row, elem: Measurable): number {
-    if (
-      row.hasStatement &&
-      !Types.isSpacer(elem) &&
-      !Types.isStatementInput(elem)
-    ) {
-      return row.yPos + this.constants_.EMPTY_STATEMENT_INPUT_HEIGHT / 2;
-    }
-    if (Types.isInlineInput(elem) && elem instanceof InputConnection) {
-      const connectedBlock = elem.connectedBlock;
-      if (
-        connectedBlock &&
-        connectedBlock.outputConnection &&
-        connectedBlock.nextConnection
-      ) {
-        return row.yPos + connectedBlock.height / 2;
-      }
-    }
-    return super.getElemCenterline_(row, elem);
-  }
-
-  override addInput_(input: Input, activeRow: Row) {
-    // If we have two dummy inputs on the same row, one aligned left and the
-    // other right, keep track of the right aligned dummy input so we can add
-    // padding later. An end-row input after a dummy input also counts.
-    if (
-      (input instanceof DummyInput || input instanceof EndRowInput) &&
-      activeRow.hasDummyInput &&
-      activeRow.align === Align.LEFT &&
-      input.align === Align.RIGHT
-    ) {
-      this.rightAlignedDummyInputs.set(activeRow, input);
-    } else if (input instanceof StatementInput) {
-      // Handle statements without next connections correctly.
-      activeRow.elements.push(
-        new StatementInputMeasurable(this.constants_, input),
-      );
-      activeRow.hasStatement = true;
-
-      if (activeRow.align === null) {
-        activeRow.align = input.align;
-      }
-      return;
-    }
-    super.addInput_(input, activeRow);
-  }
-
-  override addAlignmentPadding_(row: Row, missingSpace: number) {
-    if (this.rightAlignedDummyInputs.get(row)) {
-      let alignmentDivider;
-      for (let i = 0; i < row.elements.length; i++) {
-        const elem = row.elements[i];
-        if (Types.isSpacer(elem)) {
-          alignmentDivider = elem;
-        }
-        if (
-          Types.isField(elem) &&
-          elem instanceof Field &&
-          elem.parentInput === this.rightAlignedDummyInputs.get(row)
-        ) {
-          break;
-        }
-      }
-      if (alignmentDivider) {
-        alignmentDivider.width += missingSpace;
-        row.width += missingSpace;
-        return;
-      }
-    }
-    super.addAlignmentPadding_(row, missingSpace);
-  }
-
-  /**
-   * 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`
-   * is called.
-   */
-  protected adjustXPosition_() {
-    const notchTotalWidth =
-      this.constants_.NOTCH_OFFSET_LEFT + this.constants_.NOTCH_WIDTH;
-    let minXPos = notchTotalWidth;
-    // Run through every input row on the block and only apply bump logic to the
-    // first input row (if the block has prev connection) and every input row
-    // that has a prev and next notch.
-    for (let i = 2; i < this.rows.length - 1; i += 2) {
-      const prevSpacer = this.rows[i - 1] as SpacerRow;
-      const row = this.rows[i];
-      const nextSpacer = this.rows[i + 1] as SpacerRow;
-
-      const hasPrevNotch =
-        i === 2
-          ? !!this.topRow.hasPreviousConnection
-          : !!prevSpacer.followsStatement;
-      const hasNextNotch =
-        i + 2 >= this.rows.length - 1
-          ? !!this.bottomRow.hasNextConnection
-          : !!nextSpacer.precedesStatement;
-
-      if (Types.isInputRow(row) && row.hasStatement) {
-        row.measure();
-        minXPos =
-          row.width - (row.getLastInput()?.width ?? 0) + notchTotalWidth;
-      } else if (
-        hasPrevNotch &&
-        (i === 2 || hasNextNotch) &&
-        Types.isInputRow(row) &&
-        !row.hasStatement
-      ) {
-        let xCursor = row.xPos;
-        let prevInRowSpacer = null;
-        for (let j = 0; j < row.elements.length; j++) {
-          const elem = row.elements[j];
-          if (Types.isSpacer(elem)) {
-            prevInRowSpacer = elem;
-          }
-          if (prevInRowSpacer && (Types.isField(elem) || Types.isInput(elem))) {
-            if (
-              xCursor < minXPos &&
-              !(
-                Types.isField(elem) &&
-                elem instanceof Field &&
-                (elem.field instanceof FieldLabel ||
-                  elem.field instanceof FieldImage)
-              )
-            ) {
-              const difference = minXPos - xCursor;
-              prevInRowSpacer.width += difference;
-            }
-          }
-          xCursor += elem.width;
-        }
-      }
-    }
-  }
-
-  /**
-   * Finalize the output connection info.  In particular, set the height of the
-   * output connection to match that of the block.  For the right side, add a
-   * right connection shape element and have it match the dimensions of the
-   * output connection.
-   */
-  protected finalizeOutputConnection_() {
-    // Dynamic output connections depend on the height of the block.
-    if (!this.outputConnection || !this.outputConnection.isDynamicShape) {
-      return;
-    }
-    const outputConnectionShape = this.outputConnection.shape;
-    if (
-      !('isDynamic' in outputConnectionShape && outputConnectionShape.isDynamic)
-    ) {
-      return;
-    }
-
-    let yCursor = 0;
-    // Determine the block height.
-    for (let i = 0; i < this.rows.length; i++) {
-      const row = this.rows[i];
-      row.yPos = yCursor;
-      yCursor += row.height;
-    }
-    this.height = yCursor;
-
-    // Adjust the height of the output connection.
-    const blockHeight = this.bottomRow.hasNextConnection
-      ? this.height - this.bottomRow.descenderHeight
-      : this.height;
-    const connectionHeight = outputConnectionShape.height(blockHeight);
-    const connectionWidth = outputConnectionShape.width(blockHeight);
-
-    this.outputConnection.height = connectionHeight;
-    this.outputConnection.width = connectionWidth;
-    this.outputConnection.startX = connectionWidth;
-    this.outputConnection.connectionOffsetY =
-      outputConnectionShape.connectionOffsetY(connectionHeight);
-    this.outputConnection.connectionOffsetX =
-      outputConnectionShape.connectionOffsetX(connectionWidth);
-
-    // Add the right connection measurable.
-    // Don't add it if we have a value-to-statement or a value-to-stack block.
-    let rightConnectionWidth = 0;
-    if (!this.hasStatementInput && !this.bottomRow.hasNextConnection) {
-      rightConnectionWidth = connectionWidth;
-      this.rightSide!.height = connectionHeight;
-      this.rightSide!.width = rightConnectionWidth;
-      this.rightSide!.centerline = connectionHeight / 2;
-      this.rightSide!.xPos = this.width + rightConnectionWidth;
-    }
-    this.startX = connectionWidth;
-    this.width += connectionWidth + rightConnectionWidth;
-    this.widthWithChildren += connectionWidth + rightConnectionWidth;
-  }
-
-  /**
-   * Finalize horizontal alignment of elements on the block.  In particular,
-   * reduce the implicit spacing created by the left and right output connection
-   * shapes by adding setting negative spacing onto the leftmost and rightmost
-   * spacers.
-   */
-  protected finalizeHorizontalAlignment_() {
-    if (
-      !this.outputConnection ||
-      this.hasStatementInput ||
-      this.bottomRow.hasNextConnection
-    ) {
-      return;
-    }
-    let totalNegativeSpacing = 0;
-    for (let i = 0; i < this.rows.length; i++) {
-      const row = this.rows[i];
-      if (!Types.isInputRow(row)) {
-        continue;
-      }
-      const firstElem = row.elements[1];
-      const lastElem = row.elements[row.elements.length - 2];
-      let leftNegPadding = this.getNegativeSpacing_(firstElem);
-      let rightNegPadding = this.getNegativeSpacing_(lastElem);
-      totalNegativeSpacing = leftNegPadding + rightNegPadding;
-      const minBlockWidth =
-        this.constants_.MIN_BLOCK_WIDTH + this.outputConnection.width * 2;
-      if (this.width - totalNegativeSpacing < minBlockWidth) {
-        // Maintain a minimum block width, split negative spacing between left
-        // and right edge.
-        totalNegativeSpacing = this.width - minBlockWidth;
-        leftNegPadding = totalNegativeSpacing / 2;
-        rightNegPadding = totalNegativeSpacing / 2;
-      }
-      // Add a negative spacer on the start and end of the block.
-      row.elements.unshift(new InRowSpacer(this.constants_, -leftNegPadding));
-      row.elements.push(new InRowSpacer(this.constants_, -rightNegPadding));
-    }
-    if (totalNegativeSpacing) {
-      this.width -= totalNegativeSpacing;
-      this.widthWithChildren -= totalNegativeSpacing;
-      this.rightSide!.xPos -= totalNegativeSpacing;
-      for (let i = 0; i < this.rows.length; i++) {
-        const row = this.rows[i];
-        if (Types.isTopOrBottomRow(row)) {
-          row.elements[1].width -= totalNegativeSpacing;
-        }
-        row.width -= totalNegativeSpacing;
-        row.widthWithConnectedBlocks -= totalNegativeSpacing;
-      }
-    }
-  }
-
-  /**
-   * 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.
-   * @returns The amount of spacing to reduce the first or last spacer.
-   */
-  protected getNegativeSpacing_(elem: Measurable): number {
-    if (!elem || !this.outputConnection) {
-      return 0;
-    }
-    const connectionWidth = this.outputConnection.width;
-    const outerShape = this.outputConnection.shape.type;
-    const constants = this.constants_;
-    if (this.inputRows.length > 1) {
-      switch (outerShape) {
-        case constants.SHAPES.ROUND: {
-          // Special case for multi-row round reporter blocks.
-          const maxWidth = this.constants_.MAX_DYNAMIC_CONNECTION_SHAPE_WIDTH;
-          const width = this.height / 2 > maxWidth ? maxWidth : this.height / 2;
-          const topPadding = this.constants_.SMALL_PADDING;
-          const roundPadding =
-            width * (1 - Math.sin(Math.acos((width - topPadding) / width)));
-          return connectionWidth - roundPadding;
-        }
-        default:
-          return 0;
-      }
-    }
-    if (Types.isInlineInput(elem) && elem instanceof InputConnection) {
-      const connectedBlock = elem.connectedBlock;
-      const innerShape = connectedBlock
-        ? (connectedBlock.pathObject as PathObject).outputShapeType
-        : elem.shape.type;
-      if (innerShape == null) {
-        return 0;
-      }
-      // Special case for value to stack / value to statement blocks.
-      if (
-        connectedBlock &&
-        connectedBlock.outputConnection &&
-        (connectedBlock.statementInputCount || connectedBlock.nextConnection)
-      ) {
-        return 0;
-      }
-      // Special case for hexagonal output.
-      if (
-        outerShape === constants.SHAPES.HEXAGONAL &&
-        outerShape !== innerShape
-      ) {
-        return 0;
-      }
-      return (
-        connectionWidth -
-        this.constants_.SHAPE_IN_SHAPE_PADDING[outerShape][innerShape]
-      );
-    } else if (Types.isField(elem) && elem instanceof Field) {
-      // Special case for text inputs.
-      if (
-        outerShape === constants.SHAPES.ROUND &&
-        elem.field instanceof FieldTextInput
-      ) {
-        return connectionWidth - 2.75 * constants.GRID_UNIT;
-      }
-      return (
-        connectionWidth - this.constants_.SHAPE_IN_SHAPE_PADDING[outerShape][0]
-      );
-    } else if (Types.isIcon(elem)) {
-      return this.constants_.SMALL_PADDING;
-    }
-    return 0;
-  }
-
-  /**
-   * Finalize vertical alignment of rows on a block.  In particular, reduce the
-   * implicit spacing when a non-shadow block is connected to any of an input
-   * row's inline inputs.
-   */
-  protected finalizeVerticalAlignment_() {
-    if (this.outputConnection) {
-      return;
-    }
-    // Run through every input row on the block and only apply tight nesting
-    // logic to input rows that have a prev and next notch.
-    for (let i = 2; i < this.rows.length - 1; i += 2) {
-      const prevSpacer = this.rows[i - 1] as SpacerRow;
-      const row = this.rows[i];
-      const nextSpacer = this.rows[i + 1] as SpacerRow;
-
-      const firstRow = i === 2;
-      const hasPrevNotch = firstRow
-        ? !!this.topRow.hasPreviousConnection
-        : !!prevSpacer.followsStatement;
-      const hasNextNotch =
-        i + 2 >= this.rows.length - 1
-          ? !!this.bottomRow.hasNextConnection
-          : !!nextSpacer.precedesStatement;
-
-      if (hasPrevNotch) {
-        const elem = row.elements[1];
-        const hasSingleTextOrImageField =
-          row.elements.length === 3 &&
-          elem instanceof Field &&
-          (elem.field instanceof FieldLabel ||
-            elem.field instanceof FieldImage);
-        if (!firstRow && hasSingleTextOrImageField) {
-          // Remove some padding if we have a single image or text field.
-          prevSpacer.height -= this.constants_.SMALL_PADDING;
-          nextSpacer.height -= this.constants_.SMALL_PADDING;
-          row.height -= this.constants_.MEDIUM_PADDING;
-        } else if (!firstRow && !hasNextNotch) {
-          // Add a small padding so the notch doesn't clash with inputs/fields.
-          prevSpacer.height += this.constants_.SMALL_PADDING;
-        } else if (hasNextNotch) {
-          // Determine if the input row has non-shadow connected blocks.
-          let hasNonShadowConnectedBlocks = false;
-          const minVerticalTightNestingHeight = 40;
-          for (let j = 0; j < row.elements.length; j++) {
-            const elem = row.elements[j];
-            if (
-              elem instanceof InputConnection &&
-              Types.isInlineInput(elem) &&
-              elem.connectedBlock &&
-              !elem.connectedBlock.isShadow() &&
-              elem.connectedBlock.getHeightWidth().height >=
-                minVerticalTightNestingHeight
-            ) {
-              hasNonShadowConnectedBlocks = true;
-              break;
-            }
-          }
-          // Apply tight-nesting if we have both a prev and next notch and the
-          // block has non-shadow connected blocks.
-          if (hasNonShadowConnectedBlocks) {
-            prevSpacer.height -= this.constants_.SMALL_PADDING;
-            nextSpacer.height -= this.constants_.SMALL_PADDING;
-          }
-        }
-      }
-    }
-  }
-
-  override finalize_() {
-    this.finalizeOutputConnection_();
-    this.finalizeHorizontalAlignment_();
-    this.finalizeVerticalAlignment_();
-    super.finalize_();
-
-    if (this.rightSide) {
-      this.widthWithChildren += this.rightSide.width;
-    }
-  }
-}