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

package/build/services/debug/dashboardOpenTimeline.js

@@ -0,0 +1,195 @@
+/**
+ * Stage timeline of one dashboard open, for the dashboard open timing debug
+ * setting. The clock starts when the opening gesture reaches the phone (or
+ * when native received it, if the event carries that time); every stage is
+ * stamped as ms after that. No I/O: DashboardOpenTrace.ts feeds it.
+ */
+/** In order. `js` exists only when the gesture carried a native receipt time; `settled` needs CFW rev 27+. */
+export const DASHBOARD_OPEN_STAGES = ["js", "showView", "slot", "frame", "presented", "settled"];
+/** The stages every open must pass; the first one missing is where it stalled. */
+const REQUIRED_STAGES = ["showView", "slot", "frame", "presented"];
+const STAGE_LABELS = {
+    js: "js",
+    showView: "showView",
+    slot: "slot",
+    frame: "frame",
+    presented: "shown",
+    settled: "settled",
+};
+/** A gesture not answered with showView by then did not open the dashboard; a later stage missing by then stalled. */
+export const OPEN_WINDOW_MS = 15_000;
+/** How long to wait for the settle report once the frame was presented. */
+export const SETTLE_GRACE_MS = 2_000;
+/** A native receipt time further back than this is on some other clock. */
+const MAX_NATIVE_LAG_MS = 60_000;
+export class DashboardOpenTimeline {
+    deps;
+    active = null;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    get tracing() {
+        return this.active !== null;
+    }
+    /** The seq of the open's first overlay frame, once sent. */
+    get frameSeq() {
+        return this.active?.frameSeq ?? null;
+    }
+    /**
+     * An opening gesture reached the phone. While an earlier one still waits
+     * for showView, the same gesture again only counts as a repeat (the clock
+     * keeps the first); a different gesture restarts the clock. Ignored once
+     * the open is under way.
+     */
+    trigger(trigger, context, nativeAt) {
+        const active = this.active;
+        if (active) {
+            if (active.trace.stages.showView !== undefined)
+                return;
+            if (active.trace.trigger === trigger) {
+                active.trace.repeats++;
+                return;
+            }
+            this.cancel();
+        }
+        const now = this.deps.now();
+        const lag = nativeAt === undefined ? -1 : now - nativeAt;
+        const native = nativeAt !== undefined && lag >= 0 && lag <= MAX_NATIVE_LAG_MS;
+        this.active = {
+            trace: { trigger, repeats: 0, stages: native ? { js: lag } : {}, appUpMs: null, ...context },
+            startedAt: native ? nativeAt : now,
+            frameSeq: null,
+            timer: this.deps.setTimeout(() => this.expire(), OPEN_WINDOW_MS),
+        };
+    }
+    /** An overlay app asked for the dashboard view; `appConnectedAt` is when it connected, if known. */
+    showViewRequested(appConnectedAt) {
+        const active = this.active;
+        if (!active || active.trace.stages.showView !== undefined)
+            return;
+        active.trace.appUpMs = appConnectedAt === null ? null : active.startedAt - appConnectedAt;
+        this.stamp("showView");
+    }
+    slotGranted() {
+        if (this.active?.trace.stages.showView !== undefined)
+            this.stamp("slot");
+    }
+    /** The first overlay frame after the grant left for the glasses. */
+    frameSent(seq) {
+        const active = this.active;
+        if (!active || active.trace.stages.slot === undefined || active.frameSeq !== null)
+            return;
+        active.frameSeq = seq;
+        this.stamp("frame");
+    }
+    /**
+     * The glasses reported a frame. A later frame presented folds ours in; ours
+     * not presented is noted, and the window still waits for a later one.
+     */
+    framePresented(seq, presented, reason) {
+        const active = this.active;
+        if (!active || active.frameSeq === null || seq < active.frameSeq)
+            return;
+        if (active.trace.stages.presented !== undefined)
+            return;
+        if (!presented) {
+            if (seq === active.frameSeq)
+                active.trace.reason = reason ?? "not presented";
+            return;
+        }
+        this.stamp("presented");
+        this.deps.clearTimeout(active.timer);
+        active.timer = this.deps.setTimeout(() => this.finish(), SETTLE_GRACE_MS);
+    }
+    /** The glasses finished the animations of frame `seq` (and every frame before it). */
+    frameSettled(seq) {
+        const active = this.active;
+        if (!active || active.frameSeq === null || seq < active.frameSeq)
+            return;
+        this.stamp("presented");
+        this.stamp("settled");
+        this.finish();
+    }
+    cancel() {
+        if (!this.active)
+            return;
+        this.deps.clearTimeout(this.active.timer);
+        this.active = null;
+    }
+    stamp(stage) {
+        const active = this.active;
+        if (!active || active.trace.stages[stage] !== undefined)
+            return;
+        active.trace.stages[stage] = this.deps.now() - active.startedAt;
+    }
+    expire() {
+        const active = this.active;
+        if (!active)
+            return;
+        if (active.trace.stages.showView === undefined) {
+            this.active = null;
+            return;
+        }
+        this.finish();
+    }
+    finish() {
+        const active = this.active;
+        if (!active)
+            return;
+        this.deps.clearTimeout(active.timer);
+        this.active = null;
+        const { trace } = active;
+        const stalledAt = REQUIRED_STAGES.find((stage) => trace.stages[stage] === undefined);
+        if (stalledAt)
+            trace.stalledAt = stalledAt;
+        else
+            delete trace.reason;
+        this.deps.onFinished(trace);
+    }
+}
+/** Notification title and body: the headline, the stage timeline, then the context that separates cold opens from warm ones. */
+export function formatDashboardOpenTrace(trace) {
+    const shown = trace.stages.presented;
+    const title = trace.stalledAt === undefined && shown !== undefined
+        ? `Dashboard opened in ${formatMs(shown)} ms`
+        : `Dashboard open stalled before ${STAGE_LABELS[trace.stalledAt ?? "presented"]}`;
+    const gesture = trace.repeats > 0 ? `${trace.trigger} ×${trace.repeats + 1}` : trace.trigger;
+    const timeline = [`${gesture} 0`];
+    for (const stage of DASHBOARD_OPEN_STAGES) {
+        const at = trace.stages[stage];
+        if (at !== undefined)
+            timeline.push(`${STAGE_LABELS[stage]} +${formatMs(at)}`);
+    }
+    const context = [
+        trace.sinceLastOpenMs === null
+            ? "first open this session"
+            : `last open ${formatDuration(trace.sinceLastOpenMs)} ago`,
+    ];
+    if (trace.appUpMs !== null) {
+        context.push(trace.appUpMs < 0
+            ? `dashboard app connected ${formatDuration(-trace.appUpMs)} after the gesture`
+            : `dashboard app up ${formatDuration(trace.appUpMs)}`);
+    }
+    if (trace.glassesUpMs !== null)
+        context.push(`glasses up ${formatDuration(trace.glassesUpMs)}`);
+    const lines = [timeline.join(" · "), context.join(" · ")];
+    if (trace.reason)
+        lines.push(`glasses: ${trace.reason}`);
+    return { title, body: lines.join("\n") };
+}
+/** 5210 → "5,210". Hand-rolled so it doesn't depend on the runtime's Intl. */
+function formatMs(ms) {
+    return String(Math.round(ms)).replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+}
+function formatDuration(ms) {
+    if (ms < 1_000)
+        return `${Math.round(ms)} ms`;
+    if (ms < 60_000)
+        return `${Math.round(ms / 1_000)} s`;
+    if (ms < 3_600_000)
+        return `${Math.round(ms / 60_000)} min`;
+    const hours = Math.floor(ms / 3_600_000);
+    const minutes = Math.round((ms % 3_600_000) / 60_000);
+    return minutes > 0 ? `${hours} h ${minutes} min` : `${hours} h`;
+}
+//# sourceMappingURL=dashboardOpenTimeline.js.map

package/build/services/debug/dashboardOpenTimeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardOpenTimeline.js","sourceRoot":"","sources":["../../../src/services/debug/dashboardOpenTimeline.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Stage timeline of one dashboard open, for the dashboard open timing debug\n * setting. The clock starts when the opening gesture reaches the phone (or\n * when native received it, if the event carries that time); every stage is\n * stamped as ms after that. No I/O: DashboardOpenTrace.ts feeds it.\n */\n\nexport type DashboardOpenTrigger = \"head-up\" | \"double-tap\"\n\n/** In order. `js` exists only when the gesture carried a native receipt time; `settled` needs CFW rev 27+. */\nexport const DASHBOARD_OPEN_STAGES = [\"js\", \"showView\", \"slot\", \"frame\", \"presented\", \"settled\"] as const\nexport type DashboardOpenStage = (typeof DASHBOARD_OPEN_STAGES)[number]\n\n/** The stages every open must pass; the first one missing is where it stalled. */\nconst REQUIRED_STAGES: readonly DashboardOpenStage[] = [\"showView\", \"slot\", \"frame\", \"presented\"]\n\nconst STAGE_LABELS: Record<DashboardOpenStage, string> = {\n  js: \"js\",\n  showView: \"showView\",\n  slot: \"slot\",\n  frame: \"frame\",\n  presented: \"shown\",\n  settled: \"settled\",\n}\n\nexport interface DashboardOpenTrace {\n  trigger: DashboardOpenTrigger\n  /** Further triggers of the same kind before the dashboard asked for the view. */\n  repeats: number\n  stages: Partial<Record<DashboardOpenStage, number>>\n  /** The first required stage that never arrived; absent once the glasses presented the frame. */\n  stalledAt?: DashboardOpenStage\n  /** What the glasses said when they reported the frame not presented. */\n  reason?: string\n  /** Since the overlay slot was last granted; null when it hasn't been this session. */\n  sinceLastOpenMs: number | null\n  /** How long the requesting overlay app had been connected at the gesture; negative when it connected after. */\n  appUpMs: number | null\n  /** How long the glasses had been connected at the gesture. */\n  glassesUpMs: number | null\n}\n\nexport interface DashboardOpenTimelineDeps {\n  now(): number\n  setTimeout: (callback: () => void, ms: number) => number\n  clearTimeout: (handle: number) => void\n  /** A finished open. A gesture the dashboard never answered with showView is dropped silently. */\n  onFinished(trace: DashboardOpenTrace): void\n}\n\n/** A gesture not answered with showView by then did not open the dashboard; a later stage missing by then stalled. */\nexport const OPEN_WINDOW_MS = 15_000\n/** How long to wait for the settle report once the frame was presented. */\nexport const SETTLE_GRACE_MS = 2_000\n/** A native receipt time further back than this is on some other clock. */\nconst MAX_NATIVE_LAG_MS = 60_000\n\ninterface ActiveOpen {\n  trace: DashboardOpenTrace\n  startedAt: number\n  frameSeq: number | null\n  timer: number\n}\n\nexport class DashboardOpenTimeline {\n  private active: ActiveOpen | null = null\n\n  constructor(private readonly deps: DashboardOpenTimelineDeps) {}\n\n  get tracing(): boolean {\n    return this.active !== null\n  }\n\n  /** The seq of the open's first overlay frame, once sent. */\n  get frameSeq(): number | null {\n    return this.active?.frameSeq ?? null\n  }\n\n  /**\n   * An opening gesture reached the phone. While an earlier one still waits\n   * for showView, the same gesture again only counts as a repeat (the clock\n   * keeps the first); a different gesture restarts the clock. Ignored once\n   * the open is under way.\n   */\n  trigger(\n    trigger: DashboardOpenTrigger,\n    context: {sinceLastOpenMs: number | null; glassesUpMs: number | null},\n    nativeAt?: number,\n  ): void {\n    const active = this.active\n    if (active) {\n      if (active.trace.stages.showView !== undefined) return\n      if (active.trace.trigger === trigger) {\n        active.trace.repeats++\n        return\n      }\n      this.cancel()\n    }\n    const now = this.deps.now()\n    const lag = nativeAt === undefined ? -1 : now - nativeAt\n    const native = nativeAt !== undefined && lag >= 0 && lag <= MAX_NATIVE_LAG_MS\n    this.active = {\n      trace: {trigger, repeats: 0, stages: native ? {js: lag} : {}, appUpMs: null, ...context},\n      startedAt: native ? nativeAt : now,\n      frameSeq: null,\n      timer: this.deps.setTimeout(() => this.expire(), OPEN_WINDOW_MS),\n    }\n  }\n\n  /** An overlay app asked for the dashboard view; `appConnectedAt` is when it connected, if known. */\n  showViewRequested(appConnectedAt: number | null): void {\n    const active = this.active\n    if (!active || active.trace.stages.showView !== undefined) return\n    active.trace.appUpMs = appConnectedAt === null ? null : active.startedAt - appConnectedAt\n    this.stamp(\"showView\")\n  }\n\n  slotGranted(): void {\n    if (this.active?.trace.stages.showView !== undefined) this.stamp(\"slot\")\n  }\n\n  /** The first overlay frame after the grant left for the glasses. */\n  frameSent(seq: number): void {\n    const active = this.active\n    if (!active || active.trace.stages.slot === undefined || active.frameSeq !== null) return\n    active.frameSeq = seq\n    this.stamp(\"frame\")\n  }\n\n  /**\n   * The glasses reported a frame. A later frame presented folds ours in; ours\n   * not presented is noted, and the window still waits for a later one.\n   */\n  framePresented(seq: number, presented: boolean, reason?: string): void {\n    const active = this.active\n    if (!active || active.frameSeq === null || seq < active.frameSeq) return\n    if (active.trace.stages.presented !== undefined) return\n    if (!presented) {\n      if (seq === active.frameSeq) active.trace.reason = reason ?? \"not presented\"\n      return\n    }\n    this.stamp(\"presented\")\n    this.deps.clearTimeout(active.timer)\n    active.timer = this.deps.setTimeout(() => this.finish(), SETTLE_GRACE_MS)\n  }\n\n  /** The glasses finished the animations of frame `seq` (and every frame before it). */\n  frameSettled(seq: number): void {\n    const active = this.active\n    if (!active || active.frameSeq === null || seq < active.frameSeq) return\n    this.stamp(\"presented\")\n    this.stamp(\"settled\")\n    this.finish()\n  }\n\n  cancel(): void {\n    if (!this.active) return\n    this.deps.clearTimeout(this.active.timer)\n    this.active = null\n  }\n\n  private stamp(stage: DashboardOpenStage): void {\n    const active = this.active\n    if (!active || active.trace.stages[stage] !== undefined) return\n    active.trace.stages[stage] = this.deps.now() - active.startedAt\n  }\n\n  private expire(): void {\n    const active = this.active\n    if (!active) return\n    if (active.trace.stages.showView === undefined) {\n      this.active = null\n      return\n    }\n    this.finish()\n  }\n\n  private finish(): void {\n    const active = this.active\n    if (!active) return\n    this.deps.clearTimeout(active.timer)\n    this.active = null\n    const {trace} = active\n    const stalledAt = REQUIRED_STAGES.find((stage) => trace.stages[stage] === undefined)\n    if (stalledAt) trace.stalledAt = stalledAt\n    else delete trace.reason\n    this.deps.onFinished(trace)\n  }\n}\n\n/** Notification title and body: the headline, the stage timeline, then the context that separates cold opens from warm ones. */\nexport function formatDashboardOpenTrace(trace: DashboardOpenTrace): {title: string; body: string} {\n  const shown = trace.stages.presented\n  const title =\n    trace.stalledAt === undefined && shown !== undefined\n      ? `Dashboard opened in ${formatMs(shown)} ms`\n      : `Dashboard open stalled before ${STAGE_LABELS[trace.stalledAt ?? \"presented\"]}`\n\n  const gesture = trace.repeats > 0 ? `${trace.trigger} ×${trace.repeats + 1}` : trace.trigger\n  const timeline = [`${gesture} 0`]\n  for (const stage of DASHBOARD_OPEN_STAGES) {\n    const at = trace.stages[stage]\n    if (at !== undefined) timeline.push(`${STAGE_LABELS[stage]} +${formatMs(at)}`)\n  }\n\n  const context = [\n    trace.sinceLastOpenMs === null\n      ? \"first open this session\"\n      : `last open ${formatDuration(trace.sinceLastOpenMs)} ago`,\n  ]\n  if (trace.appUpMs !== null) {\n    context.push(\n      trace.appUpMs < 0\n        ? `dashboard app connected ${formatDuration(-trace.appUpMs)} after the gesture`\n        : `dashboard app up ${formatDuration(trace.appUpMs)}`,\n    )\n  }\n  if (trace.glassesUpMs !== null) context.push(`glasses up ${formatDuration(trace.glassesUpMs)}`)\n\n  const lines = [timeline.join(\" · \"), context.join(\" · \")]\n  if (trace.reason) lines.push(`glasses: ${trace.reason}`)\n  return {title, body: lines.join(\"\\n\")}\n}\n\n/** 5210 → \"5,210\". Hand-rolled so it doesn't depend on the runtime's Intl. */\nfunction formatMs(ms: number): string {\n  return String(Math.round(ms)).replace(/\\B(?=(\\d{3})+(?!\\d))/g, \",\")\n}\n\nfunction formatDuration(ms: number): string {\n  if (ms < 1_000) return `${Math.round(ms)} ms`\n  if (ms < 60_000) return `${Math.round(ms / 1_000)} s`\n  if (ms < 3_600_000) return `${Math.round(ms / 60_000)} min`\n  const hours = Math.floor(ms / 3_600_000)\n  const minutes = Math.round((ms % 3_600_000) / 60_000)\n  return minutes > 0 ? `${hours} h ${minutes} min` : `${hours} h`\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"effectiveCapabilities.d.ts","sourceRoot":"","sources":["../../src/services/effectiveCapabilities.ts"],"names":[],"mappings":"AAWA,OAAO,EAAC,WAAW,EAAwB,KAAK,YAAY,EAAC,MAAM,UAAU,CAAA;AAM7E,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAI3D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAkBzE"}
+{"version":3,"file":"effectiveCapabilities.d.ts","sourceRoot":"","sources":["../../src/services/effectiveCapabilities.ts"],"names":[],"mappings":"AAcA,OAAO,EAAqB,WAAW,EAAwB,KAAK,YAAY,EAAC,MAAM,UAAU,CAAA;AAOjG,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAI3D;AAMD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CA6BzE"}

package/build/services/effectiveCapabilities.js

@@ -6,36 +6,48 @@
  * Native publishes the canvas into the glasses status (0 = none). Because
  * that path is phone-side rasterization, the stock firmware's container
  * pools (6 text / 4 image) don't bound a CFW frame either — element caps are
- * lifted alongside the canvas, bounded only to keep frames sane.
+ * lifted alongside the canvas, bounded only to keep frames sane. Firmware
+ * that draws vector shapes keeps 128 scene slots, so shape-heavy frames
+ * (a game board, a chart) get a larger shared text/shape budget.
  */
 import { useGlassesStore } from "../stores/glasses";
-import { DeviceTypes, getModelCapabilities } from "../types";
-import { isGlasslyCfwFirmwareVersion } from "./CustomDashboardModel";
+import { SETTINGS, useSettingsStore } from "../stores/settings";
+import { ALL_DISPLAY_SHAPES, DeviceTypes, getModelCapabilities } from "../types";
+import { resolveNativeNavigation } from "./nativeNavigationGate";
 const CFW_MAX_TEXT_ELEMENTS = 24;
 const CFW_MAX_IMAGE_ELEMENTS = 16;
+const CFW_VECTOR_MAX_ELEMENTS = 120;
 export function runtimeSceneCanvas() {
     const { sceneCanvasWidth, sceneCanvasHeight } = useGlassesStore.getState();
     if (!sceneCanvasWidth || !sceneCanvasHeight || sceneCanvasWidth <= 0 || sceneCanvasHeight <= 0)
         return null;
     return { width: sceneCanvasWidth, height: sceneCanvasHeight };
 }
+function forceNativeNavigationOnCfw() {
+    return useSettingsStore.getState().getSetting(SETTINGS.cfw_native_navigation.key) === true;
+}
 export function getEffectiveCapabilities(model) {
     const base = getModelCapabilities(model);
-    const canvas = runtimeSceneCanvas();
-    // The firmware marker lifts the caps even when no canvas has been published:
-    // CFW classification rides the version string, and a G2 running Glassly CFW
-    // always rasterizes phone-side regardless of whether native reported dims.
-    const cfw = model === DeviceTypes.G2 && isGlasslyCfwFirmwareVersion(useGlassesStore.getState().firmwareVersion);
-    if (!base.display || (!canvas && !cfw))
+    // Only G2 CFW publishes a canvas; never let a stale value reshape another model.
+    const canvas = model === DeviceTypes.G2 ? runtimeSceneCanvas() : null;
+    if (!base.display || !canvas)
         return base;
+    // 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;
     return {
         ...base,
+        hasNativeNavigation: resolveNativeNavigation(base.hasNativeNavigation, true, forceNativeNavigationOnCfw()),
         display: {
             ...base.display,
-            width: canvas?.width ?? base.display.width,
-            height: canvas?.height ?? base.display.height,
-            maxTextElements: Math.max(base.display.maxTextElements ?? 0, CFW_MAX_TEXT_ELEMENTS),
-            maxImageElements: Math.max(base.display.maxImageElements ?? 0, CFW_MAX_IMAGE_ELEMENTS),
+            width: canvas.width,
+            height: canvas.height,
+            maxTextElements: Math.max(base.display.maxTextElements ?? 0, vector ? CFW_VECTOR_MAX_ELEMENTS : CFW_MAX_TEXT_ELEMENTS),
+            // Vector firmware draws an image as one cached slot, the same as a shape.
+            maxImageElements: Math.max(base.display.maxImageElements ?? 0, vector ? CFW_VECTOR_MAX_ELEMENTS : CFW_MAX_IMAGE_ELEMENTS),
+            ...(vector
+                ? { shapes: [...ALL_DISPLAY_SHAPES, "svg"], animation: true, rotation: true, depth: true }
+                : {}),
         },
     };
 }

package/build/services/effectiveCapabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"effectiveCapabilities.js","sourceRoot":"","sources":["../../src/services/effectiveCapabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAC,WAAW,EAAE,oBAAoB,EAAoB,MAAM,UAAU,CAAA;AAC7E,OAAO,EAAC,2BAA2B,EAAC,MAAM,wBAAwB,CAAA;AAElE,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAChC,MAAM,sBAAsB,GAAG,EAAE,CAAA;AAOjC,MAAM,UAAU,kBAAkB;IAChC,MAAM,EAAC,gBAAgB,EAAE,iBAAiB,EAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAA;IACxE,IAAI,CAAC,gBAAgB,IAAI,CAAC,iBAAiB,IAAI,gBAAgB,IAAI,CAAC,IAAI,iBAAiB,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC3G,OAAO,EAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,EAAC,CAAA;AAC7D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAkB;IACzD,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAA;IACxC,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAA;IACnC,6EAA6E;IAC7E,4EAA4E;IAC5E,2EAA2E;IAC3E,MAAM,GAAG,GAAG,KAAK,KAAK,WAAW,CAAC,EAAE,IAAI,2BAA2B,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,eAAe,CAAC,CAAA;IAC/G,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACnD,OAAO;QACL,GAAG,IAAI;QACP,OAAO,EAAE;YACP,GAAG,IAAI,CAAC,OAAO;YACf,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK;YAC1C,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;YAC7C,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,EAAE,qBAAqB,CAAC;YACnF,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,CAAC,EAAE,sBAAsB,CAAC;SACvF;KACF,CAAA;AACH,CAAC","sourcesContent":["/**\n * Effective device capabilities — the static model profile plus what the\n * connected firmware reports at runtime. The runtime override is the scene\n * canvas: Glassly CFW on the G2 rasterizes scenes phone-side straight into\n * the 640×480 panel, so the drawable canvas grows past stock's 576×288.\n * Native publishes the canvas into the glasses status (0 = none). Because\n * that path is phone-side rasterization, the stock firmware's container\n * pools (6 text / 4 image) don't bound a CFW frame either — element caps are\n * lifted alongside the canvas, bounded only to keep frames sane.\n */\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {DeviceTypes, getModelCapabilities, type Capabilities} from \"../types\"\nimport {isGlasslyCfwFirmwareVersion} from \"./CustomDashboardModel\"\n\nconst CFW_MAX_TEXT_ELEMENTS = 24\nconst CFW_MAX_IMAGE_ELEMENTS = 16\n\nexport interface SceneCanvasSize {\n  width: number\n  height: number\n}\n\nexport function runtimeSceneCanvas(): SceneCanvasSize | null {\n  const {sceneCanvasWidth, sceneCanvasHeight} = useGlassesStore.getState()\n  if (!sceneCanvasWidth || !sceneCanvasHeight || sceneCanvasWidth <= 0 || sceneCanvasHeight <= 0) return null\n  return {width: sceneCanvasWidth, height: sceneCanvasHeight}\n}\n\nexport function getEffectiveCapabilities(model: DeviceTypes): Capabilities {\n  const base = getModelCapabilities(model)\n  const canvas = runtimeSceneCanvas()\n  // The firmware marker lifts the caps even when no canvas has been published:\n  // CFW classification rides the version string, and a G2 running Glassly CFW\n  // always rasterizes phone-side regardless of whether native reported dims.\n  const cfw = model === DeviceTypes.G2 && isGlasslyCfwFirmwareVersion(useGlassesStore.getState().firmwareVersion)\n  if (!base.display || (!canvas && !cfw)) return base\n  return {\n    ...base,\n    display: {\n      ...base.display,\n      width: canvas?.width ?? base.display.width,\n      height: canvas?.height ?? base.display.height,\n      maxTextElements: Math.max(base.display.maxTextElements ?? 0, CFW_MAX_TEXT_ELEMENTS),\n      maxImageElements: Math.max(base.display.maxImageElements ?? 0, CFW_MAX_IMAGE_ELEMENTS),\n    },\n  }\n}\n"]}
+{"version":3,"file":"effectiveCapabilities.js","sourceRoot":"","sources":["../../src/services/effectiveCapabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAC,QAAQ,EAAE,gBAAgB,EAAC,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAC,kBAAkB,EAAE,WAAW,EAAE,oBAAoB,EAAoB,MAAM,UAAU,CAAA;AACjG,OAAO,EAAC,uBAAuB,EAAC,MAAM,wBAAwB,CAAA;AAE9D,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAChC,MAAM,sBAAsB,GAAG,EAAE,CAAA;AACjC,MAAM,uBAAuB,GAAG,GAAG,CAAA;AAOnC,MAAM,UAAU,kBAAkB;IAChC,MAAM,EAAC,gBAAgB,EAAE,iBAAiB,EAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAA;IACxE,IAAI,CAAC,gBAAgB,IAAI,CAAC,iBAAiB,IAAI,gBAAgB,IAAI,CAAC,IAAI,iBAAiB,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC3G,OAAO,EAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,EAAC,CAAA;AAC7D,CAAC;AAED,SAAS,0BAA0B;IACjC,OAAO,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,qBAAqB,CAAC,GAAG,CAAC,KAAK,IAAI,CAAA;AAC5F,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAkB;IACzD,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAA;IACxC,iFAAiF;IACjF,MAAM,MAAM,GAAG,KAAK,KAAK,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IACrE,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACzC,iFAAiF;IACjF,qEAAqE;IACrE,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC,WAAW,KAAK,IAAI,CAAA;IAC9D,OAAO;QACL,GAAG,IAAI;QACP,mBAAmB,EAAE,uBAAuB,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;QAC1G,OAAO,EAAE;YACP,GAAG,IAAI,CAAC,OAAO;YACf,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,eAAe,EAAE,IAAI,CAAC,GAAG,CACvB,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,EACjC,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,qBAAqB,CACzD;YACD,0EAA0E;YAC1E,gBAAgB,EAAE,IAAI,CAAC,GAAG,CACxB,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,CAAC,EAClC,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,sBAAsB,CAC1D;YACD,GAAG,CAAC,MAAM;gBACR,CAAC,CAAC,EAAC,MAAM,EAAE,CAAC,GAAG,kBAAkB,EAAE,KAAc,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAC;gBACjG,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAA;AACH,CAAC","sourcesContent":["/**\n * Effective device capabilities — the static model profile plus what the\n * connected firmware reports at runtime. The runtime override is the scene\n * canvas: Glassly CFW on the G2 rasterizes scenes phone-side straight into\n * the 640×480 panel, so the drawable canvas grows past stock's 576×288.\n * Native publishes the canvas into the glasses status (0 = none). Because\n * that path is phone-side rasterization, the stock firmware's container\n * pools (6 text / 4 image) don't bound a CFW frame either — element caps are\n * lifted alongside the canvas, bounded only to keep frames sane. Firmware\n * that draws vector shapes keeps 128 scene slots, so shape-heavy frames\n * (a game board, a chart) get a larger shared text/shape budget.\n */\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {SETTINGS, useSettingsStore} from \"../stores/settings\"\nimport {ALL_DISPLAY_SHAPES, DeviceTypes, getModelCapabilities, type Capabilities} from \"../types\"\nimport {resolveNativeNavigation} from \"./nativeNavigationGate\"\n\nconst CFW_MAX_TEXT_ELEMENTS = 24\nconst CFW_MAX_IMAGE_ELEMENTS = 16\nconst CFW_VECTOR_MAX_ELEMENTS = 120\n\nexport interface SceneCanvasSize {\n  width: number\n  height: number\n}\n\nexport function runtimeSceneCanvas(): SceneCanvasSize | null {\n  const {sceneCanvasWidth, sceneCanvasHeight} = useGlassesStore.getState()\n  if (!sceneCanvasWidth || !sceneCanvasHeight || sceneCanvasWidth <= 0 || sceneCanvasHeight <= 0) return null\n  return {width: sceneCanvasWidth, height: sceneCanvasHeight}\n}\n\nfunction forceNativeNavigationOnCfw(): boolean {\n  return useSettingsStore.getState().getSetting(SETTINGS.cfw_native_navigation.key) === true\n}\n\nexport function getEffectiveCapabilities(model: DeviceTypes): Capabilities {\n  const base = getModelCapabilities(model)\n  // Only G2 CFW publishes a canvas; never let a stale value reshape another model.\n  const canvas = model === DeviceTypes.G2 ? runtimeSceneCanvas() : null\n  if (!base.display || !canvas) return base\n  // Glassly CFW supports the complete vector contract, including SVG and rotation.\n  // Upstream g2flash publishes a raster canvas with sceneVector=false.\n  const vector = useGlassesStore.getState().sceneVector === true\n  return {\n    ...base,\n    hasNativeNavigation: resolveNativeNavigation(base.hasNativeNavigation, true, forceNativeNavigationOnCfw()),\n    display: {\n      ...base.display,\n      width: canvas.width,\n      height: canvas.height,\n      maxTextElements: Math.max(\n        base.display.maxTextElements ?? 0,\n        vector ? CFW_VECTOR_MAX_ELEMENTS : CFW_MAX_TEXT_ELEMENTS,\n      ),\n      // Vector firmware draws an image as one cached slot, the same as a shape.\n      maxImageElements: Math.max(\n        base.display.maxImageElements ?? 0,\n        vector ? CFW_VECTOR_MAX_ELEMENTS : CFW_MAX_IMAGE_ELEMENTS,\n      ),\n      ...(vector\n        ? {shapes: [...ALL_DISPLAY_SHAPES, \"svg\" as const], animation: true, rotation: true, depth: true}\n        : {}),\n    },\n  }\n}\n"]}

package/build/services/gestureClaims.d.ts

@@ -1,18 +1,37 @@
 /**
- * Gesture-claim arbitration (CLAIM_GESTURES), split out of
- * LocalMiniappRuntime so it is unit-testable — the runtime module itself
- * pulls a native import surface bun can't parse.
+ * Gesture registrations in claim order. Exactly one miniapp receives each
+ * gesture: the last registration containing it wins. Named scopes let an
+ * app temporarily claim gestures without overwriting its persistent shortcuts.
+ * Releasing a scope restores the preceding registration; stopping removes all
+ * of the app's scopes. This module has no native dependencies.
  */
-/**
- * True iff the miniapp in front of the user has claimed `gesture`.
- *
- * "In front" spans both screens. Most claiming apps are glasses-side: the
- * terminal runs as a background miniapp with the phone pocketed, so gating on
- * the phone's Compositor foreground alone left its double_tap claim inert and
- * the system dashboard kept opening mid-session. Glasses ownership is the
- * primary signal; the phone foreground is still honored for apps driven from
- * the handset. A claimer that owns neither screen is background and never
- * hijacks a system gesture.
- */
-export declare function claimsGesture(claims: ReadonlyMap<string, ReadonlySet<string>>, gesture: string, glassesOwner: string | null, phoneForeground: string | null): boolean;
+interface GestureRegistration {
+    packageName: string;
+    scope: string;
+    gestures: ReadonlySet<string>;
+}
+export interface GestureClaimState {
+    registrations: readonly GestureRegistration[];
+}
+export interface GestureClaimChange {
+    packageName: string;
+    gesture: string;
+    held: boolean;
+}
+export declare function emptyGestureClaims(): GestureClaimState;
+/** The single receiver of this gesture, regardless of how many scopes registered it. */
+export declare function gestureClaimant(state: GestureClaimState, gesture: string): string | null;
+/** Registration and current ownership differ when another app claimed more recently. */
+export declare function hasGestureClaim(state: GestureClaimState, packageName: string, gesture: string): boolean;
+/** Replace one scope's set. A nonempty registration always becomes the newest claim. */
+export declare function setGestureClaims(state: GestureClaimState, packageName: string, gestures: readonly string[], scope?: string): {
+    state: GestureClaimState;
+    changes: GestureClaimChange[];
+};
+/** Stop removes every scope without notifying the stopped app. */
+export declare function dropGestureClaims(state: GestureClaimState, packageName: string): {
+    state: GestureClaimState;
+    changes: GestureClaimChange[];
+};
+export {};
 //# sourceMappingURL=gestureClaims.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"gestureClaims.d.ts","sourceRoot":"","sources":["../../src/services/gestureClaims.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,EAChD,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,GAC7B,OAAO,CAKT"}
+{"version":3,"file":"gestureClaims.d.ts","sourceRoot":"","sources":["../../src/services/gestureClaims.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,UAAU,mBAAmB;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,SAAS,mBAAmB,EAAE,CAAA;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,OAAO,CAAA;CACd;AAED,wBAAgB,kBAAkB,IAAI,iBAAiB,CAEtD;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxF;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvG;AAeD,wFAAwF;AACxF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,KAAK,SAAY,GAChB;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAAC,CAO3D;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,MAAM,GAClB;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAAC,CAG3D"}

package/build/services/gestureClaims.js

@@ -1,24 +1,45 @@
-/**
- * Gesture-claim arbitration (CLAIM_GESTURES), split out of
- * LocalMiniappRuntime so it is unit-testable — the runtime module itself
- * pulls a native import surface bun can't parse.
- */
-/**
- * True iff the miniapp in front of the user has claimed `gesture`.
- *
- * "In front" spans both screens. Most claiming apps are glasses-side: the
- * terminal runs as a background miniapp with the phone pocketed, so gating on
- * the phone's Compositor foreground alone left its double_tap claim inert and
- * the system dashboard kept opening mid-session. Glasses ownership is the
- * primary signal; the phone foreground is still honored for apps driven from
- * the handset. A claimer that owns neither screen is background and never
- * hijacks a system gesture.
- */
-export function claimsGesture(claims, gesture, glassesOwner, phoneForeground) {
-    for (const pkg of [glassesOwner, phoneForeground]) {
-        if (pkg && claims.get(pkg)?.has(gesture) === true)
-            return true;
+export function emptyGestureClaims() {
+    return { registrations: [] };
+}
+/** The single receiver of this gesture, regardless of how many scopes registered it. */
+export function gestureClaimant(state, gesture) {
+    for (let i = state.registrations.length - 1; i >= 0; i--) {
+        const registration = state.registrations[i];
+        if (registration.gestures.has(gesture))
+            return registration.packageName;
+    }
+    return null;
+}
+/** Registration and current ownership differ when another app claimed more recently. */
+export function hasGestureClaim(state, packageName, gesture) {
+    return state.registrations.some((entry) => entry.packageName === packageName && entry.gestures.has(gesture));
+}
+function changesBetween(before, after) {
+    const gestures = new Set([...before.registrations, ...after.registrations].flatMap((entry) => [...entry.gestures]));
+    const changes = [];
+    for (const gesture of gestures) {
+        const was = gestureClaimant(before, gesture);
+        const now = gestureClaimant(after, gesture);
+        if (was === now)
+            continue;
+        if (was !== null)
+            changes.push({ packageName: was, gesture, held: false });
+        if (now !== null)
+            changes.push({ packageName: now, gesture, held: true });
     }
-    return false;
+    return changes;
+}
+/** Replace one scope's set. A nonempty registration always becomes the newest claim. */
+export function setGestureClaims(state, packageName, gestures, scope = "default") {
+    const registrations = state.registrations.filter((entry) => entry.packageName !== packageName || entry.scope !== scope);
+    if (gestures.length)
+        registrations.push({ packageName, scope, gestures: new Set(gestures) });
+    const after = { registrations };
+    return { state: after, changes: changesBetween(state, after) };
+}
+/** Stop removes every scope without notifying the stopped app. */
+export function dropGestureClaims(state, packageName) {
+    const after = { registrations: state.registrations.filter((entry) => entry.packageName !== packageName) };
+    return { state: after, changes: changesBetween(state, after).filter((change) => change.packageName !== packageName) };
 }
 //# sourceMappingURL=gestureClaims.js.map

package/build/services/gestureClaims.js.map

@@ -1 +1 @@
-{"version":3,"file":"gestureClaims.js","sourceRoot":"","sources":["../../src/services/gestureClaims.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAgD,EAChD,OAAe,EACf,YAA2B,EAC3B,eAA8B;IAE9B,KAAK,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE,CAAC;QAClD,IAAI,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;IAChE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC","sourcesContent":["/**\n * Gesture-claim arbitration (CLAIM_GESTURES), split out of\n * LocalMiniappRuntime so it is unit-testable — the runtime module itself\n * pulls a native import surface bun can't parse.\n */\n\n/**\n * True iff the miniapp in front of the user has claimed `gesture`.\n *\n * \"In front\" spans both screens. Most claiming apps are glasses-side: the\n * terminal runs as a background miniapp with the phone pocketed, so gating on\n * the phone's Compositor foreground alone left its double_tap claim inert and\n * the system dashboard kept opening mid-session. Glasses ownership is the\n * primary signal; the phone foreground is still honored for apps driven from\n * the handset. A claimer that owns neither screen is background and never\n * hijacks a system gesture.\n */\nexport function claimsGesture(\n  claims: ReadonlyMap<string, ReadonlySet<string>>,\n  gesture: string,\n  glassesOwner: string | null,\n  phoneForeground: string | null,\n): boolean {\n  for (const pkg of [glassesOwner, phoneForeground]) {\n    if (pkg && claims.get(pkg)?.has(gesture) === true) return true\n  }\n  return false\n}\n"]}
+{"version":3,"file":"gestureClaims.js","sourceRoot":"","sources":["../../src/services/gestureClaims.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Gesture registrations in claim order. Exactly one miniapp receives each\n * gesture: the last registration containing it wins. Named scopes let an\n * app temporarily claim gestures without overwriting its persistent shortcuts.\n * Releasing a scope restores the preceding registration; stopping removes all\n * of the app's scopes. This module has no native dependencies.\n */\ninterface GestureRegistration {\n  packageName: string\n  scope: string\n  gestures: ReadonlySet<string>\n}\n\nexport interface GestureClaimState {\n  registrations: readonly GestureRegistration[]\n}\n\nexport interface GestureClaimChange {\n  packageName: string\n  gesture: string\n  held: boolean\n}\n\nexport function emptyGestureClaims(): GestureClaimState {\n  return {registrations: []}\n}\n\n/** The single receiver of this gesture, regardless of how many scopes registered it. */\nexport function gestureClaimant(state: GestureClaimState, gesture: string): string | null {\n  for (let i = state.registrations.length - 1; i >= 0; i--) {\n    const registration = state.registrations[i]\n    if (registration.gestures.has(gesture)) return registration.packageName\n  }\n  return null\n}\n\n/** Registration and current ownership differ when another app claimed more recently. */\nexport function hasGestureClaim(state: GestureClaimState, packageName: string, gesture: string): boolean {\n  return state.registrations.some((entry) => entry.packageName === packageName && entry.gestures.has(gesture))\n}\n\nfunction changesBetween(before: GestureClaimState, after: GestureClaimState): GestureClaimChange[] {\n  const gestures = new Set([...before.registrations, ...after.registrations].flatMap((entry) => [...entry.gestures]))\n  const changes: GestureClaimChange[] = []\n  for (const gesture of gestures) {\n    const was = gestureClaimant(before, gesture)\n    const now = gestureClaimant(after, gesture)\n    if (was === now) continue\n    if (was !== null) changes.push({packageName: was, gesture, held: false})\n    if (now !== null) changes.push({packageName: now, gesture, held: true})\n  }\n  return changes\n}\n\n/** Replace one scope's set. A nonempty registration always becomes the newest claim. */\nexport function setGestureClaims(\n  state: GestureClaimState,\n  packageName: string,\n  gestures: readonly string[],\n  scope = \"default\",\n): {state: GestureClaimState; changes: GestureClaimChange[]} {\n  const registrations = state.registrations.filter(\n    (entry) => entry.packageName !== packageName || entry.scope !== scope,\n  )\n  if (gestures.length) registrations.push({packageName, scope, gestures: new Set(gestures)})\n  const after = {registrations}\n  return {state: after, changes: changesBetween(state, after)}\n}\n\n/** Stop removes every scope without notifying the stopped app. */\nexport function dropGestureClaims(\n  state: GestureClaimState,\n  packageName: string,\n): {state: GestureClaimState; changes: GestureClaimChange[]} {\n  const after = {registrations: state.registrations.filter((entry) => entry.packageName !== packageName)}\n  return {state: after, changes: changesBetween(state, after).filter((change) => change.packageName !== packageName)}\n}\n"]}

package/build/services/manifestFields.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pure normalizers for the free-text manifest fields (miniapp.json) that the
+ * installed-app projection carries onto ClientApp.
+ */
+/** A non-empty manifest string, trimmed; anything else is absent. */
+export declare function normalizeManifestText(raw: unknown): string | undefined;
+/** Manifest tags: lowercase slugs, de-duplicated, non-strings dropped. */
+export declare function normalizeManifestTags(raw: unknown): string[];
+//# sourceMappingURL=manifestFields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifestFields.d.ts","sourceRoot":"","sources":["../../src/services/manifestFields.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAItE;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAS5D"}

package/build/services/manifestFields.js

@@ -0,0 +1,26 @@
+/**
+ * Pure normalizers for the free-text manifest fields (miniapp.json) that the
+ * installed-app projection carries onto ClientApp.
+ */
+/** A non-empty manifest string, trimmed; anything else is absent. */
+export function normalizeManifestText(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    const trimmed = raw.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+/** Manifest tags: lowercase slugs, de-duplicated, non-strings dropped. */
+export function normalizeManifestTags(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const tag of raw) {
+        if (typeof tag !== "string")
+            continue;
+        const slug = tag.trim().toLowerCase();
+        if (slug.length > 0 && !out.includes(slug))
+            out.push(slug);
+    }
+    return out;
+}
+//# sourceMappingURL=manifestFields.js.map

package/build/services/manifestFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifestFields.js","sourceRoot":"","sources":["../../src/services/manifestFields.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC7C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IAC1B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AACjD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAClC,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAQ;QACrC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QACrC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5D,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC","sourcesContent":["/**\n * Pure normalizers for the free-text manifest fields (miniapp.json) that the\n * installed-app projection carries onto ClientApp.\n */\n\n/** A non-empty manifest string, trimmed; anything else is absent. */\nexport function normalizeManifestText(raw: unknown): string | undefined {\n  if (typeof raw !== \"string\") return undefined\n  const trimmed = raw.trim()\n  return trimmed.length > 0 ? trimmed : undefined\n}\n\n/** Manifest tags: lowercase slugs, de-duplicated, non-strings dropped. */\nexport function normalizeManifestTags(raw: unknown): string[] {\n  if (!Array.isArray(raw)) return []\n  const out: string[] = []\n  for (const tag of raw) {\n    if (typeof tag !== \"string\") continue\n    const slug = tag.trim().toLowerCase()\n    if (slug.length > 0 && !out.includes(slug)) out.push(slug)\n  }\n  return out\n}\n"]}

package/build/services/memoryStoreInstance.d.ts

@@ -5,15 +5,5 @@
  * dependency-free for tests.
  */
 import { MemoryStore } from "./MemoryStore";
-/** Whether the extended (Plus/Pro) retention window is active right now. */
-export declare function isMemoryRetentionExtended(): boolean;
-/**
- * Flip the visible retention window. Called by the host app when the
- * subscription state resolves or changes. Downgrading freezes reads to the
- * standard window but deletes nothing — the older timeline stays stored and
- * reappears on re-upgrade (MemoryStore prunes at the extended bound for
- * every tier).
- */
-export declare function setMemoryRetentionExtended(extended: boolean): void;
 export declare const memoryStore: MemoryStore;
 //# sourceMappingURL=memoryStoreInstance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"memoryStoreInstance.d.ts","sourceRoot":"","sources":["../../src/services/memoryStoreInstance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAqB,WAAW,EAAqB,MAAM,eAAe,CAAA;AAejF,4EAA4E;AAC5E,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAIlE;AAED,eAAO,MAAM,WAAW,aAetB,CAAA"}
+{"version":3,"file":"memoryStoreInstance.d.ts","sourceRoot":"","sources":["../../src/services/memoryStoreInstance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAA;AAEzC,eAAO,MAAM,WAAW,aActB,CAAA"}

package/build/services/memoryStoreInstance.js

@@ -7,38 +7,9 @@
 import { AppState } from "react-native";
 import { storage as mmkvStorage } from "../utils/storage/storage";
 import { cloudClientService } from "./CloudClientService";
-import { EXTENDED_RETENTION, MemoryStore, STANDARD_RETENTION } from "./MemoryStore";
-/**
- * Persisted "Plus/Pro memory retention" flag. Cached in MMKV so a paying user
- * who relaunches offline keeps their full read window; only a DEFINITIVE
- * subscription answer may change it (the RevenueCatSetup effect passes
- * nothing on unknown/null customer info).
- */
-const RETENTION_EXTENDED_KEY = "memory_retention_extended";
-let retentionExtended = (() => {
-    const result = mmkvStorage.load(RETENTION_EXTENDED_KEY);
-    return result.is_ok() && result.value === true;
-})();
-/** Whether the extended (Plus/Pro) retention window is active right now. */
-export function isMemoryRetentionExtended() {
-    return retentionExtended;
-}
-/**
- * Flip the visible retention window. Called by the host app when the
- * subscription state resolves or changes. Downgrading freezes reads to the
- * standard window but deletes nothing — the older timeline stays stored and
- * reappears on re-upgrade (MemoryStore prunes at the extended bound for
- * every tier).
- */
-export function setMemoryRetentionExtended(extended) {
-    if (retentionExtended === extended)
-        return;
-    retentionExtended = extended;
-    mmkvStorage.save(RETENTION_EXTENDED_KEY, extended);
-}
+import { MemoryStore } from "./MemoryStore";
 export const memoryStore = new MemoryStore({
-    getUserId: () => cloudClientService.resolveGlasslyUserId(),
-    getRetention: () => (retentionExtended ? EXTENDED_RETENTION : STANDARD_RETENTION),
+    getUserId: () => cloudClientService.resolveUserId(),
     backend: {
         get(key) {
             const result = mmkvStorage.load(key);

package/build/services/memoryStoreInstance.js.map

@@ -1 +1 @@
-{"version":3,"file":"memoryStoreInstance.js","sourceRoot":"","sources":["../../src/services/memoryStoreInstance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,cAAc,CAAA;AAErC,OAAO,EAAC,OAAO,IAAI,WAAW,EAAC,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAC,kBAAkB,EAAE,WAAW,EAAE,kBAAkB,EAAC,MAAM,eAAe,CAAA;AAEjF;;;;;GAKG;AACH,MAAM,sBAAsB,GAAG,2BAA2B,CAAA;AAE1D,IAAI,iBAAiB,GAAG,CAAC,GAAY,EAAE;IACrC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAU,sBAAsB,CAAC,CAAA;IAChE,OAAO,MAAM,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,CAAA;AAChD,CAAC,CAAC,EAAE,CAAA;AAEJ,4EAA4E;AAC5E,MAAM,UAAU,yBAAyB;IACvC,OAAO,iBAAiB,CAAA;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAiB;IAC1D,IAAI,iBAAiB,KAAK,QAAQ;QAAE,OAAM;IAC1C,iBAAiB,GAAG,QAAQ,CAAA;IAC5B,WAAW,CAAC,IAAI,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;IACzC,SAAS,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,oBAAoB,EAAE;IAC1D,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC;IACjF,OAAO,EAAE;QACP,GAAG,CAAC,GAAW;YACb,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAU,GAAG,CAAC,CAAA;YAC7C,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;QAC7C,CAAC;QACD,GAAG,CAAC,GAAW,EAAE,KAAc;YAC7B,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC9B,CAAC;QACD,MAAM,CAAC,GAAW;YAChB,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACzB,CAAC;KACF;CACF,CAAC,CAAA;AAEF,+EAA+E;AAC/E,6EAA6E;AAC7E,mFAAmF;AACnF,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;IAC5C,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAM;IAC9B,KAAK,WAAW,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACrC,OAAO,CAAC,IAAI,CAAC,0CAA0C,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACpG,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA","sourcesContent":["/**\n * The engine's singleton MemoryStore — the shared user-scoped memory timeline\n * behind LocalMiniappRuntime's MEMORY_* bridge handlers and engine.memory.\n * Lives in its own module (not MemoryStore.ts) so the store class stays\n * dependency-free for tests.\n */\n\nimport {AppState} from \"react-native\"\n\nimport {storage as mmkvStorage} from \"../utils/storage/storage\"\nimport {cloudClientService} from \"./CloudClientService\"\nimport {EXTENDED_RETENTION, MemoryStore, STANDARD_RETENTION} from \"./MemoryStore\"\n\n/**\n * Persisted \"Plus/Pro memory retention\" flag. Cached in MMKV so a paying user\n * who relaunches offline keeps their full read window; only a DEFINITIVE\n * subscription answer may change it (the RevenueCatSetup effect passes\n * nothing on unknown/null customer info).\n */\nconst RETENTION_EXTENDED_KEY = \"memory_retention_extended\"\n\nlet retentionExtended = ((): boolean => {\n  const result = mmkvStorage.load<boolean>(RETENTION_EXTENDED_KEY)\n  return result.is_ok() && result.value === true\n})()\n\n/** Whether the extended (Plus/Pro) retention window is active right now. */\nexport function isMemoryRetentionExtended(): boolean {\n  return retentionExtended\n}\n\n/**\n * Flip the visible retention window. Called by the host app when the\n * subscription state resolves or changes. Downgrading freezes reads to the\n * standard window but deletes nothing — the older timeline stays stored and\n * reappears on re-upgrade (MemoryStore prunes at the extended bound for\n * every tier).\n */\nexport function setMemoryRetentionExtended(extended: boolean): void {\n  if (retentionExtended === extended) return\n  retentionExtended = extended\n  mmkvStorage.save(RETENTION_EXTENDED_KEY, extended)\n}\n\nexport const memoryStore = new MemoryStore({\n  getUserId: () => cloudClientService.resolveGlasslyUserId(),\n  getRetention: () => (retentionExtended ? EXTENDED_RETENTION : STANDARD_RETENTION),\n  backend: {\n    get(key: string): unknown | null {\n      const result = mmkvStorage.load<unknown>(key)\n      return result.is_ok() ? result.value : null\n    },\n    set(key: string, value: unknown): void {\n      mmkvStorage.save(key, value)\n    },\n    remove(key: string): void {\n      mmkvStorage.remove(key)\n    },\n  },\n})\n\n// Transcript writes are debounced (see MemoryStore.schedulePersistLog), so the\n// tail of a conversation can be in-memory only when the user leaves the app.\n// Losing it to a background kill would be silent data loss — flush on the way out.\nAppState.addEventListener(\"change\", (state) => {\n  if (state === \"active\") return\n  void memoryStore.flush().catch((err) => {\n    console.warn(\"MemoryStore: flush on background failed:\", err instanceof Error ? err.message : err)\n  })\n})\n"]}
+{"version":3,"file":"memoryStoreInstance.js","sourceRoot":"","sources":["../../src/services/memoryStoreInstance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,cAAc,CAAA;AAErC,OAAO,EAAC,OAAO,IAAI,WAAW,EAAC,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAA;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;IACzC,SAAS,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,aAAa,EAAE;IACnD,OAAO,EAAE;QACP,GAAG,CAAC,GAAW;YACb,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAU,GAAG,CAAC,CAAA;YAC7C,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;QAC7C,CAAC;QACD,GAAG,CAAC,GAAW,EAAE,KAAc;YAC7B,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC9B,CAAC;QACD,MAAM,CAAC,GAAW;YAChB,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACzB,CAAC;KACF;CACF,CAAC,CAAA;AAEF,+EAA+E;AAC/E,6EAA6E;AAC7E,mFAAmF;AACnF,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;IAC5C,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAM;IAC9B,KAAK,WAAW,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACrC,OAAO,CAAC,IAAI,CAAC,0CAA0C,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACpG,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA","sourcesContent":["/**\n * The engine's singleton MemoryStore — the shared user-scoped memory timeline\n * behind LocalMiniappRuntime's MEMORY_* bridge handlers and engine.memory.\n * Lives in its own module (not MemoryStore.ts) so the store class stays\n * dependency-free for tests.\n */\n\nimport {AppState} from \"react-native\"\n\nimport {storage as mmkvStorage} from \"../utils/storage/storage\"\nimport {cloudClientService} from \"./CloudClientService\"\nimport {MemoryStore} from \"./MemoryStore\"\n\nexport const memoryStore = new MemoryStore({\n  getUserId: () => cloudClientService.resolveUserId(),\n  backend: {\n    get(key: string): unknown | null {\n      const result = mmkvStorage.load<unknown>(key)\n      return result.is_ok() ? result.value : null\n    },\n    set(key: string, value: unknown): void {\n      mmkvStorage.save(key, value)\n    },\n    remove(key: string): void {\n      mmkvStorage.remove(key)\n    },\n  },\n})\n\n// Transcript writes are debounced (see MemoryStore.schedulePersistLog), so the\n// tail of a conversation can be in-memory only when the user leaves the app.\n// Losing it to a background kill would be silent data loss — flush on the way out.\nAppState.addEventListener(\"change\", (state) => {\n  if (state === \"active\") return\n  void memoryStore.flush().catch((err) => {\n    console.warn(\"MemoryStore: flush on background failed:\", err instanceof Error ? err.message : err)\n  })\n})\n"]}