@buoy-gg/images 7.0.13 → 7.0.15

package/lib/typescript/remote.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Remote-dispatch seam for dashboard mirrors (Buoy Desktop).
+ *
+ * On device this stays null and every action in capture/ runs locally. A
+ * dashboard sets a handler that forwards the action name + params over the
+ * external-sync protocol to the SAME adapter actions the MCP uses
+ * (sync/imagesSyncAdapter.ts), so one action vocabulary serves phone UI,
+ * desktop UI, and LLM automation.
+ */
+import type { ActionResult } from "./capture/actions";
+export type ImagesRemoteDispatch = (action: string, params?: Record<string, unknown>) => Promise<unknown>;
+export declare function setRemoteImagesHandler(handler: ImagesRemoteDispatch | null): void;
+export declare function remoteImagesDispatch(): ImagesRemoteDispatch | null;
+/** Coerce an adapter action's `{ ok, message }` reply into an ActionResult. */
+export declare function remoteActionResult(call: Promise<unknown>): Promise<ActionResult>;
+//# sourceMappingURL=remote.d.ts.map

package/lib/typescript/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,oBAAoB,GAAG,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,oBAAoB,GAAG,IAAI,GACnC,IAAI,CAEN;AAED,wBAAgB,oBAAoB,IAAI,oBAAoB,GAAG,IAAI,CAElE;AAED,+EAA+E;AAC/E,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GACrB,OAAO,CAAC,YAAY,CAAC,CAUvB"}

package/lib/typescript/state.d.ts

@@ -9,7 +9,7 @@
  * flag. Keying all mutable state on globalThis under a well-known symbol makes
  * every copy operate on the same data.
  */
-import type { ImageRecord } from "./types";
+import type { CaptureStatus, ImageRecord } from "./types";
 export interface ImagesGlobalState {
     records: ImageRecord[];
     byId: Map<number, ImageRecord>;
@@ -49,6 +49,14 @@ export interface ImagesGlobalState {
         network: "normal" | "offline" | "cold";
         blank: boolean;
     };
+    /** True on dashboards: local capture must never install (mirror only). */
+    captureDisabled: boolean;
+    /** Forwards actions to the synced device instead of running them locally. */
+    remoteDispatch: ((action: string, params?: Record<string, unknown>) => Promise<unknown>) | null;
+    /** Device PixelRatio derived from the synced snapshot (layout → neededPx). */
+    mirrorPixelRatio: number | null;
+    /** Device-reported capture status (overrides the local probe on mirrors). */
+    mirrorCaptureStatus: CaptureStatus | null;
 }
 export declare function imagesState(): ImagesGlobalState;
 //# sourceMappingURL=state.d.ts.map

package/lib/typescript/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAEhC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IAEvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IAEvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IAEnB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IAErB,uEAAuE;IACvE,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC9D,gFAAgF;IAChF,eAAe,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IACjC,wEAAwE;IACxE,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpC,6EAA6E;IAC7E,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,wEAAwE;IACxE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,6EAA6E;IAC7E,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,WAAW,EAAE;QAAE,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CACzE;AAID,wBAAgB,WAAW,IAAI,iBAAiB,CA8B/C"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAEhC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IAEvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IAEvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IAEnB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IAErB,uEAAuE;IACvE,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC9D,gFAAgF;IAChF,eAAe,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IACjC,wEAAwE;IACxE,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpC,6EAA6E;IAC7E,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,wEAAwE;IACxE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,6EAA6E;IAC7E,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,WAAW,EAAE;QAAE,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAExE,0EAA0E;IAC1E,eAAe,EAAE,OAAO,CAAC;IACzB,6EAA6E;IAC7E,cAAc,EACV,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GACxE,IAAI,CAAC;IACT,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,6EAA6E;IAC7E,mBAAmB,EAAE,aAAa,GAAG,IAAI,CAAC;CAC3C;AAID,wBAAgB,WAAW,IAAI,iBAAiB,CAkC/C"}

package/lib/typescript/store/imageEventStore.d.ts

@@ -8,7 +8,7 @@
  * globalThis singleton (see ../state.ts) so a dual module instance of this
  * package still reads/writes one shared store.
  */
-import type { ImageRecord, ImageStats } from "../types";
+import type { ImageRecord, ImageStats, ImagesSnapshotPayload } from "../types";
 export declare function createRecord(partial: Omit<ImageRecord, "id" | "createdAt" | "loadCount" | "mounted" | "status">): ImageRecord;
 /** Mutate a record in place (records are owned by the store) and notify. */
 export declare function updateRecord(id: number, patch: Partial<ImageRecord>): ImageRecord | undefined;
@@ -16,6 +16,20 @@ export declare function getRecord(id: number): ImageRecord | undefined;
 export declare function getSnapshot(): ImageRecord[];
 export declare function subscribe(listener: () => void): () => void;
 export declare function clearRecords(): void;
+/**
+ * Dashboards never instrument their own images — the store is purely a mirror
+ * of the synced device. Makes installImageCapture() a permanent no-op.
+ */
+export declare function disableImagesCapture(): void;
+/**
+ * Replace the whole store from a synced adapter snapshot (wire records are
+ * newest-first; the store keeps oldest-first and useImageRecords reverses).
+ * Also adopts the device's global modes / capture status and derives the
+ * DEVICE's PixelRatio so oversize math doesn't use the dashboard display's.
+ */
+export declare function replaceImagesFromSnapshot(payload: ImagesSnapshotPayload): void;
+/** Device PixelRatio on device; the SYNCED device's ratio on a mirror. */
+export declare function effectivePixelRatio(): number;
 /** Physical pixels actually needed to fill the laid-out view 1:1. */
 export declare function neededPixels(record: ImageRecord): {
     width: number;

package/lib/typescript/store/imageEventStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageEventStore.d.ts","sourceRoot":"","sources":["../../../src/store/imageEventStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAsBxD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC,GAClF,WAAW,CAkBb;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAC1B,WAAW,GAAG,SAAS,CAOzB;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE7D;AAED,wBAAgB,WAAW,IAAI,WAAW,EAAE,CAE3C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAI1D;AAED,wBAAgB,YAAY,IAAI,IAAI,CAQnC;AAMD,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO1F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAOjE;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAG3D;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAQ1D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,UAAU,CAuB5D"}
+{"version":3,"file":"imageEventStore.d.ts","sourceRoot":"","sources":["../../../src/store/imageEventStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAsB/E,wBAAgB,YAAY,CAC1B,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC,GAClF,WAAW,CAkBb;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAC1B,WAAW,GAAG,SAAS,CAOzB;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE7D;AAED,wBAAgB,WAAW,IAAI,WAAW,EAAE,CAE3C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAI1D;AAED,wBAAgB,YAAY,IAAI,IAAI,CAWnC;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CA6C9E;AAMD,0EAA0E;AAC1E,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO1F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAOjE;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAG3D;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAQ1D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,UAAU,CAuB5D"}

package/lib/typescript/sync/imagesSyncAdapter.d.ts

@@ -8,44 +8,11 @@
  * global modes, and cache clears.
  */
 import type { NetworkMode } from "../capture/overrides";
+import type { ImageRecordWire } from "../types";
 export declare const imagesSyncAdapter: {
     version: number;
     getSnapshot: () => {
-        records: {
-            id: number;
-            lib: import("..").ImageLib;
-            uri: string;
-            kind: import("..").SourceKind;
-            status: import("..").ImageStatus;
-            mounted: boolean;
-            cache: import("..").CacheVerdict | null;
-            cacheSource: "event" | "queryCache" | null;
-            ms: number | null;
-            intrinsic: {
-                width: number;
-                height: number;
-            } | null;
-            layout: {
-                width: number;
-                height: number;
-            } | null;
-            neededPx: {
-                width: number;
-                height: number;
-            } | null;
-            oversizeFactor: number | null;
-            decodedKB: number;
-            wastedKB: number;
-            progressSeen: boolean;
-            bytesTotal: number | null;
-            error: string | null;
-            errorCode: number | null;
-            loadCount: number;
-            overrideLabel: string | null;
-            hasAltText: boolean | null;
-            layoutShifts: number;
-            ageMs: number;
-        }[];
+        records: ImageRecordWire[];
         stats: import("..").ImageStats;
         captureStatus: import("..").CaptureStatus;
         globalModes: {
@@ -59,41 +26,7 @@ export declare const imagesSyncAdapter: {
         /** List records (newest first). Params: { limit?, status? }. */
         list: (params: unknown) => {
             total: number;
-            records: {
-                id: number;
-                lib: import("..").ImageLib;
-                uri: string;
-                kind: import("..").SourceKind;
-                status: import("..").ImageStatus;
-                mounted: boolean;
-                cache: import("..").CacheVerdict | null;
-                cacheSource: "event" | "queryCache" | null;
-                ms: number | null;
-                intrinsic: {
-                    width: number;
-                    height: number;
-                } | null;
-                layout: {
-                    width: number;
-                    height: number;
-                } | null;
-                neededPx: {
-                    width: number;
-                    height: number;
-                } | null;
-                oversizeFactor: number | null;
-                decodedKB: number;
-                wastedKB: number;
-                progressSeen: boolean;
-                bytesTotal: number | null;
-                error: string | null;
-                errorCode: number | null;
-                loadCount: number;
-                overrideLabel: string | null;
-                hasAltText: boolean | null;
-                layoutShifts: number;
-                ageMs: number;
-            }[];
+            records: ImageRecordWire[];
             stats: import("..").ImageStats;
             captureStatus: import("..").CaptureStatus;
             globalModes: {

package/lib/typescript/sync/imagesSyncAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imagesSyncAdapter.d.ts","sourceRoot":"","sources":["../../../src/sync/imagesSyncAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,sBAAsB,CAAC;AAyExE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAMN,MAAM,IAAI;;QAE9B,gEAAgE;uBACjD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAatB,kDAAkD;4BAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAI3B,2CAA2C;6BACtB,OAAO;QAC5B,qFAAqF;+BAC9D,OAAO;QAC9B,gDAAgD;wBAChC,OAAO;QACvB,uEAAuE;4BAC7C,OAAO;;;;QAUjC,iEAAiE;wBACjD,OAAO;;;;QAIvB;;;WAGG;8BACmB,OAAO;;;;QAwB7B,oDAAoD;gCAC5B,OAAO;;;;QAI/B;;;WAGG;6BACwB,OAAO;QA6BlC,8EAA8E;iCACrD,OAAO;;;;;;;QAQhC,iEAAiE;iCACxC,OAAO;;;;;;;QAIhC,2DAA2D;;;;;QAK3D,0EAA0E;kCAC1C,OAAO;;;;;;CAsB1C,CAAC"}
+{"version":3,"file":"imagesSyncAdapter.d.ts","sourceRoot":"","sources":["../../../src/sync/imagesSyncAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,sBAAsB,CAAC;AAYxE,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,UAAU,CAAC;AA6D7D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;0BAMN,MAAM,IAAI;;QAE9B,gEAAgE;uBACjD,OAAO;;;;;;;;;;;QAatB,kDAAkD;4BAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAI3B,2CAA2C;6BACtB,OAAO;QAC5B,qFAAqF;+BAC9D,OAAO;QAC9B,gDAAgD;wBAChC,OAAO;QACvB,uEAAuE;4BAC7C,OAAO;;;;QAUjC,iEAAiE;wBACjD,OAAO;;;;QAIvB;;;WAGG;8BACmB,OAAO;;;;QAwB7B,oDAAoD;gCAC5B,OAAO;;;;QAI/B;;;WAGG;6BACwB,OAAO;QA6BlC,8EAA8E;iCACrD,OAAO;;;;;;;QAQhC,iEAAiE;iCACxC,OAAO;;;;;;;QAIhC,2DAA2D;;;;;QAK3D,0EAA0E;kCAC1C,OAAO;;;;;;CAsB1C,CAAC"}

package/lib/typescript/types.d.ts

@@ -106,6 +106,59 @@ export interface ImageStats {
     /** Σ estimated wasted decoded bytes from oversized sources (mounted). */
     estWastedBytes: number;
 }
+/**
+ * Slim wire form of a record as pushed by the external-sync adapter (heavy
+ * derived math precomputed on device). This is what dashboards receive and
+ * what `replaceFromSnapshot` reconstructs ImageRecords from — keep it in
+ * lockstep with `toWire` in sync/imagesSyncAdapter.ts (and the Flutter port).
+ */
+export interface ImageRecordWire {
+    id: number;
+    lib: ImageLib;
+    uri: string;
+    kind: SourceKind;
+    status: ImageStatus;
+    mounted: boolean;
+    cache: CacheVerdict | null;
+    cacheSource: "event" | "queryCache" | null;
+    ms: number | null;
+    intrinsic: {
+        width: number;
+        height: number;
+    } | null;
+    layout: {
+        width: number;
+        height: number;
+    } | null;
+    neededPx: {
+        width: number;
+        height: number;
+    } | null;
+    oversizeFactor: number | null;
+    decodedKB: number;
+    wastedKB: number;
+    progressSeen: boolean;
+    bytesTotal: number | null;
+    error: string | null;
+    errorCode: number | null;
+    loadCount: number;
+    overrideLabel: string | null;
+    hasAltText: boolean | null;
+    layoutShifts: number;
+    ageMs: number;
+}
+/** Full snapshot payload the adapter pushes to watching dashboards. */
+export interface ImagesSnapshotPayload {
+    stats?: ImageStats;
+    captureStatus?: CaptureStatus;
+    globalModes?: {
+        network: "normal" | "offline" | "cold";
+        blank: boolean;
+    };
+    insights?: ImageInsights;
+    /** Newest first, capped at 100. */
+    records?: ImageRecordWire[];
+}
 /** Capture capability report — what the interceptors managed to hook. */
 export interface CaptureStatus {
     installed: boolean;

package/lib/typescript/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/images",
-  "version": "7.0.13",
+  "version": "7.0.15",
   "description": "Debug every image in your React Native app — live load registry, cache verdicts (memory/disk/network), timings, oversize + wasted-memory checks, and failure diagnosis for RN <Image> and expo-image. Part of Buoy devtools.",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -18,7 +18,7 @@
     "**/index.*"
   ],
   "dependencies": {
-    "@buoy-gg/shared-ui": "^7.0.13"
+    "@buoy-gg/shared-ui": "^7.0.15"
   },
   "peerDependencies": {
     "expo-image": "*",

package/src/capture/actions.ts

@@ -16,6 +16,7 @@
  * rewrites both cache tiers.
  */
 
+import { remoteActionResult, remoteImagesDispatch } from "../remote";
 import { imagesState } from "../state";
 import { touchRecord } from "./overrides";
 import type { ImageRecord } from "../types";
@@ -147,6 +148,8 @@ export type ActionResult = { ok: boolean; message: string };
 
 /** Fresh load attempt for a mounted image (no cache bypass). */
 export async function retryRecord(record: ImageRecord): Promise<ActionResult> {
+  const remote = remoteImagesDispatch();
+  if (remote) return remoteActionResult(remote("retry", { id: record.id }));
   if (!record.mounted) {
     return { ok: false, message: "Instance unmounted — cannot reload" };
   }
@@ -166,6 +169,10 @@ export async function retryRecord(record: ImageRecord): Promise<ActionResult> {
 
 /** Hard-reload every mounted image (mass cache-bust). Returns count started. */
 export async function hardReloadAllMounted(): Promise<ActionResult> {
+  const remote = remoteImagesDispatch();
+  if (remote) {
+    return remoteActionResult(remote("massAction", { kind: "reload" }));
+  }
   const { getSnapshot } = require("../store/imageEventStore") as {
     getSnapshot: () => ImageRecord[];
   };
@@ -180,6 +187,8 @@ export async function hardReloadAllMounted(): Promise<ActionResult> {
 
 /** Bypass-cache reload: refetches from network and rewrites the caches. */
 export async function hardReloadRecord(record: ImageRecord): Promise<ActionResult> {
+  const remote = remoteImagesDispatch();
+  if (remote) return remoteActionResult(remote("hardReload", { id: record.id }));
   if (!record.mounted) {
     return { ok: false, message: "Instance unmounted — cannot reload" };
   }

package/src/capture/install.ts

@@ -17,13 +17,17 @@ import type { CaptureStatus } from "../types";
 
 export function installImageCapture(): void {
   const s = imagesState();
-  if (s.captureInstalled) return;
+  // Mirror mode (desktop dashboard): never instrument the dashboard's own UI.
+  if (s.captureDisabled || s.captureInstalled) return;
   s.captureInstalled = true;
   installRnImageInterceptor();
   installExpoImageInterceptor();
 }
 
 export function getCaptureStatus(): CaptureStatus {
+  // Mirror mode: report the synced DEVICE's capture status, not the local probe.
+  const mirrored = imagesState().mirrorCaptureStatus;
+  if (mirrored) return mirrored;
   const rn = rnCaptureStatus();
   const expo = expoCaptureStatus();
   return {

package/src/capture/overrides.ts

@@ -14,6 +14,7 @@
  * directly via forceUpdate() from the per-record instance registry.
  */
 
+import { remoteImagesDispatch } from "../remote";
 import { imagesState } from "../state";
 import { getRecord, getSnapshot, updateRecord } from "../store/imageEventStore";
 import type { ImageLib } from "../types";
@@ -106,18 +107,47 @@ export function getRenderVersion(recordId: number | null): number {
 // Per-record overrides
 // ---------------------------------------------------------------------------
 
-export function setOverride(recordId: number, override: ImageOverride): void {
+/** Remote param shape for the adapter's `setOverride` action. */
+function overrideParams(
+  recordId: number,
+  source: OverrideSource
+): Record<string, unknown> {
+  return source.type === "url"
+    ? { id: recordId, kind: "url", uri: source.uri }
+    : { id: recordId, kind: source.type };
+}
+
+/**
+ * Local bookkeeping only (no remote forward) — mirrors keep this as an
+ * optimistic UI update; the next device snapshot is the source of truth.
+ */
+function setOverrideLocal(recordId: number, override: ImageOverride): void {
   imagesState().overrides.set(recordId, override);
   updateRecord(recordId, { overrideLabel: override.label });
   touchRecord(recordId);
 }
 
-export function clearOverride(recordId: number): void {
+export function setOverride(recordId: number, override: ImageOverride): void {
+  if (override.source) {
+    void remoteImagesDispatch()?.(
+      "setOverride",
+      overrideParams(recordId, override.source)
+    );
+  }
+  setOverrideLocal(recordId, override);
+}
+
+function clearOverrideLocal(recordId: number): void {
   imagesState().overrides.delete(recordId);
   updateRecord(recordId, { overrideLabel: undefined });
   touchRecord(recordId);
 }
 
+export function clearOverride(recordId: number): void {
+  void remoteImagesDispatch()?.("clearOverride", { id: recordId });
+  clearOverrideLocal(recordId);
+}
+
 export function getOverride(recordId: number | null): ImageOverride | undefined {
   if (recordId == null) return undefined;
   return imagesState().overrides.get(recordId) as ImageOverride | undefined;
@@ -127,12 +157,19 @@ export function getOverride(recordId: number | null): ImageOverride | undefined
 // Mass actions (every mounted image at once)
 // ---------------------------------------------------------------------------
 
+/** Adapter `massAction` kind for a mass override (per-record 'hang' is mass 'loading'). */
+function massKind(source: OverrideSource): string {
+  return source.type === "hang" ? "loading" : source.type;
+}
+
 /** Apply one override to every mounted record. Returns how many were hit. */
 export function setOverrideForAllMounted(source: OverrideSource, label: string): number {
+  // One mass action on the device, not N per-record forwards.
+  void remoteImagesDispatch()?.("massAction", { kind: massKind(source) });
   let count = 0;
   for (const record of getSnapshot()) {
     if (!record.mounted) continue;
-    setOverride(record.id, { source, label });
+    setOverrideLocal(record.id, { source, label });
     count++;
   }
   return count;
@@ -140,24 +177,29 @@ export function setOverrideForAllMounted(source: OverrideSource, label: string):
 
 /** Remove every active override. Returns how many were cleared. */
 export function clearAllOverrides(): number {
-  const ids = [...imagesState().overrides.keys()];
-  for (const id of ids) clearOverride(id);
-  return ids.length;
+  void remoteImagesDispatch()?.("massAction", { kind: "restore" });
+  // Mirrors track labels on records, not the overrides map — clear both.
+  const ids = new Set<number>(imagesState().overrides.keys());
+  for (const record of getSnapshot()) {
+    if (record.overrideLabel != null) ids.add(record.id);
+  }
+  for (const id of ids) clearOverrideLocal(id);
+  return ids.size;
 }
 
 /** Flash every mounted image (locate everything the tool tracks). */
 export function flashAllMounted(durationMs = 2500): number {
+  void remoteImagesDispatch()?.("massAction", { kind: "flash" });
   let count = 0;
   for (const record of getSnapshot()) {
     if (!record.mounted) continue;
-    flashRecord(record.id, durationMs);
+    flashRecordLocal(record.id, durationMs);
     count++;
   }
   return count;
 }
 
-/** Flash a border on the on-screen image so it can be located visually. */
-export function flashRecord(recordId: number, durationMs = 2500): void {
+function flashRecordLocal(recordId: number, durationMs = 2500): void {
   const s = imagesState();
   s.flashUntil.set(recordId, Date.now() + durationMs);
   touchRecord(recordId);
@@ -167,6 +209,12 @@ export function flashRecord(recordId: number, durationMs = 2500): void {
   }, durationMs + 50);
 }
 
+/** Flash a border on the on-screen image so it can be located visually. */
+export function flashRecord(recordId: number, durationMs = 2500): void {
+  void remoteImagesDispatch()?.("flash", { id: recordId });
+  flashRecordLocal(recordId, durationMs);
+}
+
 // ---------------------------------------------------------------------------
 // Global simulation modes
 // ---------------------------------------------------------------------------
@@ -181,12 +229,14 @@ export function flashRecord(recordId: number, durationMs = 2500): void {
  *   `cachePolicy:'none'`): first-launch behavior without clearing anything.
  */
 export function setNetworkMode(mode: NetworkMode): void {
+  void remoteImagesDispatch()?.("setNetworkMode", { mode });
   imagesState().globalModes.network = mode;
   touchGlobal();
 }
 
 /** Chrome-style "disable images": render every image without a source. */
 export function setBlankImages(enabled: boolean): void {
+  void remoteImagesDispatch()?.("setBlankImages", { enabled });
   imagesState().globalModes.blank = enabled;
   touchGlobal();
 }

package/src/capture/savings.ts

@@ -12,6 +12,7 @@
  * total) → expo disk-cache file size → HEAD Content-Length.
  */
 
+import { remoteImagesDispatch } from "../remote";
 import { neededPixels } from "../store/imageEventStore";
 import type { ImageRecord } from "../types";
 
@@ -104,6 +105,16 @@ async function resolveOriginalBytes(
  * Requires expo-image-manipulator (graceful message when absent).
  */
 export async function proveSavings(record: ImageRecord): Promise<SavingsResult> {
+  // Mirror mode: the re-encode must happen ON DEVICE (that's the whole point —
+  // real bytes from the real encoder); forward and relay the result.
+  const remote = remoteImagesDispatch();
+  if (remote) {
+    try {
+      return (await remote("proveSavings", { id: record.id })) as SavingsResult;
+    } catch (error) {
+      return { ok: false, message: String((error as Error)?.message ?? error) };
+    }
+  }
   if (!record.uri || (record.sourceKind !== "network" && record.sourceKind !== "asset" && record.sourceKind !== "file")) {
     return { ok: false, message: "No loadable source URI on this record" };
   }

package/src/components/ImageDetail.tsx

@@ -8,7 +8,6 @@
 import { useState, type ReactNode } from "react";
 import {
   Image,
-  PixelRatio,
   ScrollView,
   StyleSheet,
   Text,
@@ -20,7 +19,9 @@ import { macOSColors } from "@buoy-gg/shared-ui";
 import { clearOverride, setOverride } from "../capture/overrides";
 import { proveSavings } from "../capture/savings";
 import type { SavingsResult } from "../capture/savings";
+import { remoteImagesDispatch } from "../remote";
 import {
+  effectivePixelRatio,
   estDecodedBytes,
   estWastedBytes,
   neededPixels,
@@ -54,6 +55,15 @@ function Row({ label, value, color }: { label: string; value: string; color?: st
 
 /** expo-image global cache clears (no-ops if expo-image is absent). */
 function clearExpoCache(kind: "memory" | "disk"): void {
+  // Mirror mode: the caches live on the synced device.
+  const remote = remoteImagesDispatch();
+  if (remote) {
+    void remote("clearExpoCaches", {
+      memory: kind === "memory",
+      disk: kind === "disk",
+    });
+    return;
+  }
   try {
     const expo = require("expo-image");
     if (kind === "memory") void expo.Image.clearMemoryCache();
@@ -289,7 +299,7 @@ export function ImageDetail({ record }: ImageDetailProps) {
             label="Displayed"
             value={`${Math.round(record.layout.width)}×${Math.round(record.layout.height)} dp (needs ${
               needed ? `${needed.width}×${needed.height}` : "?"
-            } px @${PixelRatio.get()}x)`}
+            } px @${Math.round(effectivePixelRatio() * 100) / 100}x)`}
           />
         ) : (
           <Row label="Displayed" value="no layout yet" />