@buoy-gg/images 7.0.3

package/lib/module/sync/imagesSyncAdapter.js

@@ -0,0 +1,311 @@
+"use strict";
+
+/**
+ * Sync adapter for the Images tool, consumed by @buoy-gg/external-sync's
+ * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
+ * this package doesn't need a dependency on it — same pattern as js-top's
+ * adapter). Exposes the live image registry to the desktop dashboard and the
+ * MCP server, plus every action the on-device UI has: reload/retry,
+ * simulation overrides (force error/loading/blank/URL swap), locate-flash,
+ * global modes, and cache clears.
+ */
+
+import { evictExpoDiskEntry, hardReloadAllMounted, hardReloadRecord, retryRecord } from "../capture/actions";
+import { getCaptureStatus } from "../capture/install";
+import { clearAllOverrides, clearOverride, flashAllMounted, flashRecord, getGlobalModes, setBlankImages, setNetworkMode, setOverride, setOverrideForAllMounted } from "../capture/overrides";
+import { proveSavings } from "../capture/savings";
+import { computeInsights } from "../store/insights";
+import { clearRecords, computeStats, estDecodedBytes, estWastedBytes, getRecord, getSnapshot, neededPixels, oversizeFactor, subscribe } from "../store/imageEventStore";
+/** Slim wire form of a record (heavy/derived fields precomputed + rounded). */
+function toWire(record) {
+  const factor = oversizeFactor(record);
+  return {
+    id: record.id,
+    lib: record.lib,
+    uri: record.uri,
+    kind: record.sourceKind,
+    status: record.status,
+    mounted: record.mounted,
+    cache: record.cacheVerdict ?? null,
+    cacheSource: record.cacheVerdictSource ?? null,
+    ms: record.durationMs != null ? Math.round(record.durationMs) : null,
+    intrinsic: record.intrinsic ?? null,
+    layout: record.layout ? {
+      width: Math.round(record.layout.width),
+      height: Math.round(record.layout.height)
+    } : null,
+    neededPx: neededPixels(record),
+    oversizeFactor: factor != null ? Math.round(factor * 100) / 100 : null,
+    decodedKB: Math.round(estDecodedBytes(record) / 1024),
+    wastedKB: Math.round(estWastedBytes(record) / 1024),
+    progressSeen: record.progressSeen === true,
+    bytesTotal: record.bytesTotal ?? null,
+    error: record.error ?? null,
+    errorCode: record.errorCode ?? null,
+    loadCount: record.loadCount,
+    overrideLabel: record.overrideLabel ?? null,
+    hasAltText: record.hasAltText ?? null,
+    layoutShifts: record.layoutShifts ?? 0,
+    ageMs: Date.now() - record.createdAt
+  };
+}
+function requireRecord(params) {
+  const id = params?.id;
+  if (typeof id !== "number") throw new Error("Missing numeric `id` param");
+  const record = getRecord(id);
+  if (!record) {
+    throw new Error(`Image record ${id} not found (cleared or evicted) — re-run the list action for current ids.`);
+  }
+  return record;
+}
+function overview() {
+  const snapshot = getSnapshot();
+  return {
+    stats: computeStats(snapshot),
+    captureStatus: getCaptureStatus(),
+    globalModes: getGlobalModes(),
+    insights: computeInsights(snapshot),
+    records: [...snapshot].reverse() // newest first
+  };
+}
+export const imagesSyncAdapter = {
+  version: 1,
+  getSnapshot: () => {
+    const {
+      records,
+      ...rest
+    } = overview();
+    return {
+      ...rest,
+      records: records.slice(0, 100).map(toWire)
+    };
+  },
+  subscribe: onChange => subscribe(onChange),
+  actions: {
+    /** List records (newest first). Params: { limit?, status? }. */
+    list: params => {
+      const p = params ?? {};
+      const limit = Math.min(Math.max(p.limit ?? 50, 1), 200);
+      const {
+        records,
+        ...rest
+      } = overview();
+      const filtered = p.status ? records.filter(r => r.status === p.status) : records;
+      return {
+        ...rest,
+        total: filtered.length,
+        records: filtered.slice(0, limit).map(toWire)
+      };
+    },
+    /** Full detail for one record. Params: { id }. */
+    getDetail: params => {
+      const record = requireRecord(params);
+      return {
+        ...toWire(record),
+        errorHeaders: record.errorHeaders ?? null
+      };
+    },
+    /** Bypass-cache reload. Params: { id }. */
+    hardReload: params => hardReloadRecord(requireRecord(params)),
+    /** Re-encode at displayed size as WebP, return real byte savings. Params: { id }. */
+    proveSavings: params => proveSavings(requireRecord(params)),
+    /** Plain fresh load attempt. Params: { id }. */
+    retry: params => retryRecord(requireRecord(params)),
+    /** Evict the expo-image disk entry for this record. Params: { id }. */
+    evictDisk: async params => {
+      const record = requireRecord(params);
+      const evicted = await evictExpoDiskEntry(record);
+      return {
+        ok: evicted,
+        message: evicted ? "Disk cache entry deleted" : "No disk entry found (expo-image + expo-file-system required)"
+      };
+    },
+    /** Flash a red border on the on-screen image. Params: { id }. */
+    flash: params => {
+      flashRecord(requireRecord(params).id);
+      return {
+        ok: true,
+        message: "Flashing for 2.5s"
+      };
+    },
+    /**
+     * Apply a simulation override. Params: { id, kind, uri? } where kind is
+     * 'error' | 'hang' | 'blank' | 'url' ('url' requires uri).
+     */
+    setOverride: params => {
+      const record = requireRecord(params);
+      const p = params;
+      const kinds = {
+        error: {
+          source: {
+            type: "error"
+          },
+          label: "Forced error"
+        },
+        hang: {
+          source: {
+            type: "hang"
+          },
+          label: "Forced loading"
+        },
+        blank: {
+          source: {
+            type: "blank"
+          },
+          label: "Blanked"
+        }
+      };
+      if (p.kind === "url") {
+        if (!p.uri) throw new Error("kind 'url' requires a `uri` param");
+        setOverride(record.id, {
+          source: {
+            type: "url",
+            uri: p.uri
+          },
+          label: "URL swapped"
+        });
+        return {
+          ok: true,
+          message: `Source overridden to ${p.uri}`
+        };
+      }
+      const entry = p.kind ? kinds[p.kind] : undefined;
+      if (!entry) throw new Error(`Unknown override kind: ${String(p.kind)}`);
+      if (!record.mounted) {
+        return {
+          ok: false,
+          message: "Instance unmounted — overrides need the image on screen"
+        };
+      }
+      setOverride(record.id, entry);
+      return {
+        ok: true,
+        message: `${entry.label} applied`
+      };
+    },
+    /** Remove a simulation override. Params: { id }. */
+    clearOverride: params => {
+      clearOverride(requireRecord(params).id);
+      return {
+        ok: true,
+        message: "Override removed — original source restored"
+      };
+    },
+    /**
+     * Mass action on every mounted image. Params: { kind } where kind is
+     * 'error' | 'loading' | 'blank' | 'reload' | 'flash' | 'restore'.
+     */
+    massAction: async params => {
+      const kind = params?.kind;
+      switch (kind) {
+        case "error":
+          {
+            const n = setOverrideForAllMounted({
+              type: "error"
+            }, "Forced error");
+            return {
+              ok: n > 0,
+              message: `Forced error on ${n} images`
+            };
+          }
+        case "loading":
+          {
+            const n = setOverrideForAllMounted({
+              type: "hang"
+            }, "Forced loading");
+            return {
+              ok: n > 0,
+              message: `Forced loading on ${n} images`
+            };
+          }
+        case "blank":
+          {
+            const n = setOverrideForAllMounted({
+              type: "blank"
+            }, "Blanked");
+            return {
+              ok: n > 0,
+              message: `Blanked ${n} images`
+            };
+          }
+        case "reload":
+          return hardReloadAllMounted();
+        case "flash":
+          {
+            const n = flashAllMounted();
+            return {
+              ok: n > 0,
+              message: `Flashing ${n} images`
+            };
+          }
+        case "restore":
+          {
+            const n = clearAllOverrides();
+            return {
+              ok: true,
+              message: `Restored ${n} images`
+            };
+          }
+        default:
+          throw new Error(`Unknown mass kind: ${String(kind)}`);
+      }
+    },
+    /** Global network simulation. Params: { mode: 'normal'|'offline'|'cold' }. */
+    setNetworkMode: params => {
+      const mode = params?.mode;
+      if (mode !== "normal" && mode !== "offline" && mode !== "cold") {
+        throw new Error("mode must be 'normal' | 'offline' | 'cold'");
+      }
+      setNetworkMode(mode);
+      return {
+        ok: true,
+        modes: getGlobalModes()
+      };
+    },
+    /** Chrome-style disable-images. Params: { enabled: boolean }. */
+    setBlankImages: params => {
+      setBlankImages(params?.enabled === true);
+      return {
+        ok: true,
+        modes: getGlobalModes()
+      };
+    },
+    /** Clear the captured registry (keeps in-flight loads). */
+    clearRecords: () => {
+      clearRecords();
+      return {
+        ok: true,
+        message: "Registry cleared"
+      };
+    },
+    /** Clear expo-image caches. Params: { memory?, disk? } (default both). */
+    clearExpoCaches: async params => {
+      const p = params ?? {};
+      const doMemory = p.memory !== false;
+      const doDisk = p.disk !== false;
+      try {
+        const expo = require("expo-image");
+        const results = [];
+        if (doMemory) {
+          await expo.Image.clearMemoryCache();
+          results.push("memory");
+        }
+        if (doDisk) {
+          await expo.Image.clearDiskCache();
+          results.push("disk");
+        }
+        return {
+          ok: true,
+          message: `Cleared expo-image ${results.join(" + ")} cache`
+        };
+      } catch {
+        return {
+          ok: false,
+          message: "expo-image not installed"
+        };
+      }
+    },
+    getCaptureStatus: () => getCaptureStatus()
+  }
+};
+//# sourceMappingURL=imagesSyncAdapter.js.map

package/lib/module/sync/imagesSyncAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["evictExpoDiskEntry","hardReloadAllMounted","hardReloadRecord","retryRecord","getCaptureStatus","clearAllOverrides","clearOverride","flashAllMounted","flashRecord","getGlobalModes","setBlankImages","setNetworkMode","setOverride","setOverrideForAllMounted","proveSavings","computeInsights","clearRecords","computeStats","estDecodedBytes","estWastedBytes","getRecord","getSnapshot","neededPixels","oversizeFactor","subscribe","toWire","record","factor","id","lib","uri","kind","sourceKind","status","mounted","cache","cacheVerdict","cacheSource","cacheVerdictSource","ms","durationMs","Math","round","intrinsic","layout","width","height","neededPx","decodedKB","wastedKB","progressSeen","bytesTotal","error","errorCode","loadCount","overrideLabel","hasAltText","layoutShifts","ageMs","Date","now","createdAt","requireRecord","params","Error","overview","snapshot","stats","captureStatus","globalModes","insights","records","reverse","imagesSyncAdapter","version","rest","slice","map","onChange","actions","list","p","limit","min","max","filtered","filter","r","total","length","getDetail","errorHeaders","hardReload","retry","evictDisk","evicted","ok","message","flash","kinds","source","type","label","hang","blank","entry","undefined","String","massAction","n","mode","modes","enabled","clearExpoCaches","doMemory","memory","doDisk","disk","expo","require","results","Image","clearMemoryCache","push","clearDiskCache","join"],"sourceRoot":"../../../src","sources":["sync/imagesSyncAdapter.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"","ignoreList":[]}

package/lib/typescript/capture/actions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Per-image actions: hard reload (bypass cache) and retry.
+ *
+ * RN core path: the decorator wrapper owns every mounted <Image>'s props, so a
+ * reload request re-renders the wrapper with a bumped `key` (native remount →
+ * fresh load cycle) and, for cache-busting, `source.cache: 'reload'` injected
+ * — VERIFIED supported on BOTH platforms (iOS NSURLRequest policy;
+ * Android ReactImageView.kt reads source."cache" → Fresco full-fetch). The
+ * override stays applied until the load settles, then reverts lazily on the
+ * app's next natural re-render (avoids an extra cache round-trip).
+ *
+ * expo-image path: the patched class instance exposes the public
+ * `reloadAsync()`. Cache-busting first evicts the disk entry (cache path +
+ * expo-file-system delete) and clears expo's memory cache (global — no
+ * per-entry memory eviction exists), so the reload is a true refetch that
+ * rewrites both cache tiers.
+ */
+import type { ImageRecord } from "../types";
+export declare function subscribeActions(listener: () => void): () => void;
+export declare function getReloadRequest(recordId: number | null): {
+    nonce: number;
+    bust: boolean;
+} | undefined;
+/** Reload nonce for a record (0 = never requested). Snapshot for the wrapper. */
+export declare function getReloadNonce(recordId: number | null): number;
+/**
+ * Mark a request consumed once its load settles (called from the tracker on
+ * load/error). Silent — the wrapper reverts the prop override on the app's
+ * next natural re-render instead of forcing an immediate one.
+ */
+export declare function settleReloadRequest(recordId: number): void;
+export declare function dropActionState(recordId: number): void;
+export declare function registerExpoInstance(recordId: number | null, instance: unknown): void;
+/**
+ * Delete an expo-image disk-cache entry (JS-only: cache path + file delete).
+ * Returns true if an entry existed and was deleted.
+ */
+export declare function evictExpoDiskEntry(record: ImageRecord): Promise<boolean>;
+export type ActionResult = {
+    ok: boolean;
+    message: string;
+};
+/** Fresh load attempt for a mounted image (no cache bypass). */
+export declare function retryRecord(record: ImageRecord): Promise<ActionResult>;
+/** Hard-reload every mounted image (mass cache-bust). Returns count started. */
+export declare function hardReloadAllMounted(): Promise<ActionResult>;
+/** Bypass-cache reload: refetches from network and rewrites the caches. */
+export declare function hardReloadRecord(record: ImageRecord): Promise<ActionResult>;
+//# sourceMappingURL=actions.d.ts.map

package/lib/typescript/capture/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/capture/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAM5C,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAIjE;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAG9C;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE9D;AAUD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAM1D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOtD;AAMD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAGrF;AAyCD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAa9E;AAMD,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,gEAAgE;AAChE,wBAAsB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAgB5E;AAED,gFAAgF;AAChF,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,YAAY,CAAC,CAWlE;AAED,2EAA2E;AAC3E,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAwBjF"}

package/lib/typescript/capture/install.d.ts

@@ -0,0 +1,15 @@
+/**
+ * installImageCapture — idempotent entry point for the capture layer.
+ *
+ * IMPORTANT (timing): the RN-core decorator only takes effect if this runs
+ * before anything evaluates the `Image` module from 'react-native'. The
+ * recommended integration is `import "@buoy-gg/images/register"` as the FIRST
+ * import of the app entry file. The expo-image patch has no such constraint.
+ *
+ * Idempotency is keyed on the globalThis singleton, so even if this package
+ * gets evaluated as two module instances, capture installs exactly once.
+ */
+import type { CaptureStatus } from "../types";
+export declare function installImageCapture(): void;
+export declare function getCaptureStatus(): CaptureStatus;
+//# sourceMappingURL=install.d.ts.map

package/lib/typescript/capture/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/capture/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAUhD"}

package/lib/typescript/capture/installExpoImage.d.ts

@@ -0,0 +1,23 @@
+/**
+ * expo-image interception via class-prototype patch.
+ *
+ * expo-image's <Image> is a class component (React.PureComponent) whose
+ * render() reads `this.props`, so wrapping the prototype's render and swapping
+ * `this.props` for an instrumented copy for the duration of the original
+ * render is timing-immune (prototype methods are looked up dynamically — no
+ * import-order race like the RN core decorator). Props are restored in
+ * `finally`, so PureComponent's shouldComponentUpdate still compares the
+ * app's real props.
+ *
+ * Double-patch safety: install flags live on the globalThis singleton AND a
+ * marker is stamped on the prototype itself, so even two module instances of
+ * this package can't wrap render() twice.
+ *
+ * expo-image is an optional peer: if it isn't installed, this is a no-op.
+ */
+export declare function installExpoImageInterceptor(): void;
+export declare function expoCaptureStatus(): {
+    available: boolean;
+    patched: boolean;
+};
+//# sourceMappingURL=installExpoImage.d.ts.map

package/lib/typescript/capture/installExpoImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installExpoImage.d.ts","sourceRoot":"","sources":["../../../src/capture/installExpoImage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAyBH,wBAAgB,2BAA2B,IAAI,IAAI,CAoElD;AAED,wBAAgB,iBAAiB,IAAI;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAG5E"}

package/lib/typescript/capture/installRnImage.d.ts

@@ -0,0 +1,24 @@
+/**
+ * RN core <Image> interception via the official injection hook.
+ *
+ * `unstable_setImageComponentDecorator` wraps EVERY RN <Image> app-wide — but
+ * the decorator is latched ONCE, at Image module evaluation
+ * (`Image.ios.js` / `Image.android.js` read it at module scope). So install
+ * order matters: this must run before anything touches `Image` from
+ * 'react-native' — hence the `@buoy-gg/images/register` first-import.
+ *
+ * Detection strategy: the decorator sets `decoratorInvoked` when RN's Image
+ * module applies it. `unstable_registerImageAttachedCallback` is a live Set
+ * (never latched), so image mounts are always visible — if mounts happen but
+ * the decorator never ran, we were too late and CaptureStatus reports it.
+ *
+ * All flags live on the globalThis singleton (../state.ts) so a second module
+ * instance of this package neither re-installs nor reports a stale status.
+ */
+export declare function installRnImageInterceptor(): void;
+export declare function rnCaptureStatus(): {
+    decoratorRegistered: boolean;
+    decoratorActive: boolean;
+    tooLate: boolean;
+};
+//# sourceMappingURL=installRnImage.d.ts.map

package/lib/typescript/capture/installRnImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installRnImage.d.ts","sourceRoot":"","sources":["../../../src/capture/installRnImage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA6DH,wBAAgB,yBAAyB,IAAI,IAAI,CAyChD;AAED,wBAAgB,eAAe,IAAI;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB,CAQA"}

package/lib/typescript/capture/overrides.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Simulation overrides — the "we own the props" tier of actions.
+ *
+ * Because the RN decorator and the expo-image render patch control every
+ * mounted image's props, anything the component accepts is a simulation:
+ * forced errors (instant, offline-safe file:// source), forced loading
+ * (blackhole-IP source that never resolves), URL swaps, blanking, style
+ * merges (locate-flash border), and app-wide modes (offline images /
+ * cold-start / blank images).
+ *
+ * Re-render plumbing: every mutation bumps a per-record or global version.
+ * RN wrappers subscribe via useSyncExternalStore with a per-record snapshot
+ * (only the touched image re-renders); expo class instances are re-rendered
+ * directly via forceUpdate() from the per-record instance registry.
+ */
+import type { ImageLib } from "../types";
+export type OverrideSource = {
+    type: "url";
+    uri: string;
+}
+/** Nonexistent file:// — native fires onError immediately, no network needed. */
+ | {
+    type: "error";
+}
+/** Blackhole IP — the request hangs, onLoad never fires (loading forever). */
+ | {
+    type: "hang";
+}
+/** No source at all (expo keeps showing its placeholder). */
+ | {
+    type: "blank";
+};
+export interface ImageOverride {
+    source?: OverrideSource;
+    /** Merged over the app's style (size experiments etc.). */
+    style?: Record<string, unknown>;
+    /** Extra props merged last (expo contentFit, priority, cachePolicy…). */
+    extraProps?: Record<string, unknown>;
+    /** Shown as the record's override badge, e.g. "Forced error". */
+    label: string;
+}
+export type NetworkMode = "normal" | "offline" | "cold";
+/** Bump one record's render version (re-renders just that image). */
+export declare function touchRecord(recordId: number): void;
+/** Bump the global render version (re-renders every wrapped image). */
+export declare function touchGlobal(): void;
+/** Snapshot for the RN wrapper's useSyncExternalStore. */
+export declare function getRenderVersion(recordId: number | null): number;
+export declare function setOverride(recordId: number, override: ImageOverride): void;
+export declare function clearOverride(recordId: number): void;
+export declare function getOverride(recordId: number | null): ImageOverride | undefined;
+/** Apply one override to every mounted record. Returns how many were hit. */
+export declare function setOverrideForAllMounted(source: OverrideSource, label: string): number;
+/** Remove every active override. Returns how many were cleared. */
+export declare function clearAllOverrides(): number;
+/** Flash every mounted image (locate everything the tool tracks). */
+export declare function flashAllMounted(durationMs?: number): number;
+/** Flash a border on the on-screen image so it can be located visually. */
+export declare function flashRecord(recordId: number, durationMs?: number): void;
+/**
+ * offline — every NETWORK image load fails immediately (both libs, cache or
+ *   not); bundled/local assets still load, like a real offline device showing
+ *   shipped images. Blunt on purpose: toggle + reload = images visibly gone.
+ *   (The subtler `only-if-cached` variant was correct-but-confusing, and its
+ *   uncached requests HANG on iOS instead of erroring — bad for QA.)
+ * cold — every image bypasses caches (RN `cache:'reload'`, expo
+ *   `cachePolicy:'none'`): first-launch behavior without clearing anything.
+ */
+export declare function setNetworkMode(mode: NetworkMode): void;
+/** Chrome-style "disable images": render every image without a source. */
+export declare function setBlankImages(enabled: boolean): void;
+export declare function getGlobalModes(): {
+    network: NetworkMode;
+    blank: boolean;
+};
+/** Inject a `cache` policy into an RN source (object or array shape). */
+export declare function patchSourceCache(source: unknown, cache: string): unknown;
+/**
+ * Merge global modes + per-record override + locate-flash into an
+ * already-copied props object. Mutates and returns `out`.
+ */
+export declare function applyOverrides(out: Record<string, unknown>, recordId: number | null, lib: ImageLib): Record<string, unknown>;
+//# sourceMappingURL=overrides.d.ts.map

package/lib/typescript/capture/overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../../src/capture/overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAMzC,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AAC9B,iFAAiF;GAC/E;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE;AACnB,8EAA8E;GAC5E;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;AAClB,6DAA6D;GAC3D;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;CACf;AAgBD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAwBxD,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKlD;AAED,uEAAuE;AACvE,wBAAgB,WAAW,IAAI,IAAI,CAKlC;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIhE;AAMD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAI3E;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIpD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,GAAG,SAAS,CAG9E;AAMD,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQtF;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,UAAU,SAAO,GAAG,MAAM,CAQzD;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,SAAO,GAAG,IAAI,CAQrE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAGtD;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGrD;AAED,wBAAgB,cAAc,IAAI;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAEzE;AAMD,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAYxE;AAgBD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,GAAG,EAAE,QAAQ,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2CzB"}

package/lib/typescript/capture/savings.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Savings prover — Squoosh-style, on device.
+ *
+ * Instead of estimating what an oversized source wastes, PROVE it: re-encode
+ * the image at the displayed size (× pixel ratio) as WebP via
+ * expo-image-manipulator (verified: chainable resize → saveAsync WebP on BOTH
+ * platforms, available in Expo Go), stat the output file, and report real
+ * bytes vs the original. The optimized file:// URI can then be A/B'd in place
+ * through the existing swap-url override.
+ *
+ * Original size is resolved in tiers: observed download bytes (onProgress
+ * total) → expo disk-cache file size → HEAD Content-Length.
+ */
+import type { ImageRecord } from "../types";
+export interface SavingsResult {
+    ok: boolean;
+    message: string;
+    /** Real encoded bytes of the original (when determinable). */
+    originalBytes?: number;
+    originalBytesSource?: "download" | "cacheFile" | "head";
+    /** Real encoded bytes of the optimized WebP on disk. */
+    optimizedBytes?: number;
+    /** file:// URI of the optimized image (feed to swap-url to preview). */
+    optimizedUri?: string;
+    optimizedDims?: {
+        width: number;
+        height: number;
+    };
+    savedBytes?: number;
+    savedPct?: number;
+}
+/**
+ * Re-encode `record`'s source at its displayed size as WebP and measure it.
+ * Requires expo-image-manipulator (graceful message when absent).
+ */
+export declare function proveSavings(record: ImageRecord): Promise<SavingsResult>;
+//# sourceMappingURL=savings.d.ts.map

package/lib/typescript/capture/savings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"savings.d.ts","sourceRoot":"","sources":["../../../src/capture/savings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;IACxD,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAuED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAuF9E"}