@buoy-gg/images 7.0.41 → 7.0.43

package/lib/module/store/imageEventStore.js

@@ -1,221 +1 @@
-"use strict";
-
-/**
- * imageEventStore
- *
- * Bounded buffer of ImageRecords fed by the capture layer (installRnImage /
- * installExpoImage). Follows the console tool's store shape — Set of
- * listeners, frame-coalesced emit so bursty image grids don't turn every
- * event into its own React commit — but ALL mutable state lives on the
- * globalThis singleton (see ../state.ts) so a dual module instance of this
- * package still reads/writes one shared store.
- */
-
-import { PixelRatio } from "react-native";
-import { remoteImagesDispatch } from "../remote";
-import { imagesState } from "../state";
-/** Max records retained before the oldest are dropped. */
-const MAX_RECORDS = 500;
-function emit() {
-  const s = imagesState();
-  if (s.emitScheduled) return;
-  s.emitScheduled = true;
-  requestAnimationFrame(() => {
-    s.emitScheduled = false;
-    for (const listener of s.listeners) listener();
-  });
-}
-
-/** Snapshot identity only changes on emit, so useSyncExternalStore stays cheap. */
-function invalidate() {
-  const s = imagesState();
-  s.snapshot = [...s.records];
-  emit();
-}
-export function createRecord(partial) {
-  const s = imagesState();
-  const record = {
-    ...partial,
-    id: s.nextId++,
-    createdAt: Date.now(),
-    status: "pending",
-    mounted: true,
-    loadCount: 0
-  };
-  s.records.push(record);
-  s.byId.set(record.id, record);
-  if (s.records.length > MAX_RECORDS) {
-    const dropped = s.records.splice(0, s.records.length - MAX_RECORDS);
-    for (const d of dropped) s.byId.delete(d.id);
-  }
-  invalidate();
-  return record;
-}
-
-/** Mutate a record in place (records are owned by the store) and notify. */
-export function updateRecord(id, patch) {
-  const s = imagesState();
-  const record = s.byId.get(id);
-  if (!record) return undefined;
-  Object.assign(record, patch);
-  invalidate();
-  return record;
-}
-export function getRecord(id) {
-  return imagesState().byId.get(id);
-}
-export function getSnapshot() {
-  return imagesState().snapshot;
-}
-export function subscribe(listener) {
-  const s = imagesState();
-  s.listeners.add(listener);
-  return () => imagesState().listeners.delete(listener);
-}
-export function clearRecords() {
-  // Mirror mode: clear the device's registry too, or the next snapshot would
-  // refill this store straight away.
-  void remoteImagesDispatch()?.("clearRecords");
-  const s = imagesState();
-  // Keep records still actively loading so in-flight events don't orphan.
-  s.records = s.records.filter(r => r.mounted && r.status !== "loaded" && r.status !== "error");
-  s.byId = new Map(s.records.map(r => [r.id, r]));
-  invalidate();
-}
-
-// ---------------------------------------------------------------------------
-// Mirror mode (desktop dashboard)
-// ---------------------------------------------------------------------------
-
-/**
- * Dashboards never instrument their own images — the store is purely a mirror
- * of the synced device. Makes installImageCapture() a permanent no-op.
- */
-export function disableImagesCapture() {
-  imagesState().captureDisabled = true;
-}
-
-/**
- * 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 function replaceImagesFromSnapshot(payload) {
-  const s = imagesState();
-  const wire = payload.records ?? [];
-
-  // neededPx was computed on device as round(layout * PixelRatio.get()), so
-  // the widest record recovers the device scale with the least rounding error.
-  let bestWidth = 0;
-  for (const w of wire) {
-    if (w.layout && w.neededPx && w.layout.width > bestWidth) {
-      bestWidth = w.layout.width;
-      s.mirrorPixelRatio = w.neededPx.width / w.layout.width;
-    }
-  }
-  const now = Date.now();
-  s.records = [...wire].reverse().map(w => ({
-    id: w.id,
-    lib: w.lib,
-    uri: w.uri,
-    sourceKind: w.kind,
-    status: w.status,
-    mounted: w.mounted,
-    createdAt: now - w.ageMs,
-    durationMs: w.ms ?? undefined,
-    intrinsic: w.intrinsic ?? undefined,
-    layout: w.layout ?? undefined,
-    cacheVerdict: w.cache ?? undefined,
-    cacheVerdictSource: w.cacheSource ?? undefined,
-    progressSeen: w.progressSeen,
-    // The wire carries only the total; a settled download loaded all of it.
-    bytesLoaded: w.status === "loaded" ? w.bytesTotal ?? undefined : undefined,
-    bytesTotal: w.bytesTotal ?? undefined,
-    error: w.error ?? undefined,
-    errorCode: w.errorCode ?? undefined,
-    loadCount: w.loadCount,
-    overrideLabel: w.overrideLabel ?? undefined,
-    hasAltText: w.hasAltText ?? undefined,
-    layoutShifts: w.layoutShifts
-  }));
-  s.byId = new Map(s.records.map(r => [r.id, r]));
-  if (payload.globalModes) s.globalModes = {
-    ...payload.globalModes
-  };
-  if (payload.captureStatus) s.mirrorCaptureStatus = payload.captureStatus;
-  invalidate();
-  // Mode toggles render through the actions bus, not the record store.
-  for (const l of s.actionListeners) l();
-}
-
-// ---------------------------------------------------------------------------
-// Derived math (shared by rows, detail view, and stats)
-// ---------------------------------------------------------------------------
-
-/** Device PixelRatio on device; the SYNCED device's ratio on a mirror. */
-export function effectivePixelRatio() {
-  return imagesState().mirrorPixelRatio ?? PixelRatio.get();
-}
-
-/** Physical pixels actually needed to fill the laid-out view 1:1. */
-export function neededPixels(record) {
-  if (!record.layout || record.layout.width <= 0 || record.layout.height <= 0) return null;
-  const scale = effectivePixelRatio();
-  return {
-    width: Math.round(record.layout.width * scale),
-    height: Math.round(record.layout.height * scale)
-  };
-}
-
-/**
- * Linear oversize factor: how many times larger (per axis, area-normalized)
- * the decoded bitmap is vs what the view needs. 1 = perfect, 2 = 4× the pixels.
- */
-export function oversizeFactor(record) {
-  const needed = neededPixels(record);
-  if (!needed || !record.intrinsic) return null;
-  const neededArea = needed.width * needed.height;
-  const intrinsicArea = record.intrinsic.width * record.intrinsic.height;
-  if (neededArea <= 0 || intrinsicArea <= 0) return null;
-  return Math.sqrt(intrinsicArea / neededArea);
-}
-
-/** Estimated decoded-bitmap memory for a loaded record (RGBA8888). */
-export function estDecodedBytes(record) {
-  if (!record.intrinsic) return 0;
-  return record.intrinsic.width * record.intrinsic.height * 4;
-}
-
-/** Decoded bytes beyond what the laid-out size needs (0 if not oversized). */
-export function estWastedBytes(record) {
-  const needed = neededPixels(record);
-  if (!needed || !record.intrinsic) return 0;
-  const wasted = (record.intrinsic.width * record.intrinsic.height - needed.width * needed.height) * 4;
-  return Math.max(0, wasted);
-}
-export function computeStats(list) {
-  const stats = {
-    total: list.length,
-    loading: 0,
-    loaded: 0,
-    errors: 0,
-    networkLoads: 0,
-    estDecodedBytes: 0,
-    estWastedBytes: 0
-  };
-  for (const r of list) {
-    // Unmounted in-flight records are stale (the instance died mid-load) —
-    // they must not count as live in-flight work.
-    if ((r.status === "loading" || r.status === "pending") && r.mounted) stats.loading++;
-    if (r.status === "loaded") stats.loaded++;
-    if (r.status === "error") stats.errors++;
-    if (r.progressSeen || r.cacheVerdict === "none") stats.networkLoads++;
-    if (r.mounted && r.status === "loaded") {
-      stats.estDecodedBytes += estDecodedBytes(r);
-      stats.estWastedBytes += estWastedBytes(r);
-    }
-  }
-  return stats;
-}
-//# sourceMappingURL=imageEventStore.js.map
+"use strict";import{PixelRatio as a}from"react-native";import{remoteImagesDispatch as c}from"../remote";import{imagesState as i}from"../state";const u=500;function l(){const e=i();if(e.emitScheduled)return;e.emitScheduled=true;requestAnimationFrame(()=>{e.emitScheduled=false;for(const t of e.listeners)t()})}function s(){const e=i();e.snapshot=[...e.records];l()}export function createRecord(e){const t=i();const o={...e,id:t.nextId++,createdAt:Date.now(),status:"pending",mounted:true,loadCount:0};t.records.push(o);t.byId.set(o.id,o);if(t.records.length>u){const r=t.records.splice(0,t.records.length-u);for(const d of r)t.byId.delete(d.id)}s();return o}export function updateRecord(e,t){const o=i();const r=o.byId.get(e);if(!r)return void 0;Object.assign(r,t);s();return r}export function getRecord(e){return i().byId.get(e)}export function getSnapshot(){return i().snapshot}export function subscribe(e){const t=i();t.listeners.add(e);return()=>i().listeners.delete(e)}export function clearRecords(){void c()?.("clearRecords");const e=i();e.records=e.records.filter(t=>t.mounted&&t.status!=="loaded"&&t.status!=="error");e.byId=new Map(e.records.map(t=>[t.id,t]));s()}export function disableImagesCapture(){i().captureDisabled=true}export function replaceImagesFromSnapshot(e){const t=i();const o=e.records??[];let r=0;for(const n of o){if(n.layout&&n.neededPx&&n.layout.width>r){r=n.layout.width;t.mirrorPixelRatio=n.neededPx.width/n.layout.width}}const d=Date.now();t.records=[...o].reverse().map(n=>({id:n.id,lib:n.lib,uri:n.uri,sourceKind:n.kind,status:n.status,mounted:n.mounted,createdAt:d-n.ageMs,durationMs:n.ms??void 0,intrinsic:n.intrinsic??void 0,layout:n.layout??void 0,cacheVerdict:n.cache??void 0,cacheVerdictSource:n.cacheSource??void 0,progressSeen:n.progressSeen,bytesLoaded:n.status==="loaded"?n.bytesTotal??void 0:void 0,bytesTotal:n.bytesTotal??void 0,error:n.error??void 0,errorCode:n.errorCode??void 0,loadCount:n.loadCount,overrideLabel:n.overrideLabel??void 0,hasAltText:n.hasAltText??void 0,layoutShifts:n.layoutShifts}));t.byId=new Map(t.records.map(n=>[n.id,n]));if(e.globalModes)t.globalModes={...e.globalModes};if(e.captureStatus)t.mirrorCaptureStatus=e.captureStatus;s();for(const n of t.actionListeners)n()}export function effectivePixelRatio(){return i().mirrorPixelRatio??a.get()}export function neededPixels(e){if(!e.layout||e.layout.width<=0||e.layout.height<=0)return null;const t=effectivePixelRatio();return{width:Math.round(e.layout.width*t),height:Math.round(e.layout.height*t)}}export function oversizeFactor(e){const t=neededPixels(e);if(!t||!e.intrinsic)return null;const o=t.width*t.height;const r=e.intrinsic.width*e.intrinsic.height;if(o<=0||r<=0)return null;return Math.sqrt(r/o)}export function estDecodedBytes(e){if(!e.intrinsic)return 0;return e.intrinsic.width*e.intrinsic.height*4}export function estWastedBytes(e){const t=neededPixels(e);if(!t||!e.intrinsic)return 0;const o=(e.intrinsic.width*e.intrinsic.height-t.width*t.height)*4;return Math.max(0,o)}export function computeStats(e){const t={total:e.length,loading:0,loaded:0,errors:0,networkLoads:0,estDecodedBytes:0,estWastedBytes:0};for(const o of e){if((o.status==="loading"||o.status==="pending")&&o.mounted)t.loading++;if(o.status==="loaded")t.loaded++;if(o.status==="error")t.errors++;if(o.progressSeen||o.cacheVerdict==="none")t.networkLoads++;if(o.mounted&&o.status==="loaded"){t.estDecodedBytes+=estDecodedBytes(o);t.estWastedBytes+=estWastedBytes(o)}}return t}

package/lib/module/store/insights.js

@@ -1,71 +1 @@
-"use strict";
-
-/**
- * Cross-record insights — findings computed purely from data the registry
- * already holds (no extra instrumentation): duplicate simultaneous loads,
- * retry storms, iOS image-queue saturation, missing alt text, and
- * layout-shifting images.
- */
-
-/** loadCount at/above this flags render-thrash reload storms. */
-const RETRY_STORM_THRESHOLD = 5;
-/** RCTImageLoader allows 4 concurrent loading tasks on iOS. */
-const IOS_CONCURRENT_LOAD_LIMIT = 4;
-export function computeInsights(records) {
-  const byUri = new Map();
-  const retryStorms = [];
-  const layoutShifters = [];
-  let missingAlt = 0;
-  let rnLoading = 0;
-  for (const r of records) {
-    if (r.mounted && r.uri) {
-      byUri.set(r.uri, (byUri.get(r.uri) ?? 0) + 1);
-    }
-    if (r.loadCount >= RETRY_STORM_THRESHOLD) {
-      retryStorms.push({
-        id: r.id,
-        uri: r.uri,
-        loadCount: r.loadCount
-      });
-    }
-    if ((r.layoutShifts ?? 0) > 0) {
-      layoutShifters.push({
-        id: r.id,
-        uri: r.uri,
-        shifts: r.layoutShifts ?? 0
-      });
-    }
-    if (r.mounted && r.hasAltText === false) missingAlt++;
-    if (r.lib === "rn" && r.mounted && r.status === "loading") rnLoading++;
-  }
-  const duplicates = [...byUri.entries()].filter(([, count]) => count > 1).map(([uri, count]) => ({
-    uri,
-    count
-  })).sort((a, b) => b.count - a.count);
-  return {
-    duplicates,
-    retryStorms: retryStorms.sort((a, b) => b.loadCount - a.loadCount),
-    queueSaturated: rnLoading > IOS_CONCURRENT_LOAD_LIMIT,
-    missingAlt,
-    layoutShifters
-  };
-}
-
-/** Compact one-line chips for UI/MCP surfacing. Empty array = all clear. */
-export function insightChips(insights) {
-  const chips = [];
-  if (insights.duplicates.length > 0) {
-    const extra = insights.duplicates.reduce((n, d) => n + d.count - 1, 0);
-    chips.push(`${insights.duplicates.length} duplicate URL${insights.duplicates.length > 1 ? "s" : ""} (${extra} redundant loads)`);
-  }
-  if (insights.retryStorms.length > 0) {
-    chips.push(`${insights.retryStorms.length} retry storm${insights.retryStorms.length > 1 ? "s" : ""}`);
-  }
-  if (insights.queueSaturated) chips.push("iOS image queue saturated (>4 loading)");
-  if (insights.missingAlt > 0) chips.push(`${insights.missingAlt} missing alt text`);
-  if (insights.layoutShifters.length > 0) {
-    chips.push(`${insights.layoutShifters.length} layout-shifting image${insights.layoutShifters.length > 1 ? "s" : ""}`);
-  }
-  return chips;
-}
-//# sourceMappingURL=insights.js.map
+"use strict";const i=5;const d=4;export function computeInsights(e){const u=new Map;const r=[];const l=[];let s=0;let n=0;for(const t of e){if(t.mounted&&t.uri){u.set(t.uri,(u.get(t.uri)??0)+1)}if(t.loadCount>=i){r.push({id:t.id,uri:t.uri,loadCount:t.loadCount})}if((t.layoutShifts??0)>0){l.push({id:t.id,uri:t.uri,shifts:t.layoutShifts??0})}if(t.mounted&&t.hasAltText===false)s++;if(t.lib==="rn"&&t.mounted&&t.status==="loading")n++}const a=[...u.entries()].filter(([,t])=>t>1).map(([t,o])=>({uri:t,count:o})).sort((t,o)=>o.count-t.count);return{duplicates:a,retryStorms:r.sort((t,o)=>o.loadCount-t.loadCount),queueSaturated:n>d,missingAlt:s,layoutShifters:l}}export function insightChips(e){const u=[];if(e.duplicates.length>0){const r=e.duplicates.reduce((l,s)=>l+s.count-1,0);u.push(`${e.duplicates.length} duplicate URL${e.duplicates.length>1?"s":""} (${r} redundant loads)`)}if(e.retryStorms.length>0){u.push(`${e.retryStorms.length} retry storm${e.retryStorms.length>1?"s":""}`)}if(e.queueSaturated)u.push("iOS image queue saturated (>4 loading)");if(e.missingAlt>0)u.push(`${e.missingAlt} missing alt text`);if(e.layoutShifters.length>0){u.push(`${e.layoutShifters.length} layout-shifting image${e.layoutShifters.length>1?"s":""}`)}return u}

package/lib/module/sync/imagesSyncAdapter.js

@@ -1,356 +1 @@
-"use strict";
-
-import { loadExpoImage } from "../capture/nativeImageModules";
-/**
- * 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";
-/**
- * `data:` URIs (and any URI over this) are NOT copied onto the snapshot.
- * A single inline PNG is routinely hundreds of KB to several MB of base64;
- * 100 of those on every ~200ms tick exceed the 2MB emit budget and drop
- * the whole images panel. The list already uses a "?" thumb for `data`
- * sources (see ImageRow), so the payload is unused on the wire. Dashboards
- * still get `kind: "data"` and a short unique stub for the row label.
- */
-export const SNAPSHOT_URI_INLINE_LIMIT = 2 * 1024;
-export function toWireUri(uri) {
-  if (!uri) return uri;
-  if (uri.startsWith("data:")) {
-    const comma = uri.indexOf(",");
-    const header = comma >= 0 ? uri.slice(0, Math.min(comma + 1, 64)) : "data:";
-    const payload = comma >= 0 ? uri.slice(comma + 1) : uri;
-    const hint = payload.length > 16 ? `${payload.slice(0, 8)}…${payload.slice(-8)}` : payload;
-    return `${header}[${uri.length} chars ${hint}]`;
-  }
-  if (uri.length <= SNAPSHOT_URI_INLINE_LIMIT) return uri;
-  return `${uri.slice(0, SNAPSHOT_URI_INLINE_LIMIT)}… [${uri.length - SNAPSHOT_URI_INLINE_LIMIT} more]`;
-}
-function capText(value, limit = SNAPSHOT_URI_INLINE_LIMIT) {
-  if (!value) return null;
-  if (value.length <= limit) return value;
-  return `${value.slice(0, limit)}… [${value.length - limit} more]`;
-}
-function toWireInsights(insights) {
-  return {
-    ...insights,
-    duplicates: insights.duplicates.map(d => ({
-      ...d,
-      uri: toWireUri(d.uri)
-    })),
-    retryStorms: insights.retryStorms.map(s => ({
-      ...s,
-      uri: toWireUri(s.uri)
-    })),
-    layoutShifters: insights.layoutShifters.map(s => ({
-      ...s,
-      uri: toWireUri(s.uri)
-    }))
-  };
-}
-
-/** 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: toWireUri(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: capText(record.error),
-    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: toWireInsights(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 = loadExpoImage();
-        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
+"use strict";import{loadExpoImage as g}from"../capture/nativeImageModules";import{evictExpoDiskEntry as p,hardReloadAllMounted as f,hardReloadRecord as k,retryRecord as y}from"../capture/actions";import{getCaptureStatus as d}from"../capture/install";import{clearAllOverrides as w,clearOverride as b,flashAllMounted as S,flashRecord as v,getGlobalModes as i,setBlankImages as M,setNetworkMode as $,setOverride as c,setOverrideForAllMounted as l}from"../capture/overrides";import{proveSavings as x}from"../capture/savings";import{computeInsights as I}from"../store/insights";import{clearRecords as R,computeStats as E,estDecodedBytes as F,estWastedBytes as A,getRecord as C,getSnapshot as B,neededPixels as O,oversizeFactor as D,subscribe as T}from"../store/imageEventStore";export const SNAPSHOT_URI_INLINE_LIMIT=2*1024;export function toWireUri(e){if(!e)return e;if(e.startsWith("data:")){const r=e.indexOf(",");const t=r>=0?e.slice(0,Math.min(r+1,64)):"data:";const o=r>=0?e.slice(r+1):e;const s=o.length>16?`${o.slice(0,8)}\u2026${o.slice(-8)}`:o;return`${t}[${e.length} chars ${s}]`}if(e.length<=SNAPSHOT_URI_INLINE_LIMIT)return e;return`${e.slice(0,SNAPSHOT_URI_INLINE_LIMIT)}\u2026 [${e.length-SNAPSHOT_URI_INLINE_LIMIT} more]`}function N(e,r=SNAPSHOT_URI_INLINE_LIMIT){if(!e)return null;if(e.length<=r)return e;return`${e.slice(0,r)}\u2026 [${e.length-r} more]`}function L(e){return{...e,duplicates:e.duplicates.map(r=>({...r,uri:toWireUri(r.uri)})),retryStorms:e.retryStorms.map(r=>({...r,uri:toWireUri(r.uri)})),layoutShifters:e.layoutShifters.map(r=>({...r,uri:toWireUri(r.uri)}))}}function u(e){const r=D(e);return{id:e.id,lib:e.lib,uri:toWireUri(e.uri),kind:e.sourceKind,status:e.status,mounted:e.mounted,cache:e.cacheVerdict??null,cacheSource:e.cacheVerdictSource??null,ms:e.durationMs!=null?Math.round(e.durationMs):null,intrinsic:e.intrinsic??null,layout:e.layout?{width:Math.round(e.layout.width),height:Math.round(e.layout.height)}:null,neededPx:O(e),oversizeFactor:r!=null?Math.round(r*100)/100:null,decodedKB:Math.round(F(e)/1024),wastedKB:Math.round(A(e)/1024),progressSeen:e.progressSeen===true,bytesTotal:e.bytesTotal??null,error:N(e.error),errorCode:e.errorCode??null,loadCount:e.loadCount,overrideLabel:e.overrideLabel??null,hasAltText:e.hasAltText??null,layoutShifts:e.layoutShifts??0,ageMs:Date.now()-e.createdAt}}function n(e){const r=e?.id;if(typeof r!=="number")throw new Error("Missing numeric `id` param");const t=C(r);if(!t){throw new Error(`Image record ${r} not found (cleared or evicted) \u2014 re-run the list action for current ids.`)}return t}function m(){const e=B();return{stats:E(e),captureStatus:d(),globalModes:i(),insights:L(I(e)),records:[...e].reverse()}}export const imagesSyncAdapter={version:1,getSnapshot:()=>{const{records:e,...r}=m();return{...r,records:e.slice(0,100).map(u)}},subscribe:e=>T(e),actions:{list:e=>{const r=e??{};const t=Math.min(Math.max(r.limit??50,1),200);const{records:o,...s}=m();const a=r.status?o.filter(h=>h.status===r.status):o;return{...s,total:a.length,records:a.slice(0,t).map(u)}},getDetail:e=>{const r=n(e);return{...u(r),errorHeaders:r.errorHeaders??null}},hardReload:e=>k(n(e)),proveSavings:e=>x(n(e)),retry:e=>y(n(e)),evictDisk:async e=>{const r=n(e);const t=await p(r);return{ok:t,message:t?"Disk cache entry deleted":"No disk entry found (expo-image + expo-file-system required)"}},flash:e=>{v(n(e).id);return{ok:true,message:"Flashing for 2.5s"}},setOverride:e=>{const r=n(e);const t=e;const o={error:{source:{type:"error"},label:"Forced error"},hang:{source:{type:"hang"},label:"Forced loading"},blank:{source:{type:"blank"},label:"Blanked"}};if(t.kind==="url"){if(!t.uri)throw new Error("kind 'url' requires a `uri` param");c(r.id,{source:{type:"url",uri:t.uri},label:"URL swapped"});return{ok:true,message:`Source overridden to ${t.uri}`}}const s=t.kind?o[t.kind]:void 0;if(!s)throw new Error(`Unknown override kind: ${String(t.kind)}`);if(!r.mounted){return{ok:false,message:"Instance unmounted \u2014 overrides need the image on screen"}}c(r.id,s);return{ok:true,message:`${s.label} applied`}},clearOverride:e=>{b(n(e).id);return{ok:true,message:"Override removed \u2014 original source restored"}},massAction:async e=>{const r=e?.kind;switch(r){case"error":{const t=l({type:"error"},"Forced error");return{ok:t>0,message:`Forced error on ${t} images`}}case"loading":{const t=l({type:"hang"},"Forced loading");return{ok:t>0,message:`Forced loading on ${t} images`}}case"blank":{const t=l({type:"blank"},"Blanked");return{ok:t>0,message:`Blanked ${t} images`}}case"reload":return f();case"flash":{const t=S();return{ok:t>0,message:`Flashing ${t} images`}}case"restore":{const t=w();return{ok:true,message:`Restored ${t} images`}}default:throw new Error(`Unknown mass kind: ${String(r)}`)}},setNetworkMode:e=>{const r=e?.mode;if(r!=="normal"&&r!=="offline"&&r!=="cold"){throw new Error("mode must be 'normal' | 'offline' | 'cold'")}$(r);return{ok:true,modes:i()}},setBlankImages:e=>{M(e?.enabled===true);return{ok:true,modes:i()}},clearRecords:()=>{R();return{ok:true,message:"Registry cleared"}},clearExpoCaches:async e=>{const r=e??{};const t=r.memory!==false;const o=r.disk!==false;try{const s=g();const a=[];if(t){await s.Image.clearMemoryCache();a.push("memory")}if(o){await s.Image.clearDiskCache();a.push("disk")}return{ok:true,message:`Cleared expo-image ${a.join(" + ")} cache`}}catch{return{ok:false,message:"expo-image not installed"}}},getCaptureStatus:()=>d()}};

package/lib/module/types.js

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