@flamingo-stack/openframe-frontend-core 0.0.853 → 0.0.855

package/dist/hooks/use-authed-image-src.d.ts

@@ -1,14 +1,21 @@
-import { clearAuthedAssetCache } from './use-authed-asset-src';
+import { type AuthedAsset, clearAuthedAssetCache } from './use-authed-asset-src';
 /**
- * Image flavor of `useAuthedAssetSrc` — see that hook for the full contract.
- * Kept as its own export because it is the lib's most-used consumer (avatars,
- * entity images, markdown `<img>`) and because hosts already import this name.
+ * Image flavor of `useAuthedAsset` — see that hook for the full contract. The
+ * one place a picture's `Accept` is stated: a store entry keeps the `Accept` of
+ * whichever consumer acquired it first, so the boxed `Image` and every picture
+ * component around it must ask the same.
  *
  * Distinct from the legacy `useAuthenticatedImage`, which ALWAYS blob-fetches
  * with `credentials: 'include'` and its own global config. This hook is
  * pass-through-first and keys off the single auth knob the lib already has:
  * the registered `EmbedAuthAdapter`.
  */
+export declare function useAuthedImage(src?: string | null): AuthedAsset;
+/**
+ * `useAuthedImage`'s `src`. Kept as its own export because it is the lib's
+ * most-used consumer (avatars, entity images, markdown `<img>`) and because
+ * hosts already import this name.
+ */
 export declare function useAuthedImageSrc(src?: string | null): string | undefined;
 /**
  * Session-end cache drop. Now an alias of `clearAuthedAssetCache` — one cache

package/dist/hooks/use-authed-image-src.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-authed-image-src.d.ts","sourceRoot":"","sources":["../../src/hooks/use-authed-image-src.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAqB,MAAM,wBAAwB,CAAC;AAElF;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAEzE;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,8BAAwB,CAAC"}
+{"version":3,"file":"use-authed-image-src.d.ts","sourceRoot":"","sources":["../../src/hooks/use-authed-image-src.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAAE,qBAAqB,EAAkB,MAAM,wBAAwB,CAAC;AAEjG;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAEzE;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,8BAAwB,CAAC"}

package/dist/hooks/use-authed-image-src.js

@@ -1,10 +1,14 @@
 "use client";
-import { clearAuthedAssetCache, useAuthedAssetSrc } from "./use-authed-asset-src.js";
+import { clearAuthedAssetCache, useAuthedAsset } from "./use-authed-asset-src.js";
+function useAuthedImage(src) {
+  return useAuthedAsset(src, "image/*");
+}
 function useAuthedImageSrc(src) {
-  return useAuthedAssetSrc(src, "image/*");
+  return useAuthedImage(src).src;
 }
 const clearAuthedImageCache = clearAuthedAssetCache;
 export {
   clearAuthedImageCache,
+  useAuthedImage,
   useAuthedImageSrc
 };

package/dist/hooks/use-image-fallback.d.ts

@@ -0,0 +1,16 @@
+export interface ImageFallback {
+    /** The first candidate that has not failed, else null: draw your own fallback (initials, a placeholder, nothing). */
+    src: string | null;
+    /** Wire to the picture's `onError`. */
+    onError: () => void;
+}
+/**
+ * A picture's fallback chain, keyed by URL: how a component falls back from a picture that did not load
+ * (`SquareAvatar`, `EntityImage`, `ChatMessageRow`, the entity cards' covers). State is the SET of URLs that failed
+ * and `src` is derived, so a new URL is simply not one of them: the picture comes back with no reset effect, and a
+ * URL that failed once is not retried in a loop. Never hide the element or reveal a fallback by writing to the DOM
+ * in `onError` instead (the legacy `hideOnError`): React does not undo the write, so the fallback outlives the URL
+ * it was about.
+ */
+export declare function useImageFallback(...candidates: (string | null | undefined)[]): ImageFallback;
+//# sourceMappingURL=use-image-fallback.d.ts.map

package/dist/hooks/use-image-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-image-fallback.d.ts","sourceRoot":"","sources":["../../src/hooks/use-image-fallback.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,qHAAqH;IACrH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,UAAU,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,aAAa,CAW5F"}

package/dist/hooks/use-image-fallback.js

@@ -0,0 +1,14 @@
+"use client";
+import { useCallback, useState } from "react";
+function useImageFallback(...candidates) {
+  const [failed, setFailed] = useState(() => /* @__PURE__ */ new Set());
+  const src = candidates.find((candidate) => !!candidate && !failed.has(candidate)) ?? null;
+  const onError = useCallback(() => {
+    if (!src) return;
+    setFailed((prev) => new Set(prev).add(src));
+  }, [src]);
+  return { src, onError };
+}
+export {
+  useImageFallback
+};