vlist 2.1.2 → 2.2.0

package/README.github.md

@@ -2,7 +2,7 @@
 
 The virtual list library for every framework. Ultra efficient, batteries-included, and accessible with composable plugins — in 8.0 KB.
 
-**v2.1.2** — [Changelog](./CHANGELOG.md) · Groups + masonry integration, grid render hot-path optimization, horizontal sticky group headers.
+**v2.2.0** — [Changelog](./CHANGELOG.md) · Table `fillWidth` (fills the container by default), async loading resilience (reload keeps placeholders, auto-retry with backoff), table placeholder skeletons.
 
 [![npm version](https://img.shields.io/npm/v/vlist.svg)](https://www.npmjs.com/package/vlist)
 [![bundle size](https://img.shields.io/bundlephobia/minzip/vlist)](https://bundlephobia.com/package/vlist)
@@ -95,7 +95,7 @@ const list = createVList({
 | Plugin | Size | Description |
 |--------|------|-------------|
 | **Base** | 8.0 KB | Virtualization, ARIA, keyboard nav, gap, padding |
-| `data()` | +4.7 KB | Lazy loading with velocity-aware fetching |
+| `data()` | +4.8 KB | Lazy loading with velocity-aware fetching |
 | `selection()` | +2.5 KB | Single/multiple selection with 2D keyboard nav |
 | `scale()` | +3.9 KB | 1M+ items via scroll compression |
 | `groups()` | +5.2 KB | Sticky/inline headers with grid + masonry + table + data integration |
@@ -103,11 +103,11 @@ const list = createVList({
 | `scrollbar()` | +2.0 KB | Custom scrollbar UI |
 | `grid()` | +2.9 KB | 2D grid layout |
 | `masonry()` | +3.7 KB | Pinterest-style masonry with lane-aware keyboard nav |
-| `table()` | +6.1 KB | Data table with columns, resize, sort |
+| `table()` | +6.2 KB | Data table with columns, resize, sort |
 | `tree()` | +5.3 KB | Collapsible tree with async loading and indent guides |
 | `page()` | +0.8 KB | Window-level scrolling |
 | `sortable()` | +2.9 KB | Drag-and-drop reordering with auto-scroll |
-| `snapshots()` | +1.2 KB | Scroll position save/restore |
+| `snapshots()` | +1.3 KB | Scroll position save/restore |
 | `transition()` | +1.8 KB | FLIP-based enter/exit animations for insert & remove |
 
 ## Examples

package/README.md

@@ -2,7 +2,7 @@
 
 The virtual list library for every framework. Ultra efficient, batteries-included, and accessible with composable plugins — in 8.0 KB.
 
-**v2.1.2** — [Changelog](https://github.com/floor/vlist/blob/main/CHANGELOG.md) · **New:** groups + masonry integration, grid render hot-path optimization, and horizontal sticky group headers.
+**v2.2.0** — [Changelog](https://github.com/floor/vlist/blob/main/CHANGELOG.md) · **New:** table `fillWidth` (fills the container by default), async loading resilience (reload keeps placeholders, auto-retry with backoff), and table placeholder skeletons.
 
 [![npm version](https://img.shields.io/npm/v/vlist.svg)](https://www.npmjs.com/package/vlist)
 [![bundle size](https://img.shields.io/bundlephobia/minzip/vlist)](https://bundlephobia.com/package/vlist)
@@ -57,7 +57,7 @@ const list = createVList({ container: '#app', items, item: { height: 200, templa
 | Plugin | Size | Description |
 |--------|------|-------------|
 | **Base** | 8.0 KB | Virtualization, ARIA, keyboard nav, gap, padding |
-| `data()` | +4.7 KB | Lazy loading with velocity-aware fetching |
+| `data()` | +4.8 KB | Lazy loading with velocity-aware fetching |
 | `selection()` | +2.5 KB | Single/multiple selection with 2D keyboard nav |
 | `scale()` | +3.9 KB | 1M+ items via scroll compression |
 | `groups()` | +5.2 KB | Sticky/inline headers with grid + masonry + table + data integration |
@@ -65,10 +65,10 @@ const list = createVList({ container: '#app', items, item: { height: 200, templa
 | `scrollbar()` | +2.0 KB | Custom scrollbar UI |
 | `grid()` | +2.9 KB | 2D grid layout |
 | `masonry()` | +3.7 KB | Pinterest-style masonry with lane-aware keyboard nav |
-| `table()` | +6.1 KB | Data table with columns, resize, sort |
+| `table()` | +6.2 KB | Data table with columns, resize, sort |
 | `page()` | +0.8 KB | Window-level scrolling |
 | `sortable()` | +2.9 KB | Drag-and-drop reordering with auto-scroll |
-| `snapshots()` | +1.2 KB | Scroll position save/restore |
+| `snapshots()` | +1.3 KB | Scroll position save/restore |
 | `transition()` | +1.8 KB | FLIP-based enter/exit animations for insert & remove |
 
 ## Framework Adapters

package/dist/constants.d.ts

@@ -27,6 +27,11 @@ export declare const PRELOAD_VELOCITY_THRESHOLD = 2;
 export declare const LOAD_VELOCITY_THRESHOLD = 15;
 /** Maximum concurrent chunk requests (0 = unlimited) */
 export declare const MAX_CONCURRENT_LOADS = 6;
+/** Initial delay before auto-retrying a failed load (ms) */
+export declare const LOAD_RETRY_BASE_DELAY = 2000;
+/** Maximum delay between auto-retries of a failed load (ms) — caps the
+ *  exponential backoff so recovery stays responsive once the network returns */
+export declare const LOAD_RETRY_MAX_DELAY = 30000;
 /**
  * Maximum virtual size in pixels along the main axis
  * Most browsers support ~16.7M pixels, we use 16M for safety margin