vlist 1.9.1 → 2.0.0

package/dist/rendering/viewport.js

@@ -0,0 +1,268 @@
+/**
+ * vlist - Virtual Scrolling Core
+ * Pure functions for virtual scroll calculations
+ *
+ * Compression support is NOT imported here — it's injected via
+ * CompressionState parameters. When compression is inactive
+ * (the common case), all calculations use simple size-cache math
+ * with zero dependency on the compression module.
+ *
+ * This keeps the builder core lightweight. The withCompression feature
+ * and the monolithic createVList entry point import compression
+ * separately and pass the state in.
+ */
+/**
+ * A "no compression" state for lists that don't need it.
+ * Used by the builder core when withCompression is not installed.
+ */
+export const NO_COMPRESSION = {
+    isCompressed: false,
+    actualSize: 0,
+    virtualSize: 0,
+    ratio: 1,
+};
+/**
+ * Create a trivial compression state from a size cache.
+ * No compression logic — just reads the total height.
+ * For use when the full compression module is not loaded.
+ */
+export const getSimpleCompressionState = (_totalItems, sizeCache) => {
+    const h = sizeCache.getTotalSize();
+    return {
+        isCompressed: false,
+        actualSize: h,
+        virtualSize: h,
+        ratio: 1,
+    };
+};
+// =============================================================================
+// Simple (non-compressed) range calculation
+// =============================================================================
+/**
+ * Calculate visible range using size cache lookups.
+ * Fast path for lists that don't need compression (< ~350 000 items at 48px).
+ * Mutates `out` to avoid allocation on the scroll hot path.
+ */
+export const simpleVisibleRange = (scrollPosition, containerHeight, sizeCache, totalItems, _compression, out) => {
+    if (totalItems === 0 || containerHeight === 0) {
+        out.start = 0;
+        out.end = -1;
+        return out;
+    }
+    const start = sizeCache.indexAtOffset(scrollPosition);
+    let end = sizeCache.indexAtOffset(scrollPosition + containerHeight);
+    if (end < totalItems - 1)
+        end++;
+    out.start = Math.max(0, start);
+    out.end = Math.min(totalItems - 1, Math.max(0, end));
+    return out;
+};
+/**
+ * Calculate render range (adds overscan around visible range).
+ * This function is compression-agnostic — works for both paths.
+ * Mutates `out` to avoid allocation on the scroll hot path.
+ */
+export const calculateRenderRange = (visibleRange, overscan, totalItems, out) => {
+    if (totalItems === 0) {
+        out.start = 0;
+        out.end = -1;
+        return out;
+    }
+    out.start = Math.max(0, visibleRange.start - overscan);
+    out.end = Math.min(totalItems - 1, visibleRange.end + overscan);
+    return out;
+};
+/**
+ * Simple scroll-to-index calculation (non-compressed).
+ * Uses size cache offsets directly.
+ */
+export const simpleScrollToIndex = (index, sizeCache, containerHeight, totalItems, _compression, align) => {
+    if (totalItems === 0)
+        return 0;
+    const safeIndex = Math.max(0, Math.min(index, totalItems - 1));
+    const itemOffset = sizeCache.getOffset(safeIndex);
+    const itemSize = sizeCache.getSize(safeIndex);
+    const totalHeight = sizeCache.getTotalSize();
+    const maxScroll = Math.max(0, totalHeight - containerHeight);
+    let position;
+    switch (align) {
+        case "center":
+            position = itemOffset - containerHeight / 2 + itemSize / 2;
+            break;
+        case "end":
+            position = itemOffset - containerHeight + itemSize;
+            break;
+        case "start":
+        default:
+            position = itemOffset;
+            break;
+    }
+    return Math.max(0, Math.min(position, maxScroll));
+};
+// =============================================================================
+// Calculate total content height
+// =============================================================================
+/**
+ * Calculate total content height.
+ * Uses compression's virtualSize when compressed, raw height otherwise.
+ */
+export const calculateTotalSize = (_totalItems, sizeCache, compression) => {
+    if (compression && compression.isCompressed) {
+        return compression.virtualSize;
+    }
+    return sizeCache.getTotalSize();
+};
+/**
+ * Calculate actual total size (without compression cap)
+ */
+export const calculateActualSize = (_totalItems, sizeCache) => {
+    return sizeCache.getTotalSize();
+};
+/**
+ * Calculate the offset (translateY) for an item
+ * For non-compressed lists only
+ */
+export const calculateItemOffset = (index, sizeCache) => {
+    return sizeCache.getOffset(index);
+};
+// =============================================================================
+// Scroll helpers
+// =============================================================================
+/**
+ * Clamp scroll position to valid range
+ */
+export const clampScrollPosition = (scrollPosition, totalHeight, containerHeight) => {
+    const maxScroll = Math.max(0, totalHeight - containerHeight);
+    return Math.max(0, Math.min(scrollPosition, maxScroll));
+};
+/**
+ * Determine scroll direction
+ */
+export const getScrollDirection = (currentScrollTop, previousScrollTop) => {
+    return currentScrollTop >= previousScrollTop ? "down" : "up";
+};
+// =============================================================================
+// Viewport State
+// =============================================================================
+/**
+ * Create initial viewport state.
+ *
+ * Accepts an optional `visibleRangeFn` so that compression-aware callers
+ * can inject the compressed version. Defaults to `simpleVisibleRange`.
+ */
+export const createViewportState = (containerHeight, sizeCache, totalItems, overscan, compression, visibleRangeFn = simpleVisibleRange) => {
+    const visibleRange = { start: 0, end: 0 };
+    const renderRange = { start: 0, end: 0 };
+    visibleRangeFn(0, containerHeight, sizeCache, totalItems, compression, visibleRange);
+    calculateRenderRange(visibleRange, overscan, totalItems, renderRange);
+    return {
+        scrollPosition: 0,
+        containerSize: containerHeight,
+        totalSize: compression.virtualSize,
+        actualSize: compression.actualSize,
+        isCompressed: compression.isCompressed,
+        compressionRatio: compression.ratio,
+        visibleRange,
+        renderRange,
+    };
+};
+/**
+ * Update viewport state after scroll.
+ * Mutates state in place for performance on the scroll hot path.
+ */
+export const updateViewportState = (state, scrollPosition, sizeCache, totalItems, overscan, compression, visibleRangeFn = simpleVisibleRange) => {
+    visibleRangeFn(scrollPosition, state.containerSize, sizeCache, totalItems, compression, state.visibleRange);
+    calculateRenderRange(state.visibleRange, overscan, totalItems, state.renderRange);
+    state.scrollPosition = scrollPosition;
+    return state;
+};
+/**
+ * Update viewport state when container resizes.
+ * Mutates state in place for performance.
+ */
+export const updateViewportSize = (state, containerHeight, sizeCache, totalItems, overscan, compression, visibleRangeFn = simpleVisibleRange) => {
+    visibleRangeFn(state.scrollPosition, containerHeight, sizeCache, totalItems, compression, state.visibleRange);
+    calculateRenderRange(state.visibleRange, overscan, totalItems, state.renderRange);
+    state.containerSize = containerHeight;
+    state.totalSize = compression.virtualSize;
+    state.actualSize = compression.actualSize;
+    state.isCompressed = compression.isCompressed;
+    state.compressionRatio = compression.ratio;
+    return state;
+};
+/**
+ * Update viewport state when total items changes.
+ * Mutates state in place for performance.
+ */
+export const updateViewportItems = (state, sizeCache, totalItems, overscan, compression, visibleRangeFn = simpleVisibleRange) => {
+    visibleRangeFn(state.scrollPosition, state.containerSize, sizeCache, totalItems, compression, state.visibleRange);
+    calculateRenderRange(state.visibleRange, overscan, totalItems, state.renderRange);
+    state.totalSize = compression.virtualSize;
+    state.actualSize = compression.actualSize;
+    state.isCompressed = compression.isCompressed;
+    state.compressionRatio = compression.ratio;
+    return state;
+};
+// =============================================================================
+// calculateScrollToIndex (public API)
+// =============================================================================
+/**
+ * Calculate scroll position to bring an index into view.
+ *
+ * Accepts an optional `scrollToIndexFn` so that compression-aware callers
+ * can inject the compressed version. Defaults to `simpleScrollToIndex`.
+ */
+export const calculateScrollToIndex = (index, sizeCache, containerHeight, totalItems, align = "start", compression, scrollToIndexFn = simpleScrollToIndex) => {
+    return scrollToIndexFn(index, sizeCache, containerHeight, totalItems, compression, align);
+};
+// =============================================================================
+// Range Utilities
+// =============================================================================
+/**
+ * Check if two ranges are equal
+ */
+export const rangesEqual = (a, b) => {
+    return a.start === b.start && a.end === b.end;
+};
+/**
+ * Check if an index is within a range
+ */
+export const isInRange = (index, range) => {
+    return index >= range.start && index <= range.end;
+};
+/**
+ * Get the count of items in a range
+ */
+export const getRangeCount = (range) => {
+    if (range.end < range.start)
+        return 0;
+    return range.end - range.start + 1;
+};
+/**
+ * Create an array of indices from a range
+ */
+export const rangeToIndices = (range) => {
+    const indices = [];
+    for (let i = range.start; i <= range.end; i++) {
+        indices.push(i);
+    }
+    return indices;
+};
+/**
+ * Calculate which indices need to be added/removed when range changes
+ */
+export const diffRanges = (oldRange, newRange) => {
+    const add = [];
+    const remove = [];
+    for (let i = oldRange.start; i <= oldRange.end; i++) {
+        if (i < newRange.start || i > newRange.end) {
+            remove.push(i);
+        }
+    }
+    for (let i = newRange.start; i <= newRange.end; i++) {
+        if (i < oldRange.start || i > oldRange.end) {
+            add.push(i);
+        }
+    }
+    return { add, remove };
+};

package/dist/size.json

@@ -1 +1 @@
-{"base":{"minified":"29.9","gzipped":"11.3","minBytes":30593,"gzBytes":11560},"withGrid":{"minified":"42.6","gzipped":"15.4","minBytes":43664,"gzBytes":15748},"withMasonry":{"minified":"40.0","gzipped":"14.8","minBytes":40966,"gzBytes":15126},"withGroups":{"minified":"45.0","gzipped":"16.0","minBytes":46049,"gzBytes":16380},"withAsync":{"minified":"42.8","gzipped":"15.9","minBytes":43778,"gzBytes":16270},"withSelection":{"minified":"40.2","gzipped":"14.1","minBytes":41139,"gzBytes":14484},"withScale":{"minified":"42.2","gzipped":"14.9","minBytes":43190,"gzBytes":15284},"withScrollbar":{"minified":"36.1","gzipped":"13.1","minBytes":36957,"gzBytes":13447},"withPage":{"minified":"32.0","gzipped":"12.0","minBytes":32717,"gzBytes":12274},"withSnapshots":{"minified":"33.6","gzipped":"12.5","minBytes":34430,"gzBytes":12811},"withTable":{"minified":"48.6","gzipped":"17.1","minBytes":49802,"gzBytes":17530},"withSortable":{"minified":"39.0","gzipped":"14.2","minBytes":39976,"gzBytes":14528},"withAutoSize":{"minified":"32.4","gzipped":"12.2","minBytes":33192,"gzBytes":12447},"withTransition":{"minified":"37.3","gzipped":"13.4","minBytes":38184,"gzBytes":13722}}
+{"base":{"minified":"21.5","gzipped":"7.8","minBytes":22029,"gzBytes":7991},"a11y":{"minified":"24.5","gzipped":"8.9","minBytes":25124,"gzBytes":9125},"selection":{"minified":"29.8","gzipped":"10.2","minBytes":30498,"gzBytes":10467},"data":{"minified":"34.3","gzipped":"12.5","minBytes":35172,"gzBytes":12764},"scrollbar":{"minified":"28.7","gzipped":"9.8","minBytes":29341,"gzBytes":10061},"sortable":{"minified":"30.9","gzipped":"10.7","minBytes":31632,"gzBytes":10979},"groups":{"minified":"32.8","gzipped":"11.5","minBytes":33587,"gzBytes":11806},"scale":{"minified":"34.7","gzipped":"11.7","minBytes":35515,"gzBytes":11963},"page":{"minified":"23.9","gzipped":"8.6","minBytes":24507,"gzBytes":8767},"snapshots":{"minified":"25.1","gzipped":"9.1","minBytes":25737,"gzBytes":9297},"transition":{"minified":"28.2","gzipped":"9.6","minBytes":28912,"gzBytes":9870},"autosize":{"minified":"23.4","gzipped":"8.5","minBytes":23920,"gzBytes":8688},"grid":{"minified":"27.5","gzipped":"9.9","minBytes":28162,"gzBytes":10133},"table":{"minified":"39.7","gzipped":"13.6","minBytes":40615,"gzBytes":13922},"masonry":{"minified":"31.2","gzipped":"11.4","minBytes":31980,"gzBytes":11626}}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * vlist - Core Types
+ * Minimal, clean interfaces for the virtual list
+ */
+export {};

package/dist/utils/padding.d.ts

@@ -1,12 +1,10 @@
 /**
  * vlist/utils — Padding Resolution
  * Shared helpers for resolving the CSS-shorthand padding config into
- * concrete pixel values. Used by core (to apply CSS) and by features
+ * concrete pixel values. Used by core (to apply CSS) and by plugins
  * (to subtract cross-axis padding from container dimensions).
  */
-import type { BuilderConfig } from "../builder/types";
-/** Padding config — re-exported from BuilderConfig for convenience */
-export type PaddingConfig = NonNullable<BuilderConfig["padding"]>;
+export type PaddingConfig = number | [number, number] | [number, number, number, number];
 /** Resolved padding — all four sides in pixels */
 export interface ResolvedPadding {
     readonly top: number;

package/dist/utils/padding.js

@@ -0,0 +1,49 @@
+/**
+ * vlist/utils — Padding Resolution
+ * Shared helpers for resolving the CSS-shorthand padding config into
+ * concrete pixel values. Used by core (to apply CSS) and by plugins
+ * (to subtract cross-axis padding from container dimensions).
+ */
+// =============================================================================
+// Resolve All Sides
+// =============================================================================
+/** Zero padding singleton — avoids allocation when padding is undefined */
+const ZERO = { top: 0, right: 0, bottom: 0, left: 0 };
+/**
+ * Resolve a padding config into all four sides.
+ *
+ * - `undefined`        → { 0, 0, 0, 0 }
+ * - `number`           → equal on all sides
+ * - `[v, h]`           → top/bottom = v, left/right = h
+ * - `[t, r, b, l]`     → per-side (CSS order)
+ *
+ * Returns a frozen singleton for the zero case (no allocation).
+ */
+export const resolvePadding = (padding) => {
+    if (padding == null)
+        return ZERO;
+    if (typeof padding === "number") {
+        return padding === 0 ? ZERO : { top: padding, right: padding, bottom: padding, left: padding };
+    }
+    if (padding.length === 2) {
+        const [v, h] = padding;
+        return (v === 0 && h === 0) ? ZERO : { top: v, right: h, bottom: v, left: h };
+    }
+    const [top, right, bottom, left] = padding;
+    return (top === 0 && right === 0 && bottom === 0 && left === 0)
+        ? ZERO
+        : { top, right, bottom, left };
+};
+// =============================================================================
+// Axis Helpers
+// =============================================================================
+/**
+ * Total padding along the main axis (scroll direction).
+ * Vertical → top + bottom. Horizontal → left + right.
+ */
+export const mainAxisPaddingFrom = (p, isHorizontal) => isHorizontal ? p.left + p.right : p.top + p.bottom;
+/**
+ * Total padding along the cross axis (perpendicular to scroll).
+ * Vertical → left + right. Horizontal → top + bottom.
+ */
+export const crossAxisPaddingFrom = (p, isHorizontal) => isHorizontal ? p.top + p.bottom : p.left + p.right;

package/dist/utils/stats.js

@@ -0,0 +1,124 @@
+// src/utils/stats.ts
+// Pure computation module for scroll statistics.
+// Tracks velocity (current + running average), computes cumulative item count
+// and progress from scroll position using geometric mapping.
+//
+// No DOM access, no RAF, no side effects — purely functional state tracker.
+import { MAX_VIRTUAL_SIZE } from "../constants";
+// =============================================================================
+// Constants
+// =============================================================================
+const MAX_VELOCITY = 50;
+const MIN_VELOCITY = 0.1;
+// =============================================================================
+// Factory
+// =============================================================================
+/**
+ * Create a stats tracker.
+ *
+ * All inputs are provided via callbacks so the tracker always reflects
+ * the latest values without needing to be recreated when the list changes.
+ *
+ * ```ts
+ * const stats = createStats({
+ *   getScrollPosition: () => list.getScrollPosition(),
+ *   getTotal: () => items.length,
+ *   getItemSize: () => ITEM_HEIGHT,
+ *   getContainerSize: () => containerEl.clientHeight,
+ * })
+ *
+ * const { progress, itemCount, total } = stats.getState()
+ * ```
+ */
+export function createStats(config) {
+    // ───────────────────────────────────────────────────────────────────────────
+    // Velocity state
+    // ───────────────────────────────────────────────────────────────────────────
+    let currentVelocity = 0;
+    let velocitySum = 0;
+    let velocityCount = 0;
+    function getVelocityAverage() {
+        return velocityCount > 0 ? velocitySum / velocityCount : 0;
+    }
+    function onVelocity(velocity) {
+        currentVelocity = velocity;
+        if (velocity > MIN_VELOCITY && velocity < MAX_VELOCITY) {
+            velocitySum += velocity;
+            velocityCount++;
+        }
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // Geometric item count
+    // ───────────────────────────────────────────────────────────────────────────
+    /**
+     * Compute cumulative item count from scroll position geometrically.
+     *
+     * scrollPosition is the DOM scrollTop/scrollLeft — in compressed/scaled
+     * mode this is the virtual (compressed) scroll position. We map it back
+     * to real item indices using the same linear mapping vlist uses internally:
+     *
+     *   columns         = getColumns() ?? 1
+     *   totalRows       = ceil(total / columns)
+     *   totalActualSize = totalRows × itemSize
+     *   totalVirtualSize = min(totalActualSize, MAX_VIRTUAL_SIZE)
+     *   maxVirtualScroll = totalVirtualSize − containerSize
+     *   maxActualScroll  = totalActualSize − containerSize
+     *   ratio            = maxActualScroll / maxVirtualScroll
+     *   actualOffset     = scrollPosition × ratio
+     *   visibleRows      = ceil((actualOffset + containerSize) / itemSize)
+     *   itemCount        = min(visibleRows × columns, total)
+     *
+     * containerSize is provided by the caller (clientHeight for vertical,
+     * clientWidth for horizontal).
+     *
+     * Using scroll-range ratio (not size ratio) ensures that at max scroll
+     * the end of the viewport aligns exactly with the last row/column.
+     * For grid/masonry, rows are converted to items via the column multiplier.
+     */
+    function getItemCount() {
+        const total = config.getTotal();
+        if (total === 0)
+            return 0;
+        const itemSize = config.getItemSize();
+        if (itemSize <= 0)
+            return 0;
+        const containerSize = config.getContainerSize();
+        if (containerSize <= 0)
+            return 0;
+        const scrollPosition = config.getScrollPosition();
+        // For grid/masonry layouts, vlist virtualizes rows — each row holds
+        // `columns` items. Convert total items → total rows for the geometric
+        // mapping, then convert visible rows back to items at the end.
+        const columns = typeof config.getColumns === "function" ? config.getColumns() : 1;
+        const totalRows = Math.ceil(total / columns);
+        // Map virtual scroll position back to actual content offset.
+        // Use scroll-range ratio so maxScroll maps exactly to the last row.
+        const totalActualSize = totalRows * itemSize;
+        const totalVirtualSize = Math.min(totalActualSize, MAX_VIRTUAL_SIZE);
+        const maxVirtualScroll = totalVirtualSize - containerSize;
+        const maxActualScroll = totalActualSize - containerSize;
+        const ratio = maxVirtualScroll > 0 ? maxActualScroll / maxVirtualScroll : 1;
+        const actualOffset = scrollPosition * ratio;
+        const lastVisibleRow = Math.ceil((actualOffset + containerSize) / itemSize);
+        return Math.min(lastVisibleRow * columns, total);
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // Public API
+    // ───────────────────────────────────────────────────────────────────────────
+    function getState() {
+        const total = config.getTotal();
+        const itemCount = getItemCount();
+        const progress = total > 0 ? Math.min(100, Math.max(0, (itemCount / total) * 100)) : 0;
+        return {
+            progress,
+            velocity: currentVelocity,
+            velocityAvg: getVelocityAverage(),
+            itemCount,
+            total,
+        };
+    }
+    return {
+        getState,
+        onVelocity,
+    };
+}

package/dist/vlist-grid.css

@@ -1 +1 @@
-.vlist--grid .vlist-items{contain:layout style}.vlist-grid-item{position:absolute;top:0;left:0;display:flex;align-items:center;justify-content:center;padding:var(--vlist-item-padding-y) var(--vlist-item-padding-x);background-color:var(--vlist-bg);cursor:default;user-select:none;transition:background-color var(--vlist-transition-duration) var(--vlist-transition-timing);contain:content;box-sizing:border-box;overflow:hidden}.vlist--grid .vlist-item{right:auto;border-bottom:none}.vlist--scrolling .vlist-grid-item{transition:none}.vlist--selectable .vlist-grid-item{cursor:pointer}.vlist--selectable .vlist-grid-item:hover{background-color:var(--vlist-bg-hover)}.vlist-grid-item.vlist-item--odd{background:var(--vlist-bg-striped)}.vlist-grid-item.vlist-item--selected{background-color:var(--vlist-bg-selected)}.vlist-grid-item.vlist-item--odd.vlist-item--selected{background:var(--vlist-bg-selected)}.vlist--selectable .vlist-grid-item.vlist-item--selected:hover{background-color:var(--vlist-bg-selected-hover)}.vlist--selectable .vlist-grid-item.vlist-item--odd.vlist-item--selected:hover{background:var(--vlist-bg-selected-hover)}.vlist-grid-item.vlist-item--focused{outline:2px solid var(--vlist-focus-ring,#3b82f6);outline-offset:-2px;z-index:1}
+.vlist--grid .vlist-content{contain:layout style}.vlist-grid-item{position:absolute;top:0;left:0;display:flex;align-items:center;justify-content:center;padding:var(--vlist-item-padding-y) var(--vlist-item-padding-x);background-color:var(--vlist-bg);cursor:default;user-select:none;transition:background-color var(--vlist-transition-duration) var(--vlist-transition-timing);contain:content;box-sizing:border-box;overflow:hidden}.vlist--grid .vlist-item{right:auto;border-bottom:none}.vlist--scrolling .vlist-grid-item{transition:none}.vlist--selectable .vlist-grid-item{cursor:pointer}.vlist--selectable .vlist-grid-item:hover{background-color:var(--vlist-bg-hover)}.vlist-grid-item.vlist-item--odd{background:var(--vlist-bg-striped)}.vlist-grid-item.vlist-item--selected{background-color:var(--vlist-bg-selected)}.vlist-grid-item.vlist-item--odd.vlist-item--selected{background:var(--vlist-bg-selected)}.vlist--selectable .vlist-grid-item.vlist-item--selected:hover{background-color:var(--vlist-bg-selected-hover)}.vlist--selectable .vlist-grid-item.vlist-item--odd.vlist-item--selected:hover{background:var(--vlist-bg-selected-hover)}.vlist-grid-item.vlist-item--focused{outline:2px solid var(--vlist-focus-ring,#3b82f6);outline-offset:-2px;z-index:1}

package/dist/vlist-masonry.css

@@ -1 +1 @@
-.vlist--masonry .vlist-items{contain:layout style}.vlist-masonry-item{position:absolute;top:0;left:0;display:flex;align-items:center;justify-content:center;padding:var(--vlist-item-padding-y) var(--vlist-item-padding-x);background-color:var(--vlist-bg);cursor:default;user-select:none;transition:background-color var(--vlist-transition-duration) var(--vlist-transition-timing);contain:content;box-sizing:border-box;overflow:hidden}.vlist--masonry .vlist-item{right:auto;border-bottom:none}.vlist--scrolling .vlist-masonry-item{transition:none}.vlist--selectable .vlist-masonry-item{cursor:pointer}.vlist--selectable .vlist-masonry-item:hover{background-color:var(--vlist-bg-hover)}.vlist-masonry-item.vlist-item--odd{background:var(--vlist-bg-striped)}.vlist-masonry-item.vlist-item--selected{background-color:var(--vlist-bg-selected)}.vlist-masonry-item.vlist-item--odd.vlist-item--selected{background:var(--vlist-bg-selected)}.vlist--selectable .vlist-masonry-item.vlist-item--selected:hover{background-color:var(--vlist-bg-selected-hover)}.vlist--selectable .vlist-masonry-item.vlist-item--odd.vlist-item--selected:hover{background:var(--vlist-bg-selected-hover)}.vlist-masonry-item.vlist-item--focused{outline:2px solid var(--vlist-focus-ring,#3b82f6);outline-offset:-2px;z-index:1}
+.vlist--masonry .vlist-content{contain:layout style}.vlist-masonry-item{position:absolute;top:0;left:0;display:flex;align-items:center;justify-content:center;padding:var(--vlist-item-padding-y) var(--vlist-item-padding-x);background-color:var(--vlist-bg);cursor:default;user-select:none;transition:background-color var(--vlist-transition-duration) var(--vlist-transition-timing);contain:content;box-sizing:border-box;overflow:hidden}.vlist--masonry .vlist-item{right:auto;border-bottom:none}.vlist--scrolling .vlist-masonry-item{transition:none}.vlist--selectable .vlist-masonry-item{cursor:pointer}.vlist--selectable .vlist-masonry-item:hover{background-color:var(--vlist-bg-hover)}.vlist-masonry-item.vlist-item--odd{background:var(--vlist-bg-striped)}.vlist-masonry-item.vlist-item--selected{background-color:var(--vlist-bg-selected)}.vlist-masonry-item.vlist-item--odd.vlist-item--selected{background:var(--vlist-bg-selected)}.vlist--selectable .vlist-masonry-item.vlist-item--selected:hover{background-color:var(--vlist-bg-selected-hover)}.vlist--selectable .vlist-masonry-item.vlist-item--odd.vlist-item--selected:hover{background:var(--vlist-bg-selected-hover)}.vlist-masonry-item.vlist-item--focused{outline:2px solid var(--vlist-focus-ring,#3b82f6);outline-offset:-2px;z-index:1}

package/dist/vlist-table.css

@@ -1 +1 @@
-.vlist--table{display:flex;flex-direction:column;overflow:hidden;min-height:inherit}.vlist--table .vlist-viewport{flex:1;min-height:0;height:auto;overflow:auto}.vlist--table .vlist-table-header{position:static}.vlist--table .vlist-scrollbar-hover{top:var(--vlist-table-header-height,0px);height:calc(100% - var(--vlist-table-header-height,0px))}.vlist--table .vlist-viewport--custom-scrollbar::-webkit-scrollbar{display:block;width:0}.vlist--table .vlist-items{contain:layout style}.vlist-table-header{position:absolute;top:0;left:0;right:0;z-index:5;overflow:hidden;display:flex;align-items:stretch;box-sizing:border-box;will-change:scroll-position;contain:layout style;background-color:var(--vlist-bg,#ffffff);border-bottom:1px solid var(--vlist-border,#e5e7eb);font-weight:600;font-size:0.8125rem;letter-spacing:0.01em;color:var(--vlist-text-muted,#6b7280)}.vlist-table-header-scroll{position:relative;display:flex;align-items:stretch;height:100%;min-width:100%;flex-shrink:0}.vlist-table-header-cell{position:relative;display:flex;align-items:center;height:100%;box-sizing:border-box;flex-shrink:0;user-select:none;padding-left:var(--vlist-item-padding-x,0.75rem);padding-right:var(--vlist-item-padding-x,0.75rem);border-right:1px solid transparent;transition:background-color 0.15s ease}.vlist-table-header-cell:hover{background-color:var(--vlist-bg-hover,rgba(0,0,0,0.04))}.vlist-table-header-cell--sortable{cursor:pointer}.vlist-table-header-cell--sortable:active{background-color:var(--vlist-bg-selected,rgba(59,130,246,0.12))}.vlist-table-header-cell--center{justify-content:center}.vlist-table-header-cell--right{justify-content:flex-end}.vlist-table-header-content{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;flex:1;min-width:0;pointer-events:none}.vlist-table-header-sort{margin-left:4px;flex-shrink:0;opacity:0;font-size:0.7em;transition:opacity 0.15s ease;pointer-events:none;color:var(--vlist-text-muted,#6b7280)}.vlist-table-header-resize{position:absolute;top:0;right:-3px;bottom:0;width:5px;cursor:col-resize;z-index:2;touch-action:none;opacity:0;transition:opacity 0.15s ease}.vlist-table-header-resize::after{content:"";position:absolute;top:0;bottom:0;left:50%;width:1px;transform:translateX(-50%);background-color:var(--vlist-border,#e5e7eb);transition:background-color 0.15s ease}.vlist-table-header-resize:hover::after{background-color:var(--vlist-focus-ring,#3b82f6)}.vlist-table-header-cell:hover .vlist-table-header-resize{opacity:1}.vlist-table-header-resize--active{opacity:1}.vlist-table-header-resize--active::after{background-color:var(--vlist-border-selected,#3b82f6)}.vlist--col-resizing,.vlist--col-resizing *{cursor:col-resize !important;user-select:none !important}.vlist-table-row{position:absolute;top:0;left:0;display:flex;box-sizing:border-box;contain:content;border-bottom:none;background-color:var(--vlist-bg,#ffffff);cursor:default;user-select:none;transition:background-color var(--vlist-transition-duration,150ms) var(--vlist-transition-timing,ease-in-out);will-change:transform}.vlist--scrolling .vlist-table-row{transition:none}.vlist-table-row.vlist-item--odd{background:var( --vlist-bg-striped,var(--vlist-bg-hover,rgba(0,0,0,0.02)) )}.vlist--selectable .vlist-table-row{cursor:pointer}.vlist--selectable .vlist-table-row:hover{background-color:var(--vlist-bg-hover,rgba(0,0,0,0.04))}.vlist-table-row.vlist-item--selected{background-color:var(--vlist-bg-selected,rgba(59,130,246,0.12))}.vlist-table-row.vlist-item--odd.vlist-item--selected{background:var(--vlist-bg-selected,rgba(59,130,246,0.12))}.vlist--selectable .vlist-table-row.vlist-item--selected:hover{background-color:var(--vlist-bg-selected-hover,rgba(59,130,246,0.18))}.vlist--selectable .vlist-table-row.vlist-item--odd.vlist-item--selected:hover{background:var(--vlist-bg-selected-hover,rgba(59,130,246,0.18))}.vlist-table-row.vlist-item--focused{outline:2px solid var(--vlist-focus-ring,#3b82f6);outline-offset:-2px;z-index:1}.vlist-table-cell{position:absolute;top:0;bottom:0;display:flex;align-items:center;box-sizing:border-box;overflow:hidden;white-space:nowrap;text-overflow:ellipsis;padding-left:var(--vlist-item-padding-x,0.75rem);padding-right:var(--vlist-item-padding-x,0.75rem);font-size:0.875rem;color:var(--vlist-text,#111827)}.vlist-table-cell--center{text-align:center;justify-content:center}.vlist-table-cell--right{text-align:right;justify-content:flex-end}.vlist--table-row-borders .vlist-table-row{border-bottom:1px solid var(--vlist-border,#e5e7eb)}.vlist--table-col-borders .vlist-table-cell{border-right:1px solid var(--vlist-border,#e5e7eb)}.vlist--table-col-borders .vlist-table-header-cell{border-right-color:var(--vlist-border,#e5e7eb)}.vlist-table-group-header{display:flex;align-items:center;background-color:var(--vlist-group-header-bg,#f3f4f6);cursor:default}.vlist-table-group-header-content{flex:1;min-width:0;font-size:0.75rem;font-weight:600;letter-spacing:0.03em;text-transform:uppercase;color:var(--vlist-text-muted,#6b7280);border-bottom:1px solid var(--vlist-border)}.vlist--table-row-borders .vlist-table-group-header{border-bottom:1px solid var(--vlist-border)}.vlist--table.vlist--grouped .vlist-sticky-header{order:1;z-index:4;border-bottom:none}.vlist--table.vlist--grouped .vlist-viewport{order:2}[data-theme-mode="dark"] .vlist-table-header,.dark .vlist-table-header{background-color:var(--vlist-bg,#111827);color:var(--vlist-text-muted,#9ca3af);border-bottom-color:var(--vlist-border,#374151)}[data-theme-mode="dark"] .vlist-table-header-cell:hover,.dark .vlist-table-header-cell:hover{background-color:var(--vlist-bg-hover,rgba(255,255,255,0.06))}[data-theme-mode="dark"] .vlist-table-header-resize::after,.dark .vlist-table-header-resize::after{background-color:var(--vlist-border,#374151)}[data-theme-mode="dark"] .vlist-table-header-resize:hover::after,.dark .vlist-table-header-resize:hover::after{background-color:var(--vlist-focus-ring,#3b82f6)}[data-theme-mode="dark"] .vlist-table-group-header,.dark .vlist-table-group-header{background-color:var(--vlist-group-header-bg,#1f2937)}[data-theme-mode="dark"] .vlist-table-group-header-content,.dark .vlist-table-group-header-content{color:var(--vlist-text-muted,#9ca3af)}@media (prefers-color-scheme:dark){:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist-table-header{background-color:var(--vlist-bg,#111827);color:var(--vlist-text-muted,#9ca3af);border-bottom-color:var(--vlist-border,#374151)}:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist-table-header-cell:hover{background-color:var(--vlist-bg-hover,rgba(255,255,255,0.06))}:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist-table-header-resize::after{background-color:var(--vlist-border,#374151)}:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist-table-header-resize:hover::after{background-color:var(--vlist-focus-ring,#3b82f6)}:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist-table-group-header{background-color:var(--vlist-group-header-bg,#1f2937)}:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist-table-group-header-content{color:var(--vlist-text-muted,#9ca3af)}}.vlist-table-row.vlist-item--placeholder .vlist-table-cell{color:transparent}.vlist-table-row.vlist-item--placeholder .vlist-table-cell>*{color:transparent;background-color:var(--vlist-border,#e5e7eb);border-radius:4px;animation:vlist-placeholder-pulse 2s ease-in-out infinite;line-height:1;min-width:1em}.vlist-table-row.vlist-item--placeholder .vlist-table-cell>*>*{visibility:hidden}.vlist-table-row.vlist-item--placeholder .vlist-table-cell>*[style]{background:var(--vlist-border,#e5e7eb) !important;color:transparent !important}[data-theme-mode="dark"] .vlist--table-row-borders .vlist-table-group-header,.dark .vlist--table-row-borders .vlist-table-group-header{border-top-color:var(--vlist-border,#374151)}@media (prefers-color-scheme:dark){:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist--table-row-borders .vlist-table-group-header{border-top-color:var(--vlist-border,#374151)}}
+.vlist--table{display:flex;flex-direction:column;overflow:hidden;min-height:inherit}.vlist--table .vlist-viewport{flex:1;min-height:0;height:auto;overflow:auto}.vlist--table .vlist-table-header{position:static}.vlist--table .vlist-scrollbar__hover{top:var(--vlist-table-header-height,0px);height:calc(100% - var(--vlist-table-header-height,0px))}.vlist--table .vlist-viewport--custom-scrollbar::-webkit-scrollbar{display:block;width:0}.vlist--table .vlist-content{contain:layout style}.vlist-table-header{position:absolute;top:0;left:0;right:0;z-index:5;overflow:hidden;display:flex;align-items:stretch;box-sizing:border-box;will-change:scroll-position;contain:layout style;background-color:var(--vlist-bg,#ffffff);border-bottom:1px solid var(--vlist-border,#e5e7eb);font-weight:600;font-size:0.8125rem;letter-spacing:0.01em;color:var(--vlist-text-muted,#6b7280)}.vlist-table-header-scroll{position:relative;display:flex;align-items:stretch;height:100%;min-width:100%;flex-shrink:0}.vlist-table-header-cell{position:relative;display:flex;align-items:center;height:100%;box-sizing:border-box;flex-shrink:0;user-select:none;padding-left:var(--vlist-item-padding-x,0.75rem);padding-right:var(--vlist-item-padding-x,0.75rem);border-right:1px solid transparent;transition:background-color 0.15s ease}.vlist-table-header-cell:hover{background-color:var(--vlist-bg-hover,rgba(0,0,0,0.04))}.vlist-table-header-cell--sortable{cursor:pointer}.vlist-table-header-cell--sortable:active{background-color:var(--vlist-bg-selected,rgba(59,130,246,0.12))}.vlist-table-header-cell--center{justify-content:center}.vlist-table-header-cell--right{justify-content:flex-end}.vlist-table-header-content{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;flex:1;min-width:0;pointer-events:none}.vlist-table-header-sort{margin-left:4px;flex-shrink:0;opacity:0;font-size:0.7em;transition:opacity 0.15s ease;pointer-events:none;color:var(--vlist-text-muted,#6b7280)}.vlist-table-header-resize{position:absolute;top:0;right:-3px;bottom:0;width:5px;cursor:col-resize;z-index:2;touch-action:none;opacity:0;transition:opacity 0.15s ease}.vlist-table-header-resize::after{content:"";position:absolute;top:0;bottom:0;left:50%;width:1px;transform:translateX(-50%);background-color:var(--vlist-border,#e5e7eb);transition:background-color 0.15s ease}.vlist-table-header-resize:hover::after{background-color:var(--vlist-focus-ring,#3b82f6)}.vlist-table-header-cell:hover .vlist-table-header-resize{opacity:1}.vlist-table-header-resize--active{opacity:1}.vlist-table-header-resize--active::after{background-color:var(--vlist-border-selected,#3b82f6)}.vlist--col-resizing,.vlist--col-resizing *{cursor:col-resize !important;user-select:none !important}.vlist-table-row{position:absolute;top:0;left:0;display:flex;box-sizing:border-box;contain:content;border-bottom:none;background-color:var(--vlist-bg,#ffffff);cursor:default;user-select:none;transition:background-color var(--vlist-transition-duration,150ms) var(--vlist-transition-timing,ease-in-out);will-change:transform}.vlist--scrolling .vlist-table-row{transition:none}.vlist-table-row.vlist-item--odd{background:var( --vlist-bg-striped,var(--vlist-bg-hover,rgba(0,0,0,0.02)) )}.vlist--selectable .vlist-table-row{cursor:pointer}.vlist--selectable .vlist-table-row:hover{background-color:var(--vlist-bg-hover,rgba(0,0,0,0.04))}.vlist-table-row.vlist-item--selected{background-color:var(--vlist-bg-selected,rgba(59,130,246,0.12))}.vlist-table-row.vlist-item--odd.vlist-item--selected{background:var(--vlist-bg-selected,rgba(59,130,246,0.12))}.vlist--selectable .vlist-table-row.vlist-item--selected:hover{background-color:var(--vlist-bg-selected-hover,rgba(59,130,246,0.18))}.vlist--selectable .vlist-table-row.vlist-item--odd.vlist-item--selected:hover{background:var(--vlist-bg-selected-hover,rgba(59,130,246,0.18))}.vlist-table-row.vlist-item--focused{outline:2px solid var(--vlist-focus-ring,#3b82f6);outline-offset:-2px;z-index:1}.vlist-table-cell{position:absolute;top:0;bottom:0;display:flex;align-items:center;box-sizing:border-box;overflow:hidden;white-space:nowrap;text-overflow:ellipsis;padding-left:var(--vlist-item-padding-x,0.75rem);padding-right:var(--vlist-item-padding-x,0.75rem);font-size:0.875rem;color:var(--vlist-text,#111827)}.vlist-table-cell--center{text-align:center;justify-content:center}.vlist-table-cell--right{text-align:right;justify-content:flex-end}.vlist--table-row-borders .vlist-table-row{border-bottom:1px solid var(--vlist-border,#e5e7eb)}.vlist--table-col-borders .vlist-table-cell{border-right:1px solid var(--vlist-border,#e5e7eb)}.vlist--table-col-borders .vlist-table-header-cell{border-right-color:var(--vlist-border,#e5e7eb)}.vlist-table-group-header{display:flex;align-items:center;background-color:var(--vlist-group-header-bg,#f3f4f6);cursor:default}.vlist-table-group-header-content{flex:1;min-width:0;font-size:0.75rem;font-weight:600;letter-spacing:0.03em;text-transform:uppercase;color:var(--vlist-text-muted,#6b7280);border-bottom:1px solid var(--vlist-border)}.vlist--table-row-borders .vlist-table-group-header{border-bottom:1px solid var(--vlist-border)}.vlist--table.vlist--grouped .vlist-sticky-header{order:1;z-index:4;border-bottom:none}.vlist--table.vlist--grouped .vlist-viewport{order:2}[data-theme-mode="dark"] .vlist-table-header,.dark .vlist-table-header{background-color:var(--vlist-bg,#111827);color:var(--vlist-text-muted,#9ca3af);border-bottom-color:var(--vlist-border,#374151)}[data-theme-mode="dark"] .vlist-table-header-cell:hover,.dark .vlist-table-header-cell:hover{background-color:var(--vlist-bg-hover,rgba(255,255,255,0.06))}[data-theme-mode="dark"] .vlist-table-header-resize::after,.dark .vlist-table-header-resize::after{background-color:var(--vlist-border,#374151)}[data-theme-mode="dark"] .vlist-table-header-resize:hover::after,.dark .vlist-table-header-resize:hover::after{background-color:var(--vlist-focus-ring,#3b82f6)}[data-theme-mode="dark"] .vlist-table-group-header,.dark .vlist-table-group-header{background-color:var(--vlist-group-header-bg,#1f2937)}[data-theme-mode="dark"] .vlist-table-group-header-content,.dark .vlist-table-group-header-content{color:var(--vlist-text-muted,#9ca3af)}@media (prefers-color-scheme:dark){:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist-table-header{background-color:var(--vlist-bg,#111827);color:var(--vlist-text-muted,#9ca3af);border-bottom-color:var(--vlist-border,#374151)}:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist-table-header-cell:hover{background-color:var(--vlist-bg-hover,rgba(255,255,255,0.06))}:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist-table-header-resize::after{background-color:var(--vlist-border,#374151)}:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist-table-header-resize:hover::after{background-color:var(--vlist-focus-ring,#3b82f6)}:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist-table-group-header{background-color:var(--vlist-group-header-bg,#1f2937)}:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist-table-group-header-content{color:var(--vlist-text-muted,#9ca3af)}}.vlist-table-row.vlist-item--placeholder .vlist-table-cell{color:transparent}.vlist-table-row.vlist-item--placeholder .vlist-table-cell>*{color:transparent;background-color:var(--vlist-border,#e5e7eb);border-radius:4px;animation:vlist-placeholder-pulse 2s ease-in-out infinite;line-height:1;min-width:1em}.vlist-table-row.vlist-item--placeholder .vlist-table-cell>*>*{visibility:hidden}.vlist-table-row.vlist-item--placeholder .vlist-table-cell>*[style]{background:var(--vlist-border,#e5e7eb) !important;color:transparent !important}[data-theme-mode="dark"] .vlist--table-row-borders .vlist-table-group-header,.dark .vlist--table-row-borders .vlist-table-group-header{border-top-color:var(--vlist-border,#374151)}@media (prefers-color-scheme:dark){:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]) .vlist--table-row-borders .vlist-table-group-header{border-top-color:var(--vlist-border,#374151)}}

package/dist/vlist.css

@@ -1 +1 @@
-@keyframes vlist-fade-in{from{opacity:0.6}to{opacity:1}}@keyframes vlist-placeholder-pulse{0%,100%{opacity:0.6}50%{opacity:0.4}}:root{--vlist-scrollbar-width:8px;--vlist-scrollbar-track-color:transparent;--vlist-scrollbar-radius:4px;--vlist-custom-scrollbar-width:8px;--vlist-custom-scrollbar-track-color:transparent;--vlist-custom-scrollbar-radius:4px;--vlist-custom-scrollbar-padding-top:2px;--vlist-custom-scrollbar-padding-right:2px;--vlist-custom-scrollbar-padding-bottom:2px;--vlist-custom-scrollbar-padding-left:2px;--vlist-custom-scrollbar-min-thumb-size:15px;--vlist-item-padding-x:1rem;--vlist-item-padding-y:0.75rem;--vlist-border-radius:0.5rem;--vlist-transition-duration:150ms;--vlist-transition-timing:ease-in-out;--vlist-bg:#ffffff;--vlist-bg-hover:rgba(0,0,0,0.04);--vlist-bg-striped:rgba(0,0,0,0.02);--vlist-bg-selected:rgba(59,130,246,0.12);--vlist-bg-selected-hover:rgba(59,130,246,0.18);--vlist-border:#e5e7eb;--vlist-border-selected:#3b82f6;--vlist-text:#111827;--vlist-text-muted:#6b7280;--vlist-focus-ring:#3b82f6;--vlist-group-header-bg:#f3f4f6;--vlist-scrollbar-thumb-color:#d1d5db;--vlist-scrollbar-thumb-hover-color:#9ca3af;--vlist-custom-scrollbar-thumb-color:rgba(0,0,0,0.2);--vlist-custom-scrollbar-thumb-hover-color:rgba(0,0,0,0.3);--vlist-placeholder-bg:rgba(0,0,0,0.2)}[data-theme-mode="dark"]{--vlist-bg:#111827;--vlist-bg-hover:rgba(255,255,255,0.06);--vlist-bg-striped:rgba(255,255,255,0.02);--vlist-bg-selected:rgba(59,130,246,0.2);--vlist-bg-selected-hover:rgba(59,130,246,0.28);--vlist-border:#374151;--vlist-border-selected:#3b82f6;--vlist-text:#f9fafb;--vlist-text-muted:#9ca3af;--vlist-focus-ring:#3b82f6;--vlist-group-header-bg:#1e2433;--vlist-scrollbar-thumb-color:#4b5563;--vlist-scrollbar-thumb-hover-color:#6b7280;--vlist-custom-scrollbar-thumb-color:rgba(255,255,255,0.2);--vlist-custom-scrollbar-thumb-hover-color:rgba(255,255,255,0.3);--vlist-placeholder-bg:rgba(255,255,255,0.3)}@media (prefers-color-scheme:dark){:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]){--vlist-bg:#111827;--vlist-bg-hover:rgba(255,255,255,0.06);--vlist-bg-striped:rgba(255,255,255,0.02);--vlist-bg-selected:rgba(59,130,246,0.2);--vlist-bg-selected-hover:rgba(59,130,246,0.28);--vlist-border:#374151;--vlist-border-selected:#3b82f6;--vlist-text:#f9fafb;--vlist-text-muted:#9ca3af;--vlist-focus-ring:#3b82f6;--vlist-group-header-bg:#1e2433;--vlist-scrollbar-thumb-color:#4b5563;--vlist-scrollbar-thumb-hover-color:#6b7280;--vlist-custom-scrollbar-thumb-color:rgba(255,255,255,0.2);--vlist-custom-scrollbar-thumb-hover-color:rgba(255,255,255,0.3);--vlist-placeholder-bg:rgba(255,255,255,0.3)}}.dark{--vlist-bg:#111827;--vlist-bg-hover:rgba(255,255,255,0.06);--vlist-bg-striped:rgba(255,255,255,0.02);--vlist-bg-selected:rgba(59,130,246,0.2);--vlist-bg-selected-hover:rgba(59,130,246,0.28);--vlist-border:#374151;--vlist-border-selected:#3b82f6;--vlist-text:#f9fafb;--vlist-text-muted:#9ca3af;--vlist-focus-ring:#3b82f6;--vlist-group-header-bg:#1e2433;--vlist-scrollbar-thumb-color:#4b5563;--vlist-scrollbar-thumb-hover-color:#6b7280;--vlist-custom-scrollbar-thumb-color:rgba(255,255,255,0.2);--vlist-custom-scrollbar-thumb-hover-color:rgba(255,255,255,0.3);--vlist-placeholder-bg:rgba(255,255,255,0.3)}.vlist{position:relative;width:100%;height:100%;box-sizing:border-box;overflow:hidden;background-color:var(--vlist-bg);color:var(--vlist-text);color-scheme:light;border:1px solid var(--vlist-border);border-radius:var(--vlist-border-radius);outline:none}[data-theme-mode="dark"] .vlist,.dark .vlist{color-scheme:dark}@media (prefers-color-scheme:dark){:root:not([data-theme-mode="light"]) .vlist{color-scheme:dark}}.vlist:focus,.vlist:focus-visible,.vlist-items:focus,.vlist-items:focus-visible{outline:none}.vlist-viewport{width:100%;height:100%;overflow:auto;scrollbar-color:var(--vlist-scrollbar-thumb-color) var(--vlist-scrollbar-track-color)}@supports (-moz-appearance:none) and (scrollbar-width:1px){.vlist-viewport{scrollbar-width:var(--vlist-scrollbar-width)}}.vlist-viewport::-webkit-scrollbar{width:var(--vlist-scrollbar-width);height:var(--vlist-scrollbar-width)}.vlist-viewport::-webkit-scrollbar-track{background:var(--vlist-scrollbar-track-color)}.vlist-viewport::-webkit-scrollbar-thumb{background-color:var(--vlist-scrollbar-thumb-color);border-radius:var(--vlist-scrollbar-radius)}.vlist-viewport::-webkit-scrollbar-thumb:hover{background-color:var(--vlist-scrollbar-thumb-hover-color)}.vlist-content{position:relative;width:100%}.vlist-items{position:relative;width:100%;contain:layout style}.vlist-item,.vlist-group-header{position:absolute;top:0;left:0;right:0;display:flex;align-items:center;background-color:var(--vlist-bg);cursor:default;user-select:none;opacity:1;transition:background-color var(--vlist-transition-duration) var(--vlist-transition-timing),opacity var(--vlist-transition-duration) var(--vlist-transition-timing);contain:content;box-sizing:border-box;will-change:transform}.vlist--scrolling .vlist-item,.vlist--settling .vlist-item,.vlist--scrolling .vlist-group-header,.vlist--settling .vlist-group-header{transition:none}.vlist--selectable .vlist-item{cursor:pointer}.vlist--selectable .vlist-item:hover{background-color:var(--vlist-bg-hover)}.vlist-item.vlist-item--odd{background:var(--vlist-bg-striped)}.vlist-item.vlist-item--selected{background-color:var(--vlist-bg-selected)}.vlist-item.vlist-item--odd.vlist-item--selected{background:var(--vlist-bg-selected)}.vlist-item.vlist-item--selected:hover{background-color:var(--vlist-bg-selected-hover)}.vlist-item.vlist-item--odd.vlist-item--selected:hover{background:var(--vlist-bg-selected-hover)}.vlist-item.vlist-item--focused{outline:2px solid var(--vlist-focus-ring,#3b82f6);outline-offset:-2px;z-index:1}.vlist-item--replaced{animation:vlist-fade-in 0.3s ease-out}.vlist-item--placeholder{opacity:0.6;animation:vlist-placeholder-pulse 2s ease-in-out infinite}.vlist-item.vlist-item--selected.vlist-item--focused{outline-color:var(--vlist-border-selected)}.vlist-scrollbar{position:absolute;top:var(--vlist-custom-scrollbar-padding-top);right:var(--vlist-custom-scrollbar-padding-right);bottom:var(--vlist-custom-scrollbar-padding-bottom);width:var(--vlist-custom-scrollbar-width);background-color:var(--vlist-custom-scrollbar-track-color);opacity:0;transition:opacity 0.2s ease-out;z-index:10;pointer-events:none}.vlist-scrollbar-hover{position:absolute;top:0;right:0;height:100%;z-index:9;pointer-events:auto}.vlist-scrollbar-hover--horizontal{top:auto;right:auto;bottom:0;left:0;width:100%;height:auto}.vlist-scrollbar--visible{opacity:1;pointer-events:auto}.vlist-scrollbar-thumb{position:absolute;top:0;left:0;right:0;width:100%;background-color:var(--vlist-custom-scrollbar-thumb-color);border-radius:var(--vlist-custom-scrollbar-radius);cursor:pointer;transition:background-color 0.15s ease-out}.vlist-scrollbar-thumb:hover{background-color:var(--vlist-custom-scrollbar-thumb-hover-color)}.vlist-scrollbar--dragging{opacity:1;pointer-events:auto}.vlist-scrollbar--dragging .vlist-scrollbar-thumb{background-color:var(--vlist-custom-scrollbar-thumb-hover-color)}.vlist-group-header{cursor:default;background-color:var(--vlist-group-header-bg,#f3f4f6);z-index:1;overflow:hidden}.vlist-group-header:hover{background-color:var(--vlist-group-header-bg,#f3f4f6)}.vlist-sticky-header{left:0;right:0;background-color:var(--vlist-group-header-bg,#f3f4f6)}.vlist--horizontal{overflow:hidden}.vlist--horizontal .vlist-viewport{overflow-x:auto;overflow-y:hidden}.vlist--horizontal .vlist-content{height:100%;width:auto}.vlist--horizontal .vlist-items{height:100%;width:auto}.vlist--horizontal .vlist-item,.vlist--horizontal .vlist-group-header{position:absolute;top:0;bottom:0;left:0;right:auto;display:flex;align-items:center;justify-content:center;border-bottom:none;border-right:1px solid var(--vlist-border)}.vlist-scrollbar--horizontal{top:auto;left:var(--vlist-custom-scrollbar-padding-left);right:var(--vlist-custom-scrollbar-padding-right);bottom:var(--vlist-custom-scrollbar-padding-bottom);width:auto;height:var(--vlist-custom-scrollbar-width)}.vlist-scrollbar--horizontal .vlist-scrollbar-thumb{top:0;left:0;width:auto;height:100%}.vlist-viewport--gutter{padding-right:calc( var(--vlist-custom-scrollbar-padding-right) + var(--vlist-custom-scrollbar-width) + var(--vlist-custom-scrollbar-padding-left) )}.vlist--horizontal .vlist-viewport--gutter{padding-right:0;padding-bottom:calc( var(--vlist-custom-scrollbar-padding-bottom) + var(--vlist-custom-scrollbar-width) + var(--vlist-custom-scrollbar-padding-top) )}.vlist-viewport--custom-scrollbar{scrollbar-width:none;-ms-overflow-style:none}.vlist-viewport--custom-scrollbar::-webkit-scrollbar{display:none}.vlist-viewport--no-scrollbar{scrollbar-width:none;-ms-overflow-style:none}.vlist-viewport--no-scrollbar::-webkit-scrollbar{display:none}.vlist-viewport--gutter-stable{scrollbar-gutter:stable}.vlist-sort-ghost{opacity:0.85;box-shadow:0 4px 16px rgba(0,0,0,0.18);cursor:grabbing}.vlist-item--drag-source{opacity:0 !important;pointer-events:none}.vlist--sorting{cursor:grabbing;-webkit-user-select:none;user-select:none;-webkit-touch-callout:none}.vlist-item--kb-sorting{outline:2px solid var(--vlist-focus-ring,#3b82f6);outline-offset:-2px;background-color:var(--vlist-bg-selected);z-index:1}
+@keyframes vlist-fade-in{from{opacity:0.6}to{opacity:1}}@keyframes vlist-placeholder-pulse{0%,100%{opacity:0.6}50%{opacity:0.4}}:root{--vlist-scrollbar-width:8px;--vlist-scrollbar-track-color:transparent;--vlist-scrollbar-radius:4px;--vlist-custom-scrollbar-width:8px;--vlist-custom-scrollbar-track-color:transparent;--vlist-custom-scrollbar-radius:4px;--vlist-custom-scrollbar-padding-top:2px;--vlist-custom-scrollbar-padding-right:2px;--vlist-custom-scrollbar-padding-bottom:2px;--vlist-custom-scrollbar-padding-left:2px;--vlist-custom-scrollbar-min-thumb-size:15px;--vlist-item-padding-x:1rem;--vlist-item-padding-y:0.75rem;--vlist-border-radius:0.5rem;--vlist-transition-duration:150ms;--vlist-transition-timing:ease-in-out;--vlist-bg:#ffffff;--vlist-bg-hover:rgba(0,0,0,0.04);--vlist-bg-striped:rgba(0,0,0,0.02);--vlist-bg-selected:rgba(59,130,246,0.12);--vlist-bg-selected-hover:rgba(59,130,246,0.18);--vlist-border:#e5e7eb;--vlist-border-selected:#3b82f6;--vlist-text:#111827;--vlist-text-muted:#6b7280;--vlist-focus-ring:#3b82f6;--vlist-group-header-bg:#f3f4f6;--vlist-scrollbar-thumb-color:#d1d5db;--vlist-scrollbar-thumb-hover-color:#9ca3af;--vlist-custom-scrollbar-thumb-color:rgba(0,0,0,0.2);--vlist-custom-scrollbar-thumb-hover-color:rgba(0,0,0,0.3);--vlist-placeholder-bg:rgba(0,0,0,0.2);--vlist-placeholder-bg-strong:rgba(0,0,0,0.24)}[data-theme-mode="dark"]{--vlist-bg:#111827;--vlist-bg-hover:rgba(255,255,255,0.06);--vlist-bg-striped:rgba(255,255,255,0.02);--vlist-bg-selected:rgba(59,130,246,0.2);--vlist-bg-selected-hover:rgba(59,130,246,0.28);--vlist-border:#374151;--vlist-border-selected:#3b82f6;--vlist-text:#f9fafb;--vlist-text-muted:#9ca3af;--vlist-focus-ring:#3b82f6;--vlist-group-header-bg:#1e2433;--vlist-scrollbar-thumb-color:#4b5563;--vlist-scrollbar-thumb-hover-color:#6b7280;--vlist-custom-scrollbar-thumb-color:rgba(255,255,255,0.2);--vlist-custom-scrollbar-thumb-hover-color:rgba(255,255,255,0.3);--vlist-placeholder-bg:rgba(255,255,255,0.3);--vlist-placeholder-bg-strong:rgba(255,255,255,0.35)}@media (prefers-color-scheme:dark){:root:not([data-theme-mode="light"]):not([data-theme-mode="dark"]){--vlist-bg:#111827;--vlist-bg-hover:rgba(255,255,255,0.06);--vlist-bg-striped:rgba(255,255,255,0.02);--vlist-bg-selected:rgba(59,130,246,0.2);--vlist-bg-selected-hover:rgba(59,130,246,0.28);--vlist-border:#374151;--vlist-border-selected:#3b82f6;--vlist-text:#f9fafb;--vlist-text-muted:#9ca3af;--vlist-focus-ring:#3b82f6;--vlist-group-header-bg:#1e2433;--vlist-scrollbar-thumb-color:#4b5563;--vlist-scrollbar-thumb-hover-color:#6b7280;--vlist-custom-scrollbar-thumb-color:rgba(255,255,255,0.2);--vlist-custom-scrollbar-thumb-hover-color:rgba(255,255,255,0.3);--vlist-placeholder-bg:rgba(255,255,255,0.3);--vlist-placeholder-bg-strong:rgba(255,255,255,0.35)}}.dark{--vlist-bg:#111827;--vlist-bg-hover:rgba(255,255,255,0.06);--vlist-bg-striped:rgba(255,255,255,0.02);--vlist-bg-selected:rgba(59,130,246,0.2);--vlist-bg-selected-hover:rgba(59,130,246,0.28);--vlist-border:#374151;--vlist-border-selected:#3b82f6;--vlist-text:#f9fafb;--vlist-text-muted:#9ca3af;--vlist-focus-ring:#3b82f6;--vlist-group-header-bg:#1e2433;--vlist-scrollbar-thumb-color:#4b5563;--vlist-scrollbar-thumb-hover-color:#6b7280;--vlist-custom-scrollbar-thumb-color:rgba(255,255,255,0.2);--vlist-custom-scrollbar-thumb-hover-color:rgba(255,255,255,0.3);--vlist-placeholder-bg:rgba(255,255,255,0.3);--vlist-placeholder-bg-strong:rgba(255,255,255,0.35)}.vlist{position:relative;width:100%;height:100%;box-sizing:border-box;overflow:hidden;background-color:var(--vlist-bg);color:var(--vlist-text);color-scheme:light;border:1px solid var(--vlist-border);border-radius:var(--vlist-border-radius);outline:none}[data-theme-mode="dark"] .vlist,.dark .vlist{color-scheme:dark}@media (prefers-color-scheme:dark){:root:not([data-theme-mode="light"]) .vlist{color-scheme:dark}}.vlist:focus,.vlist:focus-visible,.vlist-content:focus,.vlist-content:focus-visible{outline:none}.vlist-viewport{width:100%;height:100%;overflow:auto;scrollbar-color:var(--vlist-scrollbar-thumb-color) var(--vlist-scrollbar-track-color)}@supports (-moz-appearance:none) and (scrollbar-width:1px){.vlist-viewport{scrollbar-width:var(--vlist-scrollbar-width)}}.vlist-viewport::-webkit-scrollbar{width:var(--vlist-scrollbar-width);height:var(--vlist-scrollbar-width)}.vlist-viewport::-webkit-scrollbar-track{background:var(--vlist-scrollbar-track-color)}.vlist-viewport::-webkit-scrollbar-thumb{background-color:var(--vlist-scrollbar-thumb-color);border-radius:var(--vlist-scrollbar-radius)}.vlist-viewport::-webkit-scrollbar-thumb:hover{background-color:var(--vlist-scrollbar-thumb-hover-color)}.vlist-content{position:relative;width:100%;contain:layout style}.vlist-item,.vlist-group-header{position:absolute;top:0;left:0;right:0;display:flex;align-items:center;background-color:var(--vlist-bg);cursor:default;user-select:none;opacity:1;transition:background-color var(--vlist-transition-duration) var(--vlist-transition-timing),opacity var(--vlist-transition-duration) var(--vlist-transition-timing);contain:content;box-sizing:border-box;will-change:transform}.vlist--scrolling .vlist-item,.vlist--settling .vlist-item,.vlist--scrolling .vlist-group-header,.vlist--settling .vlist-group-header{transition:none}.vlist--selectable .vlist-item{cursor:pointer}.vlist--selectable .vlist-item:hover{background-color:var(--vlist-bg-hover)}.vlist-item.vlist-item--odd{background:var(--vlist-bg-striped)}.vlist-item.vlist-item--selected{background-color:var(--vlist-bg-selected)}.vlist-item.vlist-item--odd.vlist-item--selected{background:var(--vlist-bg-selected)}.vlist-item.vlist-item--selected:hover{background-color:var(--vlist-bg-selected-hover)}.vlist-item.vlist-item--odd.vlist-item--selected:hover{background:var(--vlist-bg-selected-hover)}.vlist-item.vlist-item--focused{outline:2px solid var(--vlist-focus-ring,#3b82f6);outline-offset:-2px;z-index:1}.vlist-item--replaced{animation:vlist-fade-in 0.3s ease-out}.vlist-item--placeholder{opacity:0.6;animation:vlist-placeholder-pulse 2s ease-in-out infinite}.vlist-item--placeholder *:not(:has(*)){color:transparent;background-color:var(--vlist-placeholder-bg);border-radius:4px;width:fit-content;line-height:1.2;transform:scaleY(0.8)}.vlist-item--placeholder:is(strong,b,h1,h2,h3,h4):not(:has(*)){background-color:var(--vlist-placeholder-bg-strong)}.vlist-item.vlist-item--selected.vlist-item--focused{outline-color:var(--vlist-border-selected)}.vlist-scrollbar{position:absolute;top:var(--vlist-custom-scrollbar-padding-top);right:var(--vlist-custom-scrollbar-padding-right);bottom:var(--vlist-custom-scrollbar-padding-bottom);width:var(--vlist-custom-scrollbar-width);background-color:var(--vlist-custom-scrollbar-track-color);opacity:0;transition:opacity 0.2s ease-out;z-index:10;pointer-events:none}.vlist-scrollbar__hover{position:absolute;top:0;right:0;height:100%;z-index:9;pointer-events:auto}.vlist-scrollbar__hover--horizontal{top:auto;right:auto;bottom:0;left:0;width:100%;height:auto}.vlist-scrollbar--visible{opacity:1;pointer-events:auto}.vlist-scrollbar__thumb{position:absolute;top:0;left:0;right:0;width:100%;background-color:var(--vlist-custom-scrollbar-thumb-color);border-radius:var(--vlist-custom-scrollbar-radius);cursor:pointer;transition:background-color 0.15s ease-out}.vlist-scrollbar__thumb:hover{background-color:var(--vlist-custom-scrollbar-thumb-hover-color)}.vlist-scrollbar--dragging{opacity:1;pointer-events:auto}.vlist-scrollbar--dragging .vlist-scrollbar__thumb{background-color:var(--vlist-custom-scrollbar-thumb-hover-color)}.vlist-group-header{cursor:default;background-color:var(--vlist-group-header-bg,#f3f4f6);z-index:1;overflow:hidden}.vlist-group-header:hover{background-color:var(--vlist-group-header-bg,#f3f4f6)}.vlist-sticky-header{left:0;right:0;background-color:var(--vlist-group-header-bg,#f3f4f6)}.vlist--horizontal{overflow:hidden}.vlist--horizontal .vlist-viewport{overflow-x:auto;overflow-y:hidden}.vlist--horizontal .vlist-content{height:100%;width:auto}.vlist--horizontal .vlist-item,.vlist--horizontal .vlist-group-header{position:absolute;top:0;bottom:0;left:0;right:auto;display:flex;align-items:center;justify-content:center;border-bottom:none;border-right:1px solid var(--vlist-border)}.vlist-scrollbar--horizontal{top:auto;left:var(--vlist-custom-scrollbar-padding-left);right:var(--vlist-custom-scrollbar-padding-right);bottom:var(--vlist-custom-scrollbar-padding-bottom);width:auto;height:var(--vlist-custom-scrollbar-width)}.vlist-scrollbar--horizontal .vlist-scrollbar__thumb{top:0;left:0;width:auto;height:100%}.vlist-viewport--gutter{padding-right:calc( var(--vlist-custom-scrollbar-padding-right) + var(--vlist-custom-scrollbar-width) + var(--vlist-custom-scrollbar-padding-left) )}.vlist--horizontal .vlist-viewport--gutter{padding-right:0;padding-bottom:calc( var(--vlist-custom-scrollbar-padding-bottom) + var(--vlist-custom-scrollbar-width) + var(--vlist-custom-scrollbar-padding-top) )}.vlist-viewport--custom-scrollbar{scrollbar-width:none;-ms-overflow-style:none}.vlist-viewport--custom-scrollbar::-webkit-scrollbar{display:none}.vlist-viewport--no-scrollbar{scrollbar-width:none;-ms-overflow-style:none}.vlist-viewport--no-scrollbar::-webkit-scrollbar{display:none}.vlist-viewport--gutter-stable{scrollbar-gutter:stable}.vlist-sort-ghost{opacity:0.85;box-shadow:0 4px 16px rgba(0,0,0,0.18);cursor:grabbing}.vlist-item--drag-source{opacity:0 !important;pointer-events:none}.vlist--sorting{cursor:grabbing;-webkit-user-select:none;user-select:none;-webkit-touch-callout:none}.vlist--sorting *{cursor:inherit !important}.vlist-item--kb-sorting{outline:2px solid var(--vlist-focus-ring,#3b82f6);outline-offset:-2px;background-color:var(--vlist-bg-selected);z-index:1}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vlist",
-  "version": "1.9.1",
+  "version": "2.0.0",
   "description": "Lightweight, high-performance virtual list with zero dependencies",
   "author": {
     "name": "Floor IO",
@@ -47,8 +47,7 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "dist/index.js",
-    "dist/internals.js",
+    "dist/**/*.js",
     "dist/**/*.d.ts",
     "dist/**/*.css",
     "dist/size.json",
@@ -63,9 +62,13 @@
     "test": "bun test",
     "test:changed": "bun test --changed",
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
+    "bench": "bun run scripts/bench.ts",
+    "bench:quick": "bun run scripts/bench.ts --quick",
+    "bench:full": "bun run scripts/bench.ts --full",
+    "bench:compare": "bun run scripts/bench.ts --quick --compare",
     "size": "bun run scripts/measure-size.ts",
     "release": "bun run scripts/release.ts",
-    "prepublishOnly": "bun run build --types && cp README.md README.github.md && cp npm-readme.md README.md",
+    "prepublishOnly": "bun run build -- --types && cp README.md README.github.md && cp npm-readme.md README.md",
     "postpublish": "cp README.github.md README.md && rm README.github.md"
   },
   "bugs": {
@@ -73,8 +76,10 @@
   },
   "homepage": "https://vlist.io",
   "devDependencies": {
+    "@happy-dom/global-registrator": "^20.9.0",
     "@types/bun": "^1.0.0",
     "@types/jsdom": "^27.0.0",
+    "happy-dom": "^20.9.0",
     "jsdom": "^28.0.0",
     "typescript": "^5.0.0"
   }

package/dist/builder/a11y.d.ts

@@ -1,16 +0,0 @@
-/**
- * vlist/builder -- Baseline ARIA keyboard navigation
- *
- * Extracted from core.ts to reduce the base bundle size.
- * Implements the WAI-ARIA listbox pattern: arrow keys move focus,
- * Space/Enter selects, click selects + focuses.
- */
-import type { VListItem } from "../types";
-import type { MRefs } from "./materialize";
-import type { DOMStructure } from "./dom";
-/**
- * Wire up baseline single-select ARIA keyboard navigation.
- * Registers focus/blur listeners, keydown handler, click handler, and destroy cleanup.
- */
-export declare const setupBaselineA11y: <T extends VListItem>($: MRefs<T>, dom: DOMStructure, cp: string, ap: string, hz: boolean, ps: number, pe: number, wr: boolean, methods: Map<string, Function>, rendered: Map<number, HTMLElement>, keydownHandlers: Array<(event: KeyboardEvent) => void>, clickHandlers: Array<(event: MouseEvent) => void>, destroyHandlers: Array<() => void>, foc: boolean) => void;
-//# sourceMappingURL=a11y.d.ts.map