vlist 2.5.1 → 2.6.1

package/dist/size.json

@@ -1 +1 @@
-{"base":{"minified":"27.4","gzipped":"9.9","minBytes":28063,"gzBytes":10126},"a11y":{"minified":"30.5","gzipped":"11.0","minBytes":31210,"gzBytes":11273},"selection":{"minified":"36.6","gzipped":"12.6","minBytes":37451,"gzBytes":12911},"data":{"minified":"41.1","gzipped":"14.7","minBytes":42081,"gzBytes":15067},"scrollbar":{"minified":"34.5","gzipped":"11.9","minBytes":35325,"gzBytes":12177},"sortable":{"minified":"36.8","gzipped":"12.9","minBytes":37696,"gzBytes":13195},"groups":{"minified":"43.3","gzipped":"15.2","minBytes":44380,"gzBytes":15586},"page":{"minified":"29.8","gzipped":"10.7","minBytes":30549,"gzBytes":10910},"snapshots":{"minified":"30.7","gzipped":"11.0","minBytes":31417,"gzBytes":11310},"transition":{"minified":"34.2","gzipped":"11.7","minBytes":34987,"gzBytes":11998},"autosize":{"minified":"29.8","gzipped":"10.7","minBytes":30539,"gzBytes":10996},"grid":{"minified":"34.4","gzipped":"12.3","minBytes":35246,"gzBytes":12622},"table":{"minified":"45.7","gzipped":"15.7","minBytes":46799,"gzBytes":16096},"masonry":{"minified":"38.5","gzipped":"13.9","minBytes":39384,"gzBytes":14234},"tree":{"minified":"42.5","gzipped":"14.9","minBytes":43550,"gzBytes":15271},"search":{"minified":"36.5","gzipped":"13.1","minBytes":37376,"gzBytes":13371},"carousel":{"minified":"36.9","gzipped":"13.3","minBytes":37777,"gzBytes":13656}}
+{"base":{"minified":"27.4","gzipped":"9.9","minBytes":28063,"gzBytes":10126},"a11y":{"minified":"30.7","gzipped":"11.1","minBytes":31393,"gzBytes":11359},"selection":{"minified":"36.8","gzipped":"12.7","minBytes":37682,"gzBytes":13000},"data":{"minified":"41.1","gzipped":"14.7","minBytes":42081,"gzBytes":15067},"scrollbar":{"minified":"34.5","gzipped":"11.9","minBytes":35325,"gzBytes":12177},"sortable":{"minified":"36.8","gzipped":"12.9","minBytes":37696,"gzBytes":13195},"groups":{"minified":"43.3","gzipped":"15.2","minBytes":44380,"gzBytes":15586},"page":{"minified":"29.8","gzipped":"10.7","minBytes":30549,"gzBytes":10910},"snapshots":{"minified":"30.7","gzipped":"11.0","minBytes":31417,"gzBytes":11310},"transition":{"minified":"34.2","gzipped":"11.7","minBytes":34987,"gzBytes":11998},"autosize":{"minified":"29.8","gzipped":"10.7","minBytes":30539,"gzBytes":10996},"grid":{"minified":"34.4","gzipped":"12.3","minBytes":35246,"gzBytes":12622},"table":{"minified":"45.7","gzipped":"15.7","minBytes":46799,"gzBytes":16096},"masonry":{"minified":"38.5","gzipped":"13.9","minBytes":39384,"gzBytes":14234},"tree":{"minified":"42.5","gzipped":"14.9","minBytes":43550,"gzBytes":15271},"search":{"minified":"36.5","gzipped":"13.1","minBytes":37376,"gzBytes":13371},"carousel":{"minified":"36.9","gzipped":"13.3","minBytes":37777,"gzBytes":13656}}

package/dist/types.d.ts

@@ -304,6 +304,23 @@ export interface ScrollConfig {
     element?: Window;
     /** Scroll idle detection timeout in ms (default: 150) */
     idleTimeout?: number;
+    /**
+     * Scroll model (RFC-012). `"native"` (default) sizes the content element to
+     * the full virtual size — simple, but hits the browser's ~16.7M px limit.
+     * `"bounded"` sizes the content to a viewport-multiple runway and rebases a
+     * logical origin near the edges, supporting unbounded item counts without
+     * compressing the scroll space.
+     */
+    mode?: "native" | "bounded";
+    /**
+     * Runway size as a multiple of the viewport, used only with
+     * `mode: "bounded"` (default 2). The bounded content element is sized to
+     * `viewport × runway` (capped at the real virtual size). Larger values mean
+     * more native-scroll headroom and less frequent rebasing, at the cost of a
+     * bigger content element. Clamped up to a minimum of 1.5 so native scroll and
+     * touch momentum always have some room.
+     */
+    runway?: number;
 }
 /** Custom scrollbar fine-tuning options */
 export interface ScrollbarOptions {

package/dist/utils/grid-nav.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Clamp a PageUp/PageDown target index so it preserves the column in grid mode.
+ *
+ * For a linear list (`columns <= 1`) this is a plain `[0, total-1]` clamp. In a
+ * grid, overshooting the top/bottom should land on the **same column** of the
+ * first/last row — not the absolute first/last item, which would duplicate the
+ * Home/End behavior (and, on a boundary row, wrongly jump to the corner instead
+ * of staying put). See floor/vlist#60.
+ *
+ * @param target  The raw target index (`current ± pageSize`), may be out of range.
+ * @param current The current focused index.
+ * @param columns Grid column count (`nav.ud`); 1 for a linear list.
+ * @param total   Total item count.
+ */
+export declare function clampPageTarget(target: number, current: number, columns: number, total: number): number;
+//# sourceMappingURL=grid-nav.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vlist",
-  "version": "2.5.1",
+  "version": "2.6.1",
   "description": "Lightweight, high-performance virtual list with zero dependencies",
   "author": {
     "name": "Floor IO",
@@ -34,6 +34,11 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js",
+      "default": "./dist/config.js"
+    },
     "./internals": {
       "types": "./dist/internals.d.ts",
       "import": "./dist/internals.js",