react-virtual-renderer 1.0.3

package/dist/plugin.js

@@ -0,0 +1,409 @@
+export class PluginManager {
+    constructor() {
+        Object.defineProperty(this, "plugins", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    /**
+     * Register a plugin
+     */
+    register(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            console.warn(`Plugin "${plugin.name}" already registered`);
+            return;
+        }
+        this.plugins.set(plugin.name, plugin);
+        console.log(`✅ Plugin registered: ${plugin.name} v${plugin.version}`);
+    }
+    /**
+     * Unregister a plugin
+     */
+    unregister(name) {
+        this.plugins.delete(name);
+    }
+    /**
+     * Get registered plugins
+     */
+    getPlugins() {
+        return Array.from(this.plugins.values());
+    }
+    /**
+     * Call plugin hook
+     */
+    async callHook(hookName, ...args) {
+        const results = [];
+        for (const plugin of this.plugins.values()) {
+            const hook = plugin.hooks?.[hookName];
+            if (typeof hook === 'function') {
+                try {
+                    const result = await hook(...args);
+                    results.push(result);
+                }
+                catch (error) {
+                    console.error(`Error in plugin ${plugin.name}:`, error);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Call plugin method
+     */
+    callMethod(pluginName, methodName, ...args) {
+        const plugin = this.plugins.get(pluginName);
+        if (!plugin || !plugin.methods || !plugin.methods[methodName]) {
+            throw new Error(`Method ${methodName} not found in plugin ${pluginName}`);
+        }
+        return plugin.methods[methodName](...args);
+    }
+}
+// ============================================
+// LAYOUT SYSTEM
+// ============================================
+export var LayoutType;
+(function (LayoutType) {
+    LayoutType["LIST"] = "list";
+    LayoutType["GRID"] = "grid";
+    LayoutType["MASONRY"] = "masonry";
+    LayoutType["WATERFALL"] = "waterfall";
+    LayoutType["FEED"] = "feed";
+    LayoutType["TIMELINE"] = "timeline";
+})(LayoutType || (LayoutType = {}));
+/**
+ * Waterfall Layout - Multi-column layout with items filling shortest column
+ * Perfect for: Image galleries, product showcases
+ */
+export class WaterfallLayout {
+    constructor(columns, gapSize = 8) {
+        Object.defineProperty(this, "columns", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "gapSize", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "columnHeights", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        this.columns = columns;
+        this.gapSize = gapSize;
+        this.columnHeights = new Array(columns).fill(0);
+    }
+    /**
+     * Get position for item
+     */
+    getItemPosition(_, itemHeight, width) {
+        const shortestColumn = this.columnHeights.indexOf(Math.min(...this.columnHeights));
+        const columnWidth = width / this.columns;
+        const x = shortestColumn * columnWidth;
+        const y = this.columnHeights[shortestColumn];
+        this.columnHeights[shortestColumn] += itemHeight + this.gapSize;
+        return { x, y, column: shortestColumn };
+    }
+    /**
+     * Get total height needed
+     */
+    getTotalHeight() {
+        return Math.max(...this.columnHeights);
+    }
+    /**
+     * Reset layout
+     */
+    reset() {
+        this.columnHeights.fill(0);
+    }
+}
+/**
+ * Feed Layout - Social media feed style (variable width, full-width items)
+ * Perfect for: Social feeds, blogs, news
+ */
+export class FeedLayout {
+    constructor() {
+        Object.defineProperty(this, "itemHeights", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "itemOffsets", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "totalHeight", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+    }
+    /**
+     * Record item height
+     */
+    recordItemHeight(index, height) {
+        this.itemHeights.set(index, height);
+        this.updateOffsets();
+    }
+    /**
+     * Get item offset and height
+     */
+    getItemDimensions(index) {
+        return {
+            offset: this.itemOffsets.get(index) || 0,
+            height: this.itemHeights.get(index) || 0,
+        };
+    }
+    /**
+     * Update all offsets
+     */
+    updateOffsets() {
+        let currentOffset = 0;
+        const sortedIndices = Array.from(this.itemHeights.keys()).sort((a, b) => a - b);
+        for (const index of sortedIndices) {
+            this.itemOffsets.set(index, currentOffset);
+            currentOffset += (this.itemHeights.get(index) || 0);
+        }
+        this.totalHeight = currentOffset;
+    }
+    /**
+     * Get total height
+     */
+    getTotalHeight() {
+        return this.totalHeight;
+    }
+}
+// ============================================
+// FRAMEWORK ADAPTERS
+// ============================================
+/**
+ * Vue 3 Adapter
+ */
+export const createVueVirtualList = () => {
+    return {
+        name: 'VirtualList',
+        template: `
+            <div
+                class="virtualize-container"
+                :style="{ height: height + 'px', width: width + 'px' }"
+                @scroll="handleScroll"
+                ref="container"
+            >
+                <div
+                    v-for="item in virtualItems"
+                    :key="item.key"
+                    :style="getItemStyle(item)"
+                >
+                    <slot :item="item.data" :index="item.index" />
+                </div>
+            </div>
+        `,
+        props: {
+            items: Array,
+            height: { type: Number, default: 400 },
+            width: { type: Number, default: 300 },
+            estimatedItemSize: { type: Number, default: 50 },
+        },
+    };
+};
+/**
+ * Svelte Component
+ */
+export const SvelteVirtualList = `
+<script>
+    import { useVirtualList } from 'virtualize';
+
+    export let items = [];
+    export let height = 400;
+    export let width = 300;
+    export let estimatedItemSize = 50;
+
+    let containerRef;
+    const { virtualItems, getItemStyle } = useVirtualList({
+        items,
+        containerHeight: height,
+        estimatedItemSize,
+    });
+</script>
+
+<div
+    bind:this={containerRef}
+    class="virtualize-container"
+    style="height: {height}px; width: {width}px; overflow: auto;"
+>
+    {#each $virtualItems as virtualItem (virtualItem.key)}
+        <div style={getItemStyle(virtualItem.index, virtualItem.size)}>
+            <slot item={virtualItem.data} index={virtualItem.index} />
+        </div>
+    {/each}
+</div>
+
+<style>
+    .virtualize-container {
+        position: relative;
+        border: 1px solid #ccc;
+    }
+</style>
+`;
+export class AdvancedAnalytics {
+    constructor() {
+        Object.defineProperty(this, "events", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "sessionStart", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: Date.now()
+        });
+        Object.defineProperty(this, "maxEvents", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 10000
+        });
+    }
+    /**
+     * Track event
+     */
+    trackEvent(type, data) {
+        if (this.events.length >= this.maxEvents) {
+            this.events.shift(); // Remove oldest
+        }
+        this.events.push({
+            type,
+            timestamp: Date.now(),
+            data,
+        });
+    }
+    /**
+     * Get session duration
+     */
+    getSessionDuration() {
+        return Date.now() - this.sessionStart;
+    }
+    /**
+     * Get analytics report
+     */
+    getReport() {
+        return {
+            sessionDuration: this.getSessionDuration(),
+            totalEvents: this.events.length,
+            eventBreakdown: this.getEventBreakdown(),
+            timeline: this.events,
+        };
+    }
+    /**
+     * Get event breakdown
+     */
+    getEventBreakdown() {
+        const breakdown = {};
+        for (const event of this.events) {
+            breakdown[event.type] = (breakdown[event.type] || 0) + 1;
+        }
+        return breakdown;
+    }
+    /**
+     * Send analytics to server
+     */
+    async sendAnalytics(endpoint) {
+        try {
+            const response = await fetch(endpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(this.getReport()),
+            });
+            if (!response.ok) {
+                console.error('Failed to send analytics');
+            }
+        }
+        catch (error) {
+            console.error('Error sending analytics:', error);
+        }
+    }
+    /**
+     * Export analytics as CSV
+     */
+    exportAsCSV() {
+        const headers = ['Type', 'Timestamp', 'Data'];
+        const rows = this.events.map((e) => [
+            e.type,
+            new Date(e.timestamp).toISOString(),
+            JSON.stringify(e.data),
+        ]);
+        const csv = [headers, ...rows]
+            .map((row) => row.map((cell) => `"${cell}"`).join(','))
+            .join('\n');
+        return csv;
+    }
+}
+// ============================================
+// EXAMPLE PLUGINS
+// ============================================
+/**
+ * Example: Analytics Plugin
+ */
+export const AnalyticsPlugin = {
+    name: 'analytics',
+    version: '2.0.0',
+    hooks: {
+        onScroll: (offset) => {
+            console.log(`📊 Scroll offset: ${offset}`);
+        },
+        onMeasurement: (index, size) => {
+            console.log(`📊 Item ${index} measured: ${size}px`);
+        },
+    },
+};
+/**
+ * Example: Logger Plugin
+ */
+export const LoggerPlugin = {
+    name: 'logger',
+    version: '2.0.0',
+    hooks: {
+        beforeRender: (items) => {
+            console.log(`📝 About to render ${items.length} items`);
+            return items;
+        },
+        afterRender: (elements) => {
+            console.log(`✅ Rendered ${elements.length} elements`);
+        },
+    },
+};
+/**
+ * Example: Custom Plugin
+ */
+export function createCustomPlugin(options) {
+    return {
+        name: options.name || 'custom-plugin',
+        version: options.version || '1.0.0',
+        hooks: {
+            onScroll: (offset) => {
+                console.log(`Custom: Scroll detected at ${offset}`);
+                options.onScroll?.(offset);
+            },
+        },
+        methods: {
+            customMethod: (arg) => {
+                console.log('Custom method called:', arg);
+                return arg;
+            },
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,84 @@
+/// <reference types="react" />
+export type ScrollDirection = 'forward' | 'reverse' | 'auto';
+export type LayoutMode = 'vertical' | 'horizontal' | 'grid' | 'masonry';
+export interface ItemSize {
+    index: number;
+    size: number;
+    offset: number;
+}
+export interface VirtualItem {
+    index: number;
+    offset: number;
+    size: number;
+    isSticky?: boolean;
+}
+export interface ScrollState {
+    scrollOffset: number;
+    scrollUpdateWasRequested: boolean;
+    isScrolling: boolean;
+    scrollDirection: ScrollDirection;
+}
+export interface MeasurementCache {
+    [key: number]: number;
+}
+export interface VirtualListProps<T> {
+    items: T[];
+    renderItem: (props: RenderItemProps<T>) => React.ReactNode;
+    itemKey?: (index: number, item: T) => string | number;
+    height?: number;
+    width?: number;
+    itemSize?: number | ((index: number) => number);
+    overscan?: number;
+    scrollDirection?: ScrollDirection;
+    onScroll?: (offset: number, direction: ScrollDirection) => void;
+    className?: string;
+    style?: React.CSSProperties;
+    estimatedItemSize?: number;
+    getItemSize?: (index: number) => number;
+    stickyIndices?: number[];
+    onScrollEnd?: () => void;
+    scrollMargin?: number;
+    innerRef?: React.Ref<HTMLDivElement>;
+    scrollOffsetRef?: React.MutableRefObject<number>;
+}
+export interface VirtualGridProps<T> {
+    items: T[];
+    renderItem: (props: RenderItemProps<T>) => React.ReactNode;
+    itemKey?: (index: number, item: T) => string | number;
+    height: number;
+    width: number;
+    columnCount: number | 'auto';
+    rowHeight?: number | ((index: number) => number);
+    columnWidth?: number | ((index: number) => number);
+    layout?: 'grid' | 'masonry';
+    overscan?: number;
+    gap?: number;
+    onScroll?: (offset: number) => void;
+    className?: string;
+    style?: React.CSSProperties;
+    estimatedItemHeight?: number;
+}
+export interface RenderItemProps<T> {
+    item: T;
+    index: number;
+    style: React.CSSProperties;
+    isScrolling: boolean;
+    isMeasuring?: boolean;
+}
+export interface UseVirtualListOptions<T> {
+    items: T[];
+    itemSize?: number | ((index: number) => number);
+    containerHeight: number;
+    containerWidth?: number;
+    overscan?: number;
+    scrollDirection?: ScrollDirection;
+    estimatedItemSize?: number;
+    onScroll?: (offset: number) => void;
+}
+export interface VirtualRange {
+    startIndex: number;
+    endIndex: number;
+    overscanStartIndex: number;
+    overscanEndIndex: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Binary search to find the item at a given scroll offset
+ */
+export declare function binarySearch(offsets: number[], target: number, low?: number, high?: number): number;
+/**
+ * Calculate range with overscan
+ */
+export declare function getOverscanRange(startIndex: number, endIndex: number, overscan: number, itemCount: number): {
+    start: number;
+    end: number;
+};
+/**
+ * Debounce function
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Throttle function
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Request animation frame wrapper
+ */
+export declare function requestAnimationFrameWithFallback(callback: FrameRequestCallback): number;
+/**
+ * Cancel animation frame with fallback
+ */
+export declare function cancelAnimationFrameWithFallback(id: number): void;
+/**
+ * Check if an element is visible in viewport
+ */
+export declare function isElementInViewport(element: HTMLElement, container: HTMLElement): boolean;
+/**
+ * Get scroll velocity
+ */
+export declare function calculateScrollVelocity(currentOffset: number, previousOffset: number, deltaTime: number): number;
+/**
+ * Clamp a value between min and max
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Check if ResizeObserver is supported
+ */
+export declare function isResizeObserverSupported(): boolean;
+/**
+ * Check if IntersectionObserver is supported
+ */
+export declare function isIntersectionObserverSupported(): boolean;
+/**
+ * Smooth scroll to position
+ */
+export declare function smoothScroll(element: HTMLElement, targetScroll: number, duration?: number): Promise<void>;
+/**
+ * Create a unique key from index and item
+ */
+export declare function createItemKey<T>(index: number, item: T, keyGetter?: (index: number, item: T) => string | number): string | number;
+/**
+ * Log virtualization stats (for debugging)
+ */
+export declare function logVirtualizationStats(stats: {
+    itemCount: number;
+    visibleCount: number;
+    renderedCount: number;
+    scrollOffset: number;
+    totalSize: number;
+}): void;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,YAAY,CACxB,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAAU,EACf,IAAI,GAAE,MAA2B,GAClC,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAKhC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACtD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACd,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAalC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACtD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACd,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAkBlC;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC7C,QAAQ,EAAE,oBAAoB,GAC/B,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAMjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,WAAW,GACvB,OAAO,CAUT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACnC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAClB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CACxB,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,MAAM,EACpB,QAAQ,GAAE,MAAY,GACvB,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC3B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,EACP,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,GACxD,MAAM,GAAG,MAAM,CAKjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAMP"}