@buoy-gg/images 7.0.40 → 7.0.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (179) hide show
  1. package/README.md +12 -65
  2. package/lib/commonjs/autoCapture.js +1 -0
  3. package/lib/commonjs/autoCapture.web.js +1 -0
  4. package/lib/commonjs/capture/actions.js +1 -242
  5. package/lib/commonjs/capture/install.js +1 -45
  6. package/lib/commonjs/capture/install.web.js +1 -0
  7. package/lib/commonjs/capture/installExpoImage.js +1 -99
  8. package/lib/commonjs/capture/installRnImage.js +1 -128
  9. package/lib/commonjs/capture/nativeImageModules.js +1 -0
  10. package/lib/commonjs/capture/nativeImageModules.web.js +1 -0
  11. package/lib/commonjs/capture/overrides.js +1 -346
  12. package/lib/commonjs/capture/rnDecoratorEarly.js +1 -0
  13. package/lib/commonjs/capture/savings.js +1 -209
  14. package/lib/commonjs/capture/savings.web.js +1 -0
  15. package/lib/commonjs/capture/shared.js +1 -378
  16. package/lib/commonjs/components/ImageDetail.js +1 -454
  17. package/lib/commonjs/components/ImageDetailFooter.js +1 -158
  18. package/lib/commonjs/components/ImageRow.js +1 -156
  19. package/lib/commonjs/components/ImagesHeader.js +1 -63
  20. package/lib/commonjs/components/ImagesIcon.js +1 -19
  21. package/lib/commonjs/components/ImagesListFooter.js +1 -126
  22. package/lib/commonjs/components/ImagesModal.js +1 -240
  23. package/lib/commonjs/components/ImagesRoot.js +1 -24
  24. package/lib/commonjs/components/ImagesRoot.web.js +1 -0
  25. package/lib/commonjs/components/InsightsBar.js +1 -59
  26. package/lib/commonjs/export.js +1 -81
  27. package/lib/commonjs/format.js +1 -117
  28. package/lib/commonjs/hooks/useImageRecords.js +1 -20
  29. package/lib/commonjs/index.js +1 -261
  30. package/lib/commonjs/preset.js +1 -39
  31. package/lib/commonjs/register.js +1 -19
  32. package/lib/commonjs/registerEarly.js +1 -0
  33. package/lib/commonjs/remote.js +1 -42
  34. package/lib/commonjs/state.js +1 -58
  35. package/lib/commonjs/store/imageEventStore.js +1 -238
  36. package/lib/commonjs/store/insights.js +1 -76
  37. package/lib/commonjs/sync/imagesSyncAdapter.js +1 -360
  38. package/lib/commonjs/types.js +0 -1
  39. package/lib/module/autoCapture.js +1 -0
  40. package/lib/module/autoCapture.web.js +1 -0
  41. package/lib/module/capture/actions.js +1 -229
  42. package/lib/module/capture/install.js +1 -40
  43. package/lib/module/capture/install.web.js +1 -0
  44. package/lib/module/capture/installExpoImage.js +1 -94
  45. package/lib/module/capture/installRnImage.js +1 -122
  46. package/lib/module/capture/nativeImageModules.js +1 -0
  47. package/lib/module/capture/nativeImageModules.web.js +1 -0
  48. package/lib/module/capture/overrides.js +1 -329
  49. package/lib/module/capture/rnDecoratorEarly.js +1 -0
  50. package/lib/module/capture/savings.js +1 -205
  51. package/lib/module/capture/savings.web.js +1 -0
  52. package/lib/module/capture/shared.js +1 -369
  53. package/lib/module/components/ImageDetail.js +1 -450
  54. package/lib/module/components/ImageDetailFooter.js +1 -154
  55. package/lib/module/components/ImageRow.js +1 -152
  56. package/lib/module/components/ImagesHeader.js +1 -59
  57. package/lib/module/components/ImagesIcon.js +1 -12
  58. package/lib/module/components/ImagesListFooter.js +1 -122
  59. package/lib/module/components/ImagesModal.js +1 -235
  60. package/lib/module/components/ImagesRoot.js +1 -20
  61. package/lib/module/components/ImagesRoot.web.js +1 -0
  62. package/lib/module/components/InsightsBar.js +1 -55
  63. package/lib/module/export.js +1 -76
  64. package/lib/module/format.js +1 -108
  65. package/lib/module/hooks/useImageRecords.js +1 -16
  66. package/lib/module/index.js +1 -79
  67. package/lib/module/preset.js +1 -35
  68. package/lib/module/register.js +1 -19
  69. package/lib/module/registerEarly.js +1 -0
  70. package/lib/module/remote.js +1 -36
  71. package/lib/module/state.js +1 -54
  72. package/lib/module/store/imageEventStore.js +1 -221
  73. package/lib/module/store/insights.js +1 -71
  74. package/lib/module/sync/imagesSyncAdapter.js +1 -355
  75. package/lib/module/types.js +0 -1
  76. package/lib/typescript/autoCapture.d.ts +2 -0
  77. package/lib/typescript/autoCapture.web.d.ts +2 -0
  78. package/lib/typescript/capture/actions.d.ts +0 -17
  79. package/lib/typescript/capture/install.web.d.ts +6 -0
  80. package/lib/typescript/capture/installRnImage.d.ts +5 -0
  81. package/lib/typescript/capture/nativeImageModules.d.ts +4 -0
  82. package/lib/typescript/capture/nativeImageModules.web.d.ts +4 -0
  83. package/lib/typescript/capture/rnDecoratorEarly.d.ts +18 -0
  84. package/lib/typescript/capture/savings.web.d.ts +5 -0
  85. package/lib/typescript/components/ImageDetail.d.ts +0 -6
  86. package/lib/typescript/components/ImagesRoot.web.d.ts +2 -0
  87. package/lib/typescript/index.d.ts +1 -1
  88. package/lib/typescript/registerEarly.d.ts +10 -0
  89. package/lib/typescript/sync/imagesSyncAdapter.d.ts +0 -9
  90. package/lib/typescript/types.d.ts +2 -1
  91. package/lib/web/chunks/chunk-TTS5EH4R.mjs +1 -0
  92. package/lib/web/index.mjs +3 -0
  93. package/lib/web/register.mjs +1 -0
  94. package/package.json +52 -6
  95. package/register.js +1 -15
  96. package/lib/commonjs/capture/actions.js.map +0 -1
  97. package/lib/commonjs/capture/install.js.map +0 -1
  98. package/lib/commonjs/capture/installExpoImage.js.map +0 -1
  99. package/lib/commonjs/capture/installRnImage.js.map +0 -1
  100. package/lib/commonjs/capture/overrides.js.map +0 -1
  101. package/lib/commonjs/capture/savings.js.map +0 -1
  102. package/lib/commonjs/capture/shared.js.map +0 -1
  103. package/lib/commonjs/components/ImageDetail.js.map +0 -1
  104. package/lib/commonjs/components/ImageDetailFooter.js.map +0 -1
  105. package/lib/commonjs/components/ImageRow.js.map +0 -1
  106. package/lib/commonjs/components/ImagesHeader.js.map +0 -1
  107. package/lib/commonjs/components/ImagesIcon.js.map +0 -1
  108. package/lib/commonjs/components/ImagesListFooter.js.map +0 -1
  109. package/lib/commonjs/components/ImagesModal.js.map +0 -1
  110. package/lib/commonjs/components/ImagesRoot.js.map +0 -1
  111. package/lib/commonjs/components/InsightsBar.js.map +0 -1
  112. package/lib/commonjs/export.js.map +0 -1
  113. package/lib/commonjs/format.js.map +0 -1
  114. package/lib/commonjs/hooks/useImageRecords.js.map +0 -1
  115. package/lib/commonjs/index.js.map +0 -1
  116. package/lib/commonjs/preset.js.map +0 -1
  117. package/lib/commonjs/register.js.map +0 -1
  118. package/lib/commonjs/remote.js.map +0 -1
  119. package/lib/commonjs/state.js.map +0 -1
  120. package/lib/commonjs/store/imageEventStore.js.map +0 -1
  121. package/lib/commonjs/store/insights.js.map +0 -1
  122. package/lib/commonjs/sync/imagesSyncAdapter.js.map +0 -1
  123. package/lib/commonjs/types.js.map +0 -1
  124. package/lib/module/capture/actions.js.map +0 -1
  125. package/lib/module/capture/install.js.map +0 -1
  126. package/lib/module/capture/installExpoImage.js.map +0 -1
  127. package/lib/module/capture/installRnImage.js.map +0 -1
  128. package/lib/module/capture/overrides.js.map +0 -1
  129. package/lib/module/capture/savings.js.map +0 -1
  130. package/lib/module/capture/shared.js.map +0 -1
  131. package/lib/module/components/ImageDetail.js.map +0 -1
  132. package/lib/module/components/ImageDetailFooter.js.map +0 -1
  133. package/lib/module/components/ImageRow.js.map +0 -1
  134. package/lib/module/components/ImagesHeader.js.map +0 -1
  135. package/lib/module/components/ImagesIcon.js.map +0 -1
  136. package/lib/module/components/ImagesListFooter.js.map +0 -1
  137. package/lib/module/components/ImagesModal.js.map +0 -1
  138. package/lib/module/components/ImagesRoot.js.map +0 -1
  139. package/lib/module/components/InsightsBar.js.map +0 -1
  140. package/lib/module/export.js.map +0 -1
  141. package/lib/module/format.js.map +0 -1
  142. package/lib/module/hooks/useImageRecords.js.map +0 -1
  143. package/lib/module/index.js.map +0 -1
  144. package/lib/module/preset.js.map +0 -1
  145. package/lib/module/register.js.map +0 -1
  146. package/lib/module/remote.js.map +0 -1
  147. package/lib/module/state.js.map +0 -1
  148. package/lib/module/store/imageEventStore.js.map +0 -1
  149. package/lib/module/store/insights.js.map +0 -1
  150. package/lib/module/sync/imagesSyncAdapter.js.map +0 -1
  151. package/lib/module/types.js.map +0 -1
  152. package/lib/typescript/capture/actions.d.ts.map +0 -1
  153. package/lib/typescript/capture/install.d.ts.map +0 -1
  154. package/lib/typescript/capture/installExpoImage.d.ts.map +0 -1
  155. package/lib/typescript/capture/installRnImage.d.ts.map +0 -1
  156. package/lib/typescript/capture/overrides.d.ts.map +0 -1
  157. package/lib/typescript/capture/savings.d.ts.map +0 -1
  158. package/lib/typescript/capture/shared.d.ts.map +0 -1
  159. package/lib/typescript/components/ImageDetail.d.ts.map +0 -1
  160. package/lib/typescript/components/ImageDetailFooter.d.ts.map +0 -1
  161. package/lib/typescript/components/ImageRow.d.ts.map +0 -1
  162. package/lib/typescript/components/ImagesHeader.d.ts.map +0 -1
  163. package/lib/typescript/components/ImagesIcon.d.ts.map +0 -1
  164. package/lib/typescript/components/ImagesListFooter.d.ts.map +0 -1
  165. package/lib/typescript/components/ImagesModal.d.ts.map +0 -1
  166. package/lib/typescript/components/ImagesRoot.d.ts.map +0 -1
  167. package/lib/typescript/components/InsightsBar.d.ts.map +0 -1
  168. package/lib/typescript/export.d.ts.map +0 -1
  169. package/lib/typescript/format.d.ts.map +0 -1
  170. package/lib/typescript/hooks/useImageRecords.d.ts.map +0 -1
  171. package/lib/typescript/index.d.ts.map +0 -1
  172. package/lib/typescript/preset.d.ts.map +0 -1
  173. package/lib/typescript/register.d.ts.map +0 -1
  174. package/lib/typescript/remote.d.ts.map +0 -1
  175. package/lib/typescript/state.d.ts.map +0 -1
  176. package/lib/typescript/store/imageEventStore.d.ts.map +0 -1
  177. package/lib/typescript/store/insights.d.ts.map +0 -1
  178. package/lib/typescript/sync/imagesSyncAdapter.d.ts.map +0 -1
  179. package/lib/typescript/types.d.ts.map +0 -1
@@ -1,94 +1 @@
1
- "use strict";
2
-
3
- /**
4
- * expo-image interception via class-prototype patch.
5
- *
6
- * expo-image's <Image> is a class component (React.PureComponent) whose
7
- * render() reads `this.props`, so wrapping the prototype's render and swapping
8
- * `this.props` for an instrumented copy for the duration of the original
9
- * render is timing-immune (prototype methods are looked up dynamically — no
10
- * import-order race like the RN core decorator). Props are restored in
11
- * `finally`, so PureComponent's shouldComponentUpdate still compares the
12
- * app's real props.
13
- *
14
- * Double-patch safety: install flags live on the globalThis singleton AND a
15
- * marker is stamped on the prototype itself, so even two module instances of
16
- * this package can't wrap render() twice.
17
- *
18
- * expo-image is an optional peer: if it isn't installed, this is a no-op.
19
- */
20
-
21
- import { imagesState } from "../state";
22
- import { registerExpoInstance } from "./actions";
23
- import { applyOverrides } from "./overrides";
24
- import { ImageInstanceTracker, isInternalImage } from "./shared";
25
- const PATCH_MARKER = "__buoyImagesPatched";
26
- const trackers = new WeakMap();
27
- function trackerFor(instance) {
28
- let tracker = trackers.get(instance);
29
- if (!tracker) {
30
- tracker = new ImageInstanceTracker("expo");
31
- trackers.set(instance, tracker);
32
- }
33
- return tracker;
34
- }
35
- export function installExpoImageInterceptor() {
36
- const s = imagesState();
37
- if (s.expoInstalled) return;
38
- s.expoInstalled = true;
39
- let ImageClass;
40
- try {
41
- ImageClass = require("expo-image").Image;
42
- } catch {
43
- s.expoAvailable = false;
44
- return; // expo-image not installed in this app
45
- }
46
- if (!ImageClass?.prototype?.render) {
47
- s.expoAvailable = false;
48
- return;
49
- }
50
- s.expoAvailable = true;
51
- const proto = ImageClass.prototype;
52
- if (proto[PATCH_MARKER]) {
53
- s.expoPatched = true;
54
- return; // already patched by another module instance of this package
55
- }
56
- proto[PATCH_MARKER] = true;
57
- const originalRender = proto.render;
58
- const originalUnmount = proto.componentWillUnmount;
59
- proto.render = function buoyImagesRender() {
60
- const originalProps = this.props;
61
- if (isInternalImage(originalProps?.testID)) {
62
- return originalRender.call(this);
63
- }
64
- const tracker = trackerFor(this);
65
- tracker.syncSource(originalProps?.source);
66
- tracker.noteA11y(Boolean(originalProps?.alt ?? originalProps?.accessibilityLabel));
67
- // Keep the action layer pointed at the live instance (reloadAsync etc.).
68
- registerExpoInstance(tracker.getRecordId(), this);
69
- const wrapped = tracker.handlers(originalProps);
70
- try {
71
- // Simulation layer: global modes + per-record override + locate-flash.
72
- this.props = applyOverrides({
73
- ...originalProps,
74
- ...wrapped
75
- }, tracker.getRecordId(), "expo");
76
- return originalRender.call(this);
77
- } finally {
78
- this.props = originalProps;
79
- }
80
- };
81
- proto.componentWillUnmount = function buoyImagesUnmount() {
82
- trackers.get(this)?.unmount();
83
- originalUnmount?.call(this);
84
- };
85
- s.expoPatched = true;
86
- }
87
- export function expoCaptureStatus() {
88
- const s = imagesState();
89
- return {
90
- available: s.expoAvailable,
91
- patched: s.expoPatched
92
- };
93
- }
94
- //# sourceMappingURL=installExpoImage.js.map
1
+ "use strict";import{imagesState as i}from"../state";import{registerExpoInstance as m}from"./actions";import{applyOverrides as d}from"./overrides";import{ImageInstanceTracker as g,isInternalImage as f}from"./shared";const l="__buoyImagesPatched";const a=new WeakMap;function x(e){let t=a.get(e);if(!t){t=new g("expo");a.set(e,t)}return t}export function installExpoImageInterceptor(){const e=i();if(e.expoInstalled)return;e.expoInstalled=true;let t;try{t=require("expo-image").Image}catch{e.expoAvailable=false;return}if(!t?.prototype?.render){e.expoAvailable=false;return}e.expoAvailable=true;const o=t.prototype;if(o[l]){e.expoPatched=true;return}o[l]=true;const s=o.render;const p=o.componentWillUnmount;o.render=function c(){const r=this.props;if(f(r?.testID)){return s.call(this)}const n=x(this);n.syncSource(r?.source);n.noteA11y(Boolean(r?.alt??r?.accessibilityLabel));m(n.getRecordId(),this);const u=n.handlers(r);try{this.props=d({...r,...u},n.getRecordId(),"expo");return s.call(this)}finally{this.props=r}};o.componentWillUnmount=function c(){a.get(this)?.unmount();p?.call(this)};e.expoPatched=true}export function expoCaptureStatus(){const e=i();return{available:e.expoAvailable,patched:e.expoPatched}}
@@ -1,122 +1 @@
1
- "use strict";
2
-
3
- /**
4
- * RN core <Image> interception via the official injection hook.
5
- *
6
- * `unstable_setImageComponentDecorator` wraps EVERY RN <Image> app-wide — but
7
- * the decorator is latched ONCE, at Image module evaluation
8
- * (`Image.ios.js` / `Image.android.js` read it at module scope). So install
9
- * order matters: this must run before anything touches `Image` from
10
- * 'react-native' — hence the `@buoy-gg/images/register` first-import.
11
- *
12
- * Detection strategy: the decorator sets `decoratorInvoked` when RN's Image
13
- * module applies it. `unstable_registerImageAttachedCallback` is a live Set
14
- * (never latched), so image mounts are always visible — if mounts happen but
15
- * the decorator never ran, we were too late and CaptureStatus reports it.
16
- *
17
- * All flags live on the globalThis singleton (../state.ts) so a second module
18
- * instance of this package neither re-installs nor reports a stale status.
19
- */
20
-
21
- import * as React from "react";
22
- import { imagesState } from "../state";
23
- import { getReloadNonce, getReloadRequest, subscribeActions } from "./actions";
24
- import { applyOverrides, getRenderVersion, patchSourceCache } from "./overrides";
25
- import { ImageInstanceTracker, isInternalImage } from "./shared";
26
- import { jsx as _jsx } from "react/jsx-runtime";
27
- /** Wraps one RN Image render with capture instrumentation + reload actions. */
28
- function useImageCapture(props) {
29
- const trackerRef = React.useRef(null);
30
- if (trackerRef.current == null) {
31
- trackerRef.current = new ImageInstanceTracker("rn");
32
- }
33
- const tracker = trackerRef.current;
34
- const internal = isInternalImage(props.testID);
35
- if (!internal) {
36
- tracker.syncSource(props.source);
37
- tracker.noteA11y(Boolean(props.alt ?? props.accessibilityLabel ?? props["aria-label"]));
38
- }
39
-
40
- // Action/override bus: version bumps re-render just this instance (snapshot
41
- // is per-record with a global floor, so unrelated actions don't invalidate
42
- // other images but global-mode toggles reach everyone).
43
- React.useSyncExternalStore(subscribeActions, () => getRenderVersion(internal ? null : tracker.getRecordId()));
44
- React.useEffect(() => {
45
- if (internal) return undefined;
46
- return () => tracker.unmount();
47
- }, [tracker, internal]);
48
- if (internal) return {
49
- props,
50
- reloadKey: 0
51
- };
52
- const recordId = tracker.getRecordId();
53
- const wrapped = tracker.handlers(props);
54
- const out = {
55
- ...props,
56
- ...wrapped
57
- };
58
-
59
- // While a bust request is pending (cleared when the load settles), refetch
60
- // bypassing caches — VERIFIED both platforms honor source.cache: 'reload'.
61
- const request = getReloadRequest(recordId);
62
- if (request?.bust) {
63
- out.source = patchSourceCache(out.source, "reload");
64
- }
65
- // Simulation layer: global modes + per-record override + locate-flash.
66
- applyOverrides(out, recordId, "rn");
67
- return {
68
- props: out,
69
- reloadKey: getReloadNonce(recordId)
70
- };
71
- }
72
- export function installRnImageInterceptor() {
73
- const s = imagesState();
74
- if (s.rnInstalled) return;
75
- s.rnInstalled = true;
76
- try {
77
- // Deep import: evaluates ONLY the injection module, never Image itself.
78
- const injection = require("react-native/Libraries/Image/ImageInjection");
79
- const setDecorator = injection.unstable_setImageComponentDecorator;
80
- const registerAttached = injection.unstable_registerImageAttachedCallback;
81
- if (typeof setDecorator === "function") {
82
- setDecorator(BaseImage => {
83
- imagesState().decoratorInvoked = true;
84
- const CapturedImage = /*#__PURE__*/React.forwardRef(function BuoyCapturedImage(props, ref) {
85
- const {
86
- props: instrumented,
87
- reloadKey
88
- } = useImageCapture(props);
89
- // key bump forces a native remount → fresh load cycle (retry).
90
- return /*#__PURE__*/_jsx(BaseImage, {
91
- ...instrumented,
92
- ref: ref
93
- }, `buoy-r${reloadKey}`);
94
- });
95
- return CapturedImage;
96
- });
97
- s.decoratorRegistered = true;
98
- }
99
-
100
- // Live mount signal — works regardless of decorator timing. Used purely
101
- // to detect the "decorator registered too late" condition.
102
- if (typeof registerAttached === "function") {
103
- registerAttached(() => {
104
- imagesState().attachSeen++;
105
- });
106
- }
107
- } catch {
108
- // Internal RN path moved (version drift) or non-RN platform — expo-image
109
- // capture still works; status will report the decorator as inactive.
110
- s.decoratorRegistered = false;
111
- }
112
- }
113
- export function rnCaptureStatus() {
114
- const s = imagesState();
115
- return {
116
- decoratorRegistered: s.decoratorRegistered,
117
- decoratorActive: s.decoratorInvoked,
118
- // Mounts observed but our wrapper never rendered → Image latched first.
119
- tooLate: s.decoratorRegistered && !s.decoratorInvoked && s.attachSeen > 0
120
- };
121
- }
122
- //# sourceMappingURL=installRnImage.js.map
1
+ "use strict";import*as c from"react";import{imagesState as s}from"../state";import{getReloadNonce as m,getReloadRequest as g,subscribeActions as I}from"./actions";import{applyOverrides as R,getRenderVersion as y,patchSourceCache as p}from"./overrides";import{ImageInstanceTracker as b,isInternalImage as h}from"./shared";import{jsx as S}from"react/jsx-runtime";export function useImageCapture(e){const o=c.useRef(null);if(o.current==null){o.current=new b("rn")}const t=o.current;const r=h(e.testID);if(!r){t.syncSource(e.source);t.noteA11y(Boolean(e.alt??e.accessibilityLabel??e["aria-label"]))}c.useSyncExternalStore(I,()=>y(r?null:t.getRecordId()));c.useEffect(()=>{if(r)return void 0;return()=>t.unmount()},[t,r]);if(r)return{props:e,reloadKey:0};const n=t.getRecordId();const u=t.handlers(e);const a={...e,...u};const i=g(n);if(i?.bust){a.source=p(a.source,"reload")}R(a,n,"rn");return{props:a,reloadKey:m(n)}}export function installRnImageInterceptor(){const e=s();if(e.rnInstalled)return;e.rnInstalled=true;try{const o=require("react-native/Libraries/Image/ImageInjection");const t=o.unstable_setImageComponentDecorator;const r=o.unstable_registerImageAttachedCallback;if(typeof t==="function"&&!e.decoratorRegistered){t(n=>{s().decoratorInvoked=true;const u=c.forwardRef(function a(i,d){const{props:l,reloadKey:f}=useImageCapture(i);return S(n,{...l,ref:d},`buoy-r${f}`)});return u});e.decoratorRegistered=true}if(typeof r==="function"){r(()=>{s().attachSeen++})}}catch{e.decoratorRegistered=false}}export function rnCaptureStatus(){const e=s();return{decoratorRegistered:e.decoratorRegistered,decoratorActive:e.decoratorInvoked,tooLate:e.decoratorRegistered&&!e.decoratorInvoked&&e.attachSeen>0}}
@@ -0,0 +1 @@
1
+ "use strict";export function loadExpoImage(){try{return require("expo-image")}catch{return null}}export function loadLegacyFileSystem(){try{return require("expo-file-system/legacy")}catch{return null}}export function loadFileSystemModule(){try{return require("expo-file-system")}catch{return null}}
@@ -0,0 +1 @@
1
+ "use strict";export function loadExpoImage(){return null}export function loadLegacyFileSystem(){return null}export function loadFileSystemModule(){return null}
@@ -1,329 +1 @@
1
- "use strict";
2
-
3
- /**
4
- * Simulation overrides — the "we own the props" tier of actions.
5
- *
6
- * Because the RN decorator and the expo-image render patch control every
7
- * mounted image's props, anything the component accepts is a simulation:
8
- * forced errors (instant, offline-safe file:// source), forced loading
9
- * (blackhole-IP source that never resolves), URL swaps, blanking, style
10
- * merges (locate-flash border), and app-wide modes (offline images /
11
- * cold-start / blank images).
12
- *
13
- * Re-render plumbing: every mutation bumps a per-record or global version.
14
- * RN wrappers subscribe via useSyncExternalStore with a per-record snapshot
15
- * (only the touched image re-renders); expo class instances are re-rendered
16
- * directly via forceUpdate() from the per-record instance registry.
17
- */
18
-
19
- import { remoteImagesDispatch } from "../remote";
20
- import { imagesState } from "../state";
21
- import { getRecord, getSnapshot, updateRecord } from "../store/imageEventStore";
22
-
23
- // ---------------------------------------------------------------------------
24
- // Override model
25
- // ---------------------------------------------------------------------------
26
-
27
- const FORCED_ERROR_URI = "file:///buoy-images-forced-error.png";
28
- const HANG_URI = "https://10.255.255.1/buoy-images-hang.png";
29
- /** Offline mode replaces network sources with this (fails immediately). */
30
- const OFFLINE_URI = "file:///buoy-images-offline-no-network.png";
31
- const FLASH_STYLE = {
32
- borderWidth: 3,
33
- borderColor: "#FF453A"
34
- };
35
- /**
36
- * RN core has NO safe "empty source": undefined resolves to the app bundle
37
- * path and [] does too on RN 0.85 — both fire a bogus onError ("The file …
38
- * couldn't be opened", observed live). So RN images blank via opacity
39
- * instead (visual-only; the decoded image stays resident). expo-image
40
- * supports a true `source={null}` and keeps showing its placeholder.
41
- */
42
- const RN_BLANK_STYLE = {
43
- opacity: 0
44
- };
45
- // ---------------------------------------------------------------------------
46
- // Version bus (re-render triggers)
47
- // ---------------------------------------------------------------------------
48
-
49
- function emit() {
50
- for (const l of imagesState().actionListeners) l();
51
- }
52
- function forceUpdateExpo(recordId) {
53
- const s = imagesState();
54
- if (recordId != null) {
55
- const instance = s.expoInstances.get(recordId);
56
- instance?.forceUpdate?.();
57
- return;
58
- }
59
- for (const instance of s.expoInstances.values()) {
60
- instance?.forceUpdate?.();
61
- }
62
- }
63
-
64
- /** Bump one record's render version (re-renders just that image). */
65
- export function touchRecord(recordId) {
66
- const s = imagesState();
67
- s.recordVersions.set(recordId, ++s.versionCounter);
68
- emit();
69
- forceUpdateExpo(recordId);
70
- }
71
-
72
- /** Bump the global render version (re-renders every wrapped image). */
73
- export function touchGlobal() {
74
- const s = imagesState();
75
- s.globalVersion = ++s.versionCounter;
76
- emit();
77
- forceUpdateExpo();
78
- }
79
-
80
- /** Snapshot for the RN wrapper's useSyncExternalStore. */
81
- export function getRenderVersion(recordId) {
82
- const s = imagesState();
83
- const record = recordId != null ? s.recordVersions.get(recordId) ?? 0 : 0;
84
- return Math.max(record, s.globalVersion);
85
- }
86
-
87
- // ---------------------------------------------------------------------------
88
- // Per-record overrides
89
- // ---------------------------------------------------------------------------
90
-
91
- /** Remote param shape for the adapter's `setOverride` action. */
92
- function overrideParams(recordId, source) {
93
- return source.type === "url" ? {
94
- id: recordId,
95
- kind: "url",
96
- uri: source.uri
97
- } : {
98
- id: recordId,
99
- kind: source.type
100
- };
101
- }
102
-
103
- /**
104
- * Local bookkeeping only (no remote forward) — mirrors keep this as an
105
- * optimistic UI update; the next device snapshot is the source of truth.
106
- */
107
- function setOverrideLocal(recordId, override) {
108
- imagesState().overrides.set(recordId, override);
109
- updateRecord(recordId, {
110
- overrideLabel: override.label
111
- });
112
- touchRecord(recordId);
113
- }
114
- export function setOverride(recordId, override) {
115
- if (override.source) {
116
- void remoteImagesDispatch()?.("setOverride", overrideParams(recordId, override.source));
117
- }
118
- setOverrideLocal(recordId, override);
119
- }
120
- function clearOverrideLocal(recordId) {
121
- imagesState().overrides.delete(recordId);
122
- updateRecord(recordId, {
123
- overrideLabel: undefined
124
- });
125
- touchRecord(recordId);
126
- }
127
- export function clearOverride(recordId) {
128
- void remoteImagesDispatch()?.("clearOverride", {
129
- id: recordId
130
- });
131
- clearOverrideLocal(recordId);
132
- }
133
- export function getOverride(recordId) {
134
- if (recordId == null) return undefined;
135
- return imagesState().overrides.get(recordId);
136
- }
137
-
138
- // ---------------------------------------------------------------------------
139
- // Mass actions (every mounted image at once)
140
- // ---------------------------------------------------------------------------
141
-
142
- /** Adapter `massAction` kind for a mass override (per-record 'hang' is mass 'loading'). */
143
- function massKind(source) {
144
- return source.type === "hang" ? "loading" : source.type;
145
- }
146
-
147
- /** Apply one override to every mounted record. Returns how many were hit. */
148
- export function setOverrideForAllMounted(source, label) {
149
- // One mass action on the device, not N per-record forwards.
150
- void remoteImagesDispatch()?.("massAction", {
151
- kind: massKind(source)
152
- });
153
- let count = 0;
154
- for (const record of getSnapshot()) {
155
- if (!record.mounted) continue;
156
- setOverrideLocal(record.id, {
157
- source,
158
- label
159
- });
160
- count++;
161
- }
162
- return count;
163
- }
164
-
165
- /** Remove every active override. Returns how many were cleared. */
166
- export function clearAllOverrides() {
167
- void remoteImagesDispatch()?.("massAction", {
168
- kind: "restore"
169
- });
170
- // Mirrors track labels on records, not the overrides map — clear both.
171
- const ids = new Set(imagesState().overrides.keys());
172
- for (const record of getSnapshot()) {
173
- if (record.overrideLabel != null) ids.add(record.id);
174
- }
175
- for (const id of ids) clearOverrideLocal(id);
176
- return ids.size;
177
- }
178
-
179
- /** Flash every mounted image (locate everything the tool tracks). */
180
- export function flashAllMounted(durationMs = 2500) {
181
- void remoteImagesDispatch()?.("massAction", {
182
- kind: "flash"
183
- });
184
- let count = 0;
185
- for (const record of getSnapshot()) {
186
- if (!record.mounted) continue;
187
- flashRecordLocal(record.id, durationMs);
188
- count++;
189
- }
190
- return count;
191
- }
192
- function flashRecordLocal(recordId, durationMs = 2500) {
193
- const s = imagesState();
194
- s.flashUntil.set(recordId, Date.now() + durationMs);
195
- touchRecord(recordId);
196
- setTimeout(() => {
197
- imagesState().flashUntil.delete(recordId);
198
- touchRecord(recordId);
199
- }, durationMs + 50);
200
- }
201
-
202
- /** Flash a border on the on-screen image so it can be located visually. */
203
- export function flashRecord(recordId, durationMs = 2500) {
204
- void remoteImagesDispatch()?.("flash", {
205
- id: recordId
206
- });
207
- flashRecordLocal(recordId, durationMs);
208
- }
209
-
210
- // ---------------------------------------------------------------------------
211
- // Global simulation modes
212
- // ---------------------------------------------------------------------------
213
-
214
- /**
215
- * offline — every NETWORK image load fails immediately (both libs, cache or
216
- * not); bundled/local assets still load, like a real offline device showing
217
- * shipped images. Blunt on purpose: toggle + reload = images visibly gone.
218
- * (The subtler `only-if-cached` variant was correct-but-confusing, and its
219
- * uncached requests HANG on iOS instead of erroring — bad for QA.)
220
- * cold — every image bypasses caches (RN `cache:'reload'`, expo
221
- * `cachePolicy:'none'`): first-launch behavior without clearing anything.
222
- */
223
- export function setNetworkMode(mode) {
224
- void remoteImagesDispatch()?.("setNetworkMode", {
225
- mode
226
- });
227
- imagesState().globalModes.network = mode;
228
- touchGlobal();
229
- }
230
-
231
- /** Chrome-style "disable images": render every image without a source. */
232
- export function setBlankImages(enabled) {
233
- void remoteImagesDispatch()?.("setBlankImages", {
234
- enabled
235
- });
236
- imagesState().globalModes.blank = enabled;
237
- touchGlobal();
238
- }
239
- export function getGlobalModes() {
240
- return imagesState().globalModes;
241
- }
242
-
243
- // ---------------------------------------------------------------------------
244
- // Application (called from the RN wrapper + expo render patch)
245
- // ---------------------------------------------------------------------------
246
-
247
- /** Inject a `cache` policy into an RN source (object or array shape). */
248
- export function patchSourceCache(source, cache) {
249
- if (Array.isArray(source)) {
250
- return source.map(entry => entry && typeof entry === "object" && typeof entry.uri === "string" ? {
251
- ...entry,
252
- cache
253
- } : entry);
254
- }
255
- if (source && typeof source === "object" && typeof source.uri === "string") {
256
- return {
257
- ...source,
258
- cache
259
- };
260
- }
261
- return source; // numeric assets etc. — nothing to patch
262
- }
263
- function resolveOverrideSource(source, lib) {
264
- switch (source.type) {
265
- case "url":
266
- return {
267
- uri: source.uri
268
- };
269
- case "error":
270
- return {
271
- uri: FORCED_ERROR_URI
272
- };
273
- case "hang":
274
- return {
275
- uri: HANG_URI
276
- };
277
- case "blank":
278
- // Only reached for expo — RN blanking is style-based (see RN_BLANK_STYLE).
279
- return null;
280
- }
281
- }
282
-
283
- /**
284
- * Merge global modes + per-record override + locate-flash into an
285
- * already-copied props object. Mutates and returns `out`.
286
- */
287
- export function applyOverrides(out, recordId, lib) {
288
- const s = imagesState();
289
- const modes = s.globalModes;
290
- if (modes.network === "offline") {
291
- // Hard offline: network sources fail outright (both libs); bundled/local
292
- // assets keep loading like a real offline device.
293
- const record = recordId != null ? getRecord(recordId) : undefined;
294
- if (record?.sourceKind === "network") {
295
- out.source = {
296
- uri: OFFLINE_URI
297
- };
298
- }
299
- } else if (modes.network === "cold") {
300
- if (lib === "rn") {
301
- out.source = patchSourceCache(out.source, "reload");
302
- } else {
303
- out.cachePolicy = "none";
304
- }
305
- }
306
- if (modes.blank) {
307
- if (lib === "expo") out.source = null;else out.style = [out.style, RN_BLANK_STYLE];
308
- }
309
- const override = getOverride(recordId);
310
- if (override) {
311
- if (override.source) {
312
- if (override.source.type === "blank" && lib === "rn") {
313
- out.style = [out.style, RN_BLANK_STYLE];
314
- } else {
315
- out.source = resolveOverrideSource(override.source, lib);
316
- }
317
- }
318
- if (override.extraProps) Object.assign(out, override.extraProps);
319
- if (override.style) out.style = [out.style, override.style];
320
- }
321
- if (recordId != null) {
322
- const until = s.flashUntil.get(recordId);
323
- if (until != null && until > Date.now()) {
324
- out.style = [out.style, FLASH_STYLE];
325
- }
326
- }
327
- return out;
328
- }
329
- //# sourceMappingURL=overrides.js.map
1
+ "use strict";import{remoteImagesDispatch as i}from"../remote";import{imagesState as o}from"../state";import{getRecord as y,getSnapshot as c,updateRecord as a}from"../store/imageEventStore";const x="file:///buoy-images-forced-error.png";const b="https://10.255.255.1/buoy-images-hang.png";const h="file:///buoy-images-offline-no-network.png";const k={borderWidth:3,borderColor:"#FF453A"};const u={opacity:0};function p(){for(const e of o().actionListeners)e()}function d(e){const n=o();if(e!=null){const t=n.expoInstances.get(e);t?.forceUpdate?.();return}for(const t of n.expoInstances.values()){t?.forceUpdate?.()}}export function touchRecord(e){const n=o();n.recordVersions.set(e,++n.versionCounter);p();d(e)}export function touchGlobal(){const e=o();e.globalVersion=++e.versionCounter;p();d()}export function getRenderVersion(e){const n=o();const t=e!=null?n.recordVersions.get(e)??0:0;return Math.max(t,n.globalVersion)}function O(e,n){return n.type==="url"?{id:e,kind:"url",uri:n.uri}:{id:e,kind:n.type}}function g(e,n){o().overrides.set(e,n);a(e,{overrideLabel:n.label});touchRecord(e)}export function setOverride(e,n){if(n.source){void i()?.("setOverride",O(e,n.source))}g(e,n)}function v(e){o().overrides.delete(e);a(e,{overrideLabel:void 0});touchRecord(e)}export function clearOverride(e){void i()?.("clearOverride",{id:e});v(e)}export function getOverride(e){if(e==null)return void 0;return o().overrides.get(e)}function R(e){return e.type==="hang"?"loading":e.type}export function setOverrideForAllMounted(e,n){void i()?.("massAction",{kind:R(e)});let t=0;for(const s of c()){if(!s.mounted)continue;g(s.id,{source:e,label:n});t++}return t}export function clearAllOverrides(){void i()?.("massAction",{kind:"restore"});const e=new Set(o().overrides.keys());for(const n of c()){if(n.overrideLabel!=null)e.add(n.id)}for(const n of e)v(n);return e.size}export function flashAllMounted(e=2500){void i()?.("massAction",{kind:"flash"});let n=0;for(const t of c()){if(!t.mounted)continue;m(t.id,e);n++}return n}function m(e,n=2500){const t=o();t.flashUntil.set(e,Date.now()+n);touchRecord(e);setTimeout(()=>{o().flashUntil.delete(e);touchRecord(e)},n+50)}export function flashRecord(e,n=2500){void i()?.("flash",{id:e});m(e,n)}export function setNetworkMode(e){void i()?.("setNetworkMode",{mode:e});o().globalModes.network=e;touchGlobal()}export function setBlankImages(e){void i()?.("setBlankImages",{enabled:e});o().globalModes.blank=e;touchGlobal()}export function getGlobalModes(){return o().globalModes}export function patchSourceCache(e,n){if(Array.isArray(e)){return e.map(t=>t&&typeof t==="object"&&typeof t.uri==="string"?{...t,cache:n}:t)}if(e&&typeof e==="object"&&typeof e.uri==="string"){return{...e,cache:n}}return e}function A(e,n){switch(e.type){case"url":return{uri:e.uri};case"error":return{uri:x};case"hang":return{uri:b};case"blank":return null}}export function applyOverrides(e,n,t){const s=o();const f=s.globalModes;if(f.network==="offline"){const l=n!=null?y(n):void 0;if(l?.sourceKind==="network"){e.source={uri:h}}}else if(f.network==="cold"){if(t==="rn"){e.source=patchSourceCache(e.source,"reload")}else{e.cachePolicy="none"}}if(f.blank){if(t==="expo")e.source=null;else e.style=[e.style,u]}const r=getOverride(n);if(r){if(r.source){if(r.source.type==="blank"&&t==="rn"){e.style=[e.style,u]}else{e.source=A(r.source,t)}}if(r.extraProps)Object.assign(e,r.extraProps);if(r.style)e.style=[e.style,r.style]}if(n!=null){const l=s.flashUntil.get(n);if(l!=null&&l>Date.now()){e.style=[e.style,k]}}return e}
@@ -0,0 +1 @@
1
+ "use strict";import*as m from"react";import{imagesState as t}from"../state";import{jsx as f}from"react/jsx-runtime";export function installRnImageDecoratorEarly(){const e=t();if(e.decoratorRegistered)return;try{const o=require("react-native/Libraries/Image/ImageInjection");const r=o.unstable_setImageComponentDecorator;if(typeof r!=="function")return;r(a=>{t().decoratorInvoked=true;return m.forwardRef(function g(n,s){const i=require("./installRnImage").useImageCapture;const{props:c,reloadKey:u}=i(n);return f(a,{...c,ref:s},`buoy-r${u}`)})});e.decoratorRegistered=true}catch{}}