@wyxos/vibe 5.8.1 → 5.8.3

package/README.md

@@ -99,7 +99,7 @@ const vibe = createVibe({
     height: 48,
   },
   mediaCard: {
-    feedPreload: 'replacement',
+    feedPreload: 'visible-post',
     videoMuted: true,
   },
 })
@@ -122,9 +122,11 @@ 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.
+Set `mediaCard.feedPreload` to `'visible-post'` to warm every other preview in
+a grouped masonry card after its visible media is ready. Only cards in the
+exact viewport qualify: images are fetched at low priority and decoded, while
+video or audio sources load metadata without preloading their full bodies.
+The default is `'none'`, and reel loading is unchanged.
 
 Applications that need audio continuity can pass `initialReelAudioState` with
 `volume`, `muted`, and `lastAudibleVolume`, then persist user changes through

package/lib/components/MediaCard.vue.d.ts

@@ -8,6 +8,7 @@ type __VLS_Props = {
     cardHeader?: VibeCardRegion;
     entering: boolean;
     fetchPriority: 'high' | 'low';
+    inViewport?: boolean;
     index: number;
     item: VibeItem;
     itemStyle?: CSSProperties;

package/lib/components/{useFeedReplacementPreload.d.ts → useVisiblePostPreload.d.ts}

@@ -1,5 +1,6 @@
 import type { VibeItem, VibeLayout, VibeMediaCardOptions, VibeMediaSource } from '../types';
-interface FeedReplacementPreloadOptions {
+interface VisiblePostPreloadOptions {
+    inViewport: () => boolean;
     item: () => VibeItem;
     layout: () => VibeLayout;
     mediaCard: () => VibeMediaCardOptions | undefined;
@@ -7,5 +8,5 @@ interface FeedReplacementPreloadOptions {
     mediaReady: () => boolean;
     mediaSource: () => VibeMediaSource;
 }
-export declare function useFeedReplacementPreload(options: FeedReplacementPreloadOptions): void;
+export declare function useVisiblePostPreload(options: VisiblePostPreloadOptions): void;
 export {};

package/lib/core/mediaCardOptions.d.ts

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

package/lib/core/visiblePostPreload.d.ts

@@ -0,0 +1,22 @@
+import type { VibeItem, VibeMediaSource } from '../types';
+export declare const VISIBLE_POST_PRELOAD_CONCURRENCY = 6;
+export declare const VISIBLE_POST_TIMED_PRELOAD_CONCURRENCY = 2;
+export interface VisiblePostPreloadTarget {
+    key: string;
+    src: string;
+    timed: boolean;
+}
+type EntryState = 'queued' | 'loading' | 'ready' | 'failed';
+export declare function visiblePostPreloadTargets(item: VibeItem, mediaIndex: number, mediaSource: VibeMediaSource): VisiblePostPreloadTarget[];
+export declare function acquireVisiblePostPreload(target: VisiblePostPreloadTarget): () => void;
+export declare function visiblePostPreloadSchedulerSnapshot(): {
+    active: number;
+    activeTimed: number;
+    entries: Array<{
+        key: string;
+        refs: number;
+        state: EntryState;
+    }>;
+};
+export declare function resetVisiblePostPreloadSchedulerForTests(): void;
+export {};