vlist 2.1.1 → 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.1** — [Changelog](./CHANGELOG.md) · Native groups + table + data + grid cross-plugin integration, pixel-perfect snapshot restore, keyboard nav fixes.
+**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,15 +95,15 @@ 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()` | +4.8 KB | Sticky/inline headers with grid + table + data integration |
+| `groups()` | +5.2 KB | Sticky/inline headers with grid + masonry + table + data integration |
 | `autosize()` | +0.8 KB | Auto-measure items via ResizeObserver |
 | `scrollbar()` | +2.0 KB | Custom scrollbar UI |
-| `grid()` | +2.8 KB | 2D grid layout |
+| `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 |

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.0** — [Changelog](https://github.com/floor/vlist/blob/main/CHANGELOG.md) · **New:** [`tree()`](https://vlist.io/docs/plugins/tree) plugin — virtualized collapsible trees with async loading, indent guides, and WAI-ARIA treeview keyboard nav.
+**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)
@@ -56,16 +56,16 @@ const list = createVList({ container: '#app', items, item: { height: 200, templa
 
 | Plugin | Size | Description |
 |--------|------|-------------|
-| **Base** | 7.9 KB | Virtualization, ARIA, keyboard nav, gap, padding |
-| `data()` | +4.6 KB | Lazy loading with velocity-aware fetching |
-| `selection()` | +2.4 KB | Single/multiple selection with 2D keyboard nav |
+| **Base** | 8.0 KB | Virtualization, ARIA, keyboard nav, gap, padding |
+| `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()` | +3.7 KB | Sticky/inline headers with async group discovery |
+| `groups()` | +5.2 KB | Sticky/inline headers with grid + masonry + table + data integration |
 | `autosize()` | +0.8 KB | Auto-measure items via ResizeObserver |
 | `scrollbar()` | +2.0 KB | Custom scrollbar UI |
-| `grid()` | +2.7 KB | 2D grid layout |
-| `masonry()` | +3.6 KB | Pinterest-style masonry with lane-aware keyboard nav |
-| `table()` | +6.1 KB | Data table with columns, resize, sort |
+| `grid()` | +2.9 KB | 2D grid layout |
+| `masonry()` | +3.7 KB | Pinterest-style masonry with lane-aware keyboard nav |
+| `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.3 KB | Scroll position save/restore |

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