@wyxos/vibe 3.0.6 → 3.0.10

package/README.md

@@ -305,6 +305,12 @@ const vibe = ref<VibeHandle | null>(null)
 
 Available methods:
 
+- `lockPageLoading()`
+- `unlockPageLoading()`
+- `loadNext()`
+- `loadPrevious()`
+- `retry()`
+- `cancel()`
 - `remove(ids)`
 - `restore(ids)`
 - `undo()`
@@ -327,6 +333,7 @@ type VibeStatus = {
   loadState: 'failed' | 'loaded' | 'loading'
   mode: 'dynamic' | 'static'
   nextCursor: string | null
+  pageLoadingLocked: boolean
   phase: 'failed' | 'filling' | 'idle' | 'initializing' | 'loading' | 'refreshing'
   previousCursor: string | null
   removedCount: number
@@ -338,9 +345,12 @@ type VibeStatus = {
 Example:
 
 ```ts
+vibe.value?.lockPageLoading()
 vibe.value?.remove(['item-2', 'item-5'])
 vibe.value?.undo()
+vibe.value?.unlockPageLoading()
 console.log(vibe.value?.status.itemCount)
+console.log(vibe.value?.status.pageLoadingLocked)
 console.log(vibe.value?.status.removedIds)
 ```
 

package/lib/components/viewer-core/removalState.d.ts

@@ -17,6 +17,7 @@ export interface VibeStatus {
     loadState: 'failed' | 'loaded' | 'loading';
     mode: VibeFeedMode;
     nextCursor: string | null;
+    pageLoadingLocked: boolean;
     phase: VibeLoadPhase;
     previousCursor: string | null;
     removedCount: number;
@@ -27,6 +28,7 @@ export interface VibeHandle {
     cancel: () => void;
     clearRemoved: () => void;
     getRemovedIds: () => string[];
+    lockPageLoading: () => void;
     loadNext: () => Promise<void>;
     loadPrevious: () => Promise<void>;
     remove: (ids: string | string[]) => VibeRemoveResult;
@@ -34,6 +36,7 @@ export interface VibeHandle {
     retry: () => Promise<void>;
     status: Readonly<VibeStatus>;
     undo: () => VibeRemoveResult | null;
+    unlockPageLoading: () => void;
 }
 export declare function useVibeRemovalState(): {
     clearRemoved: () => void;

package/lib/components/viewer-core/useAutoResolveSource.d.ts

@@ -32,7 +32,9 @@ export declare function useAutoResolveSource(options: {
     fillTargetCount: Ref<number | null, number | null>;
     hasNextPage: import("vue").ComputedRef<boolean>;
     hasPreviousPage: import("vue").ComputedRef<boolean>;
+    isPageLoadingLocked: Ref<boolean, boolean>;
     items: import("vue").ComputedRef<VibeViewerItem[]>;
+    lockPageLoading: () => void;
     loading: import("vue").ComputedRef<boolean>;
     mode: import("vue").ComputedRef<VibeFeedMode>;
     nextCursor: import("vue").ComputedRef<string | null>;
@@ -46,6 +48,7 @@ export declare function useAutoResolveSource(options: {
     setActiveIndex: (nextIndex: number) => void;
     setAutoPrefetchEnabled: (nextValue: boolean) => void;
     syncActiveIndexAfterVisibilityChange: (anchorOccurrenceKey?: string | null) => void;
+    unlockPageLoading: () => void;
     getActiveOccurrenceKey: () => string | null;
     maybeCommitPendingAppendWhenFilteredOut: () => void;
 };

package/lib/components/viewer-core/useController.d.ts

@@ -4,6 +4,7 @@ export declare const DESKTOP_BREAKPOINT_PX = 1024;
 export declare function useController(props: Readonly<VibeProps>, emit: VibeEmit): {
     cancel: () => void;
     isDesktop: import("vue").ComputedRef<boolean>;
+    lockPageLoading: () => void;
     loadNext: () => Promise<void>;
     loadPrevious: () => Promise<void>;
     openFullscreen: (index: number) => void;
@@ -23,6 +24,7 @@ export declare function useController(props: Readonly<VibeProps>, emit: VibeEmit
         readonly loadState: "failed" | "loaded" | "loading";
         readonly mode: import("./removalState").VibeFeedMode;
         readonly nextCursor: string | null;
+        readonly pageLoadingLocked: boolean;
         readonly phase: import("./removalState").VibeLoadPhase;
         readonly previousCursor: string | null;
         readonly removedCount: number;
@@ -30,6 +32,7 @@ export declare function useController(props: Readonly<VibeProps>, emit: VibeEmit
         readonly surfaceMode: VibeSurfaceMode;
     };
     surfaceMode: import("vue").ComputedRef<VibeSurfaceMode>;
+    unlockPageLoading: () => void;
     activeIndex: import("vue").ComputedRef<number>;
     canRefreshExhaustedNextPage: import("vue").ComputedRef<boolean>;
     canRetryInitialLoad: import("vue").ComputedRef<boolean>;
@@ -43,6 +46,7 @@ export declare function useController(props: Readonly<VibeProps>, emit: VibeEmit
     getRemovedIds: () => string[];
     hasNextPage: import("vue").ComputedRef<boolean>;
     hasPreviousPage: import("vue").ComputedRef<boolean>;
+    isPageLoadingLocked: import("vue").Ref<boolean, boolean>;
     items: import("vue").ComputedRef<import("../viewer").VibeViewerItem[]>;
     loading: import("vue").ComputedRef<boolean>;
     mode: import("vue").ComputedRef<import("./removalState").VibeFeedMode>;

package/lib/components/viewer-core/useDataSource.d.ts

@@ -52,7 +52,9 @@ export declare function useDataSource(props: Readonly<VibeProps>, emit: VibeEmit
     getRemovedIds: () => string[];
     hasNextPage: import("vue").ComputedRef<boolean>;
     hasPreviousPage: import("vue").ComputedRef<boolean>;
+    isPageLoadingLocked: import("vue").Ref<boolean, boolean>;
     items: import("vue").ComputedRef<VibeViewerItem[]>;
+    lockPageLoading: () => void;
     loading: import("vue").ComputedRef<boolean>;
     loadNext: () => Promise<void>;
     loadPrevious: () => Promise<void>;
@@ -78,4 +80,5 @@ export declare function useDataSource(props: Readonly<VibeProps>, emit: VibeEmit
     undo: () => {
         ids: string[];
     } | null;
+    unlockPageLoading: () => void;
 };