react-virtual-renderer 1.0.3

package/dist/performance/metrics.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Performance monitoring for Virtualize
+ * Tracks render time, scroll performance, memory usage, etc.
+ */
+export interface PerformanceMetrics {
+    renderTime: number;
+    itemsRendered: number;
+    itemsMeasured: number;
+    scrollFPS: number;
+    scrollDelta: number;
+    memoryUsed: number;
+    cacheSize: number;
+}
+export interface PerformanceWarnings {
+    slowRender?: boolean;
+    lowFPS?: boolean;
+    highMemory?: boolean;
+    largeCache?: boolean;
+}
+/**
+ * Performance metrics collector
+ */
+export declare class MetricsCollector {
+    private metrics;
+    private startTime;
+    private lastScrollTime;
+    private frameCount;
+    private lastFPSTime;
+    private isRecording;
+    start(): void;
+    stop(): void;
+    /**
+     * Record a render cycle
+     */
+    recordRender(itemsRendered: number, itemsMeasured: number, cacheSize: number): void;
+    /**
+     * Record scroll event
+     */
+    recordScroll(): void;
+    /**
+     * Calculate frames per second
+     */
+    private calculateFPS;
+    /**
+     * Get average metrics
+     */
+    getAverageMetrics(): Partial<PerformanceMetrics>;
+    /**
+     * Check for performance issues
+     */
+    checkWarnings(): PerformanceWarnings;
+    /**
+     * Get detailed report
+     */
+    getReport(): string;
+    /**
+     * Clear metrics
+     */
+    clear(): void;
+}
+export declare function usePerformanceMonitoring(enabled?: boolean): {
+    recordRender: (rendered: number, measured: number, cacheSize: number) => void;
+    recordScroll: () => void;
+    getMetrics: () => Partial<PerformanceMetrics>;
+    getWarnings: () => PerformanceWarnings;
+    getReport: () => string;
+};
+/**
+ * Browser DevTools integration
+ */
+export declare class VirtualizeDevTools {
+    static inject(): void;
+    static getMetrics(): any;
+    static generateReport(): any;
+}
+/**
+ * Performance profiler for detailed analysis
+ */
+export declare class PerformanceProfiler {
+    private marks;
+    private measures;
+    mark(label: string): void;
+    measure(label: string, startMark: string, endMark?: string): number;
+    getMeasures(): {
+        [k: string]: number;
+    };
+    generateFlameChart(width?: number): string;
+    clear(): void;
+}
+/**
+ * Memory leak detector
+ */
+export declare class MemoryLeakDetector {
+    private initialMemory;
+    private measurements;
+    start(): void;
+    measure(): void;
+    /**
+     * Detect if memory is continuously growing (potential leak)
+     */
+    detectLeak(sampleSize?: number, threshold?: number): boolean;
+    getReport(): {
+        initialMemory: string;
+        currentMemory: string;
+        trend: string;
+        potentialLeak: boolean;
+    };
+    clear(): void;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/performance/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/performance/metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,WAAW,CAAkB;IAErC,KAAK;IAML,IAAI;IAIJ;;OAEG;IACH,YAAY,CACR,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM;IAqBrB;;OAEG;IACH,YAAY;IAIZ;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,iBAAiB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAiBhD;;OAEG;IACH,aAAa,IAAI,mBAAmB;IAWpC;;OAEG;IACH,SAAS,IAAI,MAAM;IAyBnB;;OAEG;IACH,KAAK;CAGR;AAOD,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,OAAe;6BAYhC,MAAM,YAAY,MAAM,aAAa,MAAM;;;;;EAO3E;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC3B,MAAM,CAAC,MAAM;IAWb,MAAM,CAAC,UAAU;IAIjB,MAAM,CAAC,cAAc;CAGxB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,QAAQ,CAAkC;IAElD,IAAI,CAAC,KAAK,EAAE,MAAM;IAIlB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAa1D,WAAW;;;IAIX,kBAAkB,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM;IAe9C,KAAK;CAIR;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,YAAY,CAAgB;IAEpC,KAAK;IAML,OAAO;IAMP;;OAEG;IACH,UAAU,CAAC,UAAU,GAAE,MAAW,EAAE,SAAS,GAAE,MAAY,GAAG,OAAO;IAgBrE,SAAS;;;;;;IAiBT,KAAK;CAGR"}

package/dist/performance/metrics.js

@@ -0,0 +1,310 @@
+/**
+ * Performance monitoring for Virtualize
+ * Tracks render time, scroll performance, memory usage, etc.
+ */
+/**
+ * Performance metrics collector
+ */
+export class MetricsCollector {
+    constructor() {
+        Object.defineProperty(this, "metrics", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "startTime", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "lastScrollTime", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "frameCount", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "lastFPSTime", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "isRecording", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+    }
+    start() {
+        this.isRecording = true;
+        this.startTime = performance.now();
+        this.lastScrollTime = performance.now();
+    }
+    stop() {
+        this.isRecording = false;
+    }
+    /**
+     * Record a render cycle
+     */
+    recordRender(itemsRendered, itemsMeasured, cacheSize) {
+        if (!this.isRecording)
+            return;
+        const renderTime = performance.now() - this.startTime;
+        const memoryUsed = performance.memory?.usedJSHeapSize || 0;
+        const metric = {
+            renderTime,
+            itemsRendered,
+            itemsMeasured,
+            scrollFPS: this.calculateFPS(),
+            scrollDelta: performance.now() - this.lastScrollTime,
+            memoryUsed,
+            cacheSize,
+        };
+        this.metrics.push(metric);
+        this.startTime = performance.now();
+    }
+    /**
+     * Record scroll event
+     */
+    recordScroll() {
+        this.lastScrollTime = performance.now();
+    }
+    /**
+     * Calculate frames per second
+     */
+    calculateFPS() {
+        const now = performance.now();
+        this.frameCount++;
+        if (now - this.lastFPSTime >= 1000) {
+            const fps = this.frameCount;
+            this.frameCount = 0;
+            this.lastFPSTime = now;
+            return fps;
+        }
+        return 0;
+    }
+    /**
+     * Get average metrics
+     */
+    getAverageMetrics() {
+        if (this.metrics.length === 0)
+            return {};
+        const avg = (key) => this.metrics.reduce((sum, m) => sum + m[key], 0) / this.metrics.length;
+        return {
+            renderTime: avg('renderTime'),
+            itemsRendered: avg('itemsRendered'),
+            itemsMeasured: avg('itemsMeasured'),
+            scrollFPS: avg('scrollFPS'),
+            scrollDelta: avg('scrollDelta'),
+            memoryUsed: avg('memoryUsed'),
+            cacheSize: avg('cacheSize'),
+        };
+    }
+    /**
+     * Check for performance issues
+     */
+    checkWarnings() {
+        const avg = this.getAverageMetrics();
+        return {
+            slowRender: (avg.renderTime ?? 0) > 16.67,
+            lowFPS: (avg.scrollFPS ?? 60) < 50,
+            highMemory: (avg.memoryUsed ?? 0) > 50 * 1024 * 1024,
+            largeCache: (avg.cacheSize ?? 0) > 10000, // > 10k items cached
+        };
+    }
+    /**
+     * Get detailed report
+     */
+    getReport() {
+        const avg = this.getAverageMetrics();
+        const warnings = this.checkWarnings();
+        return `
+=== VIRTUALIZE PERFORMANCE REPORT ===
+
+📊 METRICS:
+  • Render Time: ${(avg.renderTime ?? 0).toFixed(2)}ms
+  • Items Rendered: ${Math.round(avg.itemsRendered ?? 0)}
+  • Items Measured: ${Math.round(avg.itemsMeasured ?? 0)}
+  • Scroll FPS: ${Math.round(avg.scrollFPS ?? 0)}
+  • Memory Used: ${((avg.memoryUsed ?? 0) / 1024 / 1024).toFixed(2)}MB
+  • Cache Size: ${Math.round(avg.cacheSize ?? 0)}
+
+⚠️  WARNINGS:
+  ${warnings.slowRender ? '• ⚠️ SLOW RENDER: Render time exceeds 16.67ms (1 frame @ 60fps)' : ''}
+  ${warnings.lowFPS ? '• ⚠️ LOW FPS: Scrolling performance below 50 FPS' : ''}
+  ${warnings.highMemory ? '• ⚠️ HIGH MEMORY: Using more than 50MB of memory' : ''}
+  ${warnings.largeCache ? '• ⚠️ LARGE CACHE: Cache size exceeds 10,000 items' : ''}
+
+✅ STATUS: ${Object.values(warnings).some((w) => w) ? 'NEEDS OPTIMIZATION' : 'HEALTHY'}
+    `.trim();
+    }
+    /**
+     * Clear metrics
+     */
+    clear() {
+        this.metrics = [];
+    }
+}
+/**
+ * React hook for performance monitoring
+ */
+import React from 'react';
+export function usePerformanceMonitoring(enabled = false) {
+    const collectorRef = React.useRef(new MetricsCollector());
+    React.useEffect(() => {
+        if (enabled) {
+            collectorRef.current.start();
+        }
+        else {
+            collectorRef.current.stop();
+        }
+    }, [enabled]);
+    return {
+        recordRender: (rendered, measured, cacheSize) => collectorRef.current.recordRender(rendered, measured, cacheSize),
+        recordScroll: () => collectorRef.current.recordScroll(),
+        getMetrics: () => collectorRef.current.getAverageMetrics(),
+        getWarnings: () => collectorRef.current.checkWarnings(),
+        getReport: () => collectorRef.current.getReport(),
+    };
+}
+/**
+ * Browser DevTools integration
+ */
+export class VirtualizeDevTools {
+    static inject() {
+        if (typeof window !== 'undefined') {
+            window.__VIRTUALIZE_DEVTOOLS__ = {
+                version: '1.0.0',
+                metrics: new MetricsCollector(),
+            };
+            console.log('🎯 Virtualize DevTools injected. Access via window.__VIRTUALIZE_DEVTOOLS__');
+        }
+    }
+    static getMetrics() {
+        return window.__VIRTUALIZE_DEVTOOLS__?.metrics.getAverageMetrics();
+    }
+    static generateReport() {
+        return window.__VIRTUALIZE_DEVTOOLS__?.metrics.getReport();
+    }
+}
+/**
+ * Performance profiler for detailed analysis
+ */
+export class PerformanceProfiler {
+    constructor() {
+        Object.defineProperty(this, "marks", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "measures", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    mark(label) {
+        this.marks.set(label, performance.now());
+    }
+    measure(label, startMark, endMark) {
+        const start = this.marks.get(startMark);
+        const end = endMark ? this.marks.get(endMark) : performance.now();
+        if (start !== undefined && end !== undefined) {
+            const duration = end - start;
+            this.measures.set(label, duration);
+            return duration;
+        }
+        return 0;
+    }
+    getMeasures() {
+        return Object.fromEntries(this.measures);
+    }
+    generateFlameChart(width = 80) {
+        let chart = '═'.repeat(width) + '\n';
+        const maxDuration = Math.max(...this.measures.values(), 1);
+        for (const [label, duration] of this.measures) {
+            const barLength = Math.round((duration / maxDuration) * (width - 20));
+            const bar = '█'.repeat(Math.max(barLength, 1));
+            chart += `${label.padEnd(15)} ${bar} ${duration.toFixed(2)}ms\n`;
+        }
+        chart += '═'.repeat(width);
+        return chart;
+    }
+    clear() {
+        this.marks.clear();
+        this.measures.clear();
+    }
+}
+/**
+ * Memory leak detector
+ */
+export class MemoryLeakDetector {
+    constructor() {
+        Object.defineProperty(this, "initialMemory", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "measurements", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+    }
+    start() {
+        if (performance.memory) {
+            this.initialMemory = performance.memory.usedJSHeapSize;
+        }
+    }
+    measure() {
+        if (performance.memory) {
+            this.measurements.push(performance.memory.usedJSHeapSize);
+        }
+    }
+    /**
+     * Detect if memory is continuously growing (potential leak)
+     */
+    detectLeak(sampleSize = 10, threshold = 0.8) {
+        if (this.measurements.length < sampleSize)
+            return false;
+        const recentMeasurements = this.measurements.slice(-sampleSize);
+        let increasingTrend = 0;
+        for (let i = 1; i < recentMeasurements.length; i++) {
+            if (recentMeasurements[i] > recentMeasurements[i - 1]) {
+                increasingTrend++;
+            }
+        }
+        const increasingRatio = increasingTrend / (sampleSize - 1);
+        return increasingRatio > threshold;
+    }
+    getReport() {
+        const initialMB = (this.initialMemory / 1024 / 1024).toFixed(2);
+        const currentMB = (this.measurements[this.measurements.length - 1] /
+            1024 /
+            1024).toFixed(2);
+        const hasLeak = this.detectLeak();
+        return {
+            initialMemory: `${initialMB}MB`,
+            currentMemory: `${currentMB}MB`,
+            trend: hasLeak ? '📈 INCREASING' : '📉 STABLE',
+            potentialLeak: hasLeak,
+        };
+    }
+    clear() {
+        this.measurements = [];
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/performance/metrics.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,182 @@
+export interface VirtualizePlugin {
+    name: string;
+    version: string;
+    hooks?: {
+        beforeRender?: (items: any[]) => any[];
+        afterRender?: (elements: HTMLElement[]) => void;
+        onScroll?: (offset: number) => void;
+        onMeasurement?: (index: number, size: number) => void;
+    };
+    methods?: Record<string, (...args: any[]) => any>;
+}
+export declare class PluginManager {
+    private plugins;
+    /**
+     * Register a plugin
+     */
+    register(plugin: VirtualizePlugin): void;
+    /**
+     * Unregister a plugin
+     */
+    unregister(name: string): void;
+    /**
+     * Get registered plugins
+     */
+    getPlugins(): VirtualizePlugin[];
+    /**
+     * Call plugin hook
+     */
+    callHook(hookName: keyof NonNullable<VirtualizePlugin['hooks']>, ...args: any[]): Promise<any[]>;
+    /**
+     * Call plugin method
+     */
+    callMethod(pluginName: string, methodName: string, ...args: any[]): any;
+}
+export declare enum LayoutType {
+    LIST = "list",
+    GRID = "grid",
+    MASONRY = "masonry",
+    WATERFALL = "waterfall",
+    FEED = "feed",
+    TIMELINE = "timeline"
+}
+export interface LayoutConfig {
+    type: LayoutType;
+    columnCount?: number;
+    gapSize?: number;
+    itemAspectRatio?: number;
+    maxWidth?: number;
+    minItemSize?: number;
+}
+/**
+ * Waterfall Layout - Multi-column layout with items filling shortest column
+ * Perfect for: Image galleries, product showcases
+ */
+export declare class WaterfallLayout {
+    private columns;
+    private gapSize;
+    private columnHeights;
+    constructor(columns: number, gapSize?: number);
+    /**
+     * Get position for item
+     */
+    getItemPosition(_: number, itemHeight: number, width: number): {
+        x: number;
+        y: number;
+        column: number;
+    };
+    /**
+     * Get total height needed
+     */
+    getTotalHeight(): number;
+    /**
+     * Reset layout
+     */
+    reset(): void;
+}
+/**
+ * Feed Layout - Social media feed style (variable width, full-width items)
+ * Perfect for: Social feeds, blogs, news
+ */
+export declare class FeedLayout {
+    private itemHeights;
+    private itemOffsets;
+    private totalHeight;
+    /**
+     * Record item height
+     */
+    recordItemHeight(index: number, height: number): void;
+    /**
+     * Get item offset and height
+     */
+    getItemDimensions(index: number): {
+        offset: number;
+        height: number;
+    };
+    /**
+     * Update all offsets
+     */
+    private updateOffsets;
+    /**
+     * Get total height
+     */
+    getTotalHeight(): number;
+}
+/**
+ * Vue 3 Adapter
+ */
+export declare const createVueVirtualList: () => {
+    name: string;
+    template: string;
+    props: {
+        items: ArrayConstructor;
+        height: {
+            type: NumberConstructor;
+            default: number;
+        };
+        width: {
+            type: NumberConstructor;
+            default: number;
+        };
+        estimatedItemSize: {
+            type: NumberConstructor;
+            default: number;
+        };
+    };
+};
+/**
+ * Svelte Component
+ */
+export declare const SvelteVirtualList = "\n<script>\n    import { useVirtualList } from 'virtualize';\n\n    export let items = [];\n    export let height = 400;\n    export let width = 300;\n    export let estimatedItemSize = 50;\n\n    let containerRef;\n    const { virtualItems, getItemStyle } = useVirtualList({\n        items,\n        containerHeight: height,\n        estimatedItemSize,\n    });\n</script>\n\n<div\n    bind:this={containerRef}\n    class=\"virtualize-container\"\n    style=\"height: {height}px; width: {width}px; overflow: auto;\"\n>\n    {#each $virtualItems as virtualItem (virtualItem.key)}\n        <div style={getItemStyle(virtualItem.index, virtualItem.size)}>\n            <slot item={virtualItem.data} index={virtualItem.index} />\n        </div>\n    {/each}\n</div>\n\n<style>\n    .virtualize-container {\n        position: relative;\n        border: 1px solid #ccc;\n    }\n</style>\n";
+export interface AnalyticsEvent {
+    type: string;
+    timestamp: number;
+    data: any;
+}
+export declare class AdvancedAnalytics {
+    private events;
+    private sessionStart;
+    private maxEvents;
+    /**
+     * Track event
+     */
+    trackEvent(type: string, data: any): void;
+    /**
+     * Get session duration
+     */
+    getSessionDuration(): number;
+    /**
+     * Get analytics report
+     */
+    getReport(): {
+        sessionDuration: number;
+        totalEvents: number;
+        eventBreakdown: Record<string, number>;
+        timeline: AnalyticsEvent[];
+    };
+    /**
+     * Get event breakdown
+     */
+    private getEventBreakdown;
+    /**
+     * Send analytics to server
+     */
+    sendAnalytics(endpoint: string): Promise<void>;
+    /**
+     * Export analytics as CSV
+     */
+    exportAsCSV(): string;
+}
+/**
+ * Example: Analytics Plugin
+ */
+export declare const AnalyticsPlugin: VirtualizePlugin;
+/**
+ * Example: Logger Plugin
+ */
+export declare const LoggerPlugin: VirtualizePlugin;
+/**
+ * Example: Custom Plugin
+ */
+export declare function createCustomPlugin(options: any): VirtualizePlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

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