@wyxos/vibe 3.0.3 → 3.0.4

package/README.md

@@ -70,13 +70,18 @@ Optional auto-mode pacing props:
 ```vue
 <VibeLayout
   :resolve="resolve"
-  :fill-delay-ms="1000"
-  :fill-delay-step-ms="250"
+  :fill-delay-ms="2000"
+  :fill-delay-step-ms="1000"
+  :show-end-badge="false"
+  :show-status-badges="false"
 />
 ```
 
 - `fill-delay-ms`: base delay before the first chained fill request
 - `fill-delay-step-ms`: extra delay added for each additional chained fill request in the same fill cycle
+- defaults: `2000` and `1000`
+- `show-end-badge`: controls the fullscreen `End reached` badge when the feed is exhausted
+- `show-status-badges`: controls the built-in loading/end status overlays in list and fullscreen
 
 Optional auto-mode feed strategy:
 
@@ -184,6 +189,7 @@ Auto mode also supports two feed strategies:
   - it waits `fillDelayMs`, then `fillDelayMs + fillDelayStepMs`, and so on for each chained request
   - it keeps accumulating results until the collected count reaches `pageSize` or there is no further cursor
   - then it commits that batch into the layout once
+  - when the trailing edge is exhausted, another bottom-edge attempt reloads the trailing cursor so newly available pages can be discovered
 - `static`:
   - before advancing at the bottom or top, Vibe checks whether the current boundary page is underfilled after local removals
   - if it is, Vibe reloads that same cursor in place first

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

@@ -9,7 +9,6 @@ type __VLS_Props = VibeControlledProps & {
     reportAssetError?: VibeAssetErrorReporter | null;
     reportAssetLoad?: VibeAssetLoadReporter | null;
     showBackToList?: boolean;
-    showStatusBadges?: boolean;
 };
 type __VLS_Slots = {
     'fullscreen-aside'?: (props: VibeSurfaceSlotProps) => unknown;
@@ -32,6 +31,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     activeIndex: number;
     hasNextPage: boolean;
     paginationDetail: string | null;
+    showEndBadge: boolean;
     showStatusBadges: boolean;
     showBackToList: boolean;
     active: boolean;

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

@@ -1,12 +1,13 @@
 import { type Component } from 'vue';
 import type { VibeViewerItem } from './viewer';
-import type { VibeEmptyStateSlotProps, VibeFullscreenStatusSlotProps, VibeGridStatusSlotProps, VibeSurfaceSlotProps } from './viewer-core/surfaceSlots';
+import { type VibeAssetErrorEvent, type VibeAssetLoadEvent } from './viewer-core/assetErrors';
+import type { VibeFullscreenStatusSlotProps, VibeGridStatusSlotProps, VibeSurfaceSlotProps } from './viewer-core/surfaceSlots';
+import type { VibeHandle } from './viewer-core/useViewer';
 type __VLS_Slots = {
     'fullscreen-aside'?: (props: VibeSurfaceSlotProps) => unknown;
     'fullscreen-header-actions'?: (props: VibeSurfaceSlotProps) => unknown;
     'fullscreen-overlay'?: (props: VibeSurfaceSlotProps) => unknown;
     'fullscreen-status'?: (props: VibeFullscreenStatusSlotProps) => unknown;
-    'empty-state'?: (props: VibeEmptyStateSlotProps) => unknown;
     'grid-footer'?: () => unknown;
     'grid-item-overlay'?: (props: {
         active: boolean;
@@ -22,7 +23,15 @@ type __VLS_Slots = {
         item: VibeViewerItem;
     }) => unknown;
 };
-declare const __VLS_base: import("vue").DefineSetupFnComponent<Record<string, any>, {}, {}, Record<string, any> & {}, import("vue").PublicProps>;
+declare const __VLS_base: import("vue").DefineComponent<import("..").VibeControlledProps | import("..").VibeAutoProps, VibeHandle, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:activeIndex": (value: number) => any;
+    "asset-errors": (errors: VibeAssetErrorEvent[]) => any;
+    "asset-loads": (loads: VibeAssetLoadEvent[]) => any;
+}, string, import("vue").PublicProps, Readonly<import("..").VibeControlledProps | import("..").VibeAutoProps> & Readonly<{
+    "onUpdate:activeIndex"?: ((value: number) => any) | undefined;
+    "onAsset-errors"?: ((errors: VibeAssetErrorEvent[]) => any) | undefined;
+    "onAsset-loads"?: ((loads: VibeAssetLoadEvent[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -1,10 +1,8 @@
 import type { Component } from 'vue';
 import type { VibeViewerItem } from './viewer';
 import type { VibeAssetErrorReporter, VibeAssetLoadReporter } from './viewer-core/assetErrors';
-import { type VibeAssetLoadQueue } from './viewer-core/useAssetLoadQueue';
 type __VLS_Props = {
     active?: boolean;
-    assetLoadQueue?: VibeAssetLoadQueue | null;
     index?: number;
     item: VibeViewerItem;
     reportAssetError?: VibeAssetErrorReporter | null;
@@ -34,7 +32,6 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     reportAssetError: VibeAssetErrorReporter | null;
     reportAssetLoad: VibeAssetLoadReporter | null;
     index: number;
-    assetLoadQueue: VibeAssetLoadQueue | null;
     surfaceActive: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

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

@@ -2,11 +2,10 @@ import type { Component } from 'vue';
 import type { VibeViewerItem } from './viewer';
 import type { VibeAssetErrorReporter, VibeAssetLoadReporter } from './viewer-core/assetErrors';
 import type { VibeGridStatusSlotProps } from './viewer-core/surfaceSlots';
-import type { VibeAssetLoadQueue } from './viewer-core/useAssetLoadQueue';
 type __VLS_Props = {
     active?: boolean;
     activeIndex?: number;
-    assetLoadQueue?: VibeAssetLoadQueue | null;
+    allowExhaustedNextPageRefresh?: boolean;
     commitPendingAppend?: (() => void | Promise<void>) | null;
     hasNextPage?: boolean;
     hasPreviousPage?: boolean;
@@ -55,7 +54,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     active: boolean;
     reportAssetError: VibeAssetErrorReporter | null;
     reportAssetLoad: VibeAssetLoadReporter | null;
-    assetLoadQueue: VibeAssetLoadQueue | null;
+    allowExhaustedNextPageRefresh: boolean;
     commitPendingAppend: (() => void | Promise<void>) | null;
     pendingAppendItems: VibeViewerItem[];
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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

@@ -1,5 +1,5 @@
-export declare const DEFAULT_DYNAMIC_FILL_DELAY_MS = 1000;
-export declare const DEFAULT_DYNAMIC_FILL_DELAY_STEP_MS = 250;
+export declare const DEFAULT_DYNAMIC_FILL_DELAY_MS = 2000;
+export declare const DEFAULT_DYNAMIC_FILL_DELAY_STEP_MS = 1000;
 export declare function getDynamicFillDelayMs(fillRequestIndex: number, baseDelayMs?: number, stepDelayMs?: number): number;
 export declare function normalizeDynamicFillDelayMs(value: number | undefined, fallback: number): number;
 export declare function useFillDelayCountdown(): {

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

@@ -3,7 +3,6 @@ export interface VibeRemoveResult {
 }
 export type VibeFeedMode = 'dynamic' | 'static';
 export type VibeLoadPhase = 'failed' | 'filling' | 'idle' | 'loading' | 'reloading';
-export type VibeSurfaceMode = 'fullscreen' | 'list';
 export interface VibeStatus {
     activeIndex: number;
     currentCursor: string | null;
@@ -21,7 +20,7 @@ export interface VibeStatus {
     phase: VibeLoadPhase;
     previousCursor: string | null;
     removedCount: number;
-    surfaceMode: VibeSurfaceMode;
+    surfaceMode: 'fullscreen' | 'list';
 }
 export interface VibeHandle {
     cancel: () => void;

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

@@ -20,8 +20,3 @@ export type VibeGridStatusSlotProps = {
     paginationDetail: string | null;
     total: number;
 };
-export type VibeEmptyStateSlotProps = {
-    canRetry: boolean;
-    loading: boolean;
-    retry: () => void | Promise<void>;
-};

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

@@ -14,10 +14,9 @@ export interface VibeAssetLoadLease {
     refresh: () => void;
     release: () => void;
 }
-export interface VibeAssetLoadQueue {
-    getLimits: () => VibeAssetLoadQueueLimits;
+export declare function createAssetLoadQueue(limits?: VibeAssetLoadQueueLimits): {
     request: (options: VibeAssetLoadRequest) => VibeAssetLoadLease;
-    setLimits: (limits?: Partial<VibeAssetLoadQueueLimits> | null) => void;
-}
-export declare function resolveAssetLoadQueueLimits(limits?: Partial<VibeAssetLoadQueueLimits> | null): VibeAssetLoadQueueLimits;
-export declare function createAssetLoadQueue(initialLimits?: Partial<VibeAssetLoadQueueLimits> | null): VibeAssetLoadQueue;
+};
+export declare const defaultAssetLoadQueue: {
+    request: (options: VibeAssetLoadRequest) => VibeAssetLoadLease;
+};

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

@@ -23,6 +23,7 @@ export declare function useAutoResolveSource(options: {
     activeIndex: import("vue").ComputedRef<number>;
     canRetryInitialLoad: import("vue").ComputedRef<boolean>;
     cancel: () => void;
+    canRefreshTrailingBoundary: import("vue").ComputedRef<boolean>;
     commitPendingAppend: () => Promise<void>;
     currentCursor: import("vue").ComputedRef<string | null>;
     errorMessage: Ref<string | null, string | null>;

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

@@ -1,8 +1,7 @@
-import type { VibeSurfaceMode } from './removalState';
 import { type VibeEmit, type VibeProps } from './useDataSource';
 export declare const DESKTOP_BREAKPOINT_PX = 1024;
-type VibeControllerEmit = VibeEmit & ((event: 'update:surfaceMode', value: VibeSurfaceMode) => void);
-export declare function useController(props: Readonly<VibeProps>, emit: VibeControllerEmit): {
+type VibeDesktopSurface = 'fullscreen' | 'list';
+export declare function useController(props: Readonly<VibeProps>, emit: VibeEmit): {
     cancel: () => void;
     isDesktop: import("vue").ComputedRef<boolean>;
     listRestoreToken: import("vue").Ref<number, number>;
@@ -29,10 +28,11 @@ export declare function useController(props: Readonly<VibeProps>, emit: VibeCont
         readonly phase: import("./removalState").VibeLoadPhase;
         readonly previousCursor: string | null;
         readonly removedCount: number;
-        readonly surfaceMode: VibeSurfaceMode;
+        readonly surfaceMode: "fullscreen" | "list";
     };
-    surfaceMode: import("vue").ComputedRef<VibeSurfaceMode>;
+    surfaceMode: import("vue").ComputedRef<VibeDesktopSurface>;
     activeIndex: import("vue").ComputedRef<number>;
+    canRefreshExhaustedNextPage: import("vue").ComputedRef<boolean>;
     canRetryInitialLoad: import("vue").ComputedRef<boolean>;
     clearRemoved: () => void;
     commitPendingAppend: () => Promise<void>;

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

@@ -1,6 +1,4 @@
 import type { VibeViewerItem } from '../viewer';
-import { type VibeSurfaceMode } from './removalState';
-import type { VibeAssetLoadQueueLimits } from './useAssetLoadQueue';
 export type { VibeHandle, VibeRemoveResult } from './removalState';
 export type { VibeFeedMode, VibeLoadPhase } from './removalState';
 export interface VibeResolveParams {
@@ -21,13 +19,12 @@ export interface VibeInitialState {
     activeIndex?: number;
 }
 interface VibeSharedProps {
-    assetLoadLimits?: Partial<VibeAssetLoadQueueLimits>;
     hasPreviousPage?: boolean;
     paginationDetail?: string | null;
     requestNextPage?: (() => void | Promise<void>) | null;
     requestPreviousPage?: (() => void | Promise<void>) | null;
+    showEndBadge?: boolean;
     showStatusBadges?: boolean;
-    surfaceMode?: VibeSurfaceMode;
 }
 export interface VibeControlledProps extends VibeSharedProps {
     items: VibeViewerItem[];
@@ -63,6 +60,7 @@ export type VibeProps = VibeControlledProps | VibeAutoProps;
 export type VibeEmit = (event: 'update:activeIndex', value: number) => void;
 export declare function useDataSource(props: Readonly<VibeProps>, emit: VibeEmit): {
     activeIndex: import("vue").ComputedRef<number>;
+    canRefreshExhaustedNextPage: import("vue").ComputedRef<boolean>;
     canRetryInitialLoad: import("vue").ComputedRef<boolean>;
     cancel: () => void;
     clearRemoved: () => void;

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

@@ -2,6 +2,7 @@ import { type Ref } from 'vue';
 import type { VibeViewerItem } from '../viewer';
 export declare function useVibeMasonryList(options: {
     active: Ref<boolean>;
+    allowExhaustedNextPageRefresh: Ref<boolean>;
     items: Ref<VibeViewerItem[]>;
     activeIndex: Ref<number>;
     loading: Ref<boolean>;

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

@@ -4,8 +4,7 @@ import { formatPlaybackTime } from './format';
 import { type VibeProps } from './useDataSource';
 export type { VibeResolveParams, VibeResolveResult, VibeAutoProps, VibeControlledProps, VibeEmit, VibeFeedMode, VibeHandle, VibeInitialState, VibeLoadPhase, VibeProps, } from './useDataSource';
 export type { VibeAssetErrorKind } from './loadError';
-export type { VibeStatus, VibeSurfaceMode } from './removalState';
-export type { VibeAssetLoadQueueLimits } from './useAssetLoadQueue';
+export type { VibeStatus } from './removalState';
 export type { VibeAssetErrorEvent, VibeAssetErrorReporter, VibeAssetErrorSurface, VibeAssetLoadEvent, VibeAssetLoadReporter, VibeAssetLoadSurface } from './assetErrors';
 export declare function useViewer(props: Readonly<VibeProps>, emit: (event: 'update:activeIndex', value: number) => void, options?: {
     enabled?: Ref<boolean>;