vlist 2.0.0 → 2.0.1

package/dist/core/types.js

@@ -1,7 +0,0 @@
-/**
- * vlist v2 — Core Type Definitions
- *
- * Zero-allocation pipeline types. All hot-path state lives in TypedArrays
- * on the EngineState singleton — no intermediate object allocation.
- */
-export {};

package/dist/core/velocity.js

@@ -1,33 +0,0 @@
-/**
- * vlist v2 — Velocity Tracking
- * Lightweight 2-sample velocity tracker for scroll momentum detection.
- */
-export const MIN_RELIABLE_SAMPLES = 2;
-/** Create a velocity tracker. */
-export const createVelocityTracker = (_initialPosition = 0) => ({
-    velocity: 0,
-    sampleCount: 0,
-});
-/** Update velocity from new scroll position. Mutates tracker in place. */
-export const updateVelocityTracker = (tracker, newPosition) => {
-    const now = performance.now();
-    const lastTime = tracker._lt ?? now;
-    const lastPos = tracker._lp ?? newPosition;
-    const dt = now - lastTime;
-    tracker._lp = newPosition;
-    tracker._lt = now;
-    // Zero time delta — record position but can't compute velocity
-    if (dt === 0) {
-        tracker.sampleCount = Math.min(tracker.sampleCount + 1, 5);
-        return tracker;
-    }
-    // Stale gap — reset
-    if (dt > 100) {
-        tracker.velocity = 0;
-        tracker.sampleCount = 1;
-        return tracker;
-    }
-    tracker.velocity = Math.abs(newPosition - lastPos) / dt;
-    tracker.sampleCount = Math.min(tracker.sampleCount + 1, 5);
-    return tracker;
-};

package/dist/events/emitter.js

@@ -1,60 +0,0 @@
-/**
- * vlist - Event Emitter
- * Lightweight, type-safe event system
- */
-// =============================================================================
-// Event Emitter
-// =============================================================================
-/**
- * Create a type-safe event emitter
- * Functional approach - returns an object with methods
- */
-export const createEmitter = () => {
-    const listeners = {};
-    /**
-     * Subscribe to an event
-     */
-    const on = (event, handler) => {
-        if (!listeners[event]) {
-            listeners[event] = new Set();
-        }
-        listeners[event].add(handler);
-        // Return unsubscribe function
-        return () => off(event, handler);
-    };
-    /**
-     * Unsubscribe from an event
-     */
-    const off = (event, handler) => {
-        listeners[event]?.delete(handler);
-    };
-    /**
-     * Emit an event to all subscribers
-     */
-    const emit = (event, payload) => {
-        listeners[event]?.forEach((handler) => {
-            try {
-                handler(payload);
-            }
-            catch (error) {
-                if (process.env.NODE_ENV !== "production") {
-                    console.error(`[vlist] Error in event handler for "${String(event)}":`, error);
-                }
-            }
-        });
-    };
-    /**
-     * Remove all listeners for an event (or all events if no event specified)
-     */
-    const clear = (event) => {
-        if (event) {
-            delete listeners[event];
-        }
-        else {
-            for (const key in listeners) {
-                delete listeners[key];
-            }
-        }
-    };
-    return { on, off, emit, clear };
-};

package/dist/events/index.js

@@ -1,6 +0,0 @@
-/**
- * vlist - Events Domain
- * Event emitter system
- */
-// Event Emitter
-export { createEmitter } from "./emitter";

package/dist/plugins/a11y/index.js

@@ -1 +0,0 @@
-export { a11y } from "./plugin";

package/dist/plugins/a11y/plugin.js

@@ -1,259 +0,0 @@
-/**
- * vlist v2 — A11y Plugin
- *
- * Baseline keyboard navigation, single-select, focus management, and ARIA.
- * Extracted from createVList() so it tree-shakes when selection() is used.
- *
- * Priority 55 — runs after selection (50). If selection already set
- * itemStateFn, this plugin becomes a no-op.
- */
-export function a11y() {
-    return {
-        name: "a11y",
-        priority: 55,
-        setup(ctx) {
-            if (ctx.getItemStateFn())
-                return;
-            const dom = ctx.dom;
-            const config = ctx.config;
-            const sizeCache = ctx.sizeCache;
-            const engineState = ctx.getState();
-            const emitter = ctx.emitter;
-            const classPrefix = config.classPrefix;
-            const liveRegion = dom.liveRegion;
-            let focusIdx = -1;
-            let focusVis = false;
-            let selId;
-            let selIdx = -1;
-            const getItem = (i) => ctx.getItem(i);
-            const getTotal = () => engineState.totalItems;
-            const _focusEvt = { id: 0, index: 0 };
-            const _selEvt = { selected: [], items: [] };
-            ctx.setItemStateFn((_i, is) => {
-                is.selected = selIdx === _i;
-                is.focused = focusVis && focusIdx === _i;
-            });
-            function announce(message) {
-                liveRegion.textContent = "";
-                liveRegion.textContent = message;
-            }
-            const skip = (from, dir, total) => {
-                let i = from;
-                while (i >= 0 && i < total) {
-                    const it = getItem(i);
-                    if (!it || !it.__groupHeader)
-                        return i;
-                    i += dir;
-                }
-                i = from - dir;
-                while (i >= 0 && i < total) {
-                    const it = getItem(i);
-                    if (!it || !it.__groupHeader)
-                        return i;
-                    i -= dir;
-                }
-                return from;
-            };
-            const scrollIntoView = (idx) => {
-                const nav = ctx.getNavConfig();
-                const ci = nav.scrollIndex ? nav.scrollIndex(idx) : idx;
-                const off = sizeCache.getOffset(ci);
-                const sz = sizeCache.getSize(ci);
-                const sp = engineState.scrollPosition;
-                const cs = engineState.containerSize;
-                const sP = config.startPadding;
-                const eP = config.endPadding;
-                const adjTop = off + sP;
-                const adjBot = adjTop + sz;
-                let pos = sp;
-                if (adjTop < sp)
-                    pos = Math.max(0, off);
-                else if (adjBot > sp + cs)
-                    pos = adjBot + eP - cs;
-                if (pos !== sp) {
-                    engineState.scrollPosition = pos;
-                    ctx.scrollTo(pos);
-                }
-            };
-            const commit = (idx, scroll) => {
-                dom.content.setAttribute("aria-activedescendant", `${classPrefix}-item-${idx}`);
-                if (scroll)
-                    scrollIntoView(idx);
-                ctx.forceRender();
-            };
-            const move = (next) => {
-                focusIdx = next;
-                focusVis = true;
-                commit(next, true);
-                const it = getItem(next);
-                if (it) {
-                    _focusEvt.id = it.id;
-                    _focusEvt.index = next;
-                    emitter.emit("focus:change", _focusEvt);
-                    announce(`Item ${next + 1} of ${getTotal()}`);
-                }
-            };
-            const select = (idx, kbd) => {
-                focusIdx = idx;
-                if (kbd)
-                    focusVis = true;
-                const it = getItem(idx);
-                if (it && selId === it.id) {
-                    selId = undefined;
-                    selIdx = -1;
-                }
-                else {
-                    selId = it?.id;
-                    selIdx = it ? idx : -1;
-                }
-                commit(idx, kbd);
-                if (selId !== undefined && it && selId === it.id) {
-                    _selEvt.selected[0] = selId;
-                    _selEvt.selected.length = 1;
-                    _selEvt.items[0] = it;
-                    _selEvt.items.length = 1;
-                    announce(`Selected, item ${idx + 1} of ${getTotal()}`);
-                }
-                else {
-                    _selEvt.selected.length = 0;
-                    _selEvt.items.length = 0;
-                    announce(`Deselected`);
-                }
-                emitter.emit("selection:change", _selEvt);
-            };
-            // ── Focus handlers ──────────────────────────────────────────
-            const onFocusIn = () => {
-                if (engineState.destroyed)
-                    return;
-                if (!dom.content.matches(":focus-visible"))
-                    return;
-                const t = getTotal();
-                if (t === 0)
-                    return;
-                let tgt = focusIdx >= 0 ? Math.min(focusIdx, t - 1) : 0;
-                tgt = skip(tgt, 1, t);
-                move(tgt);
-            };
-            const onFocusOut = (e) => {
-                if (engineState.destroyed)
-                    return;
-                const rel = e.relatedTarget;
-                if (rel && dom.root.contains(rel))
-                    return;
-                focusVis = false;
-                dom.content.removeAttribute("aria-activedescendant");
-                ctx.forceRender();
-            };
-            dom.content.addEventListener("focusin", onFocusIn);
-            dom.content.addEventListener("focusout", onFocusOut);
-            // ── Keyboard handler ────────────────────────────────────────
-            ctx.registerKeydownHandler((e) => {
-                if (engineState.destroyed)
-                    return;
-                const total = getTotal();
-                if (total === 0)
-                    return;
-                const p = focusIdx;
-                let n = p;
-                if (e.key === " " || e.key === "Enter") {
-                    if (p >= 0) {
-                        const it = getItem(p);
-                        if (it && !it.__groupHeader) {
-                            select(p, true);
-                        }
-                    }
-                    e.preventDefault();
-                    return;
-                }
-                const nav = ctx.getNavConfig();
-                if (nav.navigate) {
-                    switch (e.key) {
-                        case "ArrowUp":
-                        case "ArrowDown":
-                        case "ArrowLeft":
-                        case "ArrowRight":
-                        case "PageUp":
-                        case "PageDown":
-                        case "Home":
-                        case "End":
-                            n = nav.navigate(p, e.key, total);
-                            break;
-                        default: return;
-                    }
-                }
-                else {
-                    const ud = nav.ud || 1;
-                    const lr = nav.lr;
-                    const hz = config.horizontal;
-                    switch (e.key) {
-                        case "ArrowUp":
-                            if (hz && !lr)
-                                return;
-                            n = p - (hz ? lr : ud);
-                            break;
-                        case "ArrowDown":
-                            if (hz && !lr)
-                                return;
-                            n = p + (hz ? lr : ud);
-                            break;
-                        case "ArrowLeft":
-                            if (!hz && !lr)
-                                return;
-                            n = p - (hz ? ud : lr);
-                            break;
-                        case "ArrowRight":
-                            if (!hz && !lr)
-                                return;
-                            n = p + (hz ? ud : lr);
-                            break;
-                        case "PageUp":
-                        case "PageDown": {
-                            const sz = sizeCache.getSize(Math.max(0, nav.scrollIndex ? nav.scrollIndex(p) : p));
-                            const visRows = Math.max(1, Math.floor(engineState.containerSize / sz));
-                            const delta = visRows * ud;
-                            n = e.key === "PageUp" ? p - delta : p + delta;
-                            break;
-                        }
-                        case "Home":
-                            n = 0;
-                            break;
-                        case "End":
-                            n = total - 1;
-                            break;
-                        default: return;
-                    }
-                }
-                if (n < 0)
-                    n = 0;
-                else if (n >= total)
-                    n = total - 1;
-                e.preventDefault();
-                n = skip(n, n >= p ? 1 : -1, total);
-                if (n !== p)
-                    move(n);
-            });
-            // ── Click handler ───────────────────────────────────────────
-            ctx.registerClickHandler((e) => {
-                if (engineState.destroyed)
-                    return;
-                const el = e.target.closest("[data-index]");
-                if (!el)
-                    return;
-                const idx = parseInt(el.dataset.index ?? "-1", 10);
-                if (idx < 0)
-                    return;
-                const it = getItem(idx);
-                if (!it || it.__groupHeader)
-                    return;
-                focusVis = false;
-                dom.content.focus({ preventScroll: true });
-                select(idx, false);
-            });
-            // ── Cleanup ─────────────────────────────────────────────────
-            ctx.registerDestroyHandler(() => {
-                dom.content.removeEventListener("focusin", onFocusIn);
-                dom.content.removeEventListener("focusout", onFocusOut);
-            });
-        },
-    };
-}

package/dist/plugins/async/index.js

@@ -1,12 +0,0 @@
-/**
- * vlist - Data Domain
- * Data management, sparse storage, and placeholder generation
- */
-// v2 Plugin
-export { data } from "./plugin";
-// Data Manager
-export { createDataManager, mergeRanges, calculateMissingRanges, isPlaceholderItem, filterPlaceholders, countRealItems, } from "./manager";
-// Sparse Storage
-export { createSparseStorage, } from "./sparse";
-// Placeholder
-export { createPlaceholderManager, } from "./placeholder";