vlist 2.0.1 → 2.0.3

package/README.github.md

@@ -2,7 +2,7 @@
 
 The virtual list library for every framework. Ultra efficient, batteries-included, and accessible with composable plugins — in 7.7 KB.
 
-**v2.0.0** — [Changelog](./CHANGELOG.md) · **v2 is a ground-up rewrite** with a new plugin API. Coming from v1? See [Migration Guide](https://vlist.io/docs/migration).
+**v2.0.3** — [Changelog](./CHANGELOG.md) · **v2 is a ground-up rewrite** with a new plugin API. Coming from v1? See [Migration Guide](https://vlist.io/docs/migration).
 
 [![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)
@@ -14,7 +14,7 @@ The virtual list library for every framework. Ultra efficient, batteries-include
 - **7.7 KB gzipped** — composable plugins with perfect tree-shaking
 - **Constant memory** — ~0.1 MB overhead at any scale, from 10K to 1M+ items
 - **Grid, masonry, table, groups, data, selection, sortable, transition, scale** — all opt-in
-- **Vertical & horizontal** — single axis-neutral code path, every plugin works in both orientations
+- **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)**
 
@@ -99,12 +99,12 @@ const list = createVList({
 | `selection()` | +2.4 KB | Single/multiple selection with 2D keyboard nav |
 | `scale()` | +3.9 KB | 1M+ items via scroll compression |
 | `groups()` | +3.7 KB | Sticky/inline headers with async group discovery |
-| `autosize()` | +0.7 KB | Auto-measure items via ResizeObserver |
+| `autosize()` | +0.9 KB | Auto-measure items via ResizeObserver |
 | `scrollbar()` | +2.0 KB | Custom scrollbar UI |
 | `grid()` | +2.1 KB | 2D grid layout |
 | `masonry()` | +3.5 KB | Pinterest-style masonry with lane-aware keyboard nav |
 | `table()` | +5.8 KB | Data table with columns, resize, sort |
-| `page()` | +0.7 KB | Window-level scrolling |
+| `page()` | +0.8 KB | Window-level scrolling |
 | `sortable()` | +2.9 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 |

package/README.md

@@ -2,7 +2,7 @@
 
 The virtual list library for every framework. Ultra efficient, batteries-included, and accessible with composable plugins — in 7.7 KB.
 
-**v2.0.0** — [Changelog](https://github.com/floor/vlist/blob/main/CHANGELOG.md) · **v2 is a ground-up rewrite** with a new plugin API. Coming from v1? See [Migration Guide](https://vlist.io/docs/migration).
+**v2.0.3** — [Changelog](https://github.com/floor/vlist/blob/main/CHANGELOG.md) · **v2 is a ground-up rewrite** with a new plugin API. Coming from v1? See [Migration Guide](https://vlist.io/docs/migration).
 
 [![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)
@@ -13,7 +13,7 @@ The virtual list library for every framework. Ultra efficient, batteries-include
 - **Zero dependencies** — framework-agnostic core, tiny adapters for Vue, Svelte, Solid, React
 - **7.7 KB gzipped** — composable plugins with perfect tree-shaking
 - **Constant memory** — ~0.1 MB overhead at any scale, from 10K to 1M+ items
-- **Vertical & horizontal** — single axis-neutral code path, every plugin works in both orientations
+- **Axis-neutral** — vertical and horizontal scrolling through a single code path, all plugins work in both orientations
 
 ## Install
 

package/dist/core/dom.d.ts

@@ -4,5 +4,5 @@
  */
 import type { DOMStructure } from "./types";
 export declare function resolveContainer(container: HTMLElement | string): HTMLElement;
-export declare function createDOMStructure(container: HTMLElement, classPrefix: string, horizontal: boolean, interactive: boolean, ariaLabel?: string): DOMStructure;
+export declare function createDOMStructure(container: HTMLElement, classPrefix: string, isX: boolean, interactive: boolean, ariaLabel?: string): DOMStructure;
 //# sourceMappingURL=dom.d.ts.map

package/dist/core/index.d.ts

@@ -13,5 +13,5 @@ export { createDOMStructure, resolveContainer } from "./dom";
 export { createScrollHandler } from "./scroll";
 export type { SizeCache } from "./sizes";
 export type { ScrollHandler, ScrollHandlerConfig } from "./scroll";
-export type { CalculateHook, CommitHook, AfterScrollHook, IdleHook, ResizeHook, CompiledHooks, ResolvedConfig, DOMStructure, ElementPool, VisibleRangeFn, PluginContext, VListPlugin, VList, CreateVListConfig, } from "./types";
+export type { Axis, AxisConfig, CalculateHook, CommitHook, AfterScrollHook, IdleHook, ResizeHook, CompiledHooks, ResolvedConfig, DOMStructure, ElementPool, PluginContext, VListPlugin, VList, CreateVListConfig, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/pipeline.d.ts

@@ -21,9 +21,9 @@ export interface RenderConfig {
     readonly placeholderClass: string;
     readonly replacedClass: string;
     readonly translateProp: "translateX(" | "translateY(";
+    readonly sizeProp: "width" | "height";
     readonly itemRole: "option" | "listitem";
     readonly interactive: boolean;
-    readonly horizontal: boolean;
     readonly startPadding: number;
     readonly gap: number;
     readonly hasCrossPad: boolean;
@@ -34,7 +34,7 @@ export interface RenderConfig {
     readonly oddClass: string;
     readonly emitter: Emitter<VListEvents> | null;
 }
-export declare function createRenderConfig(classPrefix: string, horizontal: boolean, interactive: boolean, startPadding: number, crossPadStart: number, crossPadEnd: number, oddClass: string, gap: number, emitter?: Emitter<VListEvents> | null): RenderConfig;
+export declare function createRenderConfig(classPrefix: string, isX: boolean, interactive: boolean, startPadding: number, crossPadStart: number, crossPadEnd: number, oddClass: string, gap: number, emitter?: Emitter<VListEvents> | null): RenderConfig;
 /**
  * Calculate visible range and fill EngineState buffers.
  * Zero allocation — all writes go into pre-allocated TypedArrays.

package/dist/core/scroll.d.ts

@@ -12,13 +12,13 @@ export interface ScrollHandler {
     detach(): void;
     /** Cancel smooth scroll animation */
     cancelScroll(): void;
-    /** Animate to a target scroll position */
-    smoothScrollTo(target: number, duration: number, setFn?: (pos: number) => void, easing?: (t: number) => number): void;
+    /** Animate to a target scroll position (target may be a function for dynamic tracking) */
+    smoothScrollTo(target: number | (() => number), duration: number, setFn?: (pos: number) => void, easing?: (t: number) => number, onComplete?: () => void): void;
 }
 export interface ScrollHandlerConfig {
     readonly state: EngineState;
     readonly viewport: HTMLElement;
-    readonly horizontal: boolean;
+    readonly isX: boolean;
     readonly wheelEnabled: boolean;
     readonly idleTimeout: number;
     /** Override the event target for scroll/wheel listeners (default: viewport) */

package/dist/core/types.d.ts

@@ -25,9 +25,15 @@ export interface CompiledHooks {
     readonly idle: readonly IdleHook[];
     readonly resize: readonly ResizeHook[];
 }
+export type Axis = "x" | "y";
+export interface AxisConfig {
+    readonly primary: Axis;
+    readonly cross?: Axis;
+}
 export interface ResolvedConfig {
+    readonly axis: AxisConfig;
+    readonly hasCrossAxis: boolean;
     readonly overscan: number;
-    readonly horizontal: boolean;
     readonly reverse: boolean;
     readonly classPrefix: string;
     readonly interactive: boolean;
@@ -52,11 +58,6 @@ export interface ElementPool {
     readonly size: number;
     clear(): void;
 }
-export type VisibleRangeFn = (scrollPosition: number, containerSize: number, sizeCache: SizeCache, totalItems: number, outStart: {
-    value: number;
-}, outEnd: {
-    value: number;
-}) => void;
 export interface PluginContext<T extends VListItem = VListItem> {
     readonly dom: DOMStructure;
     readonly sizeCache: SizeCache;
@@ -70,7 +71,6 @@ export interface PluginContext<T extends VListItem = VListItem> {
     registerKeydownHandler(handler: (event: KeyboardEvent) => void): void;
     registerDestroyHandler(handler: () => void): void;
     setSizeConfig(config: number | ((index: number) => number)): void;
-    setVisibleRangeFn(fn: VisibleRangeFn): void;
     setScrollFns(get: () => number, set: (pos: number) => void): void;
     setVirtualTotalFn(fn: () => number): void;
     getItems(): readonly T[];
@@ -86,7 +86,7 @@ export interface PluginContext<T extends VListItem = VListItem> {
     getItemStateFn(): ((index: number, state: ItemState) => void) | null;
     readonly rawSizeSpec: number | ((index: number, ...args: unknown[]) => number);
     scrollTo(position: number): void;
-    smoothScrollTo(position: number, duration: number, easing?: (t: number) => number): void;
+    smoothScrollTo(target: number | (() => number), duration: number, easing?: (t: number) => number, onComplete?: () => void): void;
     disableDefaultScroll(): void;
     disableDefaultResize(): void;
     setScrollTarget(target: EventTarget): void;

package/dist/index.d.ts

@@ -38,5 +38,5 @@ export type { SortablePluginConfig } from "./plugins/sortable";
 export { createStats } from "./utils/stats";
 export type { Stats, StatsConfig, StatsState } from "./utils/stats";
 export type { VListItem, VListEvents, ItemConfig, ItemTemplate, ItemState, SelectionMode, SelectionConfig, SelectionState, ScrollbarConfig, ScrollbarPadding, ScrollbarOptions, ScrollConfig, ScrollToOptions, ScrollSnapshot, VListAdapter, AdapterParams, AdapterResponse, Range, ViewportState, EventHandler, Unsubscribe, GridConfig, MasonryConfig, GroupsConfig, GroupHeaderConfig, GridSizeContext, GridHeightContext, } from "./types";
-export type { VList, VListPlugin, PluginContext, CreateVListConfig, CompiledHooks, ResolvedConfig, DOMStructure, ElementPool, } from "./core/types";
+export type { Axis, AxisConfig, VList, VListPlugin, PluginContext, CreateVListConfig, CompiledHooks, ResolvedConfig, DOMStructure, ElementPool, } from "./core/types";
 //# sourceMappingURL=index.d.ts.map