@glassly/engine 0.3.7 → 0.3.8-beta.1013

package/src/services/{appleWatch/AppleWatchLink.ts → watch/WatchLink.ts}

@@ -1,15 +1,15 @@
 /**
- * The Apple Watch remote's phone half: the watch app's status context (glasses, the miniapp in
+ * The watch remote's phone half, for the Apple Watch (iOS, WatchConnectivity) and a Wear OS
+ * watch (Android, Wearable Data Layer) alike: the watch app's status (glasses, the miniapp in
  * front, launchable miniapps, whether Assist takes questions, the mirror setting), mirror frames
  * while the setting is on, and the commands the watch sends back. Native adds whether the active
  * watch is paired and keeps the newest frame for when the watch app opens. Gestures ride
  * `touch_event` like any controller's.
  */
-import type {AppleWatchCommandEvent} from "@glassly/bluetooth-sdk"
+import type {WatchCommandEvent} from "@glassly/bluetooth-sdk"
 import BluetoothSdk from "@glassly/bluetooth-sdk/internal"
 import type {MirrorSnapshot} from "@glassly/miniapp"
 import {MiniappStreamType} from "@glassly/miniapp"
-import {Platform} from "react-native"
 
 import {useAppStatusStore} from "../../stores/apps"
 import {useGlassesStore} from "../../stores/glasses"
@@ -23,7 +23,7 @@ import {keyEventsForTextChange} from "../neuralBand/NeuralBandInput"
 
 export const ASSIST_PACKAGE = "com.glassly.assistant"
 export const ASSIST_ACTION = "ask"
-/** WatchConnectivity messages top out near 64 KB; frames past this are skipped, not truncated. */
+/** WatchConnectivity messages top out near 64 KB (Data Layer messages at 100 KB); frames past this are skipped, not truncated. */
 const MAX_FRAME_BYTES = 48_000
 const MAX_IMAGE_CHARS = 16_000
 const MAX_APPS = 24
@@ -142,7 +142,7 @@ export function mirrorFrame(snapshot: MirrorSnapshot): Record<string, unknown> |
   return JSON.stringify(frame).length > MAX_FRAME_BYTES ? null : frame
 }
 
-export interface AppleWatchCommandDeps {
+export interface WatchCommandDeps {
   apps: () => readonly ClientApp[]
   start: (app: ClientApp) => Promise<unknown>
   stop: (packageName: string) => Promise<unknown>
@@ -151,7 +151,7 @@ export interface AppleWatchCommandDeps {
   now: () => number
 }
 
-const defaultDeps: AppleWatchCommandDeps = {
+const defaultDeps: WatchCommandDeps = {
   apps: () => useAppStatusStore.getState().apps,
   start: (app) => useAppStatusStore.getState().start(app),
   stop: (packageName) => useAppStatusStore.getState().stop(packageName),
@@ -160,9 +160,9 @@ const defaultDeps: AppleWatchCommandDeps = {
   now: () => Date.now(),
 }
 
-export async function handleAppleWatchCommand(
-  event: AppleWatchCommandEvent,
-  deps: AppleWatchCommandDeps = defaultDeps,
+export async function handleWatchCommand(
+  event: WatchCommandEvent,
+  deps: WatchCommandDeps = defaultDeps,
 ): Promise<void> {
   switch (event.command) {
     case "launch": {
@@ -170,7 +170,7 @@ export async function handleAppleWatchCommand(
         ? deps.apps().find((entry) => entry.packageName === event.packageName)
         : undefined
       if (!app) {
-        console.warn(`AppleWatch: launch of unknown miniapp ${event.packageName}`)
+        console.warn(`Watch: launch of unknown miniapp ${event.packageName}`)
         return
       }
       await deps.start(app)
@@ -206,7 +206,7 @@ function currentState(): Record<string, unknown> {
     },
     apps: useAppStatusStore.getState().apps,
     assist: localMiniappRuntime.hostActionAvailable(ASSIST_PACKAGE, ASSIST_ACTION),
-    mirror: useSettingsStore.getState().getSetting(SETTINGS.apple_watch_mirror.key) === true,
+    mirror: useSettingsStore.getState().getSetting(SETTINGS.watch_mirror.key) === true,
   })
 }
 
@@ -226,7 +226,7 @@ function syncMirror(enabled: boolean): void {
   const send = (snapshot: MirrorSnapshot) => {
     lastSentAt = Date.now()
     void BluetoothSdk.setWatchMirror(mirrorFrame(snapshot)).catch((err) =>
-      console.warn("AppleWatch: mirror push failed:", err),
+      console.warn("Watch: mirror push failed:", err),
     )
   }
   const unsubscribe = mirrorService.subscribe((snapshot) => {
@@ -252,8 +252,8 @@ function syncMirror(enabled: boolean): void {
   }
 }
 
-export function startAppleWatchLink(): void {
-  if (Platform.OS !== "ios" || stops.length > 0) return
+export function startWatchLink(): void {
+  if (stops.length > 0) return
   let lastKey = ""
   let timer: ReturnType<typeof BgTimer.setTimeout> | null = null
   const push = () => {
@@ -262,21 +262,21 @@ export function startAppleWatchLink(): void {
     const key = JSON.stringify(state)
     if (key === lastKey) return
     lastKey = key
-    void BluetoothSdk.setWatchState(state).catch((err) => console.warn("AppleWatch: state push failed:", err))
+    void BluetoothSdk.setWatchState(state).catch((err) => console.warn("Watch: state push failed:", err))
   }
   const schedule = () => {
     timer ??= BgTimer.setTimeout(push, STATE_DEBOUNCE_MS)
   }
-  const mirrorEnabled = () => useSettingsStore.getState().getSetting(SETTINGS.apple_watch_mirror.key) === true
-  const commands = BluetoothSdk.addListener("apple_watch_command", (event) => {
-    handleAppleWatchCommand(event).catch((err) => console.warn(`AppleWatch: ${event.command} failed:`, err))
+  const mirrorEnabled = () => useSettingsStore.getState().getSetting(SETTINGS.watch_mirror.key) === true
+  const commands = BluetoothSdk.addListener("watch_command", (event) => {
+    handleWatchCommand(event).catch((err) => console.warn(`Watch: ${event.command} failed:`, err))
   })
   stops = [
     () => commands.remove(),
     useGlassesStore.subscribe(schedule),
     useAppStatusStore.subscribe(schedule),
     useSettingsStore.subscribe(
-      (s) => s.getSetting(SETTINGS.apple_watch_mirror.key),
+      (s) => s.getSetting(SETTINGS.watch_mirror.key),
       () => {
         syncMirror(mirrorEnabled())
         schedule()
@@ -291,7 +291,7 @@ export function startAppleWatchLink(): void {
   schedule()
 }
 
-export function stopAppleWatchLink(): void {
+export function stopWatchLink(): void {
   stops.splice(0).forEach((stop) => stop())
   syncMirror(false)
 }

package/src/stores/appVisibility.ts

@@ -28,7 +28,6 @@ export const DEV_TOOLS_PACKAGES: ReadonlySet<string> = new Set([
   "com.glassly.example",
   "com.glassly.tetris",
   "com.glassly.compass",
-  "com.glassly.showcase",
 ])
 
 /** True when the app is dev-only and developer tools are off. */

package/src/stores/apps.ts

@@ -217,6 +217,7 @@ function projectApps(previousState: AppStatusState, localApps: ClientApp[]): Cli
     DeviceTypes.NONE
   const capabilities = getModelCapabilities(defaultWearable)
   const devToolsEnabled = useSettingsStore.getState().getSetting(SETTINGS.dev_tools.key) === true
+  const persistScreenshots = useSettingsStore.getState().getSetting(SETTINGS.persist_miniapp_screenshots.key) !== false
   const hasPairedGlasses = useSettingsStore.getState().getSetting(SETTINGS.has_paired_glasses.key) === true
 
   // Single pass: dedupe → screenshot carry-over → compat → hidden, all into
@@ -246,7 +247,10 @@ function projectApps(previousState: AppStatusState, localApps: ClientApp[]): Cli
     .map((app) => {
       const next: ClientApp = {
         ...app,
-        screenshot: previousByPackage.get(app.packageName)?.screenshot ?? app.screenshot,
+        // The registry's screenshot is the one restored from disk; only an
+        // in-memory capture carries over when persistence is off.
+        screenshot:
+          previousByPackage.get(app.packageName)?.screenshot ?? (persistScreenshots ? app.screenshot : undefined),
         compatibility: HardwareCompatibility.checkCompatibility(app.hardwareRequirements, capabilities),
         // A registry source can force an app off the primary home screen.
         // Compose that gate with the user's persisted home-screen layout instead
@@ -384,15 +388,6 @@ export const useAppStatusStore = create<AppStatusState>((set, get) => ({
     // owns the settings store).
     useSettingsStore.getState().setSetting(SETTINGS.has_ever_activated_app.key, true)
 
-    // If the tapped app is already running, this is a re-open: the nav/foreground
-    // above already drove the animation, and there's nothing to spawn. Short-
-    // circuit before the spawn pipeline. A promoted app keeps its context but
-    // still takes the foreground below.
-    if (app.running && !app.widgetOnly) {
-      saveLastOpenTime(packageName)
-      return true
-    }
-
     // Only-one rules: one standard app in the foreground, one dashboard
     // drawing the overlay. Starting another stops the one running. Widget-only
     // peers hold no foreground, so they stay.
@@ -405,6 +400,17 @@ export const useAppStatusStore = create<AppStatusState>((set, get) => ({
       }
     }
 
+    // If the tapped app is already running, this is a re-open: the nav/foreground
+    // above already drove the animation, and there's nothing to spawn. Short-
+    // circuit before the spawn pipeline. A promoted app keeps its context but
+    // still takes the foreground below.
+    if (app.running && !app.widgetOnly) {
+      saveLastOpenTime(packageName)
+      // The running background only knows the source of its spawn.
+      if (app.local) miniappLauncher.notifyLaunch(packageName, opts?.launchSource ?? "phone")
+      return true
+    }
+
     set((s) => ({
       apps: s.apps.map((a) => (a.packageName === packageName ? {...a, running: true, loading: false} : a)),
     }))
@@ -543,7 +549,12 @@ export const useAppStatusStore = create<AppStatusState>((set, get) => ({
   },
 
   saveScreenshot: async (packageName: string, screenshot: string) => {
-    storage.save(`${packageName}_screenshot`, screenshot)
+    const key = `${packageName}_screenshot`
+    if (useSettingsStore.getState().getSetting(SETTINGS.persist_miniapp_screenshots.key) !== false) {
+      storage.save(key, screenshot)
+    } else {
+      storage.remove(key)
+    }
     set((s) => ({
       apps: s.apps.map((a) => (a.packageName === packageName ? {...a, screenshot} : a)),
     }))

package/src/stores/settings.ts

@@ -132,6 +132,13 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: true,
     persist: true,
   },
+  memomind_accessory_picker: {
+    key: "memomind_accessory_picker",
+    defaultValue: () => false,
+    writable: true,
+    saveOnServer: false,
+    persist: true,
+  },
   debug_console: {
     key: "debug_console",
     defaultValue: () => false,
@@ -803,8 +810,8 @@ export const SETTINGS: Record<string, Setting> = {
   // OFF by default: they crowd out everything else in the ten-minute buffer.
   // Synced to the Bluetooth SDK, which keeps counting either way and only
   // logs while this is on. Device-local debug knob, so not saved on the server.
-  g2_perf_logs: {
-    key: "g2_perf_logs",
+  perf_logs: {
+    key: "perf_logs",
     defaultValue: () => false,
     writable: true,
     saveOnServer: false,
@@ -841,12 +848,29 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: false,
     persist: true,
   },
-  // Apple Watch: draw the glasses' current frame behind the watch trackpad. Frames
-  // cross WatchConnectivity while the watch app is up, so it stays off unless asked for.
+  // The band's own buzz on each gesture (its haptics pattern 1; pattern 2 is silent).
+  neural_band_vibration: {
+    key: "neural_band_vibration",
+    defaultValue: () => true,
+    writable: true,
+    saveOnServer: false,
+    persist: true,
+  },
+  // Watch (Apple Watch, Wear OS): draw the glasses' current frame behind the watch
+  // trackpad. Frames cross the watch link while the watch app is up, so it stays off
+  // unless asked for.
+  watch_mirror: {
+    key: "watch_mirror",
+    defaultValue: () => false,
+    writable: true,
+    saveOnServer: false,
+    persist: true,
+  },
+  // Deprecated: the setting above under its Apple-only name; read once to migrate.
   apple_watch_mirror: {
     key: "apple_watch_mirror",
     defaultValue: () => false,
-    writable: true,
+    writable: false,
     saveOnServer: false,
     persist: true,
   },
@@ -904,6 +928,23 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: false,
     persist: true,
   },
+  // Debug: keep each miniapp's switcher-card screenshot on disk so the card
+  // comes back after an app restart. Off keeps captures in memory only, for
+  // checking the capture path itself. Device-local, default on.
+  persist_miniapp_screenshots: {
+    key: "persist_miniapp_screenshots",
+    defaultValue: () => true,
+    writable: true,
+    saveOnServer: false,
+    persist: true,
+  },
+  home_offline_card: {
+    key: "home_offline_card",
+    defaultValue: () => true,
+    writable: true,
+    saveOnServer: false,
+    persist: true,
+  },
   // Gesture-dots debug indicator: flash a glyph on the glasses when a touch
   // gesture is received while the display is empty. Works on any
   // scene-capable device, not only CFW. Device-local debug knob, default off.
@@ -1128,6 +1169,13 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: true,
     persist: true,
   },
+  notifications_batch_seconds: {
+    key: "notifications_batch_seconds",
+    defaultValue: () => 0,
+    writable: true,
+    saveOnServer: true,
+    persist: true,
+  },
   // Hold popups while another glasses feature (navigation, a miniapp) is on screen.
   notifications_hold_during_apps: {
     key: "notifications_hold_during_apps",
@@ -1205,7 +1253,8 @@ export const BLUETOOTH_SETTING_KEYS: string[] = [
   SETTINGS.calendar_events.key,
   SETTINGS.cfw_scene_renderer.key,
   SETTINGS.cfw_fast_ble.key,
-  SETTINGS.g2_perf_logs.key,
+  SETTINGS.perf_logs.key,
+  SETTINGS.memomind_accessory_picker.key,
   SETTINGS.ring_via_glasses.key,
   SETTINGS.display_max_fps.key,
   SETTINGS.twelve_hour_time.key,
@@ -1276,10 +1325,13 @@ export interface SettingsState {
 }
 
 const getDefaultSettings = () =>
-  Object.keys(SETTINGS).reduce((acc, key) => {
-    acc[key] = SETTINGS[key].defaultValue()
-    return acc
-  }, {} as Record<string, any>)
+  Object.keys(SETTINGS).reduce(
+    (acc, key) => {
+      acc[key] = SETTINGS[key].defaultValue()
+      return acc
+    },
+    {} as Record<string, any>,
+  )
 
 // Single-flight for loadAllSettings: the host fires it at module load and
 // engine.start()'s device-store hydration awaits it — without the memo the
@@ -1619,6 +1671,22 @@ export const useSettingsStore = create<SettingsState>()(
           }
           if (menuMigrated) storage.save(MENU_SETTINGS_MIGRATION_KEY, true)
         }
+
+        // The watch mirror switch lost its Apple-only name when Wear OS joined: carry a
+        // turned-on `apple_watch_mirror` over to `watch_mirror` once.
+        const WATCH_MIRROR_MIGRATION_KEY = "migration:watch_mirror_v1"
+        const watchMirrorMigrationDone = storage.load<boolean>(WATCH_MIRROR_MIGRATION_KEY)
+        if (watchMirrorMigrationDone.is_error() || !watchMirrorMigrationDone.value) {
+          let watchMirrorMigrated = true
+          if (get().getSetting(SETTINGS.apple_watch_mirror.key) === true) {
+            const result = await get().setSetting(SETTINGS.watch_mirror.key, true, false)
+            if (result.is_error()) {
+              console.log("SETTINGS: watch_mirror migration failed:", result.error)
+              watchMirrorMigrated = false
+            }
+          }
+          if (watchMirrorMigrated) storage.save(WATCH_MIRROR_MIGRATION_KEY, true)
+        }
       })
       loadAllSettingsInFlight = inFlight
       void Promise.resolve(inFlight).then((result) => {

package/src/types/capabilities/even-realities-g1.ts

@@ -68,4 +68,8 @@ export const evenRealitiesG1: Capabilities = {
 
   // OTA capabilities - G1 firmware updates are not driven by the ASG OTA flow
   hasOta: false,
+
+  // The app flashes the bundled Glassly CFW over MCUmgr SMP (see
+  // bluetooth-sdk/ios/Source/Resources/G1Firmware/README.md).
+  hasCustomFirmware: true,
 }

package/src/types/capabilities/memomind-one.ts

@@ -0,0 +1,43 @@
+import type {Capabilities} from "../hardware"
+
+export const memoMindOne: Capabilities = {
+  modelName: "MemoMind One",
+  hasCamera: false,
+  camera: null,
+  hasDisplay: true,
+  display: {
+    // One panel: the vector canvas offers no depth on it.
+    count: 1,
+    isColor: false,
+    canDisplayBitmap: true,
+    resolution: {width: 600, height: 350},
+    width: 600,
+    height: 350,
+    canPosition: true,
+    intensityLevels: 16,
+    partialUpdate: true,
+    adjustBrightness: true,
+    positionRange: {height: {min: 0, max: 8}, depth: {min: 0, max: 8}},
+  },
+  hasMicrophone: true,
+  microphone: {count: 1, hasVAD: false},
+  hasSpeaker: false,
+  speaker: null,
+  hasIMU: false,
+  imu: null,
+  hasButton: true,
+  button: {
+    count: 1,
+    buttons: [{type: "press", events: ["TAP", "DOUBLE_TAP", "PRESS_HOLD", "RELEASE"], isCapacitive: false}],
+  },
+  hasLight: false,
+  light: null,
+  power: {hasExternalBattery: false},
+  hasWifi: false,
+  hasOta: false,
+  hasCustomFirmware: true,
+  hasNativeDashboard: false,
+  hasNativeNavigation: false,
+  hasNativeNotifications: false,
+  hasNotificationRelay: true,
+}

package/src/types/capabilities/rayneo-io.ts

@@ -19,10 +19,11 @@ export const rayneoIO: Capabilities = {
   hasCamera: false,
   camera: null,
 
-  // Display capabilities - single monochrome (1-bit) panel
+  // Display capabilities - a monochrome panel per eye; the Glassly CFW keeps
+  // a scene per lens, so element depth is a real disparity here
   hasDisplay: true,
   display: {
-    count: 1,
+    count: 2,
     isColor: false,
     color: "green",
     // Bitmaps and positioned elements need the Glassly CFW; stock firmware

package/src/types/enums.ts

@@ -13,10 +13,16 @@ export enum DeviceTypes {
   NIMO = "NIMO",
   FRAME = "Brilliant Frame",
   RAYNEO_IO = "RayNeo iO",
+  MEMOMIND_ONE = "MemoMind One",
 }
 
 export enum ControllerTypes {
   R1 = "Even Realities R1",
   NEURAL_BAND = "Meta Neural Band",
   APPLE_WATCH = "Apple Watch",
+  WEAR_OS = "Wear OS Watch",
+  GAMEBRICK = "IINE Gamebrick",
+  IINE_ANANKE = "IINE Ananke Gen 2",
+  ZERO2 = "8BitDo Zero 2",
+  MICRO = "8BitDo Micro",
 }

package/src/types/hardware.ts

@@ -9,6 +9,7 @@ import {mentraLive} from "./capabilities/mentra-live"
 import {simulatedGlasses} from "./capabilities/simulated-glasses"
 import {nimo} from "./capabilities/nimo"
 import {rayneoIO} from "./capabilities/rayneo-io"
+import {memoMindOne} from "./capabilities/memomind-one"
 import {vuzixZ100} from "./capabilities/vuzix-z100"
 import {none} from "./capabilities/none"
 import {DeviceTypes} from "./enums"
@@ -217,6 +218,7 @@ export interface Capabilities {
   // (reading the phone's stream, or an upload from the phone) is the driver's
   // business; the engine only decides who presents.
   hasNativeNotifications?: boolean
+  hasNotificationRelay?: boolean
   // Popup durations the firmware accepts, in seconds (0 = firmware default).
   // Drivers snap other values; the settings UI offers exactly these.
   nativeNotificationPopupSeconds?: number[]
@@ -236,6 +238,7 @@ export const HARDWARE_CAPABILITIES: Record<string, Capabilities> = {
   [vuzixZ100.modelName]: vuzixZ100,
   [nimo.modelName]: nimo,
   [rayneoIO.modelName]: rayneoIO,
+  [memoMindOne.modelName]: memoMindOne,
   [DeviceTypes.MACH1]: vuzixZ100, // Mach1 uses same Vuzix Ultralite hardware as Z100
   [DeviceTypes.AR99]: {
     ...evenRealitiesG1,
@@ -265,4 +268,14 @@ export const getModelCapabilities = (deviceType: DeviceTypes): Capabilities => {
 }
 
 // export * from "./capabilities"
-export {simulatedGlasses, evenRealitiesG1, evenRealitiesG2, mentraLive, vuzixZ100, mentraDisplay, nimo, rayneoIO}
+export {
+  simulatedGlasses,
+  evenRealitiesG1,
+  evenRealitiesG2,
+  mentraLive,
+  vuzixZ100,
+  mentraDisplay,
+  nimo,
+  rayneoIO,
+  memoMindOne,
+}

package/src/utils/display/index.ts

@@ -70,8 +70,8 @@ export {Z100_PROFILE, Z100_HYPHEN_WIDTH_PX, Z100_SPACE_WIDTH_PX} from "./profile
 // Mentra Nex Profile (a.k.a. Mentra Display)
 export {NEX_PROFILE, NEX_HYPHEN_WIDTH_PX, NEX_SPACE_WIDTH_PX} from "./profiles"
 
-// RayNeo iO Profile (stock subtitle page)
-export {RAYNEO_IO_PROFILE, RAYNEO_IO_HYPHEN_WIDTH_PX, RAYNEO_IO_SPACE_WIDTH_PX} from "./profiles"
+// RayNeo iO Profiles (stock subtitle page, Glassly CFW scene page)
+export {RAYNEO_IO_PROFILE, RAYNEO_IO_CFW_PROFILE, RAYNEO_IO_HYPHEN_WIDTH_PX, RAYNEO_IO_SPACE_WIDTH_PX} from "./profiles"
 
 // =============================================================================
 // Measurer - Pixel-accurate text measurement
@@ -274,3 +274,5 @@ export function createNexToolkit(): {
     breakMode: "character-no-hyphen",
   })
 }
+
+export {MEMOMIND_ONE_PROFILE} from "./profiles"

package/src/utils/display/profiles/index.ts

@@ -27,5 +27,12 @@ export {G2_PROFILE, G2_HYPHEN_WIDTH_PX, G2_SPACE_WIDTH_PX} from "./g2"
 // Mentra Nex Profile (a.k.a. Mentra Display)
 export {NEX_PROFILE, NEX_HYPHEN_WIDTH_PX, NEX_SPACE_WIDTH_PX} from "./nex"
 
-// RayNeo iO Profile (stock subtitle page)
-export {RAYNEO_IO_PROFILE, RAYNEO_IO_HYPHEN_WIDTH_PX, RAYNEO_IO_SPACE_WIDTH_PX} from "./rayneo-io"
+// RayNeo iO Profiles (stock subtitle page, Glassly CFW scene page)
+export {
+  RAYNEO_IO_PROFILE,
+  RAYNEO_IO_CFW_PROFILE,
+  RAYNEO_IO_HYPHEN_WIDTH_PX,
+  RAYNEO_IO_SPACE_WIDTH_PX,
+} from "./rayneo-io"
+
+export {MEMOMIND_ONE_PROFILE} from "@glassly/miniapp/display"

package/src/utils/display/profiles/rayneo-io.ts

@@ -1,2 +1,7 @@
 // Moved into the SDK (@glassly/miniapp/display) so miniapps lay text out the way the host measures it; this path re-exports it for the engine.
-export {RAYNEO_IO_PROFILE, RAYNEO_IO_HYPHEN_WIDTH_PX, RAYNEO_IO_SPACE_WIDTH_PX} from "@glassly/miniapp/display"
+export {
+  RAYNEO_IO_PROFILE,
+  RAYNEO_IO_CFW_PROFILE,
+  RAYNEO_IO_HYPHEN_WIDTH_PX,
+  RAYNEO_IO_SPACE_WIDTH_PX,
+} from "@glassly/miniapp/display"

package/src/utils/display/scene/index.ts

@@ -24,7 +24,7 @@ export {resolveAnchors} from "./anchor"
 export type {DiffResult, DiffableElement} from "./differ"
 export {diffScene} from "./differ"
 export type {ProcessedScene} from "./process"
-export {processScene, profileLineHeightPx} from "./process"
+export {processScene, profileLineHeightPx, wrapsOnDevice} from "./process"
 export type {DegradedScene} from "./degrade"
 export {degradeScene} from "./degrade"
 export {SceneStore} from "./store"

package/src/utils/display/scene/process.ts

@@ -9,6 +9,7 @@
  */
 
 import {compileSvgPath} from "./svgPath"
+import {isUnsupportedScript} from "../measurer/script-detection"
 import {TextMeasurer} from "../measurer/TextMeasurer"
 import {TextWrapper} from "../wrapper/TextWrapper"
 import type {DisplayProfile} from "../profiles/types"
@@ -47,6 +48,18 @@ function clampBox(box: SceneBox, width: number, height: number): SceneBox | null
 
 const isFinite = (n: unknown): n is number => typeof n === "number" && Number.isFinite(n)
 
+/**
+ * Text the host cannot wrap: a script the measurer has no widths or break
+ * rules for (Thai has no spaces between words, for one). It is passed through
+ * unwrapped and the device's text engine lays it out in the box.
+ */
+export function wrapsOnDevice(text: string): boolean {
+  for (const char of text) {
+    if (isUnsupportedScript(char)) return true
+  }
+  return false
+}
+
 /** Integer points, or null when the count/values are invalid for the type. */
 function validPoints(el: SceneElementInput): ScenePoint[] | null {
   const raw = (el as {points?: unknown}).points
@@ -372,10 +385,11 @@ export function processScene(
     // Height clipping only applies with a CALIBRATED line height — otherwise
     // the firmware clips vertically in-box (legacy behavior).
     const style: SceneTextStyle = el.style ?? {}
-    if (style.font === "mono" || style.font === "builtin") {
-      // Grid text is laid out by the app (cols × rows) and builtin text by the
-      // glasses' own font engine; the host's proportional wrap metrics don't
-      // apply to either. Pass lines through and let the device clip.
+    if (style.font === "mono" || style.font === "builtin" || wrapsOnDevice(el.text ?? "")) {
+      // Grid text is laid out by the app (cols × rows), builtin text by the
+      // glasses' own font engine and unsupported scripts by the device's text
+      // engine; the host's proportional wrap metrics don't apply to any of
+      // them. Pass lines through and let the device wrap and clip.
       const monoText = el.text ?? ""
       out.push({
         id: el.id,
@@ -390,8 +404,9 @@ export function processScene(
       continue
     }
     const maxLines = lineHeight ? Math.max(1, Math.floor(clamped.h / lineHeight)) : profile.maxLines
+    const maxWidthPx = Math.max(1, clamped.w - 2 * (profile.textInsetPx ?? 0))
     const result = wrapper.wrap(el.text ?? "", {
-      maxWidthPx: clamped.w,
+      maxWidthPx,
       maxLines,
       ...(style.breakMode ? {breakMode: style.breakMode} : {}),
     })
@@ -402,12 +417,12 @@ export function processScene(
         // Trim the last line until it fits WITH the ellipsis appended —
         // otherwise the extra glyph can overflow the clamped box width.
         let last = lines[lines.length - 1]
-        while (last.length > 0 && !measurer.fitsInWidth(`${last}…`, clamped.w)) {
+        while (last.length > 0 && !measurer.fitsInWidth(`${last}…`, maxWidthPx)) {
           last = last.slice(0, -1)
         }
         // A box narrower than the ellipsis glyph itself gets an empty line —
         // never emit a line wider than the clamped box.
-        const ellipsized = last.length > 0 || measurer.fitsInWidth("…", clamped.w) ? `${last}…` : ""
+        const ellipsized = last.length > 0 || measurer.fitsInWidth("…", maxWidthPx) ? `${last}…` : ""
         lines = [...lines.slice(0, -1), ellipsized]
       }
     }