@buoy-gg/images 7.0.3

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

@@ -0,0 +1,61 @@
+/**
+ * Capture core shared by the RN <Image> decorator and the expo-image patch.
+ *
+ * ImageInstanceTracker: one per live image component instance. It rolls a new
+ * ImageRecord whenever the instance's source URI changes, and exposes wrapped
+ * event handlers that feed the store while still calling through to whatever
+ * handlers the app passed.
+ */
+import type { ImageLib, SourceKind } from "../types";
+/**
+ * Images rendered by Buoy's own UI (e.g. thumbnails inside the Images modal)
+ * carry this testID prefix and are excluded from capture, so the tool doesn't
+ * pollute its own registry.
+ */
+export declare const INTERNAL_TEST_ID_PREFIX = "buoy-internal";
+export declare function isInternalImage(testID: unknown): boolean;
+/**
+ * React Native's own devtools UI loads images too (LogBox icons resolve to
+ * Metro asset URLs under Libraries/LogBox). They're noise in an app-focused
+ * registry — skip them.
+ */
+export declare function isNoiseUri(uri: string): boolean;
+export declare function classifyUri(uri: string): SourceKind;
+/**
+ * Best-effort URI extraction from any source prop shape (RN or expo-image):
+ * string, number (Metro asset), {uri}, arrays of those, ImageRef.
+ */
+export declare function resolveSourceUri(source: unknown): {
+    uri: string;
+    kind: SourceKind;
+};
+/** The event-handler subset we intercept, normalized across both libraries. */
+export interface OriginalHandlers {
+    onLoadStart?: (event: unknown) => void;
+    onProgress?: (event: unknown) => void;
+    onLoad?: (event: unknown) => void;
+    onError?: (event: unknown) => void;
+    onLoadEnd?: (event: unknown) => void;
+    onDisplay?: (event: unknown) => void;
+    onLayout?: (event: unknown) => void;
+}
+export type WrappedHandlers = Required<Pick<OriginalHandlers, "onLoadStart" | "onProgress" | "onLoad" | "onError" | "onLayout">> & Pick<OriginalHandlers, "onLoadEnd" | "onDisplay">;
+export declare class ImageInstanceTracker {
+    private readonly lib;
+    private recordId;
+    private uri;
+    private handlerCache;
+    constructor(lib: ImageLib);
+    getRecordId(): number | null;
+    /** Record accessibility presence (called per render; writes only on change). */
+    noteA11y(hasAltText: boolean): void;
+    /** Call on every render with the current source prop. Rolls records on change. */
+    syncSource(source: unknown): void;
+    unmount(): void;
+    /**
+     * Wrapped handlers for the current originals. Cached by handler identity so
+     * re-renders with unchanged props reuse the same functions.
+     */
+    handlers(orig: OriginalHandlers): WrappedHandlers;
+}
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/capture/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAgB,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AASnE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAM/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAKnD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;CAClB,CAoCA;AAED,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,CACpC,IAAI,CACF,gBAAgB,EAChB,aAAa,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CACjE,CACF,GACC,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,WAAW,CAAC,CAAC;AAmDpD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAW;IAC/B,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,YAAY,CAAyD;gBAEjE,GAAG,EAAE,QAAQ;IAIzB,WAAW,IAAI,MAAM,GAAG,IAAI;IAI5B,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAQnC,kFAAkF;IAClF,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAcjC,OAAO,IAAI,IAAI;IAOf;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe;CA+KlD"}

package/lib/typescript/components/ImageDetail.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ImageDetail — full record view: preview, source, load timeline, dimensions
+ * with the oversize verdict + estimated decoded/wasted memory, cache verdict,
+ * and error details (including HTTP status/headers when the platform provides
+ * them). Cache actions live here too (expo-image global clears).
+ */
+import type { ImageRecord } from "../types";
+interface ImageDetailProps {
+    record: ImageRecord;
+}
+export declare function ImageDetail({ record }: ImageDetailProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=ImageDetail.d.ts.map

package/lib/typescript/components/ImageDetail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageDetail.d.ts","sourceRoot":"","sources":["../../../src/components/ImageDetail.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,UAAU,gBAAgB;IACxB,MAAM,EAAE,WAAW,CAAC;CACrB;AAwJD,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,gBAAgB,+BAsKvD"}

package/lib/typescript/components/ImageDetailFooter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ImageDetailFooter — bottom navbar for the detail view: previous/next
+ * stepping through the captured list at the edges, per-image actions in the
+ * middle (hard reload / retry), with inline action feedback. Styling matches
+ * shared-ui's EventStepperFooter so it reads like the rest of Buoy.
+ *
+ * Mount with key={record.id} so action feedback resets when stepping.
+ */
+import type { ImageRecord } from "../types";
+interface ImageDetailFooterProps {
+    record: ImageRecord;
+    hasPrevious: boolean;
+    hasNext: boolean;
+    onPrevious: () => void;
+    onNext: () => void;
+}
+export declare function ImageDetailFooter({ record, hasPrevious, hasNext, onPrevious, onNext, }: ImageDetailFooterProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=ImageDetailFooter.d.ts.map

package/lib/typescript/components/ImageDetailFooter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageDetailFooter.d.ts","sourceRoot":"","sources":["../../../src/components/ImageDetailFooter.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,UAAU,sBAAsB;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,WAAW,EACX,OAAO,EACP,UAAU,EACV,MAAM,GACP,EAAE,sBAAsB,+BA4HxB"}

package/lib/typescript/components/ImageRow.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ImageRow — one captured image in the list: thumbnail, filename, library +
+ * cache badges, load time, and the size verdict.
+ *
+ * Thumbnails carry the buoy-internal testID so the capture layer skips them —
+ * the tool must never appear in its own registry.
+ */
+import type { ImageRecord } from "../types";
+interface ImageRowProps {
+    record: ImageRecord;
+    onPress: (id: number) => void;
+}
+export declare function ImageRow({ record, onPress }: ImageRowProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=ImageRow.d.ts.map

package/lib/typescript/components/ImageRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageRow.d.ts","sourceRoot":"","sources":["../../../src/components/ImageRow.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,UAAU,aAAa;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,wBAAgB,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,aAAa,+BA0D1D"}

package/lib/typescript/components/ImagesHeader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ImagesHeader — shared ModalHeader wiring for the Images tool, matching the
+ * Console/Network header pattern. List mode shows aggregate stats, the shared
+ * ToolbarCopyButton (full registry report) and the shared ToolbarClearButton;
+ * detail mode shows back navigation plus the copy button for that record's
+ * report. Copy behavior (Pro gating, hint banner, success/error feedback)
+ * comes from shared-ui — identical to every other tool.
+ */
+import type { ImageStats } from "../types";
+interface ImagesHeaderProps {
+    stats: ImageStats;
+    detailOpen: boolean;
+    /** Index of the open record in the list (-1 when unknown). */
+    detailIndex?: number;
+    detailTotal?: number;
+    onCloseDetail: () => void;
+    onClear: () => void;
+    /** Builds the mode-appropriate report (registry or single record). */
+    getReport: () => string;
+    /** App-stack back (from the floating menu's AppHost). */
+    onBack?: () => void;
+}
+export declare function ImagesHeader({ stats, detailOpen, detailIndex, detailTotal, onCloseDetail, onClear, getReport, onBack, }: ImagesHeaderProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=ImagesHeader.d.ts.map

package/lib/typescript/components/ImagesHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImagesHeader.d.ts","sourceRoot":"","sources":["../../../src/components/ImagesHeader.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,UAAU,iBAAiB;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,sEAAsE;IACtE,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,UAAU,EACV,WAAgB,EAChB,WAAe,EACf,aAAa,EACb,OAAO,EACP,SAAS,EACT,MAAM,GACP,EAAE,iBAAiB,+BAoCnB"}

package/lib/typescript/components/ImagesIcon.d.ts

@@ -0,0 +1,13 @@
+/** Tool accent color (photo violet). */
+export declare const IMAGES_ICON_COLOR = "#C084FC";
+interface ImagesIconProps {
+    size: number;
+    color?: string;
+}
+/**
+ * Dependency-free "picture" glyph: rounded frame with a sun dot and a
+ * mountain-ish baseline, rendered from plain views.
+ */
+export declare function ImagesIcon({ size, color }: ImagesIconProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=ImagesIcon.d.ts.map

package/lib/typescript/components/ImagesIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImagesIcon.d.ts","sourceRoot":"","sources":["../../../src/components/ImagesIcon.tsx"],"names":[],"mappings":"AAEA,wCAAwC;AACxC,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,KAAyB,EAAE,EAAE,eAAe,+BAuC9E"}

package/lib/typescript/components/ImagesListFooter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ImagesListFooter — the list screen's action bar: mass simulations applied
+ * to EVERY mounted image at once (error / loading / blank), mass hard-reload,
+ * flash everything, restore all — plus the global network simulation modes
+ * (Normal / Offline / Cold). Styled to match the detail footer.
+ */
+export declare function ImagesListFooter(): import("react").JSX.Element;
+//# sourceMappingURL=ImagesListFooter.d.ts.map

package/lib/typescript/components/ImagesListFooter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImagesListFooter.d.ts","sourceRoot":"","sources":["../../../src/components/ImagesListFooter.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,wBAAgB,gBAAgB,gCAiF/B"}

package/lib/typescript/components/ImagesModal.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ImagesModal — bottom-sheet wrapper rendered by FloatingDevTools when the
+ * Images tool is opened. List of captured images → tap for detail. Also
+ * surfaces the capture status so a mis-ordered install is self-diagnosing
+ * instead of silently empty.
+ */
+import type { ModalState } from "@buoy-gg/shared-ui";
+interface ImagesModalProps {
+    visible: boolean;
+    onClose: () => void;
+    onBack?: () => void;
+    onMinimize?: (modalState: ModalState) => void;
+    persistenceKey?: string;
+}
+export declare function ImagesModal({ visible, onClose, onBack, onMinimize, persistenceKey, }: ImagesModalProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=ImagesModal.d.ts.map

package/lib/typescript/components/ImagesModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImagesModal.d.ts","sourceRoot":"","sources":["../../../src/components/ImagesModal.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAerD,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAqCD,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,cAAc,GACf,EAAE,gBAAgB,+BAoFlB"}

package/lib/typescript/components/ImagesRoot.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Mount once near the app root to start image capture immediately.
+ *
+ * NOTE: for full RN-core <Image> coverage prefer the side-effect import
+ * `import "@buoy-gg/images/register"` as the first import of your entry file —
+ * the RN decorator must be installed before React Native's Image module first
+ * evaluates. ImagesRoot alone still captures every expo-image instance
+ * (timing-immune) and reports whether the RN hook landed.
+ */
+export declare function ImagesRoot(): null;
+//# sourceMappingURL=ImagesRoot.d.ts.map

package/lib/typescript/components/ImagesRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImagesRoot.d.ts","sourceRoot":"","sources":["../../../src/components/ImagesRoot.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,wBAAgB,UAAU,IAAI,IAAI,CAKjC"}

package/lib/typescript/components/InsightsBar.d.ts

@@ -0,0 +1,13 @@
+/**
+ * InsightsBar — compact warning chips above the list when cross-record
+ * findings exist (duplicates, retry storms, queue saturation, missing alt,
+ * layout shifts). Renders nothing when all clear.
+ *
+ * A wrapping row (not a horizontal ScrollView — that under-measures its
+ * height inside the modal's flex column and clips the chips).
+ */
+import type { ImageInsights } from "../types";
+export declare function InsightsBar({ insights }: {
+    insights: ImageInsights;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=InsightsBar.d.ts.map

package/lib/typescript/components/InsightsBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InsightsBar.d.ts","sourceRoot":"","sources":["../../../src/components/InsightsBar.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,aAAa,CAAA;CAAE,sCAYpE"}

package/lib/typescript/export.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copy-friendly markdown reports — paste-ready context for an issue, PR, or
+ * an AI chat. One for the whole registry (list header copy) and one for a
+ * single record (detail header copy).
+ */
+import type { CaptureStatus, ImageInsights, ImageRecord, ImageStats } from "./types";
+export declare function formatRecordMarkdown(record: ImageRecord): string;
+export declare function formatRegistryMarkdown(records: ImageRecord[], stats: ImageStats, insights: ImageInsights, captureStatus: CaptureStatus, modes: {
+    network: string;
+    blank: boolean;
+}): string;
+//# sourceMappingURL=export.d.ts.map

package/lib/typescript/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/export.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAqChE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,aAAa,EACvB,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACzC,MAAM,CAsCR"}

package/lib/typescript/format.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Formatting + verdict helpers shared by list rows and the detail view.
+ */
+import type { ImageRecord } from "./types";
+export declare function formatBytes(bytes: number): string;
+export declare function formatMs(ms: number | undefined): string;
+/** Last path segment of a URI, for compact row display. */
+export declare function uriTail(uri: string): string;
+export interface SizeVerdict {
+    label: string;
+    color: string;
+    /** Linear factor (2 = twice as wide/tall as needed). */
+    factor: number | null;
+}
+/**
+ * Fresco-style fit verdict: green within 10%, yellow within 50%, red beyond.
+ * Undersized sources (upscaled, likely blurry) get their own callout.
+ */
+export declare function sizeVerdict(record: ImageRecord): SizeVerdict;
+export declare function statusColor(record: ImageRecord): string;
+/** Cache verdict badge text + tint (memory=green, disk=yellow, network=red). */
+export declare function cacheBadge(record: ImageRecord): {
+    label: string;
+    color: string;
+};
+//# sourceMappingURL=format.d.ts.map

package/lib/typescript/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIvD;AAED,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ3C;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAa5D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAWvD;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAYhF"}

package/lib/typescript/hooks/useImageRecords.d.ts

@@ -0,0 +1,11 @@
+/**
+ * React bindings for the image event store.
+ */
+import type { ImageRecord, ImageStats } from "../types";
+export interface UseImageRecordsResult {
+    /** Newest first. */
+    records: ImageRecord[];
+    stats: ImageStats;
+}
+export declare function useImageRecords(): UseImageRecordsResult;
+//# sourceMappingURL=useImageRecords.d.ts.map

package/lib/typescript/hooks/useImageRecords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImageRecords.d.ts","sourceRoot":"","sources":["../../../src/hooks/useImageRecords.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,oBAAoB;IACpB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,wBAAgB,eAAe,IAAI,qBAAqB,CASvD"}

package/lib/typescript/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @buoy-gg/images
+ *
+ * Image debugger for React Native: a live registry of every image the app
+ * loads — RN core <Image> (via the official component-decorator hook) and
+ * expo-image (via a timing-immune class patch) — with cache verdicts
+ * (memory/disk/network), load timings, decoded-vs-displayed oversize checks,
+ * estimated decoded/wasted memory, and a failure log with HTTP details where
+ * the platform provides them.
+ *
+ * Image HTTP traffic never touches the JS network stack, so network devtools
+ * cannot see it — this tool is the visibility layer for images.
+ */
+import "./register";
+export { imagesToolPreset, createImagesTool } from "./preset";
+export { ImagesRoot } from "./components/ImagesRoot";
+export { ImagesModal } from "./components/ImagesModal";
+export { ImagesIcon, IMAGES_ICON_COLOR } from "./components/ImagesIcon";
+export { installImageCapture, getCaptureStatus } from "./capture/install";
+export { hardReloadRecord, retryRecord, evictExpoDiskEntry, } from "./capture/actions";
+export type { ActionResult } from "./capture/actions";
+export { setOverride, clearOverride, getOverride, flashRecord, setNetworkMode, setBlankImages, getGlobalModes, setOverrideForAllMounted, clearAllOverrides, flashAllMounted, } from "./capture/overrides";
+export { hardReloadAllMounted } from "./capture/actions";
+export type { ImageOverride, OverrideSource, NetworkMode } from "./capture/overrides";
+export { proveSavings } from "./capture/savings";
+export type { SavingsResult } from "./capture/savings";
+export { computeInsights, insightChips } from "./store/insights";
+export { formatRecordMarkdown, formatRegistryMarkdown } from "./export";
+export { imagesSyncAdapter } from "./sync/imagesSyncAdapter";
+export { useImageRecords } from "./hooks/useImageRecords";
+export { clearRecords, getSnapshot as getImageRecords, subscribe as subscribeImageRecords, computeStats, oversizeFactor, estDecodedBytes, estWastedBytes, } from "./store/imageEventStore";
+export type { ImageRecord, ImageStats, ImageInsights, ImageLib, ImageStatus, CacheVerdict, SourceKind, CaptureStatus, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,YAAY,CAAC;AAKpB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAK9D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAKxE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAK1E,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKtF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAKxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAK7D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,YAAY,EACZ,WAAW,IAAI,eAAe,EAC9B,SAAS,IAAI,qBAAqB,EAClC,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,yBAAyB,CAAC;AAKjC,YAAY,EACV,WAAW,EACX,UAAU,EACV,aAAa,EACb,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC"}

package/lib/typescript/preset.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Pre-configured Images tool for FloatingDevTools.
+ *
+ * @example
+ * ```tsx
+ * import { imagesToolPreset } from '@buoy-gg/images';
+ *
+ * <FloatingDevTools apps={[imagesToolPreset]} />
+ * ```
+ */
+import { ImagesModal } from "./components/ImagesModal";
+export declare const imagesToolPreset: {
+    id: string;
+    name: string;
+    description: string;
+    slot: "both";
+    icon: ({ size, color }: {
+        size: number;
+        color?: string;
+    }) => import("react").JSX.Element;
+    component: typeof ImagesModal;
+};
+/** Create a custom Images tool configuration. */
+export declare function createImagesTool(options?: {
+    name?: string;
+    description?: string;
+}): {
+    name: string;
+    description: string;
+    id: string;
+    slot: "both";
+    icon: ({ size, color }: {
+        size: number;
+        color?: string;
+    }) => import("react").JSX.Element;
+    component: typeof ImagesModal;
+};
+//# sourceMappingURL=preset.d.ts.map

package/lib/typescript/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/preset.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,eAAO,MAAM,gBAAgB;;;;;4BAKH;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;;CAIzD,CAAC;AAEF,iDAAiD;AACjD,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO;;;;;4BAR7B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;;EAezD"}

package/lib/typescript/register.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Side-effect entry: installs image capture on import.
+ *
+ * Import this FIRST in your app entry file so the RN-core <Image> decorator
+ * lands before React Native's Image module is evaluated:
+ *
+ * ```ts
+ * import "@buoy-gg/images/register";
+ * ```
+ *
+ * This module intentionally imports nothing that touches react-native's Image
+ * (directly or transitively) before installing.
+ */
+export {};
+//# sourceMappingURL=register.d.ts.map

package/lib/typescript/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/lib/typescript/state.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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.
+ */
+import type { ImageRecord } from "./types";
+export interface ImagesGlobalState {
+    records: ImageRecord[];
+    byId: Map<number, ImageRecord>;
+    nextId: number;
+    listeners: Set<() => void>;
+    snapshot: ImageRecord[];
+    emitScheduled: boolean;
+    captureInstalled: boolean;
+    rnInstalled: boolean;
+    expoInstalled: boolean;
+    decoratorRegistered: boolean;
+    decoratorInvoked: boolean;
+    attachSeen: number;
+    expoAvailable: boolean;
+    expoPatched: boolean;
+    /** recordId → pending reload request for the RN wrapper to consume. */
+    reloadRequests: Map<number, {
+        nonce: number;
+        bust: boolean;
+    }>;
+    /** Notified when a reload request is issued (wrappers re-check their nonce). */
+    actionListeners: Set<() => void>;
+    /** recordId → live expo-image class instance (has reloadAsync etc.). */
+    expoInstances: Map<number, unknown>;
+    /** recordId → active override (source swap / forced error / style merge). */
+    overrides: Map<number, unknown>;
+    /** recordId → epoch-ms until which the locate-flash border is shown. */
+    flashUntil: Map<number, number>;
+    /** Per-record render version (bumped by any action touching that record). */
+    recordVersions: Map<number, number>;
+    /** Render version for global-mode changes (affects every image). */
+    globalVersion: number;
+    /** Monotonic counter feeding both version maps. */
+    versionCounter: number;
+    /** App-wide simulation modes. */
+    globalModes: {
+        network: "normal" | "offline" | "cold";
+        blank: boolean;
+    };
+}
+export declare function imagesState(): ImagesGlobalState;
+//# sourceMappingURL=state.d.ts.map

package/lib/typescript/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAEhC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IAEvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IAEvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IAEnB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IAErB,uEAAuE;IACvE,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC9D,gFAAgF;IAChF,eAAe,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IACjC,wEAAwE;IACxE,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpC,6EAA6E;IAC7E,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,wEAAwE;IACxE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,6EAA6E;IAC7E,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,WAAW,EAAE;QAAE,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CACzE;AAID,wBAAgB,WAAW,IAAI,iBAAiB,CA8B/C"}

package/lib/typescript/store/imageEventStore.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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 type { ImageRecord, ImageStats } from "../types";
+export declare function createRecord(partial: Omit<ImageRecord, "id" | "createdAt" | "loadCount" | "mounted" | "status">): ImageRecord;
+/** Mutate a record in place (records are owned by the store) and notify. */
+export declare function updateRecord(id: number, patch: Partial<ImageRecord>): ImageRecord | undefined;
+export declare function getRecord(id: number): ImageRecord | undefined;
+export declare function getSnapshot(): ImageRecord[];
+export declare function subscribe(listener: () => void): () => void;
+export declare function clearRecords(): void;
+/** Physical pixels actually needed to fill the laid-out view 1:1. */
+export declare function neededPixels(record: ImageRecord): {
+    width: number;
+    height: number;
+} | null;
+/**
+ * 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 declare function oversizeFactor(record: ImageRecord): number | null;
+/** Estimated decoded-bitmap memory for a loaded record (RGBA8888). */
+export declare function estDecodedBytes(record: ImageRecord): number;
+/** Decoded bytes beyond what the laid-out size needs (0 if not oversized). */
+export declare function estWastedBytes(record: ImageRecord): number;
+export declare function computeStats(list: ImageRecord[]): ImageStats;
+//# sourceMappingURL=imageEventStore.d.ts.map

package/lib/typescript/store/imageEventStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageEventStore.d.ts","sourceRoot":"","sources":["../../../src/store/imageEventStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAsBxD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC,GAClF,WAAW,CAkBb;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAC1B,WAAW,GAAG,SAAS,CAOzB;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE7D;AAED,wBAAgB,WAAW,IAAI,WAAW,EAAE,CAE3C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAI1D;AAED,wBAAgB,YAAY,IAAI,IAAI,CAQnC;AAMD,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO1F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAOjE;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAG3D;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAQ1D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,UAAU,CAuB5D"}

package/lib/typescript/store/insights.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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.
+ */
+import type { ImageInsights, ImageRecord } from "../types";
+export declare function computeInsights(records: ImageRecord[]): ImageInsights;
+/** Compact one-line chips for UI/MCP surfacing. Empty array = all clear. */
+export declare function insightChips(insights: ImageInsights): string[];
+//# sourceMappingURL=insights.d.ts.map

package/lib/typescript/store/insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../../src/store/insights.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAO3D,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,aAAa,CAiCrE;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CAe9D"}