vlist 2.1.2 → 2.3.0

package/README.github.md

@@ -1,8 +1,8 @@
 # vlist
 
-The virtual list library for every framework. Ultra efficient, batteries-included, and accessible with composable plugins — in 8.0 KB.
+The virtual list library for every framework. Ultra efficient, batteries-included, and accessible with composable plugins — in 8.1 KB.
 
-**v2.1.2** — [Changelog](./CHANGELOG.md) · Groups + masonry integration, grid render hot-path optimization, horizontal sticky group headers.
+**v2.3.0** — [Changelog](./CHANGELOG.md) · **New:** `search()` plugin with filter/navigate modes and match highlighting. Pixel-perfect keyboard navigation for scale, grid, masonry, and groups. Tree click selection consistency.
 
 [![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)
@@ -11,9 +11,9 @@ The virtual list library for every framework. Ultra efficient, batteries-include
 
 - **Accessible** — WAI-ARIA, 2D keyboard navigation, focus recovery, screen-reader DOM ordering
 - **Zero dependencies** — framework-agnostic core with tiny adapters for Vue, Svelte, Solid, React
-- **8.0 KB gzipped** — composable plugins with perfect tree-shaking
+- **8.1 KB gzipped** — composable plugins with perfect tree-shaking
 - **Constant memory** — ~0.1 MB overhead at any scale, from 10K to 1M+ items
-- **Tree, grid, masonry, table, groups, data, selection, sortable, transition, scale** — all opt-in
+- **Tree, grid, masonry, table, groups, data, selection, search, sortable, transition, scale** — all opt-in
 - **Axis-neutral** — vertical and horizontal scrolling through a single code path, all plugins work in both orientations
 
 **18 interactive examples, docs & benchmarks → [vlist.io](https://vlist.io)**
@@ -94,20 +94,21 @@ 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 |
-| `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 |
+| **Base** | 8.1 KB | Virtualization, ARIA, keyboard nav, gap, padding |
+| `data()` | +4.8 KB | Lazy loading with velocity-aware fetching |
+| `selection()` | +2.6 KB | Single/multiple selection with 2D keyboard nav |
+| `search()` | +3.2 KB | Search bar: filter/navigate modes, match highlighting |
+| `scale()` | +4.2 KB | 1M+ items via scroll compression |
+| `groups()` | +5.3 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.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 |
+| `grid()` | +3.0 KB | 2D grid layout |
+| `masonry()` | +4.0 KB | Pinterest-style masonry with lane-aware keyboard nav |
+| `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 |
+| `page()` | +0.7 KB | Window-level scrolling |
+| `sortable()` | +2.8 KB | Drag-and-drop reordering with auto-scroll |
+| `snapshots()` | +1.3 KB | Scroll position save/restore |
 | `transition()` | +1.8 KB | FLIP-based enter/exit animations for insert & remove |
 
 ## Examples
@@ -215,6 +216,24 @@ const list = createVList({
 ])
 ```
 
+### Search
+
+```typescript
+import { createVList, search } from 'vlist'
+import 'vlist/styles/search'
+
+const list = createVList({
+  container: '#app',
+  items: people,
+  item: { height: 48, template: renderPerson },
+}, [
+  // Zero-config: a search bar at the top, Ctrl/⌘+F to focus, type to filter,
+  // matches highlighted with <mark>. Use mode: 'navigate' to jump between
+  // matches instead of hiding non-matches.
+  search(),
+])
+```
+
 ## Accessibility
 
 Every vlist is accessible by default following the [WAI-ARIA listbox pattern](https://www.w3.org/WAI/ARIA/apg/patterns/listbox/):

package/README.md

@@ -1,8 +1,8 @@
 # vlist
 
-The virtual list library for every framework. Ultra efficient, batteries-included, and accessible with composable plugins — in 8.0 KB.
+The virtual list library for every framework. Ultra efficient, batteries-included, and accessible with composable plugins — in 8.1 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.3.0** — [Changelog](https://github.com/floor/vlist/blob/main/CHANGELOG.md) · **New:** `search()` plugin with filter/navigate modes and match highlighting. Pixel-perfect keyboard navigation for scale, grid, masonry, and groups.
 
 [![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)
@@ -11,7 +11,7 @@ The virtual list library for every framework. Ultra efficient, batteries-include
 
 - **Accessible** — WAI-ARIA, 2D keyboard navigation, focus recovery, screen-reader DOM ordering
 - **Zero dependencies** — framework-agnostic core, tiny adapters for Vue, Svelte, Solid, React
-- **8.0 KB gzipped** — composable plugins with perfect tree-shaking
+- **8.1 KB gzipped** — composable plugins with perfect tree-shaking
 - **Constant memory** — ~0.1 MB overhead at any scale, from 10K to 1M+ items
 - **Axis-neutral** — vertical and horizontal scrolling through a single code path, all plugins work in both orientations
 
@@ -56,19 +56,20 @@ 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 |
-| `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 |
+| **Base** | 8.1 KB | Virtualization, ARIA, keyboard nav, gap, padding |
+| `data()` | +4.8 KB | Lazy loading with velocity-aware fetching |
+| `selection()` | +2.6 KB | Single/multiple selection with 2D keyboard nav |
+| `search()` | +3.2 KB | Search bar: filter/navigate modes, match highlighting |
+| `scale()` | +4.2 KB | 1M+ items via scroll compression |
+| `groups()` | +5.3 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.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 |
-| `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 |
+| `grid()` | +3.0 KB | 2D grid layout |
+| `masonry()` | +4.0 KB | Pinterest-style masonry with lane-aware keyboard nav |
+| `table()` | +6.2 KB | Data table with columns, resize, sort |
+| `page()` | +0.7 KB | Window-level scrolling |
+| `sortable()` | +2.8 KB | Drag-and-drop reordering with auto-scroll |
+| `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

package/dist/index.d.ts

@@ -37,6 +37,8 @@ export { sortable } from "./plugins/sortable";
 export type { SortablePluginConfig } from "./plugins/sortable";
 export { tree } from "./plugins/tree";
 export type { TreePluginConfig, FlatNode } from "./plugins/tree";
+export { search, DEFAULT_SEARCH_TEXT } from "./plugins/search";
+export type { SearchPluginConfig, SearchText } from "./plugins/search";
 export { createStats } from "./utils/stats";
 export type { Stats, StatsConfig, StatsState } from "./utils/stats";
 export { rebuild } from "./utils/rebuild";