lazy-render-virtual-scroll 2.0.0 → 2.1.2

package/dist/esm/svelte/adapters/react/hooks/useLazyComponent.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+export type LazyMode = 'virtual' | 'visibility' | 'hybrid';
+export interface UseLazyComponentProps {
+    mode?: LazyMode;
+    threshold?: number;
+    rootMargin?: string;
+    onVisible?: () => void;
+    onHidden?: () => void;
+}
+export interface UseLazyComponentReturn {
+    isVisible: boolean;
+    isInView: boolean;
+    ref: React.RefObject<HTMLDivElement>;
+    shouldRender: boolean;
+    shouldMount: boolean;
+}
+/**
+ * Hook for lazy component rendering with multiple modes
+ *
+ * Modes:
+ * - virtual: Traditional virtual scrolling (render all, show visible)
+ * - visibility: Intersection Observer (mount only when visible)
+ * - hybrid: Combine both (best performance)
+ */
+export declare function useLazyComponent(props?: UseLazyComponentProps): UseLazyComponentReturn;
+/**
+ * HOC for lazy rendering components
+ *
+ * Usage:
+ * const LazyCard = withLazyRender(Card);
+ *
+ * <LazyCard mode="hybrid" />
+ */
+export declare function withLazyRender<P extends object>(WrappedComponent: React.ComponentType<P & {
+    mode?: LazyMode;
+}>): (props: P) => React.JSX.Element;
+export default useLazyComponent;
+//# sourceMappingURL=useLazyComponent.d.ts.map

package/dist/esm/svelte/adapters/react/hooks/useLazyComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLazyComponent.d.ts","sourceRoot":"","sources":["../../../../src/adapters/react/hooks/useLazyComponent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAGxE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,GAAE,qBAA0B,GAChC,sBAAsB,CA+ExB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAE,CAAC,IAEhC,OAAO,CAAC,uBAevC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/esm/svelte/core/GlobalScrollManager.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Global Scroll Manager
+ * Singleton that manages scroll events for all lazy-render components
+ * Uses only 2 event listeners for ALL components (scroll + resize)
+ */
+export interface ScrollManagerConfig {
+    scrollThrottle?: number;
+    resizeDebounce?: number;
+}
+export interface ScrollListener {
+    id: string;
+    callback: (scrollTop: number, container: HTMLElement) => void;
+    container: HTMLElement;
+}
+declare class GlobalScrollManagerClass {
+    private static instance;
+    private listeners;
+    private scrollThrottle;
+    private resizeDebounce;
+    private scrollHandler;
+    private resizeHandler;
+    private isInitialized;
+    private constructor();
+    static getInstance(config?: ScrollManagerConfig): GlobalScrollManagerClass;
+    /**
+     * Register a scroll listener
+     * Only 2 event listeners total (scroll + resize) for ALL components
+     */
+    register(id: string, container: HTMLElement, callback: (scrollTop: number, container: HTMLElement) => void): void;
+    /**
+     * Unregister a scroll listener
+     */
+    unregister(id: string): void;
+    /**
+     * Initialize global event listeners
+     * Only called once, regardless of how many components
+     */
+    private initialize;
+    /**
+     * Cleanup event listeners
+     */
+    private cleanup;
+    /**
+     * Throttle helper
+     */
+    private throttle;
+    /**
+     * Debounce helper
+     */
+    private debounce;
+    /**
+     * Get stats
+     */
+    getStats(): {
+        listenerCount: number;
+        isInitialized: boolean;
+    };
+}
+export declare const GlobalScrollManager: GlobalScrollManagerClass;
+export default GlobalScrollManager;
+//# sourceMappingURL=GlobalScrollManager.d.ts.map

package/dist/esm/svelte/core/GlobalScrollManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalScrollManager.d.ts","sourceRoot":"","sources":["../../src/core/GlobalScrollManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9D,SAAS,EAAE,WAAW,CAAC;CACxB;AAED,cAAM,wBAAwB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,aAAa,CAAkB;IAEvC,OAAO;IAKP,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,wBAAwB;IAO1E;;;OAGG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,KAAK,IAAI,GAC5D,IAAI;IAQP;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ5B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAwBlB;;OAEG;IACH,OAAO,CAAC,OAAO;IAcf;;OAEG;IACH,OAAO,CAAC,QAAQ;IAWhB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,OAAO,CAAC;KACxB;CAMF;AAGD,eAAO,MAAM,mBAAmB,0BAAyC,CAAC;AAC1E,eAAe,mBAAmB,CAAC"}

package/dist/esm/svelte/index.d.ts

@@ -25,10 +25,15 @@ export { PerformanceAnalytics } from './core/PerformanceAnalytics';
 export { PerformanceDashboard } from './core/PerformanceDashboard';
 export { AccessibilityManager } from './core/AccessibilityManager';
 export { AnimationManager } from './core/AnimationManager';
+export { GlobalScrollManager } from './core/GlobalScrollManager';
 export type { EngineConfig, VisibleRange, FetchMoreCallback, EngineState, ScrollAnalysis } from './core/types';
 export { ScrollObserver } from './platform/browser/ScrollObserver';
 export { useLazyList } from './adapters/react/useLazyList';
 export { LazyList } from './adapters/react/LazyList';
+export { useLazyComponent } from './adapters/react/hooks/useLazyComponent';
+export { withLazyRender } from './adapters/react/hooks/useLazyComponent';
+export { createLazyComponent } from './adapters/react/components/withLazyRender';
+export type { LazyMode } from './adapters/react/hooks/useLazyComponent';
 export { LazyScroll, createLazyScroll } from './adapters/vanilla/lazyScroll';
 declare class LazyScrollElementClass {
     constructor();

package/dist/esm/svelte/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG/G,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAK7E,cAAM,sBAAsB;;IAE1B,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE;IACrB,OAAO;IACP,eAAe;;;;IACf,MAAM,CAAC,eAAe;CACvB;AAGD,QAAA,MAAM,iBAAiB,+BAEG,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG/G,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,YAAY,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAK7E,cAAM,sBAAsB;;IAE1B,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE;IACrB,OAAO;IACP,eAAe;;;;IACf,MAAM,CAAC,eAAe;CACvB;AAGD,QAAA,MAAM,iBAAiB,+BAEG,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/vue/adapters/react/components/withLazyRender.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import { LazyMode } from '../hooks/useLazyComponent';
+export interface WithLazyRenderProps {
+    mode?: LazyMode;
+    placeholder?: React.ReactNode;
+    onVisible?: () => void;
+    onHidden?: () => void;
+}
+/**
+ * Higher-Order Component for lazy rendering
+ *
+ * Usage:
+ * const LazyCard = withLazyRender(Card);
+ *
+ * <LazyCard mode="hybrid" placeholder={<div>Loading...</div>} />
+ */
+export declare function createLazyComponent<P extends object>(WrappedComponent: React.ComponentType<P>, options?: {
+    placeholder?: React.ReactNode;
+    mode?: LazyMode;
+}): (props: P & WithLazyRenderProps) => React.JSX.Element;
+export default createLazyComponent;
+//# sourceMappingURL=withLazyRender.d.ts.map

package/dist/esm/vue/adapters/react/components/withLazyRender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withLazyRender.d.ts","sourceRoot":"","sources":["../../../../src/adapters/react/components/withLazyRender.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAkB,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAClD,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EACxC,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,IAAI,CAAC,EAAE,QAAQ,CAAC;CACZ,IAEwB,OAAO,CAAC,GAAG,mBAAmB,uBAqE7D;AAED,eAAe,mBAAmB,CAAC"}

package/dist/esm/vue/adapters/react/hooks/useLazyComponent.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+export type LazyMode = 'virtual' | 'visibility' | 'hybrid';
+export interface UseLazyComponentProps {
+    mode?: LazyMode;
+    threshold?: number;
+    rootMargin?: string;
+    onVisible?: () => void;
+    onHidden?: () => void;
+}
+export interface UseLazyComponentReturn {
+    isVisible: boolean;
+    isInView: boolean;
+    ref: React.RefObject<HTMLDivElement>;
+    shouldRender: boolean;
+    shouldMount: boolean;
+}
+/**
+ * Hook for lazy component rendering with multiple modes
+ *
+ * Modes:
+ * - virtual: Traditional virtual scrolling (render all, show visible)
+ * - visibility: Intersection Observer (mount only when visible)
+ * - hybrid: Combine both (best performance)
+ */
+export declare function useLazyComponent(props?: UseLazyComponentProps): UseLazyComponentReturn;
+/**
+ * HOC for lazy rendering components
+ *
+ * Usage:
+ * const LazyCard = withLazyRender(Card);
+ *
+ * <LazyCard mode="hybrid" />
+ */
+export declare function withLazyRender<P extends object>(WrappedComponent: React.ComponentType<P & {
+    mode?: LazyMode;
+}>): (props: P) => React.JSX.Element;
+export default useLazyComponent;
+//# sourceMappingURL=useLazyComponent.d.ts.map

package/dist/esm/vue/adapters/react/hooks/useLazyComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLazyComponent.d.ts","sourceRoot":"","sources":["../../../../src/adapters/react/hooks/useLazyComponent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAGxE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,GAAE,qBAA0B,GAChC,sBAAsB,CA+ExB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAE,CAAC,IAEhC,OAAO,CAAC,uBAevC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/esm/vue/core/GlobalScrollManager.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Global Scroll Manager
+ * Singleton that manages scroll events for all lazy-render components
+ * Uses only 2 event listeners for ALL components (scroll + resize)
+ */
+export interface ScrollManagerConfig {
+    scrollThrottle?: number;
+    resizeDebounce?: number;
+}
+export interface ScrollListener {
+    id: string;
+    callback: (scrollTop: number, container: HTMLElement) => void;
+    container: HTMLElement;
+}
+declare class GlobalScrollManagerClass {
+    private static instance;
+    private listeners;
+    private scrollThrottle;
+    private resizeDebounce;
+    private scrollHandler;
+    private resizeHandler;
+    private isInitialized;
+    private constructor();
+    static getInstance(config?: ScrollManagerConfig): GlobalScrollManagerClass;
+    /**
+     * Register a scroll listener
+     * Only 2 event listeners total (scroll + resize) for ALL components
+     */
+    register(id: string, container: HTMLElement, callback: (scrollTop: number, container: HTMLElement) => void): void;
+    /**
+     * Unregister a scroll listener
+     */
+    unregister(id: string): void;
+    /**
+     * Initialize global event listeners
+     * Only called once, regardless of how many components
+     */
+    private initialize;
+    /**
+     * Cleanup event listeners
+     */
+    private cleanup;
+    /**
+     * Throttle helper
+     */
+    private throttle;
+    /**
+     * Debounce helper
+     */
+    private debounce;
+    /**
+     * Get stats
+     */
+    getStats(): {
+        listenerCount: number;
+        isInitialized: boolean;
+    };
+}
+export declare const GlobalScrollManager: GlobalScrollManagerClass;
+export default GlobalScrollManager;
+//# sourceMappingURL=GlobalScrollManager.d.ts.map

package/dist/esm/vue/core/GlobalScrollManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalScrollManager.d.ts","sourceRoot":"","sources":["../../src/core/GlobalScrollManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9D,SAAS,EAAE,WAAW,CAAC;CACxB;AAED,cAAM,wBAAwB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,aAAa,CAAkB;IAEvC,OAAO;IAKP,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,wBAAwB;IAO1E;;;OAGG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,KAAK,IAAI,GAC5D,IAAI;IAQP;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ5B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAwBlB;;OAEG;IACH,OAAO,CAAC,OAAO;IAcf;;OAEG;IACH,OAAO,CAAC,QAAQ;IAWhB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,OAAO,CAAC;KACxB;CAMF;AAGD,eAAO,MAAM,mBAAmB,0BAAyC,CAAC;AAC1E,eAAe,mBAAmB,CAAC"}

package/dist/esm/vue/index.d.ts

@@ -25,10 +25,15 @@ export { PerformanceAnalytics } from './core/PerformanceAnalytics';
 export { PerformanceDashboard } from './core/PerformanceDashboard';
 export { AccessibilityManager } from './core/AccessibilityManager';
 export { AnimationManager } from './core/AnimationManager';
+export { GlobalScrollManager } from './core/GlobalScrollManager';
 export type { EngineConfig, VisibleRange, FetchMoreCallback, EngineState, ScrollAnalysis } from './core/types';
 export { ScrollObserver } from './platform/browser/ScrollObserver';
 export { useLazyList } from './adapters/react/useLazyList';
 export { LazyList } from './adapters/react/LazyList';
+export { useLazyComponent } from './adapters/react/hooks/useLazyComponent';
+export { withLazyRender } from './adapters/react/hooks/useLazyComponent';
+export { createLazyComponent } from './adapters/react/components/withLazyRender';
+export type { LazyMode } from './adapters/react/hooks/useLazyComponent';
 export { LazyScroll, createLazyScroll } from './adapters/vanilla/lazyScroll';
 declare class LazyScrollElementClass {
     constructor();

package/dist/esm/vue/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG/G,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAK7E,cAAM,sBAAsB;;IAE1B,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE;IACrB,OAAO;IACP,eAAe;;;;IACf,MAAM,CAAC,eAAe;CACvB;AAGD,QAAA,MAAM,iBAAiB,+BAEG,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG/G,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,YAAY,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAK7E,cAAM,sBAAsB;;IAE1B,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE;IACrB,OAAO;IACP,eAAe;;;;IACf,MAAM,CAAC,eAAe;CACvB;AAGD,QAAA,MAAM,iBAAiB,+BAEG,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 interface EngineConfig {
     itemHeight: number;
@@ -1352,6 +1353,61 @@ declare class AnimationManager {
     updateConfig(config: Partial<AnimationConfig>): void;
 }
 
+/**
+ * Global Scroll Manager
+ * Singleton that manages scroll events for all lazy-render components
+ * Uses only 2 event listeners for ALL components (scroll + resize)
+ */
+interface ScrollManagerConfig {
+    scrollThrottle?: number;
+    resizeDebounce?: number;
+}
+declare class GlobalScrollManagerClass {
+    private static instance;
+    private listeners;
+    private scrollThrottle;
+    private resizeDebounce;
+    private scrollHandler;
+    private resizeHandler;
+    private isInitialized;
+    private constructor();
+    static getInstance(config?: ScrollManagerConfig): GlobalScrollManagerClass;
+    /**
+     * Register a scroll listener
+     * Only 2 event listeners total (scroll + resize) for ALL components
+     */
+    register(id: string, container: HTMLElement, callback: (scrollTop: number, container: HTMLElement) => void): void;
+    /**
+     * Unregister a scroll listener
+     */
+    unregister(id: string): void;
+    /**
+     * Initialize global event listeners
+     * Only called once, regardless of how many components
+     */
+    private initialize;
+    /**
+     * Cleanup event listeners
+     */
+    private cleanup;
+    /**
+     * Throttle helper
+     */
+    private throttle;
+    /**
+     * Debounce helper
+     */
+    private debounce;
+    /**
+     * Get stats
+     */
+    getStats(): {
+        listenerCount: number;
+        isInitialized: boolean;
+    };
+}
+declare const GlobalScrollManager: GlobalScrollManagerClass;
+
 declare class ScrollObserver {
     private container;
     private callback;
@@ -1406,6 +1462,61 @@ interface LazyListProps extends EngineConfig {
 }
 declare const LazyList: React.ForwardRefExoticComponent<LazyListProps & React.RefAttributes<HTMLDivElement>>;
 
+type LazyMode = 'virtual' | 'visibility' | 'hybrid';
+interface UseLazyComponentProps {
+    mode?: LazyMode;
+    threshold?: number;
+    rootMargin?: string;
+    onVisible?: () => void;
+    onHidden?: () => void;
+}
+interface UseLazyComponentReturn {
+    isVisible: boolean;
+    isInView: boolean;
+    ref: React.RefObject<HTMLDivElement>;
+    shouldRender: boolean;
+    shouldMount: boolean;
+}
+/**
+ * Hook for lazy component rendering with multiple modes
+ *
+ * Modes:
+ * - virtual: Traditional virtual scrolling (render all, show visible)
+ * - visibility: Intersection Observer (mount only when visible)
+ * - hybrid: Combine both (best performance)
+ */
+declare function useLazyComponent(props?: UseLazyComponentProps): UseLazyComponentReturn;
+/**
+ * HOC for lazy rendering components
+ *
+ * Usage:
+ * const LazyCard = withLazyRender(Card);
+ *
+ * <LazyCard mode="hybrid" />
+ */
+declare function withLazyRender<P extends object>(WrappedComponent: React.ComponentType<P & {
+    mode?: LazyMode;
+}>): (props: P) => react_jsx_runtime.JSX.Element;
+
+interface WithLazyRenderProps {
+    mode?: LazyMode;
+    placeholder?: React.ReactNode;
+    onVisible?: () => void;
+    onHidden?: () => void;
+}
+/**
+ * Higher-Order Component for lazy rendering
+ *
+ * Usage:
+ * const LazyCard = withLazyRender(Card);
+ *
+ * <LazyCard mode="hybrid" placeholder={<div>Loading...</div>} />
+ */
+declare function createLazyComponent<P extends object>(WrappedComponent: React.ComponentType<P>, options?: {
+    placeholder?: React.ReactNode;
+    mode?: LazyMode;
+}): (props: P & WithLazyRenderProps) => react_jsx_runtime.JSX.Element;
+
 class LazyScroll {
   constructor(container, config) {
     this.container = container;
@@ -1555,5 +1666,5 @@ declare class LazyScrollElementClass {
 }
 declare const LazyScrollElement: typeof LazyScrollElementClass;
 
-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 };
+export { AccessibilityManager, AdaptiveBufferCalculator, AnimationManager, BatchSizeOptimizer, ContentComplexityAnalyzer, DevicePerformanceMonitor, DynamicHeightEngine, Engine, GPUAccelerator, GlobalScrollManager, HeightMeasurementCache, IntelligentPagination, IntelligentScrollDetector, LazyList, LazyScroll, LazyScrollElement, MemoryManager, NetworkAwarePrefetchManager, NetworkAwareRequestQueue, NetworkSpeedDetector, PerformanceAnalytics, PerformanceDashboard, PerformanceOptimizer, PreemptiveCache, PrefetchManager, Priority, PriorityRequestQueue, RequestDeduplicator, RequestQueue, ScrollObserver, SmartPrefetchAlgorithm, VariableHeightManager, WindowManager, createLazyComponent, createLazyScroll, debounce, throttle, useLazyComponent, useLazyList, withLazyRender };
+export type { EngineConfig, EngineState, FetchMoreCallback, LazyMode, ScrollAnalysis, VisibleRange };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lazy-render-virtual-scroll",
-  "version": "2.0.0",
+  "version": "2.1.2",
   "description": "A framework-agnostic virtual scrolling and lazy rendering solution",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -71,9 +71,9 @@
     "url": "https://github.com/sannuk79/PROJECTS-AND-NPM-PACKAGES-?tab=readme-ov-file"
   },
   "bugs": {
-    "url": "https://github.com/sannuk79/lezzyrender/issues"
+    "url": "https://mypackagedoc.vercel.app/package/lazy-render"
   },
-  "homepage": "https://github.com/sannuk79/lezzyrender#readme",
+  "homepage": "https://mypackagedoc.vercel.app/package/lazy-render",
   "peerDependencies": {
     "react": "^18.3.1",
     "react-dom": "^18.3.1"