@floor/vlist 0.6.1 → 0.7.0

package/dist/plugins/groups/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * vlist - Groups Domain
- * Sticky headers and grouped lists
- */
-export { withGroups, type GroupsPluginConfig } from "./plugin";
-export type { GroupsConfig, GroupBoundary, LayoutEntry, GroupHeaderItem, GroupLayout, StickyHeader, } from "./types";
-export { isGroupHeader } from "./types";
-export { createGroupLayout, buildLayoutItems, createGroupedHeightFn, } from "./layout";
-export { createStickyHeader } from "./sticky";
-//# sourceMappingURL=index.d.ts.map

package/dist/plugins/groups/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/groups/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG/D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,eAAe,EACf,WAAW,EACX,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}

package/dist/plugins/groups/layout.d.ts

@@ -1,46 +0,0 @@
-/**
- * vlist - Group Layout
- * Computes group boundaries and maps between data indices and layout indices.
- *
- * The layout transforms a flat items array into a "layout" that includes
- * group header pseudo-items interspersed at group boundaries:
- *
- *   Data:   [item0, item1, item2, item3, item4, item5]
- *   Groups: [  A,     A,     A,     B,     B,     C  ]
- *   Layout: [headerA, item0, item1, item2, headerB, item3, item4, headerC, item5]
- *   Index:  [  0,       1,     2,     3,      4,      5,     6,      7,      8  ]
- *
- * All lookups are O(log g) where g = number of groups, using binary search
- * on the sorted group boundaries array.
- */
-import type { GroupsConfig, GroupBoundary, GroupLayout, GroupHeaderItem } from "./types";
-import type { VListItem } from "../../types";
-/**
- * Build the transformed layout items array with header pseudo-items inserted
- * at group boundaries.
- *
- * @param items - Original data items
- * @param groups - Computed group boundaries
- * @returns Array of items and header pseudo-items in layout order
- */
-export declare const buildLayoutItems: <T extends VListItem>(items: T[], groups: readonly GroupBoundary[]) => Array<T | GroupHeaderItem>;
-/**
- * Create a height function for the layout that returns the correct height
- * for both group headers and data items.
- *
- * @param layout - The group layout instance
- * @param itemHeight - Original item height config (number or function)
- * @returns A height function (layoutIndex) => number suitable for HeightCache
- */
-export declare const createGroupedHeightFn: (layout: GroupLayout, itemHeight: number | ((index: number) => number)) => ((layoutIndex: number) => number);
-/**
- * Create a GroupLayout instance.
- *
- * The layout computes group boundaries from items and provides efficient
- * O(log g) mappings between data indices and layout indices.
- *
- * @param itemCount - Number of data items
- * @param config - Groups configuration
- */
-export declare const createGroupLayout: (itemCount: number, config: GroupsConfig) => GroupLayout;
-//# sourceMappingURL=layout.d.ts.map

package/dist/plugins/groups/layout.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/plugins/groups/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EAEX,eAAe,EAChB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA+G7C;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,SAAS,EAClD,OAAO,CAAC,EAAE,EACV,QAAQ,SAAS,aAAa,EAAE,KAC/B,KAAK,CAAC,CAAC,GAAG,eAAe,CA0B3B,CAAC;AAMF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,WAAW,EACnB,YAAY,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,KAC/C,CAAC,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAelC,CAAC;AAMF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,EACjB,QAAQ,YAAY,KACnB,WAkIF,CAAC"}

package/dist/plugins/groups/plugin.d.ts

@@ -1,64 +0,0 @@
-/**
- * vlist/groups - Builder Plugin
- * Adds grouped lists with sticky section headers.
- *
- * Priority: 10 (runs first — transforms item list and height function before rendering)
- *
- * What it wires:
- * - Transforms item list — inserts header items at group boundaries
- * - Replaces height function — headers use headerHeight, data items use configured item.height
- * - Unified template — dispatches to headerTemplate for headers, user template for items
- * - Sticky header DOM — creates a positioned header element that updates as you scroll
- * - Index mapping — translates between data indices and layout indices
- * - CSS class — adds .vlist--grouped to the root element
- *
- * Restrictions:
- * - Items must be pre-sorted by group
- * - Cannot be combined with direction: 'horizontal'
- *
- * Can be combined with:
- * - withGrid for grouped 2D layouts
- * - reverse: true (sticky header shows current section as you scroll up through history)
- */
-import type { VListItem } from "../../types";
-import type { VListPlugin } from "../../builder/types";
-/** Groups plugin configuration */
-export interface GroupsPluginConfig {
-    /** Returns group key for item at index (required) */
-    getGroupForIndex: (index: number) => string;
-    /** Height of group headers in pixels (required) */
-    headerHeight: number;
-    /** Render function for headers (required) */
-    headerTemplate: (key: string, groupIndex: number) => HTMLElement | string;
-    /** Enable sticky headers — iOS Contacts style (default: true) */
-    sticky?: boolean;
-}
-/**
- * Create a groups plugin for the builder.
- *
- * Adds grouped lists with sticky section headers.
- *
- * ```ts
- * import { vlist } from 'vlist/builder'
- * import { withGroups } from 'vlist/groups'
- *
- * const contacts = vlist({
- *   container: '#contacts',
- *   item: { height: 56, template: renderContact },
- *   items: sortedContacts,
- * })
- * .use(withGroups({
- *   getGroupForIndex: (i) => sortedContacts[i].lastName[0],
- *   headerHeight: 32,
- *   headerTemplate: (letter) => {
- *     const el = document.createElement('div')
- *     el.className = 'letter-header'
- *     el.textContent = letter
- *     return el
- *   },
- * }))
- * .build()
- * ```
- */
-export declare const withGroups: <T extends VListItem = VListItem>(config: GroupsPluginConfig) => VListPlugin<T>;
-//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/groups/plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/groups/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,qBAAqB,CAAC;AAuBvE,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAE5C,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,WAAW,GAAG,MAAM,CAAC;IAE1E,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,SAAS,GAAG,SAAS,EACxD,QAAQ,kBAAkB,KACzB,WAAW,CAAC,CAAC,CAmRf,CAAC"}

package/dist/plugins/groups/sticky.d.ts

@@ -1,33 +0,0 @@
-/**
- * vlist - Sticky Header
- * Manages a floating header element that "sticks" to the top of the viewport
- * and transitions smoothly when the next group's header approaches.
- *
- * The sticky header is a separate DOM element positioned absolutely at the
- * top of the root container. It overlays the scrolling content and shows
- * the current group's header. When the next group's inline header scrolls
- * into view, the sticky header is pushed upward to create the classic
- * iOS Contacts-style transition effect.
- *
- * Layout:
- *   .vlist (root, position: relative)
- *   ├── .vlist-sticky-header (position: absolute, top: 0, z-index: 5)
- *   │   └── (content rendered by headerTemplate)
- *   └── .vlist-viewport
- *       └── .vlist-content
- *           └── .vlist-items
- */
-import type { GroupLayout, GroupsConfig, StickyHeader } from "./types";
-import type { HeightCache } from "../../render/heights";
-/**
- * Create a sticky header manager.
- *
- * @param root - The vlist root element (.vlist) — sticky header is appended here
- * @param layout - Group layout for index/group resolution
- * @param heightCache - The LAYOUT height cache (includes headers)
- * @param config - Groups configuration (headerTemplate, headerHeight)
- * @param classPrefix - CSS class prefix (default: 'vlist')
- * @returns StickyHeader instance
- */
-export declare const createStickyHeader: (root: HTMLElement, layout: GroupLayout, heightCache: HeightCache, config: GroupsConfig, classPrefix: string) => StickyHeader;
-//# sourceMappingURL=sticky.d.ts.map

package/dist/plugins/groups/sticky.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sticky.d.ts","sourceRoot":"","sources":["../../../src/plugins/groups/sticky.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMxD;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,WAAW,EACjB,QAAQ,WAAW,EACnB,aAAa,WAAW,EACxB,QAAQ,YAAY,EACpB,aAAa,MAAM,KAClB,YAgMF,CAAC"}

package/dist/plugins/groups/types.d.ts

@@ -1,86 +0,0 @@
-/**
- * vlist - Group Types
- * Types for sticky headers and grouped lists
- */
-import type { VListItem, GroupsConfig } from "../../types";
-export type { GroupsConfig };
-/** A single group boundary */
-export interface GroupBoundary {
-    /** Group key (return value of getGroupForIndex) */
-    key: string;
-    /** Sequential group index (0-based) */
-    groupIndex: number;
-    /** Layout index of this group's header */
-    headerLayoutIndex: number;
-    /** Data index of the first item in this group */
-    firstDataIndex: number;
-    /** Number of data items in this group */
-    count: number;
-}
-/** Entry type in the layout — either a group header or a data item */
-export type LayoutEntry = {
-    type: "header";
-    group: GroupBoundary;
-} | {
-    type: "item";
-    dataIndex: number;
-    group: GroupBoundary;
-};
-/**
- * Internal marker for group header pseudo-items inserted into the layout.
- * These are interleaved with real data items in the transformed items array.
- */
-export interface GroupHeaderItem extends VListItem {
-    /** Always `__group_header_{groupIndex}` */
-    id: string;
-    /** Discriminator flag */
-    __groupHeader: true;
-    /** The group key */
-    groupKey: string;
-    /** Sequential group index (0-based) */
-    groupIndex: number;
-}
-/**
- * Type guard: check if an item is a group header pseudo-item
- */
-export declare const isGroupHeader: (item: unknown) => item is GroupHeaderItem;
-/** Group layout — maps between data indices and layout indices */
-export interface GroupLayout {
-    /** Total layout entries (data items + group headers) */
-    readonly totalEntries: number;
-    /** Number of groups */
-    readonly groupCount: number;
-    /** All group boundaries, in order */
-    readonly groups: readonly GroupBoundary[];
-    /** Get the layout entry at a layout index — O(log g) */
-    getEntry: (layoutIndex: number) => LayoutEntry;
-    /** Map layout index → data index, or -1 if it's a header — O(log g) */
-    layoutToDataIndex: (layoutIndex: number) => number;
-    /** Map data index → layout index — O(log g) */
-    dataToLayoutIndex: (dataIndex: number) => number;
-    /** Get the group boundary that contains a given layout index — O(log g) */
-    getGroupAtLayoutIndex: (layoutIndex: number) => GroupBoundary;
-    /** Get the group boundary that contains a given data index — O(log g) */
-    getGroupAtDataIndex: (dataIndex: number) => GroupBoundary;
-    /** Get header height for a group */
-    getHeaderHeight: (groupIndex: number) => number;
-    /**
-     * Rebuild the layout from scratch.
-     * Call when items change (setItems, append, prepend, remove, etc.)
-     */
-    rebuild: (itemCount: number) => void;
-}
-/** Sticky header manager */
-export interface StickyHeader {
-    /** Update sticky header position and content based on scroll position */
-    update: (scrollTop: number) => void;
-    /** Force refresh the sticky header content (e.g. after items change) */
-    refresh: () => void;
-    /** Show the sticky header */
-    show: () => void;
-    /** Hide the sticky header */
-    hide: () => void;
-    /** Destroy and remove the sticky header DOM element */
-    destroy: () => void;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/plugins/groups/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/groups/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3D,YAAY,EAAE,YAAY,EAAE,CAAC;AAM7B,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IAEZ,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IAEnB,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAE1B,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IAEvB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sEAAsE;AACtE,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAM9D;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IAEX,yBAAyB;IACzB,aAAa,EAAE,IAAI,CAAC;IAEpB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IAEjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,OAAO,KAAG,IAAI,IAAI,eAMrD,CAAC;AAMF,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAE1C,wDAAwD;IACxD,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,WAAW,CAAC;IAE/C,uEAAuE;IACvE,iBAAiB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IAEnD,+CAA+C;IAC/C,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAEjD,2EAA2E;IAC3E,qBAAqB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,aAAa,CAAC;IAE9D,yEAAyE;IACzE,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,aAAa,CAAC;IAE1D,oCAAoC;IACpC,eAAe,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAEhD;;;OAGG;IACH,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAMD,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC,wEAAwE;IACxE,OAAO,EAAE,MAAM,IAAI,CAAC;IAEpB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB,uDAAuD;IACvD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB"}

package/dist/plugins/scroll/controller.d.ts

@@ -1,121 +0,0 @@
-/**
- * vlist - Scroll Controller
- * Handles both native scrolling and manual wheel-based scrolling for compressed lists
- *
- * When compression is active (large lists exceeding browser height limits),
- * we switch from native scrolling to manual wheel event handling.
- * This allows smooth scrolling through millions of items.
- */
-import type { CompressionState } from "../../render/compression";
-/** Scroll direction */
-export type ScrollDirection = "up" | "down";
-/** Scroll event data */
-export interface ScrollEventData {
-    scrollTop: number;
-    direction: ScrollDirection;
-    velocity: number;
-}
-/** Scroll controller configuration */
-export interface ScrollControllerConfig {
-    /** Enable compressed scroll mode (manual wheel handling) */
-    compressed?: boolean;
-    /** Compression state for calculating bounds */
-    compression?: CompressionState;
-    /**
-     * External scroll element for window/document scrolling.
-     * When set, the controller listens to this element's scroll events
-     * and computes list-relative positions from the viewport's bounding rect.
-     */
-    scrollElement?: Window;
-    /** Allow mouse wheel to scroll (default: true) */
-    wheel?: boolean;
-    /** Wheel sensitivity multiplier (default: 1) */
-    sensitivity?: number;
-    /** Enable smooth scrolling interpolation */
-    smoothing?: boolean;
-    /** Scroll idle detection timeout in ms (default: 150) */
-    idleTimeout?: number;
-    /**
-     * Enable horizontal scrolling mode.
-     * When true, the controller reads scrollLeft instead of scrollTop,
-     * uses clientWidth instead of clientHeight, and maps wheel deltaX.
-     */
-    horizontal?: boolean;
-    /** Callback when scroll position changes */
-    onScroll?: (data: ScrollEventData) => void;
-    /** Callback when scrolling becomes idle */
-    onIdle?: () => void;
-}
-/** Scroll controller instance */
-export interface ScrollController {
-    /** Get current scroll position */
-    getScrollTop: () => number;
-    /** Set scroll position */
-    scrollTo: (position: number, smooth?: boolean) => void;
-    /** Scroll by delta */
-    scrollBy: (delta: number) => void;
-    /** Check if at top */
-    isAtTop: () => boolean;
-    /** Check if at bottom */
-    isAtBottom: (threshold?: number) => boolean;
-    /** Get scroll percentage (0-1) */
-    getScrollPercentage: () => number;
-    /** Get current scroll velocity (px/ms, absolute value) */
-    getVelocity: () => number;
-    /**
-     * Check if the velocity tracker is actively tracking with enough samples.
-     * Returns false during ramp-up (first few frames of a new scroll gesture)
-     * when the tracker doesn't have enough samples yet.
-     */
-    isTracking: () => boolean;
-    /** Check if currently scrolling */
-    isScrolling: () => boolean;
-    /** Update configuration (e.g., when compression state changes) */
-    updateConfig: (config: Partial<ScrollControllerConfig>) => void;
-    /** Enable compressed mode */
-    enableCompression: (compression: CompressionState) => void;
-    /** Disable compressed mode (revert to native scroll) */
-    disableCompression: () => void;
-    /** Check if compressed mode is active */
-    isCompressed: () => boolean;
-    /** Check if in window scroll mode */
-    isWindowMode: () => boolean;
-    /**
-     * Update the container height used for scroll calculations.
-     * In window mode, call this when the window resizes.
-     */
-    updateContainerHeight: (height: number) => void;
-    /** Destroy and cleanup */
-    destroy: () => void;
-}
-/**
- * Create a scroll controller for a viewport element
- *
- * Supports two modes:
- * 1. Native scrolling (default) - uses browser's built-in scroll
- * 2. Compressed scrolling - manual wheel handling for large lists
- */
-export declare const createScrollController: (viewport: HTMLElement, config?: ScrollControllerConfig) => ScrollController;
-/**
- * Throttle scroll handler using requestAnimationFrame
- */
-export declare const rafThrottle: <T extends (...args: any[]) => void>(fn: T) => ((...args: Parameters<T>) => void) & {
-    cancel: () => void;
-};
-/**
- * Check if scroll position is at bottom
- */
-export declare const isAtBottom: (scrollTop: number, scrollHeight: number, clientHeight: number, threshold?: number) => boolean;
-/**
- * Check if scroll position is at top
- */
-export declare const isAtTop: (scrollTop: number, threshold?: number) => boolean;
-/**
- * Get scroll percentage (0-1)
- */
-export declare const getScrollPercentage: (scrollTop: number, scrollHeight: number, clientHeight: number) => number;
-/**
- * Check if a range is visible in the scroll viewport
- */
-export declare const isRangeVisible: (rangeStart: number, rangeEnd: number, visibleStart: number, visibleEnd: number) => boolean;
-//# sourceMappingURL=controller.d.ts.map

package/dist/plugins/scroll/controller.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/plugins/scroll/controller.ts"],"names":[],"mappings":"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"}

package/dist/plugins/scroll/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * vlist - Scroll Domain
- * Scroll controller and custom scrollbar
- */
-export { withScrollbar, type ScrollbarPluginConfig } from "./plugin";
-export { createScrollController, rafThrottle, isAtBottom, isAtTop, getScrollPercentage, isRangeVisible, type ScrollController, type ScrollControllerConfig, type ScrollEventData, type ScrollDirection, } from "./controller";
-export { createScrollbar, type Scrollbar, type ScrollbarConfig, type ScrollCallback, } from "./scrollbar";
-//# sourceMappingURL=index.d.ts.map

package/dist/plugins/scroll/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/scroll/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGrE,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,OAAO,EACP,mBAAmB,EACnB,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC"}

package/dist/plugins/scroll/plugin.d.ts

@@ -1,60 +0,0 @@
-/**
- * vlist/scroll - Builder Plugin
- * Wraps the custom scrollbar into a VListPlugin for the composable builder.
- *
- * Priority: 30 (runs after renderer/data setup but before selection)
- *
- * What it wires:
- * - DOM elements — track, thumb, and optional hover zone appended to viewport
- * - CSS class — .vlist-viewport--custom-scrollbar hides native scrollbar
- * - Drag handlers — mousedown on thumb, mousemove/mouseup on document
- * - Track click — click on track to jump to position
- * - Hover handlers — mouseenter/leave on track, hover zone, and viewport
- * - Scroll sync — updates thumb position on every scroll frame
- * - Resize sync — updates thumb size when container or content height changes
- *
- * No public methods are added — the scrollbar is entirely automatic.
- */
-import type { VListItem } from "../../types";
-import type { VListPlugin } from "../../builder/types";
-/** Scrollbar plugin configuration */
-export interface ScrollbarPluginConfig {
-    /** Auto-hide scrollbar after idle (default: true) */
-    autoHide?: boolean;
-    /** Auto-hide delay in milliseconds (default: 1000) */
-    autoHideDelay?: number;
-    /** Minimum thumb size in pixels (default: 30) */
-    minThumbSize?: number;
-    /**
-     * Show scrollbar when hovering near the scrollbar edge (default: true).
-     * When true, an invisible hover zone is placed along the scrollbar edge.
-     */
-    showOnHover?: boolean;
-    /**
-     * Width of the invisible hover zone in pixels (default: 16).
-     * Only used when `showOnHover` is true.
-     */
-    hoverZoneWidth?: number;
-    /**
-     * Show scrollbar when the mouse enters the list viewport (default: true).
-     * When false, the scrollbar only appears on scroll or hover near edge.
-     */
-    showOnViewportEnter?: boolean;
-}
-/**
- * Create a scrollbar plugin for the builder.
- *
- * Replaces the native browser scrollbar with a custom, cross-browser
- * consistent scrollbar.
- *
- * ```ts
- * import { vlist } from 'vlist/builder'
- * import { withScrollbar } from 'vlist/scroll'
- *
- * const list = vlist({ ... })
- *   .use(withScrollbar({ autoHide: true, autoHideDelay: 1000 }))
- *   .build()
- * ```
- */
-export declare const withScrollbar: <T extends VListItem = VListItem>(config?: ScrollbarPluginConfig) => VListPlugin<T>;
-//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/scroll/plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/scroll/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,qBAAqB,CAAC;AAQvE,qCAAqC;AACrC,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAMD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,SAAS,GAAG,SAAS,EAC3D,SAAS,qBAAqB,KAC7B,WAAW,CAAC,CAAC,CAgFf,CAAC"}

package/dist/plugins/scroll/scrollbar.d.ts

@@ -1,73 +0,0 @@
-/**
- * vlist - Custom Scrollbar
- * Provides visual scroll indication for compressed mode where native scrollbar is hidden
- *
- * Features:
- * - Visual track and thumb
- * - Thumb size proportional to visible content
- * - Click on track to jump to position
- * - Drag thumb to scroll
- * - Auto-hide after idle (optional)
- * - Show on hover with configurable hover zone (optional)
- * - CSS variables for customization
- * - Horizontal mode support (direction-aware axis)
- */
-/** Scrollbar configuration */
-export interface ScrollbarConfig {
-    /** Enable scrollbar (default: true when compressed) */
-    enabled?: boolean;
-    /** Auto-hide scrollbar after idle (default: true) */
-    autoHide?: boolean;
-    /** Auto-hide delay in milliseconds (default: 1000) */
-    autoHideDelay?: number;
-    /** Minimum thumb size in pixels (default: 30) */
-    minThumbSize?: number;
-    /**
-     * Show scrollbar when hovering near the scrollbar edge (default: true).
-     * When true, an invisible hover zone is placed along the scrollbar edge.
-     * Moving the mouse into this zone reveals the scrollbar; it stays visible
-     * as long as the cursor remains over the zone or the track.
-     */
-    showOnHover?: boolean;
-    /**
-     * Width of the invisible hover zone in pixels (default: 16).
-     * Only used when `showOnHover` is true.
-     * A wider zone makes the scrollbar easier to discover;
-     * a narrower zone avoids interference with content near the edge.
-     */
-    hoverZoneWidth?: number;
-    /**
-     * Show scrollbar when the mouse enters the list viewport (default: true).
-     * When false, the scrollbar only appears on scroll or when hovering
-     * near the scrollbar edge (if `showOnHover` is true).
-     */
-    showOnViewportEnter?: boolean;
-}
-/** Scrollbar instance */
-export interface Scrollbar {
-    /** Show the scrollbar */
-    show: () => void;
-    /** Hide the scrollbar */
-    hide: () => void;
-    /** Update scrollbar dimensions based on content/container size */
-    updateBounds: (totalHeight: number, containerHeight: number) => void;
-    /** Update thumb position based on scroll position */
-    updatePosition: (scrollTop: number) => void;
-    /** Check if scrollbar is visible */
-    isVisible: () => boolean;
-    /** Destroy and cleanup */
-    destroy: () => void;
-}
-/** Callback for scroll position changes */
-export type ScrollCallback = (position: number) => void;
-/**
- * Create a scrollbar instance
- *
- * @param viewport - The viewport element to attach scrollbar to
- * @param onScroll - Callback when scrollbar interaction causes scroll
- * @param config - Scrollbar configuration
- * @param classPrefix - CSS class prefix (default: 'vlist')
- * @param horizontal - Whether the scrollbar is horizontal (default: false)
- */
-export declare const createScrollbar: (viewport: HTMLElement, onScroll: ScrollCallback, config?: ScrollbarConfig, classPrefix?: string, horizontal?: boolean) => Scrollbar;
-//# sourceMappingURL=scrollbar.d.ts.map

package/dist/plugins/scroll/scrollbar.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scrollbar.d.ts","sourceRoot":"","sources":["../../../src/plugins/scroll/scrollbar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,yBAAyB;AACzB,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB,yBAAyB;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB,kEAAkE;IAClE,YAAY,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;IAErE,qDAAqD;IACrD,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5C,oCAAoC;IACpC,SAAS,EAAE,MAAM,OAAO,CAAC;IAEzB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,2CAA2C;AAC3C,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;AAiBxD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,WAAW,EACrB,UAAU,cAAc,EACxB,SAAQ,eAAoB,EAC5B,oBAAqB,EACrB,oBAAkB,KACjB,SA4XF,CAAC"}

package/dist/plugins/selection/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * vlist - Selection Domain
- * Selection state management
- */
-export { withSelection, type SelectionPluginConfig } from "./plugin";
-export { createSelectionState, selectItems, deselectItems, toggleSelection, selectAll, clearSelection, setFocusedIndex, moveFocusUp, moveFocusDown, moveFocusToFirst, moveFocusToLast, moveFocusByPage, selectFocused, selectRange, getSelectedIds, getSelectedItems, getSelectionCount, isSelected, isSelectionEmpty, type SelectionState, } from "./state";
-//# sourceMappingURL=index.d.ts.map

package/dist/plugins/selection/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/selection/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGrE,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,eAAe,EACf,SAAS,EACT,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,KAAK,cAAc,GACpB,MAAM,SAAS,CAAC"}

package/dist/plugins/selection/plugin.d.ts

@@ -1,44 +0,0 @@
-/**
- * vlist/selection - Builder Plugin
- * Wraps the selection domain into a VListPlugin for the composable builder.
- *
- * Priority: 50 (runs after renderer and data are ready)
- *
- * What it wires:
- * - Click handler on items container — toggles selection on item click
- * - Keyboard handler on root — ArrowUp/Down for focus, Space/Enter for toggle
- * - ARIA attributes — aria-selected on items, aria-activedescendant on root
- * - Live region — announces selection changes to screen readers
- * - Render integration — passes selection state to render pipeline
- *
- * Added methods: select, deselect, toggleSelect, selectAll, clearSelection,
- *                getSelected, getSelectedItems
- *
- * Added events: item:click, selection:change
- */
-import type { VListItem, SelectionMode } from "../../types";
-import type { VListPlugin } from "../../builder/types";
-/** Selection plugin configuration */
-export interface SelectionPluginConfig {
-    /** Selection mode (default: 'single') */
-    mode?: SelectionMode;
-    /** Initially selected item IDs */
-    initial?: Array<string | number>;
-}
-/**
- * Create a selection plugin for the builder.
- *
- * ```ts
- * import { vlist } from 'vlist/builder'
- * import { withSelection } from 'vlist/selection'
- *
- * const list = vlist({ ... })
- *   .use(withSelection({ mode: 'multiple', initial: ['id-1'] }))
- *   .build()
- *
- * list.select('id-2')
- * list.getSelected() // ['id-1', 'id-2']
- * ```
- */
-export declare const withSelection: <T extends VListItem = VListItem>(config?: SelectionPluginConfig) => VListPlugin<T>;
-//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/selection/plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/selection/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,qBAAqB,CAAC;AAwBvE,qCAAqC;AACrC,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,IAAI,CAAC,EAAE,aAAa,CAAC;IAErB,kCAAkC;IAClC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CAClC;AAMD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,SAAS,GAAG,SAAS,EAC3D,SAAS,qBAAqB,KAC7B,WAAW,CAAC,CAAC,CAwWf,CAAC"}