vlist 3.0.0 → 3.0.1-next.1

package/dist/types.d.ts

@@ -294,15 +294,30 @@ export interface ScrollConfig {
      * Useful for carousels, wizards, and circular navigation.
      */
     wrap?: boolean;
-    /** Native visibility: "none" hides the browser scrollbar, "native" keeps it.
-     * Options are consumed by vlist/config; with the low-level factory install
-     * scrollbar() explicitly. The synthetic entry rejects both string values.
+    /** "none": no scrollbar, the browser's or the one a synthetic list draws.
+     * "native" keeps the browser's, so it needs native input. Options configure
+     * the scrollbar a synthetic list draws, and vlist/config installs
+     * scrollbar() from them.
      */
     scrollbar?: "native" | "none" | ScrollbarOptions;
     /** External scroll element for window scrolling */
     element?: Window;
     /** Scroll idle detection timeout in ms (default: 150) */
     idleTimeout?: number;
+    /**
+     * Who owns scroll input (RFC-015, default: `"auto"`).
+     * - `"auto"` — native scrolling; past the browser's element size limit
+     *   (16,000,000 px of content) the list swaps to synthetic input in place,
+     *   and back below 12,000,000 px.
+     * - `"native"` — always native; past the limit the last rows are out of reach.
+     * - `"synthetic"` — vlist owns wheel, touch and keys from the start.
+     *
+     * The synthetic driver is a separate chunk, downloaded the first time a
+     * list needs it; until then the list scrolls natively. A synthetic list
+     * draws a scrollbar, since the browser draws none: `scroll.scrollbar`
+     * configures it, "none" skips it, and a list with scrollbar() keeps that one.
+     */
+    mode?: "auto" | "native" | "synthetic";
 }
 /** Custom scrollbar fine-tuning options */
 export interface ScrollbarOptions {
@@ -534,6 +549,10 @@ export interface VListEvents<T extends VListItem = VListItem> extends EventMap {
     "scroll:idle": {
         scrollPosition: number;
     };
+    /** Scroll input swapped in place (`scroll.mode`, RFC-015). */
+    "scroll:mode": {
+        mode: "native" | "synthetic";
+    };
     /** Data changed — fired after item removal or other data mutations */
     "data:change": {
         type: "insert";

package/dist/version.json

@@ -0,0 +1 @@
+{"version":"3.0.1-next.1","commit":"75053a1","builtAt":"2026-09-27T20:48:01.516Z","released":true}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vlist",
-  "version": "3.0.0",
+  "version": "3.0.1-next.1",
   "description": "Lightweight, high-performance virtual list with zero dependencies",
   "author": {
     "name": "Floor IO",
@@ -69,6 +69,7 @@
     "dist/**/*.d.ts",
     "dist/**/*.css",
     "dist/size.json",
+    "dist/version.json",
     "!dist/**/*.d.ts.map"
   ],
   "sideEffects": [
@@ -79,7 +80,7 @@
     "dev": "bun run build.ts --watch",
     "test": "bun test",
     "test:changed": "bun test --changed",
-    "test:browser": "bun scripts/rtl-cross-axis-browser.mjs && bun scripts/synthetic-browser.mjs && bun scripts/synthetic-carousel-browser.mjs && bun scripts/synthetic-sortable-browser.mjs && bun scripts/select-next-browser.mjs && bun scripts/item-fill-browser.mjs",
+    "test:browser": "bun scripts/rtl-cross-axis-browser.mjs && bun scripts/synthetic-browser.mjs && bun scripts/synthetic-carousel-browser.mjs && bun scripts/synthetic-sortable-browser.mjs && bun scripts/select-next-browser.mjs && bun scripts/item-fill-browser.mjs && bun scripts/scroll-mode-browser.mjs && bun scripts/native-cap-browser.mjs",
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.types.json && tsc --noEmit -p tsconfig.test.json",
     "bench": "bun run scripts/bench.ts",
     "bench:quick": "bun run scripts/bench.ts --quick",