vlist 3.1.0-next.3 → 3.1.1

package/README.github.md

@@ -2,7 +2,7 @@
 
 The virtual list library for every framework. Ultra efficient, batteries-included, and accessible with composable plugins.
 
-**v3.1.0-next.3** (prerelease on the npm `next` tag) — Vue, Svelte, Solid and React entries in the package itself: `vlist/vue`, `vlist/svelte`, `vlist/solid` and `vlist/react`, feature-first and tree-shaken like the vanilla builder; the separate adapter packages are deprecated. With `scroll.mode` from 3.1.0-next.2: the default, `"auto"`, scrolls natively and hands a list past the browser's size limit to synthetic input. See the [changelog](https://github.com/floor/vlist/blob/next/CHANGELOG.md).
+**v3.1.1** — `scroll.mode` on the one `vlist` entry: the default, `"auto"`, scrolls natively and hands a list past the browser's size limit to synthetic input, which draws its own scrollbar. Vue, Svelte, Solid and React entries in the package itself (`vlist/vue`, `vlist/svelte`, `vlist/solid`, `vlist/react`), feature-first and tree-shaken like the vanilla builder; the separate adapter packages are deprecated. See the [changelog](https://github.com/floor/vlist/blob/main/CHANGELOG.md).
 
 [![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)
@@ -267,8 +267,8 @@ The touch-only `.vlist-item--touch-sort` class suppresses selection and callouts
 | **Base (`vlist`)** | 27.3 KB | 10.3 KB |
 | `vlist/synthetic` (deprecated) | 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.3 KB |
+| `a11y()` | 32.0 KB | 12.0 KB |
+| `selection()` | 37.8 KB | 13.6 KB |
 | `data()` | 41.0 KB | 15.1 KB |
 | `scrollbar()` | 35.5 KB | 13.2 KB |
 | `sortable()` | 39.2 KB | 13.9 KB |
@@ -278,9 +278,9 @@ The touch-only `.vlist-item--touch-sort` class suppresses selection and callouts
 | `transition()` | 34.1 KB | 12.3 KB |
 | `autosize()` | 30.6 KB | 11.5 KB |
 | `grid()` | 34.7 KB | 12.9 KB |
-| `table()` | 45.8 KB | 16.2 KB |
+| `table()` | 46.3 KB | 16.4 KB |
 | `masonry()` | 39.4 KB | 14.7 KB |
-| `tree()` | 43.5 KB | 15.7 KB |
+| `tree()` | 43.1 KB | 15.6 KB |
 | `search()` | 36.9 KB | 13.6 KB |
 | `carousel()` | 43.2 KB | 15.8 KB |
 | `vlist/synthetic` + `carousel()` | 49.3 KB | 18.1 KB |
@@ -321,10 +321,19 @@ const myTable = createVList({
   selection({ mode: 'single' }),
 ])
 
+myTable.on('column:click', ({ key, index, event }) => { /* a header cell was clicked */ })
 myTable.on('column:sort', ({ key, direction }) => { /* re-sort data */ })
 myTable.on('column:resize', ({ key, width }) => { /* persist widths */ })
 ```
 
+A control supplied in a header `label` that is not one of `a[href]`, `button`, `input`, `select`,
+`textarea` or an element with `tabindex` — a custom element with a button in its shadow root, or a
+`div` with `role="button"` and no `tabindex` — runs its own handler, and the click still reaches the
+cell, which sorts the column when it is sortable: give the control `tabindex`, or call
+`stopPropagation()` in its handler. `column:click` is emitted for a pointer click or tap only;
+Enter and Space emit `column:sort` on a sortable header and never `column:click`, so an action a
+keyboard user must reach should be a `button` supplied in the header label.
+
 ### Grid Layout
 
 ```typescript
@@ -423,9 +432,9 @@ adapter instead. It cannot be combined with `tree()` either: filtering a tree
 means keeping the ancestors of each match, which belongs to the plugin that
 owns the layout, and `tree()` offers no such hook.
 
-## Custom scrollbar (3.0 preview)
+## Custom scrollbar
 
-On `next`, `scrollbar()` remains a plugin. macOS and Android default to thin,
+`scrollbar()` is a plugin. macOS and Android default to thin,
 rounded, auto-hiding overlays; Windows defaults to a wider, square, always-visible
 bar. Set `gutter: true` to reserve space. The same behavior works horizontally.
 

package/README.md

@@ -2,7 +2,7 @@
 
 The virtual list library for every framework. Ultra efficient, batteries-included, and accessible with composable plugins.
 
-**v3.1.0-next.3** (prerelease on the npm `next` tag) — Vue, Svelte, Solid and React entries in the package itself: `vlist/vue`, `vlist/svelte`, `vlist/solid` and `vlist/react`, feature-first and tree-shaken like the vanilla builder; the separate adapter packages are deprecated. With `scroll.mode` from 3.1.0-next.2: the default, `"auto"`, scrolls natively and hands a list past the browser's size limit to synthetic input. See the [changelog](https://github.com/floor/vlist/blob/next/CHANGELOG.md).
+**v3.1.1** — `scroll.mode` on the one `vlist` entry: the default, `"auto"`, scrolls natively and hands a list past the browser's size limit to synthetic input, which draws its own scrollbar. Vue, Svelte, Solid and React entries in the package itself (`vlist/vue`, `vlist/svelte`, `vlist/solid`, `vlist/react`), feature-first and tree-shaken like the vanilla builder; the separate adapter packages are deprecated. See the [changelog](https://github.com/floor/vlist/blob/main/CHANGELOG.md).
 
 [![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)
@@ -134,8 +134,8 @@ The touch-only `.vlist-item--touch-sort` class suppresses selection and callouts
 | **Base (`vlist`)** | 27.3 KB | 10.3 KB |
 | `vlist/synthetic` (deprecated) | 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.3 KB |
+| `a11y()` | 32.0 KB | 12.0 KB |
+| `selection()` | 37.8 KB | 13.6 KB |
 | `data()` | 41.0 KB | 15.1 KB |
 | `scrollbar()` | 35.5 KB | 13.2 KB |
 | `sortable()` | 39.2 KB | 13.9 KB |
@@ -145,9 +145,9 @@ The touch-only `.vlist-item--touch-sort` class suppresses selection and callouts
 | `transition()` | 34.1 KB | 12.3 KB |
 | `autosize()` | 30.6 KB | 11.5 KB |
 | `grid()` | 34.7 KB | 12.9 KB |
-| `table()` | 45.8 KB | 16.2 KB |
+| `table()` | 46.3 KB | 16.4 KB |
 | `masonry()` | 39.4 KB | 14.7 KB |
-| `tree()` | 43.5 KB | 15.7 KB |
+| `tree()` | 43.1 KB | 15.6 KB |
 | `search()` | 36.9 KB | 13.6 KB |
 | `carousel()` | 43.2 KB | 15.8 KB |
 | `vlist/synthetic` + `carousel()` | 49.3 KB | 18.1 KB |