@glassly/engine 0.4.0 → 0.4.1-beta.1138

package/src/services/SupportProfileSync.ts

@@ -83,6 +83,8 @@ function armDebounce(generation: number): void {
 
 async function sendCurrentSnapshot(force: boolean, generation = syncGeneration): Promise<void> {
   if (!unsubscribe || generation !== syncGeneration) return
+  // Every send would fail into the retry backoff with no client to send through.
+  if (cloudClientService.isCloudDisabled()) return
   if (sendingGeneration === generation) {
     const fingerprint = snapshotFingerprint(buildSnapshot())
     if (fingerprint !== lastSentFingerprint) queuedFingerprint = fingerprint

package/src/services/TranscriptionRouting.ts

@@ -1,3 +1,21 @@
+import type {TranscriptionSubscription} from "@glassly/cloud-protocol"
+
+/** Match a provider result to a logical miniapp subscription. */
+export function matchesTranscriptionSubscription(
+  stream: string,
+  resolvedStream: string,
+  subscription: TranscriptionSubscription,
+): boolean {
+  const prefix = "transcription:"
+  if (!stream.startsWith(prefix) || !resolvedStream.startsWith(prefix)) return false
+  if (subscription.language.mode === "specific") return stream === `${prefix}${subscription.language.code}`
+  if (stream === `${prefix}auto`) return true
+  // Providers detect ISO language codes; miniapps request regional BCP-47 tags.
+  // Unknown language stays auto-only until the recognizer identifies it.
+  const detected = resolvedStream.slice(prefix.length).split("-")[0].toLowerCase()
+  return detected !== "auto" && detected !== "" && stream.slice(prefix.length).split("-")[0].toLowerCase() === detected
+}
+
 export interface TranscriptionRouteSummary {
   hasCloudSubscriber: boolean
   hasForceLocalSubscriber: boolean

package/src/services/UIRouter.ts

@@ -193,9 +193,7 @@ export class UIRouter {
       const cancel = {type: "cancel", requestId: uiSendPayload.requestId}
       const literal = JSON.stringify(cancel)
       const escaped = JSON.stringify(literal)
-      binding.inject(
-        `if (window.__host && window.__host.recv) window.__host.recv(JSON.parse(${escaped})); true;`,
-      )
+      binding.inject(`if (window.__host && window.__host.recv) window.__host.recv(JSON.parse(${escaped})); true;`)
       return
     }
     const outbound: Record<string, unknown> = {
@@ -207,9 +205,7 @@ export class UIRouter {
     if (typeof uiSendPayload.requestId === "string") outbound.requestId = uiSendPayload.requestId
     const literal = JSON.stringify(outbound)
     const escaped = JSON.stringify(literal)
-    binding.inject(
-      `if (window.__host && window.__host.recv) window.__host.recv(JSON.parse(${escaped})); true;`,
-    )
+    binding.inject(`if (window.__host && window.__host.recv) window.__host.recv(JSON.parse(${escaped})); true;`)
   }
 
   /**
@@ -222,9 +218,7 @@ export class UIRouter {
     if (!binding) return
     const literal = JSON.stringify(frame)
     const escaped = JSON.stringify(literal)
-    binding.inject(
-      `if (window.__host && window.__host.recv) window.__host.recv(JSON.parse(${escaped})); true;`,
-    )
+    binding.inject(`if (window.__host && window.__host.recv) window.__host.recv(JSON.parse(${escaped})); true;`)
   }
 
   /**

package/src/services/controllers.ts

@@ -57,6 +57,7 @@ const INPUT_SURFACES: Readonly<Record<string, readonly InputSurface[]>> = {
   [ControllerTypes.IINE_ANANKE]: [GAMEBRICK_SURFACE],
   [ControllerTypes.ZERO2]: [GAMEBRICK_SURFACE],
   [ControllerTypes.MICRO]: [GAMEBRICK_SURFACE],
+  [ControllerTypes.CRKD_ATOM_PLUS]: [GAMEBRICK_SURFACE],
   [ControllerTypes.R1]: [],
 }
 

package/src/services/effectiveCapabilities.ts

@@ -61,8 +61,9 @@ function glassesCapabilities(model: DeviceTypes): Capabilities {
   // Glassly CFW supports the complete vector contract, including SVG and rotation.
   // Upstream g2flash publishes a raster canvas with sceneVector=false.
   const vector = useGlassesStore.getState().sceneVector === true
-  // Depth is a disparity between the lenses; one panel (MemoMind One) draws every element flat.
-  const stereo = (base.display.count ?? 1) >= 2
+  // Depth is a disparity between the eyes: a lens per eye, or firmware that
+  // presents a separate raster to each eye's panel (MemoMind One CFW 22+).
+  const stereo = (base.display.count ?? 1) >= 2 || useGlassesStore.getState().sceneStereo === true
   return {
     ...(volumeGate ? withVolumeGate(base) : base),
     hasNativeNavigation: resolveNativeNavigation(base.hasNativeNavigation, true, forceNativeNavigationOnCfw()),

package/src/services/gestureDotGlyphs.ts

@@ -4,18 +4,23 @@
  */
 export const GESTURE_DOT_GLYPH_SIZE = 24
 
-export type GestureDotGlyph = "dot" | "double" | "ring" | "doubleRing" | "up" | "down" | "left" | "right" | "hold" | "holdRing" | "blank"
+export type GestureDotGlyph =
+  "dot" | "double" | "ring" | "doubleRing" | "up" | "down" | "left" | "right" | "hold" | "holdRing" | "blank"
 
 export const GESTURE_DOT_GLYPHS: Record<GestureDotGlyph, string> = {
   dot: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAALklEQVR4nM2QsQ0AAAjC/P/pmrhqZ+xIF6DqBQyWbwO3gduAmKjQuj7QL/ETEzQmMptl7Q9NBAAAAABJRU5ErkJggg==",
-  double: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAG0lEQVR4nGNgGD7gPxjgYkN4yOyBlcDp3GEBAB3sd4lPaQxDAAAAAElFTkSuQmCC",
+  double:
+    "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAG0lEQVR4nGNgGD7gPxjgYkN4yOyBlcDp3GEBAB3sd4lPaQxDAAAAAElFTkSuQmCC",
   ring: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAANElEQVR4nGNgGBTgPxjgEseUgQphyCD4qDL/kSX+Y9WApoWqEjgsx+lc3B7EHSS4A3EgAAC+cEu1JTNREQAAAABJRU5ErkJggg==",
-  doubleRing: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAIklEQVR4nGNgGD7gPxjgYkN4yGwGmBA6SV0JHJbjdO6wAADBMlep8zl7TAAAAABJRU5ErkJggg==",
+  doubleRing:
+    "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAIklEQVR4nGNgGD7gPxjgYkN4yGwGmBA6SV0JHJbjdO6wAADBMlep8zl7TAAAAABJRU5ErkJggg==",
   up: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAMElEQVR4nGNgoCv4////f1zi2GT+/4ciTHE4RhdHIlDFUUhkcTQKQx9WBw8PCVoBAIcbOcf3xeeBAAAAAElFTkSuQmCC",
   down: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAALUlEQVR4nGNgoC/4/3+4SkBFUCkkNjKJIoMg0GRgGEMGgrC4CQSwuxanR2gEAO1/Ocfgp8uvAAAAAElFTkSuQmCC",
   left: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAI0lEQVR4nGNgoCv4j0sch8RAiTP8RwPESOAwajDI4JKgGQAAKO05x7DqJxIAAAAASUVORK5CYII=",
-  right: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAIElEQVR4nGNgoDf4j1NiMMn8RwOEJYizZKDEcQc7bQAAS7w5x+ro2lsAAAAASUVORK5CYII=",
+  right:
+    "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAIElEQVR4nGNgoDf4j1NiMMn8RwOEJYizZKDEcQc7bQAAS7w5x+ro2lsAAAAASUVORK5CYII=",
   hold: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAR0lEQVR4nGNgIAj+gwF2UUy5//+xyyDzcLGRedjMhTEwXAKl0Z0Lof7DKbgMhBpQCZzOxedBHEGCMxAJBTXhKGRAA9hFMQEANr7jHQU9fO0AAAAASUVORK5CYII=",
-  holdRing: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAQ0lEQVR4nGNgIAj+gwF2UUy5//+xyyDzcLGRedjMhTEwXAKlMd2IVQNMaEAlcDoXnwdxBAnOQCQU1ISjEIvjsYhiAgAo9KdZzePY3AAAAABJRU5ErkJggg==",
+  holdRing:
+    "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAQ0lEQVR4nGNgIAj+gwF2UUy5//+xyyDzcLGRedjMhTEwXAKlMd2IVQNMaEAlcDoXnwdxBAnOQCQU1ISjEIvjsYhiAgAo9KdZzePY3AAAAABJRU5ErkJggg==",
   blank: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAD0lEQVR4nGNgGAWjgPoAAAJYAAGgxYwDAAAAAElFTkSuQmCC",
 }

package/src/services/manifestActions.ts

@@ -80,7 +80,8 @@ export function normalizeManifestActions(raw: unknown): DeclaredAction[] {
 }
 
 const WIDGET_SIZES: readonly DeclaredWidgetSize[] = ["XS", "XSM", "SM", "MD", "LG"]
-const isWidgetSize = (value: unknown): value is DeclaredWidgetSize => (WIDGET_SIZES as readonly unknown[]).includes(value)
+const isWidgetSize = (value: unknown): value is DeclaredWidgetSize =>
+  (WIDGET_SIZES as readonly unknown[]).includes(value)
 
 /**
  * Normalize manifest widgets for installed and dev-sideloaded bundles: an

package/src/services/neuralBand/MetaAuth.ts

@@ -41,17 +41,45 @@ export function isLoginCallback(url: string): boolean {
   return url.toLowerCase().startsWith("fb-viewapp:") || url.includes("frl_login")
 }
 
+function queryPairs(url: string): [string, string][] {
+  const withoutFragment = url.includes("#") ? url.slice(0, url.indexOf("#")) : url
+  const query = withoutFragment.includes("?") ? withoutFragment.slice(withoutFragment.indexOf("?") + 1) : ""
+  const pairs: [string, string][] = []
+  for (const pair of query.split("&")) {
+    if (!pair) continue
+    const eq = pair.indexOf("=")
+    pairs.push(eq === -1 ? [pair, ""] : [pair.slice(0, eq), pair.slice(eq + 1)])
+  }
+  return pairs
+}
+
+function decodeValue(value: string): string {
+  try {
+    return decodeURIComponent(value)
+  } catch {
+    return value
+  }
+}
+
 export function callbackQuery(url: string): {token?: string; blob?: string} {
-  const query = url.includes("?") ? url.slice(url.indexOf("?") + 1) : ""
   const out: {token?: string; blob?: string} = {}
-  for (const pair of query.split("&")) {
-    const [key, value = ""] = pair.split("=")
-    if (key === "token") out.token = decodeURIComponent(value)
-    if (key === "blob") out.blob = decodeURIComponent(value)
+  for (const [key, value] of queryPairs(url)) {
+    if (key === "token") out.token = decodeValue(value)
+    if (key === "blob") out.blob = decodeValue(value)
   }
   return out
 }
 
+export function callbackShape(url: string): string {
+  const scheme = url.includes(":") ? url.slice(0, url.indexOf(":")) : "-"
+  const afterScheme = url.slice(scheme.length + 1)
+  const pathEnd = afterScheme.search(/[?#]/)
+  const path = pathEnd === -1 ? afterScheme : afterScheme.slice(0, pathEnd)
+  const keys = queryPairs(url).map(([key, value]) => `${key}:${value.length}`)
+  const fragment = url.includes("#") ? ` fragment=${url.slice(url.indexOf("#") + 1).length}` : ""
+  return `${scheme}:${path} query=[${keys.join(",")}]${fragment}`
+}
+
 /** The first 16 hex digits of the request token's SHA-256, which the callback must present. */
 export function expectedCallbackToken(nativeSsoToken: string): string {
   return sha256Hex(nativeSsoToken).slice(0, 16)
@@ -99,11 +127,12 @@ async function post(url: string, headers: Record<string, string>, body: string):
   } catch {
     json = null
   }
+  const error = json?.error as {code?: number; error_subcode?: number} | null | undefined
   if (response.status !== 200 || json === null) {
-    throw new MetaAuthError(`Meta sign-in failed (HTTP ${response.status}). Try again.`)
+    const code = error ? `, code ${error.code ?? "-"}` : ""
+    throw new MetaAuthError(`Meta sign-in failed (HTTP ${response.status}${code}). Try again.`)
   }
-  if (json.error !== undefined) {
-    const error = json.error as {code?: number; error_subcode?: number} | null
+  if (error !== undefined) {
     throw new MetaAuthError(
       `Meta sign-in failed (code ${error?.code ?? "-"}, subcode ${error?.error_subcode ?? "-"}). Try again.`,
     )

package/src/services/notificationAppPayload.ts

@@ -0,0 +1,15 @@
+/** Keep installed-app icons from exhausting the miniapp's 32 MiB JS heap.
+ * Icons are optional; clients already render a fallback when one is absent.
+ * Bound both individual icons and their total before JSON crosses the bridge.
+ */
+export function notificationAppPayload(
+  apps: Array<{packageName: string; appName: string; icon: string | null}>,
+): Array<{packageName: string; appName: string; icon: string | null}> {
+  let remaining = 128 * 1024
+  return apps.map(({packageName, appName, icon}) => {
+    const size = icon?.length ?? 0
+    const keep = size <= 8 * 1024 && size <= remaining
+    if (keep) remaining -= size
+    return {packageName, appName, icon: keep ? icon : null}
+  })
+}

package/src/services/notifications/miniappNotifications.ts

@@ -0,0 +1,53 @@
+/**
+ * Notifications miniapps post (`session.phone.notifications.post`) on their
+ * way into the host's phone-notification path. The runtime validates and
+ * emits here; the host subscribes through `engine.phoneNotifications` and
+ * feeds them to the same fan-out as the phone's own, with `system: false`
+ * and `source` set, so the dashboard, other readers and presentation treat
+ * them alike.
+ */
+export interface MiniappNotificationPosted {
+  type: "posted"
+  notificationId: string
+  source: string
+  app: string
+  title: string
+  content: string
+  timestamp: number
+}
+
+export interface MiniappNotificationDismissed {
+  type: "dismissed"
+  notificationId: string
+  source: string
+  timestamp: number
+}
+
+export type MiniappNotificationEvent = MiniappNotificationPosted | MiniappNotificationDismissed
+
+export const MINIAPP_NOTIFICATION_TITLE_MAX = 200
+export const MINIAPP_NOTIFICATION_CONTENT_MAX = 2_000
+export const MINIAPP_NOTIFICATION_ID_MAX = 128
+
+const listeners = new Set<(event: MiniappNotificationEvent) => void>()
+
+export function miniappNotificationId(source: string, id: string): string {
+  return `${source}:${id}`
+}
+
+export function emitMiniappNotification(event: MiniappNotificationEvent): void {
+  for (const listener of listeners) {
+    try {
+      listener(event)
+    } catch (err) {
+      console.warn(`miniappNotifications: listener threw: ${(err as Error)?.message ?? err}`)
+    }
+  }
+}
+
+export function onMiniappNotification(listener: (event: MiniappNotificationEvent) => void): () => void {
+  listeners.add(listener)
+  return () => {
+    listeners.delete(listener)
+  }
+}

package/src/services/pages/pageEligibility.ts

@@ -21,11 +21,12 @@ export function isCfwFirmwareVersion(firmwareVersion: string | null | undefined)
 
 /**
  * Only models that ship a Glassly custom firmware, and only while they run it.
- * Stock firmware on those models and every other model (NIMO, G1, ...) are
- * intentionally excluded.
+ * Stock firmware and every other model are intentionally excluded.
  */
 export function isCustomDashboardEligible(info: {model?: string | null; firmwareVersion?: string | null}): boolean {
   if (!info.model) return false
+  // The NIMO drivers draw no scenes through its CFW yet; the dashboard would land on the text page.
+  if (info.model === DeviceTypes.NIMO) return false
   if (info.model === DeviceTypes.MEMOMIND_ONE) {
     const match = /^GLASSLYCFW\/([0-9]+)$/.exec(info.firmwareVersion ?? "")
     const revision = match ? Number(match[1]) : 0

package/src/services/settingsBridge.ts

@@ -23,7 +23,6 @@ export type SettingsBridgeAccess = "read" | "write"
 export const SETTINGS_BRIDGE_KEYS: Readonly<Record<string, SettingsBridgeAccess>> = {
   // The dashboard's master switch is a phone-side debug knob.
   custom_dashboard_enabled: "read",
-  contextual_dashboard: "write",
   head_up_angle: "write",
   // Where the glasses draw; each model's steps are its display.positionRange.
   dashboard_depth: "write",
@@ -33,7 +32,6 @@ export const SETTINGS_BRIDGE_KEYS: Readonly<Record<string, SettingsBridgeAccess>
   auto_brightness: "write",
   // Per paired model: the store resolves the indexed key.
   preferred_mic: "write",
-  twelve_hour_time: "write",
   menu_apps: "write",
   notifications_enabled: "write",
   notifications_popups: "write",
@@ -82,8 +80,7 @@ export function selectSettingsBridgeKeys(requested: unknown): string[] {
 }
 
 export type SettingsSetValidation =
-  | {ok: true; key: string; value: unknown}
-  | {ok: false; code: "INVALID_ARGUMENT" | "NOT_PERMITTED"; message: string}
+  {ok: true; key: string; value: unknown} | {ok: false; code: "INVALID_ARGUMENT" | "NOT_PERMITTED"; message: string}
 
 /** A SETTINGS_SET payload: a writable key and a JSON value (undefined is not a value). */
 export function validateSettingsSet(payload: Record<string, unknown>): SettingsSetValidation {

package/src/services/uiShim.ts

@@ -304,6 +304,13 @@ export function buildUiShim(options: UiShimOptions): string {
     postEnvelope({ type: 'set_background', color: color });
   }
 
+  var backHandler = null;
+
+  function setBackActionFn(handler) {
+    backHandler = typeof handler === 'function' ? handler : null;
+    postEnvelope({ type: 'set_back_action', shown: backHandler !== null });
+  }
+
   function fireChannel(channel, payload) {
     var list = channelHandlers[channel];
     if (!list || list.length === 0) {
@@ -348,6 +355,12 @@ export function buildUiShim(options: UiShimOptions): string {
       }
       return;
     }
+    if (type === 'back') {
+      if (backHandler) {
+        try { backHandler(); } catch (e) {}
+      }
+      return;
+    }
     if (type === 'cancel' && typeof envelope.requestId === 'string') {
       // Background-side cancel (reserved; currently unused). If we had a
       // future bidirectional RPC this would abort an in-flight UI handler.
@@ -366,6 +379,7 @@ export function buildUiShim(options: UiShimOptions): string {
     onClose: onClose,
     ready: readyFn,
     setBackgroundColor: setBackgroundColorFn,
+    setBackAction: setBackActionFn,
     /** @internal — packageName for diagnostic logs only. */
     _packageName: packageName,
   };

package/src/stores/appVisibility.ts

@@ -44,8 +44,5 @@ export const isGatedByDevTools = (packageName: string, devToolsEnabled: boolean)
 export const PAIRED_GLASSES_PACKAGES: ReadonlySet<string> = new Set(["com.glassly.store"])
 
 /** True when the app waits on a pairing that hasn't happened and dev tools are off. */
-export const isGatedUntilPaired = (
-  packageName: string,
-  devToolsEnabled: boolean,
-  hasPairedGlasses: boolean,
-): boolean => !devToolsEnabled && !hasPairedGlasses && PAIRED_GLASSES_PACKAGES.has(packageName)
+export const isGatedUntilPaired = (packageName: string, devToolsEnabled: boolean, hasPairedGlasses: boolean): boolean =>
+  !devToolsEnabled && !hasPairedGlasses && PAIRED_GLASSES_PACKAGES.has(packageName)

package/src/stores/gallerySync.ts

@@ -29,13 +29,7 @@ export interface PhotoInfo {
 
 // Sync state machine states
 export type SyncState =
-  | "idle"
-  | "requesting_hotspot"
-  | "connecting_wifi"
-  | "syncing"
-  | "complete"
-  | "error"
-  | "cancelled"
+  "idle" | "requesting_hotspot" | "connecting_wifi" | "syncing" | "complete" | "error" | "cancelled"
 
 export interface HotspotInfo {
   ssid: string

package/src/stores/glasses.ts

@@ -144,6 +144,7 @@ const initialState: GlassesStore = {
   sceneCanvasWidth: 0,
   sceneCanvasHeight: 0,
   sceneVector: false,
+  sceneStereo: false,
   sceneSettle: false,
   volumeGate: false,
   firmwareUpdateAvailable: false,

package/src/stores/settings.ts

@@ -132,13 +132,6 @@ 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,
@@ -333,7 +326,7 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: false,
     persist: true,
   },
-  // User-supplied AI/voice provider keys (Settings > API Keys). Not consumed
+  // User-supplied AI/voice provider keys (Settings > Privacy > API Keys). Not consumed
   // by the app itself — they exist so miniapps declaring the API_KEYS manifest
   // permission can read them via session.keys.get() (see
   // MINIAPP_READABLE_API_KEYS in LocalMiniappRuntime; mapbox is also readable
@@ -715,13 +708,6 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: true,
     persist: true,
   },
-  twelve_hour_time: {
-    key: "twelve_hour_time",
-    defaultValue: () => true,
-    writable: true,
-    saveOnServer: true,
-    persist: true,
-  },
   enforce_local_transcription: {
     key: "enforce_local_transcription",
     defaultValue: () => false,
@@ -762,20 +748,14 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: true,
     persist: true,
   },
+  // Session-only: Position settings holds it on for stock G1, and a persisted
+  // true (app killed on that screen) blanks every glasses' display at boot.
   screen_disabled: {
     key: "screen_disabled",
     defaultValue: () => false,
     writable: true,
     saveOnServer: false,
-    persist: true,
-  },
-  // glasses settings:
-  contextual_dashboard: {
-    key: "contextual_dashboard",
-    defaultValue: () => false,
-    writable: true,
-    saveOnServer: true,
-    persist: true,
+    persist: false,
   },
   // Debug escape hatch: G2 scene rendering through the Glassly CFW
   // direct-framebuffer path (rasterized mode-3 frames into the carrier).
@@ -948,6 +928,13 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: false,
     persist: true,
   },
+  debug_mirror_rail: {
+    key: "debug_mirror_rail",
+    defaultValue: () => false,
+    writable: true,
+    saveOnServer: false,
+    persist: true,
+  },
   home_offline_card: {
     key: "home_offline_card",
     defaultValue: () => true,
@@ -955,6 +942,13 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: false,
     persist: true,
   },
+  home_tips_seen: {
+    key: "home_tips_seen",
+    defaultValue: (): string[] => [],
+    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.
@@ -988,6 +982,13 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: true,
     persist: true,
   },
+  dashboard_size: {
+    key: "dashboard_size",
+    defaultValue: () => 340,
+    writable: true,
+    saveOnServer: true,
+    persist: true,
+  },
   menu_apps: {
     key: "menu_apps",
     defaultValue: () => null,
@@ -1252,22 +1253,20 @@ export const BLUETOOTH_SETTING_KEYS: string[] = [
   SETTINGS.screen_disabled.key,
   SETTINGS.auth_email.key,
   SETTINGS.core_token.key,
-  // glasses settings (contextual_dashboard is phone-side policy now — native
-  // no longer reads it):
+  // glasses settings:
   SETTINGS.head_up_angle.key,
   SETTINGS.brightness.key,
   SETTINGS.auto_brightness.key,
   SETTINGS.dashboard_height.key,
   SETTINGS.dashboard_depth.key,
+  SETTINGS.dashboard_size.key,
   SETTINGS.menu_apps.key,
   SETTINGS.calendar_events.key,
   SETTINGS.cfw_scene_renderer.key,
   SETTINGS.cfw_fast_ble.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,
   SETTINGS.metric_system.key,
   // button:
   SETTINGS.button_photo_size.key,

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

@@ -72,4 +72,9 @@ export const evenRealitiesG1: Capabilities = {
   // The app flashes the bundled Glassly CFW over MCUmgr SMP (see
   // bluetooth-sdk/ios/Source/Resources/G1Firmware/README.md).
   hasCustomFirmware: true,
+
+  // On iOS the Glassly CFW (G1CFW/51) relays the notifications the phone shares
+  // with the glasses over ANCS; the dashboard presents them.
+  hasNativeNotifications: false,
+  hasNotificationRelay: true,
 }

package/src/types/capabilities/nimo.ts

@@ -18,21 +18,34 @@ export const nimo: Capabilities = {
   hasCamera: false,
   camera: null,
 
-  // Display capabilities - monochrome binocular display
+  // Display capabilities - monochrome binocular display. Firmware 0.1.1.1+
+  // has a phone-drawn page (app 0xFD): a 500x220 canvas of positioned text,
+  // rectangles, circles, lines and bitmaps that the drivers render scene
+  // frames onto (NimoDynamicLayout.kt / .swift). Older firmware shows the
+  // frame's text on the ASR note page instead.
   hasDisplay: true,
   display: {
     count: 2,
     isColor: false,
     color: "green",
     canDisplayBitmap: true,
-    // Bitmaps render into the nav mini-map widget (appId 0x01, 160x160 2bpp);
-    // see displayBitmap in Nimo.kt / Nimo.swift. The resolution below is the
-    // text-display placeholder, not the bitmap target.
-    // TODO: placeholder - verify against hardware screen info
-    resolution: {width: 640, height: 400},
-    maxTextLines: 5,
+    resolution: {width: 540, height: 280},
+    maxTextLines: 10,
     adjustBrightness: true,
     positionRange: {height: {min: 0, max: 10}, depth: {min: 0, max: 10}},
+
+    // Scene display API - the Dynamic Layout canvas.
+    width: 500,
+    height: 220,
+    canPosition: true,
+    // One page holds 64 objects; the text pool is shared with rectangles.
+    maxTextElements: 32,
+    maxImageElements: 4,
+    maxImagePx: {width: 500, height: 220},
+    shapes: ["rect", "circle", "line"],
+    intensityLevels: 16,
+    // Every frame replaces the page; the firmware has no per-object update.
+    partialUpdate: false,
   },
 
   // Microphone capabilities - Nimo streams Opus audio from both arms
@@ -82,4 +95,7 @@ export const nimo: Capabilities = {
 
   // OTA capabilities - Nimo firmware updates are not driven by the ASG OTA flow
   hasOta: false,
+
+  // The drivers flash a bundled Glassly CFW over the GATT OTA characteristics.
+  hasCustomFirmware: true,
 }

package/src/types/enums.ts

@@ -25,4 +25,5 @@ export enum ControllerTypes {
   IINE_ANANKE = "IINE Ananke Gen 2",
   ZERO2 = "8BitDo Zero 2",
   MICRO = "8BitDo Micro",
+  CRKD_ATOM_PLUS = "CRKD ATOM+",
 }

package/src/utils/display/index.ts

@@ -36,7 +36,7 @@
 // =============================================================================
 
 // Import for factory functions
-import {G1_PROFILE_LEGACY, G2_PROFILE, Z100_PROFILE, NEX_PROFILE} from "./profiles"
+import {G1_PROFILE_LEGACY, G2_PROFILE, Z100_PROFILE, NEX_PROFILE, G1_PROFILE} from "./profiles"
 
 // =============================================================================
 // Convenience factory functions
@@ -46,7 +46,6 @@ import {TextMeasurer} from "./measurer"
 import {TextWrapper} from "./wrapper"
 import {DisplayHelpers} from "./helpers"
 import {ColumnComposer} from "./composer"
-import {G1_PROFILE} from "./profiles"
 import type {DisplayProfile} from "./profiles"
 import type {WrapOptions} from "./wrapper"
 
@@ -276,3 +275,4 @@ export function createNexToolkit(): {
 }
 
 export {MEMOMIND_ONE_PROFILE} from "./profiles"
+export {NIMO_PROFILE} from "./profiles"

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

@@ -36,3 +36,5 @@ export {
 } from "./rayneo-io"
 
 export {MEMOMIND_ONE_PROFILE} from "@glassly/miniapp/display"
+
+export {NIMO_PROFILE} from "./nimo"

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

@@ -0,0 +1,2 @@
+// 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 {NIMO_PROFILE} from "@glassly/miniapp/display"

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

@@ -128,7 +128,7 @@ export function compileSvgPath(d: string): {commands: number[]; edges: number} {
     curve(a, depth + 1)
     curve(b, depth + 1)
   }
-  for (let i = 0; i < commands.length; ) {
+  for (let i = 0; i < commands.length;) {
     const op = commands[i++],
       pairs = op === 4 ? 0 : op === 3 ? 3 : op === 2 ? 2 : 1
     if (++count > 1024) throw new Error("SVG path exceeds 1024 commands")