vlist 3.0.0 → 3.0.1-next.1

package/README.github.md

@@ -11,7 +11,7 @@ The virtual list library for every framework. Ultra efficient, batteries-include
 
 - **Accessible** — `a11y()` or a selection mode adds WAI-ARIA, 2D keyboard navigation, focus recovery, screen-reader DOM ordering
 - **Zero dependencies** — framework-agnostic core with tiny adapters for Vue, Svelte, Solid, React
-- **10.0 KB gzipped** — composable plugins with perfect tree-shaking
+- **10.3 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, carousel, table, groups, data, selection, search, sortable, transition** — all opt-in
 - **Axis-neutral** — vertical and horizontal scrolling through a single code path, all plugins work in both orientations
@@ -172,35 +172,35 @@ The touch-only `.vlist-item--touch-sort` class suppresses selection and callouts
 | Flat `PluginContext` members (`registerMethod`, `forceRender`, `sizeCache`, `scrollTo`, …) | Grouped by capability: `ctx.hooks.method`, `ctx.render.force`, `ctx.sizes.cache`, `ctx.scroll.to`, `ctx.items.all`. `pool`, `config`, `emitter`, `template` and `getState()` stay at the top level. |
 | `scale()` and `ScalePluginConfig` | Remove them; use `vlist/synthetic` for the full logical range. Config no longer installs a scale stub. |
 
-Removed mode/runway options throw a migration error before creating DOM. `vlist/config` wires only what the config asks for: `selection`, the custom scrollbar, `snapshots` and `a11y` are each opt-in, so an adapter list matches a core list built from the same options. It keeps the scrollbar options convenience and its top-level `scrollbar: "none"`; pass `scrollbar: true` for the overlay scrollbar earlier versions added to every list. `baseOffset` stays private engine state; plugins use `ctx.scroll.getRenderOrigin()`. Custom wrap providers now supply their handler factory as the second argument of `ctx.scroll.setBoundedWrap`.
+Removed mode/runway options throw a migration error before creating DOM. `vlist/config` wires only what the config asks for: `selection`, the custom scrollbar, `snapshots` and `a11y` are each opt-in, so an adapter list matches a core list built from the same options. It keeps the scrollbar options convenience and its top-level `scrollbar: "none"`; pass `scrollbar: true` for the overlay scrollbar earlier versions added to every list. `baseOffset` stays private engine state; plugins use `ctx.scroll.getRenderOrigin()`. Custom wrap providers supply their handler factory as the second argument of `ctx.scroll.setWrap` (named `setBoundedWrap` in 3.0.0, still accepted).
 
 ## Plugins
 
 | Entry / export | Minified | Gzipped |
 |---|---:|---:|
-| **Base (`vlist`)** | 27.0 KB | 10.0 KB |
-| `vlist/synthetic` | 33.9 KB | 12.6 KB |
-| `vlist/native` (alias) | 27.0 KB | 10.0 KB |
-| `a11y()` | 30.8 KB | 11.4 KB |
-| `selection()` | 36.5 KB | 12.9 KB |
-| `data()` | 40.6 KB | 14.8 KB |
-| `scrollbar()` | 35.1 KB | 12.8 KB |
-| `sortable()` | 38.9 KB | 13.6 KB |
-| `groups()` | 43.0 KB | 15.4 KB |
-| `page()` | 29.5 KB | 10.9 KB |
-| `snapshots()` | 30.3 KB | 11.1 KB |
-| `transition()` | 33.7 KB | 12.0 KB |
-| `autosize()` | 30.2 KB | 11.1 KB |
-| `grid()` | 34.4 KB | 12.5 KB |
-| `table()` | 45.4 KB | 15.9 KB |
-| `masonry()` | 39.0 KB | 14.4 KB |
-| `tree()` | 43.1 KB | 15.3 KB |
-| `search()` | 36.5 KB | 13.3 KB |
-| `carousel()` | 41.7 KB | 15.2 KB |
-| `vlist/synthetic` + `carousel()` | 47.8 KB | 17.4 KB |
-| `vlist/synthetic` + `sortable()` | 45.8 KB | 16.2 KB |
-
-Sizes are tree-shaken totals from `bun run size`, not additive plugin costs. Plugin rows include the native default factory plus that plugin. The base is **10,201 bytes gzipped**, within the 10.0 KB budget (10,240 bytes). `bun run size` fails if a scenario fails to build, an unused plugin leaks into a bundle, or any published size exceeds its gzip budget. Synthetic input is **12,893 bytes** before plugins. The alias row measures the same source factory; the distributed alias re-exports it without duplicating the implementation.
+| **Base (`vlist`)** | 27.3 KB | 10.3 KB |
+| `vlist/synthetic` | 34.2 KB | 12.9 KB |
+| `vlist/native` (alias) | 27.3 KB | 10.3 KB |
+| `a11y()` | 31.2 KB | 11.7 KB |
+| `selection()` | 36.9 KB | 13.2 KB |
+| `data()` | 40.9 KB | 15.1 KB |
+| `scrollbar()` | 35.5 KB | 13.2 KB |
+| `sortable()` | 39.2 KB | 13.9 KB |
+| `groups()` | 43.4 KB | 15.7 KB |
+| `page()` | 29.8 KB | 11.2 KB |
+| `snapshots()` | 30.6 KB | 11.4 KB |
+| `transition()` | 34.0 KB | 12.3 KB |
+| `autosize()` | 30.6 KB | 11.4 KB |
+| `grid()` | 34.7 KB | 12.9 KB |
+| `table()` | 45.8 KB | 16.2 KB |
+| `masonry()` | 39.4 KB | 14.7 KB |
+| `tree()` | 43.5 KB | 15.7 KB |
+| `search()` | 36.8 KB | 13.6 KB |
+| `carousel()` | 42.2 KB | 15.4 KB |
+| `vlist/synthetic` + `carousel()` | 48.3 KB | 17.7 KB |
+| `vlist/synthetic` + `sortable()` | 46.1 KB | 16.5 KB |
+
+Sizes are tree-shaken totals from `bun run size`, not additive plugin costs. Plugin rows include the native default factory plus that plugin. The base is **10,531 bytes gzipped**, within the 10.3 KB budget (10,547 bytes). `bun run size` fails if a scenario fails to build, an unused plugin leaks into a bundle, or any published size exceeds its gzip budget. Synthetic input is **13,172 bytes** before plugins; with `scroll.mode`, a `vlist` list downloads the driver and its scrollbar as `synthetic-driver.js` (6.2 KB gzipped) only when it goes synthetic. The alias row measures the same source factory; the distributed alias re-exports it without duplicating the implementation.
 
 ## Examples
 

package/README.md

@@ -11,7 +11,7 @@ The virtual list library for every framework. Ultra efficient, batteries-include
 
 - **Accessible** — `a11y()` or a selection mode adds WAI-ARIA, 2D keyboard navigation, focus recovery, screen-reader DOM ordering
 - **Zero dependencies** — framework-agnostic core, tiny adapters for Vue, Svelte, Solid, React
-- **10.0 KB gzipped** — composable plugins with perfect tree-shaking
+- **10.3 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
 
@@ -118,35 +118,35 @@ The touch-only `.vlist-item--touch-sort` class suppresses selection and callouts
 | `PluginContext.setScrollFns`, `disableDefaultScroll` | Use `setScrollSource` to supply an external position source and commit callback. |
 | `scale()` and `ScalePluginConfig` | Remove them; use `vlist/synthetic` for the full logical range. Config no longer installs a scale stub. |
 
-Removed mode/runway options throw a migration error before creating DOM. `vlist/config` wires only what the config asks for: `selection`, the custom scrollbar, `snapshots` and `a11y` are each opt-in, so an adapter list matches a core list built from the same options. It keeps the scrollbar options convenience and its top-level `scrollbar: "none"`; pass `scrollbar: true` for the overlay scrollbar earlier versions added to every list. `baseOffset` stays private engine state; plugins use `ctx.scroll.getRenderOrigin()`. Custom wrap providers now supply their handler factory as the second argument of `ctx.scroll.setBoundedWrap`.
+Removed mode/runway options throw a migration error before creating DOM. `vlist/config` wires only what the config asks for: `selection`, the custom scrollbar, `snapshots` and `a11y` are each opt-in, so an adapter list matches a core list built from the same options. It keeps the scrollbar options convenience and its top-level `scrollbar: "none"`; pass `scrollbar: true` for the overlay scrollbar earlier versions added to every list. `baseOffset` stays private engine state; plugins use `ctx.scroll.getRenderOrigin()`. Custom wrap providers supply their handler factory as the second argument of `ctx.scroll.setWrap` (named `setBoundedWrap` in 3.0.0, still accepted).
 
 ## Plugins
 
 | Entry / export | Minified | Gzipped |
 |---|---:|---:|
-| **Base (`vlist`)** | 27.0 KB | 10.0 KB |
-| `vlist/synthetic` | 33.9 KB | 12.6 KB |
-| `vlist/native` (alias) | 27.0 KB | 10.0 KB |
-| `a11y()` | 30.8 KB | 11.4 KB |
-| `selection()` | 36.5 KB | 12.9 KB |
-| `data()` | 40.6 KB | 14.8 KB |
-| `scrollbar()` | 35.1 KB | 12.8 KB |
-| `sortable()` | 38.9 KB | 13.6 KB |
-| `groups()` | 43.0 KB | 15.4 KB |
-| `page()` | 29.5 KB | 10.9 KB |
-| `snapshots()` | 30.3 KB | 11.1 KB |
-| `transition()` | 33.7 KB | 12.0 KB |
-| `autosize()` | 30.2 KB | 11.1 KB |
-| `grid()` | 34.4 KB | 12.5 KB |
-| `table()` | 45.4 KB | 15.9 KB |
-| `masonry()` | 39.0 KB | 14.4 KB |
-| `tree()` | 43.1 KB | 15.3 KB |
-| `search()` | 36.5 KB | 13.3 KB |
-| `carousel()` | 41.7 KB | 15.2 KB |
-| `vlist/synthetic` + `carousel()` | 47.8 KB | 17.4 KB |
-| `vlist/synthetic` + `sortable()` | 45.8 KB | 16.2 KB |
-
-Sizes are tree-shaken totals from `bun run size`, not additive plugin costs. Plugin rows include the native default factory plus that plugin. The base is **10,201 bytes gzipped**, within the 10.0 KB budget (10,240 bytes). `bun run size` fails if a scenario fails to build, an unused plugin leaks into a bundle, or any published size exceeds its gzip budget. Synthetic input is **12,893 bytes** before plugins. The alias row measures the same source factory; the distributed alias re-exports it without duplicating the implementation.
+| **Base (`vlist`)** | 27.3 KB | 10.3 KB |
+| `vlist/synthetic` | 34.2 KB | 12.9 KB |
+| `vlist/native` (alias) | 27.3 KB | 10.3 KB |
+| `a11y()` | 31.2 KB | 11.7 KB |
+| `selection()` | 36.9 KB | 13.2 KB |
+| `data()` | 40.9 KB | 15.1 KB |
+| `scrollbar()` | 35.5 KB | 13.2 KB |
+| `sortable()` | 39.2 KB | 13.9 KB |
+| `groups()` | 43.4 KB | 15.7 KB |
+| `page()` | 29.8 KB | 11.2 KB |
+| `snapshots()` | 30.6 KB | 11.4 KB |
+| `transition()` | 34.0 KB | 12.3 KB |
+| `autosize()` | 30.6 KB | 11.4 KB |
+| `grid()` | 34.7 KB | 12.9 KB |
+| `table()` | 45.8 KB | 16.2 KB |
+| `masonry()` | 39.4 KB | 14.7 KB |
+| `tree()` | 43.5 KB | 15.7 KB |
+| `search()` | 36.8 KB | 13.6 KB |
+| `carousel()` | 42.2 KB | 15.4 KB |
+| `vlist/synthetic` + `carousel()` | 48.3 KB | 17.7 KB |
+| `vlist/synthetic` + `sortable()` | 46.1 KB | 16.5 KB |
+
+Sizes are tree-shaken totals from `bun run size`, not additive plugin costs. Plugin rows include the native default factory plus that plugin. The base is **10,531 bytes gzipped**, within the 10.3 KB budget (10,547 bytes). `bun run size` fails if a scenario fails to build, an unused plugin leaks into a bundle, or any published size exceeds its gzip budget. Synthetic input is **13,172 bytes** before plugins; with `scroll.mode`, a `vlist` list downloads the driver and its scrollbar as `synthetic-driver.js` (6.2 KB gzipped) only when it goes synthetic. The alias row measures the same source factory; the distributed alias re-exports it without duplicating the implementation.
 
 ## Framework Adapters
 

package/dist/config.d.ts

@@ -41,7 +41,7 @@ export type VListFactory<T extends VListItem = VListItem> = typeof createVList<T
  * translated into plugins by {@link resolvePlugins}.
  */
 export interface VListConfig<T extends VListItem = VListItem> extends Omit<CreateVListConfig<T>, "container" | "scroll"> {
-    /** Scroll options; select synthetic input with a factory from vlist/synthetic. */
+    /** Scroll options; `scroll.mode` chooses native, synthetic or auto input. */
     scroll?: ScrollConfig;
     /** List factory; defaults to core createVList. Fixed for this instance. */
     factory?: VListFactory<T>;