@glassly/engine 0.3.8-dev.980 → 0.3.8-dev.982

package/src/services/LocalDisplayManager.ts

@@ -489,6 +489,11 @@ class LocalDisplayManager {
     }
   }
 
+  /** A frame for native to keep warm, never shown (SceneRenderer.prefetchScene). */
+  public prefetch(packageName: string, view: "main" | "dashboard", elements: SceneElementInput[]): boolean {
+    return sceneRenderer.prefetchScene(packageName, view, elements)
+  }
+
   /**
    * The overlay slot only; bypasses arbitration and main ownership state.
    * Frames from an owner other than the slot's are dropped. Returns the scene

package/src/services/LocalMiniappRuntime.ts

@@ -1495,6 +1495,9 @@ class LocalMiniappRuntime {
       case MiniappRequestType.SHOW_VIEW:
         this.handleShowView(packageName, payload, requestId)
         break
+      case MiniappRequestType.PREFETCH:
+        this.handlePrefetch(packageName, payload, requestId)
+        break
       case MiniappRequestType.SETTINGS_GET:
         this.handleSettingsGet(packageName, payload, requestId)
         break
@@ -2651,6 +2654,27 @@ class LocalMiniappRuntime {
     )
   }
 
+  /**
+   * display.prefetch: the active dashboard hands over the frame its view would
+   * show if opened now. Native keeps its fonts and images on the glasses while
+   * nothing is on screen; nothing is displayed or retained here.
+   */
+  private handlePrefetch(packageName: string, payload: Record<string, unknown>, requestId?: string): void {
+    if (payload.view !== "dashboard" || !Array.isArray(payload.elements)) {
+      this.sendResult(packageName, requestId, false, undefined, {
+        code: MiniappErrorCode.INVALID_ARGUMENT,
+        message: 'prefetch takes the "dashboard" view and an elements array',
+      })
+      return
+    }
+    if (!this.connectedApps.has(packageName) || !isDashboardApp(packageName) || !isOverlayApp(packageName)) {
+      this.sendResult(packageName, requestId, true, {status: "unsupported", reason: "not the active dashboard"})
+      return
+    }
+    const sent = localDisplayManager.prefetch(packageName, "dashboard", payload.elements as NonNullable<DisplayPayload["scene"]>)
+    this.sendResult(packageName, requestId, true, sent ? {status: "queued"} : {status: "unsupported", reason: "no scene display"})
+  }
+
   /**
    * Reject the request with PERMISSION_NOT_DECLARED unless the caller's
    * manifest declares `permission`. System apps pass without declaring it.

package/src/services/SceneRenderer.ts

@@ -283,6 +283,34 @@ class SceneRenderer {
     }
   }
 
+  /**
+   * Hand native the frame `elements` would make for (app, view) without
+   * showing it or touching the retained scene: drivers with an on-glass asset
+   * cache upload its fonts and images while the panel is idle. Every element
+   * is "created" and the frame carries seq 0 (no presentation report). Empty
+   * elements drop it. False when there is nothing to send it to.
+   */
+  public prefetchScene(appId: string, view: "main" | "dashboard", elements: SceneElementInput[]): boolean {
+    const caps = this.currentCapabilities()
+    if (!caps?.canPosition) return false
+    const processed = processScene(resolveAnchors(elements, caps.width, caps.height), caps, displayProcessor.getSceneProfile())
+    let synthetic = 0
+    const {elements: created} = diffScene([], processed.elements, () => `~prefetch${synthetic++}`)
+    const frame: SceneFrame = {
+      appId,
+      view,
+      sceneEpoch: 0,
+      seq: 0,
+      elements: created,
+      removed: [],
+      canvas: {width: caps.width, height: caps.height},
+    }
+    void Promise.resolve(BluetoothSdk.displayEvent({view, scene: frame, prefetch: true})).catch((err) => {
+      console.error(`${LOG_TAG}: native prefetch failed:`, err)
+    })
+    return true
+  }
+
   /**
    * Re-emit an app's retained scene (reconnect / arbitration restore). Replay
    * is always create-based — the device rebuilds from scratch (spec §4).

package/src/stores/apps.ts

@@ -388,17 +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)
-      // The running background only knows the source of its spawn.
-      if (app.local) miniappLauncher.notifyLaunch(packageName, opts?.launchSource ?? "phone")
-      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.
@@ -411,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)),
     }))