@buoy-gg/images 7.0.41 → 7.0.43

package/lib/commonjs/remote.js

@@ -1,42 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.remoteActionResult = remoteActionResult;
-exports.remoteImagesDispatch = remoteImagesDispatch;
-exports.setRemoteImagesHandler = setRemoteImagesHandler;
-var _state = require("./state");
-/**
- * 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.
- */
-
-function setRemoteImagesHandler(handler) {
-  (0, _state.imagesState)().remoteDispatch = handler;
-}
-function remoteImagesDispatch() {
-  return (0, _state.imagesState)().remoteDispatch;
-}
-
-/** Coerce an adapter action's `{ ok, message }` reply into an ActionResult. */
-async function remoteActionResult(call) {
-  try {
-    const result = await call;
-    return {
-      ok: !!result?.ok,
-      message: String(result?.message ?? "")
-    };
-  } catch (error) {
-    return {
-      ok: false,
-      message: String(error?.message ?? error)
-    };
-  }
-}
-//# sourceMappingURL=remote.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.remoteActionResult=remoteActionResult;exports.remoteImagesDispatch=remoteImagesDispatch;exports.setRemoteImagesHandler=setRemoteImagesHandler;var _state=require("./state");function setRemoteImagesHandler(t){(0,_state.imagesState)().remoteDispatch=t}function remoteImagesDispatch(){return(0,_state.imagesState)().remoteDispatch}async function remoteActionResult(t){try{const e=await t;return{ok:!!e?.ok,message:String(e?.message??"")}}catch(e){return{ok:false,message:String(e?.message??e)}}}

package/lib/commonjs/state.js

@@ -1,58 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.imagesState = imagesState;
-/**
- * Global singleton state for the Images tool.
- *
- * The package can get evaluated twice as two separate module instances (e.g.
- * the `/register` entry shim resolving to one copy while the package root
- * import resolves to another — lib vs src). If capture state lived in module
- * scope, the early copy would install the RN decorator and collect records
- * while the UI copy read an empty store and a false "decorator never ran"
- * flag. Keying all mutable state on globalThis under a well-known symbol makes
- * every copy operate on the same data.
- */
-
-const KEY = Symbol.for("buoy.images.globalState.v1");
-function imagesState() {
-  const g = globalThis;
-  if (!g[KEY]) {
-    g[KEY] = {
-      records: [],
-      byId: new Map(),
-      nextId: 1,
-      listeners: new Set(),
-      snapshot: [],
-      emitScheduled: false,
-      captureInstalled: false,
-      rnInstalled: false,
-      expoInstalled: false,
-      decoratorRegistered: false,
-      decoratorInvoked: false,
-      attachSeen: 0,
-      expoAvailable: false,
-      expoPatched: false,
-      reloadRequests: new Map(),
-      actionListeners: new Set(),
-      expoInstances: new Map(),
-      overrides: new Map(),
-      flashUntil: new Map(),
-      recordVersions: new Map(),
-      globalVersion: 0,
-      versionCounter: 0,
-      globalModes: {
-        network: "normal",
-        blank: false
-      },
-      captureDisabled: false,
-      remoteDispatch: null,
-      mirrorPixelRatio: null,
-      mirrorCaptureStatus: null
-    };
-  }
-  return g[KEY];
-}
-//# sourceMappingURL=state.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.imagesState=imagesState;const KEY=Symbol.for("buoy.images.globalState.v1");function imagesState(){const e=globalThis;if(!e[KEY]){e[KEY]={records:[],byId:new Map,nextId:1,listeners:new Set,snapshot:[],emitScheduled:false,captureInstalled:false,rnInstalled:false,expoInstalled:false,decoratorRegistered:false,decoratorInvoked:false,attachSeen:0,expoAvailable:false,expoPatched:false,reloadRequests:new Map,actionListeners:new Set,expoInstances:new Map,overrides:new Map,flashUntil:new Map,recordVersions:new Map,globalVersion:0,versionCounter:0,globalModes:{network:"normal",blank:false},captureDisabled:false,remoteDispatch:null,mirrorPixelRatio:null,mirrorCaptureStatus:null}}return e[KEY]}

package/lib/commonjs/store/imageEventStore.js

@@ -1,238 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.clearRecords = clearRecords;
-exports.computeStats = computeStats;
-exports.createRecord = createRecord;
-exports.disableImagesCapture = disableImagesCapture;
-exports.effectivePixelRatio = effectivePixelRatio;
-exports.estDecodedBytes = estDecodedBytes;
-exports.estWastedBytes = estWastedBytes;
-exports.getRecord = getRecord;
-exports.getSnapshot = getSnapshot;
-exports.neededPixels = neededPixels;
-exports.oversizeFactor = oversizeFactor;
-exports.replaceImagesFromSnapshot = replaceImagesFromSnapshot;
-exports.subscribe = subscribe;
-exports.updateRecord = updateRecord;
-var _reactNative = require("react-native");
-var _remote = require("../remote");
-var _state = require("../state");
-/**
- * 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.
- */
-
-/** Max records retained before the oldest are dropped. */
-const MAX_RECORDS = 500;
-function emit() {
-  const s = (0, _state.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 = (0, _state.imagesState)();
-  s.snapshot = [...s.records];
-  emit();
-}
-function createRecord(partial) {
-  const s = (0, _state.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. */
-function updateRecord(id, patch) {
-  const s = (0, _state.imagesState)();
-  const record = s.byId.get(id);
-  if (!record) return undefined;
-  Object.assign(record, patch);
-  invalidate();
-  return record;
-}
-function getRecord(id) {
-  return (0, _state.imagesState)().byId.get(id);
-}
-function getSnapshot() {
-  return (0, _state.imagesState)().snapshot;
-}
-function subscribe(listener) {
-  const s = (0, _state.imagesState)();
-  s.listeners.add(listener);
-  return () => (0, _state.imagesState)().listeners.delete(listener);
-}
-function clearRecords() {
-  // Mirror mode: clear the device's registry too, or the next snapshot would
-  // refill this store straight away.
-  void (0, _remote.remoteImagesDispatch)()?.("clearRecords");
-  const s = (0, _state.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.
- */
-function disableImagesCapture() {
-  (0, _state.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.
- */
-function replaceImagesFromSnapshot(payload) {
-  const s = (0, _state.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. */
-function effectivePixelRatio() {
-  return (0, _state.imagesState)().mirrorPixelRatio ?? _reactNative.PixelRatio.get();
-}
-
-/** Physical pixels actually needed to fill the laid-out view 1:1. */
-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.
- */
-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). */
-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). */
-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);
-}
-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";Object.defineProperty(exports,"__esModule",{value:true});exports.clearRecords=clearRecords;exports.computeStats=computeStats;exports.createRecord=createRecord;exports.disableImagesCapture=disableImagesCapture;exports.effectivePixelRatio=effectivePixelRatio;exports.estDecodedBytes=estDecodedBytes;exports.estWastedBytes=estWastedBytes;exports.getRecord=getRecord;exports.getSnapshot=getSnapshot;exports.neededPixels=neededPixels;exports.oversizeFactor=oversizeFactor;exports.replaceImagesFromSnapshot=replaceImagesFromSnapshot;exports.subscribe=subscribe;exports.updateRecord=updateRecord;var _reactNative=require("react-native");var _remote=require("../remote");var _state=require("../state");const MAX_RECORDS=500;function emit(){const e=(0,_state.imagesState)();if(e.emitScheduled)return;e.emitScheduled=true;requestAnimationFrame(()=>{e.emitScheduled=false;for(const t of e.listeners)t()})}function invalidate(){const e=(0,_state.imagesState)();e.snapshot=[...e.records];emit()}function createRecord(e){const t=(0,_state.imagesState)();const r={...e,id:t.nextId++,createdAt:Date.now(),status:"pending",mounted:true,loadCount:0};t.records.push(r);t.byId.set(r.id,r);if(t.records.length>MAX_RECORDS){const i=t.records.splice(0,t.records.length-MAX_RECORDS);for(const n of i)t.byId.delete(n.id)}invalidate();return r}function updateRecord(e,t){const r=(0,_state.imagesState)();const i=r.byId.get(e);if(!i)return void 0;Object.assign(i,t);invalidate();return i}function getRecord(e){return(0,_state.imagesState)().byId.get(e)}function getSnapshot(){return(0,_state.imagesState)().snapshot}function subscribe(e){const t=(0,_state.imagesState)();t.listeners.add(e);return()=>(0,_state.imagesState)().listeners.delete(e)}function clearRecords(){void(0,_remote.remoteImagesDispatch)()?.("clearRecords");const e=(0,_state.imagesState)();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]));invalidate()}function disableImagesCapture(){(0,_state.imagesState)().captureDisabled=true}function replaceImagesFromSnapshot(e){const t=(0,_state.imagesState)();const r=e.records??[];let i=0;for(const s of r){if(s.layout&&s.neededPx&&s.layout.width>i){i=s.layout.width;t.mirrorPixelRatio=s.neededPx.width/s.layout.width}}const n=Date.now();t.records=[...r].reverse().map(s=>({id:s.id,lib:s.lib,uri:s.uri,sourceKind:s.kind,status:s.status,mounted:s.mounted,createdAt:n-s.ageMs,durationMs:s.ms??void 0,intrinsic:s.intrinsic??void 0,layout:s.layout??void 0,cacheVerdict:s.cache??void 0,cacheVerdictSource:s.cacheSource??void 0,progressSeen:s.progressSeen,bytesLoaded:s.status==="loaded"?s.bytesTotal??void 0:void 0,bytesTotal:s.bytesTotal??void 0,error:s.error??void 0,errorCode:s.errorCode??void 0,loadCount:s.loadCount,overrideLabel:s.overrideLabel??void 0,hasAltText:s.hasAltText??void 0,layoutShifts:s.layoutShifts}));t.byId=new Map(t.records.map(s=>[s.id,s]));if(e.globalModes)t.globalModes={...e.globalModes};if(e.captureStatus)t.mirrorCaptureStatus=e.captureStatus;invalidate();for(const s of t.actionListeners)s()}function effectivePixelRatio(){return(0,_state.imagesState)().mirrorPixelRatio??_reactNative.PixelRatio.get()}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)}}function oversizeFactor(e){const t=neededPixels(e);if(!t||!e.intrinsic)return null;const r=t.width*t.height;const i=e.intrinsic.width*e.intrinsic.height;if(r<=0||i<=0)return null;return Math.sqrt(i/r)}function estDecodedBytes(e){if(!e.intrinsic)return 0;return e.intrinsic.width*e.intrinsic.height*4}function estWastedBytes(e){const t=neededPixels(e);if(!t||!e.intrinsic)return 0;const r=(e.intrinsic.width*e.intrinsic.height-t.width*t.height)*4;return Math.max(0,r)}function computeStats(e){const t={total:e.length,loading:0,loaded:0,errors:0,networkLoads:0,estDecodedBytes:0,estWastedBytes:0};for(const r of e){if((r.status==="loading"||r.status==="pending")&&r.mounted)t.loading++;if(r.status==="loaded")t.loaded++;if(r.status==="error")t.errors++;if(r.progressSeen||r.cacheVerdict==="none")t.networkLoads++;if(r.mounted&&r.status==="loaded"){t.estDecodedBytes+=estDecodedBytes(r);t.estWastedBytes+=estWastedBytes(r)}}return t}

package/lib/commonjs/store/insights.js

@@ -1,76 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.computeInsights = computeInsights;
-exports.insightChips = insightChips;
-/**
- * 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;
-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. */
-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";Object.defineProperty(exports,"__esModule",{value:true});exports.computeInsights=computeInsights;exports.insightChips=insightChips;const RETRY_STORM_THRESHOLD=5;const IOS_CONCURRENT_LOAD_LIMIT=4;function computeInsights(e){const u=new Map;const r=[];const s=[];let i=0;let l=0;for(const t of e){if(t.mounted&&t.uri){u.set(t.uri,(u.get(t.uri)??0)+1)}if(t.loadCount>=RETRY_STORM_THRESHOLD){r.push({id:t.id,uri:t.uri,loadCount:t.loadCount})}if((t.layoutShifts??0)>0){s.push({id:t.id,uri:t.uri,shifts:t.layoutShifts??0})}if(t.mounted&&t.hasAltText===false)i++;if(t.lib==="rn"&&t.mounted&&t.status==="loading")l++}const n=[...u.entries()].filter(([,t])=>t>1).map(([t,o])=>({uri:t,count:o})).sort((t,o)=>o.count-t.count);return{duplicates:n,retryStorms:r.sort((t,o)=>o.loadCount-t.loadCount),queueSaturated:l>IOS_CONCURRENT_LOAD_LIMIT,missingAlt:i,layoutShifters:s}}function insightChips(e){const u=[];if(e.duplicates.length>0){const r=e.duplicates.reduce((s,i)=>s+i.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}