@glassly/engine 0.1.0-dev.61 → 0.1.0-dev.89

package/build/types/index.js

@@ -2,5 +2,5 @@
  * are re-exported from @glassly/miniapp, their canonical owner. */
 // Enums (runtime values)
 export { HardwareType, HardwareRequirementLevel, DeviceTypes, ControllerTypes } from "./enums";
-export { HARDWARE_CAPABILITIES, getModelCapabilities, simulatedGlasses, evenRealitiesG1, evenRealitiesG2, mentraLive, vuzixZ100, mentraDisplay, nimo, } from "./hardware";
+export { HARDWARE_CAPABILITIES, getModelCapabilities, simulatedGlasses, evenRealitiesG1, evenRealitiesG2, mentraLive, nimo, vuzixZ100, mentraDisplay, } from "./hardware";
 //# sourceMappingURL=index.js.map

package/build/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;mEACmE;AAEnE,yBAAyB;AACzB,OAAO,EAAC,YAAY,EAAE,wBAAwB,EAAE,WAAW,EAAE,eAAe,EAAC,MAAM,SAAS,CAAA;AAgB5F,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,UAAU,EACV,SAAS,EACT,aAAa,EACb,IAAI,GACL,MAAM,YAAY,CAAA","sourcesContent":["/** Engine capability types and profiles. Miniapp manifest requirement types\n * are re-exported from @glassly/miniapp, their canonical owner. */\n\n// Enums (runtime values)\nexport {HardwareType, HardwareRequirementLevel, DeviceTypes, ControllerTypes} from \"./enums\"\n\n// Hardware types\nexport type {\n  HardwareRequirement,\n  CameraCapabilities,\n  DisplayCapabilities,\n  MicrophoneCapabilities,\n  SpeakerCapabilities,\n  IMUCapabilities,\n  ButtonCapabilities,\n  LightCapabilities,\n  PowerCapabilities,\n  Capabilities,\n} from \"./hardware\"\n\nexport {\n  HARDWARE_CAPABILITIES,\n  getModelCapabilities,\n  simulatedGlasses,\n  evenRealitiesG1,\n  evenRealitiesG2,\n  mentraLive,\n  vuzixZ100,\n  mentraDisplay,\n  nimo,\n} from \"./hardware\"\n\n// Applet types\nexport type {AppletType, AppPermissionType, AppletPermission, AppletInterface, ClientApp} from \"./applet\"\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;mEACmE;AAEnE,yBAAyB;AACzB,OAAO,EAAC,YAAY,EAAE,wBAAwB,EAAE,WAAW,EAAE,eAAe,EAAC,MAAM,SAAS,CAAA;AAgB5F,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,UAAU,EACV,IAAI,EACJ,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAA","sourcesContent":["/** Engine capability types and profiles. Miniapp manifest requirement types\n * are re-exported from @glassly/miniapp, their canonical owner. */\n\n// Enums (runtime values)\nexport {HardwareType, HardwareRequirementLevel, DeviceTypes, ControllerTypes} from \"./enums\"\n\n// Hardware types\nexport type {\n  HardwareRequirement,\n  CameraCapabilities,\n  DisplayCapabilities,\n  MicrophoneCapabilities,\n  SpeakerCapabilities,\n  IMUCapabilities,\n  ButtonCapabilities,\n  LightCapabilities,\n  PowerCapabilities,\n  Capabilities,\n} from \"./hardware\"\n\nexport {\n  HARDWARE_CAPABILITIES,\n  getModelCapabilities,\n  simulatedGlasses,\n  evenRealitiesG1,\n  evenRealitiesG2,\n  mentraLive,\n  nimo,\n  vuzixZ100,\n  mentraDisplay,\n} from \"./hardware\"\n\n// Applet types\nexport type {AppletType, AppPermissionType, AppletPermission, AppletInterface, ClientApp} from \"./applet\"\n"]}

package/build/utils/display/composer/ColumnComposer.d.ts

@@ -11,7 +11,7 @@
  * 2. Merges columns line-by-line with pixel-precise space padding
  * 3. Returns a single pre-composed string ready for native to chunk & send
  *
- * @see cloud/issues/026-mobile-display-processor for design docs
+ * @see notes/miniapp-display-api-redesign.md for the current display design
  */
 import type { DisplayProfile } from "../profiles/types";
 import type { BreakMode } from "../wrapper/types";

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

@@ -11,7 +11,7 @@
  * 2. Merges columns line-by-line with pixel-precise space padding
  * 3. Returns a single pre-composed string ready for native to chunk & send
  *
- * @see cloud/issues/026-mobile-display-processor for design docs
+ * @see notes/miniapp-display-api-redesign.md for the current display design
  */
 import { TextMeasurer } from "../measurer/TextMeasurer";
 import { TextWrapper } from "../wrapper/TextWrapper";

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":"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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 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": "@glassly/engine",
-  "version": "0.1.0-dev.61",
+  "version": "0.1.0-dev.89",
   "description": "Glassly Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -97,16 +97,17 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@glassly/bluetooth-sdk": "0.1.0-dev.61",
-    "@glassly/cloud-client": "0.1.0-dev.61",
-    "@glassly/cloud-protocol": "0.1.0-dev.61",
-    "@glassly/crust": "0.1.0-dev.61",
-    "@glassly/miniapp": "0.1.0-dev.61",
+    "@glassly/bluetooth-sdk": "0.1.0-dev.89",
+    "@glassly/cloud-client": "0.1.0-dev.89",
+    "@glassly/cloud-protocol": "0.1.0-dev.89",
+    "@glassly/crust": "0.1.0-dev.89",
+    "@glassly/miniapp": "0.1.0-dev.89",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
+    "react-native-marked": "8.1.1",
     "semver": "^7.7.4",
     "typesafe-ts": "^1.7.1",
-    "@glassly/llm-providers": "0.1.0-dev.61"
+    "@glassly/llm-providers": "0.1.0-dev.89"
   },
   "devDependencies": {
     "@glassly/llm-providers": "workspace:*",

package/src/engine.ts

@@ -46,6 +46,7 @@ import {speakers} from "./facades/speakers"
 import {providerKeys} from "./facades/providerKeys"
 import {logBuffer} from "./utils/devLogging"
 import customDashboardService from "./services/CustomDashboardService"
+import dashboardCoordinator from "./services/DashboardCoordinator"
 import gestureDotsService from "./services/GestureDotsService"
 
 export const engine = {
@@ -69,6 +70,7 @@ export const engine = {
     // syncs below react to them.
     startGlassesStatusProjection((changed) => localMiniappRuntime.forwardEvent("glasses_connection_state", changed))
     customDashboardService.start()
+    dashboardCoordinator.start()
     gestureDotsService.start()
     // Route the rest of the inbound device events (wifi/hotspot/gallery -> stores+bus,
     // photo/stream -> coordinators, button/touch/accel/head -> miniapps, save_setting ->
@@ -151,6 +153,7 @@ export const engine = {
     await safely("glasses settings sync", stopGlassesSettingsSync)
     await safely("glasses status projection", stopGlassesStatusProjection)
     await safely("device event router", stopDeviceEventRouter)
+    await safely("dashboard coordinator", () => dashboardCoordinator.stop())
     await safely("custom dashboard service", () => customDashboardService.stop())
     await safely("gesture dots service", () => gestureDotsService.stop())
     await safely("ota service", stopOtaService)

package/src/facades/display.ts

@@ -5,11 +5,21 @@
  * the engine DisplayProcessor / layout system, not these).
  */
 import BluetoothSdk from "@glassly/bluetooth-sdk"
+import dashboardCoordinator from "../services/DashboardCoordinator"
 import {displayMirror} from "./displayMirror"
 
 export const display = {
-  /** Mirrored-view read-model (current/onMirror/view/setView). */
+  /** Mirrored-view read-model (current/onMirror). */
   mirror: displayMirror,
+  /** Phone-composed dashboard controls (simulated head-up, dev tools). */
+  dashboard: {
+    isOpen: (): boolean => dashboardCoordinator.isOpen,
+    /** Open/close as if the head was raised/lowered (respects contextual_dashboard). */
+    setHeadUp: (up: boolean): void => dashboardCoordinator.setHeadUp(up),
+    /** Force open/close, ignoring contextual_dashboard (simulator button). */
+    open: (): void => dashboardCoordinator.open(),
+    close: (): void => dashboardCoordinator.close(),
+  },
   /** Write raw text to the glasses display at (x, y) with a font size. */
   text: (...args: Parameters<typeof BluetoothSdk.displayText>) => BluetoothSdk.displayText(...args),
   /** Clear the glasses display. */

package/src/facades/displayMirror.ts

@@ -1,33 +1,25 @@
 /**
  * glasses display mirror — the typed read facade over the (now engine-owned)
  * display store, for a phone-side preview of the glasses screen
- * (`engine.display.mirror`). The store is fed by the display paths
- * (LocalDisplayManager + the cloud path) via `setDisplayEvent`; this facade is the
- * read side: `current()` (snapshot) + `onMirror(cb)` (subscribe). The raw store is
- * also exposed as `engine.displayStore` (the Glassly-app escape hatch).
+ * (`engine.display.mirror`). The store holds the single frame currently on the
+ * glasses (dashboard switching happens upstream in DashboardCoordinator); this
+ * facade is the read side: `current()` (snapshot) + `onMirror(cb)` (subscribe).
+ * The raw store is also exposed as `engine.displayStore` (the Glassly-app
+ * escape hatch).
  */
 import {useDisplayStore} from "../stores/display"
 
 export type DisplayMirrorEvent = Record<string, unknown> & {view?: string; layout?: any}
 
 export const displayMirror = {
-  /** The display event currently shown on the previewed view (snapshot). */
+  /** The display event currently on the glasses (snapshot). */
   current(): DisplayMirrorEvent {
     // Copy: the snapshot must not hand callers a mutable reference into the store.
     return {...useDisplayStore.getState().currentEvent}
   },
 
-  /** Subscribe to changes of the previewed display event; returns an unsubscribe. */
+  /** Subscribe to changes of the mirrored display event; returns an unsubscribe. */
   onMirror(cb: (event: DisplayMirrorEvent) => void): () => void {
     return useDisplayStore.subscribe((s) => s.currentEvent, cb)
   },
-
-  /** Which view is previewed — the main screen or the dashboard. */
-  view(): string {
-    return useDisplayStore.getState().view
-  },
-  /** Switch the previewed view between `"main"` and `"dashboard"`. */
-  setView(view: "main" | "dashboard"): void {
-    useDisplayStore.getState().setView(view)
-  },
 }

package/src/facades/glasses.ts

@@ -35,6 +35,8 @@ function projectStatus() {
     micEnabled: s.micEnabled,
     vadEnabled: s.voiceActivityDetectionEnabled,
     btClassic: s.bluetoothClassicConnected,
+    // iOS: glasses may read the phone's ANCS stream ("Share System Notifications").
+    ancsAuthorized: Boolean(s.ancsAuthorized),
   }
 }
 

package/src/facades/ota.ts

@@ -17,7 +17,7 @@ import type {
   OtaUpdateInfo,
   ReleaseChangelog,
 } from "@glassly/bluetooth-sdk"
-import {isGlassesConnected, useGlassesStore} from "../stores/glasses"
+import {isGlassesConnected, isGlassesReady, useGlassesStore} from "../stores/glasses"
 import {resolveOtaManifestUrl} from "../services/otaManifestUrl"
 import {otaInstallCoordinator, type OtaInstallSnapshot} from "../services/OtaInstallCoordinator"
 import {startGlassesStatusProjection} from "../services/GlassesStatusProjection"
@@ -32,10 +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,
@@ -64,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 () => {

package/src/facades/phoneNotifications.ts

@@ -1,25 +1,40 @@
 /**
  * phoneNotifications facade — `engine.phoneNotifications`: forward phone
- * notifications to the glasses, with a per-app blocklist. Android-only (the
- * NotificationListenerService); the getters return sensible defaults on iOS.
+ * notifications to the glasses, with a per-app blocklist.
  *
- * The per-app blocklist is an engine setting (auto-synced to the native
- * listener); the installed-apps list + listener permission are CrustModule.
- * Capture itself is controlled only by Android notification access and the
- * hidden operational kill switch.
+ * Android: apps come from the NotificationListenerService's installed-apps
+ * enumeration and the blocklist filters capture phone-side.
+ * iOS: apps are the seeded catalog plus what the glasses' ANCS client has
+ * reported posting notifications (`ios_notification_seen_apps`); the blocklist
+ * is mapped onto the G2's on-glass allowlist by PhoneNotificationsSync.
+ * Capture itself is controlled by Android notification access / iOS ANCS
+ * authorization (`glasses.ancsAuthorized`), not by this facade.
  */
 import {Platform} from "react-native"
 import CrustModule from "@glassly/crust"
 import {useSettingsStore, SETTINGS} from "../stores/settings"
+import {useGlassesStore} from "../stores/glasses"
+import {getKnownNotificationApps} from "../services/PhoneNotificationsSync"
 
 export const phoneNotifications = {
-  /** The phone's installed apps (package, name, icon). (empty on iOS) */
+  /**
+   * Apps to show in the notification filter UI (package/bundle id, name, icon).
+   * Android: installed apps. iOS: seeded catalog ∪ glasses-reported apps
+   * (icons unavailable — iOS offers no cross-app icon lookup).
+   */
   installedApps: (): Promise<Array<{packageName: string; appName: string; icon: string | null}>> => {
-    if (Platform.OS !== "android") return Promise.resolve([])
-    return CrustModule.getInstalledApps()
+    if (Platform.OS === "android") return CrustModule.getInstalledApps()
+    if (Platform.OS !== "ios") return Promise.resolve([])
+    return Promise.resolve(
+      getKnownNotificationApps().map((app) => ({
+        packageName: app.appId,
+        appName: app.displayName,
+        icon: null,
+      })),
+    )
   },
 
-  /** The per-app blocklist (package names whose notifications are NOT forwarded). */
+  /** The per-app blocklist (package/bundle ids whose notifications are NOT forwarded). */
   blocklist: (): string[] => {
     const b = useSettingsStore.getState().getSetting(SETTINGS.notifications_blocklist.key)
     return Array.isArray(b) ? b : []
@@ -38,4 +53,11 @@ export const phoneNotifications = {
     if (Platform.OS !== "android") return
     return CrustModule.openNotificationListenerSettings()
   },
+
+  /**
+   * iOS: whether the connected glasses may read the phone's ANCS notification
+   * stream (the "Share System Notifications" Bluetooth consent). Always false
+   * on Android — Android capture is the notification listener instead.
+   */
+  ancsAuthorized: (): boolean => Boolean(useGlassesStore.getState().ancsAuthorized),
 }

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface EngineReleaseMetadata {
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "0.1.0",
-  "releaseIdentity": "0.1.0-dev.61",
-  "releaseSetId": "glassly-0.1.0-dev.61",
-  "sourceCommit": "a95e4c9e0146e47ed4e553613584abd265913759",
+  "releaseIdentity": "0.1.0-dev.89",
+  "releaseSetId": "glassly-0.1.0-dev.89",
+  "sourceCommit": "c66a621d66d70251e257f73c9a79ee1f8e079be9",
   "otaManifestUrl": null,
   "otaManifestSha256": null
 })

package/src/index.ts

@@ -109,6 +109,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"
@@ -216,9 +217,9 @@ export {
   evenRealitiesG1,
   evenRealitiesG2,
   mentraLive,
+  nimo,
   vuzixZ100,
   mentraDisplay,
-  nimo,
 } from "./types"
 export type {
   HardwareRequirement,