@lightningjs/renderer 3.0.3 → 3.0.5

package/dist/src/core/text-rendering/renderers/canvas/internal/types.d.ts

@@ -0,0 +1,66 @@
+import type { WebTrFontFace } from '../../../font-face-types/WebTrFontFace.js';
+import { type RGBA } from '../../../../lib/utils.js';
+/**
+ * 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;
+    textRenderIssueMargin: number;
+}

package/dist/src/core/text-rendering/renderers/canvas/internal/types.js

@@ -0,0 +1,2 @@
+import {} from '../../../../lib/utils.js';
+//# sourceMappingURL=types.js.map

package/dist/src/core/text-rendering/renderers/canvas/internal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../src/core/text-rendering/renderers/canvas/internal/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,MAAM,0BAA0B,CAAC"}

package/dist/src/core/text-rendering/renderers/canvas/internal/utils.d.ts

@@ -0,0 +1,91 @@
+import type { NormalizedFontMetrics } from '../../../font-face-types/TrFontFace.js';
+import type { WebTrFontFace } from '../../../font-face-types/WebTrFontFace.js';
+import { type TextBaseline } from './types.js';
+/**
+ * Returns CSS font setting string for use in canvas context.
+ *
+ * @param fontFace
+ * @param fontStyle
+ * @param fontSize
+ * @param precision
+ * @param defaultFontFace
+ * @returns
+ */
+export declare function getFontSetting(fontFace: string | string[], fontStyle: string, fontSize: number, precision: number, defaultFontFace: string): string;
+/**
+ * Returns true if the given character is a zero-width space.
+ *
+ * @param space
+ */
+export declare function isZeroWidthSpace(space: string): boolean;
+/**
+ * Returns true if the given character is a zero-width space or a regular space.
+ *
+ * @param space
+ */
+export declare function isSpace(space: string): boolean;
+/**
+ * Converts a string into an array of tokens and the words between them.
+ *
+ * @param tokenRegex
+ * @param text
+ */
+export declare function tokenizeString(tokenRegex: RegExp, text: string): string[];
+/**
+ * Measure the width of a string accounting for letter spacing.
+ *
+ * @param context
+ * @param word
+ * @param space
+ */
+export declare function measureText(word: string, space: number | undefined, context: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D): number;
+/**
+ * Get the font metrics for a font face.
+ *
+ * @remarks
+ * This function will attempt to grab the explicitly defined metrics from the
+ * font face first. If the font face does not have metrics defined, it will
+ * attempt to calculate the metrics using the browser's measureText method.
+ *
+ * If the browser does not support the font metrics API, it will use some
+ * default values.
+ *
+ * @param context
+ * @param fontFace
+ * @param fontSize
+ * @returns
+ */
+export declare function getWebFontMetrics(context: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, fontFace: WebTrFontFace, fontSize: number): NormalizedFontMetrics;
+export interface WrapTextResult {
+    l: string[];
+    n: number[];
+}
+/**
+ * Applies newlines to a string to have it optimally fit into the horizontal
+ * bounds set by the Text object's wordWrapWidth property.
+ *
+ * @param text
+ * @param wordWrapWidth
+ * @param suffix
+ * @param context
+ */
+export declare function wrapWord(word: string, wordWrapWidth: number, suffix: string, context: CanvasRenderingContext2D): string;
+/**
+ * Applies newlines to a string to have it optimally fit into the horizontal
+ * bounds set by the Text object's wordWrapWidth property.
+ */
+export declare function wrapText(text: string, wordWrapWidth: number, letterSpacing: number, indent: number | undefined, context: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D): {
+    l: string[];
+    n: number[];
+};
+/**
+ * Calculate height for the canvas
+ *
+ * @param textBaseline
+ * @param fontSize
+ * @param lineHeight
+ * @param numLines
+ * @param offsetY
+ * @returns
+ */
+export declare function calcHeight(textBaseline: TextBaseline, fontSize: number, lineHeight: number, numLines: number): number;

package/dist/src/core/text-rendering/renderers/canvas/internal/utils.js

@@ -0,0 +1,282 @@
+/*
+ * 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.
+ */
+import {} from './types.js';
+/**
+ * Returns CSS font setting string for use in canvas context.
+ *
+ * @param fontFace
+ * @param fontStyle
+ * @param fontSize
+ * @param precision
+ * @param defaultFontFace
+ * @returns
+ */
+export function getFontSetting(fontFace, fontStyle, fontSize, precision, defaultFontFace) {
+    let ff = fontFace;
+    if (!Array.isArray(ff)) {
+        ff = [ff];
+    }
+    const ffs = [];
+    for (let i = 0, n = ff.length; i < n; i++) {
+        let curFf = ff[i];
+        // Replace the default font face `null` with the actual default font face set
+        // on the stage.
+        if (curFf === null || curFf === undefined) {
+            curFf = defaultFontFace;
+        }
+        if (curFf === 'serif' || curFf === 'sans-serif') {
+            ffs.push(curFf);
+        }
+        else {
+            ffs.push(`"${curFf}"`);
+        }
+    }
+    return `${fontStyle} ${fontSize * precision}px ${ffs.join(',')}`;
+}
+/**
+ * Returns true if the given character is a zero-width space.
+ *
+ * @param space
+ */
+export function isZeroWidthSpace(space) {
+    return space === '' || space === '\u200B';
+}
+/**
+ * Returns true if the given character is a zero-width space or a regular space.
+ *
+ * @param space
+ */
+export function isSpace(space) {
+    return isZeroWidthSpace(space) || space === ' ';
+}
+/**
+ * Converts a string into an array of tokens and the words between them.
+ *
+ * @param tokenRegex
+ * @param text
+ */
+export function tokenizeString(tokenRegex, text) {
+    const delimeters = text.match(tokenRegex) || [];
+    const words = text.split(tokenRegex) || [];
+    const final = [];
+    for (let i = 0; i < words.length; i++) {
+        final.push(words[i], delimeters[i]);
+    }
+    final.pop();
+    return final.filter((word) => word != '');
+}
+/**
+ * Measure the width of a string accounting for letter spacing.
+ *
+ * @param context
+ * @param word
+ * @param space
+ */
+export function measureText(word, space = 0, context) {
+    if (!space) {
+        return context.measureText(word).width;
+    }
+    return word.split('').reduce((acc, char) => {
+        // Zero-width spaces should not include letter spacing.
+        // And since we know the width of a zero-width space is 0, we can skip
+        // measuring it.
+        if (isZeroWidthSpace(char)) {
+            return acc;
+        }
+        return acc + context.measureText(char).width + space;
+    }, 0);
+}
+/**
+ * Get the font metrics for a font face.
+ *
+ * @remarks
+ * This function will attempt to grab the explicitly defined metrics from the
+ * font face first. If the font face does not have metrics defined, it will
+ * attempt to calculate the metrics using the browser's measureText method.
+ *
+ * If the browser does not support the font metrics API, it will use some
+ * default values.
+ *
+ * @param context
+ * @param fontFace
+ * @param fontSize
+ * @returns
+ */
+export function getWebFontMetrics(context, fontFace, fontSize) {
+    if (fontFace.metrics) {
+        return fontFace.metrics;
+    }
+    // If the font face doesn't have metrics defined, we fallback to using the
+    // browser's measureText method to calculate take a best guess at the font
+    // actual font's metrics.
+    // - fontBoundingBox[Ascent|Descent] is the best estimate but only supported
+    //   in Chrome 87+ (2020), Firefox 116+ (2023), and Safari 11.1+ (2018).
+    //   - It is an estimate as it can vary between browsers.
+    // - actualBoundingBox[Ascent|Descent] is less accurate and supported in
+    //   Chrome 77+ (2019), Firefox 74+ (2020), and Safari 11.1+ (2018).
+    // - If neither are supported, we'll use some default values which will
+    //   get text on the screen but likely not be great.
+    // NOTE: It's been decided not to rely on fontBoundingBox[Ascent|Descent]
+    // as it's browser support is limited and it also tends to produce higher than
+    // expected values. It is instead HIGHLY RECOMMENDED that developers provide
+    // explicit metrics in the font face definition.
+    const browserMetrics = context.measureText('ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz');
+    console.warn(`Font metrics not provided for Canvas Web font ${fontFace.fontFamily}. ` +
+        'Using fallback values. It is HIGHLY recommended you use the latest ' +
+        'version of the Lightning 3 `msdf-generator` tool to extract the default ' +
+        'metrics for the font and provide them in the Canvas Web font definition.');
+    let metrics;
+    if (browserMetrics.actualBoundingBoxDescent &&
+        browserMetrics.actualBoundingBoxAscent) {
+        metrics = {
+            ascender: browserMetrics.actualBoundingBoxAscent / fontSize,
+            descender: -browserMetrics.actualBoundingBoxDescent / fontSize,
+            lineGap: 0.2,
+        };
+    }
+    else {
+        // If the browser doesn't support the font metrics API, we'll use some
+        // default values.
+        metrics = {
+            ascender: 0.8,
+            descender: -0.2,
+            lineGap: 0.2,
+        };
+    }
+    // Save the calculated metrics to the font face for future use.
+    fontFace.metrics = metrics;
+    return metrics;
+}
+/**
+ * Applies newlines to a string to have it optimally fit into the horizontal
+ * bounds set by the Text object's wordWrapWidth property.
+ *
+ * @param text
+ * @param wordWrapWidth
+ * @param suffix
+ * @param context
+ */
+export function wrapWord(word, wordWrapWidth, suffix, context) {
+    const suffixWidth = context.measureText(suffix).width;
+    const wordLen = word.length;
+    const wordWidth = 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 = 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 =
+                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 =
+                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.
+ */
+export function wrapText(text, wordWrapWidth, letterSpacing, indent = 0, context) {
+    const spaceRegex = / |\u200B/g; // ZWSP and spaces
+    const lines = text.split(/\r?\n/g);
+    let allLines = [];
+    const realNewlines = [];
+    for (let i = 0; i < lines.length; i++) {
+        const resultLines = [];
+        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 = measureText(word, letterSpacing, context);
+            const wordWidthWithSpace = isZeroWidthSpace(space)
+                ? wordWidth
+                : wordWidth + measureText(space, letterSpacing, context);
+            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 };
+}
+/**
+ * Calculate height for the canvas
+ *
+ * @param textBaseline
+ * @param fontSize
+ * @param lineHeight
+ * @param numLines
+ * @param offsetY
+ * @returns
+ */
+export function calcHeight(textBaseline, fontSize, lineHeight, numLines) {
+    const baselineOffset = textBaseline !== 'bottom' ? 0.5 * fontSize : 0;
+    return (lineHeight * (numLines - 1) +
+        baselineOffset +
+        Math.max(lineHeight, fontSize));
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/core/text-rendering/renderers/canvas/internal/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../../../src/core/text-rendering/renderers/canvas/internal/utils.ts"],"names":[],"mappings":"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"}

package/dist/src/core/text-rendering/sdf/PeekableGenerator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A wrapper Generator class that makes a generator peekable.
+ */
+export declare class PeekableIterator<T = unknown, TReturn = any, TNext = unknown> implements Iterator<T, TReturn, TNext> {
+    private iterator;
+    private peekBuffer;
+    private _lastIndex;
+    constructor(iterator: Iterator<T, TReturn, TNext>, indexBase?: number);
+    next(): IteratorResult<T, TReturn>;
+    peek(): IteratorResult<T, TReturn>;
+    get lastIndex(): number;
+}

package/dist/src/core/text-rendering/sdf/PeekableGenerator.js

@@ -0,0 +1,61 @@
+/*
+ * 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.
+ */
+/**
+ * A wrapper Generator class that makes a generator peekable.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export class PeekableIterator {
+    iterator;
+    peekBuffer = [];
+    _lastIndex = -1;
+    constructor(iterator, indexBase = 0) {
+        this.iterator = iterator;
+        this.iterator = iterator;
+        this._lastIndex = indexBase - 1;
+        this.peekBuffer = [];
+    }
+    next() {
+        const nextResult = this.peekBuffer.length > 0
+            ? // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                this.peekBuffer.pop()
+            : this.iterator.next();
+        if (nextResult.done === true) {
+            this._lastIndex = -1;
+        }
+        else {
+            this._lastIndex++;
+        }
+        return nextResult;
+    }
+    peek() {
+        if (this.peekBuffer.length > 0) {
+            // We know that the buffer is not empty, so we can safely use the
+            // non-null assertion operator
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            return this.peekBuffer[0];
+        }
+        const result = this.iterator.next();
+        this.peekBuffer.push(result);
+        return result;
+    }
+    get lastIndex() {
+        return this._lastIndex;
+    }
+}
+//# sourceMappingURL=PeekableGenerator.js.map

package/dist/src/core/text-rendering/sdf/PeekableGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeekableGenerator.js","sourceRoot":"","sources":["../../../../../src/core/text-rendering/sdf/PeekableGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;GAEG;AACH,8DAA8D;AAC9D,MAAM,OAAO,gBAAgB;IAMP;IAHZ,UAAU,GAAiC,EAAE,CAAC;IAC9C,UAAU,GAAG,CAAC,CAAC,CAAC;IAExB,YAAoB,QAAqC,EAAE,SAAS,GAAG,CAAC;QAApD,aAAQ,GAAR,QAAQ,CAA6B;QACvD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,IAAI;QACF,MAAM,UAAU,GACd,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YACxB,CAAC,CAAC,oEAAoE;gBACpE,IAAI,CAAC,UAAU,CAAC,GAAG,EAAG;YACxB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE3B,IAAI,UAAU,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,iEAAiE;YACjE,8BAA8B;YAC9B,oEAAoE;YACpE,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;QAC7B,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/src/core/text-rendering/sdf/SimpleFontShaper.d.ts

@@ -0,0 +1,45 @@
+import type { PeekableIterator } from './PeekableGenerator.js';
+/**
+ * Minimal glyph info for performance-focused text shaping
+ */
+export interface SimpleGlyphInfo {
+    /**
+     * Whether the character was successfully mapped to a glyph
+     */
+    mapped: boolean;
+    /**
+     * Unicode codepoint
+     */
+    codepoint: number;
+    /**
+     * How much to advance horizontally after rendering this glyph
+     */
+    xAdvance: number;
+}
+/**
+ * Minimal font shaper properties
+ */
+export interface FontShaperProps {
+    /**
+     * Font family name
+     */
+    fontFamily: string;
+    /**
+     * Font size in pixels
+     */
+    fontSize: number;
+    /**
+     * Letter spacing in pixels
+     */
+    letterSpacing: number;
+}
+/**
+ * Functional font shaper interface
+ */
+export interface FontShaper {
+    shapeText: (props: FontShaperProps, codepoints: PeekableIterator<number>) => Generator<SimpleGlyphInfo, void>;
+}
+/**
+ * Create a simple SDF font shaper
+ */
+export declare const createSdfFontShaper: () => FontShaper;

package/dist/src/core/text-rendering/sdf/SimpleFontShaper.js

@@ -0,0 +1,69 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2025 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.
+ */
+import * as SdfFontHandler from '../SdfFontHandler.js';
+/**
+ * Create a simple SDF font shaper
+ */
+export const createSdfFontShaper = () => ({
+    shapeText: function* (props, codepoints) {
+        // Host paths on top
+        const fontFamily = props.fontFamily;
+        const fontSize = props.fontSize;
+        const letterSpacing = props.letterSpacing;
+        const fontData = SdfFontHandler.getFontData(fontFamily);
+        if (fontData === null)
+            return;
+        const fontScale = fontSize / fontData.common.lineHeight;
+        let prevCodepoint = 0;
+        while (true) {
+            const result = codepoints.next();
+            if (result.done)
+                break;
+            const codepoint = result.value;
+            if (!codepoint)
+                continue;
+            // Get glyph data
+            const glyph = SdfFontHandler.getGlyph(fontFamily, codepoint);
+            if (glyph === null) {
+                yield {
+                    mapped: false,
+                    codepoint,
+                    xAdvance: 0,
+                };
+                continue;
+            }
+            // Calculate advance with kerning
+            let advance = glyph.xadvance * fontScale;
+            // Add kerning if there's a previous character
+            if (prevCodepoint !== 0) {
+                const kerning = SdfFontHandler.getKerning(fontFamily, prevCodepoint, codepoint);
+                advance += kerning * fontScale;
+            }
+            // Add letter spacing
+            advance += letterSpacing;
+            yield {
+                mapped: true,
+                codepoint,
+                xAdvance: advance,
+            };
+            prevCodepoint = codepoint;
+        }
+    },
+});
+//# sourceMappingURL=SimpleFontShaper.js.map

package/dist/src/core/text-rendering/sdf/SimpleFontShaper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleFontShaper.js","sourceRoot":"","sources":["../../../../../src/core/text-rendering/sdf/SimpleFontShaper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAgDvD;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAe,EAAE,CAAC,CAAC;IACpD,SAAS,EAAE,QAAQ,CAAC,EAClB,KAAsB,EACtB,UAAoC;QAEpC,oBAAoB;QACpB,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;QAE1C,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO;QAE9B,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC;QACxD,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,MAAM,CAAC,IAAI;gBAAE,MAAM;YAEvB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC;YAC/B,IAAI,CAAC,SAAS;gBAAE,SAAS;YAEzB,iBAAiB;YACjB,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAC7D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM;oBACJ,MAAM,EAAE,KAAK;oBACb,SAAS;oBACT,QAAQ,EAAE,CAAC;iBACZ,CAAC;gBACF,SAAS;YACX,CAAC;YAED,iCAAiC;YACjC,IAAI,OAAO,GAAG,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC;YAEzC,8CAA8C;YAC9C,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CACvC,UAAU,EACV,aAAa,EACb,SAAS,CACV,CAAC;gBACF,OAAO,IAAI,OAAO,GAAG,SAAS,CAAC;YACjC,CAAC;YAED,qBAAqB;YACrB,OAAO,IAAI,aAAa,CAAC;YAEzB,MAAM;gBACJ,MAAM,EAAE,IAAI;gBACZ,SAAS;gBACT,QAAQ,EAAE,OAAO;aAClB,CAAC;YAEF,aAAa,GAAG,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}