@mentra/engine 3.1.0-dev.10 → 3.1.0-dev.102

package/build/utils/display/composer/ColumnComposer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ColumnComposer.js","sourceRoot":"","sources":["../../../../src/utils/display/composer/ColumnComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA+CrD,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAc;IACjB,OAAO,CAAiB;IACxB,QAAQ,CAAe;IACvB,OAAO,CAAc;IACrB,YAAY,CAAS;IAE7B,YAAY,OAAuB,EAAE,YAAuB,qBAAqB;QAC/E,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC5C,SAAS;SACV,CAAC,CAAC;QAEH,+CAA+C;QAC/C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E;;;;;;;;;;OAUG;IACI,qBAAqB,CAAC,QAAgB,EAAE,SAAiB,EAAE,UAA0B,EAAE;QAC5F,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAE1D,iCAAiC;QACjC,MAAM,eAAe,GAAgB;YACnC,UAAU,EAAE,MAAM,CAAC,iBAAiB;YACpC,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;QAEF,MAAM,gBAAgB,GAAgB;YACpC,UAAU,EAAE,MAAM,CAAC,kBAAkB;YACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAEzE,8CAA8C;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAErE,qCAAqC;QACrC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAEtE,OAAO;YACL,YAAY;YACZ,SAAS;YACT,UAAU;YACV,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,sBAAsB;QAC3B,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,SAAoB;QACtC,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC5C,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAE9E;;OAEG;IACK,eAAe,CAAC,SAAiC;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;QAEjD,2DAA2D;QAC3D,iDAAiD;QACjD,MAAM,QAAQ,GAAiB;YAC7B,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC;YACjD,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;YACnD,kBAAkB,EAAE,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;YAClE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC/B,gBAAgB,EAAE,CAAC;SACpB,CAAC;QAEF,OAAO;YACL,GAAG,QAAQ;YACX,GAAG,SAAS;SACb,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,KAAe,EAAE,KAAa;QAC7C,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QAC1B,OAAO,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACK,YAAY,CAAC,SAAmB,EAAE,UAAoB,EAAE,MAAoB;QAClF,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAE1D,qCAAqC;YACrC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAExD,0DAA0D;YAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC;YAE9F,wBAAwB;YACxB,IAAI,IAAI,GAAG,EAAE,CAAC;YAEd,gCAAgC;YAChC,IAAI,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;gBAC3D,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC9C,CAAC;YAED,IAAI,IAAI,QAAQ,CAAC;YACjB,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,IAAI,SAAS,CAAC;YAElB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACK,2BAA2B,CAAC,cAAsB,EAAE,gBAAwB;QAClF,MAAM,YAAY,GAAG,gBAAgB,GAAG,cAAc,CAAC;QAEvD,2CAA2C;QAC3C,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,CAAC;QACX,CAAC;QAED,wEAAwE;QACxE,wEAAwE;QACxE,wEAAwE;QACxE,wEAAwE;QACxE,wBAAwB;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAEzE,yDAAyD;QACzD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACK,aAAa,CAAC,IAAY;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC;CACF;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAuB,EAAE,YAAuB,MAAM;IACzF,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC","sourcesContent":["/**\n * ColumnComposer\n *\n * Handles composition of multi-column layouts like double_text_wall.\n * This is the single source of truth for column layout logic, replacing\n * the duplicate implementations in native iOS (G1Text.swift) and\n * Android (G1Text.kt, G1.java).\n *\n * The composer:\n * 1. Wraps each column's text to its allocated width\n * 2. Merges columns line-by-line with pixel-precise space padding\n * 3. Returns a single pre-composed string ready for native to chunk & send\n *\n * @see cloud/issues/026-mobile-display-processor for design docs\n */\n\nimport type { DisplayProfile } from \"../profiles/types\";\nimport { TextMeasurer } from \"../measurer/TextMeasurer\";\nimport { TextWrapper } from \"../wrapper/TextWrapper\";\nimport type { WrapOptions, BreakMode } from \"../wrapper/types\";\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Configuration for column layout\n */\nexport interface ColumnConfig {\n  /** Width of the left column in pixels */\n  leftColumnWidthPx: number;\n  /** X position where the right column starts in pixels */\n  rightColumnStartPx: number;\n  /** Width of the right column in pixels (calculated from start position) */\n  rightColumnWidthPx: number;\n  /** Maximum number of lines to display */\n  maxLines: number;\n  /** Left margin in spaces (for indentation) */\n  leftMarginSpaces?: number;\n}\n\n/**\n * Options for composing double text wall\n */\nexport interface ComposeOptions {\n  /** Break mode for text wrapping */\n  breakMode?: BreakMode;\n  /** Custom column configuration (overrides profile defaults) */\n  columnConfig?: Partial<ColumnConfig>;\n}\n\n/**\n * Result of column composition\n */\nexport interface ComposeResult {\n  /** The fully composed text with both columns merged */\n  composedText: string;\n  /** Lines from the left column (for debugging/preview) */\n  leftLines: string[];\n  /** Lines from the right column (for debugging/preview) */\n  rightLines: string[];\n  /** The column configuration that was used */\n  config: ColumnConfig;\n}\n\n// =============================================================================\n// ColumnComposer Class\n// =============================================================================\n\n/**\n * Composes multi-column layouts for smart glasses displays.\n *\n * Usage:\n * ```typescript\n * const composer = new ColumnComposer(G1_PROFILE)\n * const result = composer.composeDoubleTextWall(\"Left content\", \"Right content\")\n * // result.composedText is ready to send to native SGC\n * ```\n */\nexport class ColumnComposer {\n  private profile: DisplayProfile;\n  private measurer: TextMeasurer;\n  private wrapper: TextWrapper;\n  private spaceWidthPx: number;\n\n  constructor(profile: DisplayProfile, breakMode: BreakMode = \"character-no-hyphen\") {\n    this.profile = profile;\n    this.measurer = new TextMeasurer(profile);\n    this.wrapper = new TextWrapper(this.measurer, {\n      breakMode,\n    });\n\n    // Cache space width for alignment calculations\n    this.spaceWidthPx = this.measurer.measureText(\" \");\n  }\n\n  // ===========================================================================\n  // Public API\n  // ===========================================================================\n\n  /**\n   * Compose a double text wall layout.\n   *\n   * Takes left and right text, wraps each to their column width,\n   * and merges them with pixel-precise space alignment.\n   *\n   * @param leftText - Text for the left column\n   * @param rightText - Text for the right column\n   * @param options - Optional composition settings\n   * @returns Composed result with merged text and metadata\n   */\n  public composeDoubleTextWall(leftText: string, rightText: string, options: ComposeOptions = {}): ComposeResult {\n    const config = this.getColumnConfig(options.columnConfig);\n\n    // Wrap each column independently\n    const leftWrapOptions: WrapOptions = {\n      maxWidthPx: config.leftColumnWidthPx,\n      maxLines: config.maxLines,\n    };\n\n    const rightWrapOptions: WrapOptions = {\n      maxWidthPx: config.rightColumnWidthPx,\n      maxLines: config.maxLines,\n    };\n\n    const leftResult = this.wrapper.wrap(leftText || \"\", leftWrapOptions);\n    const rightResult = this.wrapper.wrap(rightText || \"\", rightWrapOptions);\n\n    // Pad arrays to have exactly maxLines entries\n    const leftLines = this.padLines(leftResult.lines, config.maxLines);\n    const rightLines = this.padLines(rightResult.lines, config.maxLines);\n\n    // Merge columns with space alignment\n    const composedText = this.mergeColumns(leftLines, rightLines, config);\n\n    return {\n      composedText,\n      leftLines,\n      rightLines,\n      config,\n    };\n  }\n\n  /**\n   * Get the default column configuration for the current profile.\n   */\n  public getDefaultColumnConfig(): ColumnConfig {\n    return this.getColumnConfig();\n  }\n\n  /**\n   * Update the break mode for text wrapping.\n   */\n  public setBreakMode(breakMode: BreakMode): void {\n    this.wrapper = new TextWrapper(this.measurer, {\n      breakMode,\n    });\n  }\n\n  // ===========================================================================\n  // Private Methods\n  // ===========================================================================\n\n  /**\n   * Get column configuration, merging defaults with overrides.\n   */\n  private getColumnConfig(overrides?: Partial<ColumnConfig>): ColumnConfig {\n    const displayWidth = this.profile.displayWidthPx;\n\n    // Default layout: 50% for left column, right starts at 55%\n    // This matches the native G1Text implementations\n    const defaults: ColumnConfig = {\n      leftColumnWidthPx: Math.floor(displayWidth * 0.5),\n      rightColumnStartPx: Math.floor(displayWidth * 0.55),\n      rightColumnWidthPx: displayWidth - Math.floor(displayWidth * 0.55),\n      maxLines: this.profile.maxLines,\n      leftMarginSpaces: 0,\n    };\n\n    return {\n      ...defaults,\n      ...overrides,\n    };\n  }\n\n  /**\n   * Pad lines array to exactly `count` entries.\n   */\n  private padLines(lines: string[], count: number): string[] {\n    const result = [...lines];\n    while (result.length < count) {\n      result.push(\"\");\n    }\n    return result.slice(0, count);\n  }\n\n  /**\n   * Merge left and right columns with pixel-precise space alignment.\n   *\n   * For each line:\n   * 1. Take the left column text\n   * 2. Calculate its pixel width\n   * 3. Calculate how many spaces needed to reach rightColumnStartPx\n   * 4. Append spaces and right column text\n   */\n  private mergeColumns(leftLines: string[], rightLines: string[], config: ColumnConfig): string {\n    const lines: string[] = [];\n\n    for (let i = 0; i < config.maxLines; i++) {\n      const leftText = this.cleanEnspaces(leftLines[i] || \"\");\n      const rightText = this.cleanEnspaces(rightLines[i] || \"\");\n\n      // Calculate pixel width of left text\n      const leftWidthPx = this.measurer.measureText(leftText);\n\n      // Calculate spaces needed to reach the right column start\n      const spacesNeeded = this.calculateSpacesForAlignment(leftWidthPx, config.rightColumnStartPx);\n\n      // Build the merged line\n      let line = \"\";\n\n      // Add left margin if configured\n      if (config.leftMarginSpaces && config.leftMarginSpaces > 0) {\n        line += \" \".repeat(config.leftMarginSpaces);\n      }\n\n      line += leftText;\n      line += \" \".repeat(spacesNeeded);\n      line += rightText;\n\n      lines.push(line);\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Calculate the number of spaces needed to align to a target position.\n   *\n   * @param currentWidthPx - Current position in pixels\n   * @param targetPositionPx - Target position in pixels\n   * @returns Number of space characters needed\n   */\n  private calculateSpacesForAlignment(currentWidthPx: number, targetPositionPx: number): number {\n    const pixelsNeeded = targetPositionPx - currentWidthPx;\n\n    // Ensure at least one space for separation\n    if (pixelsNeeded <= 0) {\n      return 1;\n    }\n\n    // Calculate spaces needed. Use Math.floor (not Math.ceil) to ensure the\n    // right column never starts past rightColumnStartPx. Rounding up caused\n    // the right column to start 1–5px further right than planned, shrinking\n    // its usable width and causing the last character to wrap onto the next\n    // line's left position.\n    const spaces = Math.max(1, Math.floor(pixelsNeeded / this.spaceWidthPx));\n\n    // Cap at a reasonable maximum to prevent runaway spacing\n    return Math.min(spaces, 100);\n  }\n\n  /**\n   * Remove en-space characters (U+2002) that may have been added during wrapping.\n   * Native implementations do this cleanup before merging.\n   */\n  private cleanEnspaces(text: string): string {\n    return text.replace(/\\u2002/g, \"\");\n  }\n}\n\n// =============================================================================\n// Factory Function\n// =============================================================================\n\n/**\n * Create a ColumnComposer for a given profile.\n *\n * @param profile - Display profile to use\n * @param breakMode - Break mode for text wrapping (default: \"word\")\n * @returns Configured ColumnComposer instance\n */\nexport function createColumnComposer(profile: DisplayProfile, breakMode: BreakMode = \"word\"): ColumnComposer {\n  return new ColumnComposer(profile, breakMode);\n}\n"]}
+{"version":3,"file":"ColumnComposer.js","sourceRoot":"","sources":["../../../../src/utils/display/composer/ColumnComposer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ColumnComposer\n *\n * Handles composition of multi-column layouts like double_text_wall.\n * This is the single source of truth for column layout logic, replacing\n * the duplicate implementations in native iOS (G1Text.swift) and\n * Android (G1Text.kt, G1.java).\n *\n * The composer:\n * 1. Wraps each column's text to its allocated width\n * 2. Merges columns line-by-line with pixel-precise space padding\n * 3. Returns a single pre-composed string ready for native to chunk & send\n *\n * @see notes/miniapp-display-api-redesign.md for the current display design\n */\n\nimport type { DisplayProfile } from \"../profiles/types\";\nimport { TextMeasurer } from \"../measurer/TextMeasurer\";\nimport { TextWrapper } from \"../wrapper/TextWrapper\";\nimport type { WrapOptions, BreakMode } from \"../wrapper/types\";\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Configuration for column layout\n */\nexport interface ColumnConfig {\n  /** Width of the left column in pixels */\n  leftColumnWidthPx: number;\n  /** X position where the right column starts in pixels */\n  rightColumnStartPx: number;\n  /** Width of the right column in pixels (calculated from start position) */\n  rightColumnWidthPx: number;\n  /** Maximum number of lines to display */\n  maxLines: number;\n  /** Left margin in spaces (for indentation) */\n  leftMarginSpaces?: number;\n}\n\n/**\n * Options for composing double text wall\n */\nexport interface ComposeOptions {\n  /** Break mode for text wrapping */\n  breakMode?: BreakMode;\n  /** Custom column configuration (overrides profile defaults) */\n  columnConfig?: Partial<ColumnConfig>;\n}\n\n/**\n * Result of column composition\n */\nexport interface ComposeResult {\n  /** The fully composed text with both columns merged */\n  composedText: string;\n  /** Lines from the left column (for debugging/preview) */\n  leftLines: string[];\n  /** Lines from the right column (for debugging/preview) */\n  rightLines: string[];\n  /** The column configuration that was used */\n  config: ColumnConfig;\n}\n\n// =============================================================================\n// ColumnComposer Class\n// =============================================================================\n\n/**\n * Composes multi-column layouts for smart glasses displays.\n *\n * Usage:\n * ```typescript\n * const composer = new ColumnComposer(G1_PROFILE)\n * const result = composer.composeDoubleTextWall(\"Left content\", \"Right content\")\n * // result.composedText is ready to send to native SGC\n * ```\n */\nexport class ColumnComposer {\n  private profile: DisplayProfile;\n  private measurer: TextMeasurer;\n  private wrapper: TextWrapper;\n  private spaceWidthPx: number;\n\n  constructor(profile: DisplayProfile, breakMode: BreakMode = \"character-no-hyphen\") {\n    this.profile = profile;\n    this.measurer = new TextMeasurer(profile);\n    this.wrapper = new TextWrapper(this.measurer, {\n      breakMode,\n    });\n\n    // Cache space width for alignment calculations\n    this.spaceWidthPx = this.measurer.measureText(\" \");\n  }\n\n  // ===========================================================================\n  // Public API\n  // ===========================================================================\n\n  /**\n   * Compose a double text wall layout.\n   *\n   * Takes left and right text, wraps each to their column width,\n   * and merges them with pixel-precise space alignment.\n   *\n   * @param leftText - Text for the left column\n   * @param rightText - Text for the right column\n   * @param options - Optional composition settings\n   * @returns Composed result with merged text and metadata\n   */\n  public composeDoubleTextWall(leftText: string, rightText: string, options: ComposeOptions = {}): ComposeResult {\n    const config = this.getColumnConfig(options.columnConfig);\n\n    // Wrap each column independently\n    const leftWrapOptions: WrapOptions = {\n      maxWidthPx: config.leftColumnWidthPx,\n      maxLines: config.maxLines,\n    };\n\n    const rightWrapOptions: WrapOptions = {\n      maxWidthPx: config.rightColumnWidthPx,\n      maxLines: config.maxLines,\n    };\n\n    const leftResult = this.wrapper.wrap(leftText || \"\", leftWrapOptions);\n    const rightResult = this.wrapper.wrap(rightText || \"\", rightWrapOptions);\n\n    // Pad arrays to have exactly maxLines entries\n    const leftLines = this.padLines(leftResult.lines, config.maxLines);\n    const rightLines = this.padLines(rightResult.lines, config.maxLines);\n\n    // Merge columns with space alignment\n    const composedText = this.mergeColumns(leftLines, rightLines, config);\n\n    return {\n      composedText,\n      leftLines,\n      rightLines,\n      config,\n    };\n  }\n\n  /**\n   * Get the default column configuration for the current profile.\n   */\n  public getDefaultColumnConfig(): ColumnConfig {\n    return this.getColumnConfig();\n  }\n\n  /**\n   * Update the break mode for text wrapping.\n   */\n  public setBreakMode(breakMode: BreakMode): void {\n    this.wrapper = new TextWrapper(this.measurer, {\n      breakMode,\n    });\n  }\n\n  // ===========================================================================\n  // Private Methods\n  // ===========================================================================\n\n  /**\n   * Get column configuration, merging defaults with overrides.\n   */\n  private getColumnConfig(overrides?: Partial<ColumnConfig>): ColumnConfig {\n    const displayWidth = this.profile.displayWidthPx;\n\n    // Default layout: 50% for left column, right starts at 55%\n    // This matches the native G1Text implementations\n    const defaults: ColumnConfig = {\n      leftColumnWidthPx: Math.floor(displayWidth * 0.5),\n      rightColumnStartPx: Math.floor(displayWidth * 0.55),\n      rightColumnWidthPx: displayWidth - Math.floor(displayWidth * 0.55),\n      maxLines: this.profile.maxLines,\n      leftMarginSpaces: 0,\n    };\n\n    return {\n      ...defaults,\n      ...overrides,\n    };\n  }\n\n  /**\n   * Pad lines array to exactly `count` entries.\n   */\n  private padLines(lines: string[], count: number): string[] {\n    const result = [...lines];\n    while (result.length < count) {\n      result.push(\"\");\n    }\n    return result.slice(0, count);\n  }\n\n  /**\n   * Merge left and right columns with pixel-precise space alignment.\n   *\n   * For each line:\n   * 1. Take the left column text\n   * 2. Calculate its pixel width\n   * 3. Calculate how many spaces needed to reach rightColumnStartPx\n   * 4. Append spaces and right column text\n   */\n  private mergeColumns(leftLines: string[], rightLines: string[], config: ColumnConfig): string {\n    const lines: string[] = [];\n\n    for (let i = 0; i < config.maxLines; i++) {\n      const leftText = this.cleanEnspaces(leftLines[i] || \"\");\n      const rightText = this.cleanEnspaces(rightLines[i] || \"\");\n\n      // Calculate pixel width of left text\n      const leftWidthPx = this.measurer.measureText(leftText);\n\n      // Calculate spaces needed to reach the right column start\n      const spacesNeeded = this.calculateSpacesForAlignment(leftWidthPx, config.rightColumnStartPx);\n\n      // Build the merged line\n      let line = \"\";\n\n      // Add left margin if configured\n      if (config.leftMarginSpaces && config.leftMarginSpaces > 0) {\n        line += \" \".repeat(config.leftMarginSpaces);\n      }\n\n      line += leftText;\n      line += \" \".repeat(spacesNeeded);\n      line += rightText;\n\n      lines.push(line);\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Calculate the number of spaces needed to align to a target position.\n   *\n   * @param currentWidthPx - Current position in pixels\n   * @param targetPositionPx - Target position in pixels\n   * @returns Number of space characters needed\n   */\n  private calculateSpacesForAlignment(currentWidthPx: number, targetPositionPx: number): number {\n    const pixelsNeeded = targetPositionPx - currentWidthPx;\n\n    // Ensure at least one space for separation\n    if (pixelsNeeded <= 0) {\n      return 1;\n    }\n\n    // Calculate spaces needed. Use Math.floor (not Math.ceil) to ensure the\n    // right column never starts past rightColumnStartPx. Rounding up caused\n    // the right column to start 1–5px further right than planned, shrinking\n    // its usable width and causing the last character to wrap onto the next\n    // line's left position.\n    const spaces = Math.max(1, Math.floor(pixelsNeeded / this.spaceWidthPx));\n\n    // Cap at a reasonable maximum to prevent runaway spacing\n    return Math.min(spaces, 100);\n  }\n\n  /**\n   * Remove en-space characters (U+2002) that may have been added during wrapping.\n   * Native implementations do this cleanup before merging.\n   */\n  private cleanEnspaces(text: string): string {\n    return text.replace(/\\u2002/g, \"\");\n  }\n}\n\n// =============================================================================\n// Factory Function\n// =============================================================================\n\n/**\n * Create a ColumnComposer for a given profile.\n *\n * @param profile - Display profile to use\n * @param breakMode - Break mode for text wrapping (default: \"word\")\n * @returns Configured ColumnComposer instance\n */\nexport function createColumnComposer(profile: DisplayProfile, breakMode: BreakMode = \"word\"): ColumnComposer {\n  return new ColumnComposer(profile, breakMode);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/engine",
-  "version": "3.1.0-dev.10",
+  "version": "3.1.0-dev.102",
   "description": "Mentra Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -36,6 +36,11 @@
       "react-native": "./src/bluetooth-sdk/photo-receiver.ts",
       "default": "./build/bluetooth-sdk/photo-receiver.js"
     },
+    "./bluetooth-sdk/ota-transport": {
+      "types": "./build/bluetooth-sdk/ota-transport.d.ts",
+      "react-native": "./src/bluetooth-sdk/ota-transport.ts",
+      "default": "./build/bluetooth-sdk/ota-transport.js"
+    },
     "./bluetooth-sdk/debug": {
       "types": "./build/bluetooth-sdk/debug.d.ts",
       "react-native": "./src/bluetooth-sdk/debug.ts",
@@ -64,6 +69,7 @@
     "write:release-metadata": "node scripts/write-release-metadata.mjs",
     "verify:release-package": "node scripts/verify-release-package.mjs",
     "test:public-api": "bun test src/bluetooth-sdk/__tests__/publicApi.test.ts",
+    "test:public-ota-consumer": "tsc --noEmit --strict --skipLibCheck --jsx react-jsx --moduleResolution bundler --module esnext --target es2022 scripts/fixtures/public-ota-consumer.tsx",
     "build:module": "expo-module prepare",
     "prepublishOnly": "expo-module prepublishOnly",
     "expo-module": "expo-module"
@@ -91,13 +97,14 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@mentra/bluetooth-sdk": "3.1.0-dev.10",
-    "@mentra/cloud-client": "3.1.0-dev.10",
-    "@mentra/cloud-protocol": "3.1.0-dev.10",
-    "@mentra/crust": "3.1.0-dev.10",
-    "@mentra/miniapp": "3.1.0-dev.10",
+    "@mentra/bluetooth-sdk": "3.1.0-dev.102",
+    "@mentra/cloud-client": "3.1.0-dev.102",
+    "@mentra/cloud-protocol": "3.1.0-dev.102",
+    "@mentra/crust": "3.1.0-dev.102",
+    "@mentra/miniapp": "3.1.0-dev.102",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
+    "react-native-marked": "8.1.1",
     "semver": "^7.7.4",
     "typesafe-ts": "^1.7.1"
   },

package/src/bluetooth-sdk/ota-transport.ts

@@ -0,0 +1 @@
+export * from "@mentra/bluetooth-sdk/ota-transport"

package/src/facades/ota.ts

@@ -8,9 +8,16 @@
  * `installSession` fronts the OtaInstallCoordinator state machine (WP 8B) — the host
  * progress screen is a pure renderer over its snapshot + attach/detach/retry/finish.
  */
-import BluetoothSdk from "@mentra/bluetooth-sdk/internal"
-import type {OtaProgress, OtaProgressStatus, OtaStartAckEvent, OtaStatus, OtaUpdateInfo} from "@mentra/bluetooth-sdk"
-import {isGlassesConnected, useGlassesStore} from "../stores/glasses"
+import BluetoothSdk from "@mentra/bluetooth-sdk"
+import type {
+  OtaProgress,
+  OtaProgressStatus,
+  OtaStartAckEvent,
+  OtaStatus,
+  OtaUpdateInfo,
+  ReleaseChangelog,
+} from "@mentra/bluetooth-sdk"
+import {isGlassesConnected, isGlassesReady, useGlassesStore} from "../stores/glasses"
 import {resolveOtaManifestUrl} from "../services/otaManifestUrl"
 import {otaInstallCoordinator, type OtaInstallSnapshot} from "../services/OtaInstallCoordinator"
 import {startGlassesStatusProjection} from "../services/GlassesStatusProjection"
@@ -25,9 +32,12 @@ function projectSnapshot() {
   const s = useGlassesStore.getState()
   return {
     connected: isGlassesConnected(s.connection),
+    ready: isGlassesReady(s.connection),
     buildNumber: s.buildNumber || null,
+    appVersion: s.appVersion || null,
     mtkFirmwareVersion: s.mtkFirmwareVersion || null,
     besFirmwareVersion: s.besFirmwareVersion || null,
+    batteryLevel: s.batteryLevel >= 0 ? s.batteryLevel : null,
     hotspotOtaVersion: s.hotspotOtaVersion ?? 0,
     wifiConnected: s.wifi.state === "connected",
     wifiStatusKnown: s.wifiStatusKnown,
@@ -46,6 +56,7 @@ export type {
   OtaProgressStatus,
   OtaStatus,
   OtaUpdateInfo,
+  ReleaseChangelog,
   OtaInstallSnapshot,
   OtaCheckCurrentGlassesOptions,
   OtaCheckCurrentGlassesResult,
@@ -55,7 +66,7 @@ export const ota = {
   // --- actions ---
   /**
    * Start the device-status and OTA projections without starting the authenticated
-   * cloud/miniapp runtime. This is the explicit entry point for Bluetooth-only hosts.
+   * cloud connection or miniapp runtime. This is the explicit entry point for Bluetooth-only hosts.
    * Idempotent and safe when the full engine runtime is already running.
    */
   initialize: async () => {
@@ -84,6 +95,9 @@ export const ota = {
   ping: () => BluetoothSdk.ping(),
   /** Resolve and compare the current glasses against the OTA manifest, then update the OTA snapshot. */
   checkForUpdates: (options?: OtaCheckCurrentGlassesOptions) => checkCurrentGlassesForUpdate(options),
+  /** Return bundled release changelogs crossed between two coordinated product versions, newest first. */
+  getReleaseChangelogs: (fromVersion?: string | null, toVersion?: string | null): ReleaseChangelog[] =>
+    BluetoothSdk.getReleaseChangelogs(fromVersion, toVersion),
   /** Clear the available-update prompt state. */
   clearUpdateAvailable: () => useGlassesStore.getState().setOtaUpdateAvailable(null),
   /** Clear active progress/status before entering a fresh install flow. */
@@ -113,7 +127,6 @@ export const ota = {
    * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.
    */
   clearBuildNumberForNextCheck: () => {
-    BluetoothSdk.updateGlasses({buildNumber: ""})
     useGlassesStore.getState().setGlassesInfo({buildNumber: ""})
   },
   /**
@@ -136,9 +149,9 @@ export const ota = {
     detach: () => otaInstallCoordinator.detach(),
     /** Retry after a failure: clear state and re-send ota_start (if connected). */
     retry: () => otaInstallCoordinator.retry(),
-    /** Terminal cleanup for Continue/Done (navigation stays in the screen). */
+    /** Terminal cleanup for Continue/Done, including hotspot route teardown. */
     finish: () => otaInstallCoordinator.finish(),
-    /** Abandon an interrupted session (super-mode skip): finish() + drop the session's status/progress. */
+    /** Abandon an interrupted session: await finish() then drop the session's status/progress. */
     discard: () => otaInstallCoordinator.discard(),
     /** Current install read model (displayState/errorMsg/lockout + glasses OTA data). */
     snapshot: (): OtaInstallSnapshot => otaInstallCoordinator.snapshot(),

package/src/facades/pairing.ts

@@ -13,6 +13,7 @@ import BluetoothSdk from "@mentra/bluetooth-sdk/internal"
 import type {ConnectOptions, Device, DeviceModel, PairFailureEvent, GlassesNotReadyEvent} from "@mentra/bluetooth-sdk"
 import {useCoreStore} from "../stores/core"
 import {useGlassesStore} from "../stores/glasses"
+import {SETTINGS, useSettingsStore} from "../stores/settings"
 import {hasDefaultDevice} from "../services/DeviceStoreHydration"
 import {
   markPendingSelection,
@@ -20,18 +21,14 @@ import {
   subscribePairingIdentity,
   type IdentitySnapshot,
 } from "../services/PairingIdentity"
-import {
-  isGlassesConnected,
-  isGlassesLinkLayerBusy,
-  isGlassesReady,
-  waitForGlassesReady,
-} from "../services/GlassesReadiness"
+import {isGlassesConnected, isGlassesLinkLayerBusy, isGlassesReady} from "../services/GlassesReadiness"
 import {
   logAutomaticReportSubmissionStatus,
   toAutomaticReportSubmissionStatus,
   type AutomaticReportSubmissionStatus,
 } from "../services/AutomaticReportResult"
 import {pushAllBluetoothSettings} from "../services/GlassesSettingsSync"
+import {ControllerTypes} from "../types"
 import {submitAutomaticReport} from "./reports"
 
 export type {IdentitySnapshot} from "../services/PairingIdentity"
@@ -60,6 +57,82 @@ function projectReadiness() {
   }
 }
 
+function projectTargetReady(options: Pick<PairingReadyWaitOptions, "deviceModel" | "deviceName">): boolean {
+  const {deviceModel, deviceName} = options
+  const glasses = useGlassesStore.getState()
+
+  if (deviceModel === ControllerTypes.R1) {
+    if (!glasses.controllerConnected || !glasses.controllerFullyBooted) return false
+    const settings = useSettingsStore.getState()
+    const pairedModel = settings.getSetting(SETTINGS.default_controller.key)
+    const pairedName = settings.getSetting(SETTINGS.controller_device_name.key)
+    return (!deviceModel || pairedModel === deviceModel) && (!deviceName || pairedName === deviceName)
+  }
+
+  if (!isGlassesReady(glasses.connection)) return false
+  const identity = projectPairingIdentity()
+  if (!deviceModel && !deviceName) return true
+  return (
+    identity.kind === "paired" &&
+    (!deviceModel || identity.model === deviceModel) &&
+    (!deviceName || identity.name === deviceName)
+  )
+}
+
+function subscribeTargetReady(
+  options: Pick<PairingReadyWaitOptions, "deviceModel" | "deviceName">,
+  cb: (ready: boolean) => void,
+): () => void {
+  let last = projectTargetReady(options)
+  const notify = () => {
+    const ready = projectTargetReady(options)
+    if (ready === last) return
+    last = ready
+    cb(ready)
+  }
+  const unsubscribeGlasses = useGlassesStore.subscribe(notify)
+  const unsubscribeSettings = useSettingsStore.subscribe(notify)
+  return () => {
+    unsubscribeGlasses()
+    unsubscribeSettings()
+  }
+}
+
+async function waitForTargetReady(options: PairingReadyWaitOptions, timeoutMs: number): Promise<boolean> {
+  return new Promise((resolve) => {
+    if (options.signal?.aborted) {
+      resolve(false)
+      return
+    }
+    if (projectTargetReady(options)) {
+      resolve(true)
+      return
+    }
+
+    let settled = false
+    let timeout: ReturnType<typeof setTimeout> | null = null
+    let unsubscribe: (() => void) | null = null
+    let onAbort: (() => void) | null = null
+    const finish = (ready: boolean) => {
+      if (settled) return
+      settled = true
+      if (timeout) clearTimeout(timeout)
+      if (unsubscribe) unsubscribe()
+      if (onAbort && options.signal) options.signal.removeEventListener("abort", onAbort)
+      resolve(ready)
+    }
+
+    unsubscribe = subscribeTargetReady(options, (ready) => {
+      if (ready) finish(true)
+    })
+    if (options.signal) {
+      onAbort = () => finish(false)
+      options.signal.addEventListener("abort", onAbort)
+    }
+    timeout = setTimeout(() => finish(projectTargetReady(options)), timeoutMs)
+  })
+}
+
 export type PairingReadinessSnapshot = ReturnType<typeof projectReadiness>
 
 export async function submitPairingBootTimeoutReport(params: {
@@ -108,12 +181,7 @@ async function waitForReadyDuringPairing(options: PairingReadyWaitOptions = {}):
   })
 
   try {
-    const ready = await waitForGlassesReady({
-      getConnection: () => useGlassesStore.getState().connection,
-      subscribe: (listener) => useGlassesStore.subscribe((state) => state.connection, listener),
-      timeoutMs,
-      signal: options.signal,
-    })
+    const ready = await waitForTargetReady(options, timeoutMs)
 
     if (!ready && !options.signal?.aborted) {
       void submitPairingBootTimeoutReport({
@@ -193,6 +261,14 @@ export const pairing = {
       cb(snap)
     })
   },
+  /** Whether the exact wearable or controller selected on the scan screen is ready. */
+  targetReady: (options: Pick<PairingReadyWaitOptions, "deviceModel" | "deviceName">): boolean =>
+    projectTargetReady(options),
+  /** Subscribe to readiness for the exact selected target, excluding stale devices. */
+  onTargetReady: (
+    options: Pick<PairingReadyWaitOptions, "deviceModel" | "deviceName">,
+    cb: (ready: boolean) => void,
+  ): (() => void) => subscribeTargetReady(options, cb),
 
   // --- pairing-identity lifecycle (the PairingIdentity read-model + the JS-owned
   // identity writes; promotion to `paired` only ever happens natively) ---

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface EngineReleaseMetadata {
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "3.1.0",
-  "releaseIdentity": "3.1.0-dev.10",
-  "releaseSetId": "mentra-3.1.0-dev.10",
-  "sourceCommit": "64cf83b23a71e70261571a5f4401d1a7538f1852",
-  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-v3.1.0-dev.10/mentra-live-ota-3.1.0-dev.10.json",
-  "otaManifestSha256": "214d92c8894033eaab276e668cb553c79990005d3330d23aaf499a514dc08cff"
+  "releaseIdentity": "3.1.0-dev.102",
+  "releaseSetId": "mentra-3.1.0-dev.102",
+  "sourceCommit": "1e5cd9f88a6a43db2f51f4ddd3c6a4b8f15d0fed",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.1.0/mentra-live-ota-3.1.0-dev.102.json",
+  "otaManifestSha256": "5ff3b609846566abecea90ce5fed4a8d281db2dee82a728b7d80a97beedc4f13"
 })

package/src/index.ts

@@ -89,6 +89,7 @@ export {
   GLOBAL_OTA_TIMEOUT_MS,
   PING_INTERVAL_MS,
   QUERY_REPLY_TIMEOUT_MS,
+  BES_RESTART_TIMEOUT_MS,
   OtaProgressMessages,
 } from "./services/otaInstallPolicy"
 export {deriveDisplayState} from "./services/otaDisplayState"
@@ -98,6 +99,7 @@ export type {
   OtaProgressStatus,
   OtaStatus,
   OtaUpdateInfo,
+  ReleaseChangelog,
   OtaSnapshot,
   OtaInstallSnapshot,
 } from "./facades/ota"
@@ -195,6 +197,7 @@ export {
   evenRealitiesG1,
   evenRealitiesG2,
   mentraLive,
+  nimo,
   vuzixZ100,
   mentraDisplay,
 } from "./types"