blockly 8.0.5 → 9.0.0-beta.0

package/core/renderers/common/constants.ts

@@ -0,0 +1,1124 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview An object that provides constants for rendering blocks.
+ */
+
+/**
+ * An object that provides constants for rendering blocks.
+ * @class
+ */
+import * as goog from '../../../closure/goog/goog.js';
+goog.declareModuleId('Blockly.blockRendering.ConstantProvider');
+
+import {ConnectionType} from '../../connection_type.js';
+import type {RenderedConnection} from '../../rendered_connection.js';
+import type {BlockStyle, Theme} from '../../theme.js';
+import * as colour from '../../utils/colour.js';
+import * as dom from '../../utils/dom.js';
+import * as parsing from '../../utils/parsing.js';
+import {Svg} from '../../utils/svg.js';
+import * as svgPaths from '../../utils/svg_paths.js';
+import * as userAgent from '../../utils/useragent.js';
+
+
+/** An object containing sizing and path information about outside corners. */
+export interface OutsideCorners {
+  topLeft: string;
+  topRight: string;
+  bottomRight: string;
+  bottomLeft: string;
+  rightHeight: number;
+}
+
+/** An object containing sizing and path information about inside corners. */
+export interface InsideCorners {
+  width: number;
+  height: number;
+  pathTop: string;
+  pathBottom: string;
+}
+
+/** An object containing sizing and path information about a start hat. */
+export interface StartHat {
+  height: number;
+  width: number;
+  path: string;
+}
+
+/** An object containing sizing and path information about a notch. */
+export interface Notch {
+  type: number;
+  width: number;
+  height: number;
+  pathLeft: string;
+  pathRight: string;
+}
+
+/** An object containing sizing and path information about a puzzle tab. */
+export interface PuzzleTab {
+  type: number;
+  width: number;
+  height: number;
+  pathDown: string|((p1: number) => string);
+  pathUp: string|((p1: number) => string);
+}
+
+/**
+ * An object containing sizing and path information about collapsed block
+ * indicators.
+ */
+export interface JaggedTeeth {
+  height: number;
+  width: number;
+  path: string;
+}
+
+export type BaseShape = {
+  type: number; width: number; height: number;
+};
+
+export type DynamicShape = {
+  type: number; width: (p1: number) => number; height: (p1: number) => number;
+  isDynamic: true;
+  connectionOffsetY: (p1: number) => number;
+  connectionOffsetX: (p1: number) => number;
+  pathDown: (p1: number) => string;
+  pathUp: (p1: number) => string;
+  pathRightDown: (p1: number) => string;
+  pathRightUp: (p1: number) => string;
+};
+
+/** An object containing sizing and type information about a shape. */
+export type Shape = BaseShape|DynamicShape;
+
+/** An object containing sizing and type information about a dynamic shape. */
+// export interface DynamicShape {
+//   type: number;
+//   width: (p1: number) => number;
+//   height: (p1: number) => number;
+//   isDynamic: boolean;
+//   connectionOffsetY: (p1: number) => number;
+//   connectionOffsetX: (p1: number) => number;
+//   pathDown: (p1: number) => string;
+//   pathUp: (p1: number) => string;
+//   pathRightDown: (p1: number) => string;
+//   pathRightUp: (p1: number) => string;
+// }
+
+/**
+ * An object that provides constants for rendering blocks.
+ * @alias Blockly.blockRendering.ConstantProvider
+ */
+export class ConstantProvider {
+  /** The size of an empty spacer. */
+  NO_PADDING = 0;
+
+  /** The size of small padding. */
+  SMALL_PADDING = 3;
+
+  /** The size of medium padding. */
+  MEDIUM_PADDING = 5;
+
+  /** The size of medium-large padding. */
+  MEDIUM_LARGE_PADDING = 8;
+
+  /** The size of large padding. */
+  LARGE_PADDING = 10;
+  TALL_INPUT_FIELD_OFFSET_Y: number;
+
+  /** The height of the puzzle tab used for input and output connections. */
+  TAB_HEIGHT = 15;
+
+  /**
+   * The offset from the top of the block at which a puzzle tab is positioned.
+   */
+  TAB_OFFSET_FROM_TOP = 5;
+
+  /**
+   * Vertical overlap of the puzzle tab, used to make it look more like a
+   * puzzle piece.
+   */
+  TAB_VERTICAL_OVERLAP = 2.5;
+
+  /** The width of the puzzle tab used for input and output connections. */
+  TAB_WIDTH = 8;
+
+  /** The width of the notch used for previous and next connections. */
+  NOTCH_WIDTH = 15;
+
+  /** The height of the notch used for previous and next connections. */
+  NOTCH_HEIGHT = 4;
+
+  /** The minimum width of the block. */
+  MIN_BLOCK_WIDTH = 12;
+  EMPTY_BLOCK_SPACER_HEIGHT = 16;
+  DUMMY_INPUT_MIN_HEIGHT: number;
+  DUMMY_INPUT_SHADOW_MIN_HEIGHT: number;
+
+  /** Rounded corner radius. */
+  CORNER_RADIUS = 8;
+
+  /**
+   * Offset from the left side of a block or the inside of a statement input
+   * to the left side of the notch.
+   */
+  NOTCH_OFFSET_LEFT = 15;
+  STATEMENT_INPUT_NOTCH_OFFSET: number;
+
+  STATEMENT_BOTTOM_SPACER = 0;
+  STATEMENT_INPUT_PADDING_LEFT = 20;
+
+  /** Vertical padding between consecutive statement inputs. */
+  BETWEEN_STATEMENT_PADDING_Y = 4;
+  TOP_ROW_MIN_HEIGHT: number;
+  TOP_ROW_PRECEDES_STATEMENT_MIN_HEIGHT: number;
+  BOTTOM_ROW_MIN_HEIGHT: number;
+  BOTTOM_ROW_AFTER_STATEMENT_MIN_HEIGHT: number;
+
+  /**
+   * Whether to add a 'hat' on top of all blocks with no previous or output
+   * connections. Can be overridden by 'hat' property on Theme.BlockStyle.
+   */
+  ADD_START_HATS = false;
+
+  /** Height of the top hat. */
+  START_HAT_HEIGHT = 15;
+
+  /** Width of the top hat. */
+  START_HAT_WIDTH = 100;
+
+  SPACER_DEFAULT_HEIGHT = 15;
+
+  MIN_BLOCK_HEIGHT = 24;
+
+  EMPTY_INLINE_INPUT_PADDING = 14.5;
+  EMPTY_INLINE_INPUT_HEIGHT: number;
+
+  EXTERNAL_VALUE_INPUT_PADDING = 2;
+  EMPTY_STATEMENT_INPUT_HEIGHT: number;
+  START_POINT: AnyDuringMigration;
+
+  /** Height of SVG path for jagged teeth at the end of collapsed blocks. */
+  JAGGED_TEETH_HEIGHT = 12;
+
+  /** Width of SVG path for jagged teeth at the end of collapsed blocks. */
+  JAGGED_TEETH_WIDTH = 6;
+
+  /** Point size of text. */
+  FIELD_TEXT_FONTSIZE = 11;
+
+  /** Text font weight. */
+  FIELD_TEXT_FONTWEIGHT = 'normal';
+
+  /** Text font family. */
+  FIELD_TEXT_FONTFAMILY = 'sans-serif';
+
+  /**
+   * Height of text.  This constant is dynamically set in
+   * ``setFontConstants_`` to be the height of the text based on the font
+   * used.
+   */
+  FIELD_TEXT_HEIGHT: number = -1;  // Dynamically set.
+
+  /**
+   * Text baseline.  This constant is dynamically set in ``setFontConstants_``
+   * to be the baseline of the text based on the font used.
+   */
+  FIELD_TEXT_BASELINE: number = -1;  // Dynamically set.
+
+  /** A field's border rect corner radius. */
+  FIELD_BORDER_RECT_RADIUS = 4;
+
+  /** A field's border rect default height. */
+  FIELD_BORDER_RECT_HEIGHT = 16;
+
+  /** A field's border rect X padding. */
+  FIELD_BORDER_RECT_X_PADDING = 5;
+
+  /** A field's border rect Y padding. */
+  FIELD_BORDER_RECT_Y_PADDING = 3;
+
+  /**
+   * The backing colour of a field's border rect.
+   * @internal
+   */
+  FIELD_BORDER_RECT_COLOUR = '#fff';
+  FIELD_TEXT_BASELINE_CENTER: boolean;
+  FIELD_DROPDOWN_BORDER_RECT_HEIGHT: number;
+
+  /**
+   * Whether or not a dropdown field should add a border rect when in a shadow
+   * block.
+   */
+  FIELD_DROPDOWN_NO_BORDER_RECT_SHADOW = false;
+
+  /**
+   * Whether or not a dropdown field's div should be coloured to match the
+   * block colours.
+   */
+  FIELD_DROPDOWN_COLOURED_DIV = false;
+
+  /** Whether or not a dropdown field uses a text or SVG arrow. */
+  FIELD_DROPDOWN_SVG_ARROW = false;
+  FIELD_DROPDOWN_SVG_ARROW_PADDING: number;
+
+  /** A dropdown field's SVG arrow size. */
+  FIELD_DROPDOWN_SVG_ARROW_SIZE = 12;
+  FIELD_DROPDOWN_SVG_ARROW_DATAURI: string;
+
+  /**
+   * Whether or not to show a box shadow around the widget div. This is only a
+   * feature of full block fields.
+   */
+  FIELD_TEXTINPUT_BOX_SHADOW = false;
+
+  /**
+   * Whether or not the colour field should display its colour value on the
+   * entire block.
+   */
+  FIELD_COLOUR_FULL_BLOCK = false;
+
+  /** A colour field's default width. */
+  FIELD_COLOUR_DEFAULT_WIDTH = 26;
+  FIELD_COLOUR_DEFAULT_HEIGHT: number;
+  FIELD_CHECKBOX_X_OFFSET: number;
+  /** @internal */
+  randomIdentifier: string;
+
+  /**
+   * The defs tag that contains all filters and patterns for this Blockly
+   * instance.
+   */
+  private defs_: SVGElement|null = null;
+
+  /**
+   * The ID of the emboss filter, or the empty string if no filter is set.
+   * @internal
+   */
+  embossFilterId = '';
+
+  /** The <filter> element to use for highlighting, or null if not set. */
+  // AnyDuringMigration because:  Type 'null' is not assignable to type
+  // 'SVGElement'.
+  private embossFilter_: SVGElement = null as AnyDuringMigration;
+
+  /**
+   * The ID of the disabled pattern, or the empty string if no pattern is set.
+   * @internal
+   */
+  disabledPatternId = '';
+
+  /**
+   * The <pattern> element to use for disabled blocks, or null if not set.
+   */
+  // AnyDuringMigration because:  Type 'null' is not assignable to type
+  // 'SVGElement'.
+  private disabledPattern_: SVGElement = null as AnyDuringMigration;
+
+  /**
+   * The ID of the debug filter, or the empty string if no pattern is set.
+   */
+  debugFilterId = '';
+
+  /**
+   * The <filter> element to use for a debug highlight, or null if not set.
+   */
+  // AnyDuringMigration because:  Type 'null' is not assignable to type
+  // 'SVGElement'.
+  private debugFilter_: SVGElement = null as AnyDuringMigration;
+
+  /** The <style> element to use for injecting renderer specific CSS. */
+  // AnyDuringMigration because:  Type 'null' is not assignable to type
+  // 'HTMLStyleElement'.
+  private cssNode_: HTMLStyleElement = null as AnyDuringMigration;
+
+  /**
+   * Cursor colour.
+   * @internal
+   */
+  CURSOR_COLOUR = '#cc0a0a';
+
+  /**
+   * Immovable marker colour.
+   * @internal
+   */
+  MARKER_COLOUR = '#4286f4';
+
+  /**
+   * Width of the horizontal cursor.
+   * @internal
+   */
+  CURSOR_WS_WIDTH = 100;
+
+  /**
+   * Height of the horizontal cursor.
+   * @internal
+   */
+  WS_CURSOR_HEIGHT = 5;
+
+  /**
+   * Padding around a stack.
+   * @internal
+   */
+  CURSOR_STACK_PADDING = 10;
+
+  /**
+   * Padding around a block.
+   * @internal
+   */
+  CURSOR_BLOCK_PADDING = 2;
+
+  /**
+   * Stroke of the cursor.
+   * @internal
+   */
+  CURSOR_STROKE_WIDTH = 4;
+
+  /**
+   * Whether text input and colour fields fill up the entire source block.
+   * @internal
+   */
+  FULL_BLOCK_FIELDS = false;
+
+  /**
+   * The main colour of insertion markers, in hex.  The block is rendered a
+   * transparent grey by changing the fill opacity in CSS.
+   * @internal
+   */
+  INSERTION_MARKER_COLOUR = '#000000';
+
+  /**
+   * The insertion marker opacity.
+   * @internal
+   */
+  INSERTION_MARKER_OPACITY = 0.2;
+
+  SHAPES: {[key: string]: number} = {PUZZLE: 1, NOTCH: 2};
+  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
+  JAGGED_TEETH!: JaggedTeeth;
+  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
+  NOTCH!: Notch;
+  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
+  START_HAT!: StartHat;
+  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
+  PUZZLE_TAB!: PuzzleTab;
+  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
+  INSIDE_CORNERS!: InsideCorners;
+  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
+  OUTSIDE_CORNERS!: OutsideCorners;
+  // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
+  /** @internal */
+  blockStyles!: {[key: string]: BlockStyle};
+
+  /** @internal */
+  constructor() {
+    /**
+     * Offset from the top of the row for placing fields on inline input rows
+     * and statement input rows.
+     * Matches existing rendering (in 2019).
+     */
+    this.TALL_INPUT_FIELD_OFFSET_Y = this.MEDIUM_PADDING;
+
+    /** The minimum height of a dummy input row. */
+    this.DUMMY_INPUT_MIN_HEIGHT = this.TAB_HEIGHT;
+
+    /** The minimum height of a dummy input row in a shadow block. */
+    this.DUMMY_INPUT_SHADOW_MIN_HEIGHT = this.TAB_HEIGHT;
+
+    /**
+     * Additional offset added to the statement input's width to account for the
+     * notch.
+     */
+    this.STATEMENT_INPUT_NOTCH_OFFSET = this.NOTCH_OFFSET_LEFT;
+
+    /** The top row's minimum height. */
+    this.TOP_ROW_MIN_HEIGHT = this.MEDIUM_PADDING;
+
+    /** The top row's minimum height if it precedes a statement. */
+    this.TOP_ROW_PRECEDES_STATEMENT_MIN_HEIGHT = this.LARGE_PADDING;
+
+    /** The bottom row's minimum height. */
+    this.BOTTOM_ROW_MIN_HEIGHT = this.MEDIUM_PADDING;
+
+    /** The bottom row's minimum height if it follows a statement input. */
+    this.BOTTOM_ROW_AFTER_STATEMENT_MIN_HEIGHT = this.LARGE_PADDING;
+
+    /** The height of an empty inline input. */
+    this.EMPTY_INLINE_INPUT_HEIGHT = this.TAB_HEIGHT + 11;
+
+    /**
+     * The height of an empty statement input.  Note that in the old rendering
+     * this varies slightly depending on whether the block has external or
+     * inline inputs. In the new rendering this is consistent.  It seems
+     * unlikely that the old behaviour was intentional.
+     */
+    this.EMPTY_STATEMENT_INPUT_HEIGHT = this.MIN_BLOCK_HEIGHT;
+
+    this.START_POINT = svgPaths.moveBy(0, 0);
+
+    /** A field's text element's dominant baseline. */
+    this.FIELD_TEXT_BASELINE_CENTER = !userAgent.IE && !userAgent.EDGE;
+
+    /** A dropdown field's border rect height. */
+    this.FIELD_DROPDOWN_BORDER_RECT_HEIGHT = this.FIELD_BORDER_RECT_HEIGHT;
+
+    /** A dropdown field's SVG arrow padding. */
+    this.FIELD_DROPDOWN_SVG_ARROW_PADDING = this.FIELD_BORDER_RECT_X_PADDING;
+
+    /** A dropdown field's SVG arrow datauri. */
+    this.FIELD_DROPDOWN_SVG_ARROW_DATAURI =
+        'data:image/svg+xml;base64,PHN2ZyBpZD0iTGF5ZXJfMSIgZGF0YS1uYW1lPSJMYXllci' +
+        'AxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMi43MSIgaG' +
+        'VpZ2h0PSI4Ljc5IiB2aWV3Qm94PSIwIDAgMTIuNzEgOC43OSI+PHRpdGxlPmRyb3Bkb3duLW' +
+        'Fycm93PC90aXRsZT48ZyBvcGFjaXR5PSIwLjEiPjxwYXRoIGQ9Ik0xMi43MSwyLjQ0QTIuND' +
+        'EsMi40MSwwLDAsMSwxMiw0LjE2TDguMDgsOC4wOGEyLjQ1LDIuNDUsMCwwLDEtMy40NSwwTD' +
+        'AuNzIsNC4xNkEyLjQyLDIuNDIsMCwwLDEsMCwyLjQ0LDIuNDgsMi40OCwwLDAsMSwuNzEuNz' +
+        'FDMSwwLjQ3LDEuNDMsMCw2LjM2LDBTMTEuNzUsMC40NiwxMiwuNzFBMi40NCwyLjQ0LDAsMC' +
+        'wxLDEyLjcxLDIuNDRaIiBmaWxsPSIjMjMxZjIwIi8+PC9nPjxwYXRoIGQ9Ik02LjM2LDcuNz' +
+        'lhMS40MywxLjQzLDAsMCwxLTEtLjQyTDEuNDIsMy40NWExLjQ0LDEuNDQsMCwwLDEsMC0yYz' +
+        'AuNTYtLjU2LDkuMzEtMC41Niw5Ljg3LDBhMS40NCwxLjQ0LDAsMCwxLDAsMkw3LjM3LDcuMz' +
+        'dBMS40MywxLjQzLDAsMCwxLDYuMzYsNy43OVoiIGZpbGw9IiNmZmYiLz48L3N2Zz4=';
+
+    /** A colour field's default height. */
+    this.FIELD_COLOUR_DEFAULT_HEIGHT = this.FIELD_BORDER_RECT_HEIGHT;
+
+    /** A checkbox field's X offset. */
+    this.FIELD_CHECKBOX_X_OFFSET = this.FIELD_BORDER_RECT_X_PADDING - 3;
+
+    /**
+     * A random identifier used to ensure a unique ID is used for each
+     * filter/pattern for the case of multiple Blockly instances on a page.
+     * @internal
+     */
+    this.randomIdentifier = String(Math.random()).substring(2);
+  }
+
+  /**
+   * Initialize shape objects based on the constants set in the constructor.
+   * @internal
+   */
+  init() {
+    /**
+     * An object containing sizing and path information about collapsed block
+     * indicators.
+     */
+    this.JAGGED_TEETH = this.makeJaggedTeeth();
+
+    /** An object containing sizing and path information about notches. */
+    this.NOTCH = this.makeNotch();
+
+    /** An object containing sizing and path information about start hats */
+    this.START_HAT = this.makeStartHat();
+
+    /**
+     * An object containing sizing and path information about puzzle tabs.
+     */
+    this.PUZZLE_TAB = this.makePuzzleTab();
+
+    /**
+     * An object containing sizing and path information about inside corners
+     */
+    this.INSIDE_CORNERS = this.makeInsideCorners();
+
+    /**
+     * An object containing sizing and path information about outside corners.
+     */
+    this.OUTSIDE_CORNERS = this.makeOutsideCorners();
+  }
+
+  /**
+   * Refresh constants properties that depend on the theme.
+   * @param theme The current workspace theme.
+   * @internal
+   */
+  setTheme(theme: Theme) {
+    /** The block styles map. */
+    this.blockStyles = Object.create(null);
+
+    const blockStyles = theme.blockStyles;
+    for (const key in blockStyles) {
+      this.blockStyles[key] = this.validatedBlockStyle_(blockStyles[key]);
+    }
+
+    this.setDynamicProperties_(theme);
+  }
+
+  /**
+   * Sets dynamic properties that depend on other values or theme properties.
+   * @param theme The current workspace theme.
+   */
+  protected setDynamicProperties_(theme: Theme) {
+    this.setFontConstants_(theme);
+    this.setComponentConstants_(theme);
+
+    this.ADD_START_HATS =
+        theme.startHats !== null ? theme.startHats : this.ADD_START_HATS;
+  }
+
+  /**
+   * Set constants related to fonts.
+   * @param theme The current workspace theme.
+   */
+  protected setFontConstants_(theme: Theme) {
+    if (theme.fontStyle && theme.fontStyle['family']) {
+      this.FIELD_TEXT_FONTFAMILY = theme.fontStyle['family'];
+    }
+
+    if (theme.fontStyle && theme.fontStyle['weight']) {
+      this.FIELD_TEXT_FONTWEIGHT = theme.fontStyle['weight'];
+    }
+
+    if (theme.fontStyle && theme.fontStyle['size']) {
+      this.FIELD_TEXT_FONTSIZE = theme.fontStyle['size'];
+    }
+
+    const fontMetrics = dom.measureFontMetrics(
+        'Hg', this.FIELD_TEXT_FONTSIZE + 'pt', this.FIELD_TEXT_FONTWEIGHT,
+        this.FIELD_TEXT_FONTFAMILY);
+
+    this.FIELD_TEXT_HEIGHT = fontMetrics.height;
+    this.FIELD_TEXT_BASELINE = fontMetrics.baseline;
+  }
+
+  /**
+   * Set constants from a theme's component styles.
+   * @param theme The current workspace theme.
+   */
+  protected setComponentConstants_(theme: Theme) {
+    this.CURSOR_COLOUR =
+        theme.getComponentStyle('cursorColour') || this.CURSOR_COLOUR;
+    this.MARKER_COLOUR =
+        theme.getComponentStyle('markerColour') || this.MARKER_COLOUR;
+    this.INSERTION_MARKER_COLOUR =
+        theme.getComponentStyle('insertionMarkerColour') ||
+        this.INSERTION_MARKER_COLOUR;
+    this.INSERTION_MARKER_OPACITY =
+        Number(theme.getComponentStyle('insertionMarkerOpacity')) ||
+        this.INSERTION_MARKER_OPACITY;
+  }
+
+  /**
+   * Get or create a block style based on a single colour value.  Generate a
+   * name for the style based on the colour.
+   * @param colour #RRGGBB colour string.
+   * @return An object containing the style and an autogenerated name for that
+   *     style.
+   * @internal
+   */
+  getBlockStyleForColour(colour: string): {style: BlockStyle, name: string} {
+    const name = 'auto_' + colour;
+    if (!this.blockStyles[name]) {
+      this.blockStyles[name] = this.createBlockStyle_(colour);
+    }
+    return {style: this.blockStyles[name], name};
+  }
+
+  /**
+   * Gets the BlockStyle for the given block style name.
+   * @param blockStyleName The name of the block style.
+   * @return The named block style, or a default style if no style with the
+   *     given name was found.
+   */
+  getBlockStyle(blockStyleName: string|null): BlockStyle {
+    return this.blockStyles[blockStyleName || ''] ||
+        (blockStyleName && blockStyleName.indexOf('auto_') === 0 ?
+             this.getBlockStyleForColour(blockStyleName.substring(5)).style :
+             this.createBlockStyle_('#000000'));
+  }
+
+  /**
+   * Create a block style object based on the given colour.
+   * @param colour #RRGGBB colour string.
+   * @return A populated block style based on the given colour.
+   */
+  protected createBlockStyle_(colour: string): BlockStyle {
+    return this.validatedBlockStyle_({'colourPrimary': colour});
+  }
+
+  /**
+   * Get a full block style object based on the input style object.  Populate
+   * any missing values.
+   * @param blockStyle A full or partial block style object.
+   * @return A full block style object, with all required properties populated.
+   */
+  protected validatedBlockStyle_(blockStyle: {
+    colourPrimary: string,
+    colourSecondary?: string,
+    colourTertiary?: string,
+    hat?: string
+  }): BlockStyle {
+    // Make a new object with all of the same properties.
+    const valid = {} as BlockStyle;
+    if (blockStyle) {
+      Object.assign(valid, blockStyle);
+    }
+    // Validate required properties.
+    const parsedColour =
+        parsing.parseBlockColour(valid['colourPrimary'] || '#000');
+    valid.colourPrimary = parsedColour.hex;
+    valid.colourSecondary = valid['colourSecondary'] ?
+        parsing.parseBlockColour(valid['colourSecondary']).hex :
+        this.generateSecondaryColour_(valid.colourPrimary);
+    valid.colourTertiary = valid['colourTertiary'] ?
+        parsing.parseBlockColour(valid['colourTertiary']).hex :
+        this.generateTertiaryColour_(valid.colourPrimary);
+
+    valid.hat = valid['hat'] || '';
+    return valid;
+  }
+
+  /**
+   * Generate a secondary colour from the passed in primary colour.
+   * @param inputColour Primary colour.
+   * @return The generated secondary colour.
+   */
+  protected generateSecondaryColour_(inputColour: string): string {
+    return colour.blend('#fff', inputColour, 0.6) || inputColour;
+  }
+
+  /**
+   * Generate a tertiary colour from the passed in primary colour.
+   * @param inputColour Primary colour.
+   * @return The generated tertiary colour.
+   */
+  protected generateTertiaryColour_(inputColour: string): string {
+    return colour.blend('#fff', inputColour, 0.3) || inputColour;
+  }
+
+  /**
+   * Dispose of this constants provider.
+   * Delete all DOM elements that this provider created.
+   * @internal
+   */
+  dispose() {
+    if (this.embossFilter_) {
+      dom.removeNode(this.embossFilter_);
+    }
+    if (this.disabledPattern_) {
+      dom.removeNode(this.disabledPattern_);
+    }
+    if (this.debugFilter_) {
+      dom.removeNode(this.debugFilter_);
+    }
+    // AnyDuringMigration because:  Type 'null' is not assignable to type
+    // 'HTMLStyleElement'.
+    this.cssNode_ = null as AnyDuringMigration;
+  }
+
+  /**
+   * @return An object containing sizing and path information about collapsed
+   *     block indicators.
+   * @internal
+   */
+  makeJaggedTeeth(): JaggedTeeth {
+    const height = this.JAGGED_TEETH_HEIGHT;
+    const width = this.JAGGED_TEETH_WIDTH;
+
+    const mainPath = svgPaths.line([
+      svgPaths.point(width, height / 4),
+      svgPaths.point(-width * 2, height / 2),
+      svgPaths.point(width, height / 4),
+    ]);
+    return {height, width, path: mainPath};
+  }
+
+  /**
+   * @return An object containing sizing and path information about start hats.
+   * @internal
+   */
+  makeStartHat(): StartHat {
+    const height = this.START_HAT_HEIGHT;
+    const width = this.START_HAT_WIDTH;
+
+    const mainPath = svgPaths.curve('c', [
+      svgPaths.point(30, -height),
+      svgPaths.point(70, -height),
+      svgPaths.point(width, 0),
+    ]);
+    return {height, width, path: mainPath};
+  }
+
+  /**
+   * @return An object containing sizing and path information about puzzle tabs.
+   * @internal
+   */
+  makePuzzleTab(): PuzzleTab {
+    const width = this.TAB_WIDTH;
+    const height = this.TAB_HEIGHT;
+
+    /**
+     * Make the main path for the puzzle tab made out of a few curves (c and s).
+     * Those curves are defined with relative positions.  The 'up' and 'down'
+     * versions of the paths are the same, but the Y sign flips.  Forward and
+     * back are the signs to use to move the cursor in the direction that the
+     * path is being drawn.
+     * @param up True if the path should be drawn from bottom to top, false
+     *     otherwise.
+     * @return A path fragment describing a puzzle tab.
+     */
+    function makeMainPath(up: boolean): string {
+      const forward = up ? -1 : 1;
+      const back = -forward;
+
+      const overlap = 2.5;
+      const halfHeight = height / 2;
+      const control1Y = halfHeight + overlap;
+      const control2Y = halfHeight + 0.5;
+      const control3Y = overlap;  // 2.5
+
+      const endPoint1 = svgPaths.point(-width, forward * halfHeight);
+      const endPoint2 = svgPaths.point(width, forward * halfHeight);
+
+      return svgPaths.curve(
+                 'c',
+                 [
+                   svgPaths.point(0, forward * control1Y),
+                   svgPaths.point(-width, back * control2Y),
+                   endPoint1,
+                 ]) +
+          svgPaths.curve(
+              's', [svgPaths.point(width, back * control3Y), endPoint2]);
+    }
+
+    // c 0,-10  -8,8  -8,-7.5  s 8,2.5  8,-7.5
+    const pathUp = makeMainPath(true);
+    // c 0,10  -8,-8  -8,7.5  s 8,-2.5  8,7.5
+    const pathDown = makeMainPath(false);
+
+    return {
+      type: this.SHAPES.PUZZLE,
+      width,
+      height,
+      pathDown,
+      pathUp,
+    };
+  }
+
+  /**
+   * @return An object containing sizing and path information about notches.
+   * @internal
+   */
+  makeNotch(): Notch {
+    const width = this.NOTCH_WIDTH;
+    const height = this.NOTCH_HEIGHT;
+    const innerWidth = 3;
+    const outerWidth = (width - innerWidth) / 2;
+
+    /**
+     * Make the main path for the notch.
+     * @param dir Direction multiplier to apply to horizontal offsets along the
+     *     path. Either 1 or -1.
+     * @return A path fragment describing a notch.
+     */
+    function makeMainPath(dir: number): string {
+      return svgPaths.line([
+        svgPaths.point(dir * outerWidth, height),
+        svgPaths.point(dir * innerWidth, 0),
+        svgPaths.point(dir * outerWidth, -height),
+      ]);
+    }
+    const pathLeft = makeMainPath(1);
+    const pathRight = makeMainPath(-1);
+
+    return {
+      type: this.SHAPES.NOTCH,
+      width,
+      height,
+      pathLeft,
+      pathRight,
+    };
+  }
+
+  /**
+   * @return An object containing sizing and path information about inside
+   *     corners.
+   * @internal
+   */
+  makeInsideCorners(): InsideCorners {
+    const radius = this.CORNER_RADIUS;
+
+    const innerTopLeftCorner =
+        svgPaths.arc('a', '0 0,0', radius, svgPaths.point(-radius, radius));
+
+    const innerBottomLeftCorner =
+        svgPaths.arc('a', '0 0,0', radius, svgPaths.point(radius, radius));
+
+    return {
+      width: radius,
+      height: radius,
+      pathTop: innerTopLeftCorner,
+      pathBottom: innerBottomLeftCorner,
+    };
+  }
+
+  /**
+   * @return An object containing sizing and path information about outside
+   *     corners.
+   * @internal
+   */
+  makeOutsideCorners(): OutsideCorners {
+    const radius = this.CORNER_RADIUS;
+    /** SVG path for drawing the rounded top-left corner. */
+    const topLeft = svgPaths.moveBy(0, radius) +
+        svgPaths.arc('a', '0 0,1', radius, svgPaths.point(radius, -radius));
+
+    /** SVG path for drawing the rounded top-right corner. */
+    const topRight =
+        svgPaths.arc('a', '0 0,1', radius, svgPaths.point(radius, radius));
+
+    /** SVG path for drawing the rounded bottom-left corner. */
+    const bottomLeft =
+        svgPaths.arc('a', '0 0,1', radius, svgPaths.point(-radius, -radius));
+
+    /** SVG path for drawing the rounded bottom-right corner. */
+    const bottomRight =
+        svgPaths.arc('a', '0 0,1', radius, svgPaths.point(-radius, radius));
+
+    return {
+      topLeft,
+      topRight,
+      bottomRight,
+      bottomLeft,
+      rightHeight: radius,
+    };
+  }
+
+  /**
+   * Get an object with connection shape and sizing information based on the
+   * type of the connection.
+   * @param connection The connection to find a shape object for
+   * @return The shape object for the connection.
+   * @internal
+   */
+  shapeFor(connection: RenderedConnection): Shape {
+    switch (connection.type) {
+      case ConnectionType.INPUT_VALUE:
+      case ConnectionType.OUTPUT_VALUE:
+        return this.PUZZLE_TAB;
+      case ConnectionType.PREVIOUS_STATEMENT:
+      case ConnectionType.NEXT_STATEMENT:
+        return this.NOTCH;
+      default:
+        throw Error('Unknown connection type');
+    }
+  }
+
+  /**
+   * Create any DOM elements that this renderer needs (filters, patterns, etc).
+   * @param svg The root of the workspace's SVG.
+   * @param tagName The name to use for the CSS style tag.
+   * @param selector The CSS selector to use.
+   * @suppress {strictModuleDepCheck} Debug renderer only included in
+   * playground.
+   * @internal
+   */
+  createDom(svg: SVGElement, tagName: string, selector: string) {
+    this.injectCSS_(tagName, selector);
+
+    /*
+        <defs>
+          ... filters go here ...
+        </defs>
+        */
+    this.defs_ = dom.createSvgElement(Svg.DEFS, {}, svg);
+    /*
+          <filter id="blocklyEmbossFilter837493">
+            <feGaussianBlur in="SourceAlpha" stdDeviation="1" result="blur" />
+            <feSpecularLighting in="blur" surfaceScale="1"
+       specularConstant="0.5" specularExponent="10" lighting-color="white"
+                                result="specOut">
+              <fePointLight x="-5000" y="-10000" z="20000" />
+            </feSpecularLighting>
+            <feComposite in="specOut" in2="SourceAlpha" operator="in"
+                         result="specOut" />
+            <feComposite in="SourceGraphic" in2="specOut" operator="arithmetic"
+                         k1="0" k2="1" k3="1" k4="0" />
+          </filter>
+        */
+    // AnyDuringMigration because:  Argument of type 'SVGElement | null' is not
+    // assignable to parameter of type 'Element | undefined'.
+    const embossFilter = dom.createSvgElement(
+        Svg.FILTER, {'id': 'blocklyEmbossFilter' + this.randomIdentifier},
+        this.defs_ as AnyDuringMigration);
+    dom.createSvgElement(
+        Svg.FEGAUSSIANBLUR,
+        {'in': 'SourceAlpha', 'stdDeviation': 1, 'result': 'blur'},
+        embossFilter);
+    const feSpecularLighting = dom.createSvgElement(
+        Svg.FESPECULARLIGHTING, {
+          'in': 'blur',
+          'surfaceScale': 1,
+          'specularConstant': 0.5,
+          'specularExponent': 10,
+          'lighting-color': 'white',
+          'result': 'specOut',
+        },
+        embossFilter);
+    dom.createSvgElement(
+        Svg.FEPOINTLIGHT, {'x': -5000, 'y': -10000, 'z': 20000},
+        feSpecularLighting);
+    dom.createSvgElement(
+        Svg.FECOMPOSITE, {
+          'in': 'specOut',
+          'in2': 'SourceAlpha',
+          'operator': 'in',
+          'result': 'specOut',
+        },
+        embossFilter);
+    dom.createSvgElement(
+        Svg.FECOMPOSITE, {
+          'in': 'SourceGraphic',
+          'in2': 'specOut',
+          'operator': 'arithmetic',
+          'k1': 0,
+          'k2': 1,
+          'k3': 1,
+          'k4': 0,
+        },
+        embossFilter);
+    this.embossFilterId = embossFilter.id;
+    this.embossFilter_ = embossFilter;
+
+    /*
+          <pattern id="blocklyDisabledPattern837493"
+       patternUnits="userSpaceOnUse" width="10" height="10"> <rect width="10"
+       height="10" fill="#aaa" /> <path d="M 0 0 L 10 10 M 10 0 L 0 10"
+       stroke="#cc0" />
+          </pattern>
+        */
+    // AnyDuringMigration because:  Argument of type 'SVGElement | null' is not
+    // assignable to parameter of type 'Element | undefined'.
+    const disabledPattern = dom.createSvgElement(
+        Svg.PATTERN, {
+          'id': 'blocklyDisabledPattern' + this.randomIdentifier,
+          'patternUnits': 'userSpaceOnUse',
+          'width': 10,
+          'height': 10,
+        },
+        this.defs_ as AnyDuringMigration);
+    dom.createSvgElement(
+        Svg.RECT, {'width': 10, 'height': 10, 'fill': '#aaa'}, disabledPattern);
+    dom.createSvgElement(
+        Svg.PATH, {'d': 'M 0 0 L 10 10 M 10 0 L 0 10', 'stroke': '#cc0'},
+        disabledPattern);
+    this.disabledPatternId = disabledPattern.id;
+    this.disabledPattern_ = disabledPattern;
+
+    this.createDebugFilter();
+  }
+
+  /**
+   * Create a filter for highlighting the currently rendering block during
+   * render debugging.
+   */
+  private createDebugFilter() {
+    // Only create the debug filter once.
+    if (!this.debugFilter_) {
+      // AnyDuringMigration because:  Argument of type 'SVGElement | null' is
+      // not assignable to parameter of type 'Element | undefined'.
+      const debugFilter = dom.createSvgElement(
+          Svg.FILTER, {
+            'id': 'blocklyDebugFilter' + this.randomIdentifier,
+            'height': '160%',
+            'width': '180%',
+            'y': '-30%',
+            'x': '-40%',
+          },
+          this.defs_ as AnyDuringMigration);
+      // Set all gaussian blur pixels to 1 opacity before applying flood
+      const debugComponentTransfer = dom.createSvgElement(
+          Svg.FECOMPONENTTRANSFER, {'result': 'outBlur'}, debugFilter);
+      dom.createSvgElement(
+          Svg.FEFUNCA,
+          {'type': 'table', 'tableValues': '0 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1'},
+          debugComponentTransfer);
+      // Color the highlight
+      dom.createSvgElement(
+          Svg.FEFLOOD, {
+            'flood-color': '#ff0000',
+            'flood-opacity': 0.5,
+            'result': 'outColor',
+          },
+          debugFilter);
+      dom.createSvgElement(
+          Svg.FECOMPOSITE, {
+            'in': 'outColor',
+            'in2': 'outBlur',
+            'operator': 'in',
+            'result': 'outGlow',
+          },
+          debugFilter);
+      this.debugFilterId = debugFilter.id;
+      this.debugFilter_ = debugFilter;
+    }
+  }
+
+  /**
+   * Inject renderer specific CSS into the page.
+   * @param tagName The name of the style tag to use.
+   * @param selector The CSS selector to use.
+   */
+  protected injectCSS_(tagName: string, selector: string) {
+    const cssArray = this.getCSS_(selector);
+    const cssNodeId = 'blockly-renderer-style-' + tagName;
+    this.cssNode_ = document.getElementById(cssNodeId) as HTMLStyleElement;
+    const text = cssArray.join('\n');
+    if (this.cssNode_) {
+      // Already injected, update if the theme changed.
+      this.cssNode_.firstChild!.textContent = text;
+      return;
+    }
+    // Inject CSS tag at start of head.
+    const cssNode = (document.createElement('style'));
+    cssNode.id = cssNodeId;
+    const cssTextNode = document.createTextNode(text);
+    cssNode.appendChild(cssTextNode);
+    document.head.insertBefore(cssNode, document.head.firstChild);
+    this.cssNode_ = cssNode;
+  }
+
+  /**
+   * Get any renderer specific CSS to inject when the renderer is initialized.
+   * @param selector CSS selector to use.
+   * @return Array of CSS strings.
+   */
+  protected getCSS_(selector: string): string[] {
+    return [
+      /* eslint-disable indent */
+      /* clang-format off */
+      // Text.
+      selector + ' .blocklyText, ', selector + ' .blocklyFlyoutLabelText {', 'font: ' + this.FIELD_TEXT_FONTWEIGHT + ' ' + this.FIELD_TEXT_FONTSIZE + 'pt ' + this.FIELD_TEXT_FONTFAMILY + ';', '}',
+
+      // Fields.
+      selector + ' .blocklyText {', 'fill: #fff;', '}', selector + ' .blocklyNonEditableText>rect,', selector + ' .blocklyEditableText>rect {', 'fill: ' + this.FIELD_BORDER_RECT_COLOUR + ';', 'fill-opacity: .6;', 'stroke: none;', '}', selector + ' .blocklyNonEditableText>text,', selector + ' .blocklyEditableText>text {', 'fill: #000;', '}',
+
+      // Flyout labels.
+      selector + ' .blocklyFlyoutLabelText {', 'fill: #000;', '}',
+
+      // Bubbles.
+      selector + ' .blocklyText.blocklyBubbleText {', 'fill: #000;', '}',
+
+      // Editable field hover.
+      selector + ' .blocklyEditableText:not(.editing):hover>rect {', 'stroke: #fff;', 'stroke-width: 2;', '}',
+
+      // Text field input.
+      selector + ' .blocklyHtmlInput {', 'font-family: ' + this.FIELD_TEXT_FONTFAMILY + ';', 'font-weight: ' + this.FIELD_TEXT_FONTWEIGHT + ';', '}', // Selection highlight.
+      selector + ' .blocklySelected>.blocklyPath {', 'stroke: #fc3;', 'stroke-width: 3px;', '}',
+
+      // Connection highlight.
+      selector + ' .blocklyHighlightedConnectionPath {', 'stroke: #fc3;', '}',
+
+      // Replaceable highlight.
+      selector + ' .blocklyReplaceable .blocklyPath {', 'fill-opacity: .5;', '}', selector + ' .blocklyReplaceable .blocklyPathLight,', selector + ' .blocklyReplaceable .blocklyPathDark {', 'display: none;', '}',
+
+      // Insertion marker.
+      selector + ' .blocklyInsertionMarker>.blocklyPath {', 'fill-opacity: ' + this.INSERTION_MARKER_OPACITY + ';', 'stroke: none;', '}',];
+  }
+}
+/* clang-format on */
+/* eslint-enable indent */