lazy-render-virtual-scroll 1.12.0 → 1.13.0

package/dist/index.d.ts

@@ -1064,6 +1064,294 @@ declare class IntelligentPagination {
     getCurrentPage(): number;
 }
 
+/**
+ * Performance Analytics Engine
+ * Tracks render time, memory usage, and network performance
+ */
+interface PerformanceMetrics {
+    renderTime: {
+        average: number;
+        min: number;
+        max: number;
+        count: number;
+    };
+    memoryUsage: {
+        current: number;
+        peak: number;
+        trend: 'increasing' | 'stable' | 'decreasing';
+    };
+    networkPerformance: {
+        averageLatency: number;
+        averageSpeed: number;
+        failedRequests: number;
+    };
+    scrollPerformance: {
+        averageFPS: number;
+        droppedFrames: number;
+        jankCount: number;
+    };
+}
+declare class PerformanceAnalytics {
+    private renderTimeHistory;
+    private memoryHistory;
+    private networkLatencyHistory;
+    private frameTimestamps;
+    private droppedFrames;
+    private jankCount;
+    private readonly MAX_HISTORY;
+    private readonly JANK_THRESHOLD;
+    /**
+     * Track render time for an item
+     */
+    trackRenderTime(renderTime: number): void;
+    /**
+     * Track memory usage
+     */
+    trackMemoryUsage(memoryMB: number): void;
+    /**
+     * Track network request latency
+     */
+    trackNetworkLatency(latency: number): void;
+    /**
+     * Track frame timing for FPS calculation
+     */
+    trackFrame(): void;
+    /**
+     * Get current FPS
+     */
+    getCurrentFPS(): number;
+    /**
+     * Get comprehensive performance metrics
+     */
+    getMetrics(): PerformanceMetrics;
+    /**
+     * Get average from array
+     */
+    private getAverage;
+    /**
+     * Get trend from array
+     */
+    private getTrend;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Get performance score (0-100)
+     */
+    getPerformanceScore(): number;
+    /**
+     * Get optimization recommendations
+     */
+    getRecommendations(): string[];
+}
+
+/**
+ * Performance Dashboard
+ * Real-time performance monitoring and bottleneck identification
+ */
+
+interface DashboardData {
+    overallScore: number;
+    fps: number;
+    renderTime: number;
+    memoryUsage: number;
+    networkLatency: number;
+    recommendations: string[];
+    bottlenecks: string[];
+}
+declare class PerformanceDashboard {
+    private analytics;
+    private updateInterval;
+    private listeners;
+    private intervalId;
+    private isMonitoring;
+    constructor(analytics: PerformanceAnalytics);
+    /**
+     * Start real-time monitoring
+     */
+    startMonitoring(): void;
+    /**
+     * Stop monitoring
+     */
+    stopMonitoring(): void;
+    /**
+     * Get current dashboard data
+     */
+    getDashboardData(): DashboardData;
+    /**
+     * Identify performance bottlenecks
+     */
+    private identifyBottlenecks;
+    /**
+     * Add listener for dashboard updates
+     */
+    addListener(callback: (data: DashboardData) => void): void;
+    /**
+     * Remove listener
+     */
+    removeListener(callback: (data: DashboardData) => void): void;
+    /**
+     * Notify all listeners
+     */
+    private notifyListeners;
+    /**
+     * Export metrics as JSON
+     */
+    exportMetrics(): string;
+    /**
+     * Get performance report
+     */
+    getPerformanceReport(): string;
+}
+
+/**
+ * Accessibility Manager
+ * Handles keyboard navigation, screen reader compatibility, and ARIA attributes
+ */
+interface AccessibilityConfig {
+    enableKeyboardNav: boolean;
+    enableScreenReader: boolean;
+    enableARIA: boolean;
+}
+declare class AccessibilityManager {
+    private config;
+    private focusedIndex;
+    private containerElement;
+    private itemElements;
+    constructor(config?: Partial<AccessibilityConfig>);
+    /**
+     * Initialize accessibility features
+     */
+    initialize(container: HTMLElement): void;
+    /**
+     * Setup ARIA attributes
+     */
+    private setupARIA;
+    /**
+     * Setup keyboard navigation
+     */
+    private setupKeyboardNav;
+    /**
+     * Handle keyboard events
+     */
+    private handleKeyDown;
+    /**
+     * Focus next item
+     */
+    private focusNext;
+    /**
+     * Focus previous item
+     */
+    private focusPrevious;
+    /**
+     * Focus first item
+     */
+    private focusFirst;
+    /**
+     * Focus last item
+     */
+    private focusLast;
+    /**
+     * Focus page down (10 items)
+     */
+    private focusPageDown;
+    /**
+     * Focus page up (10 items)
+     */
+    private focusPageUp;
+    /**
+     * Focus specific item
+     */
+    private focusItem;
+    /**
+     * Setup screen reader support
+     */
+    private setupScreenReader;
+    /**
+     * Announce message to screen readers
+     */
+    private announce;
+    /**
+     * Update item elements
+     */
+    updateItems(elements: HTMLElement[]): void;
+    /**
+     * Set focused index from outside
+     */
+    setFocusedIndex(index: number): void;
+    /**
+     * Get current focused index
+     */
+    getFocusedIndex(): number;
+    /**
+     * Cleanup accessibility features
+     */
+    cleanup(): void;
+}
+
+/**
+ * Animation Manager
+ * Handles smooth transitions, staggered animations, and performance-optimized animations
+ */
+interface AnimationConfig {
+    enableTransitions: boolean;
+    enableStagger: boolean;
+    staggerDelay: number;
+    transitionDuration: number;
+    easingFunction: string;
+}
+declare class AnimationManager {
+    private config;
+    private activeAnimations;
+    private prefersReducedMotion;
+    constructor(config?: Partial<AnimationConfig>);
+    /**
+     * Animate item entrance
+     */
+    animateEntrance(element: HTMLElement, index: number): Promise<void>;
+    /**
+     * Animate item exit
+     */
+    animateExit(element: HTMLElement): Promise<void>;
+    /**
+     * Animate scroll indicator
+     */
+    animateScrollIndicator(element: HTMLElement, direction: 'up' | 'down'): void;
+    /**
+     * Smooth scroll to position
+     */
+    smoothScroll(container: HTMLElement, targetPosition: number, duration?: number): Promise<void>;
+    /**
+     * Animate loading skeleton
+     */
+    animateSkeleton(element: HTMLElement): void;
+    /**
+     * Stop skeleton animation
+     */
+    stopSkeletonAnimation(element: HTMLElement): void;
+    /**
+     * Animate item highlight
+     */
+    animateHighlight(element: HTMLElement, color?: string, duration?: number): Promise<void>;
+    /**
+     * Batch animate multiple elements
+     */
+    batchAnimate(elements: HTMLElement[], animation: 'entrance' | 'exit'): Promise<void>;
+    /**
+     * Cancel active animations
+     */
+    cancelAnimations(): void;
+    /**
+     * Check if reduced motion is preferred
+     */
+    hasReducedMotion(): boolean;
+    /**
+     * Update animation config
+     */
+    updateConfig(config: Partial<AnimationConfig>): void;
+}
+
 declare class ScrollObserver {
     private container;
     private callback;
@@ -1267,5 +1555,5 @@ declare class LazyScrollElementClass {
 }
 declare const LazyScrollElement: typeof LazyScrollElementClass;
 
-export { AdaptiveBufferCalculator, BatchSizeOptimizer, ContentComplexityAnalyzer, DevicePerformanceMonitor, DynamicHeightEngine, Engine, GPUAccelerator, HeightMeasurementCache, IntelligentPagination, IntelligentScrollDetector, LazyList, LazyScroll, LazyScrollElement, MemoryManager, NetworkAwarePrefetchManager, NetworkAwareRequestQueue, NetworkSpeedDetector, PerformanceOptimizer, PreemptiveCache, PrefetchManager, Priority, PriorityRequestQueue, RequestDeduplicator, RequestQueue, ScrollObserver, SmartPrefetchAlgorithm, VariableHeightManager, WindowManager, createLazyScroll, debounce, throttle, useLazyList };
+export { AccessibilityManager, AdaptiveBufferCalculator, AnimationManager, BatchSizeOptimizer, ContentComplexityAnalyzer, DevicePerformanceMonitor, DynamicHeightEngine, Engine, GPUAccelerator, HeightMeasurementCache, IntelligentPagination, IntelligentScrollDetector, LazyList, LazyScroll, LazyScrollElement, MemoryManager, NetworkAwarePrefetchManager, NetworkAwareRequestQueue, NetworkSpeedDetector, PerformanceAnalytics, PerformanceDashboard, PerformanceOptimizer, PreemptiveCache, PrefetchManager, Priority, PriorityRequestQueue, RequestDeduplicator, RequestQueue, ScrollObserver, SmartPrefetchAlgorithm, VariableHeightManager, WindowManager, createLazyScroll, debounce, throttle, useLazyList };
 export type { EngineConfig, EngineState, FetchMoreCallback, ScrollAnalysis, VisibleRange };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lazy-render-virtual-scroll",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "A framework-agnostic virtual scrolling and lazy rendering solution",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",