@buoy-gg/images 7.0.3

package/lib/commonjs/capture/overrides.js

@@ -0,0 +1,286 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.applyOverrides = applyOverrides;
+exports.clearAllOverrides = clearAllOverrides;
+exports.clearOverride = clearOverride;
+exports.flashAllMounted = flashAllMounted;
+exports.flashRecord = flashRecord;
+exports.getGlobalModes = getGlobalModes;
+exports.getOverride = getOverride;
+exports.getRenderVersion = getRenderVersion;
+exports.patchSourceCache = patchSourceCache;
+exports.setBlankImages = setBlankImages;
+exports.setNetworkMode = setNetworkMode;
+exports.setOverride = setOverride;
+exports.setOverrideForAllMounted = setOverrideForAllMounted;
+exports.touchGlobal = touchGlobal;
+exports.touchRecord = touchRecord;
+var _state = require("../state");
+var _imageEventStore = require("../store/imageEventStore");
+/**
+ * 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.
+ */
+
+// ---------------------------------------------------------------------------
+// Override model
+// ---------------------------------------------------------------------------
+
+const FORCED_ERROR_URI = "file:///buoy-images-forced-error.png";
+const HANG_URI = "https://10.255.255.1/buoy-images-hang.png";
+/** Offline mode replaces network sources with this (fails immediately). */
+const OFFLINE_URI = "file:///buoy-images-offline-no-network.png";
+const FLASH_STYLE = {
+  borderWidth: 3,
+  borderColor: "#FF453A"
+};
+/**
+ * RN core has NO safe "empty source": undefined resolves to the app bundle
+ * path and [] does too on RN 0.85 — both fire a bogus onError ("The file …
+ * couldn't be opened", observed live). So RN images blank via opacity
+ * instead (visual-only; the decoded image stays resident). expo-image
+ * supports a true `source={null}` and keeps showing its placeholder.
+ */
+const RN_BLANK_STYLE = {
+  opacity: 0
+};
+// ---------------------------------------------------------------------------
+// Version bus (re-render triggers)
+// ---------------------------------------------------------------------------
+
+function emit() {
+  for (const l of (0, _state.imagesState)().actionListeners) l();
+}
+function forceUpdateExpo(recordId) {
+  const s = (0, _state.imagesState)();
+  if (recordId != null) {
+    const instance = s.expoInstances.get(recordId);
+    instance?.forceUpdate?.();
+    return;
+  }
+  for (const instance of s.expoInstances.values()) {
+    instance?.forceUpdate?.();
+  }
+}
+
+/** Bump one record's render version (re-renders just that image). */
+function touchRecord(recordId) {
+  const s = (0, _state.imagesState)();
+  s.recordVersions.set(recordId, ++s.versionCounter);
+  emit();
+  forceUpdateExpo(recordId);
+}
+
+/** Bump the global render version (re-renders every wrapped image). */
+function touchGlobal() {
+  const s = (0, _state.imagesState)();
+  s.globalVersion = ++s.versionCounter;
+  emit();
+  forceUpdateExpo();
+}
+
+/** Snapshot for the RN wrapper's useSyncExternalStore. */
+function getRenderVersion(recordId) {
+  const s = (0, _state.imagesState)();
+  const record = recordId != null ? s.recordVersions.get(recordId) ?? 0 : 0;
+  return Math.max(record, s.globalVersion);
+}
+
+// ---------------------------------------------------------------------------
+// Per-record overrides
+// ---------------------------------------------------------------------------
+
+function setOverride(recordId, override) {
+  (0, _state.imagesState)().overrides.set(recordId, override);
+  (0, _imageEventStore.updateRecord)(recordId, {
+    overrideLabel: override.label
+  });
+  touchRecord(recordId);
+}
+function clearOverride(recordId) {
+  (0, _state.imagesState)().overrides.delete(recordId);
+  (0, _imageEventStore.updateRecord)(recordId, {
+    overrideLabel: undefined
+  });
+  touchRecord(recordId);
+}
+function getOverride(recordId) {
+  if (recordId == null) return undefined;
+  return (0, _state.imagesState)().overrides.get(recordId);
+}
+
+// ---------------------------------------------------------------------------
+// Mass actions (every mounted image at once)
+// ---------------------------------------------------------------------------
+
+/** Apply one override to every mounted record. Returns how many were hit. */
+function setOverrideForAllMounted(source, label) {
+  let count = 0;
+  for (const record of (0, _imageEventStore.getSnapshot)()) {
+    if (!record.mounted) continue;
+    setOverride(record.id, {
+      source,
+      label
+    });
+    count++;
+  }
+  return count;
+}
+
+/** Remove every active override. Returns how many were cleared. */
+function clearAllOverrides() {
+  const ids = [...(0, _state.imagesState)().overrides.keys()];
+  for (const id of ids) clearOverride(id);
+  return ids.length;
+}
+
+/** Flash every mounted image (locate everything the tool tracks). */
+function flashAllMounted(durationMs = 2500) {
+  let count = 0;
+  for (const record of (0, _imageEventStore.getSnapshot)()) {
+    if (!record.mounted) continue;
+    flashRecord(record.id, durationMs);
+    count++;
+  }
+  return count;
+}
+
+/** Flash a border on the on-screen image so it can be located visually. */
+function flashRecord(recordId, durationMs = 2500) {
+  const s = (0, _state.imagesState)();
+  s.flashUntil.set(recordId, Date.now() + durationMs);
+  touchRecord(recordId);
+  setTimeout(() => {
+    (0, _state.imagesState)().flashUntil.delete(recordId);
+    touchRecord(recordId);
+  }, durationMs + 50);
+}
+
+// ---------------------------------------------------------------------------
+// Global simulation modes
+// ---------------------------------------------------------------------------
+
+/**
+ * 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.
+ */
+function setNetworkMode(mode) {
+  (0, _state.imagesState)().globalModes.network = mode;
+  touchGlobal();
+}
+
+/** Chrome-style "disable images": render every image without a source. */
+function setBlankImages(enabled) {
+  (0, _state.imagesState)().globalModes.blank = enabled;
+  touchGlobal();
+}
+function getGlobalModes() {
+  return (0, _state.imagesState)().globalModes;
+}
+
+// ---------------------------------------------------------------------------
+// Application (called from the RN wrapper + expo render patch)
+// ---------------------------------------------------------------------------
+
+/** Inject a `cache` policy into an RN source (object or array shape). */
+function patchSourceCache(source, cache) {
+  if (Array.isArray(source)) {
+    return source.map(entry => entry && typeof entry === "object" && typeof entry.uri === "string" ? {
+      ...entry,
+      cache
+    } : entry);
+  }
+  if (source && typeof source === "object" && typeof source.uri === "string") {
+    return {
+      ...source,
+      cache
+    };
+  }
+  return source; // numeric assets etc. — nothing to patch
+}
+function resolveOverrideSource(source, lib) {
+  switch (source.type) {
+    case "url":
+      return {
+        uri: source.uri
+      };
+    case "error":
+      return {
+        uri: FORCED_ERROR_URI
+      };
+    case "hang":
+      return {
+        uri: HANG_URI
+      };
+    case "blank":
+      // Only reached for expo — RN blanking is style-based (see RN_BLANK_STYLE).
+      return null;
+  }
+}
+
+/**
+ * Merge global modes + per-record override + locate-flash into an
+ * already-copied props object. Mutates and returns `out`.
+ */
+function applyOverrides(out, recordId, lib) {
+  const s = (0, _state.imagesState)();
+  const modes = s.globalModes;
+  if (modes.network === "offline") {
+    // Hard offline: network sources fail outright (both libs); bundled/local
+    // assets keep loading like a real offline device.
+    const record = recordId != null ? (0, _imageEventStore.getRecord)(recordId) : undefined;
+    if (record?.sourceKind === "network") {
+      out.source = {
+        uri: OFFLINE_URI
+      };
+    }
+  } else if (modes.network === "cold") {
+    if (lib === "rn") {
+      out.source = patchSourceCache(out.source, "reload");
+    } else {
+      out.cachePolicy = "none";
+    }
+  }
+  if (modes.blank) {
+    if (lib === "expo") out.source = null;else out.style = [out.style, RN_BLANK_STYLE];
+  }
+  const override = getOverride(recordId);
+  if (override) {
+    if (override.source) {
+      if (override.source.type === "blank" && lib === "rn") {
+        out.style = [out.style, RN_BLANK_STYLE];
+      } else {
+        out.source = resolveOverrideSource(override.source, lib);
+      }
+    }
+    if (override.extraProps) Object.assign(out, override.extraProps);
+    if (override.style) out.style = [out.style, override.style];
+  }
+  if (recordId != null) {
+    const until = s.flashUntil.get(recordId);
+    if (until != null && until > Date.now()) {
+      out.style = [out.style, FLASH_STYLE];
+    }
+  }
+  return out;
+}
+//# sourceMappingURL=overrides.js.map

package/lib/commonjs/capture/overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_state","require","_imageEventStore","FORCED_ERROR_URI","HANG_URI","OFFLINE_URI","FLASH_STYLE","borderWidth","borderColor","RN_BLANK_STYLE","opacity","emit","l","imagesState","actionListeners","forceUpdateExpo","recordId","s","instance","expoInstances","get","forceUpdate","values","touchRecord","recordVersions","set","versionCounter","touchGlobal","globalVersion","getRenderVersion","record","Math","max","setOverride","override","overrides","updateRecord","overrideLabel","label","clearOverride","delete","undefined","getOverride","setOverrideForAllMounted","source","count","getSnapshot","mounted","id","clearAllOverrides","ids","keys","length","flashAllMounted","durationMs","flashRecord","flashUntil","Date","now","setTimeout","setNetworkMode","mode","globalModes","network","setBlankImages","enabled","blank","getGlobalModes","patchSourceCache","cache","Array","isArray","map","entry","uri","resolveOverrideSource","lib","type","applyOverrides","out","modes","getRecord","sourceKind","cachePolicy","style","extraProps","Object","assign","until"],"sourceRoot":"../../../src","sources":["capture/overrides.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/capture/savings.js

@@ -0,0 +1,193 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.proveSavings = proveSavings;
+var _imageEventStore = require("../store/imageEventStore");
+/**
+ * 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.
+ */
+
+function loadLegacyFs() {
+  try {
+    const mod = require("expo-file-system/legacy");
+    const fs = mod?.default || mod;
+    if (fs?.getInfoAsync) return fs;
+  } catch {
+    // try main import
+  }
+  try {
+    const mod = require("expo-file-system");
+    const fs = mod?.default || mod;
+    if (fs?.getInfoAsync) return fs;
+  } catch {
+    // not installed
+  }
+  return null;
+}
+async function fileSize(uri) {
+  const fs = loadLegacyFs();
+  if (!fs?.getInfoAsync) return null;
+  try {
+    const normalized = uri.startsWith("file://") ? uri : `file://${uri}`;
+    const info = await fs.getInfoAsync(normalized, {
+      size: true
+    });
+    return info.exists && typeof info.size === "number" ? info.size : null;
+  } catch {
+    return null;
+  }
+}
+async function resolveOriginalBytes(record) {
+  if (record.bytesTotal && record.bytesTotal > 0) {
+    return {
+      bytes: record.bytesTotal,
+      source: "download"
+    };
+  }
+  // expo disk cache file
+  if (record.lib === "expo") {
+    try {
+      const expo = require("expo-image");
+      const path = await expo.Image.getCachePathAsync(record.uri);
+      if (path) {
+        const size = await fileSize(path);
+        if (size != null) return {
+          bytes: size,
+          source: "cacheFile"
+        };
+      }
+    } catch {
+      // fall through
+    }
+  }
+  // HEAD request (network sources only)
+  if (record.sourceKind === "network") {
+    try {
+      const response = await fetch(record.uri, {
+        method: "HEAD"
+      });
+      const length = Number(response.headers.get("content-length"));
+      if (Number.isFinite(length) && length > 0) return {
+        bytes: length,
+        source: "head"
+      };
+    } catch {
+      // unknown original size is fine
+    }
+  }
+  return null;
+}
+
+/**
+ * Re-encode `record`'s source at its displayed size as WebP and measure it.
+ * Requires expo-image-manipulator (graceful message when absent).
+ */
+async function proveSavings(record) {
+  if (!record.uri || record.sourceKind !== "network" && record.sourceKind !== "asset" && record.sourceKind !== "file") {
+    return {
+      ok: false,
+      message: "No loadable source URI on this record"
+    };
+  }
+  const needed = (0, _imageEventStore.neededPixels)(record);
+  if (!needed) {
+    return {
+      ok: false,
+      message: "No layout yet — the image must render once to know its displayed size"
+    };
+  }
+  let manipulator;
+  try {
+    manipulator = require("expo-image-manipulator");
+  } catch {
+    return {
+      ok: false,
+      message: "expo-image-manipulator not installed — add it to enable real savings measurement"
+    };
+  }
+  const webp = manipulator.SaveFormat?.WEBP ?? "webp";
+  const targetWidth = Math.min(needed.width, record.intrinsic?.width ?? needed.width);
+  let original = null;
+  let optimized = null;
+  try {
+    [original, optimized] = await Promise.all([resolveOriginalBytes(record), (async () => {
+      // Preferred: context API (current). Fallback: deprecated manipulateAsync.
+      if (manipulator.ImageManipulator?.manipulate) {
+        const context = manipulator.ImageManipulator.manipulate(record.uri);
+        try {
+          const ref = await context.resize({
+            width: targetWidth
+          }).renderAsync();
+          try {
+            return await ref.saveAsync({
+              format: webp,
+              compress: 0.8
+            });
+          } finally {
+            ref.release?.();
+          }
+        } finally {
+          context.release?.();
+        }
+      }
+      if (manipulator.manipulateAsync) {
+        return manipulator.manipulateAsync(record.uri, [{
+          resize: {
+            width: targetWidth
+          }
+        }], {
+          compress: 0.8,
+          format: webp
+        });
+      }
+      return null;
+    })()]);
+  } catch (error) {
+    return {
+      ok: false,
+      message: `Re-encode failed: ${String(error?.message ?? error)}`
+    };
+  }
+  if (!optimized?.uri) {
+    return {
+      ok: false,
+      message: "Re-encode produced no output (unsupported source?)"
+    };
+  }
+  const optimizedBytes = await fileSize(optimized.uri);
+  const result = {
+    ok: true,
+    message: "",
+    optimizedUri: optimized.uri,
+    optimizedBytes: optimizedBytes ?? undefined,
+    optimizedDims: {
+      width: optimized.width,
+      height: optimized.height
+    },
+    originalBytes: original?.bytes,
+    originalBytesSource: original?.source
+  };
+  if (original?.bytes != null && optimizedBytes != null) {
+    result.savedBytes = Math.max(0, original.bytes - optimizedBytes);
+    result.savedPct = original.bytes > 0 ? Math.round(result.savedBytes / original.bytes * 100) : 0;
+    result.message = `Right-sized WebP is ${result.savedPct}% smaller (real bytes, encoded on device)`;
+  } else if (optimizedBytes != null) {
+    result.message = "Optimized variant encoded — original size unknown (no download bytes, cache entry, or Content-Length)";
+  } else {
+    result.message = "Optimized variant encoded — could not stat the output file";
+  }
+  return result;
+}
+//# sourceMappingURL=savings.js.map

package/lib/commonjs/capture/savings.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_imageEventStore","require","loadLegacyFs","mod","fs","default","getInfoAsync","fileSize","uri","normalized","startsWith","info","size","exists","resolveOriginalBytes","record","bytesTotal","bytes","source","lib","expo","path","Image","getCachePathAsync","sourceKind","response","fetch","method","length","Number","headers","get","isFinite","proveSavings","ok","message","needed","neededPixels","manipulator","webp","SaveFormat","WEBP","targetWidth","Math","min","width","intrinsic","original","optimized","Promise","all","ImageManipulator","manipulate","context","ref","resize","renderAsync","saveAsync","format","compress","release","manipulateAsync","error","String","optimizedBytes","result","optimizedUri","undefined","optimizedDims","height","originalBytes","originalBytesSource","savedBytes","max","savedPct","round"],"sourceRoot":"../../../src","sources":["capture/savings.ts"],"mappings":"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","ignoreList":[]}