tuiuiu.js 0.1.1

package/dist/core/virtual-scroll.d.ts

@@ -0,0 +1,241 @@
+/**
+ * Virtual Scrolling System
+ *
+ * Features:
+ * - Efficient rendering of large lists (only visible items rendered)
+ * - Variable item heights with measurement caching
+ * - Smooth scrolling with animation
+ * - Overscan for smoother experience
+ * - Keyboard navigation
+ * - Infinite scroll pattern
+ *
+ *
+ */
+/** Virtual scroll item */
+export interface VirtualItem<T = unknown> {
+    /** Item index in the data array */
+    index: number;
+    /** Computed start position (in rows) */
+    start: number;
+    /** Computed end position (in rows) */
+    end: number;
+    /** Item height (in rows) */
+    height: number;
+    /** The actual data item */
+    data: T;
+}
+/** Height measurement function */
+export type MeasureHeight<T> = (item: T, index: number) => number;
+/** Virtual scroll options */
+export interface VirtualScrollOptions<T> {
+    /** Total number of items */
+    itemCount: number;
+    /** Get item by index */
+    getItem: (index: number) => T;
+    /** Measure item height (default: 1) */
+    measureHeight?: MeasureHeight<T>;
+    /** Number of extra items to render above/below visible area */
+    overscan?: number;
+    /** Container height in rows */
+    containerHeight: number;
+    /** Enable smooth scrolling animation */
+    smoothScroll?: boolean;
+    /** Scroll animation duration (ms) */
+    scrollDuration?: number;
+    /** Initial scroll offset */
+    initialOffset?: number;
+    /** Callback when scroll position changes */
+    onScroll?: (offset: number) => void;
+    /** Callback when reaching end (for infinite scroll) */
+    onEndReached?: () => void;
+    /** Threshold from end to trigger onEndReached (items) */
+    endReachedThreshold?: number;
+    /** Estimated item height for initial layout */
+    estimatedItemHeight?: number;
+}
+/** Virtual scroll state */
+export interface VirtualScrollState {
+    /** Current scroll offset (in rows) */
+    offset: number;
+    /** Target offset for smooth scrolling */
+    targetOffset: number;
+    /** Whether currently scrolling */
+    isScrolling: boolean;
+    /** Measured heights cache (index -> height) */
+    heightCache: Map<number, number>;
+    /** Computed positions cache (index -> start position) */
+    positionCache: Map<number, number>;
+    /** Total content height */
+    totalHeight: number;
+    /** Whether height calculation is dirty */
+    dirty: boolean;
+}
+/** Virtual scroll result */
+export interface VirtualScrollResult<T> {
+    /** Items to render */
+    items: VirtualItem<T>[];
+    /** Total content height */
+    totalHeight: number;
+    /** Current scroll offset */
+    offset: number;
+    /** Container height */
+    containerHeight: number;
+    /** Whether can scroll up */
+    canScrollUp: boolean;
+    /** Whether can scroll down */
+    canScrollDown: boolean;
+    /** First visible item index */
+    startIndex: number;
+    /** Last visible item index */
+    endIndex: number;
+    /** Scroll position as percentage (0-1) */
+    scrollProgress: number;
+}
+/**
+ * Create a virtual scroll manager
+ */
+export declare function createVirtualScroll<T>(options: VirtualScrollOptions<T>): VirtualScrollManager<T>;
+/**
+ * Virtual scroll manager class
+ */
+export declare class VirtualScrollManager<T> {
+    private options;
+    private state;
+    private animationFrame;
+    constructor(options: VirtualScrollOptions<T>);
+    /**
+     * Recalculate total height and positions
+     */
+    recalculateLayout(): void;
+    /**
+     * Get height for item at index
+     */
+    getItemHeight(index: number): number;
+    /**
+     * Get position for item at index
+     */
+    getItemPosition(index: number): number;
+    /**
+     * Update item height (call when item content changes)
+     */
+    updateItemHeight(index: number, height: number): void;
+    /**
+     * Invalidate height cache
+     */
+    invalidateHeights(): void;
+    /**
+     * Scroll to offset
+     */
+    scrollTo(offset: number, animate?: boolean): void;
+    /**
+     * Scroll by delta
+     */
+    scrollBy(delta: number, animate?: boolean): void;
+    /**
+     * Scroll to item by index
+     */
+    scrollToItem(index: number, align?: 'start' | 'center' | 'end' | 'auto'): void;
+    /**
+     * Scroll to top
+     */
+    scrollToTop(animate?: boolean): void;
+    /**
+     * Scroll to bottom
+     */
+    scrollToBottom(animate?: boolean): void;
+    private animateScroll;
+    private checkEndReached;
+    /**
+     * Get visible items for rendering
+     */
+    getVisibleItems(): VirtualScrollResult<T>;
+    /**
+     * Find item index at given offset using binary search
+     */
+    private findIndexAtOffset;
+    /**
+     * Get current offset
+     */
+    getOffset(): number;
+    /**
+     * Get total height
+     */
+    getTotalHeight(): number;
+    /**
+     * Check if currently scrolling
+     */
+    isScrolling(): boolean;
+    /**
+     * Get index of item at given row position
+     */
+    getItemAtPosition(position: number): number;
+    /**
+     * Update item count
+     */
+    setItemCount(count: number): void;
+    /**
+     * Update container height
+     */
+    setContainerHeight(height: number): void;
+    /**
+     * Update options
+     */
+    updateOptions(options: Partial<VirtualScrollOptions<T>>): void;
+    /**
+     * Cleanup
+     */
+    destroy(): void;
+}
+/**
+ * Create a fixed-height virtual scroll (all items same height)
+ */
+export declare function createFixedHeightVirtualScroll<T>(options: Omit<VirtualScrollOptions<T>, 'measureHeight'> & {
+    itemHeight: number;
+}): VirtualScrollManager<T>;
+/**
+ * Create a variable-height virtual scroll with height estimator
+ */
+export declare function createVariableHeightVirtualScroll<T>(options: VirtualScrollOptions<T> & {
+    /** Estimate height before measurement */
+    estimateHeight?: MeasureHeight<T>;
+}): VirtualScrollManager<T>;
+/** Scroll direction */
+export type ScrollDirection = 'up' | 'down' | 'none';
+/**
+ * Determine scroll direction from delta
+ */
+export declare function getScrollDirection(delta: number): ScrollDirection;
+/**
+ * Calculate visible range percentage
+ */
+export declare function getVisibleRangePercent(offset: number, containerHeight: number, totalHeight: number): {
+    start: number;
+    end: number;
+};
+/**
+ * Create scroll indicators (for scrollbar rendering)
+ */
+export declare function createScrollIndicator(containerHeight: number, totalHeight: number, offset: number, minThumbSize?: number): {
+    position: number;
+    size: number;
+};
+/** Infinite scroll state */
+export interface InfiniteScrollState<T> {
+    items: T[];
+    isLoading: boolean;
+    hasMore: boolean;
+    error: Error | null;
+}
+/**
+ * Create infinite scroll manager
+ */
+export declare function createInfiniteScroll<T>(loadMore: (offset: number, limit: number) => Promise<{
+    items: T[];
+    hasMore: boolean;
+}>): {
+    state: InfiniteScrollState<T>;
+    loadNextPage: () => Promise<void>;
+    reset: () => void;
+    setItems: (items: T[]) => void;
+};
+//# sourceMappingURL=virtual-scroll.d.ts.map

package/dist/core/virtual-scroll.d.ts.map

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