@wyxos/vibe 5.8.2 → 5.8.3

package/README.md

@@ -99,6 +99,7 @@ const vibe = createVibe({
     height: 48,
   },
   mediaCard: {
+    feedPreload: 'visible-post',
     videoMuted: true,
   },
 })
@@ -121,6 +122,12 @@ 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 `'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
 `onReelAudioStateChange`. Every reel card in that Vibe instance shares the

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/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/components/useVisiblePostPreload.d.ts

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

package/lib/core/mediaCardOptions.d.ts

@@ -6,6 +6,7 @@ export interface VibeCardChromeStyle {
 }
 export interface VibeMediaCardOptions {
     error?: VibeMediaError;
+    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 {};