@mentra/engine 0.1.0-beta.0

package/build/utils/display/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/display/index.ts"],"names":[],"mappings":"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"}

package/build/utils/display/index.js

@@ -0,0 +1,185 @@
+/**
+ * @mentra/display-utils
+ *
+ * Glasses-agnostic, pixel-accurate text measurement and wrapping library
+ * for smart glasses displays.
+ *
+ * Key features:
+ * - Pixel-perfect measurement (no abstract units or averages)
+ * - Multiple break modes (character, word, strict-word)
+ * - Full script support (Latin, CJK, Korean, Cyrillic)
+ * - Configurable display profiles for different glasses hardware
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   TextMeasurer,
+ *   TextWrapper,
+ *   DisplayHelpers,
+ *   G1_PROFILE
+ * } from '@mentra/display-utils'
+ *
+ * // Create measurer and wrapper for G1 glasses
+ * const measurer = new TextMeasurer(G1_PROFILE)
+ * const wrapper = new TextWrapper(measurer, { breakMode: 'character' })
+ * const helpers = new DisplayHelpers(measurer, wrapper)
+ *
+ * // Wrap text for display
+ * const result = wrapper.wrap("Hello, world! This is a long text.")
+ * console.log(result.lines)
+ * // ["Hello, world! This is a long text th-", "at needs wrapping."]
+ * ```
+ */
+export { G1_PROFILE, G1_PROFILE_LEGACY, G1_HYPHEN_WIDTH_PX, G1_SPACE_WIDTH_PX } from "./profiles";
+// G2 Profile
+export { G2_PROFILE, G2_HYPHEN_WIDTH_PX, G2_SPACE_WIDTH_PX } from "./profiles";
+// Z100 Profile
+export { Z100_PROFILE, Z100_HYPHEN_WIDTH_PX, Z100_SPACE_WIDTH_PX } from "./profiles";
+// Mentra Nex Profile (a.k.a. Mentra Display)
+export { NEX_PROFILE, NEX_HYPHEN_WIDTH_PX, NEX_SPACE_WIDTH_PX } from "./profiles";
+// Import for factory functions
+import { G1_PROFILE_LEGACY, G2_PROFILE, Z100_PROFILE, NEX_PROFILE } from "./profiles";
+// =============================================================================
+// Measurer - Pixel-accurate text measurement
+// =============================================================================
+export { TextMeasurer } from "./measurer";
+// Script detection utilities
+export { detectScript, isCJKCharacter, isKoreanCharacter, isUniformWidthScript, isUnsupportedScript, needsHyphenForBreak, SCRIPT_RANGES, } from "./measurer";
+// =============================================================================
+// Wrapper - Text wrapping with multiple break modes
+// =============================================================================
+export { TextWrapper } from "./wrapper";
+export { DEFAULT_WRAP_OPTIONS } from "./wrapper";
+// =============================================================================
+// Helpers - Optional convenience utilities
+// =============================================================================
+export { DisplayHelpers, ScrollView } from "./helpers";
+// =============================================================================
+// Composer - Multi-column layout composition
+// =============================================================================
+export { ColumnComposer, createColumnComposer } from "./composer";
+// =============================================================================
+// Convenience factory functions
+// =============================================================================
+import { TextMeasurer } from "./measurer";
+import { TextWrapper } from "./wrapper";
+import { DisplayHelpers } from "./helpers";
+import { ColumnComposer } from "./composer";
+import { G1_PROFILE } from "./profiles";
+/**
+ * Create a complete display toolkit for a given profile.
+ *
+ * @param profile - Display profile (defaults to G1)
+ * @param wrapOptions - Default wrap options
+ * @returns Object with measurer, wrapper, and helpers
+ *
+ * @example
+ * ```typescript
+ * const { measurer, wrapper, helpers } = createDisplayToolkit()
+ * const lines = wrapper.wrapToLines("Hello, world!")
+ * ```
+ */
+export function createDisplayToolkit(profile = G1_PROFILE, wrapOptions) {
+    const measurer = new TextMeasurer(profile);
+    const wrapper = new TextWrapper(measurer, wrapOptions);
+    const helpers = new DisplayHelpers(measurer, wrapper);
+    const composer = new ColumnComposer(profile, wrapOptions?.breakMode || "word");
+    return {
+        measurer,
+        wrapper,
+        helpers,
+        composer,
+        profile,
+    };
+}
+/**
+ * Create a G1-configured display toolkit with character breaking.
+ * This is the recommended setup for captions and similar high-utilization use cases.
+ *
+ * @returns Object with measurer, wrapper, and helpers configured for G1
+ *
+ * @example
+ * ```typescript
+ * const { wrapper, composer } = createG1Toolkit()
+ * const result = wrapper.wrap("Your text here")
+ * const columns = composer.composeDoubleTextWall("Left", "Right")
+ * ```
+ */
+export function createG1Toolkit() {
+    return createDisplayToolkit(G1_PROFILE, {
+        breakMode: "character-no-hyphen",
+    });
+}
+/**
+ * Create a G1-configured display toolkit for LEGACY mobile clients.
+ *
+ * Use this when the mobile client has old wrapping logic that re-wraps
+ * text received from the cloud. This profile uses a reduced display width
+ * (~522px instead of 576px) to prevent double-wrapping overflow.
+ *
+ * @returns Object with measurer, wrapper, and helpers configured for legacy G1 clients
+ *
+ * @example
+ * ```typescript
+ * // For old mobile clients that double-wrap
+ * const { wrapper } = createG1LegacyToolkit()
+ * const result = wrapper.wrap("Your text here")
+ * // Lines will be shorter to account for mobile re-wrapping
+ * ```
+ */
+export function createG1LegacyToolkit() {
+    return createDisplayToolkit(G1_PROFILE_LEGACY, {
+        breakMode: "character-no-hyphen",
+    });
+}
+/**
+ * Create a G2-configured display toolkit with character breaking.
+ * G2 uses EvenHub protocol with the same display hardware as G1.
+ *
+ * @returns Object with measurer, wrapper, and helpers configured for Even G2
+ *
+ * @example
+ * ```typescript
+ * const { wrapper } = createG2Toolkit()
+ * const result = wrapper.wrap("Your text here")
+ * ```
+ */
+export function createG2Toolkit() {
+    return createDisplayToolkit(G2_PROFILE, {
+        breakMode: "character-no-hyphen",
+    });
+}
+/**
+ * Create a Z100-configured display toolkit with character breaking.
+ *
+ * @returns Object with measurer, wrapper, and helpers configured for Vuzix Z100
+ *
+ * @example
+ * ```typescript
+ * const { wrapper } = createZ100Toolkit()
+ * const result = wrapper.wrap("Your text here")
+ * ```
+ */
+export function createZ100Toolkit() {
+    return createDisplayToolkit(Z100_PROFILE, {
+        breakMode: "character-no-hyphen",
+    });
+}
+/**
+ * Create a Mentra Nex-configured display toolkit with character breaking.
+ * Also known as "Mentra Display".
+ *
+ * @returns Object with measurer, wrapper, and helpers configured for Mentra Nex
+ *
+ * @example
+ * ```typescript
+ * const { wrapper } = createNexToolkit()
+ * const result = wrapper.wrap("Your text here")
+ * ```
+ */
+export function createNexToolkit() {
+    return createDisplayToolkit(NEX_PROFILE, {
+        breakMode: "character-no-hyphen",
+    });
+}
+//# sourceMappingURL=index.js.map

package/build/utils/display/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/display/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @mentra/display-utils\n *\n * Glasses-agnostic, pixel-accurate text measurement and wrapping library\n * for smart glasses displays.\n *\n * Key features:\n * - Pixel-perfect measurement (no abstract units or averages)\n * - Multiple break modes (character, word, strict-word)\n * - Full script support (Latin, CJK, Korean, Cyrillic)\n * - Configurable display profiles for different glasses hardware\n *\n * @example\n * ```typescript\n * import {\n *   TextMeasurer,\n *   TextWrapper,\n *   DisplayHelpers,\n *   G1_PROFILE\n * } from '@mentra/display-utils'\n *\n * // Create measurer and wrapper for G1 glasses\n * const measurer = new TextMeasurer(G1_PROFILE)\n * const wrapper = new TextWrapper(measurer, { breakMode: 'character' })\n * const helpers = new DisplayHelpers(measurer, wrapper)\n *\n * // Wrap text for display\n * const result = wrapper.wrap(\"Hello, world! This is a long text.\")\n * console.log(result.lines)\n * // [\"Hello, world! This is a long text th-\", \"at needs wrapping.\"]\n * ```\n */\n\n// =============================================================================\n// Profiles - Hardware configurations for different glasses\n// =============================================================================\n\nexport type {\n  DisplayProfile,\n  FontMetrics,\n  UniformScriptWidths,\n  FallbackConfig,\n  DisplayConstraints,\n  ScriptType,\n} from \"./profiles\";\n\nexport { G1_PROFILE, G1_PROFILE_LEGACY, G1_HYPHEN_WIDTH_PX, G1_SPACE_WIDTH_PX } from \"./profiles\";\n\n// G2 Profile\nexport { G2_PROFILE, G2_HYPHEN_WIDTH_PX, G2_SPACE_WIDTH_PX } from \"./profiles\";\n\n// Z100 Profile\nexport { Z100_PROFILE, Z100_HYPHEN_WIDTH_PX, Z100_SPACE_WIDTH_PX } from \"./profiles\";\n\n// Mentra Nex Profile (a.k.a. Mentra Display)\nexport { NEX_PROFILE, NEX_HYPHEN_WIDTH_PX, NEX_SPACE_WIDTH_PX } from \"./profiles\";\n\n// Import for factory functions\nimport { G1_PROFILE_LEGACY, G2_PROFILE, Z100_PROFILE, NEX_PROFILE } from \"./profiles\";\n\n// =============================================================================\n// Measurer - Pixel-accurate text measurement\n// =============================================================================\n\nexport { TextMeasurer } from \"./measurer\";\nexport type { CharMeasurement, TextMeasurement } from \"./measurer\";\n\n// Script detection utilities\nexport {\n  detectScript,\n  isCJKCharacter,\n  isKoreanCharacter,\n  isUniformWidthScript,\n  isUnsupportedScript,\n  needsHyphenForBreak,\n  SCRIPT_RANGES,\n} from \"./measurer\";\n\n// =============================================================================\n// Wrapper - Text wrapping with multiple break modes\n// =============================================================================\n\nexport { TextWrapper } from \"./wrapper\";\nexport type { WrapOptions, WrapResult, LineMetrics, BreakMode } from \"./wrapper\";\nexport { DEFAULT_WRAP_OPTIONS } from \"./wrapper\";\n\n// =============================================================================\n// Helpers - Optional convenience utilities\n// =============================================================================\n\nexport { DisplayHelpers, ScrollView } from \"./helpers\";\nexport type { TruncateResult, Page, Chunk, ScrollPosition, ScrollViewport } from \"./helpers\";\n\n// =============================================================================\n// Composer - Multi-column layout composition\n// =============================================================================\n\nexport { ColumnComposer, createColumnComposer } from \"./composer\";\nexport type { ColumnConfig, ComposeOptions, ComposeResult } from \"./composer\";\n\n// =============================================================================\n// Convenience factory functions\n// =============================================================================\n\nimport { TextMeasurer } from \"./measurer\";\nimport { TextWrapper } from \"./wrapper\";\nimport { DisplayHelpers } from \"./helpers\";\nimport { ColumnComposer } from \"./composer\";\nimport { G1_PROFILE } from \"./profiles\";\nimport type { DisplayProfile } from \"./profiles\";\nimport type { WrapOptions } from \"./wrapper\";\n\n/**\n * Create a complete display toolkit for a given profile.\n *\n * @param profile - Display profile (defaults to G1)\n * @param wrapOptions - Default wrap options\n * @returns Object with measurer, wrapper, and helpers\n *\n * @example\n * ```typescript\n * const { measurer, wrapper, helpers } = createDisplayToolkit()\n * const lines = wrapper.wrapToLines(\"Hello, world!\")\n * ```\n */\nexport function createDisplayToolkit(\n  profile: DisplayProfile = G1_PROFILE,\n  wrapOptions?: WrapOptions,\n): {\n  measurer: TextMeasurer;\n  wrapper: TextWrapper;\n  helpers: DisplayHelpers;\n  composer: ColumnComposer;\n  profile: DisplayProfile;\n} {\n  const measurer = new TextMeasurer(profile);\n  const wrapper = new TextWrapper(measurer, wrapOptions);\n  const helpers = new DisplayHelpers(measurer, wrapper);\n  const composer = new ColumnComposer(profile, wrapOptions?.breakMode || \"word\");\n\n  return {\n    measurer,\n    wrapper,\n    helpers,\n    composer,\n    profile,\n  };\n}\n\n/**\n * Create a G1-configured display toolkit with character breaking.\n * This is the recommended setup for captions and similar high-utilization use cases.\n *\n * @returns Object with measurer, wrapper, and helpers configured for G1\n *\n * @example\n * ```typescript\n * const { wrapper, composer } = createG1Toolkit()\n * const result = wrapper.wrap(\"Your text here\")\n * const columns = composer.composeDoubleTextWall(\"Left\", \"Right\")\n * ```\n */\nexport function createG1Toolkit(): {\n  measurer: TextMeasurer;\n  wrapper: TextWrapper;\n  helpers: DisplayHelpers;\n  composer: ColumnComposer;\n  profile: DisplayProfile;\n} {\n  return createDisplayToolkit(G1_PROFILE, {\n    breakMode: \"character-no-hyphen\",\n  });\n}\n\n/**\n * Create a G1-configured display toolkit for LEGACY mobile clients.\n *\n * Use this when the mobile client has old wrapping logic that re-wraps\n * text received from the cloud. This profile uses a reduced display width\n * (~522px instead of 576px) to prevent double-wrapping overflow.\n *\n * @returns Object with measurer, wrapper, and helpers configured for legacy G1 clients\n *\n * @example\n * ```typescript\n * // For old mobile clients that double-wrap\n * const { wrapper } = createG1LegacyToolkit()\n * const result = wrapper.wrap(\"Your text here\")\n * // Lines will be shorter to account for mobile re-wrapping\n * ```\n */\nexport function createG1LegacyToolkit(): {\n  measurer: TextMeasurer;\n  wrapper: TextWrapper;\n  helpers: DisplayHelpers;\n  composer: ColumnComposer;\n  profile: DisplayProfile;\n} {\n  return createDisplayToolkit(G1_PROFILE_LEGACY, {\n    breakMode: \"character-no-hyphen\",\n  });\n}\n\n/**\n * Create a G2-configured display toolkit with character breaking.\n * G2 uses EvenHub protocol with the same display hardware as G1.\n *\n * @returns Object with measurer, wrapper, and helpers configured for Even G2\n *\n * @example\n * ```typescript\n * const { wrapper } = createG2Toolkit()\n * const result = wrapper.wrap(\"Your text here\")\n * ```\n */\nexport function createG2Toolkit(): {\n  measurer: TextMeasurer;\n  wrapper: TextWrapper;\n  helpers: DisplayHelpers;\n  composer: ColumnComposer;\n  profile: DisplayProfile;\n} {\n  return createDisplayToolkit(G2_PROFILE, {\n    breakMode: \"character-no-hyphen\",\n  });\n}\n\n/**\n * Create a Z100-configured display toolkit with character breaking.\n *\n * @returns Object with measurer, wrapper, and helpers configured for Vuzix Z100\n *\n * @example\n * ```typescript\n * const { wrapper } = createZ100Toolkit()\n * const result = wrapper.wrap(\"Your text here\")\n * ```\n */\nexport function createZ100Toolkit(): {\n  measurer: TextMeasurer;\n  wrapper: TextWrapper;\n  helpers: DisplayHelpers;\n  composer: ColumnComposer;\n  profile: DisplayProfile;\n} {\n  return createDisplayToolkit(Z100_PROFILE, {\n    breakMode: \"character-no-hyphen\",\n  });\n}\n\n/**\n * Create a Mentra Nex-configured display toolkit with character breaking.\n * Also known as \"Mentra Display\".\n *\n * @returns Object with measurer, wrapper, and helpers configured for Mentra Nex\n *\n * @example\n * ```typescript\n * const { wrapper } = createNexToolkit()\n * const result = wrapper.wrap(\"Your text here\")\n * ```\n */\nexport function createNexToolkit(): {\n  measurer: TextMeasurer;\n  wrapper: TextWrapper;\n  helpers: DisplayHelpers;\n  composer: ColumnComposer;\n  profile: DisplayProfile;\n} {\n  return createDisplayToolkit(NEX_PROFILE, {\n    breakMode: \"character-no-hyphen\",\n  });\n}\n"]}

package/build/utils/display/measurer/TextMeasurer.d.ts

@@ -0,0 +1,160 @@
+import type { DisplayProfile, ScriptType } from "../profiles/types";
+/**
+ * Character measurement result with detailed breakdown.
+ */
+export interface CharMeasurement {
+    /** The character measured */
+    char: string;
+    /** Width in rendered pixels */
+    widthPx: number;
+    /** The script type of the character */
+    script: ScriptType;
+    /** Whether width came from glyph map (true) or fallback (false) */
+    fromGlyphMap: boolean;
+}
+/**
+ * Text measurement result with detailed breakdown.
+ */
+export interface TextMeasurement {
+    /** The text measured */
+    text: string;
+    /** Total width in rendered pixels */
+    totalWidthPx: number;
+    /** Number of characters */
+    charCount: number;
+    /** Per-character measurements (optional, for debugging) */
+    chars?: CharMeasurement[];
+}
+/**
+ * Measures text width in pixels based on a DisplayProfile.
+ * All measurements are in actual rendered pixels, not abstract units.
+ *
+ * Key features:
+ * - Pixel-perfect measurement for mapped characters
+ * - Uniform-width handling for CJK, Korean, Cyrillic
+ * - Safe fallback for unmapped Latin characters
+ * - Caching for performance
+ */
+export declare class TextMeasurer {
+    private readonly profile;
+    private readonly charCache;
+    constructor(profile: DisplayProfile);
+    /**
+     * Pre-compute rendered widths for all known glyphs.
+     */
+    private buildCharCache;
+    /**
+     * Measure the total pixel width of a text string.
+     *
+     * @param text - The text to measure
+     * @returns Width in rendered pixels
+     */
+    measureText(text: string): number;
+    /**
+     * Measure text with detailed breakdown of each character.
+     *
+     * @param text - The text to measure
+     * @returns Detailed measurement result
+     */
+    measureTextDetailed(text: string): TextMeasurement;
+    /**
+     * Measure a single character's pixel width.
+     *
+     * IMPORTANT: This is PIXEL-PERFECT measurement, not averaging!
+     * - Mapped characters: exact width from glyph map
+     * - Uniform scripts (CJK, Korean, Cyrillic): verified uniform width
+     * - Unmapped Latin: MAX width fallback (safe, never overflow)
+     *
+     * @param char - Single character to measure
+     * @returns Width in rendered pixels
+     */
+    measureChar(char: string): number;
+    /**
+     * Calculate character width (called when not in cache).
+     */
+    private calculateCharWidth;
+    /**
+     * Get the raw glyph width (before render formula).
+     * Returns undefined for unmapped characters.
+     *
+     * @param char - Single character
+     * @returns Glyph width in pixels, or undefined if not in glyph map
+     */
+    getGlyphWidth(char: string): number | undefined;
+    /**
+     * Check if text fits within a pixel width.
+     *
+     * @param text - Text to check
+     * @param maxWidthPx - Maximum width in pixels
+     * @returns true if text fits
+     */
+    fitsInWidth(text: string, maxWidthPx: number): boolean;
+    /**
+     * Find how many characters fit within a pixel width.
+     *
+     * @param text - Text to measure
+     * @param maxWidthPx - Maximum width in pixels
+     * @param startIndex - Starting index (default: 0)
+     * @returns Number of characters that fit
+     */
+    charsThatFit(text: string, maxWidthPx: number, startIndex?: number): number;
+    /**
+     * Find the pixel position of a character index in text.
+     *
+     * @param text - Text to measure
+     * @param index - Character index
+     * @returns Pixel offset from start of text
+     */
+    getPixelOffset(text: string, index: number): number;
+    /**
+     * Detect the script type of a character.
+     *
+     * @param char - Single character
+     * @returns Script type
+     */
+    detectScript(char: string): ScriptType;
+    /**
+     * Check if a character is from a uniform-width script.
+     *
+     * @param char - Single character
+     * @returns true if character is from CJK, Korean, or Cyrillic
+     */
+    isUniformWidth(char: string): boolean;
+    /**
+     * Get the display profile.
+     */
+    getProfile(): DisplayProfile;
+    /**
+     * Get the display width in pixels.
+     */
+    getDisplayWidthPx(): number;
+    /**
+     * Get the maximum number of lines.
+     */
+    getMaxLines(): number;
+    /**
+     * Get the maximum payload size in bytes.
+     */
+    getMaxPayloadBytes(): number;
+    /**
+     * Calculate the UTF-8 byte size of text.
+     *
+     * @param text - Text to measure
+     * @returns Byte size
+     */
+    getByteSize(text: string): number;
+    /**
+     * Get the width of a hyphen character in rendered pixels.
+     */
+    getHyphenWidth(): number;
+    /**
+     * Get the width of a space character in rendered pixels.
+     */
+    getSpaceWidth(): number;
+    /**
+     * Clear the character cache.
+     * Useful if profile metrics change at runtime.
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=TextMeasurer.d.ts.map

package/build/utils/display/measurer/TextMeasurer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextMeasurer.d.ts","sourceRoot":"","sources":["../../../../src/utils/display/measurer/TextMeasurer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGnE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,MAAM,EAAE,UAAU,CAAA;IAClB,mEAAmE;IACnE,YAAY,EAAE,OAAO,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;gBAE/C,OAAO,EAAE,cAAc;IAMnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAYjC;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAoClD;;;;;;;;;;OAUG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAoBjC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAItD;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU,GAAG,MAAM;IAyB9E;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAenD;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAItC;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;OAEG;IACH,UAAU,IAAI,cAAc;IAI5B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,UAAU,IAAI,IAAI;CAInB"}

package/build/utils/display/measurer/TextMeasurer.js

@@ -0,0 +1,273 @@
+import { detectScript, isUniformWidthScript } from "./script-detection";
+/**
+ * Measures text width in pixels based on a DisplayProfile.
+ * All measurements are in actual rendered pixels, not abstract units.
+ *
+ * Key features:
+ * - Pixel-perfect measurement for mapped characters
+ * - Uniform-width handling for CJK, Korean, Cyrillic
+ * - Safe fallback for unmapped Latin characters
+ * - Caching for performance
+ */
+export class TextMeasurer {
+    profile;
+    charCache = new Map();
+    constructor(profile) {
+        this.profile = profile;
+        // Pre-populate cache with known glyphs
+        this.buildCharCache();
+    }
+    /**
+     * Pre-compute rendered widths for all known glyphs.
+     */
+    buildCharCache() {
+        const { glyphWidths, renderFormula } = this.profile.fontMetrics;
+        for (const [char, glyphWidth] of glyphWidths.entries()) {
+            const renderedWidth = renderFormula(glyphWidth);
+            this.charCache.set(char, renderedWidth);
+        }
+    }
+    /**
+     * Measure the total pixel width of a text string.
+     *
+     * @param text - The text to measure
+     * @returns Width in rendered pixels
+     */
+    measureText(text) {
+        if (!text || text.length === 0) {
+            return 0;
+        }
+        let totalWidth = 0;
+        for (const char of text) {
+            totalWidth += this.measureChar(char);
+        }
+        return totalWidth;
+    }
+    /**
+     * Measure text with detailed breakdown of each character.
+     *
+     * @param text - The text to measure
+     * @returns Detailed measurement result
+     */
+    measureTextDetailed(text) {
+        if (!text || text.length === 0) {
+            return {
+                text: "",
+                totalWidthPx: 0,
+                charCount: 0,
+                chars: [],
+            };
+        }
+        const chars = [];
+        let totalWidth = 0;
+        for (const char of text) {
+            const script = detectScript(char);
+            const widthPx = this.measureChar(char);
+            const fromGlyphMap = this.profile.fontMetrics.glyphWidths.has(char);
+            chars.push({
+                char,
+                widthPx,
+                script,
+                fromGlyphMap,
+            });
+            totalWidth += widthPx;
+        }
+        return {
+            text,
+            totalWidthPx: totalWidth,
+            charCount: chars.length,
+            chars,
+        };
+    }
+    /**
+     * Measure a single character's pixel width.
+     *
+     * IMPORTANT: This is PIXEL-PERFECT measurement, not averaging!
+     * - Mapped characters: exact width from glyph map
+     * - Uniform scripts (CJK, Korean, Cyrillic): verified uniform width
+     * - Unmapped Latin: MAX width fallback (safe, never overflow)
+     *
+     * @param char - Single character to measure
+     * @returns Width in rendered pixels
+     */
+    measureChar(char) {
+        if (!char || char.length === 0) {
+            return 0;
+        }
+        // Check cache first (includes pre-computed glyph map entries)
+        const cached = this.charCache.get(char);
+        if (cached !== undefined) {
+            return cached;
+        }
+        // Calculate width based on script type
+        const width = this.calculateCharWidth(char);
+        // Cache for future lookups
+        this.charCache.set(char, width);
+        return width;
+    }
+    /**
+     * Calculate character width (called when not in cache).
+     */
+    calculateCharWidth(char) {
+        const { fontMetrics } = this.profile;
+        const { uniformScripts, fallback, renderFormula, glyphWidths } = fontMetrics;
+        // 1. Check explicit glyph map (pixel-perfect for Latin)
+        const glyphWidth = glyphWidths.get(char);
+        if (glyphWidth !== undefined) {
+            return renderFormula(glyphWidth);
+        }
+        // 2. Uniform-width scripts (verified monospace - NOT averages!)
+        const script = detectScript(char);
+        switch (script) {
+            case "cjk":
+                return uniformScripts.cjk; // ALL CJK chars are exactly this width
+            case "hiragana":
+                return uniformScripts.hiragana; // ALL Hiragana chars are exactly this width
+            case "katakana":
+                return uniformScripts.katakana; // ALL Katakana chars are exactly this width
+            case "korean":
+                return uniformScripts.korean; // ALL Korean chars are exactly this width
+            case "cyrillic":
+                return uniformScripts.cyrillic; // ALL Cyrillic chars are exactly this width
+        }
+        // 3. Unmapped Latin or unknown: use MAX width (safe fallback)
+        // This guarantees we NEVER overflow - worst case is slight under-utilization
+        return fallback.latinMaxWidth;
+    }
+    /**
+     * Get the raw glyph width (before render formula).
+     * Returns undefined for unmapped characters.
+     *
+     * @param char - Single character
+     * @returns Glyph width in pixels, or undefined if not in glyph map
+     */
+    getGlyphWidth(char) {
+        return this.profile.fontMetrics.glyphWidths.get(char);
+    }
+    /**
+     * Check if text fits within a pixel width.
+     *
+     * @param text - Text to check
+     * @param maxWidthPx - Maximum width in pixels
+     * @returns true if text fits
+     */
+    fitsInWidth(text, maxWidthPx) {
+        return this.measureText(text) <= maxWidthPx;
+    }
+    /**
+     * Find how many characters fit within a pixel width.
+     *
+     * @param text - Text to measure
+     * @param maxWidthPx - Maximum width in pixels
+     * @param startIndex - Starting index (default: 0)
+     * @returns Number of characters that fit
+     */
+    charsThatFit(text, maxWidthPx, startIndex = 0) {
+        if (!text || startIndex >= text.length) {
+            return 0;
+        }
+        let currentWidth = 0;
+        let count = 0;
+        // Use Array.from to handle surrogate pairs correctly
+        const chars = Array.from(text).slice(startIndex);
+        for (const char of chars) {
+            const charWidth = this.measureChar(char);
+            if (currentWidth + charWidth > maxWidthPx) {
+                break;
+            }
+            currentWidth += charWidth;
+            count++;
+        }
+        return count;
+    }
+    /**
+     * Find the pixel position of a character index in text.
+     *
+     * @param text - Text to measure
+     * @param index - Character index
+     * @returns Pixel offset from start of text
+     */
+    getPixelOffset(text, index) {
+        if (!text || index <= 0) {
+            return 0;
+        }
+        const chars = Array.from(text).slice(0, index);
+        let offset = 0;
+        for (const char of chars) {
+            offset += this.measureChar(char);
+        }
+        return offset;
+    }
+    /**
+     * Detect the script type of a character.
+     *
+     * @param char - Single character
+     * @returns Script type
+     */
+    detectScript(char) {
+        return detectScript(char);
+    }
+    /**
+     * Check if a character is from a uniform-width script.
+     *
+     * @param char - Single character
+     * @returns true if character is from CJK, Korean, or Cyrillic
+     */
+    isUniformWidth(char) {
+        return isUniformWidthScript(char);
+    }
+    /**
+     * Get the display profile.
+     */
+    getProfile() {
+        return this.profile;
+    }
+    /**
+     * Get the display width in pixels.
+     */
+    getDisplayWidthPx() {
+        return this.profile.displayWidthPx;
+    }
+    /**
+     * Get the maximum number of lines.
+     */
+    getMaxLines() {
+        return this.profile.maxLines;
+    }
+    /**
+     * Get the maximum payload size in bytes.
+     */
+    getMaxPayloadBytes() {
+        return this.profile.maxPayloadBytes;
+    }
+    /**
+     * Calculate the UTF-8 byte size of text.
+     *
+     * @param text - Text to measure
+     * @returns Byte size
+     */
+    getByteSize(text) {
+        return new TextEncoder().encode(text).length;
+    }
+    /**
+     * Get the width of a hyphen character in rendered pixels.
+     */
+    getHyphenWidth() {
+        return this.measureChar("-");
+    }
+    /**
+     * Get the width of a space character in rendered pixels.
+     */
+    getSpaceWidth() {
+        return this.measureChar(" ");
+    }
+    /**
+     * Clear the character cache.
+     * Useful if profile metrics change at runtime.
+     */
+    clearCache() {
+        this.charCache.clear();
+        this.buildCharCache();
+    }
+}
+//# sourceMappingURL=TextMeasurer.js.map