@mentra/engine 0.1.0-beta.0

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Text Measurer Module
+ *
+ * Provides pixel-accurate text measurement based on display profiles.
+ * All measurements are in actual rendered pixels, not abstract units.
+ */
+export { TextMeasurer } from "./TextMeasurer";
+export type { CharMeasurement, TextMeasurement } from "./TextMeasurer";
+export { detectScript, isCJKCharacter, isKoreanCharacter, isUniformWidthScript, isUnsupportedScript, needsHyphenForBreak, SCRIPT_RANGES, } from "./script-detection";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/display/measurer/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGtE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,GACd,MAAM,oBAAoB,CAAA"}

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

@@ -0,0 +1,11 @@
+/**
+ * Text Measurer Module
+ *
+ * Provides pixel-accurate text measurement based on display profiles.
+ * All measurements are in actual rendered pixels, not abstract units.
+ */
+// Main class
+export { TextMeasurer } from "./TextMeasurer";
+// Script detection utilities
+export { detectScript, isCJKCharacter, isKoreanCharacter, isUniformWidthScript, isUnsupportedScript, needsHyphenForBreak, SCRIPT_RANGES, } from "./script-detection";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/display/measurer/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAG7C,6BAA6B;AAC7B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,GACd,MAAM,oBAAoB,CAAA","sourcesContent":["/**\n * Text Measurer Module\n *\n * Provides pixel-accurate text measurement based on display profiles.\n * All measurements are in actual rendered pixels, not abstract units.\n */\n\n// Main class\nexport { TextMeasurer } from \"./TextMeasurer\"\nexport type { CharMeasurement, TextMeasurement } from \"./TextMeasurer\"\n\n// Script detection utilities\nexport {\n  detectScript,\n  isCJKCharacter,\n  isKoreanCharacter,\n  isUniformWidthScript,\n  isUnsupportedScript,\n  needsHyphenForBreak,\n  SCRIPT_RANGES,\n} from \"./script-detection\"\n"]}

package/build/utils/display/measurer/script-detection.d.ts

@@ -0,0 +1,53 @@
+import type { ScriptType } from "../profiles/types";
+/**
+ * Unicode ranges for script detection.
+ * Used to classify characters for proper width measurement.
+ */
+export declare const SCRIPT_RANGES: {
+    readonly cjk: readonly [readonly [19968, 40959], readonly [13312, 19903], readonly [131072, 173791], readonly [173824, 177983], readonly [177984, 178207], readonly [63744, 64255]];
+    readonly hiragana: readonly [readonly [12352, 12447]];
+    readonly katakana: readonly [readonly [12448, 12543], readonly [12784, 12799]];
+    readonly korean: readonly [readonly [44032, 55215], readonly [4352, 4607], readonly [12592, 12687], readonly [43360, 43391], readonly [55216, 55295]];
+    readonly cyrillic: readonly [readonly [1024, 1279], readonly [1280, 1327]];
+    readonly numbers: readonly [readonly [48, 57]];
+    readonly punctuation: readonly [readonly [32, 47], readonly [58, 64], readonly [91, 96], readonly [123, 126]];
+    readonly arabic: readonly [readonly [1536, 1791]];
+    readonly hebrew: readonly [readonly [1424, 1535]];
+    readonly thai: readonly [readonly [3584, 3711]];
+    readonly emoji: readonly [readonly [128512, 128591], readonly [127744, 128511], readonly [128640, 128767], readonly [127456, 127487], readonly [9728, 9983], readonly [9984, 10175], readonly [65024, 65039], readonly [129280, 129535]];
+};
+/**
+ * Detect the script type of a single character.
+ *
+ * @param char - Single character to classify
+ * @returns The script type of the character
+ */
+export declare function detectScript(char: string): ScriptType;
+/**
+ * Check if a character is a CJK character (Chinese, Japanese Kanji).
+ * CJK characters can break anywhere without needing a hyphen.
+ */
+export declare function isCJKCharacter(char: string): boolean;
+/**
+ * Check if a character is Korean Hangul.
+ */
+export declare function isKoreanCharacter(char: string): boolean;
+/**
+ * Check if a character is from a uniform-width script.
+ * These scripts render all characters at the same width.
+ */
+export declare function isUniformWidthScript(char: string): boolean;
+/**
+ * Check if a character is from an unsupported script.
+ * These characters may not render correctly on the glasses.
+ */
+export declare function isUnsupportedScript(char: string): boolean;
+/**
+ * Check if breaking between two characters requires a hyphen.
+ * Returns false for:
+ * - Breaking after CJK characters (can break anywhere)
+ * - Breaking before or after spaces
+ * - Breaking after punctuation
+ */
+export declare function needsHyphenForBreak(charBefore: string, charAfter: string): boolean;
+//# sourceMappingURL=script-detection.d.ts.map

package/build/utils/display/measurer/script-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-detection.d.ts","sourceRoot":"","sources":["../../../../src/utils/display/measurer/script-detection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAA;AAEjD;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;CA4DhB,CAAA;AAcV;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CA0DrD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CA6BlF"}

package/build/utils/display/measurer/script-detection.js

@@ -0,0 +1,184 @@
+/**
+ * Unicode ranges for script detection.
+ * Used to classify characters for proper width measurement.
+ */
+export const SCRIPT_RANGES = {
+    // CJK Unified Ideographs
+    cjk: [
+        [0x4e00, 0x9fff], // Main block (common Chinese, Japanese Kanji)
+        [0x3400, 0x4dbf], // Extension A
+        [0x20000, 0x2a6df], // Extension B
+        [0x2a700, 0x2b73f], // Extension C
+        [0x2b740, 0x2b81f], // Extension D
+        [0xf900, 0xfaff], // Compatibility Ideographs
+    ],
+    // Japanese Hiragana
+    hiragana: [[0x3040, 0x309f]],
+    // Japanese Katakana
+    katakana: [
+        [0x30a0, 0x30ff], // Main block
+        [0x31f0, 0x31ff], // Phonetic Extensions
+    ],
+    // Korean
+    korean: [
+        [0xac00, 0xd7af], // Hangul Syllables
+        [0x1100, 0x11ff], // Hangul Jamo
+        [0x3130, 0x318f], // Compatibility Jamo
+        [0xa960, 0xa97f], // Jamo Extended-A
+        [0xd7b0, 0xd7ff], // Jamo Extended-B
+    ],
+    // Cyrillic
+    cyrillic: [
+        [0x0400, 0x04ff], // Main block
+        [0x0500, 0x052f], // Supplement
+    ],
+    // Numbers (ASCII)
+    numbers: [[0x30, 0x39]],
+    // Basic punctuation (ASCII)
+    punctuation: [
+        [0x20, 0x2f], // Space and basic punctuation
+        [0x3a, 0x40], // More punctuation
+        [0x5b, 0x60], // Brackets etc.
+        [0x7b, 0x7e], // Braces etc.
+    ],
+    // Unsupported scripts (for filtering)
+    arabic: [[0x0600, 0x06ff]],
+    hebrew: [[0x0590, 0x05ff]],
+    thai: [[0x0e00, 0x0e7f]],
+    emoji: [
+        [0x1f600, 0x1f64f], // Emoticons
+        [0x1f300, 0x1f5ff], // Misc Symbols and Pictographs
+        [0x1f680, 0x1f6ff], // Transport and Map
+        [0x1f1e0, 0x1f1ff], // Flags
+        [0x2600, 0x26ff], // Misc Symbols
+        [0x2700, 0x27bf], // Dingbats
+        [0xfe00, 0xfe0f], // Variation Selectors
+        [0x1f900, 0x1f9ff], // Supplemental Symbols
+    ],
+};
+/**
+ * Check if a code point is within any of the given ranges.
+ */
+function inRanges(codePoint, ranges) {
+    for (const [start, end] of ranges) {
+        if (codePoint >= start && codePoint <= end) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Detect the script type of a single character.
+ *
+ * @param char - Single character to classify
+ * @returns The script type of the character
+ */
+export function detectScript(char) {
+    if (!char || char.length === 0) {
+        return "latin";
+    }
+    // Get the code point (handles surrogate pairs for characters outside BMP)
+    const codePoint = char.codePointAt(0);
+    if (codePoint === undefined) {
+        return "latin";
+    }
+    // Check each script in order of likelihood/importance
+    // CJK (most common for multi-byte)
+    if (inRanges(codePoint, SCRIPT_RANGES.cjk)) {
+        return "cjk";
+    }
+    // Japanese kana
+    if (inRanges(codePoint, SCRIPT_RANGES.hiragana)) {
+        return "hiragana";
+    }
+    if (inRanges(codePoint, SCRIPT_RANGES.katakana)) {
+        return "katakana";
+    }
+    // Korean
+    if (inRanges(codePoint, SCRIPT_RANGES.korean)) {
+        return "korean";
+    }
+    // Cyrillic
+    if (inRanges(codePoint, SCRIPT_RANGES.cyrillic)) {
+        return "cyrillic";
+    }
+    // Numbers
+    if (inRanges(codePoint, SCRIPT_RANGES.numbers)) {
+        return "numbers";
+    }
+    // Punctuation
+    if (inRanges(codePoint, SCRIPT_RANGES.punctuation)) {
+        return "punctuation";
+    }
+    // Unsupported scripts
+    if (inRanges(codePoint, SCRIPT_RANGES.arabic) ||
+        inRanges(codePoint, SCRIPT_RANGES.hebrew) ||
+        inRanges(codePoint, SCRIPT_RANGES.thai) ||
+        inRanges(codePoint, SCRIPT_RANGES.emoji)) {
+        return "unsupported";
+    }
+    // Default to Latin for ASCII letters and anything else
+    return "latin";
+}
+/**
+ * Check if a character is a CJK character (Chinese, Japanese Kanji).
+ * CJK characters can break anywhere without needing a hyphen.
+ */
+export function isCJKCharacter(char) {
+    const script = detectScript(char);
+    return script === "cjk" || script === "hiragana" || script === "katakana";
+}
+/**
+ * Check if a character is Korean Hangul.
+ */
+export function isKoreanCharacter(char) {
+    return detectScript(char) === "korean";
+}
+/**
+ * Check if a character is from a uniform-width script.
+ * These scripts render all characters at the same width.
+ */
+export function isUniformWidthScript(char) {
+    const script = detectScript(char);
+    return (script === "cjk" || script === "hiragana" || script === "katakana" || script === "korean" || script === "cyrillic");
+}
+/**
+ * Check if a character is from an unsupported script.
+ * These characters may not render correctly on the glasses.
+ */
+export function isUnsupportedScript(char) {
+    return detectScript(char) === "unsupported";
+}
+/**
+ * Check if breaking between two characters requires a hyphen.
+ * Returns false for:
+ * - Breaking after CJK characters (can break anywhere)
+ * - Breaking before or after spaces
+ * - Breaking after punctuation
+ */
+export function needsHyphenForBreak(charBefore, charAfter) {
+    // No hyphen needed after CJK (can break anywhere)
+    if (isCJKCharacter(charBefore)) {
+        return false;
+    }
+    // No hyphen needed before CJK
+    if (isCJKCharacter(charAfter)) {
+        return false;
+    }
+    // No hyphen needed after space
+    if (charBefore === " " || charBefore === "\t") {
+        return false;
+    }
+    // No hyphen needed before space (the space is a natural break point)
+    if (charAfter === " " || charAfter === "\t") {
+        return false;
+    }
+    // No hyphen needed after existing punctuation that serves as break
+    const breakPunctuation = ["-", "–", "—", "/", "\\", "|"];
+    if (breakPunctuation.includes(charBefore)) {
+        return false;
+    }
+    // Default: hyphen is needed for mid-word Latin breaks
+    return true;
+}
+//# sourceMappingURL=script-detection.js.map

package/build/utils/display/measurer/script-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-detection.js","sourceRoot":"","sources":["../../../../src/utils/display/measurer/script-detection.ts"],"names":[],"mappings":"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","sourcesContent":["import type {ScriptType} from \"../profiles/types\"\n\n/**\n * Unicode ranges for script detection.\n * Used to classify characters for proper width measurement.\n */\nexport const SCRIPT_RANGES = {\n  // CJK Unified Ideographs\n  cjk: [\n    [0x4e00, 0x9fff], // Main block (common Chinese, Japanese Kanji)\n    [0x3400, 0x4dbf], // Extension A\n    [0x20000, 0x2a6df], // Extension B\n    [0x2a700, 0x2b73f], // Extension C\n    [0x2b740, 0x2b81f], // Extension D\n    [0xf900, 0xfaff], // Compatibility Ideographs\n  ] as const,\n\n  // Japanese Hiragana\n  hiragana: [[0x3040, 0x309f]] as const,\n\n  // Japanese Katakana\n  katakana: [\n    [0x30a0, 0x30ff], // Main block\n    [0x31f0, 0x31ff], // Phonetic Extensions\n  ] as const,\n\n  // Korean\n  korean: [\n    [0xac00, 0xd7af], // Hangul Syllables\n    [0x1100, 0x11ff], // Hangul Jamo\n    [0x3130, 0x318f], // Compatibility Jamo\n    [0xa960, 0xa97f], // Jamo Extended-A\n    [0xd7b0, 0xd7ff], // Jamo Extended-B\n  ] as const,\n\n  // Cyrillic\n  cyrillic: [\n    [0x0400, 0x04ff], // Main block\n    [0x0500, 0x052f], // Supplement\n  ] as const,\n\n  // Numbers (ASCII)\n  numbers: [[0x30, 0x39]] as const,\n\n  // Basic punctuation (ASCII)\n  punctuation: [\n    [0x20, 0x2f], // Space and basic punctuation\n    [0x3a, 0x40], // More punctuation\n    [0x5b, 0x60], // Brackets etc.\n    [0x7b, 0x7e], // Braces etc.\n  ] as const,\n\n  // Unsupported scripts (for filtering)\n  arabic: [[0x0600, 0x06ff]] as const,\n  hebrew: [[0x0590, 0x05ff]] as const,\n  thai: [[0x0e00, 0x0e7f]] as const,\n  emoji: [\n    [0x1f600, 0x1f64f], // Emoticons\n    [0x1f300, 0x1f5ff], // Misc Symbols and Pictographs\n    [0x1f680, 0x1f6ff], // Transport and Map\n    [0x1f1e0, 0x1f1ff], // Flags\n    [0x2600, 0x26ff], // Misc Symbols\n    [0x2700, 0x27bf], // Dingbats\n    [0xfe00, 0xfe0f], // Variation Selectors\n    [0x1f900, 0x1f9ff], // Supplemental Symbols\n  ] as const,\n} as const\n\n/**\n * Check if a code point is within any of the given ranges.\n */\nfunction inRanges(codePoint: number, ranges: readonly (readonly [number, number])[]): boolean {\n  for (const [start, end] of ranges) {\n    if (codePoint >= start && codePoint <= end) {\n      return true\n    }\n  }\n  return false\n}\n\n/**\n * Detect the script type of a single character.\n *\n * @param char - Single character to classify\n * @returns The script type of the character\n */\nexport function detectScript(char: string): ScriptType {\n  if (!char || char.length === 0) {\n    return \"latin\"\n  }\n\n  // Get the code point (handles surrogate pairs for characters outside BMP)\n  const codePoint = char.codePointAt(0)\n  if (codePoint === undefined) {\n    return \"latin\"\n  }\n\n  // Check each script in order of likelihood/importance\n\n  // CJK (most common for multi-byte)\n  if (inRanges(codePoint, SCRIPT_RANGES.cjk)) {\n    return \"cjk\"\n  }\n\n  // Japanese kana\n  if (inRanges(codePoint, SCRIPT_RANGES.hiragana)) {\n    return \"hiragana\"\n  }\n  if (inRanges(codePoint, SCRIPT_RANGES.katakana)) {\n    return \"katakana\"\n  }\n\n  // Korean\n  if (inRanges(codePoint, SCRIPT_RANGES.korean)) {\n    return \"korean\"\n  }\n\n  // Cyrillic\n  if (inRanges(codePoint, SCRIPT_RANGES.cyrillic)) {\n    return \"cyrillic\"\n  }\n\n  // Numbers\n  if (inRanges(codePoint, SCRIPT_RANGES.numbers)) {\n    return \"numbers\"\n  }\n\n  // Punctuation\n  if (inRanges(codePoint, SCRIPT_RANGES.punctuation)) {\n    return \"punctuation\"\n  }\n\n  // Unsupported scripts\n  if (\n    inRanges(codePoint, SCRIPT_RANGES.arabic) ||\n    inRanges(codePoint, SCRIPT_RANGES.hebrew) ||\n    inRanges(codePoint, SCRIPT_RANGES.thai) ||\n    inRanges(codePoint, SCRIPT_RANGES.emoji)\n  ) {\n    return \"unsupported\"\n  }\n\n  // Default to Latin for ASCII letters and anything else\n  return \"latin\"\n}\n\n/**\n * Check if a character is a CJK character (Chinese, Japanese Kanji).\n * CJK characters can break anywhere without needing a hyphen.\n */\nexport function isCJKCharacter(char: string): boolean {\n  const script = detectScript(char)\n  return script === \"cjk\" || script === \"hiragana\" || script === \"katakana\"\n}\n\n/**\n * Check if a character is Korean Hangul.\n */\nexport function isKoreanCharacter(char: string): boolean {\n  return detectScript(char) === \"korean\"\n}\n\n/**\n * Check if a character is from a uniform-width script.\n * These scripts render all characters at the same width.\n */\nexport function isUniformWidthScript(char: string): boolean {\n  const script = detectScript(char)\n  return (\n    script === \"cjk\" || script === \"hiragana\" || script === \"katakana\" || script === \"korean\" || script === \"cyrillic\"\n  )\n}\n\n/**\n * Check if a character is from an unsupported script.\n * These characters may not render correctly on the glasses.\n */\nexport function isUnsupportedScript(char: string): boolean {\n  return detectScript(char) === \"unsupported\"\n}\n\n/**\n * Check if breaking between two characters requires a hyphen.\n * Returns false for:\n * - Breaking after CJK characters (can break anywhere)\n * - Breaking before or after spaces\n * - Breaking after punctuation\n */\nexport function needsHyphenForBreak(charBefore: string, charAfter: string): boolean {\n  // No hyphen needed after CJK (can break anywhere)\n  if (isCJKCharacter(charBefore)) {\n    return false\n  }\n\n  // No hyphen needed before CJK\n  if (isCJKCharacter(charAfter)) {\n    return false\n  }\n\n  // No hyphen needed after space\n  if (charBefore === \" \" || charBefore === \"\\t\") {\n    return false\n  }\n\n  // No hyphen needed before space (the space is a natural break point)\n  if (charAfter === \" \" || charAfter === \"\\t\") {\n    return false\n  }\n\n  // No hyphen needed after existing punctuation that serves as break\n  const breakPunctuation = [\"-\", \"–\", \"—\", \"/\", \"\\\\\", \"|\"]\n  if (breakPunctuation.includes(charBefore)) {\n    return false\n  }\n\n  // Default: hyphen is needed for mid-word Latin breaks\n  return true\n}\n"]}

package/build/utils/display/profiles/g1.d.ts

@@ -0,0 +1,33 @@
+import { DisplayProfile } from "./types";
+/**
+ * Even Realities G1 Smart Glasses Display Profile
+ *
+ * Verified through empirical testing with actual hardware.
+ * See: line-width-debug-tool/line-width-spec.md
+ */
+export declare const G1_PROFILE: DisplayProfile;
+/**
+ * G1 Profile for LEGACY mobile clients that have their own wrapping logic.
+ *
+ * Old mobile clients re-wrap text received from the cloud, causing double-wrapping.
+ * This profile uses a reduced display width (~522px instead of 576px) so that
+ * when the mobile client re-wraps, the result still fits within 5 lines.
+ *
+ * Use this profile when:
+ * - Mobile client version < X.X.X (has old wrapping logic)
+ * - You see text getting cut off or exceeding 5 lines
+ *
+ * Once all clients are updated, this can be deprecated.
+ */
+export declare const G1_PROFILE_LEGACY: DisplayProfile;
+/**
+ * Get the hyphen width for G1 in rendered pixels.
+ * Hyphen glyph = 4px → rendered = (4+1)*2 = 10px
+ */
+export declare const G1_HYPHEN_WIDTH_PX = 10;
+/**
+ * Get the space width for G1 in rendered pixels.
+ * Space glyph = 2px → rendered = (2+1)*2 = 6px
+ */
+export declare const G1_SPACE_WIDTH_PX = 6;
+//# sourceMappingURL=g1.d.ts.map

package/build/utils/display/profiles/g1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"g1.d.ts","sourceRoot":"","sources":["../../../../src/utils/display/profiles/g1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,SAAS,CAAA;AAsHtC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,cAgDxB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,EAAE,cAoC/B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAA;AAEpC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAA"}

package/build/utils/display/profiles/g1.js

@@ -0,0 +1,213 @@
+/**
+ * Complete G1 glyph widths from G1FontLoaderKt
+ * These are GLYPH widths - multiply using renderFormula to get rendered pixels.
+ * Rendered width = (glyphWidth + 1) * 2
+ */
+const G1_GLYPH_WIDTHS = {
+    // Punctuation & Symbols
+    " ": 2,
+    "!": 1,
+    '"': 2,
+    "#": 6,
+    "$": 5,
+    "%": 6,
+    "&": 7,
+    "'": 1,
+    "(": 2,
+    ")": 2,
+    "*": 3,
+    "+": 4,
+    ",": 1,
+    "-": 4, // Hyphen: 4px glyph → 10px rendered (CRITICAL for breaking!)
+    ".": 1,
+    "/": 3,
+    // Numbers
+    "0": 5,
+    "1": 3,
+    "2": 5,
+    "3": 5,
+    "4": 5,
+    "5": 5,
+    "6": 5,
+    "7": 5,
+    "8": 5,
+    "9": 5,
+    // More punctuation
+    ":": 1,
+    ";": 1,
+    "<": 4,
+    "=": 4,
+    ">": 4,
+    "?": 5,
+    "@": 7,
+    // Uppercase
+    "A": 6,
+    "B": 5,
+    "C": 5,
+    "D": 5,
+    "E": 4,
+    "F": 4,
+    "G": 5,
+    "H": 5,
+    "I": 2,
+    "J": 3,
+    "K": 5,
+    "L": 4,
+    "M": 7,
+    "N": 5,
+    "O": 5,
+    "P": 5,
+    "Q": 5,
+    "R": 5,
+    "S": 5,
+    "T": 5,
+    "U": 5,
+    "V": 6,
+    "W": 7,
+    "X": 6,
+    "Y": 6,
+    "Z": 5,
+    // Brackets & special
+    "[": 2,
+    "\\": 3,
+    "]": 2,
+    "^": 4,
+    "_": 3,
+    "`": 2,
+    // Lowercase
+    "a": 5,
+    "b": 4,
+    "c": 4,
+    "d": 4,
+    "e": 4,
+    "f": 4,
+    "g": 4,
+    "h": 4,
+    "i": 1,
+    "j": 2,
+    "k": 4,
+    "l": 1,
+    "m": 7,
+    "n": 4,
+    "o": 4,
+    "p": 4,
+    "q": 4,
+    "r": 3,
+    "s": 4,
+    "t": 3,
+    "u": 5,
+    "v": 5,
+    "w": 7,
+    "x": 5,
+    "y": 5,
+    "z": 4,
+    // More special
+    "{": 3,
+    "|": 1,
+    "}": 3,
+    "~": 7,
+};
+/**
+ * Even Realities G1 Smart Glasses Display Profile
+ *
+ * Verified through empirical testing with actual hardware.
+ * See: line-width-debug-tool/line-width-spec.md
+ */
+export const G1_PROFILE = {
+    id: "even-realities-g1",
+    name: "Even Realities G1",
+    // Display dimensions
+    displayWidthPx: 576,
+    maxLines: 5,
+    // BLE constraints
+    maxPayloadBytes: 390,
+    bleChunkSize: 176,
+    // Font metrics
+    fontMetrics: {
+        // Glyph widths from G1FontLoaderKt
+        glyphWidths: new Map(Object.entries(G1_GLYPH_WIDTHS)),
+        // Default glyph width for unmapped Latin characters (use max to be safe)
+        defaultGlyphWidth: 7,
+        // Rendered width = (glyphWidth + 1) * 2
+        renderFormula: (glyphWidth) => (glyphWidth + 1) * 2,
+        // Uniform-width scripts - ALL characters in these scripts render at this exact width
+        // These are verified values in RENDERED pixels, NOT averages
+        uniformScripts: {
+            cjk: 18, // ALL Chinese/Japanese Kanji chars = 18px (verified)
+            hiragana: 18, // ALL Hiragana chars = 18px (verified)
+            katakana: 18, // ALL Katakana chars = 18px (verified)
+            korean: 24, // ALL Korean Hangul chars = 24px (verified)
+            cyrillic: 18, // ALL Cyrillic chars = 18px (verified)
+        },
+        // Fallback for unmapped Latin characters
+        // Uses MAX width to guarantee no overflow (safe under-utilization)
+        fallback: {
+            latinMaxWidth: 16, // Max Latin = 'm', 'w' at (7+1)*2 = 16px
+            unknownBehavior: "useLatinMax",
+        },
+    },
+    constraints: {
+        minCharsBeforeHyphen: 3,
+        // Kinsoku: Characters that should not appear at start of line
+        noStartChars: [".", ",", "!", "?", ":", ";", ")", "]", "}", "。", "，", "！", "？", "：", "；", "）", "】", "」"],
+        // Kinsoku: Characters that should not appear at end of line
+        noEndChars: ["(", "[", "{", "（", "【", "「"],
+    },
+};
+/**
+ * G1 Profile for LEGACY mobile clients that have their own wrapping logic.
+ *
+ * Old mobile clients re-wrap text received from the cloud, causing double-wrapping.
+ * This profile uses a reduced display width (~522px instead of 576px) so that
+ * when the mobile client re-wraps, the result still fits within 5 lines.
+ *
+ * Use this profile when:
+ * - Mobile client version < X.X.X (has old wrapping logic)
+ * - You see text getting cut off or exceeding 5 lines
+ *
+ * Once all clients are updated, this can be deprecated.
+ */
+export const G1_PROFILE_LEGACY = {
+    id: "even-realities-g1-legacy",
+    name: "Even Realities G1 (Legacy Client Compatibility)",
+    // Reduced display width to prevent double-wrapping overflow
+    // Old mobile client wraps at ~90% of true width
+    displayWidthPx: 420,
+    maxLines: 5,
+    // BLE constraints (same as standard)
+    maxPayloadBytes: 390,
+    bleChunkSize: 176,
+    // Font metrics (same as standard)
+    fontMetrics: {
+        glyphWidths: new Map(Object.entries(G1_GLYPH_WIDTHS)),
+        defaultGlyphWidth: 7,
+        renderFormula: (glyphWidth) => (glyphWidth + 1) * 2,
+        uniformScripts: {
+            cjk: 18,
+            hiragana: 18,
+            katakana: 18,
+            korean: 24,
+            cyrillic: 18,
+        },
+        fallback: {
+            latinMaxWidth: 16,
+            unknownBehavior: "useLatinMax",
+        },
+    },
+    constraints: {
+        minCharsBeforeHyphen: 3,
+        noStartChars: [".", ",", "!", "?", ":", ";", ")", "]", "}", "。", "，", "！", "？", "：", "；", "）", "】", "」"],
+        noEndChars: ["(", "[", "{", "（", "【", "「"],
+    },
+};
+/**
+ * Get the hyphen width for G1 in rendered pixels.
+ * Hyphen glyph = 4px → rendered = (4+1)*2 = 10px
+ */
+export const G1_HYPHEN_WIDTH_PX = 10;
+/**
+ * Get the space width for G1 in rendered pixels.
+ * Space glyph = 2px → rendered = (2+1)*2 = 6px
+ */
+export const G1_SPACE_WIDTH_PX = 6;
+//# sourceMappingURL=g1.js.map

package/build/utils/display/profiles/g1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"g1.js","sourceRoot":"","sources":["../../../../src/utils/display/profiles/g1.ts"],"names":[],"mappings":"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","sourcesContent":["import {DisplayProfile} from \"./types\"\n\n/**\n * Complete G1 glyph widths from G1FontLoaderKt\n * These are GLYPH widths - multiply using renderFormula to get rendered pixels.\n * Rendered width = (glyphWidth + 1) * 2\n */\nconst G1_GLYPH_WIDTHS: Record<string, number> = {\n  // Punctuation & Symbols\n  \" \": 2,\n  \"!\": 1,\n  '\"': 2,\n  \"#\": 6,\n  \"$\": 5,\n  \"%\": 6,\n  \"&\": 7,\n  \"'\": 1,\n  \"(\": 2,\n  \")\": 2,\n  \"*\": 3,\n  \"+\": 4,\n  \",\": 1,\n  \"-\": 4, // Hyphen: 4px glyph → 10px rendered (CRITICAL for breaking!)\n  \".\": 1,\n  \"/\": 3,\n\n  // Numbers\n  \"0\": 5,\n  \"1\": 3,\n  \"2\": 5,\n  \"3\": 5,\n  \"4\": 5,\n  \"5\": 5,\n  \"6\": 5,\n  \"7\": 5,\n  \"8\": 5,\n  \"9\": 5,\n\n  // More punctuation\n  \":\": 1,\n  \";\": 1,\n  \"<\": 4,\n  \"=\": 4,\n  \">\": 4,\n  \"?\": 5,\n  \"@\": 7,\n\n  // Uppercase\n  \"A\": 6,\n  \"B\": 5,\n  \"C\": 5,\n  \"D\": 5,\n  \"E\": 4,\n  \"F\": 4,\n  \"G\": 5,\n  \"H\": 5,\n  \"I\": 2,\n  \"J\": 3,\n  \"K\": 5,\n  \"L\": 4,\n  \"M\": 7,\n  \"N\": 5,\n  \"O\": 5,\n  \"P\": 5,\n  \"Q\": 5,\n  \"R\": 5,\n  \"S\": 5,\n  \"T\": 5,\n  \"U\": 5,\n  \"V\": 6,\n  \"W\": 7,\n  \"X\": 6,\n  \"Y\": 6,\n  \"Z\": 5,\n\n  // Brackets & special\n  \"[\": 2,\n  \"\\\\\": 3,\n  \"]\": 2,\n  \"^\": 4,\n  \"_\": 3,\n  \"`\": 2,\n\n  // Lowercase\n  \"a\": 5,\n  \"b\": 4,\n  \"c\": 4,\n  \"d\": 4,\n  \"e\": 4,\n  \"f\": 4,\n  \"g\": 4,\n  \"h\": 4,\n  \"i\": 1,\n  \"j\": 2,\n  \"k\": 4,\n  \"l\": 1,\n  \"m\": 7,\n  \"n\": 4,\n  \"o\": 4,\n  \"p\": 4,\n  \"q\": 4,\n  \"r\": 3,\n  \"s\": 4,\n  \"t\": 3,\n  \"u\": 5,\n  \"v\": 5,\n  \"w\": 7,\n  \"x\": 5,\n  \"y\": 5,\n  \"z\": 4,\n\n  // More special\n  \"{\": 3,\n  \"|\": 1,\n  \"}\": 3,\n  \"~\": 7,\n}\n\n/**\n * Even Realities G1 Smart Glasses Display Profile\n *\n * Verified through empirical testing with actual hardware.\n * See: line-width-debug-tool/line-width-spec.md\n */\nexport const G1_PROFILE: DisplayProfile = {\n  id: \"even-realities-g1\",\n  name: \"Even Realities G1\",\n\n  // Display dimensions\n  displayWidthPx: 576,\n  maxLines: 5,\n\n  // BLE constraints\n  maxPayloadBytes: 390,\n  bleChunkSize: 176,\n\n  // Font metrics\n  fontMetrics: {\n    // Glyph widths from G1FontLoaderKt\n    glyphWidths: new Map(Object.entries(G1_GLYPH_WIDTHS)),\n\n    // Default glyph width for unmapped Latin characters (use max to be safe)\n    defaultGlyphWidth: 7,\n\n    // Rendered width = (glyphWidth + 1) * 2\n    renderFormula: (glyphWidth: number) => (glyphWidth + 1) * 2,\n\n    // Uniform-width scripts - ALL characters in these scripts render at this exact width\n    // These are verified values in RENDERED pixels, NOT averages\n    uniformScripts: {\n      cjk: 18, // ALL Chinese/Japanese Kanji chars = 18px (verified)\n      hiragana: 18, // ALL Hiragana chars = 18px (verified)\n      katakana: 18, // ALL Katakana chars = 18px (verified)\n      korean: 24, // ALL Korean Hangul chars = 24px (verified)\n      cyrillic: 18, // ALL Cyrillic chars = 18px (verified)\n    },\n\n    // Fallback for unmapped Latin characters\n    // Uses MAX width to guarantee no overflow (safe under-utilization)\n    fallback: {\n      latinMaxWidth: 16, // Max Latin = 'm', 'w' at (7+1)*2 = 16px\n      unknownBehavior: \"useLatinMax\",\n    },\n  },\n\n  constraints: {\n    minCharsBeforeHyphen: 3,\n    // Kinsoku: Characters that should not appear at start of line\n    noStartChars: [\".\", \",\", \"!\", \"?\", \":\", \";\", \")\", \"]\", \"}\", \"。\", \"，\", \"！\", \"？\", \"：\", \"；\", \"）\", \"】\", \"」\"],\n    // Kinsoku: Characters that should not appear at end of line\n    noEndChars: [\"(\", \"[\", \"{\", \"（\", \"【\", \"「\"],\n  },\n}\n\n/**\n * G1 Profile for LEGACY mobile clients that have their own wrapping logic.\n *\n * Old mobile clients re-wrap text received from the cloud, causing double-wrapping.\n * This profile uses a reduced display width (~522px instead of 576px) so that\n * when the mobile client re-wraps, the result still fits within 5 lines.\n *\n * Use this profile when:\n * - Mobile client version < X.X.X (has old wrapping logic)\n * - You see text getting cut off or exceeding 5 lines\n *\n * Once all clients are updated, this can be deprecated.\n */\nexport const G1_PROFILE_LEGACY: DisplayProfile = {\n  id: \"even-realities-g1-legacy\",\n  name: \"Even Realities G1 (Legacy Client Compatibility)\",\n\n  // Reduced display width to prevent double-wrapping overflow\n  // Old mobile client wraps at ~90% of true width\n  displayWidthPx: 420,\n  maxLines: 5,\n\n  // BLE constraints (same as standard)\n  maxPayloadBytes: 390,\n  bleChunkSize: 176,\n\n  // Font metrics (same as standard)\n  fontMetrics: {\n    glyphWidths: new Map(Object.entries(G1_GLYPH_WIDTHS)),\n    defaultGlyphWidth: 7,\n    renderFormula: (glyphWidth: number) => (glyphWidth + 1) * 2,\n    uniformScripts: {\n      cjk: 18,\n      hiragana: 18,\n      katakana: 18,\n      korean: 24,\n      cyrillic: 18,\n    },\n    fallback: {\n      latinMaxWidth: 16,\n      unknownBehavior: \"useLatinMax\",\n    },\n  },\n\n  constraints: {\n    minCharsBeforeHyphen: 3,\n    noStartChars: [\".\", \",\", \"!\", \"?\", \":\", \";\", \")\", \"]\", \"}\", \"。\", \"，\", \"！\", \"？\", \"：\", \"；\", \"）\", \"】\", \"」\"],\n    noEndChars: [\"(\", \"[\", \"{\", \"（\", \"【\", \"「\"],\n  },\n}\n\n/**\n * Get the hyphen width for G1 in rendered pixels.\n * Hyphen glyph = 4px → rendered = (4+1)*2 = 10px\n */\nexport const G1_HYPHEN_WIDTH_PX = 10\n\n/**\n * Get the space width for G1 in rendered pixels.\n * Space glyph = 2px → rendered = (2+1)*2 = 6px\n */\nexport const G1_SPACE_WIDTH_PX = 6\n"]}

package/build/utils/display/profiles/g2.d.ts

@@ -0,0 +1,13 @@
+import { DisplayProfile } from "./types";
+export declare const G2_PROFILE: DisplayProfile;
+/**
+ * Get the hyphen width for G2 in rendered pixels.
+ * Same as G1: Hyphen glyph = 4px → rendered = (4+1)*2 = 10px
+ */
+export declare const G2_HYPHEN_WIDTH_PX = 10;
+/**
+ * Get the space width for G2 in rendered pixels.
+ * Same as G1: Space glyph = 2px → rendered = (2+1)*2 = 6px
+ */
+export declare const G2_SPACE_WIDTH_PX = 6;
+//# sourceMappingURL=g2.d.ts.map

package/build/utils/display/profiles/g2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"g2.d.ts","sourceRoot":"","sources":["../../../../src/utils/display/profiles/g2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,SAAS,CAAA;AActC,eAAO,MAAM,UAAU,EAAE,cAYxB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAA;AAEpC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAA"}