@wyxos/vibe 5.13.4 → 5.15.0

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

@@ -1,3 +1,4 @@
+import type { MediaFailure } from '../core/mediaFailure';
 import type { MasonryFeedProps } from '../core/feed';
 import type { VibeItemId } from '../types';
 declare function loadIfNearBottom(): void;
@@ -11,6 +12,7 @@ declare const __VLS_export: import("vue").DefineComponent<MasonryFeedProps, {
     loadMore: () => any;
     retryEnd: () => any;
     activate: (postId: VibeItemId, input: "keyboard" | "pointer") => any;
+    mediaError: (postId: VibeItemId, failure: MediaFailure) => any;
     mediaChange: (postId: VibeItemId, mediaIndex: number) => any;
     fullyVisible: (postId: VibeItemId, mediaIndex: number) => any;
     visible: (postId: VibeItemId, mediaIndex: number) => any;
@@ -20,6 +22,7 @@ declare const __VLS_export: import("vue").DefineComponent<MasonryFeedProps, {
     onLoadMore?: (() => any) | undefined;
     onRetryEnd?: (() => any) | undefined;
     onActivate?: ((postId: VibeItemId, input: "keyboard" | "pointer") => any) | undefined;
+    onMediaError?: ((postId: VibeItemId, failure: MediaFailure) => any) | undefined;
     onMediaChange?: ((postId: VibeItemId, mediaIndex: number) => any) | undefined;
     onFullyVisible?: ((postId: VibeItemId, mediaIndex: number) => any) | undefined;
     onVisible?: ((postId: VibeItemId, mediaIndex: number) => any) | undefined;

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

@@ -1,3 +1,4 @@
+import type { MediaFailure } from '../core/mediaFailure';
 import { type CSSProperties } from 'vue';
 import { type MediaPreviewState } from '../core/mediaPreview';
 import type { VibeCardRegion, VibeItem, VibeLayout, VibeMediaSource, VibeMediaCardOptions, VibeReelAudioState } from '../types';
@@ -30,6 +31,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     error: (mediaIndex: number) => any;
     ended: (mediaIndex: number) => any;
     activate: (input: "keyboard" | "pointer") => any;
+    mediaError: (failure: MediaFailure) => any;
     mediaChange: (mediaIndex: number) => any;
     reelAudioChange: (state: VibeReelAudioState) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
@@ -37,6 +39,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     onError?: ((mediaIndex: number) => any) | undefined;
     onEnded?: ((mediaIndex: number) => any) | undefined;
     onActivate?: ((input: "keyboard" | "pointer") => any) | undefined;
+    onMediaError?: ((failure: MediaFailure) => any) | undefined;
     onMediaChange?: ((mediaIndex: number) => any) | undefined;
     onReelAudioChange?: ((state: VibeReelAudioState) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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

@@ -1,3 +1,4 @@
+import type { MediaFailure } from '../core/mediaFailure';
 import { type ReelFeedProps } from '../core/feed';
 import type { VibeItemId, VibeReelAudioState } from '../types';
 declare function loadIfNearBottom(): void;
@@ -20,6 +21,7 @@ declare const __VLS_export: import("vue").DefineComponent<ReelFeedProps, {
     error: (postId: VibeItemId, mediaIndex: number) => any;
     loadMore: () => any;
     retryEnd: () => any;
+    mediaError: (postId: VibeItemId, failure: MediaFailure) => any;
     mediaChange: (postId: VibeItemId, mediaIndex: number) => any;
     reelAudioChange: (state: VibeReelAudioState) => any;
     activeChange: (postId: VibeItemId) => any;
@@ -29,6 +31,7 @@ declare const __VLS_export: import("vue").DefineComponent<ReelFeedProps, {
     onError?: ((postId: VibeItemId, mediaIndex: number) => any) | undefined;
     onLoadMore?: (() => any) | undefined;
     onRetryEnd?: (() => any) | undefined;
+    onMediaError?: ((postId: VibeItemId, failure: MediaFailure) => any) | undefined;
     onMediaChange?: ((postId: VibeItemId, mediaIndex: number) => any) | undefined;
     onReelAudioChange?: ((state: VibeReelAudioState) => any) | undefined;
     onActiveChange?: ((postId: VibeItemId) => any) | undefined;

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

@@ -1,3 +1,4 @@
+import type { MediaFailure } from '../core/mediaFailure';
 import type { ReelLayoutProps } from '../core/feed';
 import type { VibeItemId, VibeReelAudioState } from '../types';
 declare function changeActiveMedia(direction: -1 | 1): boolean;
@@ -18,6 +19,7 @@ declare const __VLS_export: import("vue").DefineComponent<ReelLayoutProps, {
     error: (postId: VibeItemId, mediaIndex: number) => any;
     loadMore: () => any;
     retryEnd: () => any;
+    mediaError: (postId: VibeItemId, failure: MediaFailure) => any;
     mediaChange: (postId: VibeItemId, mediaIndex: number) => any;
     reelAudioChange: (state: VibeReelAudioState) => any;
     activeChange: (postId: VibeItemId) => any;
@@ -28,6 +30,7 @@ declare const __VLS_export: import("vue").DefineComponent<ReelLayoutProps, {
     onError?: ((postId: VibeItemId, mediaIndex: number) => any) | undefined;
     onLoadMore?: (() => any) | undefined;
     onRetryEnd?: (() => any) | undefined;
+    onMediaError?: ((postId: VibeItemId, failure: MediaFailure) => any) | undefined;
     onMediaChange?: ((postId: VibeItemId, mediaIndex: number) => any) | undefined;
     onReelAudioChange?: ((state: VibeReelAudioState) => any) | undefined;
     onActiveChange?: ((postId: VibeItemId) => any) | undefined;

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

@@ -1,6 +1,6 @@
 import type { VibeMasonryOptions } from '../core/masonryOptions';
 import { type VibeRuntimeState } from '../core/runtime';
-import type { VibeCardRegion, VibeFeedFooter, VibeFeedFooterActions, VibeItemId, VibeMediaCardOptions, VibeMediaLifecycleContext, VibeReelInfoSheetOptions, VibeReelAudioState, VibeReelItemTarget, VibeReelNavigationResult } from '../types';
+import type { VibeCardRegion, VibeFeedFooter, VibeFeedFooterActions, VibeItemId, VibeMediaCardOptions, VibeMediaErrorContext, VibeMediaLifecycleContext, VibeReelInfoSheetOptions, VibeReelAudioState, VibeReelItemTarget, VibeReelNavigationResult } from '../types';
 import type { VibeItemRemovalOptions } from '../core/itemRemovalOptions';
 type __VLS_Props = {
     canRetryEnd: boolean;
@@ -20,7 +20,11 @@ declare function moveActiveReelPost(direction: -1 | 1): boolean;
 declare function navigateToReelItem(target: VibeReelItemTarget): VibeReelNavigationResult;
 declare function getAutoScrollElement(): HTMLElement | null;
 declare function startItemRemoval(postIds: readonly VibeItemId[], options?: VibeItemRemovalOptions): number;
+declare function cancelItemRemoval(): void;
+declare function animateItemRemoval(postIds: readonly VibeItemId[], signal: AbortSignal): Promise<void>;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    animateItemRemoval: typeof animateItemRemoval;
+    cancelItemRemoval: typeof cancelItemRemoval;
     changeActiveReelMedia: typeof changeActiveReelMedia;
     getAutoScrollElement: typeof getAutoScrollElement;
     loadIfNearBottom: typeof loadIfNearBottom;
@@ -33,6 +37,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     loadMore: () => any;
     retryEnd: () => any;
+    mediaError: (context: VibeMediaErrorContext) => any;
     reelAudioChange: (state: VibeReelAudioState) => any;
     retryForward: () => any;
     activeReelChange: (postId: VibeItemId) => any;
@@ -46,6 +51,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onLoadMore?: (() => any) | undefined;
     onRetryEnd?: (() => any) | undefined;
+    onMediaError?: ((context: VibeMediaErrorContext) => any) | undefined;
     onReelAudioChange?: ((state: VibeReelAudioState) => any) | undefined;
     onRetryForward?: (() => any) | undefined;
     onActiveReelChange?: ((postId: VibeItemId) => any) | undefined;

package/lib/components/useMediaLifecycle.d.ts

@@ -1,13 +1,16 @@
+import type { MediaFailure } from '../core/mediaFailure';
 import type { MediaPreviewState } from '../core/mediaPreview';
 import type { VibeRuntimeState } from '../core/runtime';
-import type { VibeItemId, VibeMediaLifecycleContext } from '../types';
+import type { VibeItemId, VibeLayout, VibeMediaErrorContext, VibeMediaLifecycleContext } from '../types';
 interface MediaLifecycleEvents {
+    error: (context: VibeMediaErrorContext) => void;
     fullyVisible: (context: VibeMediaLifecycleContext) => void;
     ready: (context: VibeMediaLifecycleContext) => void;
     reelChange: (context: VibeMediaLifecycleContext) => void;
     visible: (context: VibeMediaLifecycleContext) => void;
 }
 export declare function useMediaLifecycle(state: VibeRuntimeState, events: MediaLifecycleEvents): {
+    markMediaError: (postId: VibeItemId, failure: MediaFailure, layout: VibeLayout) => void;
     markMasonryFullyVisible: (postId: VibeItemId, mediaIndex: number) => void;
     markMasonryVisible: (postId: VibeItemId, mediaIndex: number) => void;
     markPreviewError: (postId: VibeItemId, mediaIndex: number) => void;

package/lib/components/useMediaReadiness.d.ts

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

package/lib/core/feed.d.ts

@@ -53,6 +53,8 @@ export interface ReelLayoutProps extends ReelFeedProps {
     origin: VibeReelOrigin;
 }
 export interface VibeSurfaceExpose {
+    animateItemRemoval: (postIds: readonly VibeItemId[], signal: AbortSignal) => Promise<void>;
+    cancelItemRemoval: () => void;
     changeActiveReelMedia: (direction: -1 | 1) => boolean;
     getAutoScrollElement: () => HTMLElement | null;
     loadIfNearBottom: () => Promise<void>;

package/lib/core/loadingLock.d.ts

@@ -0,0 +1,10 @@
+import type { VibeRuntimeState } from './runtime';
+interface LoadingLockActions {
+    getPending: () => Promise<void> | null;
+    hasPendingSession: () => boolean;
+    loadIfNearBottom: () => Promise<void> | undefined;
+    loadNext: () => Promise<void>;
+    resumeFill: () => Promise<void>;
+}
+export declare function setLoadingLock(state: VibeRuntimeState, locked: boolean, actions: LoadingLockActions): void;
+export {};

package/lib/core/mediaFailure.d.ts

@@ -0,0 +1,6 @@
+import type { VibeMediaLifecycleContext, VibeMediaSource } from '../types';
+export interface VibeMediaErrorContext extends VibeMediaLifecycleContext {
+    source: VibeMediaSource;
+    src: string;
+}
+export type MediaFailure = Pick<VibeMediaErrorContext, 'mediaIndex' | 'source' | 'src'>;

package/lib/core/pageReplacement.d.ts

@@ -0,0 +1,22 @@
+import type { VibeSurfaceExpose } from './feed';
+import type { VibeRuntimeState } from './runtime';
+import type { VibePage } from '../types';
+export interface VibePageReplacementOptions {
+    /** Scroll masonry to its beginning after the outgoing cards leave. */
+    resetScroll?: boolean;
+}
+interface PageReplacementOptions {
+    commit: (page: VibePage) => void;
+    prepare: () => Promise<void>;
+    state: VibeRuntimeState;
+    surface: () => VibeSurfaceExpose | null;
+}
+export declare class PageReplacementController {
+    private readonly options;
+    private controller;
+    constructor(options: PageReplacementOptions);
+    isActive(): boolean;
+    cancel(): void;
+    replace(pageValue: VibePage, options?: VibePageReplacementOptions): Promise<void>;
+}
+export {};

package/lib/core/runtime.d.ts

@@ -1,4 +1,4 @@
-import { type ComputedRef } from 'vue';
+import { type ComputedRef, type WatchHandle } from 'vue';
 import type { VibeAutoScrollState, VibeAutofillState, VibeCursor, VibeFillState, VibeItem, VibeItemId, VibeLayout, VibeMediaSource, VibeReelAutoAdvanceState, VibeReelForwardState, VibeReelInfoSheetState, VibeState } from '../types';
 export interface VibeRuntimeState {
     activeReelPostId: VibeItemId | null;
@@ -28,4 +28,5 @@ export interface VibeRuntimeState {
     total: number | null;
 }
 export declare function createItemSnapshot(state: VibeRuntimeState): ComputedRef<readonly VibeItem[]>;
+export declare function watchStateSnapshots(state: VibeRuntimeState, items: ComputedRef<readonly VibeItem[]>, onStateChange: (state: VibeState) => void): WatchHandle;
 export declare function snapshotState(state: VibeRuntimeState, items?: readonly VibeItem[]): VibeState;