@glassly/engine 0.1.0-dev.98 → 0.2.8-dev.445

package/build/services/mirrorSnapshot.d.ts

@@ -0,0 +1,16 @@
+import type { MirrorSnapshot } from "@glassly/miniapp";
+export interface MirrorSource {
+    event: unknown;
+    canvas: {
+        width: number;
+        height: number;
+    } | null;
+    connected: boolean;
+    model: string | null;
+    battery: number;
+    measureChar: (char: string) => number;
+    now: number;
+}
+/** Copy and normalize host layouts at the public boundary; never leak store references. */
+export declare function buildMirrorSnapshot(source: MirrorSource, revision: number): MirrorSnapshot;
+//# sourceMappingURL=mirrorSnapshot.d.ts.map

package/build/services/mirrorSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirrorSnapshot.d.ts","sourceRoot":"","sources":["../../src/services/mirrorSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA+B,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAElF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAA;IAC9C,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACrC,GAAG,EAAE,MAAM,CAAA;CACZ;AAOD,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAiG1F"}

package/build/services/mirrorSnapshot.js

@@ -0,0 +1,102 @@
+const object = (v) => v !== null && typeof v === "object" && !Array.isArray(v) ? v : {};
+const number = (v, fallback = 0) => (typeof v === "number" && Number.isFinite(v) ? v : fallback);
+const string = (v) => (typeof v === "string" ? v : "");
+/** Copy and normalize host layouts at the public boundary; never leak store references. */
+export function buildMirrorSnapshot(source, revision) {
+    const { now, connected, model, measureChar } = source;
+    const event = object(source.event);
+    const layout = object(event.layout);
+    let canvas = source.canvas;
+    let content = { kind: "empty" };
+    const widths = {};
+    const date = new Date(now);
+    const pad = (n) => String(n).padStart(2, "0");
+    const parseText = (value) => {
+        const text = string(value)
+            .replace(/\$DATE\$/g, `${pad(date.getMonth() + 1)}/${pad(date.getDate())}`)
+            .replace(/\$TIME12\$/g, `${pad(date.getHours() % 12 || 12)}:${pad(date.getMinutes())}`)
+            .replace(/\$TIME24\$/g, `${pad(date.getHours())}:${pad(date.getMinutes())}`)
+            .replace(/\$GBATT\$/g, source.battery >= 0 ? `${source.battery}%` : "")
+            .replace(/\$CONNECTION_STATUS\$/g, connected ? "Connected" : "Disconnected");
+        for (const char of text)
+            widths[char] = measureChar(char);
+        return text;
+    };
+    const textElement = (id, text, x, y, w, h) => ({
+        id,
+        type: "text",
+        text: parseText(text),
+        box: { x, y, w, h },
+        change: "created",
+    });
+    if (!canvas)
+        content = { kind: "unavailable", reason: "no-display" };
+    else if (layout.layoutType === "unavailable")
+        content = { kind: "unavailable", reason: string(layout.reason) || "unknown" };
+    else if (layout.layoutType === "scene") {
+        canvas = { width: number(layout.width, canvas.width), height: number(layout.height, canvas.height) };
+        const elements = [];
+        for (const raw of Array.isArray(layout.elements) ? layout.elements : []) {
+            const el = object(raw);
+            if (typeof el.id !== "string" || typeof el.type !== "string" || !el.box)
+                continue;
+            // SceneRenderer produces validated FrameElements. Serialization strips
+            // references; private native compiler/hash fields stay inside the host.
+            const { path: _path, contentHash: _hash, ...copy } = JSON.parse(JSON.stringify(el));
+            if (copy.type === "text")
+                copy.text = parseText(copy.text);
+            elements.push(copy);
+        }
+        content = elements.length ? { kind: "scene", elements, epoch: number(layout.sceneEpoch) } : { kind: "empty" };
+    }
+    else if (layout.layoutType === "bitmap_view") {
+        content = { kind: "bitmap", data: string(layout.data) };
+    }
+    else if (layout.layoutType && layout.layoutType !== "clear_view") {
+        const { width: w, height: h } = canvas;
+        let elements = null;
+        switch (layout.layoutType) {
+            case "text_wall":
+            case "text_line":
+                elements = [textElement("text", layout.text, 0, 0, w, h)];
+                break;
+            case "text_rows":
+                elements = [textElement("text", Array.isArray(layout.text) ? layout.text.join("\n") : "", 0, 0, w, h)];
+                break;
+            case "reference_card":
+                elements = [
+                    textElement("text", [string(layout.title), string(layout.text)].filter(Boolean).join("\n"), 0, 0, w, h),
+                ];
+                break;
+            case "double_text_wall":
+                elements = [
+                    textElement("top", layout.topText, 0, 0, w, h / 2),
+                    textElement("bottom", layout.bottomText, 0, h / 2, w, h / 2),
+                ];
+                break;
+            case "positioned_text":
+                elements = [
+                    {
+                        ...textElement("text", layout.text, number(layout.x), number(layout.y), number(layout.width, w), number(layout.height, h)),
+                        style: { border: number(layout.borderWidth), radius: number(layout.borderRadius) },
+                    },
+                ];
+                break;
+        }
+        content = elements
+            ? { kind: "scene", elements, epoch: 0 }
+            : { kind: "unavailable", reason: `unsupported-layout:${string(layout.layoutType)}` };
+    }
+    return {
+        revision,
+        updatedAt: now,
+        connected,
+        model,
+        canvas,
+        view: event.view === "dashboard" ? "dashboard" : canvas ? "main" : null,
+        appId: typeof layout.appId === "string" ? layout.appId : null,
+        content,
+        glyphWidths: widths,
+    };
+}
+//# sourceMappingURL=mirrorSnapshot.js.map

package/build/services/mirrorSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirrorSnapshot.js","sourceRoot":"","sources":["../../src/services/mirrorSnapshot.ts"],"names":[],"mappings":"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","sourcesContent":["import type {MirrorContent, MirrorElement, MirrorSnapshot} from \"@glassly/miniapp\"\n\nexport interface MirrorSource {\n  event: unknown\n  canvas: {width: number; height: number} | null\n  connected: boolean\n  model: string | null\n  battery: number\n  measureChar: (char: string) => number\n  now: number\n}\n\nconst object = (v: unknown): Record<string, unknown> =>\n  v !== null && typeof v === \"object\" && !Array.isArray(v) ? (v as Record<string, unknown>) : {}\nconst number = (v: unknown, fallback = 0): number => (typeof v === \"number\" && Number.isFinite(v) ? v : fallback)\nconst string = (v: unknown): string => (typeof v === \"string\" ? v : \"\")\n\n/** Copy and normalize host layouts at the public boundary; never leak store references. */\nexport function buildMirrorSnapshot(source: MirrorSource, revision: number): MirrorSnapshot {\n  const {now, connected, model, measureChar} = source\n  const event = object(source.event)\n  const layout = object(event.layout)\n  let canvas = source.canvas\n  let content: MirrorContent = {kind: \"empty\"}\n  const widths: Record<string, number> = {}\n  const date = new Date(now)\n  const pad = (n: number) => String(n).padStart(2, \"0\")\n  const parseText = (value: unknown) => {\n    const text = string(value)\n      .replace(/\\$DATE\\$/g, `${pad(date.getMonth() + 1)}/${pad(date.getDate())}`)\n      .replace(/\\$TIME12\\$/g, `${pad(date.getHours() % 12 || 12)}:${pad(date.getMinutes())}`)\n      .replace(/\\$TIME24\\$/g, `${pad(date.getHours())}:${pad(date.getMinutes())}`)\n      .replace(/\\$GBATT\\$/g, source.battery >= 0 ? `${source.battery}%` : \"\")\n      .replace(/\\$CONNECTION_STATUS\\$/g, connected ? \"Connected\" : \"Disconnected\")\n    for (const char of text) widths[char] = measureChar(char)\n    return text\n  }\n  const textElement = (id: string, text: unknown, x: number, y: number, w: number, h: number): MirrorElement => ({\n    id,\n    type: \"text\",\n    text: parseText(text),\n    box: {x, y, w, h},\n    change: \"created\",\n  })\n  if (!canvas) content = {kind: \"unavailable\", reason: \"no-display\"}\n  else if (layout.layoutType === \"unavailable\")\n    content = {kind: \"unavailable\", reason: string(layout.reason) || \"unknown\"}\n  else if (layout.layoutType === \"scene\") {\n    canvas = {width: number(layout.width, canvas.width), height: number(layout.height, canvas.height)}\n    const elements: MirrorElement[] = []\n    for (const raw of Array.isArray(layout.elements) ? layout.elements : []) {\n      const el = object(raw)\n      if (typeof el.id !== \"string\" || typeof el.type !== \"string\" || !el.box) continue\n      // SceneRenderer produces validated FrameElements. Serialization strips\n      // references; private native compiler/hash fields stay inside the host.\n      const {path: _path, contentHash: _hash, ...copy} = JSON.parse(JSON.stringify(el))\n      if (copy.type === \"text\") copy.text = parseText(copy.text)\n      elements.push(copy as MirrorElement)\n    }\n    content = elements.length ? {kind: \"scene\", elements, epoch: number(layout.sceneEpoch)} : {kind: \"empty\"}\n  } else if (layout.layoutType === \"bitmap_view\") {\n    content = {kind: \"bitmap\", data: string(layout.data)}\n  } else if (layout.layoutType && layout.layoutType !== \"clear_view\") {\n    const {width: w, height: h} = canvas\n    let elements: MirrorElement[] | null = null\n    switch (layout.layoutType) {\n      case \"text_wall\":\n      case \"text_line\":\n        elements = [textElement(\"text\", layout.text, 0, 0, w, h)]\n        break\n      case \"text_rows\":\n        elements = [textElement(\"text\", Array.isArray(layout.text) ? layout.text.join(\"\\n\") : \"\", 0, 0, w, h)]\n        break\n      case \"reference_card\":\n        elements = [\n          textElement(\"text\", [string(layout.title), string(layout.text)].filter(Boolean).join(\"\\n\"), 0, 0, w, h),\n        ]\n        break\n      case \"double_text_wall\":\n        elements = [\n          textElement(\"top\", layout.topText, 0, 0, w, h / 2),\n          textElement(\"bottom\", layout.bottomText, 0, h / 2, w, h / 2),\n        ]\n        break\n      case \"positioned_text\":\n        elements = [\n          {\n            ...textElement(\n              \"text\",\n              layout.text,\n              number(layout.x),\n              number(layout.y),\n              number(layout.width, w),\n              number(layout.height, h),\n            ),\n            style: {border: number(layout.borderWidth), radius: number(layout.borderRadius)},\n          },\n        ]\n        break\n    }\n    content = elements\n      ? {kind: \"scene\", elements, epoch: 0}\n      : {kind: \"unavailable\", reason: `unsupported-layout:${string(layout.layoutType)}`}\n  }\n  return {\n    revision,\n    updatedAt: now,\n    connected,\n    model,\n    canvas,\n    view: event.view === \"dashboard\" ? \"dashboard\" : canvas ? \"main\" : null,\n    appId: typeof layout.appId === \"string\" ? layout.appId : null,\n    content,\n    glyphWidths: widths,\n  }\n}\n"]}

package/build/services/nativeNavigationGate.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The firmware nav UI is a stock-firmware feature. Custom firmware publishes a
+ * scene canvas, so the navigation miniapp draws its own HUD there and reads
+ * session.compass directly; native nav mode would only cover that up. The
+ * debug knob forces it back on for comparing both UIs on hardware.
+ */
+export declare function resolveNativeNavigation(modelSupports: boolean | undefined, customFirmware: boolean, forceOnCustomFirmware: boolean): boolean | undefined;
+//# sourceMappingURL=nativeNavigationGate.d.ts.map

package/build/services/nativeNavigationGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeNavigationGate.d.ts","sourceRoot":"","sources":["../../src/services/nativeNavigationGate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,OAAO,GAAG,SAAS,EAClC,cAAc,EAAE,OAAO,EACvB,qBAAqB,EAAE,OAAO,GAC7B,OAAO,GAAG,SAAS,CAGrB"}

package/build/services/nativeNavigationGate.js

@@ -0,0 +1,12 @@
+/**
+ * The firmware nav UI is a stock-firmware feature. Custom firmware publishes a
+ * scene canvas, so the navigation miniapp draws its own HUD there and reads
+ * session.compass directly; native nav mode would only cover that up. The
+ * debug knob forces it back on for comparing both UIs on hardware.
+ */
+export function resolveNativeNavigation(modelSupports, customFirmware, forceOnCustomFirmware) {
+    if (modelSupports !== true)
+        return modelSupports;
+    return !customFirmware || forceOnCustomFirmware;
+}
+//# sourceMappingURL=nativeNavigationGate.js.map

package/build/services/nativeNavigationGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeNavigationGate.js","sourceRoot":"","sources":["../../src/services/nativeNavigationGate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,aAAkC,EAClC,cAAuB,EACvB,qBAA8B;IAE9B,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,aAAa,CAAA;IAChD,OAAO,CAAC,cAAc,IAAI,qBAAqB,CAAA;AACjD,CAAC","sourcesContent":["/**\n * The firmware nav UI is a stock-firmware feature. Custom firmware publishes a\n * scene canvas, so the navigation miniapp draws its own HUD there and reads\n * session.compass directly; native nav mode would only cover that up. The\n * debug knob forces it back on for comparing both UIs on hardware.\n */\nexport function resolveNativeNavigation(\n  modelSupports: boolean | undefined,\n  customFirmware: boolean,\n  forceOnCustomFirmware: boolean,\n): boolean | undefined {\n  if (modelSupports !== true) return modelSupports\n  return !customFirmware || forceOnCustomFirmware\n}\n"]}

package/build/services/notificationAppCatalog.d.ts

@@ -0,0 +1,7 @@
+export interface NotificationApp {
+    appId: string;
+    displayName: string;
+}
+/** The catalog for the current phone platform. */
+export declare function notificationAppCatalog(): NotificationApp[];
+//# sourceMappingURL=notificationAppCatalog.d.ts.map

package/build/services/notificationAppCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationAppCatalog.d.ts","sourceRoot":"","sources":["../../src/services/notificationAppCatalog.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,kDAAkD;AAClD,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CAG1D"}

package/build/services/notificationAppCatalog.js

@@ -0,0 +1,16 @@
+/**
+ * Seeded catalog of apps that post notifications, keyed by bundle id or
+ * package name. Where the phone cannot enumerate apps (iOS) the filter UI
+ * shows this catalog plus apps the glasses have reported, and firmware whose
+ * filter is an allowlist needs known ids so blocking one app does not take
+ * every not-yet-seen app down with it. Derived from the SDK's known-apps
+ * table so names live in one place.
+ */
+import { KNOWN_APPS } from "@glassly/miniapp/known-apps";
+import { Platform } from "react-native";
+/** The catalog for the current phone platform. */
+export function notificationAppCatalog() {
+    const other = Platform.OS === "ios" ? "android" : "ios";
+    return KNOWN_APPS.filter((app) => app.platform !== other).map((app) => ({ appId: app.id, displayName: app.name }));
+}
+//# sourceMappingURL=notificationAppCatalog.js.map

package/build/services/notificationAppCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationAppCatalog.js","sourceRoot":"","sources":["../../src/services/notificationAppCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAC,UAAU,EAAC,MAAM,6BAA6B,CAAA;AACtD,OAAO,EAAC,QAAQ,EAAC,MAAM,cAAc,CAAA;AAOrC,kDAAkD;AAClD,MAAM,UAAU,sBAAsB;IACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAA;IACvD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,IAAI,EAAC,CAAC,CAAC,CAAA;AAClH,CAAC","sourcesContent":["/**\n * Seeded catalog of apps that post notifications, keyed by bundle id or\n * package name. Where the phone cannot enumerate apps (iOS) the filter UI\n * shows this catalog plus apps the glasses have reported, and firmware whose\n * filter is an allowlist needs known ids so blocking one app does not take\n * every not-yet-seen app down with it. Derived from the SDK's known-apps\n * table so names live in one place.\n */\nimport {KNOWN_APPS} from \"@glassly/miniapp/known-apps\"\nimport {Platform} from \"react-native\"\n\nexport interface NotificationApp {\n  appId: string\n  displayName: string\n}\n\n/** The catalog for the current phone platform. */\nexport function notificationAppCatalog(): NotificationApp[] {\n  const other = Platform.OS === \"ios\" ? \"android\" : \"ios\"\n  return KNOWN_APPS.filter((app) => app.platform !== other).map((app) => ({appId: app.id, displayName: app.name}))\n}\n"]}

package/build/services/notifications/notificationPolicy.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Notification policy, pure: what the glasses should do with phone
+ * notifications, from settings and the current state of the phone and the
+ * glasses. Two questions live here. `glassesNotificationConfig` is the
+ * behaviour pushed to firmware that presents notifications itself.
+ * `presentationOwner` names the one thing that may draw a notification for
+ * the wearer; every other consumer stays quiet. The adapters
+ * (PhoneNotificationsSync, the host) snapshot inputs and act on the answers.
+ */
+import type { GlassesNotificationConfig } from "@glassly/bluetooth-sdk";
+export interface NotificationApp {
+    appId: string;
+    displayName: string;
+}
+export interface NotificationConfigInput {
+    enabled: boolean;
+    popups: boolean;
+    popupSeconds: number;
+    holdDuringApps: boolean;
+    /** Hold popups while the wearer can see the phone. */
+    ignoreWhileActive: boolean;
+    phoneActive: boolean;
+    blockedApps: string[];
+    /** Catalog ∪ apps the glasses reported, for allowlist firmware. */
+    knownApps: NotificationApp[];
+}
+/**
+ * Popups fold the ignore-while-active gate in: firmware that pops
+ * notifications up by itself has no other way to hold them while the wearer
+ * is on the phone. The engine's viewer applies the same gate from its env.
+ */
+export declare function effectivePopups(popups: boolean, ignoreWhileActive: boolean, phoneActive: boolean): boolean;
+export declare function glassesNotificationConfig(input: NotificationConfigInput): GlassesNotificationConfig;
+/**
+ * Who draws a phone notification for the wearer.
+ *  viewer   — the notifications viewer on connected Glassly CFW glasses, while it runs
+ *  firmware — the glasses' own notification centre (hasNativeNotifications)
+ *  host     — the host app's card and speech, while its presentation surface runs
+ *  none     — nobody: notifications are off, or nothing is there to show them
+ * Miniapp forwarding is not presentation and is never gated by this.
+ */
+export type PresentationOwner = "viewer" | "firmware" | "host" | "none";
+export interface PresentationInput {
+    enabled: boolean;
+    /** Pages may show on the connected glasses. */
+    pagesEligible: boolean;
+    /** The viewer's app is running, so a page can actually show. */
+    viewerRunning: boolean;
+    /** The connected model presents notifications in firmware. */
+    nativeNotifications: boolean;
+    /** The Notifications miniapp is running, enabling the host fallback. */
+    hostActive: boolean;
+}
+export declare function presentationOwner(input: PresentationInput): PresentationOwner;
+//# sourceMappingURL=notificationPolicy.d.ts.map

package/build/services/notifications/notificationPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationPolicy.d.ts","sourceRoot":"","sources":["../../../src/services/notifications/notificationPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,wBAAwB,CAAA;AAErE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,OAAO,CAAA;IACvB,sDAAsD;IACtD,iBAAiB,EAAE,OAAO,CAAA;IAC1B,WAAW,EAAE,OAAO,CAAA;IACpB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,mEAAmE;IACnE,SAAS,EAAE,eAAe,EAAE,CAAA;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAI1G;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,uBAAuB,GAAG,yBAAyB,CAgBnG;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAA;AAEvE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,+CAA+C;IAC/C,aAAa,EAAE,OAAO,CAAA;IACtB,gEAAgE;IAChE,aAAa,EAAE,OAAO,CAAA;IACtB,8DAA8D;IAC9D,mBAAmB,EAAE,OAAO,CAAA;IAC5B,wEAAwE;IACxE,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,CAM7E"}

package/build/services/notifications/notificationPolicy.js

@@ -0,0 +1,41 @@
+/**
+ * Popups fold the ignore-while-active gate in: firmware that pops
+ * notifications up by itself has no other way to hold them while the wearer
+ * is on the phone. The engine's viewer applies the same gate from its env.
+ */
+export function effectivePopups(popups, ignoreWhileActive, phoneActive) {
+    if (!popups)
+        return false;
+    if (!ignoreWhileActive)
+        return true;
+    return !phoneActive;
+}
+export function glassesNotificationConfig(input) {
+    const blocked = new Set(input.blockedApps);
+    const seconds = Number(input.popupSeconds);
+    // Known apps travel even while nothing is blocked so a first block enables
+    // the allowlist against the wearer's current list, not an empty one.
+    const allowedApps = input.knownApps
+        .filter((app) => app.appId && !blocked.has(app.appId))
+        .map((app) => ({ id: app.appId, name: app.displayName || app.appId }));
+    return {
+        enabled: input.enabled,
+        popups: effectivePopups(input.popups, input.ignoreWhileActive, input.phoneActive),
+        popupSeconds: Number.isFinite(seconds) && seconds > 0 ? Math.round(seconds) : 0,
+        holdDuringApps: input.holdDuringApps,
+        blockedApps: [...blocked],
+        allowedApps,
+    };
+}
+export function presentationOwner(input) {
+    if (!input.enabled)
+        return "none";
+    if (input.pagesEligible && input.viewerRunning)
+        return "viewer";
+    if (input.nativeNotifications)
+        return "firmware";
+    if (input.hostActive)
+        return "host";
+    return "none";
+}
+//# sourceMappingURL=notificationPolicy.js.map

package/build/services/notifications/notificationPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationPolicy.js","sourceRoot":"","sources":["../../../src/services/notifications/notificationPolicy.ts"],"names":[],"mappings":"AA6BA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAe,EAAE,iBAA0B,EAAE,WAAoB;IAC/F,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IACzB,IAAI,CAAC,iBAAiB;QAAE,OAAO,IAAI,CAAA;IACnC,OAAO,CAAC,WAAW,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAA8B;IACtE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IAC1C,2EAA2E;IAC3E,qEAAqE;IACrE,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS;SAChC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAC,EAAE,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,KAAK,EAAC,CAAC,CAAC,CAAA;IACtE,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,WAAW,CAAC;QACjF,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC;QACzB,WAAW;KACZ,CAAA;AACH,CAAC;AAwBD,MAAM,UAAU,iBAAiB,CAAC,KAAwB;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,MAAM,CAAA;IACjC,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa;QAAE,OAAO,QAAQ,CAAA;IAC/D,IAAI,KAAK,CAAC,mBAAmB;QAAE,OAAO,UAAU,CAAA;IAChD,IAAI,KAAK,CAAC,UAAU;QAAE,OAAO,MAAM,CAAA;IACnC,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["/**\n * Notification policy, pure: what the glasses should do with phone\n * notifications, from settings and the current state of the phone and the\n * glasses. Two questions live here. `glassesNotificationConfig` is the\n * behaviour pushed to firmware that presents notifications itself.\n * `presentationOwner` names the one thing that may draw a notification for\n * the wearer; every other consumer stays quiet. The adapters\n * (PhoneNotificationsSync, the host) snapshot inputs and act on the answers.\n */\nimport type {GlassesNotificationConfig} from \"@glassly/bluetooth-sdk\"\n\nexport interface NotificationApp {\n  appId: string\n  displayName: string\n}\n\nexport interface NotificationConfigInput {\n  enabled: boolean\n  popups: boolean\n  popupSeconds: number\n  holdDuringApps: boolean\n  /** Hold popups while the wearer can see the phone. */\n  ignoreWhileActive: boolean\n  phoneActive: boolean\n  blockedApps: string[]\n  /** Catalog ∪ apps the glasses reported, for allowlist firmware. */\n  knownApps: NotificationApp[]\n}\n\n/**\n * Popups fold the ignore-while-active gate in: firmware that pops\n * notifications up by itself has no other way to hold them while the wearer\n * is on the phone. The engine's viewer applies the same gate from its env.\n */\nexport function effectivePopups(popups: boolean, ignoreWhileActive: boolean, phoneActive: boolean): boolean {\n  if (!popups) return false\n  if (!ignoreWhileActive) return true\n  return !phoneActive\n}\n\nexport function glassesNotificationConfig(input: NotificationConfigInput): GlassesNotificationConfig {\n  const blocked = new Set(input.blockedApps)\n  const seconds = Number(input.popupSeconds)\n  // Known apps travel even while nothing is blocked so a first block enables\n  // the allowlist against the wearer's current list, not an empty one.\n  const allowedApps = input.knownApps\n    .filter((app) => app.appId && !blocked.has(app.appId))\n    .map((app) => ({id: app.appId, name: app.displayName || app.appId}))\n  return {\n    enabled: input.enabled,\n    popups: effectivePopups(input.popups, input.ignoreWhileActive, input.phoneActive),\n    popupSeconds: Number.isFinite(seconds) && seconds > 0 ? Math.round(seconds) : 0,\n    holdDuringApps: input.holdDuringApps,\n    blockedApps: [...blocked],\n    allowedApps,\n  }\n}\n\n/**\n * Who draws a phone notification for the wearer.\n *  viewer   — the notifications viewer on connected Glassly CFW glasses, while it runs\n *  firmware — the glasses' own notification centre (hasNativeNotifications)\n *  host     — the host app's card and speech, while its presentation surface runs\n *  none     — nobody: notifications are off, or nothing is there to show them\n * Miniapp forwarding is not presentation and is never gated by this.\n */\nexport type PresentationOwner = \"viewer\" | \"firmware\" | \"host\" | \"none\"\n\nexport interface PresentationInput {\n  enabled: boolean\n  /** Pages may show on the connected glasses. */\n  pagesEligible: boolean\n  /** The viewer's app is running, so a page can actually show. */\n  viewerRunning: boolean\n  /** The connected model presents notifications in firmware. */\n  nativeNotifications: boolean\n  /** The Notifications miniapp is running, enabling the host fallback. */\n  hostActive: boolean\n}\n\nexport function presentationOwner(input: PresentationInput): PresentationOwner {\n  if (!input.enabled) return \"none\"\n  if (input.pagesEligible && input.viewerRunning) return \"viewer\"\n  if (input.nativeNotifications) return \"firmware\"\n  if (input.hostActive) return \"host\"\n  return \"none\"\n}\n"]}

package/build/services/pages/OverlayPages.d.ts

@@ -0,0 +1,26 @@
+export type DashboardViewChangeReason = "shown" | "hidden" | "replaced" | "ineligible";
+export interface OverlayPagesSink {
+    /** Deliver a display_view event to the app. */
+    send(packageName: string, event: Record<string, unknown>): void;
+}
+declare class OverlayPages {
+    private sink;
+    private pages;
+    /** Set while an app's page is torn down with the app; it hears nothing then. */
+    private silent;
+    setSink(sink: OverlayPagesSink | null): void;
+    /** The app whose page holds the slot, or null. */
+    get showingPackage(): string | null;
+    /** Give the app the slot (a no-op when it already shows or pages are not eligible). */
+    show(packageName: string): boolean;
+    /** Release the slot if the app holds it. */
+    hide(packageName: string): void;
+    /** The app stopped: release the slot without telling it, and forget its page. */
+    remove(packageName: string): void;
+    private pageFor;
+    private emit;
+}
+declare const overlayPages: OverlayPages;
+export default overlayPages;
+export { OverlayPages };
+//# sourceMappingURL=OverlayPages.d.ts.map

package/build/services/pages/OverlayPages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayPages.d.ts","sourceRoot":"","sources":["../../../src/services/pages/OverlayPages.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAA;AAEtF,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAChE;AAED,cAAM,YAAY;IAChB,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,KAAK,CAA0B;IACvC,gFAAgF;IAChF,OAAO,CAAC,MAAM,CAAoB;IAElC,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAI5C,kDAAkD;IAClD,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAKlC;IAED,uFAAuF;IACvF,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAOlC,4CAA4C;IAC5C,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAK/B,iFAAiF;IACjF,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAYjC,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,IAAI;CAIb;AAED,QAAA,MAAM,YAAY,cAAqB,CAAA;AACvC,eAAe,YAAY,CAAA;AAC3B,OAAO,EAAC,YAAY,EAAC,CAAA"}

package/build/services/pages/OverlayPages.js

@@ -0,0 +1,80 @@
+/**
+ * The overlay apps' pages (ADR-0006): one Page per app that has taken the
+ * slot, the only Page implementation the page host shows. The engine keeps
+ * the slot and the eligibility watch; a page only relays: holding the slot
+ * is reported to its app as a view change, and the app's frames reach the
+ * slot through `renderOverlay` under its package name. Whichever app asked
+ * last holds the slot; the previous one hears it was replaced. The runtime
+ * supplies the sink that delivers to apps, so this module never imports it.
+ */
+import pageHost from "./PageHost";
+import { isOverlayApp } from "./overlayApps";
+import { pagesEligible } from "./pageEligibility";
+class OverlayPages {
+    sink = null;
+    pages = new Map();
+    /** Set while an app's page is torn down with the app; it hears nothing then. */
+    silent = new Set();
+    setSink(sink) {
+        this.sink = sink;
+    }
+    /** The app whose page holds the slot, or null. */
+    get showingPackage() {
+        const showing = pageHost.showing;
+        if (!showing)
+            return null;
+        for (const [packageName, page] of this.pages)
+            if (page === showing)
+                return packageName;
+        return null;
+    }
+    /** Give the app the slot (a no-op when it already shows or pages are not eligible). */
+    show(packageName) {
+        if (!isOverlayApp(packageName) || !pagesEligible())
+            return false;
+        const page = this.pageFor(packageName);
+        pageHost.show(page);
+        return pageHost.showing === page;
+    }
+    /** Release the slot if the app holds it. */
+    hide(packageName) {
+        const page = this.pages.get(packageName);
+        if (page)
+            pageHost.hide(page);
+    }
+    /** The app stopped: release the slot without telling it, and forget its page. */
+    remove(packageName) {
+        const page = this.pages.get(packageName);
+        if (!page)
+            return;
+        this.silent.add(packageName);
+        try {
+            pageHost.hide(page);
+        }
+        finally {
+            this.silent.delete(packageName);
+        }
+        this.pages.delete(packageName);
+    }
+    pageFor(packageName) {
+        let page = this.pages.get(packageName);
+        if (page)
+            return page;
+        page = {
+            id: packageName,
+            onShown: () => this.emit(packageName, { kind: "change", view: "dashboard", reason: "shown" }),
+            onHidden: (reason) => this.emit(packageName, { kind: "change", view: "main", reason }),
+        };
+        this.pages.set(packageName, page);
+        return page;
+    }
+    emit(packageName, event) {
+        if (this.silent.has(packageName) || !isOverlayApp(packageName))
+            return;
+        this.sink?.send(packageName, event);
+    }
+}
+const overlayPages = new OverlayPages();
+export default overlayPages;
+export { OverlayPages };
+//# sourceMappingURL=OverlayPages.js.map

package/build/services/pages/OverlayPages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayPages.js","sourceRoot":"","sources":["../../../src/services/pages/OverlayPages.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The overlay apps' pages (ADR-0006): one Page per app that has taken the\n * slot, the only Page implementation the page host shows. The engine keeps\n * the slot and the eligibility watch; a page only relays: holding the slot\n * is reported to its app as a view change, and the app's frames reach the\n * slot through `renderOverlay` under its package name. Whichever app asked\n * last holds the slot; the previous one hears it was replaced. The runtime\n * supplies the sink that delivers to apps, so this module never imports it.\n */\nimport pageHost, {type Page, type PageHiddenReason} from \"./PageHost\"\nimport {isOverlayApp} from \"./overlayApps\"\nimport {pagesEligible} from \"./pageEligibility\"\n\nexport type DashboardViewChangeReason = \"shown\" | \"hidden\" | \"replaced\" | \"ineligible\"\n\nexport interface OverlayPagesSink {\n  /** Deliver a display_view event to the app. */\n  send(packageName: string, event: Record<string, unknown>): void\n}\n\nclass OverlayPages {\n  private sink: OverlayPagesSink | null = null\n  private pages = new Map<string, Page>()\n  /** Set while an app's page is torn down with the app; it hears nothing then. */\n  private silent = new Set<string>()\n\n  setSink(sink: OverlayPagesSink | null): void {\n    this.sink = sink\n  }\n\n  /** The app whose page holds the slot, or null. */\n  get showingPackage(): string | null {\n    const showing = pageHost.showing\n    if (!showing) return null\n    for (const [packageName, page] of this.pages) if (page === showing) return packageName\n    return null\n  }\n\n  /** Give the app the slot (a no-op when it already shows or pages are not eligible). */\n  show(packageName: string): boolean {\n    if (!isOverlayApp(packageName) || !pagesEligible()) return false\n    const page = this.pageFor(packageName)\n    pageHost.show(page)\n    return pageHost.showing === page\n  }\n\n  /** Release the slot if the app holds it. */\n  hide(packageName: string): void {\n    const page = this.pages.get(packageName)\n    if (page) pageHost.hide(page)\n  }\n\n  /** The app stopped: release the slot without telling it, and forget its page. */\n  remove(packageName: string): void {\n    const page = this.pages.get(packageName)\n    if (!page) return\n    this.silent.add(packageName)\n    try {\n      pageHost.hide(page)\n    } finally {\n      this.silent.delete(packageName)\n    }\n    this.pages.delete(packageName)\n  }\n\n  private pageFor(packageName: string): Page {\n    let page = this.pages.get(packageName)\n    if (page) return page\n    page = {\n      id: packageName,\n      onShown: () => this.emit(packageName, {kind: \"change\", view: \"dashboard\", reason: \"shown\"}),\n      onHidden: (reason: PageHiddenReason) => this.emit(packageName, {kind: \"change\", view: \"main\", reason}),\n    }\n    this.pages.set(packageName, page)\n    return page\n  }\n\n  private emit(packageName: string, event: Record<string, unknown>): void {\n    if (this.silent.has(packageName) || !isOverlayApp(packageName)) return\n    this.sink?.send(packageName, event)\n  }\n}\n\nconst overlayPages = new OverlayPages()\nexport default overlayPages\nexport {OverlayPages}\n"]}

package/build/services/pages/PageHost.d.ts

@@ -0,0 +1,32 @@
+export type PageHiddenReason = "hidden" | "replaced" | "ineligible";
+export interface Page {
+    /** Scene app id; the overlay owner while the page shows. */
+    readonly id: string;
+    /** The page holds the slot: draw the first frame. */
+    onShown(): void;
+    /** The slot was released, taken by another page, or lost with eligibility. */
+    onHidden(reason: PageHiddenReason): void;
+}
+declare class PageHost {
+    private showingPage;
+    private ops;
+    private draining;
+    private listeners;
+    private unsubs;
+    private started;
+    start(): void;
+    stop(): void;
+    get showing(): Page | null;
+    /** Give `page` the slot; no-op when it already shows or pages are not eligible. */
+    show(page: Page): void;
+    /** Release the slot if `page` holds it. */
+    hide(page: Page): void;
+    onChange(listener: (page: Page | null) => void): () => void;
+    private release;
+    private emit;
+    private enqueue;
+}
+declare const pageHost: PageHost;
+export default pageHost;
+export { PageHost };
+//# sourceMappingURL=PageHost.d.ts.map

package/build/services/pages/PageHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageHost.d.ts","sourceRoot":"","sources":["../../../src/services/pages/PageHost.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAA;AAEnE,MAAM,WAAW,IAAI;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,qDAAqD;IACrD,OAAO,IAAI,IAAI,CAAA;IACf,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAA;CACzC;AAED,cAAM,QAAQ;IACZ,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,OAAO,CAAQ;IAEvB,KAAK,IAAI,IAAI;IAeb,IAAI,IAAI,IAAI;IAOZ,IAAI,OAAO,IAAI,IAAI,GAAG,IAAI,CAEzB;IAED,mFAAmF;IACnF,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAYtB,2CAA2C;IAC3C,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAOtB,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;IAO3D,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,OAAO;CAUhB;AAED,QAAA,MAAM,QAAQ,UAAiB,CAAA;AAC/B,eAAe,QAAQ,CAAA;AACvB,OAAO,EAAC,QAAQ,EAAC,CAAA"}

package/build/services/pages/PageHost.js

@@ -0,0 +1,99 @@
+/**
+ * The page host owns the overlay slot: the single native view above the main
+ * content. At most one page shows at a time; showing a page replaces whatever
+ * was showing, hiding releases the slot and the main content replays. Which
+ * app gets the wearer's gestures is the gesture claims' business, not the
+ * host's. Show and hide run through one queue so a page
+ * that hides itself from inside its own transition is hidden afterwards, never
+ * re-entered. Eligibility (Glassly CFW, dashboard enabled) is checked before a
+ * show and watched while a page is up.
+ */
+import { useGlassesStore } from "../../stores/glasses";
+import { SETTINGS, useSettingsStore } from "../../stores/settings";
+import localDisplayManager from "../LocalDisplayManager";
+import { pagesEligible } from "./pageEligibility";
+class PageHost {
+    showingPage = null;
+    ops = [];
+    draining = false;
+    listeners = new Set();
+    unsubs = [];
+    started = false;
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        const check = () => {
+            if (this.showingPage && !pagesEligible())
+                this.release("ineligible");
+        };
+        this.unsubs.push(useGlassesStore.subscribe((state) => `${state.connection.state}:${state.deviceModel}:${state.firmwareVersion}`, check), useSettingsStore.subscribe((state) => state.getSetting(SETTINGS.custom_dashboard_enabled.key), check));
+    }
+    stop() {
+        for (const unsub of this.unsubs)
+            unsub();
+        this.unsubs = [];
+        this.release("hidden");
+        this.started = false;
+    }
+    get showing() {
+        return this.showingPage;
+    }
+    /** Give `page` the slot; no-op when it already shows or pages are not eligible. */
+    show(page) {
+        this.enqueue(() => {
+            if (this.showingPage === page || !pagesEligible())
+                return;
+            const previous = this.showingPage;
+            this.showingPage = page;
+            localDisplayManager.setOverlayOwner(page.id);
+            previous?.onHidden("replaced");
+            page.onShown();
+            this.emit();
+        });
+    }
+    /** Release the slot if `page` holds it. */
+    hide(page) {
+        this.enqueue(() => {
+            if (this.showingPage !== page)
+                return;
+            this.release("hidden");
+        });
+    }
+    onChange(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    release(reason) {
+        const page = this.showingPage;
+        if (!page)
+            return;
+        this.showingPage = null;
+        localDisplayManager.setOverlayOwner(null);
+        page.onHidden(reason);
+        this.emit();
+    }
+    emit() {
+        for (const listener of Array.from(this.listeners))
+            listener(this.showingPage);
+    }
+    enqueue(op) {
+        this.ops.push(op);
+        if (this.draining)
+            return;
+        this.draining = true;
+        try {
+            while (this.ops.length)
+                this.ops.shift()();
+        }
+        finally {
+            this.draining = false;
+        }
+    }
+}
+const pageHost = new PageHost();
+export default pageHost;
+export { PageHost };
+//# sourceMappingURL=PageHost.js.map

package/build/services/pages/PageHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageHost.js","sourceRoot":"","sources":["../../../src/services/pages/PageHost.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The page host owns the overlay slot: the single native view above the main\n * content. At most one page shows at a time; showing a page replaces whatever\n * was showing, hiding releases the slot and the main content replays. Which\n * app gets the wearer's gestures is the gesture claims' business, not the\n * host's. Show and hide run through one queue so a page\n * that hides itself from inside its own transition is hidden afterwards, never\n * re-entered. Eligibility (Glassly CFW, dashboard enabled) is checked before a\n * show and watched while a page is up.\n */\nimport {useGlassesStore} from \"../../stores/glasses\"\nimport {SETTINGS, useSettingsStore} from \"../../stores/settings\"\nimport localDisplayManager from \"../LocalDisplayManager\"\nimport {pagesEligible} from \"./pageEligibility\"\n\nexport type PageHiddenReason = \"hidden\" | \"replaced\" | \"ineligible\"\n\nexport interface Page {\n  /** Scene app id; the overlay owner while the page shows. */\n  readonly id: string\n  /** The page holds the slot: draw the first frame. */\n  onShown(): void\n  /** The slot was released, taken by another page, or lost with eligibility. */\n  onHidden(reason: PageHiddenReason): void\n}\n\nclass PageHost {\n  private showingPage: Page | null = null\n  private ops: Array<() => void> = []\n  private draining = false\n  private listeners = new Set<(page: Page | null) => void>()\n  private unsubs: Array<() => void> = []\n  private started = false\n\n  start(): void {\n    if (this.started) return\n    this.started = true\n    const check = () => {\n      if (this.showingPage && !pagesEligible()) this.release(\"ineligible\")\n    }\n    this.unsubs.push(\n      useGlassesStore.subscribe(\n        (state) => `${state.connection.state}:${state.deviceModel}:${state.firmwareVersion}`,\n        check,\n      ),\n      useSettingsStore.subscribe((state) => state.getSetting(SETTINGS.custom_dashboard_enabled.key), check),\n    )\n  }\n\n  stop(): void {\n    for (const unsub of this.unsubs) unsub()\n    this.unsubs = []\n    this.release(\"hidden\")\n    this.started = false\n  }\n\n  get showing(): Page | null {\n    return this.showingPage\n  }\n\n  /** Give `page` the slot; no-op when it already shows or pages are not eligible. */\n  show(page: Page): void {\n    this.enqueue(() => {\n      if (this.showingPage === page || !pagesEligible()) return\n      const previous = this.showingPage\n      this.showingPage = page\n      localDisplayManager.setOverlayOwner(page.id)\n      previous?.onHidden(\"replaced\")\n      page.onShown()\n      this.emit()\n    })\n  }\n\n  /** Release the slot if `page` holds it. */\n  hide(page: Page): void {\n    this.enqueue(() => {\n      if (this.showingPage !== page) return\n      this.release(\"hidden\")\n    })\n  }\n\n  onChange(listener: (page: Page | null) => void): () => void {\n    this.listeners.add(listener)\n    return () => {\n      this.listeners.delete(listener)\n    }\n  }\n\n  private release(reason: PageHiddenReason): void {\n    const page = this.showingPage\n    if (!page) return\n    this.showingPage = null\n    localDisplayManager.setOverlayOwner(null)\n    page.onHidden(reason)\n    this.emit()\n  }\n\n  private emit(): void {\n    for (const listener of Array.from(this.listeners)) listener(this.showingPage)\n  }\n\n  private enqueue(op: () => void): void {\n    this.ops.push(op)\n    if (this.draining) return\n    this.draining = true\n    try {\n      while (this.ops.length) (this.ops.shift() as () => void)()\n    } finally {\n      this.draining = false\n    }\n  }\n}\n\nconst pageHost = new PageHost()\nexport default pageHost\nexport {PageHost}\n"]}