@flamingo-stack/openframe-frontend-core 0.0.854 → 0.0.856

package/dist/hooks/index.cjs

@@ -61,7 +61,7 @@
 
 
 
-var _chunkUPQ4MAR7cjs = require('../chunk-UPQ4MAR7.cjs');
+var _chunkQZXCUY36cjs = require('../chunk-QZXCUY36.cjs');
 
 
 var _chunk24I6RFVUcjs = require('../chunk-24I6RFVU.cjs');
@@ -70,9 +70,9 @@ var _chunk24I6RFVUcjs = require('../chunk-24I6RFVU.cjs');
 
 
 
-var _chunk5HMENXSRcjs = require('../chunk-5HMENXSR.cjs');
+var _chunkPCQ2HKU3cjs = require('../chunk-PCQ2HKU3.cjs');
 require('../chunk-MZ4KBSH7.cjs');
-require('../chunk-OH5TXFRR.cjs');
+require('../chunk-O4CPT3RK.cjs');
 
 
 
@@ -84,15 +84,15 @@ require('../chunk-OH5TXFRR.cjs');
 
 
 
-var _chunk2IJMHBOKcjs = require('../chunk-2IJMHBOK.cjs');
+var _chunk77GX573Icjs = require('../chunk-77GX573I.cjs');
 
 
 
 
 
 
-var _chunkJKBNK5U6cjs = require('../chunk-JKBNK5U6.cjs');
-require('../chunk-IGVAPIEW.cjs');
+var _chunkD6GEMVHDcjs = require('../chunk-D6GEMVHD.cjs');
+require('../chunk-6C4OR4MZ.cjs');
 require('../chunk-JKX2C3I2.cjs');
 require('../chunk-WWUSFOJ7.cjs');
 require('../chunk-SKI6NKOE.cjs');
@@ -111,7 +111,7 @@ var _chunkBLH2SFOOcjs = require('../chunk-BLH2SFOO.cjs');
 
 
 
-var _chunkQD727QFIcjs = require('../chunk-QD727QFI.cjs');
+var _chunkT54I5ZZYcjs = require('../chunk-T54I5ZZY.cjs');
 
 
 
@@ -119,29 +119,33 @@ var _chunkQD727QFIcjs = require('../chunk-QD727QFI.cjs');
 
 
 
+var _chunkGK577ZLJcjs = require('../chunk-GK577ZLJ.cjs');
 
 
-var _chunk4SSJ3T3Ncjs = require('../chunk-4SSJ3T3N.cjs');
 
+var _chunkEXQSIX2Icjs = require('../chunk-EXQSIX2I.cjs');
 
 
 
-var _chunkYSDB6HGQcjs = require('../chunk-YSDB6HGQ.cjs');
+var _chunkXCQ5I27Zcjs = require('../chunk-XCQ5I27Z.cjs');
 
 
+var _chunkRY7INTYUcjs = require('../chunk-RY7INTYU.cjs');
 
-var _chunkETZFBB7Ocjs = require('../chunk-ETZFBB7O.cjs');
 
 
+var _chunkNTPX5GXIcjs = require('../chunk-NTPX5GXI.cjs');
 
-var _chunkFX35L4Y6cjs = require('../chunk-FX35L4Y6.cjs');
-require('../chunk-KKFDRCQF.cjs');
 
 
 
-var _chunkNTPX5GXIcjs = require('../chunk-NTPX5GXI.cjs');
-require('../chunk-GI3MMBP3.cjs');
-require('../chunk-GG466XFQ.cjs');
+var _chunk6DMH4GXNcjs = require('../chunk-6DMH4GXN.cjs');
+
+
+
+
+
+var _chunkSQ7YHWEPcjs = require('../chunk-SQ7YHWEP.cjs');
 require('../chunk-UJ7AXHRZ.cjs');
 require('../chunk-PMUCEUFQ.cjs');
 require('../chunk-FCZAUK4D.cjs');
@@ -258,4 +262,7 @@ require('../chunk-QDB2JO55.cjs');
 
 
 
-exports.AGENT_IDENTITIES_API_PATH = _chunkFX35L4Y6cjs.AGENT_IDENTITIES_API_PATH; exports.CONTENT_BREAKPOINTS = _chunkQD727QFIcjs.CONTENT_BREAKPOINTS; exports.ContentAreaWidthContext = _chunkQD727QFIcjs.ContentAreaWidthContext; exports.DRAG_AND_DROP_MEDIA_QUERY = _chunk5HMENXSRcjs.DRAG_AND_DROP_MEDIA_QUERY; exports.GraphQLIntrospector = _chunkUPQ4MAR7cjs.GraphQLIntrospector; exports.HOVER_MEDIA_QUERY = _chunkJKBNK5U6cjs.HOVER_MEDIA_QUERY; exports.MEASURE_LAYER_CLASS = _chunkJKBNK5U6cjs.MEASURE_LAYER_CLASS; exports.NEAR_VIEWPORT_ROOT_MARGIN = _chunkNTPX5GXIcjs.NEAR_VIEWPORT_ROOT_MARGIN; exports.PREFERS_REDUCED_MOTION_QUERY = _chunk2IJMHBOKcjs.PREFERS_REDUCED_MOTION_QUERY; exports.ViewportBreakpoints = _chunkQD727QFIcjs.ViewportBreakpoints; exports.batchFetchAuthenticatedImages = _chunkUPQ4MAR7cjs.batchFetchAuthenticatedImages; exports.breakpoints = _chunk4SSJ3T3Ncjs.breakpoints; exports.clearAuthedAssetCache = _chunkYSDB6HGQcjs.clearAuthedAssetCache; exports.clearAuthedImageCache = _chunk4SSJ3T3Ncjs.clearAuthedImageCache; exports.clearVariablesParams = _chunkUPQ4MAR7cjs.clearParams; exports.coerceValue = _chunkUPQ4MAR7cjs.coerceValue; exports.completeFormRescue = _chunkUPQ4MAR7cjs.completeFormRescue; exports.configureAuthenticatedImage = _chunkUPQ4MAR7cjs.configureAuthenticatedImage; exports.configureBatchImageFetch = _chunkUPQ4MAR7cjs.configureBatchImageFetch; exports.contentBreakpointFor = _chunkQD727QFIcjs.contentBreakpointFor; exports.contentStepFor = _chunkQD727QFIcjs.contentStepFor; exports.createSearchParams = _chunkBLH2SFOOcjs.createSearchParams; exports.extractVariablesFromQuery = _chunkUPQ4MAR7cjs.extractVariablesFromQuery; exports.flattenQueryVariables = _chunkUPQ4MAR7cjs.flattenQueryVariables; exports.getArrayParams = _chunkUPQ4MAR7cjs.getArrayParams; exports.getNestedValue = _chunkUPQ4MAR7cjs.getNestedValue; exports.getRequiredParams = _chunkUPQ4MAR7cjs.getRequiredParams; exports.introspector = _chunkUPQ4MAR7cjs.introspector; exports.isInputObjectType = _chunkUPQ4MAR7cjs.isInputObjectType; exports.isScalarType = _chunkUPQ4MAR7cjs.isScalarType; exports.mergeDefaults = _chunkUPQ4MAR7cjs.mergeDefaults; exports.mergeVariables = _chunkUPQ4MAR7cjs.mergeVariables; exports.resetDownloadsStore = _chunkUPQ4MAR7cjs.resetDownloadsStore; exports.resolveActiveSection = _chunkUPQ4MAR7cjs.resolveActiveSection; exports.setNestedValue = _chunkUPQ4MAR7cjs.setNestedValue; exports.shouldIncludeInUrl = _chunkBLH2SFOOcjs.shouldIncludeInUrl; exports.toast = _chunkUPQ4MAR7cjs.toast; exports.urlParamsToVariables = _chunkUPQ4MAR7cjs.urlParamsToVariables; exports.useAccessCodeIntegration = _chunkUPQ4MAR7cjs.useAccessCodeIntegration; exports.useActiveSection = _chunkUPQ4MAR7cjs.useActiveSection; exports.useAgentIdentities = _chunkFX35L4Y6cjs.useAgentIdentities; exports.useApiParams = _chunkUPQ4MAR7cjs.useApiParams; exports.useAuthedAssetSrc = _chunkYSDB6HGQcjs.useAuthedAssetSrc; exports.useAuthedImageSrc = _chunk4SSJ3T3Ncjs.useAuthedImageSrc; exports.useAuthenticatedImage = _chunkUPQ4MAR7cjs.useAuthenticatedImage; exports.useAutoLimitTags = _chunkJKBNK5U6cjs.useAutoLimitTags; exports.useAutoplay = _chunk2IJMHBOKcjs.useAutoplay; exports.useBatchImages = _chunkUPQ4MAR7cjs.useBatchImages; exports.useClaudeMirrorSrc = _chunkUPQ4MAR7cjs.useClaudeMirrorSrc; exports.useClippedLabelTooltip = _chunkJKBNK5U6cjs.useClippedLabelTooltip; exports.useContactSubmission = _chunkUPQ4MAR7cjs.useContactSubmission; exports.useContentBreakpoint = _chunkQD727QFIcjs.useContentBreakpoint; exports.useContentLgUp = _chunkQD727QFIcjs.useContentLgUp; exports.useContentMdUp = _chunkQD727QFIcjs.useContentMdUp; exports.useContentXlUp = _chunkQD727QFIcjs.useContentXlUp; exports.useCopyToClipboard = _chunkUPQ4MAR7cjs.useCopyToClipboard; exports.useCursorPaginationState = _chunkUPQ4MAR7cjs.useCursorPaginationState; exports.useDebounce = _chunk2IJMHBOKcjs.useDebounce; exports.useDeferredError = _chunkUPQ4MAR7cjs.useDeferredError; exports.useDownloads = _chunkUPQ4MAR7cjs.useDownloads; exports.useDragAndDropEnabled = _chunk5HMENXSRcjs.useDragAndDropEnabled; exports.useFocusTrap = _chunkUPQ4MAR7cjs.useFocusTrap; exports.useFormRescue = _chunkUPQ4MAR7cjs.useFormRescue; exports.useHeaderHeight = _chunk24I6RFVUcjs.useHeaderHeight; exports.useHorizontalScrollbar = _chunk5HMENXSRcjs.useHorizontalScrollbar; exports.useHumanitySignals = _chunkUPQ4MAR7cjs.useHumanitySignals; exports.useImageEdgeColor = _chunkETZFBB7Ocjs.useImageEdgeColor; exports.useInView = _chunk2IJMHBOKcjs.useInView; exports.useIsTruncated = _chunk4SSJ3T3Ncjs.useIsTruncated; exports.useIsomorphicLayoutEffect = _chunkYSDB6HGQcjs.useIsomorphicLayoutEffect; exports.useKeyboardCollisionPadding = _chunkJKBNK5U6cjs.useKeyboardCollisionPadding; exports.useLgUp = _chunk4SSJ3T3Ncjs.useLgUp; exports.useLocalStorage = _chunk5HMENXSRcjs.useLocalStorage; exports.useLocationHash = _chunkUPQ4MAR7cjs.useLocationHash; exports.useMarqueeEngine = _chunk2IJMHBOKcjs.useMarqueeEngine; exports.useMdUp = _chunk4SSJ3T3Ncjs.useMdUp; exports.useMediaQuery = _chunk4SSJ3T3Ncjs.useMediaQuery; exports.useMemoizedCallback = _chunkUPQ4MAR7cjs.useMemoizedCallback; exports.useNatsClient = _chunkUPQ4MAR7cjs.useNatsClient; exports.useNavMenus = _chunkUPQ4MAR7cjs.useNavMenus; exports.useNearViewport = _chunkNTPX5GXIcjs.useNearViewport; exports.useNotificationPermission = _chunkUPQ4MAR7cjs.useNotificationPermission; exports.useOgPlaceholderUrl = _chunkETZFBB7Ocjs.useOgPlaceholderUrl; exports.useOnboardingState = _chunkUPQ4MAR7cjs.useOnboardingState; exports.usePlatformByValue = _chunkUPQ4MAR7cjs.usePlatformByValue; exports.usePlatformConfig = _chunkUPQ4MAR7cjs.usePlatformConfig; exports.usePrefersReducedMotion = _chunk2IJMHBOKcjs.usePrefersReducedMotion; exports.usePrefersReducedMotionState = _chunk2IJMHBOKcjs.usePrefersReducedMotionState; exports.usePreventScroll = _chunkUPQ4MAR7cjs.usePreventScroll; exports.useQueryParams = _chunkUPQ4MAR7cjs.useQueryParams; exports.useRescuedForm = _chunkUPQ4MAR7cjs.useRescuedForm; exports.useResetOnPageHidden = _chunk2IJMHBOKcjs.useResetOnPageHidden; exports.useResumableTimeout = _chunkUPQ4MAR7cjs.useResumableTimeout; exports.useScenarioPlayer = _chunkUPQ4MAR7cjs.useScenarioPlayer; exports.useScrollToHash = _chunkUPQ4MAR7cjs.useScrollToHash; exports.useSearch = _chunkUPQ4MAR7cjs.useSearch; exports.useSmUp = _chunk4SSJ3T3Ncjs.useSmUp; exports.useStickyToolbar = _chunkUPQ4MAR7cjs.useStickyToolbar; exports.useSuppressCloneFocus = _chunk2IJMHBOKcjs.useSuppressCloneFocus; exports.useTablePagination = _chunkUPQ4MAR7cjs.useTablePagination; exports.useThrottle = _chunkUPQ4MAR7cjs.useThrottle; exports.useToast = _chunkUPQ4MAR7cjs.useToast; exports.useValidatePlatform = _chunkUPQ4MAR7cjs.useValidatePlatform; exports.useVisitorDesktopDownload = _chunkUPQ4MAR7cjs.useVisitorDesktopDownload; exports.useVisitorOs = _chunk2IJMHBOKcjs.useVisitorOs; exports.useWindowSize = _chunkUPQ4MAR7cjs.useWindowSize; exports.validateSchema = _chunkUPQ4MAR7cjs.validateSchema; exports.validateVariables = _chunkUPQ4MAR7cjs.validateVariables; exports.variablesToUrlParams = _chunkUPQ4MAR7cjs.variablesToUrlParams;
+
+
+
+exports.AGENT_IDENTITIES_API_PATH = _chunkXCQ5I27Zcjs.AGENT_IDENTITIES_API_PATH; exports.CONTENT_BREAKPOINTS = _chunkT54I5ZZYcjs.CONTENT_BREAKPOINTS; exports.ContentAreaWidthContext = _chunkT54I5ZZYcjs.ContentAreaWidthContext; exports.DRAG_AND_DROP_MEDIA_QUERY = _chunkPCQ2HKU3cjs.DRAG_AND_DROP_MEDIA_QUERY; exports.GraphQLIntrospector = _chunkQZXCUY36cjs.GraphQLIntrospector; exports.HOVER_MEDIA_QUERY = _chunkD6GEMVHDcjs.HOVER_MEDIA_QUERY; exports.MEASURE_LAYER_CLASS = _chunkD6GEMVHDcjs.MEASURE_LAYER_CLASS; exports.NEAR_VIEWPORT_ROOT_MARGIN = _chunkNTPX5GXIcjs.NEAR_VIEWPORT_ROOT_MARGIN; exports.PREFERS_REDUCED_MOTION_QUERY = _chunk77GX573Icjs.PREFERS_REDUCED_MOTION_QUERY; exports.ViewportBreakpoints = _chunkT54I5ZZYcjs.ViewportBreakpoints; exports.batchFetchAuthenticatedImages = _chunkQZXCUY36cjs.batchFetchAuthenticatedImages; exports.breakpoints = _chunkGK577ZLJcjs.breakpoints; exports.clearAuthedAssetCache = _chunkSQ7YHWEPcjs.clearAuthedAssetCache; exports.clearAuthedImageCache = _chunk6DMH4GXNcjs.clearAuthedImageCache; exports.clearVariablesParams = _chunkQZXCUY36cjs.clearParams; exports.coerceValue = _chunkQZXCUY36cjs.coerceValue; exports.completeFormRescue = _chunkQZXCUY36cjs.completeFormRescue; exports.configureAuthenticatedImage = _chunkQZXCUY36cjs.configureAuthenticatedImage; exports.configureBatchImageFetch = _chunkQZXCUY36cjs.configureBatchImageFetch; exports.contentBreakpointFor = _chunkT54I5ZZYcjs.contentBreakpointFor; exports.contentStepFor = _chunkT54I5ZZYcjs.contentStepFor; exports.createSearchParams = _chunkBLH2SFOOcjs.createSearchParams; exports.extractVariablesFromQuery = _chunkQZXCUY36cjs.extractVariablesFromQuery; exports.flattenQueryVariables = _chunkQZXCUY36cjs.flattenQueryVariables; exports.getArrayParams = _chunkQZXCUY36cjs.getArrayParams; exports.getNestedValue = _chunkQZXCUY36cjs.getNestedValue; exports.getRequiredParams = _chunkQZXCUY36cjs.getRequiredParams; exports.introspector = _chunkQZXCUY36cjs.introspector; exports.isInputObjectType = _chunkQZXCUY36cjs.isInputObjectType; exports.isScalarType = _chunkQZXCUY36cjs.isScalarType; exports.mergeDefaults = _chunkQZXCUY36cjs.mergeDefaults; exports.mergeVariables = _chunkQZXCUY36cjs.mergeVariables; exports.resetDownloadsStore = _chunkQZXCUY36cjs.resetDownloadsStore; exports.resolveActiveSection = _chunkQZXCUY36cjs.resolveActiveSection; exports.setNestedValue = _chunkQZXCUY36cjs.setNestedValue; exports.shouldIncludeInUrl = _chunkBLH2SFOOcjs.shouldIncludeInUrl; exports.toast = _chunkQZXCUY36cjs.toast; exports.urlParamsToVariables = _chunkQZXCUY36cjs.urlParamsToVariables; exports.useAccessCodeIntegration = _chunkQZXCUY36cjs.useAccessCodeIntegration; exports.useActiveSection = _chunkQZXCUY36cjs.useActiveSection; exports.useAgentIdentities = _chunkXCQ5I27Zcjs.useAgentIdentities; exports.useApiParams = _chunkQZXCUY36cjs.useApiParams; exports.useAuthedAsset = _chunkSQ7YHWEPcjs.useAuthedAsset; exports.useAuthedAssetSrc = _chunkSQ7YHWEPcjs.useAuthedAssetSrc; exports.useAuthedImage = _chunk6DMH4GXNcjs.useAuthedImage; exports.useAuthedImageSrc = _chunk6DMH4GXNcjs.useAuthedImageSrc; exports.useAuthenticatedImage = _chunkQZXCUY36cjs.useAuthenticatedImage; exports.useAutoLimitTags = _chunkD6GEMVHDcjs.useAutoLimitTags; exports.useAutoplay = _chunk77GX573Icjs.useAutoplay; exports.useBatchImages = _chunkQZXCUY36cjs.useBatchImages; exports.useClaudeMirrorSrc = _chunkQZXCUY36cjs.useClaudeMirrorSrc; exports.useClippedLabelTooltip = _chunkD6GEMVHDcjs.useClippedLabelTooltip; exports.useContactSubmission = _chunkQZXCUY36cjs.useContactSubmission; exports.useContentBreakpoint = _chunkT54I5ZZYcjs.useContentBreakpoint; exports.useContentLgUp = _chunkT54I5ZZYcjs.useContentLgUp; exports.useContentMdUp = _chunkT54I5ZZYcjs.useContentMdUp; exports.useContentXlUp = _chunkT54I5ZZYcjs.useContentXlUp; exports.useCopyToClipboard = _chunkQZXCUY36cjs.useCopyToClipboard; exports.useCursorPaginationState = _chunkQZXCUY36cjs.useCursorPaginationState; exports.useDebounce = _chunk77GX573Icjs.useDebounce; exports.useDeferredError = _chunkQZXCUY36cjs.useDeferredError; exports.useDownloads = _chunkQZXCUY36cjs.useDownloads; exports.useDragAndDropEnabled = _chunkPCQ2HKU3cjs.useDragAndDropEnabled; exports.useFocusTrap = _chunkQZXCUY36cjs.useFocusTrap; exports.useFormRescue = _chunkQZXCUY36cjs.useFormRescue; exports.useHeaderHeight = _chunk24I6RFVUcjs.useHeaderHeight; exports.useHorizontalScrollbar = _chunkPCQ2HKU3cjs.useHorizontalScrollbar; exports.useHumanitySignals = _chunkQZXCUY36cjs.useHumanitySignals; exports.useImageEdgeColor = _chunkEXQSIX2Icjs.useImageEdgeColor; exports.useImageFallback = _chunkRY7INTYUcjs.useImageFallback; exports.useInView = _chunk77GX573Icjs.useInView; exports.useIsTruncated = _chunkGK577ZLJcjs.useIsTruncated; exports.useIsomorphicLayoutEffect = _chunkSQ7YHWEPcjs.useIsomorphicLayoutEffect; exports.useKeyboardCollisionPadding = _chunkD6GEMVHDcjs.useKeyboardCollisionPadding; exports.useLgUp = _chunkGK577ZLJcjs.useLgUp; exports.useLocalStorage = _chunkPCQ2HKU3cjs.useLocalStorage; exports.useLocationHash = _chunkQZXCUY36cjs.useLocationHash; exports.useMarqueeEngine = _chunk77GX573Icjs.useMarqueeEngine; exports.useMdUp = _chunkGK577ZLJcjs.useMdUp; exports.useMediaQuery = _chunkGK577ZLJcjs.useMediaQuery; exports.useMemoizedCallback = _chunkQZXCUY36cjs.useMemoizedCallback; exports.useNatsClient = _chunkQZXCUY36cjs.useNatsClient; exports.useNavMenus = _chunkQZXCUY36cjs.useNavMenus; exports.useNearViewport = _chunkNTPX5GXIcjs.useNearViewport; exports.useNotificationPermission = _chunkQZXCUY36cjs.useNotificationPermission; exports.useOgPlaceholderUrl = _chunkEXQSIX2Icjs.useOgPlaceholderUrl; exports.useOnboardingState = _chunkQZXCUY36cjs.useOnboardingState; exports.usePlatformByValue = _chunkQZXCUY36cjs.usePlatformByValue; exports.usePlatformConfig = _chunkQZXCUY36cjs.usePlatformConfig; exports.usePrefersReducedMotion = _chunk77GX573Icjs.usePrefersReducedMotion; exports.usePrefersReducedMotionState = _chunk77GX573Icjs.usePrefersReducedMotionState; exports.usePreventScroll = _chunkQZXCUY36cjs.usePreventScroll; exports.useQueryParams = _chunkQZXCUY36cjs.useQueryParams; exports.useRescuedForm = _chunkQZXCUY36cjs.useRescuedForm; exports.useResetOnPageHidden = _chunk77GX573Icjs.useResetOnPageHidden; exports.useResumableTimeout = _chunkQZXCUY36cjs.useResumableTimeout; exports.useScenarioPlayer = _chunkQZXCUY36cjs.useScenarioPlayer; exports.useScrollToHash = _chunkQZXCUY36cjs.useScrollToHash; exports.useSearch = _chunkQZXCUY36cjs.useSearch; exports.useSmUp = _chunkGK577ZLJcjs.useSmUp; exports.useStickyToolbar = _chunkQZXCUY36cjs.useStickyToolbar; exports.useSuppressCloneFocus = _chunk77GX573Icjs.useSuppressCloneFocus; exports.useTablePagination = _chunkQZXCUY36cjs.useTablePagination; exports.useThrottle = _chunkQZXCUY36cjs.useThrottle; exports.useToast = _chunkQZXCUY36cjs.useToast; exports.useValidatePlatform = _chunkQZXCUY36cjs.useValidatePlatform; exports.useVisitorDesktopDownload = _chunkQZXCUY36cjs.useVisitorDesktopDownload; exports.useVisitorOs = _chunk77GX573Icjs.useVisitorOs; exports.useWindowSize = _chunkQZXCUY36cjs.useWindowSize; exports.validateSchema = _chunkQZXCUY36cjs.validateSchema; exports.validateVariables = _chunkQZXCUY36cjs.validateVariables; exports.variablesToUrlParams = _chunkQZXCUY36cjs.variablesToUrlParams;

package/dist/hooks/index.d.ts

@@ -9,6 +9,7 @@ export * from './use-batch-images';
 export * from './use-authenticated-image';
 export * from './use-authed-asset-src';
 export * from './use-authed-image-src';
+export * from './use-image-fallback';
 export * from './state';
 export * from './nats/use-nats-client';
 export * from './use-near-viewport';

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,SAAS,CAAC;AAGxB,cAAc,wBAAwB,CAAC;AAGvC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,uBAAuB,CAAC;AAMtC,cAAc,+BAA+B,CAAC;AAG9C,cAAc,0BAA0B,CAAC;AAIzC,cAAc,yBAAyB,CAAC;AAKxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAIrC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,SAAS,CAAC;AAGxB,cAAc,wBAAwB,CAAC;AAGvC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,uBAAuB,CAAC;AAMtC,cAAc,+BAA+B,CAAC;AAG9C,cAAc,0BAA0B,CAAC;AAIzC,cAAc,yBAAyB,CAAC;AAKxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAIrC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/dist/hooks/index.js

@@ -9,6 +9,7 @@ export * from "./use-batch-images.js";
 export * from "./use-authenticated-image.js";
 export * from "./use-authed-asset-src.js";
 export * from "./use-authed-image-src.js";
+export * from "./use-image-fallback.js";
 export * from "./state/index.js";
 export * from "./nats/use-nats-client.js";
 export * from "./use-near-viewport.js";

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

@@ -1,9 +1,82 @@
+/**
+ * Resolve ANY asset URL the browser would load natively — `<img src>`,
+ * `<track src>`, a font, a poster — on every host:
+ *
+ *   1. The host's `resolveAssetUrl` says where the URL lives, so a backend path
+ *      the page's origin does not serve is drawn from the gateway.
+ *   2. Where auth rides in request HEADERS instead of cookies (native shells,
+ *      `capacitor://` / `tauri://`, and dev-ticket web, both in bearer mode), a
+ *      native subresource load can't carry the `Authorization` header and gets
+ *      a 401. Such a URL is fetched through `embedAuthedFetch` (bearer + deduped
+ *      401-refresh-retry + the adapter's cross-origin guard) and drawn from a
+ *      blob object-URL. Every other URL is drawn as it stands, so on the
+ *      cookie-auth web this is a pass-through.
+ *
+ * The state lives in ONE module store read through `useSyncExternalStore`, so
+ * every mounted consumer follows it, memoized or not:
+ *
+ *   - A shell renders before its tokens arrive. A gateway URL is then `pending`
+ *     (nothing is drawn, nothing is requested) and is fetched as soon as the
+ *     adapter reports a credential (`subscribeEmbedCredentialChange`), a new
+ *     adapter registers, or a consumer renders and finds one. It used to be
+ *     handed to a native `<img>` at that first render, which got a 401 and was
+ *     never asked again.
+ *   - `failed` is its own state, so a caller can show its fallback at once, and
+ *     it stays `failed` while a retry runs. What is retried, and when:
+ *       - no answer at all (offline, a refused redirect): on the next credential
+ *         and when the browser comes back online;
+ *       - a 401 that `embedAuthedFetch` could not refresh its way past (no new
+ *         credential came of it): on the next credential;
+ *       - anything else, including a 401 to the retry `embedAuthedFetch` sent
+ *         with a credential it had just refreshed (`answeredAfterRefresh`): only
+ *         when a consumer mounts again after every one let go. A new credential
+ *         cannot lift that refusal, and retrying it on each rotation would rotate
+ *         again: two such pictures would keep rotating the session between them.
+ *   - `clearAuthedAssetCache` (session end) drops every blob; consumers still
+ *     mounted go back to `pending` and fetch again with whatever credential the
+ *     host holds when one next asks (see there).
+ *   - A 2xx `text/html` answer is a failure, not a picture: a native shell's
+ *     asset server answers an unknown path with its SPA page.
+ *
+ * Reading the state through the store also keeps it correct under the React
+ * Compiler: a module map read during render is memoized on its key, so a hook
+ * that read `cache.get(src)` there would keep the `undefined` it saw before the
+ * fetch finished.
+ *
+ * Cache: keyed by the resolved URL, so the same avatar in twenty rows costs one
+ * request. Gateway URLs carry a `?v=<content-hash>` cache-buster, so changed
+ * content is a new key. Entries are reference-counted by the mounted consumers
+ * and revoked RELEASE_DELAY_MS after the last one unmounts (a remount inside
+ * that window keeps the blob): in a desktop shell open for days, every distinct
+ * picture ever shown would otherwise stay in memory.
+ */
+/** What a consumer draws, and why. */
+export type AuthedAssetStatus = 
+/** Draw `src` as it stands: the browser loads it itself. */
+'native'
+/** Nothing to draw yet: waiting for a credential, or the first authed fetch is in flight. */
+ | 'pending'
+/** `src` is the fetched blob. */
+ | 'ready'
+/** The authed fetch failed (a retry may be running); `url` is what was asked for. */
+ | 'failed';
+export interface AuthedAsset {
+    /** What to draw: the URL (`native`), its blob (`ready`), or nothing (`pending`, `failed`, or no URL given). */
+    readonly src: string | undefined;
+    /** The URL after the host's `resolveAssetUrl`; `undefined` when none was given. */
+    readonly url: string | undefined;
+    readonly status: AuthedAssetStatus;
+}
 /**
  * Drop every cached blob and revoke its object URL. Hosts call this at
  * session end (logout / forced re-login) so a follow-on login as a
  * different identity cannot be served blobs fetched under the previous
- * one's bearer. Fetches still in flight when the clear happens are fenced
- * by a generation counter — their results are revoked instead of cached.
+ * one's bearer. Fetches still in flight are fenced by a generation counter
+ * (their results are revoked instead of cached). Consumers still mounted go
+ * back to `pending`; the clear itself starts no fetch, so a host may clear
+ * just before it drops its credential, in the same task. A consumer that
+ * looks again later (a credential change, a mount, a render) fetches with
+ * whatever credential the host holds then.
  */
 export declare function clearAuthedAssetCache(): void;
 /**
@@ -12,5 +85,7 @@ export declare function clearAuthedAssetCache(): void;
  *               consumer renders (`image/*`, `text/vtt`); it also replaces
  *               `embedAuthedFetch`'s default JSON `Content-Type` on the GET.
  */
+export declare function useAuthedAsset(src?: string | null, accept?: string): AuthedAsset;
+/** `useAuthedAsset`'s `src`: what to draw, `undefined` while there is nothing to draw. */
 export declare function useAuthedAssetSrc(src?: string | null, accept?: string): string | undefined;
 //# sourceMappingURL=use-authed-asset-src.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-authed-asset-src.d.ts","sourceRoot":"","sources":["../../src/hooks/use-authed-asset-src.ts"],"names":[],"mappings":"AA0EA;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAO5C;AA0BD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,SAAQ,GAAG,MAAM,GAAG,SAAS,CA6BzF"}
+{"version":3,"file":"use-authed-asset-src.d.ts","sourceRoot":"","sources":["../../src/hooks/use-authed-asset-src.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,sCAAsC;AACtC,MAAM,MAAM,iBAAiB;AAC3B,4DAA4D;AAC1D,QAAQ;AACV,6FAA6F;GAC3F,SAAS;AACX,iCAAiC;GAC/B,OAAO;AACT,qFAAqF;GACnF,QAAQ,CAAC;AAEb,MAAM,WAAW,WAAW;IAC1B,+GAA+G;IAC/G,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AA8LD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAU5C;AA+BD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,SAAQ,GAAG,WAAW,CA6B/E;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,SAAQ,GAAG,MAAM,GAAG,SAAS,CAEzF"}

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

@@ -1,92 +1,204 @@
 "use client";
-import { useEffect, useReducer } from "react";
-import { embedAuthedFetch, needsBearerAssetFetch } from "../utils/embed-authed-fetch.js";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+import { useEffect, useSyncExternalStore } from "react";
+import { subscribeRegisteredAdapter } from "../utils/embed-auth-adapter-registry.js";
+import {
+  answeredAfterRefresh,
+  assetLoadMode,
+  embedAuthedFetch,
+  resolveAssetUrl,
+  subscribeEmbedCredentialChange
+} from "../utils/embed-authed-fetch.js";
 import { useIsomorphicLayoutEffect } from "./ui/use-isomorphic-layout-effect.js";
-const resolvedCache = /* @__PURE__ */ new Map();
-const inFlight = /* @__PURE__ */ new Map();
-let cacheGeneration = 0;
 const RELEASE_DELAY_MS = 6e4;
-const refCounts = /* @__PURE__ */ new Map();
-const releaseTimers = /* @__PURE__ */ new Map();
-function scheduleRelease(src) {
-  clearTimeout(releaseTimers.get(src));
-  releaseTimers.set(
-    src,
-    setTimeout(() => {
-      releaseTimers.delete(src);
-      if (refCounts.has(src)) return;
-      const blobUrl = resolvedCache.get(src);
-      if (blobUrl) URL.revokeObjectURL(blobUrl);
-      resolvedCache.delete(src);
-    }, RELEASE_DELAY_MS)
+const IDLE = { status: "idle" };
+class AssetResponseError extends Error {
+  constructor(response) {
+    super(`asset fetch failed: ${response.status}`);
+    __publicField(this, "status");
+    __publicField(this, "afterRefresh");
+    this.status = response.status;
+    this.afterRefresh = answeredAfterRefresh(response);
+  }
+}
+const entries = /* @__PURE__ */ new Map();
+const listeners = /* @__PURE__ */ new Set();
+let cacheGeneration = 0;
+let notifyScheduled = false;
+let detachSources = null;
+function notify() {
+  if (notifyScheduled) return;
+  notifyScheduled = true;
+  queueMicrotask(() => {
+    notifyScheduled = false;
+    for (const listener of [...listeners]) listener();
+  });
+}
+function settle(url, entry, generation, state) {
+  const current = entries.get(url);
+  if (generation !== cacheGeneration || current !== entry) return false;
+  current.state = state;
+  notify();
+  return true;
+}
+function due(state, trigger) {
+  if (state.status === "idle") return true;
+  if (state.status !== "failed") return false;
+  switch (trigger) {
+    case "mount":
+      return true;
+    case "credential":
+      return state.retryOn !== "remount";
+    case "online":
+      return state.retryOn === "credential-or-online";
+    default:
+      return false;
+  }
+}
+function retryOnFor(error) {
+  if (error instanceof TypeError) return "credential-or-online";
+  if (error instanceof AssetResponseError && error.status === 401 && !error.afterRefresh) return "credential";
+  return "remount";
+}
+function kick(url, trigger) {
+  const entry = entries.get(url);
+  if (!entry || !due(entry.state, trigger) || assetLoadMode(url) !== "bearer") return;
+  const generation = cacheGeneration;
+  settle(url, entry, generation, { status: "loading", afterFailure: entry.state.status === "failed" });
+  Promise.resolve().then(() => embedAuthedFetch(url, { headers: { Accept: entry.accept } })).then(async (response) => {
+    if (!response.ok || /^\s*text\/html\b/i.test(response.headers.get("Content-Type") ?? "")) {
+      throw new AssetResponseError(response);
+    }
+    return URL.createObjectURL(await response.blob());
+  }).then(
+    (blobUrl) => {
+      if (!settle(url, entry, generation, { status: "ready", blobUrl })) URL.revokeObjectURL(blobUrl);
+    },
+    (error) => {
+      settle(url, entry, generation, { status: "failed", retryOn: retryOnFor(error) });
+    }
   );
 }
-function acquire(src) {
-  clearTimeout(releaseTimers.get(src));
-  releaseTimers.delete(src);
-  refCounts.set(src, (refCounts.get(src) ?? 0) + 1);
+function sweep(trigger) {
+  for (const [url, entry] of entries) if (entry.refs > 0) kick(url, trigger);
+  notify();
+}
+function onCredentialChange() {
+  sweep("credential");
+}
+function onOnline() {
+  sweep("online");
+}
+function attachSources() {
+  let detachCredential = subscribeEmbedCredentialChange(onCredentialChange);
+  const detachAdapter = subscribeRegisteredAdapter(() => {
+    detachCredential();
+    detachCredential = subscribeEmbedCredentialChange(onCredentialChange);
+    onCredentialChange();
+  });
+  window.addEventListener("online", onOnline);
+  return () => {
+    detachCredential();
+    detachAdapter();
+    window.removeEventListener("online", onOnline);
+  };
 }
-function release(src) {
-  const remaining = (refCounts.get(src) ?? 1) - 1;
-  if (remaining > 0) {
-    refCounts.set(src, remaining);
-    return;
+function subscribeNothing() {
+  return () => {
+  };
+}
+function subscribe(listener) {
+  listeners.add(listener);
+  detachSources ?? (detachSources = attachSources());
+  return () => {
+    listeners.delete(listener);
+    if (listeners.size === 0 && detachSources) {
+      detachSources();
+      detachSources = null;
+    }
+  };
+}
+function acquire(url, accept) {
+  let entry = entries.get(url);
+  if (!entry) {
+    entry = { state: IDLE, accept, refs: 0, releaseTimer: void 0 };
+    entries.set(url, entry);
   }
-  refCounts.delete(src);
-  scheduleRelease(src);
+  clearTimeout(entry.releaseTimer);
+  entry.releaseTimer = void 0;
+  entry.refs++;
+  kick(url, entry.refs === 1 ? "mount" : "join");
+}
+function release(url) {
+  const entry = entries.get(url);
+  if (!entry) return;
+  entry.refs = Math.max(0, entry.refs - 1);
+  if (entry.refs > 0) return;
+  clearTimeout(entry.releaseTimer);
+  entry.releaseTimer = setTimeout(() => {
+    if (entries.get(url) !== entry || entry.refs > 0) return;
+    if (entry.state.status === "ready") URL.revokeObjectURL(entry.state.blobUrl);
+    entries.delete(url);
+  }, RELEASE_DELAY_MS);
 }
 function clearAuthedAssetCache() {
   cacheGeneration++;
-  for (const url of resolvedCache.values()) URL.revokeObjectURL(url);
-  resolvedCache.clear();
-  inFlight.clear();
-  for (const timer of releaseTimers.values()) clearTimeout(timer);
-  releaseTimers.clear();
-}
-function fetchAsBlobUrl(src, accept) {
-  let pending = inFlight.get(src);
-  if (!pending) {
-    const startedGeneration = cacheGeneration;
-    pending = embedAuthedFetch(src, { headers: { Accept: accept } }).then(async (response) => {
-      if (!response.ok) throw new Error(`asset fetch failed: ${response.status}`);
-      const blobUrl = URL.createObjectURL(await response.blob());
-      if (startedGeneration === cacheGeneration) {
-        resolvedCache.set(src, blobUrl);
-        if (!refCounts.has(src)) scheduleRelease(src);
-      } else {
-        URL.revokeObjectURL(blobUrl);
-      }
-    }).finally(() => {
-      if (inFlight.get(src) === pending) inFlight.delete(src);
-    });
-    inFlight.set(src, pending);
+  for (const [url, entry] of entries) {
+    if (entry.state.status === "ready") URL.revokeObjectURL(entry.state.blobUrl);
+    clearTimeout(entry.releaseTimer);
+    entry.releaseTimer = void 0;
+    if (entry.refs > 0) entry.state = IDLE;
+    else entries.delete(url);
   }
-  return pending;
+  notify();
 }
-function useAuthedAssetSrc(src, accept = "*/*") {
-  const bearerSrc = src && needsBearerAssetFetch(src) ? src : null;
-  const [, rerender] = useReducer((c) => c + 1, 0);
+const NO_ASSET = Object.freeze({ src: void 0, url: void 0, status: "native" });
+function readAsset(src) {
+  if (!src) return NO_ASSET;
+  const url = resolveAssetUrl(src);
+  const mode = assetLoadMode(url);
+  if (mode === "native") return { src: url, url, status: "native" };
+  const state = mode === "bearer" ? entries.get(url)?.state : void 0;
+  if (state?.status === "ready") return { src: state.blobUrl, url, status: "ready" };
+  if (state?.status === "failed" || state?.status === "loading" && state.afterFailure) {
+    return { src: void 0, url, status: "failed" };
+  }
+  return { src: void 0, url, status: "pending" };
+}
+function encode(asset) {
+  return JSON.stringify([asset.status, asset.url ?? null, asset.src ?? null]);
+}
+function decode(snapshot) {
+  const [status, url, src] = JSON.parse(snapshot);
+  return { status, url: url ?? void 0, src: src ?? void 0 };
+}
+function useAuthedAsset(src, accept = "*/*") {
+  const snapshot = useSyncExternalStore(
+    src ? subscribe : subscribeNothing,
+    () => encode(readAsset(src)),
+    // The server has no adapter: it draws the URL as given, and the client takes over after hydration.
+    () => encode(src ? { src, url: src, status: "native" } : NO_ASSET)
+  );
+  const asset = decode(snapshot);
+  const tracked = asset.status === "native" ? void 0 : asset.url;
   useIsomorphicLayoutEffect(() => {
-    if (!bearerSrc) return void 0;
-    acquire(bearerSrc);
-    return () => release(bearerSrc);
-  }, [bearerSrc]);
+    if (!tracked) return void 0;
+    acquire(tracked, accept);
+    return () => release(tracked);
+  }, [tracked, accept]);
+  const waiting = tracked !== void 0 && asset.status === "pending";
   useEffect(() => {
-    if (!bearerSrc || resolvedCache.has(bearerSrc)) return void 0;
-    let cancelled = false;
-    fetchAsBlobUrl(bearerSrc, accept).catch(() => {
-    }).finally(() => {
-      if (!cancelled) rerender();
-    });
-    return () => {
-      cancelled = true;
-    };
-  }, [bearerSrc, accept]);
-  if (!src) return void 0;
-  if (!bearerSrc) return src;
-  return resolvedCache.get(bearerSrc);
+    if (waiting) kick(tracked, "join");
+  });
+  return asset;
+}
+function useAuthedAssetSrc(src, accept = "*/*") {
+  return useAuthedAsset(src, accept).src;
 }
 export {
   clearAuthedAssetCache,
+  useAuthedAsset,
   useAuthedAssetSrc
 };

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
+};