vlist 1.9.1 → 2.0.1

package/dist/builder/materialize.d.ts

@@ -1,166 +0,0 @@
-/**
- * vlist/builder — Materialize Context Factory
- *
- * Extracts the BuilderContext object, default data-manager proxy, and default
- * scroll-controller proxy out of materialize() in core.ts.
- *
- * All shared mutable state lives in a single `$` (MRefs) object that both
- * core.ts and this module read/write through. Property names are kept short
- * (2–3 chars) so they survive minification without bloating the bundle.
- * Each factory destructures to readable locals on entry.
- *
- * Immutable dependencies are passed via a `deps` (MDeps) object — these are
- * destructured once and never re-read, so their names don't matter at runtime.
- */
-import type { VListItem, VListEvents, ItemTemplate, ItemState, Range } from "../types";
-import type { SizeCache } from "../rendering/sizes";
-import type { Emitter } from "../events/emitter";
-import type { DOMStructure } from "./dom";
-import type { createElementPool } from "./pool";
-import type { BuilderConfig, BuilderContext, BuilderState, ResolvedBuilderConfig } from "./types";
-/**
- * Mutable refs object shared between core.ts materialize() and context factories.
- *
- * Key mapping (short → long):
- *
- * | Key  | Meaning                |
- * |------|------------------------|
- * | it   | items                  |
- * | hc   | sizeCache              |
- * | ch   | containerHeight        |
- * | cw   | containerWidth         |
- * | id   | isDestroyed            |
- * | ii   | isInitialized          |
- * | ls   | lastScrollTop          |
- * | vt   | velocityTracker        |
- * | ss   | selectionSet           |
- * | fi   | focusedIndex           |
- * | la   | lastAriaSetSize        |
- * | dm   | dataManagerProxy       |
- * | sc   | scrollControllerProxy  |
- * | vtf  | virtualTotalFn         |
- * | sgt  | scrollGetTop           |
- * | sst  | scrollSetTop           |
- * | sab  | scrollIsAtBottom       |
- * | sic  | scrollIsCompressed     |
- * | rfn  | renderIfNeededFn       |
- * | ffn  | forceRenderFn          |
- * | gvr  | getVisibleRange        |
- * | gsp  | getScrollToPos         |
- * | pef  | positionElementFn      |
- * | at   | activeTemplate         |
- * | vre  | viewportResizeEnabled  |
- * | st   | scrollTarget           |
- * | gcw  | getContainerWidth      |
- * | gch  | getContainerHeight     |
- */
-export interface MRefs<T extends VListItem = VListItem> {
-    /** items */
-    it: T[];
-    /** sizeCache */
-    hc: SizeCache;
-    /** containerHeight */
-    ch: number;
-    /** containerWidth */
-    cw: number;
-    /** isDestroyed */
-    id: boolean;
-    /** isInitialized */
-    ii: boolean;
-    /** lastScrollTop */
-    ls: number;
-    /** velocityTracker */
-    vt: {
-        velocity: number;
-        sampleCount: number;
-    };
-    /** selectionSet */
-    ss: Set<string | number>;
-    /** focusedIndex */
-    fi: number;
-    /** lastAriaSetSize */
-    la: string;
-    /** dataManagerProxy */
-    dm: any;
-    /** scrollControllerProxy */
-    sc: any;
-    /** virtualTotalFn */
-    vtf: () => number;
-    /** scrollGetTop */
-    sgt: () => number;
-    /** scrollSetTop */
-    sst: (pos: number) => void;
-    /** scrollIsAtBottom */
-    sab: (threshold?: number) => boolean;
-    /** scrollIsCompressed */
-    sic: boolean;
-    /** renderIfNeededFn */
-    rfn: () => void;
-    /** forceRenderFn */
-    ffn: () => void;
-    /** getVisibleRange */
-    gvr: (scrollTop: number, cHeight: number, hc: SizeCache, total: number, out: Range) => void;
-    /** getScrollToPos */
-    gsp: (index: number, hc: SizeCache, cHeight: number, total: number, align: "start" | "center" | "end") => number;
-    /** positionElementFn */
-    pef: (element: HTMLElement, index: number) => void;
-    /** activeTemplate */
-    at: ItemTemplate<T>;
-    /** viewportResizeEnabled */
-    vre: boolean;
-    /** scrollTarget */
-    st: HTMLElement | Window;
-    /** wheelHandler - for features to disable wheel handling if needed */
-    wh: ((e: WheelEvent) => void) | null;
-    /** getContainerWidth */
-    gcw: () => number;
-    /** getContainerHeight */
-    gch: () => number;
-    /** gap — item spacing along main axis (0 = none) */
-    gp: number;
-    /** mainAxisPadding — sum of CSS padding along scroll axis (0 = none) */
-    mp: number;
-    /** stripeIndexFn — maps layout index to stripe index (-1 = skip) */
-    sif: (index: number) => number;
-    /** itemToScrollIndex — maps flat item index to size-cache index (identity for list, floor(index/cols) for grid) */
-    i2s: (index: number) => number;
-    /** updateItemClassesFn */
-    uic: (index: number, isSelected: boolean, isFocused: boolean) => void;
-    /** constrainSizeForIndex — null = always constrain (Mode A default) */
-    csi: ((index: number) => boolean) | null;
-}
-/** Immutable dependencies the context factory needs from materialize(). */
-export interface MDeps<T extends VListItem = VListItem> {
-    readonly dom: DOMStructure;
-    readonly emitter: Emitter<VListEvents<T>>;
-    readonly resolvedConfig: ResolvedBuilderConfig;
-    readonly rawConfig: BuilderConfig<T>;
-    readonly rendered: Map<number, HTMLElement>;
-    readonly pool: ReturnType<typeof createElementPool>;
-    readonly itemState: ItemState;
-    readonly sharedState: BuilderState;
-    readonly renderRange: Range;
-    readonly isHorizontal: boolean;
-    readonly classPrefix: string;
-    readonly contentSizeHandlers: Array<() => void>;
-    readonly idleHandlers: Array<() => void>;
-    readonly afterScroll: Array<(scrollPosition: number, direction: string) => void>;
-    readonly clickHandlers: Array<(event: MouseEvent) => void>;
-    readonly contextMenuHandlers: Array<(event: MouseEvent) => void>;
-    readonly keydownHandlers: Array<(event: KeyboardEvent) => void>;
-    readonly resizeHandlers: Array<(width: number, height: number) => void>;
-    readonly destroyHandlers: Array<() => void>;
-    readonly methods: Map<string, Function>;
-    readonly onScrollFrame: () => void;
-    readonly resizeObserver: ResizeObserver;
-    readonly afterRenderBatch: ReadonlyArray<(items: ReadonlyArray<{
-        index: number;
-        element: HTMLElement;
-    }>) => void>;
-    readonly applyTemplate: (element: HTMLElement, result: string | HTMLElement) => void;
-    readonly updateContentSize: () => void;
-}
-export declare const createMaterializeCtx: <T extends VListItem = VListItem>($: MRefs<T>, deps: MDeps<T>) => BuilderContext<T>;
-export declare const createDefaultDataProxy: <T extends VListItem = VListItem>($: MRefs<T>, deps: Pick<MDeps<T>, "rendered" | "itemState" | "contentSizeHandlers" | "applyTemplate" | "updateContentSize">, ctx: BuilderContext<T>) => any;
-export declare const createDefaultScrollProxy: <T extends VListItem = VListItem>($: MRefs<T>, deps: Pick<MDeps<T>, "dom" | "classPrefix" | "onScrollFrame">) => any;
-//# sourceMappingURL=materialize.d.ts.map

package/dist/builder/pool.d.ts

@@ -1,10 +0,0 @@
-/**
- * vlist/builder — Element Pool
- * Recycling pool for DOM elements to reduce allocation during scrolling.
- */
-export declare const createElementPool: (maxSize?: number) => {
-    acquire: () => HTMLElement;
-    release: (el: HTMLElement) => void;
-    clear: () => void;
-};
-//# sourceMappingURL=pool.d.ts.map

package/dist/builder/range.d.ts

@@ -1,10 +0,0 @@
-/**
- * vlist/builder — Range Calculations
- * Visible range detection, overscan application, and scroll-to-index positioning.
- */
-import type { Range } from "../types";
-import type { SizeCache } from "../rendering/sizes";
-export declare const calcVisibleRange: (scrollPosition: number, containerHeight: number, hc: SizeCache, totalItems: number, out: Range) => void;
-export declare const applyOverscan: (visible: Range, overscan: number, totalItems: number, out: Range) => void;
-export declare const calcScrollToPosition: (index: number, hc: SizeCache, containerHeight: number, totalItems: number, align: "start" | "center" | "end", mainAxisPadding?: number) => number;
-//# sourceMappingURL=range.d.ts.map

package/dist/builder/scroll.d.ts

@@ -1,24 +0,0 @@
-/**
- * vlist/builder — Scroll Utilities
- * Easing, scroll-argument resolution, and smooth scroll animation.
- */
-import type { ScrollToOptions } from "../types";
-export declare const easeInOutQuad: (t: number) => number;
-export declare const resolveScrollArgs: (o?: "start" | "center" | "end" | ScrollToOptions) => {
-    align: "start" | "center" | "end";
-    behavior: "auto" | "smooth";
-    duration: number;
-};
-/** Scroll controller interface — minimal surface needed by the animation. */
-export interface ScrollController {
-    scrollTo: (position: number) => void;
-    getScrollTop: () => number;
-}
-/**
- * Create a smooth scroll animator with its own animation state.
- */
-export declare const createSmoothScroll: (scrollController: ScrollController, renderFn: () => void) => {
-    animateScroll: (from: number, to: number, duration: number) => void;
-    cancelScroll: () => void;
-};
-//# sourceMappingURL=scroll.d.ts.map