@vobs/ui 0.2.0 → 1.0.0

package/dist/virtual-list.d.ts

@@ -1,190 +0,0 @@
-/** @license MIT
- * Copyright (c) 2026 vobsjs
- * @vobs/ui
- */
-import { type UiAttributes, type UiDomPlan } from './primitives.js';
-export type VirtualListKey = number | string;
-export type VirtualListLayout = 'grid' | 'horizontal';
-export type VirtualListAnchorMode = 'append' | 'prepend' | 'preserve';
-export interface FixedVirtualListOptions<T> {
-    readonly items: readonly T[];
-    readonly itemHeight: number;
-    readonly viewportHeight: number;
-    readonly overscan?: number;
-    readonly scrollOffset?: number;
-    readonly ssrFallbackCount?: number;
-    readonly getKey?: (item: T, index: number) => VirtualListKey;
-}
-export interface FixedVirtualListDomOptions<T> extends FixedVirtualListOptions<T> {
-    readonly id?: string;
-    readonly ariaLabel?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface FixedVirtualListControllerOptions<T> extends Omit<FixedVirtualListDomOptions<T>, 'scrollOffset' | 'viewportHeight'> {
-    readonly getScrollElement: () => HTMLElement | null;
-    readonly initialOffset?: number;
-    readonly viewportHeight?: number;
-    readonly onChange?: (state: FixedVirtualListState<T>, sync: boolean) => void;
-}
-export interface DynamicVirtualListOptions<T> {
-    readonly items: readonly T[];
-    readonly estimatedItemHeight: number;
-    readonly viewportHeight: number;
-    readonly overscan?: number;
-    readonly scrollOffset?: number;
-    readonly ssrFallbackCount?: number;
-    readonly getKey?: (item: T, index: number) => VirtualListKey;
-    readonly getItemHeight?: (item: T, index: number) => number | undefined;
-}
-export interface DynamicVirtualListDomOptions<T> extends DynamicVirtualListOptions<T> {
-    readonly id?: string;
-    readonly ariaLabel?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface VirtualListLayoutOptions<T> {
-    readonly items: readonly T[];
-    readonly layout: VirtualListLayout;
-    readonly itemWidth: number;
-    readonly itemHeight: number;
-    readonly viewportWidth: number;
-    readonly viewportHeight: number;
-    readonly columnCount?: number;
-    readonly overscan?: number;
-    readonly scrollLeft?: number;
-    readonly scrollTop?: number;
-    readonly ssrFallbackCount?: number;
-    readonly getKey?: (item: T, index: number) => VirtualListKey;
-}
-export interface VirtualListLayoutDomOptions<T> extends VirtualListLayoutOptions<T> {
-    readonly id?: string;
-    readonly ariaLabel?: string;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export interface VirtualListResizeMeasurementContractOptions<T> extends Omit<DynamicVirtualListDomOptions<T>, 'getItemHeight'> {
-    readonly getMeasuredItemHeight?: (item: T, index: number) => number | undefined;
-    readonly measuringIds?: readonly VirtualListKey[];
-}
-export interface VirtualListAnchorStateContractOptions<T> {
-    readonly previousItems: readonly T[];
-    readonly nextItems: readonly T[];
-    readonly anchorKey: VirtualListKey;
-    readonly itemHeight: number;
-    readonly anchorOffset?: number;
-    readonly viewportHeight?: number;
-    readonly mode?: VirtualListAnchorMode;
-    readonly stickToEnd?: boolean;
-    readonly getKey?: (item: T, index: number) => VirtualListKey;
-}
-export interface FixedVirtualListItem<T> {
-    readonly key: VirtualListKey;
-    readonly index: number;
-    readonly item: T;
-    readonly start: number;
-    readonly size: number;
-    readonly end: number;
-    readonly plan: UiDomPlan<'div'>;
-}
-export interface DynamicVirtualListItem<T> {
-    readonly key: VirtualListKey;
-    readonly index: number;
-    readonly item: T;
-    readonly start: number;
-    readonly size: number;
-    readonly measured: boolean;
-    readonly end: number;
-    readonly plan: UiDomPlan<'div'>;
-}
-export interface VirtualListLayoutItem<T> {
-    readonly key: VirtualListKey;
-    readonly index: number;
-    readonly item: T;
-    readonly rowIndex: number;
-    readonly columnIndex: number;
-    readonly x: number;
-    readonly y: number;
-    readonly width: number;
-    readonly height: number;
-    readonly plan: UiDomPlan<'div'>;
-}
-export interface FixedVirtualListState<T> {
-    readonly totalSize: number;
-    readonly scrollOffset: number;
-    readonly visibleStartIndex: number;
-    readonly visibleEndIndex: number;
-    readonly items: readonly FixedVirtualListItem<T>[];
-}
-export interface DynamicVirtualListState<T> {
-    readonly totalSize: number;
-    readonly scrollOffset: number;
-    readonly visibleStartIndex: number;
-    readonly visibleEndIndex: number;
-    readonly measuredCount: number;
-    readonly items: readonly DynamicVirtualListItem<T>[];
-}
-export interface VirtualListLayoutState<T> {
-    readonly layout: VirtualListLayout;
-    readonly rowCount: number;
-    readonly columnCount: number;
-    readonly totalWidth: number;
-    readonly totalHeight: number;
-    readonly scrollLeft: number;
-    readonly scrollTop: number;
-    readonly visibleRowStart: number;
-    readonly visibleRowEnd: number;
-    readonly visibleColumnStart: number;
-    readonly visibleColumnEnd: number;
-    readonly visibleStartIndex: number;
-    readonly visibleEndIndex: number;
-    readonly items: readonly VirtualListLayoutItem<T>[];
-}
-export interface FixedVirtualListPlans<T> extends FixedVirtualListState<T> {
-    readonly root: UiDomPlan<'div'>;
-    readonly spacer: UiDomPlan<'div'>;
-}
-export interface DynamicVirtualListPlans<T> extends DynamicVirtualListState<T> {
-    readonly root: UiDomPlan<'div'>;
-    readonly spacer: UiDomPlan<'div'>;
-}
-export interface VirtualListLayoutPlans<T> extends VirtualListLayoutState<T> {
-    readonly root: UiDomPlan<'div'>;
-    readonly spacer: UiDomPlan<'div'>;
-}
-export interface VirtualListResizeMeasurementContract<T> {
-    readonly plans: DynamicVirtualListPlans<T>;
-    readonly attrs: UiAttributes;
-    readonly measuredKeys: readonly VirtualListKey[];
-    readonly measuringKeys: readonly VirtualListKey[];
-    readonly estimatedKeys: readonly VirtualListKey[];
-}
-export interface VirtualListAnchorStateContract {
-    readonly scrollOffset: number;
-    readonly previousAnchorIndex: number;
-    readonly nextAnchorIndex: number;
-    readonly insertedBeforeCount: number;
-    readonly attrs: UiAttributes;
-}
-export interface FixedVirtualListScrollState {
-    readonly scrollOffset: number;
-    readonly visibleStartIndex: number;
-    readonly visibleEndIndex: number;
-}
-export interface FixedVirtualListController<T> {
-    read(): FixedVirtualListPlans<T>;
-    update(options: Partial<Omit<FixedVirtualListControllerOptions<T>, 'getScrollElement'>>): void;
-    scrollToOffset(offset: number): void;
-    scrollToIndex(index: number): void;
-    takeScrollState(): FixedVirtualListScrollState;
-    destroy(): void;
-}
-export declare function createFixedVirtualListPlans<T>(options: FixedVirtualListDomOptions<T>): FixedVirtualListPlans<T>;
-export declare function createDynamicVirtualListPlans<T>(options: DynamicVirtualListDomOptions<T>): DynamicVirtualListPlans<T>;
-export declare function createVirtualListLayoutPlans<T>(options: VirtualListLayoutDomOptions<T>): VirtualListLayoutPlans<T>;
-export declare function calculateVirtualListLayoutState<T>(options: VirtualListLayoutOptions<T>): VirtualListLayoutState<T>;
-export declare function createVirtualListResizeMeasurementContract<T>(options: VirtualListResizeMeasurementContractOptions<T>): VirtualListResizeMeasurementContract<T>;
-export declare function createVirtualListAnchorStateContract<T>(options: VirtualListAnchorStateContractOptions<T>): VirtualListAnchorStateContract;
-export declare function calculateFixedVirtualListState<T>(options: FixedVirtualListOptions<T>): FixedVirtualListState<T>;
-export declare function calculateDynamicVirtualListState<T>(options: DynamicVirtualListOptions<T>): DynamicVirtualListState<T>;
-export declare function createFixedVirtualListController<T>(options: FixedVirtualListControllerOptions<T>): FixedVirtualListController<T>;