@glassly/engine 0.4.0-beta.1023 → 0.4.0-beta.1045

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/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/settingsBridge.ts

@@ -82,8 +82,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/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

@@ -134,7 +134,7 @@ export const SETTINGS: Record<string, Setting> = {
   },
   memomind_accessory_picker: {
     key: "memomind_accessory_picker",
-    defaultValue: () => false,
+    defaultValue: () => true,
     writable: true,
     saveOnServer: false,
     persist: true,
@@ -333,7 +333,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
@@ -762,12 +762,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,
+    persist: false,
   },
   // glasses settings:
   contextual_dashboard: {

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

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")

package/src/utils/memory/search.ts

@@ -66,9 +66,7 @@ export function searchMemoryEntries<T extends MemorySearchableEntry>(
   const windowCount = Math.max(0, hi - lo)
 
   const needle = q.contains?.trim().toLowerCase() || null
-  const termWords = (q.terms ?? [])
-    .map((t) => tokenize(t))
-    .filter((words) => words.length > 0)
+  const termWords = (q.terms ?? []).map((t) => tokenize(t)).filter((words) => words.length > 0)
 
   const picked: T[] = []
   for (let i = hi - 1; i >= lo && picked.length < q.limit; i--) {
@@ -154,11 +152,23 @@ export function editDistanceAtMost(a: string, b: string, max: number): boolean {
 }
 
 const SOUNDEX_CODES: Record<string, string> = {
-  b: "1", f: "1", p: "1", v: "1",
-  c: "2", g: "2", j: "2", k: "2", q: "2", s: "2", x: "2", z: "2",
-  d: "3", t: "3",
+  b: "1",
+  f: "1",
+  p: "1",
+  v: "1",
+  c: "2",
+  g: "2",
+  j: "2",
+  k: "2",
+  q: "2",
+  s: "2",
+  x: "2",
+  z: "2",
+  d: "3",
+  t: "3",
   l: "4",
-  m: "5", n: "5",
+  m: "5",
+  n: "5",
   r: "6",
 }