@wyxos/vibe 5.8.0 → 5.8.1

package/README.md

@@ -99,6 +99,7 @@ const vibe = createVibe({
     height: 48,
   },
   mediaCard: {
+    feedPreload: 'replacement',
     videoMuted: true,
   },
 })
@@ -121,6 +122,10 @@ active again. Set `mediaCard.videoMuted` to explicitly override the initial
 state in either layout. Users can still change mute and volume through the
 timed-media controls.
 
+Set `mediaCard.feedPreload` to `replacement` to warm the exact preview source
+that a grouped masonry card will show after its current media item is removed.
+The default is `none`, so consumers opt in to the additional request.
+
 Applications that need audio continuity can pass `initialReelAudioState` with
 `volume`, `muted`, and `lastAudibleVolume`, then persist user changes through
 `onReelAudioStateChange`. Every reel card in that Vibe instance shares the

package/lib/components/useFeedReplacementPreload.d.ts

@@ -0,0 +1,11 @@
+import type { VibeItem, VibeLayout, VibeMediaCardOptions, VibeMediaSource } from '../types';
+interface FeedReplacementPreloadOptions {
+    item: () => VibeItem;
+    layout: () => VibeLayout;
+    mediaCard: () => VibeMediaCardOptions | undefined;
+    mediaIndex: () => number;
+    mediaReady: () => boolean;
+    mediaSource: () => VibeMediaSource;
+}
+export declare function useFeedReplacementPreload(options: FeedReplacementPreloadOptions): void;
+export {};

package/lib/components/useMediaLoading.d.ts

@@ -11,6 +11,6 @@ interface MediaLoadingOptions {
 export declare function useMediaLoading(options: MediaLoadingOptions): {
     imageLoading: import("vue").ComputedRef<"lazy" | "eager">;
     mediaIsTimed: import("vue").ComputedRef<boolean>;
-    videoPreload: import("vue").ComputedRef<"metadata" | "auto" | "none">;
+    videoPreload: import("vue").ComputedRef<"none" | "metadata" | "auto">;
 };
 export {};

package/lib/core/feedReplacementPreload.d.ts

@@ -0,0 +1,3 @@
+import type { VibeItem, VibeMediaSource, VibeMediaVariant } from '../types';
+export declare function replacementFeedVariant(item: VibeItem, mediaIndex: number, mediaSource: VibeMediaSource): VibeMediaVariant | null;
+export declare function preloadFeedVariant(variant: VibeMediaVariant): () => void;

package/lib/core/mediaCardOptions.d.ts

@@ -6,6 +6,7 @@ export interface VibeCardChromeStyle {
 }
 export interface VibeMediaCardOptions {
     error?: VibeMediaError;
+    feedPreload?: 'none' | 'replacement';
     footer?: VibeCardChromeStyle;
     header?: VibeCardChromeStyle;
     videoMuted?: boolean;