@wyxos/vibe 5.5.5 → 5.7.0

package/README.md

@@ -41,9 +41,11 @@ In responsive layout, Vibe observes the target and uses reels on phones while
 keeping tablets and desktops in masonry. Use `masonry` or `reel` to force a
 renderer instead.
 
-Phone reels load `preview.src`. Reels on tablets and desktops load the full
+Masonry loads `preview`. Reels on tablets and desktops load the canonical
 `src`, including a reel forced with `layout: 'reel'` and a reel opened from a
-masonry card.
+masonry card. Phone reels load the optional `mobile` variant when supplied and
+otherwise fall back to the canonical `src`; feed previews are never promoted to
+reel playback sources.
 
 `loadPage` receives `cursor: null` for the initial request. It returns normalized Vibe items, the next opaque cursor, and an optional total:
 

package/lib/components/useMediaLoading.d.ts

@@ -1,9 +1,11 @@
 import { type ShallowRef } from 'vue';
-import type { VibeLayout } from '../types';
+import type { VibeLayout, VibeMediaType } from '../types';
 interface MediaLoadingOptions {
+    active: () => boolean | undefined;
     fetchPriority: () => 'high' | 'low';
     layout: () => VibeLayout;
     mediaSource: () => string;
+    mediaType: () => VibeMediaType | undefined;
     videoElement: ShallowRef<HTMLVideoElement | null>;
 }
 export declare function useMediaLoading(options: MediaLoadingOptions): {

package/lib/components/useMediaReadiness.d.ts

@@ -0,0 +1,19 @@
+import type { MediaPreviewState } from '../core/mediaPreview';
+interface MediaReadinessOptions {
+    identity: () => string;
+    mediaIndex: () => number;
+    onError: (mediaIndex: number) => void;
+    onReady: (mediaIndex: number) => void;
+    previewState: () => MediaPreviewState;
+}
+export declare function useMediaReadiness(options: MediaReadinessOptions): {
+    effectivePreviewState: import("vue").ComputedRef<MediaPreviewState>;
+    failSourceAttempt: (event?: Event) => void;
+    imageElement: import("vue").ShallowRef<HTMLImageElement | null, HTMLImageElement | null>;
+    markSourceReady: (event?: Event) => void;
+    noteSourceActivity: (event: Event) => void;
+    retrySource: () => void;
+    sourceGeneration: import("vue").ShallowRef<number, number>;
+    videoElement: import("vue").ShallowRef<HTMLVideoElement | null, HTMLVideoElement | null>;
+};
+export {};

package/lib/core/appendPage.d.ts

@@ -0,0 +1,4 @@
+import type { VibeCursor, VibePage } from '../types';
+import type { RemovalReconciliationController } from './removalReconciliationController';
+import type { VibeRuntimeState } from './runtime';
+export declare function appendPageToState(pageValue: VibePage, state: VibeRuntimeState, reconciliation: RemovalReconciliationController, setCursor: (cursor: VibeCursor) => void): void;

package/lib/core/backlogRestore.d.ts

@@ -0,0 +1,2 @@
+import type { CreateVibeOptions, VibePage } from '../types';
+export declare function restoreBacklog(restore: CreateVibeOptions['restoreBacklog'], appendPage: (page: VibePage) => void, setController: (controller: AbortController | null) => void): Promise<void>;

package/lib/core/feedFooter.d.ts

@@ -5,6 +5,7 @@ interface FeedFooterActionTarget {
     loadNext: () => Promise<void>;
     reload: () => Promise<void>;
     retryEnd: () => Promise<void>;
+    retryFill: () => Promise<void>;
 }
 export declare function createFeedFooterActions(target: FeedFooterActionTarget): VibeFeedFooterActions;
 export {};

package/lib/core/fillController.d.ts

@@ -36,6 +36,7 @@ export declare class VibeFillController {
     start(targetValue: VibeFillTarget, startOptions?: FillStartOptions): Promise<void>;
     cancel(): Promise<void>;
     resume(prepareFrontend: boolean): Promise<void>;
+    retry(prepareFrontend: boolean): Promise<void>;
     reset(): void;
     destroy(): void;
     private abortLocalRequest;

package/lib/core/mediaAsset.d.ts

@@ -1,4 +1,5 @@
-import type { VibeItem, VibeItemId, VibeMediaAsset } from '../types';
+import type { VibeItem, VibeItemId, VibeMediaAsset, VibeMediaSource, VibeMediaVariant } from '../types';
+export declare function mediaVariantForSource(asset: VibeMediaAsset, source: VibeMediaSource): VibeMediaVariant;
 export declare function mediaAssets(item: VibeItem): readonly VibeMediaAsset[];
 export declare function clampMediaIndex(item: VibeItem, index: number): number;
 export declare function mediaAssetAt(item: VibeItem, index: number): VibeMediaAsset;

package/lib/core/mediaType.d.ts

@@ -1 +1,3 @@
+import type { VibeMediaType } from '../types';
 export declare function isTimedMediaSource(src: string): boolean;
+export declare function isTimedMedia(type: VibeMediaType | undefined, src: string): boolean;

package/lib/core/page.d.ts

@@ -7,4 +7,5 @@ export interface LoadedPageRecord {
 }
 export declare function validatePage(page: VibePage): VibePage;
 export declare function appendUniqueItems(current: readonly VibeItem[], incoming: readonly VibeItem[]): VibeItem[];
+export declare function reconcilePageItems(current: readonly VibeItem[], incoming: readonly VibeItem[]): VibeItem[];
 export declare function pageCurrentCursor(page: VibePage): VibeCursor;

package/lib/core/runtime.d.ts

@@ -1,5 +1,5 @@
 import { type ComputedRef } from 'vue';
-import type { VibeAutoScrollState, VibeAutofillState, VibeCursor, VibeFillState, VibeItem, VibeItemId, VibeLayout, VibeReelAutoAdvanceState, VibeReelForwardState, VibeReelInfoSheetState, VibeState } from '../types';
+import type { VibeAutoScrollState, VibeAutofillState, VibeCursor, VibeFillState, VibeItem, VibeItemId, VibeLayout, VibeMediaSource, VibeReelAutoAdvanceState, VibeReelForwardState, VibeReelInfoSheetState, VibeState } from '../types';
 export interface VibeRuntimeState {
     activeReelPostId: VibeItemId | null;
     autoScroll: VibeAutoScrollState;
@@ -23,7 +23,7 @@ export interface VibeRuntimeState {
     reelForwardItem: VibeItem | null;
     reelInfoSheet: VibeReelInfoSheetState;
     reelInfoSheetOverlay: boolean;
-    reelMediaSource: 'original' | 'preview';
+    reelMediaSource: VibeMediaSource;
     reelOrigin: 'masonry' | null;
     total: number | null;
 }