@wyxos/vibe 5.4.1 → 5.5.0

package/README.md

@@ -125,6 +125,7 @@ item and the same removal, restoration, reel, and pagination behavior:
 
 ```ts
 masonry: {
+  minColumnWidth: 400,
   overscan: {
     minimumPx: 600,
     viewportMultiplier: 0.5,
@@ -133,6 +134,9 @@ masonry: {
 },
 ```
 
+`minColumnWidth` defaults to `240` CSS pixels. Raising it produces fewer,
+larger masonry columns without constraining the feed container.
+
 Low-priority images in that overscan window use native lazy loading, and
 low-priority masonry videos defer metadata until they reach the real viewport.
 Reel preload behavior remains unchanged.

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

@@ -1,6 +1,7 @@
 import type { VibeMasonryOptions } from '../core/masonryOptions';
 import { type VibeRuntimeState } from '../core/runtime';
 import type { VibeCardRegion, VibeFeedFooter, VibeFeedFooterActions, VibeItemId, VibeMediaCardOptions, VibeMediaLifecycleContext, VibeReelInfoSheetOptions, VibeReelItemTarget, VibeReelNavigationResult } from '../types';
+import type { VibeItemRemovalOptions } from '../core/itemRemovalOptions';
 type __VLS_Props = {
     canRetryEnd: boolean;
     cardFooter?: VibeCardRegion;
@@ -17,7 +18,7 @@ declare function changeActiveReelMedia(direction: -1 | 1): boolean;
 declare function moveActiveReelPost(direction: -1 | 1): boolean;
 declare function navigateToReelItem(target: VibeReelItemTarget): VibeReelNavigationResult;
 declare function getAutoScrollElement(): HTMLElement | null;
-declare function startItemRemoval(postIds: readonly VibeItemId[]): number;
+declare function startItemRemoval(postIds: readonly VibeItemId[], options?: VibeItemRemovalOptions): number;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
     changeActiveReelMedia: typeof changeActiveReelMedia;
     getAutoScrollElement: typeof getAutoScrollElement;

package/lib/core/feed.d.ts

@@ -1,4 +1,5 @@
 import type { VibeCardRegion, VibeFeedFooter, VibeFeedFooterActions, VibeItem, VibeItemId, VibeMediaSource, VibeMediaCardOptions, VibeReelAutoAdvanceState, VibeReelForwardState, VibeReelInfoSheetOptions, VibeReelItemTarget, VibeReelNavigationResult, VibeReelOrigin, VibeState } from '../types';
+import type { VibeItemRemovalOptions } from './itemRemovalOptions';
 import type { VibeMasonryOptions } from './masonryOptions';
 import type { MediaPreviewState } from './mediaPreview';
 export interface FeedRendererProps {
@@ -56,7 +57,7 @@ export interface VibeSurfaceExpose {
     loadIfNearBottom: () => Promise<void>;
     moveActiveReelPost: (direction: -1 | 1) => boolean;
     navigateToReelItem: (target: VibeReelItemTarget) => VibeReelNavigationResult;
-    startItemRemoval: (postIds: readonly VibeItemId[]) => number;
+    startItemRemoval: (postIds: readonly VibeItemId[], options?: VibeItemRemovalOptions) => number;
     transitionActiveReelMedia: (direction: -1 | 1) => Promise<boolean>;
     transitionActiveReelPost: (postId: VibeItemId) => Promise<boolean>;
 }

package/lib/core/itemRemovalController.d.ts

@@ -1,11 +1,12 @@
 import type { VibeRuntimeState } from './runtime';
 import type { VibeItemId, VibeItemPlacement, VibeRemoval } from '../types';
+import type { VibeItemRemovalOptions } from './itemRemovalOptions';
 interface ItemRemovalControllerOptions {
     historyLimit?: number;
     onItemsRemoved: (removal: VibeRemoval, placements: readonly VibeItemPlacement[], activeIndex: number) => void;
     onRemovalRestored: (removal: VibeRemoval) => void;
     prepareRemoval: (postIds: readonly VibeItemId[]) => Promise<void>;
-    startRemoval: (postIds: readonly VibeItemId[]) => number;
+    startRemoval: (postIds: readonly VibeItemId[], options?: VibeItemRemovalOptions) => number;
     state: VibeRuntimeState;
 }
 export declare class ItemRemovalController {
@@ -19,7 +20,7 @@ export declare class ItemRemovalController {
     private readonly stopItemsWatcher;
     constructor(options: ItemRemovalControllerOptions);
     destroy(): void;
-    remove(postIds: readonly VibeItemId[]): Promise<VibeRemoval>;
+    remove(postIds: readonly VibeItemId[], options?: VibeItemRemovalOptions): Promise<VibeRemoval>;
     reset(): void;
     restoreItems(placements: readonly VibeItemPlacement[]): void;
     restoreRemoval(removal: VibeRemoval): boolean;

package/lib/core/itemRemovalOptions.d.ts

@@ -0,0 +1,3 @@
+export interface VibeItemRemovalOptions {
+    staggerMs?: number;
+}

package/lib/core/masonryOptions.d.ts

@@ -4,9 +4,12 @@ export interface VibeMasonryOverscanOptions {
     viewportMultiplier?: number;
 }
 export interface VibeMasonryOptions {
+    minColumnWidth?: number;
     overscan?: VibeMasonryOverscanOptions;
 }
+export declare const DEFAULT_MASONRY_MIN_COLUMN_WIDTH = 240;
 export declare const DEFAULT_MASONRY_OVERSCAN_MINIMUM_PX = 800;
 export declare const DEFAULT_MASONRY_OVERSCAN_VIEWPORT_MULTIPLIER = 1.5;
+export declare function resolveMasonryMinColumnWidth(options: VibeMasonryOptions | undefined): number;
 export declare function resolveMasonryOverscan(options: VibeMasonryOptions | undefined, viewportHeight: number): number;
 export declare function validateMasonryOptions(options?: VibeMasonryOptions): void;

package/lib/core/masonryViewportIndex.d.ts

@@ -0,0 +1,16 @@
+import type { MasonryPosition, MasonryViewportOptions } from './masonry';
+interface MasonryViewportIndexEntry {
+    bottom: number;
+    index: number;
+    top: number;
+}
+export interface MasonryViewportIndex {
+    columns: readonly (readonly MasonryViewportIndexEntry[])[];
+}
+export interface MasonryViewportQuery {
+    indices: number[];
+    inspected: number;
+}
+export declare function createMasonryViewportIndex(items: readonly MasonryPosition[], sourceIndices?: readonly number[]): MasonryViewportIndex;
+export declare function queryMasonryViewportIndex(index: MasonryViewportIndex, options: MasonryViewportOptions): MasonryViewportQuery;
+export {};