@lightningjs/renderer 2.9.0-beta3 → 2.9.0

package/src/core/text-rendering/renderers/LightningTextTextureRenderer.ts

@@ -1,798 +1,798 @@
-/*
- * If not stated otherwise in this file or this component's LICENSE file the
- * following copyright and licenses apply:
- *
- * Copyright 2023 Comcast Cable Communications Management, LLC.
- *
- * Licensed under the Apache License, Version 2.0 (the License);
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-/* eslint-disable @typescript-eslint/no-non-null-assertion */
-
-import { assertTruthy } from '../../../utils.js';
-import { getRgbaString, type RGBA } from '../../lib/utils.js';
-import { calcDefaultLineHeight } from '../TextRenderingUtils.js';
-import {
-  getWebFontMetrics,
-  isZeroWidthSpace,
-} from '../TextTextureRendererUtils.js';
-import type { NormalizedFontMetrics } from '../font-face-types/TrFontFace.js';
-import type { WebTrFontFace } from '../font-face-types/WebTrFontFace.js';
-
-const MAX_TEXTURE_DIMENSION = 2048;
-
-/**
- * Text Overflow Values
- */
-export type TextOverflow =
-  | 'ellipsis'
-  | 'clip'
-  | (string & Record<never, never>);
-
-/***
- * Text Horizontal Align Values
- */
-export type TextAlign = 'left' | 'center' | 'right';
-
-/***
- * Text Baseline Values
- */
-export type TextBaseline =
-  | 'alphabetic'
-  | 'top'
-  | 'hanging'
-  | 'middle'
-  | 'ideographic'
-  | 'bottom';
-
-/***
- * Text Vertical Align Values
- */
-export type TextVerticalAlign = 'top' | 'middle' | 'bottom';
-
-/**
- * Text Texture Settings
- */
-export interface Settings {
-  w: number;
-  h: number;
-  text: string;
-  fontStyle: string;
-  fontSize: number;
-  fontBaselineRatio: number;
-  fontFamily: string | null;
-  trFontFace: WebTrFontFace | null;
-  wordWrap: boolean;
-  wordWrapWidth: number;
-  wordBreak: boolean;
-  textOverflow: TextOverflow | null;
-  lineHeight: number | null;
-  textBaseline: TextBaseline;
-  textAlign: TextAlign;
-  verticalAlign: TextVerticalAlign;
-  offsetY: number | null;
-  maxLines: number;
-  maxHeight: number | null;
-  overflowSuffix: string;
-  precision: number;
-  textColor: RGBA;
-  paddingLeft: number;
-  paddingRight: number;
-  shadow: boolean;
-  shadowColor: RGBA;
-  shadowOffsetX: number;
-  shadowOffsetY: number;
-  shadowBlur: number;
-  highlight: boolean;
-  highlightHeight: number;
-  highlightColor: RGBA;
-  highlightOffset: number;
-  highlightPaddingLeft: number;
-  highlightPaddingRight: number;
-  letterSpacing: number;
-  textIndent: number;
-  cutSx: number;
-  cutSy: number;
-  cutEx: number;
-  cutEy: number;
-  advancedRenderer: boolean;
-
-  // Normally stage options
-  textRenderIssueMargin: number;
-}
-
-export interface RenderInfo {
-  w: number;
-  h: number;
-  lines: string[];
-  precision: number;
-  remainingText: string;
-  moreTextLines: boolean;
-  width: number;
-  innerWidth: number;
-  height: number;
-  fontSize: number;
-  cutSx: number;
-  cutSy: number;
-  cutEx: number;
-  cutEy: number;
-  lineHeight: number;
-  defLineHeight: number;
-  lineWidths: number[];
-  offsetY: number;
-  paddingLeft: number;
-  paddingRight: number;
-  letterSpacing: number;
-  textIndent: number;
-  metrics: NormalizedFontMetrics;
-}
-
-/**
- * Calculate height for the canvas
- *
- * @param textBaseline
- * @param fontSize
- * @param lineHeight
- * @param numLines
- * @param offsetY
- * @returns
- */
-function calcHeight(
-  textBaseline: TextBaseline,
-  fontSize: number,
-  lineHeight: number,
-  numLines: number,
-  offsetY: number | null,
-) {
-  const baselineOffset = textBaseline !== 'bottom' ? 0.5 * fontSize : 0;
-  return (
-    lineHeight * (numLines - 1) +
-    baselineOffset +
-    Math.max(lineHeight, fontSize) +
-    (offsetY || 0)
-  );
-}
-
-export class LightningTextTextureRenderer {
-  private _canvas: OffscreenCanvas | HTMLCanvasElement;
-  private _context:
-    | OffscreenCanvasRenderingContext2D
-    | CanvasRenderingContext2D;
-  private _settings: Settings;
-
-  constructor(
-    canvas: OffscreenCanvas | HTMLCanvasElement,
-    context: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D,
-  ) {
-    this._canvas = canvas;
-    this._context = context;
-    this._settings = this.mergeDefaults({});
-  }
-
-  set settings(v: Partial<Settings>) {
-    this._settings = this.mergeDefaults(v);
-  }
-
-  get settings(): Settings {
-    return this._settings;
-  }
-
-  getPrecision() {
-    return this._settings.precision;
-  }
-
-  setFontProperties() {
-    this._context.font = this._getFontSetting();
-    this._context.textBaseline = this._settings.textBaseline;
-  }
-
-  _getFontSetting() {
-    const ff = [this._settings.fontFamily];
-
-    const ffs = [];
-    for (let i = 0, n = ff.length; i < n; i++) {
-      if (ff[i] === 'serif' || ff[i] === 'sans-serif') {
-        ffs.push(ff[i]);
-      } else {
-        ffs.push(`"${ff[i]!}"`);
-      }
-    }
-
-    return `${this._settings.fontStyle} ${
-      this._settings.fontSize * this.getPrecision()
-    }px ${ffs.join(',')}`;
-  }
-
-  _load() {
-    if (true && document.fonts) {
-      const fontSetting = this._getFontSetting();
-      try {
-        if (!document.fonts.check(fontSetting, this._settings.text)) {
-          // Use a promise that waits for loading.
-          return document.fonts
-            .load(fontSetting, this._settings.text)
-            .catch((err) => {
-              // Just load the fallback font.
-              console.warn('[Lightning] Font load error', err, fontSetting);
-            })
-            .then(() => {
-              if (!document.fonts.check(fontSetting, this._settings.text)) {
-                console.warn('[Lightning] Font not found', fontSetting);
-              }
-            });
-        }
-      } catch (e) {
-        console.warn("[Lightning] Can't check font loading for " + fontSetting);
-      }
-    }
-  }
-
-  calculateRenderInfo(): RenderInfo {
-    const renderInfo: Partial<RenderInfo> = {};
-
-    const precision = this.getPrecision();
-
-    const paddingLeft = this._settings.paddingLeft * precision;
-    const paddingRight = this._settings.paddingRight * precision;
-    const fontSize = this._settings.fontSize * precision;
-    let offsetY =
-      this._settings.offsetY === null
-        ? null
-        : this._settings.offsetY * precision;
-    const w = this._settings.w * precision;
-    const h = this._settings.h * precision;
-    let wordWrapWidth = this._settings.wordWrapWidth * precision;
-    const cutSx = this._settings.cutSx * precision;
-    const cutEx = this._settings.cutEx * precision;
-    const cutSy = this._settings.cutSy * precision;
-    const cutEy = this._settings.cutEy * precision;
-    const letterSpacing = (this._settings.letterSpacing || 0) * precision;
-    const textIndent = this._settings.textIndent * precision;
-    const trFontFace = this._settings.trFontFace;
-
-    // Set font properties.
-    this.setFontProperties();
-
-    assertTruthy(trFontFace);
-    const metrics = getWebFontMetrics(this._context, trFontFace, fontSize);
-    const defLineHeight = calcDefaultLineHeight(metrics, fontSize) * precision;
-    const lineHeight =
-      this._settings.lineHeight !== null
-        ? this._settings.lineHeight * precision
-        : defLineHeight;
-
-    const maxHeight = this._settings.maxHeight;
-    const containedMaxLines =
-      maxHeight !== null && lineHeight > 0
-        ? Math.floor(maxHeight / lineHeight)
-        : 0;
-
-    const setMaxLines = this._settings.maxLines;
-    const calcMaxLines =
-      containedMaxLines > 0 && setMaxLines > 0
-        ? Math.min(containedMaxLines, setMaxLines)
-        : Math.max(containedMaxLines, setMaxLines);
-
-    // Total width.
-    let width = w || 2048 / this.getPrecision();
-
-    // Inner width.
-    let innerWidth = width - paddingLeft;
-    if (innerWidth < 10) {
-      width += 10 - innerWidth;
-      innerWidth = 10;
-    }
-
-    if (!wordWrapWidth) {
-      wordWrapWidth = innerWidth;
-    }
-
-    // Text overflow
-    if (this._settings.textOverflow && !this._settings.wordWrap) {
-      let suffix;
-      switch (this._settings.textOverflow) {
-        case 'clip':
-          suffix = '';
-          break;
-        case 'ellipsis':
-          suffix = this._settings.overflowSuffix;
-          break;
-        default:
-          suffix = this._settings.textOverflow;
-      }
-      this._settings.text = this.wrapWord(
-        this._settings.text,
-        wordWrapWidth - textIndent,
-        suffix,
-      );
-    }
-
-    // word wrap
-    // preserve original text
-    let linesInfo: { n: number[]; l: string[] };
-    if (this._settings.wordWrap) {
-      linesInfo = this.wrapText(
-        this._settings.text,
-        wordWrapWidth,
-        letterSpacing,
-        textIndent,
-      );
-    } else {
-      linesInfo = { l: this._settings.text.split(/(?:\r\n|\r|\n)/), n: [] };
-      const n = linesInfo.l.length;
-      for (let i = 0; i < n - 1; i++) {
-        linesInfo.n.push(i);
-      }
-    }
-    let lines = linesInfo.l;
-
-    if (calcMaxLines && lines.length > calcMaxLines) {
-      const usedLines = lines.slice(0, calcMaxLines);
-
-      let otherLines = null;
-      if (this._settings.overflowSuffix) {
-        // Wrap again with max lines suffix enabled.
-        const w = this._settings.overflowSuffix
-          ? this.measureText(this._settings.overflowSuffix)
-          : 0;
-        const al = this.wrapText(
-          usedLines[usedLines.length - 1]!,
-          wordWrapWidth - w,
-          letterSpacing,
-          textIndent,
-        );
-        usedLines[usedLines.length - 1] = `${al.l[0]!}${
-          this._settings.overflowSuffix
-        }`;
-        otherLines = [al.l.length > 1 ? al.l[1] : ''];
-      } else {
-        otherLines = [''];
-      }
-
-      // Re-assemble the remaining text.
-      let i;
-      const n = lines.length;
-      let j = 0;
-      const m = linesInfo.n.length;
-      for (i = calcMaxLines; i < n; i++) {
-        otherLines[j] += `${otherLines[j] ? ' ' : ''}${lines[i]!}`;
-        if (i + 1 < m && linesInfo.n[i + 1]) {
-          j++;
-        }
-      }
-
-      renderInfo.remainingText = otherLines.join('\n');
-
-      renderInfo.moreTextLines = true;
-
-      lines = usedLines;
-    } else {
-      renderInfo.moreTextLines = false;
-      renderInfo.remainingText = '';
-    }
-
-    // calculate text width
-    let maxLineWidth = 0;
-    const lineWidths: number[] = [];
-    for (let i = 0; i < lines.length; i++) {
-      const lineWidth =
-        this.measureText(lines[i]!, letterSpacing) + (i === 0 ? textIndent : 0);
-      lineWidths.push(lineWidth);
-      maxLineWidth = Math.max(maxLineWidth, lineWidth);
-    }
-
-    renderInfo.lineWidths = lineWidths;
-
-    if (!w) {
-      // Auto-set width to max text length.
-      width = maxLineWidth + paddingLeft + paddingRight;
-      innerWidth = maxLineWidth;
-    }
-
-    let height;
-    if (h) {
-      height = h;
-    } else {
-      height = calcHeight(
-        this._settings.textBaseline,
-        fontSize,
-        lineHeight,
-        lines.length,
-        offsetY,
-      );
-    }
-
-    if (offsetY === null) {
-      offsetY = fontSize;
-    }
-
-    renderInfo.w = width;
-    renderInfo.h = height;
-    renderInfo.lines = lines;
-    renderInfo.precision = precision;
-
-    if (!width) {
-      // To prevent canvas errors.
-      width = 1;
-    }
-
-    if (!height) {
-      // To prevent canvas errors.
-      height = 1;
-    }
-
-    if (cutSx || cutEx) {
-      width = Math.min(width, cutEx - cutSx);
-    }
-
-    if (cutSy || cutEy) {
-      height = Math.min(height, cutEy - cutSy);
-    }
-
-    renderInfo.width = width;
-    renderInfo.innerWidth = innerWidth;
-    renderInfo.height = height;
-    renderInfo.fontSize = fontSize;
-    renderInfo.cutSx = cutSx;
-    renderInfo.cutSy = cutSy;
-    renderInfo.cutEx = cutEx;
-    renderInfo.cutEy = cutEy;
-    renderInfo.lineHeight = lineHeight;
-    renderInfo.defLineHeight = defLineHeight;
-    renderInfo.lineWidths = lineWidths;
-    renderInfo.offsetY = offsetY;
-    renderInfo.paddingLeft = paddingLeft;
-    renderInfo.paddingRight = paddingRight;
-    renderInfo.letterSpacing = letterSpacing;
-    renderInfo.textIndent = textIndent;
-    renderInfo.metrics = metrics;
-
-    return renderInfo as RenderInfo;
-  }
-
-  draw(
-    renderInfo: RenderInfo,
-    linesOverride?: { lines: string[]; lineWidths: number[] },
-  ) {
-    const precision = this.getPrecision();
-
-    // Allow lines to be overriden for partial rendering.
-    const lines = linesOverride?.lines || renderInfo.lines;
-    const lineWidths = linesOverride?.lineWidths || renderInfo.lineWidths;
-    const height = linesOverride
-      ? calcHeight(
-          this._settings.textBaseline,
-          renderInfo.fontSize,
-          renderInfo.lineHeight,
-          linesOverride.lines.length,
-          this._settings.offsetY === null
-            ? null
-            : this._settings.offsetY * precision,
-        )
-      : renderInfo.height;
-
-    // Add extra margin to prevent issue with clipped text when scaling.
-    this._canvas.width = Math.min(
-      Math.ceil(renderInfo.width + this._settings.textRenderIssueMargin),
-      MAX_TEXTURE_DIMENSION,
-    );
-    this._canvas.height = Math.min(Math.ceil(height), MAX_TEXTURE_DIMENSION);
-
-    // Canvas context has been reset.
-    this.setFontProperties();
-
-    if (renderInfo.fontSize >= 128) {
-      // WpeWebKit bug: must force compositing because cairo-traps-compositor will not work with text first.
-      this._context.globalAlpha = 0.01;
-      this._context.fillRect(0, 0, 0.01, 0.01);
-      this._context.globalAlpha = 1.0;
-    }
-
-    if (renderInfo.cutSx || renderInfo.cutSy) {
-      this._context.translate(-renderInfo.cutSx, -renderInfo.cutSy);
-    }
-
-    let linePositionX;
-    let linePositionY;
-
-    const drawLines = [];
-
-    const { metrics } = renderInfo;
-
-    /**
-     * Ascender (in pixels)
-     */
-    const ascenderPx = metrics
-      ? metrics.ascender * renderInfo.fontSize
-      : renderInfo.fontSize;
-
-    /**
-     * Bare line height is the distance between the ascender and descender of the font.
-     * without the line gap metric.
-     */
-    const bareLineHeightPx =
-      (metrics.ascender - metrics.descender) * renderInfo.fontSize;
-
-    // Draw lines line by line.
-    for (let i = 0, n = lines.length; i < n; i++) {
-      linePositionX = i === 0 ? renderInfo.textIndent : 0;
-
-      // By default, text is aligned to top
-      linePositionY = i * renderInfo.lineHeight + ascenderPx;
-
-      if (this._settings.verticalAlign == 'middle') {
-        linePositionY += (renderInfo.lineHeight - bareLineHeightPx) / 2;
-      } else if (this._settings.verticalAlign == 'bottom') {
-        linePositionY += renderInfo.lineHeight - bareLineHeightPx;
-      }
-
-      if (this._settings.textAlign === 'right') {
-        linePositionX += renderInfo.innerWidth - lineWidths[i]!;
-      } else if (this._settings.textAlign === 'center') {
-        linePositionX += (renderInfo.innerWidth - lineWidths[i]!) / 2;
-      }
-      linePositionX += renderInfo.paddingLeft;
-
-      drawLines.push({
-        text: lines[i]!,
-        x: linePositionX,
-        y: linePositionY,
-        w: lineWidths[i]!,
-      });
-    }
-
-    // Highlight.
-    if (this._settings.highlight) {
-      const color = this._settings.highlightColor;
-
-      const hlHeight =
-        this._settings.highlightHeight * precision || renderInfo.fontSize * 1.5;
-      const offset = this._settings.highlightOffset * precision;
-      const hlPaddingLeft =
-        this._settings.highlightPaddingLeft !== null
-          ? this._settings.highlightPaddingLeft * precision
-          : renderInfo.paddingLeft;
-      const hlPaddingRight =
-        this._settings.highlightPaddingRight !== null
-          ? this._settings.highlightPaddingRight * precision
-          : renderInfo.paddingRight;
-
-      this._context.fillStyle = getRgbaString(color);
-      for (let i = 0; i < drawLines.length; i++) {
-        const drawLine = drawLines[i]!;
-        this._context.fillRect(
-          drawLine.x - hlPaddingLeft,
-          drawLine.y - renderInfo.offsetY + offset,
-          drawLine.w + hlPaddingRight + hlPaddingLeft,
-          hlHeight,
-        );
-      }
-    }
-
-    // Text shadow.
-    let prevShadowSettings: null | [string, number, number, number] = null;
-    if (this._settings.shadow) {
-      prevShadowSettings = [
-        this._context.shadowColor,
-        this._context.shadowOffsetX,
-        this._context.shadowOffsetY,
-        this._context.shadowBlur,
-      ];
-
-      this._context.shadowColor = getRgbaString(this._settings.shadowColor);
-      this._context.shadowOffsetX = this._settings.shadowOffsetX * precision;
-      this._context.shadowOffsetY = this._settings.shadowOffsetY * precision;
-      this._context.shadowBlur = this._settings.shadowBlur * precision;
-    }
-
-    this._context.fillStyle = getRgbaString(this._settings.textColor);
-    for (let i = 0, n = drawLines.length; i < n; i++) {
-      const drawLine = drawLines[i]!;
-
-      if (renderInfo.letterSpacing === 0) {
-        this._context.fillText(drawLine.text, drawLine.x, drawLine.y);
-      } else {
-        const textSplit = drawLine.text.split('');
-        let x = drawLine.x;
-        for (let i = 0, j = textSplit.length; i < j; i++) {
-          this._context.fillText(textSplit[i]!, x, drawLine.y);
-          x += this.measureText(textSplit[i]!, renderInfo.letterSpacing);
-        }
-      }
-    }
-
-    if (prevShadowSettings) {
-      this._context.shadowColor = prevShadowSettings[0];
-      this._context.shadowOffsetX = prevShadowSettings[1];
-      this._context.shadowOffsetY = prevShadowSettings[2];
-      this._context.shadowBlur = prevShadowSettings[3];
-    }
-
-    if (renderInfo.cutSx || renderInfo.cutSy) {
-      this._context.translate(renderInfo.cutSx, renderInfo.cutSy);
-    }
-  }
-
-  wrapWord(word: string, wordWrapWidth: number, suffix: string) {
-    const suffixWidth = this._context.measureText(suffix).width;
-    const wordLen = word.length;
-    const wordWidth = this._context.measureText(word).width;
-
-    /* If word fits wrapWidth, do nothing */
-    if (wordWidth <= wordWrapWidth) {
-      return word;
-    }
-
-    /* Make initial guess for text cuttoff */
-    let cutoffIndex = Math.floor((wordWrapWidth * wordLen) / wordWidth);
-    let truncWordWidth =
-      this._context.measureText(word.substring(0, cutoffIndex)).width +
-      suffixWidth;
-
-    /* In case guess was overestimated, shrink it letter by letter. */
-    if (truncWordWidth > wordWrapWidth) {
-      while (cutoffIndex > 0) {
-        truncWordWidth =
-          this._context.measureText(word.substring(0, cutoffIndex)).width +
-          suffixWidth;
-        if (truncWordWidth > wordWrapWidth) {
-          cutoffIndex -= 1;
-        } else {
-          break;
-        }
-      }
-
-      /* In case guess was underestimated, extend it letter by letter. */
-    } else {
-      while (cutoffIndex < wordLen) {
-        truncWordWidth =
-          this._context.measureText(word.substring(0, cutoffIndex)).width +
-          suffixWidth;
-        if (truncWordWidth < wordWrapWidth) {
-          cutoffIndex += 1;
-        } else {
-          // Finally, when bound is crossed, retract last letter.
-          cutoffIndex -= 1;
-          break;
-        }
-      }
-    }
-
-    /* If wrapWidth is too short to even contain suffix alone, return empty string */
-    return (
-      word.substring(0, cutoffIndex) +
-      (wordWrapWidth >= suffixWidth ? suffix : '')
-    );
-  }
-
-  /**
-   * Applies newlines to a string to have it optimally fit into the horizontal
-   * bounds set by the Text object's wordWrapWidth property.
-   */
-  wrapText(
-    text: string,
-    wordWrapWidth: number,
-    letterSpacing: number,
-    indent = 0,
-  ) {
-    const spaceRegex = / |\u200B/g; // ZWSP and spaces
-    const lines = text.split(/\r?\n/g);
-    let allLines: string[] = [];
-    const realNewlines: number[] = [];
-
-    for (let i = 0; i < lines.length; i++) {
-      const resultLines: string[] = [];
-      let result = '';
-      let spaceLeft = wordWrapWidth - indent;
-
-      // Split the line into words, considering ZWSP
-      const words = lines[i]!.split(spaceRegex);
-      const spaces = lines[i]!.match(spaceRegex) || [];
-
-      for (let j = 0; j < words.length; j++) {
-        const space = spaces[j - 1] || '';
-        const word = words[j]!;
-        const wordWidth = this.measureText(word, letterSpacing);
-        const wordWidthWithSpace = isZeroWidthSpace(space)
-          ? wordWidth
-          : wordWidth + this.measureText(space, letterSpacing);
-
-        if (j === 0 || wordWidthWithSpace > spaceLeft) {
-          if (j > 0) {
-            resultLines.push(result);
-            result = '';
-          }
-          result += word;
-          spaceLeft = wordWrapWidth - wordWidth - (j === 0 ? indent : 0);
-        } else {
-          spaceLeft -= wordWidthWithSpace;
-          result += space + word;
-        }
-      }
-
-      resultLines.push(result);
-      result = '';
-      allLines = allLines.concat(resultLines);
-
-      if (i < lines.length - 1) {
-        realNewlines.push(allLines.length);
-      }
-    }
-
-    return { l: allLines, n: realNewlines };
-  }
-
-  measureText(word: string, space = 0) {
-    if (!space) {
-      return this._context.measureText(word).width;
-    }
-
-    // Split word into characters, but skip ZWSP in the width calculation
-    return word.split('').reduce((acc, char) => {
-      // Check if the character is a zero-width space and skip it
-      if (isZeroWidthSpace(char)) {
-        return acc;
-      }
-      return acc + this._context.measureText(char).width + space;
-    }, 0);
-  }
-
-  mergeDefaults(settings: Partial<Settings>): Settings {
-    return {
-      text: '',
-      w: 0,
-      h: 0,
-      fontStyle: 'normal',
-      fontSize: 40,
-      fontFamily: null,
-      trFontFace: null,
-      wordWrap: true,
-      wordWrapWidth: 0,
-      wordBreak: false,
-      textOverflow: '',
-      lineHeight: null,
-      textBaseline: 'alphabetic',
-      textAlign: 'left',
-      verticalAlign: 'top',
-      offsetY: null,
-      maxLines: 0,
-      maxHeight: null,
-      overflowSuffix: '...',
-      textColor: [1.0, 1.0, 1.0, 1.0],
-      paddingLeft: 0,
-      paddingRight: 0,
-      shadow: false,
-      shadowColor: [0.0, 0.0, 0.0, 1.0],
-      shadowOffsetX: 0,
-      shadowOffsetY: 0,
-      shadowBlur: 5,
-      highlight: false,
-      highlightHeight: 0,
-      highlightColor: [0.0, 0.0, 0.0, 1.0],
-      highlightOffset: 0,
-      highlightPaddingLeft: 0,
-      highlightPaddingRight: 0,
-      letterSpacing: 0,
-      textIndent: 0,
-      cutSx: 0,
-      cutEx: 0,
-      cutSy: 0,
-      cutEy: 0,
-      advancedRenderer: false,
-      fontBaselineRatio: 0,
-      precision: 1,
-      textRenderIssueMargin: 0,
-      ...settings,
-    };
-  }
-}
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/* eslint-disable @typescript-eslint/no-non-null-assertion */
+
+import { assertTruthy } from '../../../utils.js';
+import { getRgbaString, type RGBA } from '../../lib/utils.js';
+import { calcDefaultLineHeight } from '../TextRenderingUtils.js';
+import {
+  getWebFontMetrics,
+  isZeroWidthSpace,
+} from '../TextTextureRendererUtils.js';
+import type { NormalizedFontMetrics } from '../font-face-types/TrFontFace.js';
+import type { WebTrFontFace } from '../font-face-types/WebTrFontFace.js';
+
+const MAX_TEXTURE_DIMENSION = 2048;
+
+/**
+ * Text Overflow Values
+ */
+export type TextOverflow =
+  | 'ellipsis'
+  | 'clip'
+  | (string & Record<never, never>);
+
+/***
+ * Text Horizontal Align Values
+ */
+export type TextAlign = 'left' | 'center' | 'right';
+
+/***
+ * Text Baseline Values
+ */
+export type TextBaseline =
+  | 'alphabetic'
+  | 'top'
+  | 'hanging'
+  | 'middle'
+  | 'ideographic'
+  | 'bottom';
+
+/***
+ * Text Vertical Align Values
+ */
+export type TextVerticalAlign = 'top' | 'middle' | 'bottom';
+
+/**
+ * Text Texture Settings
+ */
+export interface Settings {
+  w: number;
+  h: number;
+  text: string;
+  fontStyle: string;
+  fontSize: number;
+  fontBaselineRatio: number;
+  fontFamily: string | null;
+  trFontFace: WebTrFontFace | null;
+  wordWrap: boolean;
+  wordWrapWidth: number;
+  wordBreak: boolean;
+  textOverflow: TextOverflow | null;
+  lineHeight: number | null;
+  textBaseline: TextBaseline;
+  textAlign: TextAlign;
+  verticalAlign: TextVerticalAlign;
+  offsetY: number | null;
+  maxLines: number;
+  maxHeight: number | null;
+  overflowSuffix: string;
+  precision: number;
+  textColor: RGBA;
+  paddingLeft: number;
+  paddingRight: number;
+  shadow: boolean;
+  shadowColor: RGBA;
+  shadowOffsetX: number;
+  shadowOffsetY: number;
+  shadowBlur: number;
+  highlight: boolean;
+  highlightHeight: number;
+  highlightColor: RGBA;
+  highlightOffset: number;
+  highlightPaddingLeft: number;
+  highlightPaddingRight: number;
+  letterSpacing: number;
+  textIndent: number;
+  cutSx: number;
+  cutSy: number;
+  cutEx: number;
+  cutEy: number;
+  advancedRenderer: boolean;
+
+  // Normally stage options
+  textRenderIssueMargin: number;
+}
+
+export interface RenderInfo {
+  w: number;
+  h: number;
+  lines: string[];
+  precision: number;
+  remainingText: string;
+  moreTextLines: boolean;
+  width: number;
+  innerWidth: number;
+  height: number;
+  fontSize: number;
+  cutSx: number;
+  cutSy: number;
+  cutEx: number;
+  cutEy: number;
+  lineHeight: number;
+  defLineHeight: number;
+  lineWidths: number[];
+  offsetY: number;
+  paddingLeft: number;
+  paddingRight: number;
+  letterSpacing: number;
+  textIndent: number;
+  metrics: NormalizedFontMetrics;
+}
+
+/**
+ * Calculate height for the canvas
+ *
+ * @param textBaseline
+ * @param fontSize
+ * @param lineHeight
+ * @param numLines
+ * @param offsetY
+ * @returns
+ */
+function calcHeight(
+  textBaseline: TextBaseline,
+  fontSize: number,
+  lineHeight: number,
+  numLines: number,
+  offsetY: number | null,
+) {
+  const baselineOffset = textBaseline !== 'bottom' ? 0.5 * fontSize : 0;
+  return (
+    lineHeight * (numLines - 1) +
+    baselineOffset +
+    Math.max(lineHeight, fontSize) +
+    (offsetY || 0)
+  );
+}
+
+export class LightningTextTextureRenderer {
+  private _canvas: OffscreenCanvas | HTMLCanvasElement;
+  private _context:
+    | OffscreenCanvasRenderingContext2D
+    | CanvasRenderingContext2D;
+  private _settings: Settings;
+
+  constructor(
+    canvas: OffscreenCanvas | HTMLCanvasElement,
+    context: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D,
+  ) {
+    this._canvas = canvas;
+    this._context = context;
+    this._settings = this.mergeDefaults({});
+  }
+
+  set settings(v: Partial<Settings>) {
+    this._settings = this.mergeDefaults(v);
+  }
+
+  get settings(): Settings {
+    return this._settings;
+  }
+
+  getPrecision() {
+    return this._settings.precision;
+  }
+
+  setFontProperties() {
+    this._context.font = this._getFontSetting();
+    this._context.textBaseline = this._settings.textBaseline;
+  }
+
+  _getFontSetting() {
+    const ff = [this._settings.fontFamily];
+
+    const ffs = [];
+    for (let i = 0, n = ff.length; i < n; i++) {
+      if (ff[i] === 'serif' || ff[i] === 'sans-serif') {
+        ffs.push(ff[i]);
+      } else {
+        ffs.push(`"${ff[i]!}"`);
+      }
+    }
+
+    return `${this._settings.fontStyle} ${
+      this._settings.fontSize * this.getPrecision()
+    }px ${ffs.join(',')}`;
+  }
+
+  _load() {
+    if (true && document.fonts) {
+      const fontSetting = this._getFontSetting();
+      try {
+        if (!document.fonts.check(fontSetting, this._settings.text)) {
+          // Use a promise that waits for loading.
+          return document.fonts
+            .load(fontSetting, this._settings.text)
+            .catch((err) => {
+              // Just load the fallback font.
+              console.warn('[Lightning] Font load error', err, fontSetting);
+            })
+            .then(() => {
+              if (!document.fonts.check(fontSetting, this._settings.text)) {
+                console.warn('[Lightning] Font not found', fontSetting);
+              }
+            });
+        }
+      } catch (e) {
+        console.warn("[Lightning] Can't check font loading for " + fontSetting);
+      }
+    }
+  }
+
+  calculateRenderInfo(): RenderInfo {
+    const renderInfo: Partial<RenderInfo> = {};
+
+    const precision = this.getPrecision();
+
+    const paddingLeft = this._settings.paddingLeft * precision;
+    const paddingRight = this._settings.paddingRight * precision;
+    const fontSize = this._settings.fontSize * precision;
+    let offsetY =
+      this._settings.offsetY === null
+        ? null
+        : this._settings.offsetY * precision;
+    const w = this._settings.w * precision;
+    const h = this._settings.h * precision;
+    let wordWrapWidth = this._settings.wordWrapWidth * precision;
+    const cutSx = this._settings.cutSx * precision;
+    const cutEx = this._settings.cutEx * precision;
+    const cutSy = this._settings.cutSy * precision;
+    const cutEy = this._settings.cutEy * precision;
+    const letterSpacing = (this._settings.letterSpacing || 0) * precision;
+    const textIndent = this._settings.textIndent * precision;
+    const trFontFace = this._settings.trFontFace;
+
+    // Set font properties.
+    this.setFontProperties();
+
+    assertTruthy(trFontFace);
+    const metrics = getWebFontMetrics(this._context, trFontFace, fontSize);
+    const defLineHeight = calcDefaultLineHeight(metrics, fontSize) * precision;
+    const lineHeight =
+      this._settings.lineHeight !== null
+        ? this._settings.lineHeight * precision
+        : defLineHeight;
+
+    const maxHeight = this._settings.maxHeight;
+    const containedMaxLines =
+      maxHeight !== null && lineHeight > 0
+        ? Math.floor(maxHeight / lineHeight)
+        : 0;
+
+    const setMaxLines = this._settings.maxLines;
+    const calcMaxLines =
+      containedMaxLines > 0 && setMaxLines > 0
+        ? Math.min(containedMaxLines, setMaxLines)
+        : Math.max(containedMaxLines, setMaxLines);
+
+    // Total width.
+    let width = w || 2048 / this.getPrecision();
+
+    // Inner width.
+    let innerWidth = width - paddingLeft;
+    if (innerWidth < 10) {
+      width += 10 - innerWidth;
+      innerWidth = 10;
+    }
+
+    if (!wordWrapWidth) {
+      wordWrapWidth = innerWidth;
+    }
+
+    // Text overflow
+    if (this._settings.textOverflow && !this._settings.wordWrap) {
+      let suffix;
+      switch (this._settings.textOverflow) {
+        case 'clip':
+          suffix = '';
+          break;
+        case 'ellipsis':
+          suffix = this._settings.overflowSuffix;
+          break;
+        default:
+          suffix = this._settings.textOverflow;
+      }
+      this._settings.text = this.wrapWord(
+        this._settings.text,
+        wordWrapWidth - textIndent,
+        suffix,
+      );
+    }
+
+    // word wrap
+    // preserve original text
+    let linesInfo: { n: number[]; l: string[] };
+    if (this._settings.wordWrap) {
+      linesInfo = this.wrapText(
+        this._settings.text,
+        wordWrapWidth,
+        letterSpacing,
+        textIndent,
+      );
+    } else {
+      linesInfo = { l: this._settings.text.split(/(?:\r\n|\r|\n)/), n: [] };
+      const n = linesInfo.l.length;
+      for (let i = 0; i < n - 1; i++) {
+        linesInfo.n.push(i);
+      }
+    }
+    let lines = linesInfo.l;
+
+    if (calcMaxLines && lines.length > calcMaxLines) {
+      const usedLines = lines.slice(0, calcMaxLines);
+
+      let otherLines = null;
+      if (this._settings.overflowSuffix) {
+        // Wrap again with max lines suffix enabled.
+        const w = this._settings.overflowSuffix
+          ? this.measureText(this._settings.overflowSuffix)
+          : 0;
+        const al = this.wrapText(
+          usedLines[usedLines.length - 1]!,
+          wordWrapWidth - w,
+          letterSpacing,
+          textIndent,
+        );
+        usedLines[usedLines.length - 1] = `${al.l[0]!}${
+          this._settings.overflowSuffix
+        }`;
+        otherLines = [al.l.length > 1 ? al.l[1] : ''];
+      } else {
+        otherLines = [''];
+      }
+
+      // Re-assemble the remaining text.
+      let i;
+      const n = lines.length;
+      let j = 0;
+      const m = linesInfo.n.length;
+      for (i = calcMaxLines; i < n; i++) {
+        otherLines[j] += `${otherLines[j] ? ' ' : ''}${lines[i]!}`;
+        if (i + 1 < m && linesInfo.n[i + 1]) {
+          j++;
+        }
+      }
+
+      renderInfo.remainingText = otherLines.join('\n');
+
+      renderInfo.moreTextLines = true;
+
+      lines = usedLines;
+    } else {
+      renderInfo.moreTextLines = false;
+      renderInfo.remainingText = '';
+    }
+
+    // calculate text width
+    let maxLineWidth = 0;
+    const lineWidths: number[] = [];
+    for (let i = 0; i < lines.length; i++) {
+      const lineWidth =
+        this.measureText(lines[i]!, letterSpacing) + (i === 0 ? textIndent : 0);
+      lineWidths.push(lineWidth);
+      maxLineWidth = Math.max(maxLineWidth, lineWidth);
+    }
+
+    renderInfo.lineWidths = lineWidths;
+
+    if (!w) {
+      // Auto-set width to max text length.
+      width = maxLineWidth + paddingLeft + paddingRight;
+      innerWidth = maxLineWidth;
+    }
+
+    let height;
+    if (h) {
+      height = h;
+    } else {
+      height = calcHeight(
+        this._settings.textBaseline,
+        fontSize,
+        lineHeight,
+        lines.length,
+        offsetY,
+      );
+    }
+
+    if (offsetY === null) {
+      offsetY = fontSize;
+    }
+
+    renderInfo.w = width;
+    renderInfo.h = height;
+    renderInfo.lines = lines;
+    renderInfo.precision = precision;
+
+    if (!width) {
+      // To prevent canvas errors.
+      width = 1;
+    }
+
+    if (!height) {
+      // To prevent canvas errors.
+      height = 1;
+    }
+
+    if (cutSx || cutEx) {
+      width = Math.min(width, cutEx - cutSx);
+    }
+
+    if (cutSy || cutEy) {
+      height = Math.min(height, cutEy - cutSy);
+    }
+
+    renderInfo.width = width;
+    renderInfo.innerWidth = innerWidth;
+    renderInfo.height = height;
+    renderInfo.fontSize = fontSize;
+    renderInfo.cutSx = cutSx;
+    renderInfo.cutSy = cutSy;
+    renderInfo.cutEx = cutEx;
+    renderInfo.cutEy = cutEy;
+    renderInfo.lineHeight = lineHeight;
+    renderInfo.defLineHeight = defLineHeight;
+    renderInfo.lineWidths = lineWidths;
+    renderInfo.offsetY = offsetY;
+    renderInfo.paddingLeft = paddingLeft;
+    renderInfo.paddingRight = paddingRight;
+    renderInfo.letterSpacing = letterSpacing;
+    renderInfo.textIndent = textIndent;
+    renderInfo.metrics = metrics;
+
+    return renderInfo as RenderInfo;
+  }
+
+  draw(
+    renderInfo: RenderInfo,
+    linesOverride?: { lines: string[]; lineWidths: number[] },
+  ) {
+    const precision = this.getPrecision();
+
+    // Allow lines to be overriden for partial rendering.
+    const lines = linesOverride?.lines || renderInfo.lines;
+    const lineWidths = linesOverride?.lineWidths || renderInfo.lineWidths;
+    const height = linesOverride
+      ? calcHeight(
+          this._settings.textBaseline,
+          renderInfo.fontSize,
+          renderInfo.lineHeight,
+          linesOverride.lines.length,
+          this._settings.offsetY === null
+            ? null
+            : this._settings.offsetY * precision,
+        )
+      : renderInfo.height;
+
+    // Add extra margin to prevent issue with clipped text when scaling.
+    this._canvas.width = Math.min(
+      Math.ceil(renderInfo.width + this._settings.textRenderIssueMargin),
+      MAX_TEXTURE_DIMENSION,
+    );
+    this._canvas.height = Math.min(Math.ceil(height), MAX_TEXTURE_DIMENSION);
+
+    // Canvas context has been reset.
+    this.setFontProperties();
+
+    if (renderInfo.fontSize >= 128) {
+      // WpeWebKit bug: must force compositing because cairo-traps-compositor will not work with text first.
+      this._context.globalAlpha = 0.01;
+      this._context.fillRect(0, 0, 0.01, 0.01);
+      this._context.globalAlpha = 1.0;
+    }
+
+    if (renderInfo.cutSx || renderInfo.cutSy) {
+      this._context.translate(-renderInfo.cutSx, -renderInfo.cutSy);
+    }
+
+    let linePositionX;
+    let linePositionY;
+
+    const drawLines = [];
+
+    const { metrics } = renderInfo;
+
+    /**
+     * Ascender (in pixels)
+     */
+    const ascenderPx = metrics
+      ? metrics.ascender * renderInfo.fontSize
+      : renderInfo.fontSize;
+
+    /**
+     * Bare line height is the distance between the ascender and descender of the font.
+     * without the line gap metric.
+     */
+    const bareLineHeightPx =
+      (metrics.ascender - metrics.descender) * renderInfo.fontSize;
+
+    // Draw lines line by line.
+    for (let i = 0, n = lines.length; i < n; i++) {
+      linePositionX = i === 0 ? renderInfo.textIndent : 0;
+
+      // By default, text is aligned to top
+      linePositionY = i * renderInfo.lineHeight + ascenderPx;
+
+      if (this._settings.verticalAlign == 'middle') {
+        linePositionY += (renderInfo.lineHeight - bareLineHeightPx) / 2;
+      } else if (this._settings.verticalAlign == 'bottom') {
+        linePositionY += renderInfo.lineHeight - bareLineHeightPx;
+      }
+
+      if (this._settings.textAlign === 'right') {
+        linePositionX += renderInfo.innerWidth - lineWidths[i]!;
+      } else if (this._settings.textAlign === 'center') {
+        linePositionX += (renderInfo.innerWidth - lineWidths[i]!) / 2;
+      }
+      linePositionX += renderInfo.paddingLeft;
+
+      drawLines.push({
+        text: lines[i]!,
+        x: linePositionX,
+        y: linePositionY,
+        w: lineWidths[i]!,
+      });
+    }
+
+    // Highlight.
+    if (this._settings.highlight) {
+      const color = this._settings.highlightColor;
+
+      const hlHeight =
+        this._settings.highlightHeight * precision || renderInfo.fontSize * 1.5;
+      const offset = this._settings.highlightOffset * precision;
+      const hlPaddingLeft =
+        this._settings.highlightPaddingLeft !== null
+          ? this._settings.highlightPaddingLeft * precision
+          : renderInfo.paddingLeft;
+      const hlPaddingRight =
+        this._settings.highlightPaddingRight !== null
+          ? this._settings.highlightPaddingRight * precision
+          : renderInfo.paddingRight;
+
+      this._context.fillStyle = getRgbaString(color);
+      for (let i = 0; i < drawLines.length; i++) {
+        const drawLine = drawLines[i]!;
+        this._context.fillRect(
+          drawLine.x - hlPaddingLeft,
+          drawLine.y - renderInfo.offsetY + offset,
+          drawLine.w + hlPaddingRight + hlPaddingLeft,
+          hlHeight,
+        );
+      }
+    }
+
+    // Text shadow.
+    let prevShadowSettings: null | [string, number, number, number] = null;
+    if (this._settings.shadow) {
+      prevShadowSettings = [
+        this._context.shadowColor,
+        this._context.shadowOffsetX,
+        this._context.shadowOffsetY,
+        this._context.shadowBlur,
+      ];
+
+      this._context.shadowColor = getRgbaString(this._settings.shadowColor);
+      this._context.shadowOffsetX = this._settings.shadowOffsetX * precision;
+      this._context.shadowOffsetY = this._settings.shadowOffsetY * precision;
+      this._context.shadowBlur = this._settings.shadowBlur * precision;
+    }
+
+    this._context.fillStyle = getRgbaString(this._settings.textColor);
+    for (let i = 0, n = drawLines.length; i < n; i++) {
+      const drawLine = drawLines[i]!;
+
+      if (renderInfo.letterSpacing === 0) {
+        this._context.fillText(drawLine.text, drawLine.x, drawLine.y);
+      } else {
+        const textSplit = drawLine.text.split('');
+        let x = drawLine.x;
+        for (let i = 0, j = textSplit.length; i < j; i++) {
+          this._context.fillText(textSplit[i]!, x, drawLine.y);
+          x += this.measureText(textSplit[i]!, renderInfo.letterSpacing);
+        }
+      }
+    }
+
+    if (prevShadowSettings) {
+      this._context.shadowColor = prevShadowSettings[0];
+      this._context.shadowOffsetX = prevShadowSettings[1];
+      this._context.shadowOffsetY = prevShadowSettings[2];
+      this._context.shadowBlur = prevShadowSettings[3];
+    }
+
+    if (renderInfo.cutSx || renderInfo.cutSy) {
+      this._context.translate(renderInfo.cutSx, renderInfo.cutSy);
+    }
+  }
+
+  wrapWord(word: string, wordWrapWidth: number, suffix: string) {
+    const suffixWidth = this._context.measureText(suffix).width;
+    const wordLen = word.length;
+    const wordWidth = this._context.measureText(word).width;
+
+    /* If word fits wrapWidth, do nothing */
+    if (wordWidth <= wordWrapWidth) {
+      return word;
+    }
+
+    /* Make initial guess for text cuttoff */
+    let cutoffIndex = Math.floor((wordWrapWidth * wordLen) / wordWidth);
+    let truncWordWidth =
+      this._context.measureText(word.substring(0, cutoffIndex)).width +
+      suffixWidth;
+
+    /* In case guess was overestimated, shrink it letter by letter. */
+    if (truncWordWidth > wordWrapWidth) {
+      while (cutoffIndex > 0) {
+        truncWordWidth =
+          this._context.measureText(word.substring(0, cutoffIndex)).width +
+          suffixWidth;
+        if (truncWordWidth > wordWrapWidth) {
+          cutoffIndex -= 1;
+        } else {
+          break;
+        }
+      }
+
+      /* In case guess was underestimated, extend it letter by letter. */
+    } else {
+      while (cutoffIndex < wordLen) {
+        truncWordWidth =
+          this._context.measureText(word.substring(0, cutoffIndex)).width +
+          suffixWidth;
+        if (truncWordWidth < wordWrapWidth) {
+          cutoffIndex += 1;
+        } else {
+          // Finally, when bound is crossed, retract last letter.
+          cutoffIndex -= 1;
+          break;
+        }
+      }
+    }
+
+    /* If wrapWidth is too short to even contain suffix alone, return empty string */
+    return (
+      word.substring(0, cutoffIndex) +
+      (wordWrapWidth >= suffixWidth ? suffix : '')
+    );
+  }
+
+  /**
+   * Applies newlines to a string to have it optimally fit into the horizontal
+   * bounds set by the Text object's wordWrapWidth property.
+   */
+  wrapText(
+    text: string,
+    wordWrapWidth: number,
+    letterSpacing: number,
+    indent = 0,
+  ) {
+    const spaceRegex = / |\u200B/g; // ZWSP and spaces
+    const lines = text.split(/\r?\n/g);
+    let allLines: string[] = [];
+    const realNewlines: number[] = [];
+
+    for (let i = 0; i < lines.length; i++) {
+      const resultLines: string[] = [];
+      let result = '';
+      let spaceLeft = wordWrapWidth - indent;
+
+      // Split the line into words, considering ZWSP
+      const words = lines[i]!.split(spaceRegex);
+      const spaces = lines[i]!.match(spaceRegex) || [];
+
+      for (let j = 0; j < words.length; j++) {
+        const space = spaces[j - 1] || '';
+        const word = words[j]!;
+        const wordWidth = this.measureText(word, letterSpacing);
+        const wordWidthWithSpace = isZeroWidthSpace(space)
+          ? wordWidth
+          : wordWidth + this.measureText(space, letterSpacing);
+
+        if (j === 0 || wordWidthWithSpace > spaceLeft) {
+          if (j > 0) {
+            resultLines.push(result);
+            result = '';
+          }
+          result += word;
+          spaceLeft = wordWrapWidth - wordWidth - (j === 0 ? indent : 0);
+        } else {
+          spaceLeft -= wordWidthWithSpace;
+          result += space + word;
+        }
+      }
+
+      resultLines.push(result);
+      result = '';
+      allLines = allLines.concat(resultLines);
+
+      if (i < lines.length - 1) {
+        realNewlines.push(allLines.length);
+      }
+    }
+
+    return { l: allLines, n: realNewlines };
+  }
+
+  measureText(word: string, space = 0) {
+    if (!space) {
+      return this._context.measureText(word).width;
+    }
+
+    // Split word into characters, but skip ZWSP in the width calculation
+    return word.split('').reduce((acc, char) => {
+      // Check if the character is a zero-width space and skip it
+      if (isZeroWidthSpace(char)) {
+        return acc;
+      }
+      return acc + this._context.measureText(char).width + space;
+    }, 0);
+  }
+
+  mergeDefaults(settings: Partial<Settings>): Settings {
+    return {
+      text: '',
+      w: 0,
+      h: 0,
+      fontStyle: 'normal',
+      fontSize: 40,
+      fontFamily: null,
+      trFontFace: null,
+      wordWrap: true,
+      wordWrapWidth: 0,
+      wordBreak: false,
+      textOverflow: '',
+      lineHeight: null,
+      textBaseline: 'alphabetic',
+      textAlign: 'left',
+      verticalAlign: 'top',
+      offsetY: null,
+      maxLines: 0,
+      maxHeight: null,
+      overflowSuffix: '...',
+      textColor: [1.0, 1.0, 1.0, 1.0],
+      paddingLeft: 0,
+      paddingRight: 0,
+      shadow: false,
+      shadowColor: [0.0, 0.0, 0.0, 1.0],
+      shadowOffsetX: 0,
+      shadowOffsetY: 0,
+      shadowBlur: 5,
+      highlight: false,
+      highlightHeight: 0,
+      highlightColor: [0.0, 0.0, 0.0, 1.0],
+      highlightOffset: 0,
+      highlightPaddingLeft: 0,
+      highlightPaddingRight: 0,
+      letterSpacing: 0,
+      textIndent: 0,
+      cutSx: 0,
+      cutEx: 0,
+      cutSy: 0,
+      cutEy: 0,
+      advancedRenderer: false,
+      fontBaselineRatio: 0,
+      precision: 1,
+      textRenderIssueMargin: 0,
+      ...settings,
+    };
+  }
+}