lazy-render-virtual-scroll 2.0.0 → 2.1.2

package/dist/cjs/angular/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/cjs/angular/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/cjs/angular/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/cjs/angular/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/cjs/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/cjs/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/cjs/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/cjs/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/cjs/index.js

@@ -3674,6 +3674,120 @@ class AnimationManager {
     }
 }
 
+/**
+ * Global Scroll Manager
+ * Singleton that manages scroll events for all lazy-render components
+ * Uses only 2 event listeners for ALL components (scroll + resize)
+ */
+class GlobalScrollManagerClass {
+    constructor(config = {}) {
+        this.listeners = new Map();
+        this.scrollHandler = null;
+        this.resizeHandler = null;
+        this.isInitialized = false;
+        this.scrollThrottle = config.scrollThrottle || 16;
+        this.resizeDebounce = config.resizeDebounce || 100;
+    }
+    static getInstance(config) {
+        if (!GlobalScrollManagerClass.instance) {
+            GlobalScrollManagerClass.instance = new GlobalScrollManagerClass(config);
+        }
+        return GlobalScrollManagerClass.instance;
+    }
+    /**
+     * Register a scroll listener
+     * Only 2 event listeners total (scroll + resize) for ALL components
+     */
+    register(id, container, callback) {
+        this.listeners.set(id, { id, callback, container });
+        if (!this.isInitialized) {
+            this.initialize();
+        }
+    }
+    /**
+     * Unregister a scroll listener
+     */
+    unregister(id) {
+        this.listeners.delete(id);
+        if (this.listeners.size === 0) {
+            this.cleanup();
+        }
+    }
+    /**
+     * Initialize global event listeners
+     * Only called once, regardless of how many components
+     */
+    initialize() {
+        this.isInitialized = true;
+        // Single scroll handler for ALL components
+        this.scrollHandler = this.throttle(() => {
+            this.listeners.forEach((listener) => {
+                const scrollTop = listener.container.scrollTop;
+                listener.callback(scrollTop, listener.container);
+            });
+        }, this.scrollThrottle);
+        // Single resize handler for ALL components
+        this.resizeHandler = this.debounce(() => {
+            this.listeners.forEach((listener) => {
+                const scrollTop = listener.container.scrollTop;
+                listener.callback(scrollTop, listener.container);
+            });
+        }, this.resizeDebounce);
+        // Attach to document (global)
+        document.addEventListener('scroll', this.scrollHandler, { passive: true, capture: true });
+        window.addEventListener('resize', this.resizeHandler);
+    }
+    /**
+     * Cleanup event listeners
+     */
+    cleanup() {
+        if (this.scrollHandler) {
+            document.removeEventListener('scroll', this.scrollHandler, { capture: true });
+            this.scrollHandler = null;
+        }
+        if (this.resizeHandler) {
+            window.removeEventListener('resize', this.resizeHandler);
+            this.resizeHandler = null;
+        }
+        this.isInitialized = false;
+    }
+    /**
+     * Throttle helper
+     */
+    throttle(func, limit) {
+        let inThrottle;
+        return ((...args) => {
+            if (!inThrottle) {
+                func.apply(this, args);
+                inThrottle = true;
+                setTimeout(() => (inThrottle = false), limit);
+            }
+        });
+    }
+    /**
+     * Debounce helper
+     */
+    debounce(func, wait) {
+        let timeout;
+        return ((...args) => {
+            if (timeout)
+                clearTimeout(timeout);
+            timeout = setTimeout(() => func.apply(this, args), wait);
+        });
+    }
+    /**
+     * Get stats
+     */
+    getStats() {
+        return {
+            listenerCount: this.listeners.size,
+            isInitialized: this.isInitialized
+        };
+    }
+}
+// Export singleton
+const GlobalScrollManager = GlobalScrollManagerClass.getInstance();
+
 class ScrollObserver {
     constructor(container, callback, options) {
         this.observer = null;
@@ -3872,6 +3986,157 @@ const LazyList = React.forwardRef((props, ref) => {
 });
 LazyList.displayName = 'LazyList';
 
+/**
+ * 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)
+ */
+function useLazyComponent(props = {}) {
+    const { mode = 'hybrid', threshold = 0, rootMargin = '0px', onVisible, onHidden } = props;
+    const ref = React.useRef(null);
+    const [isVisible, setIsVisible] = React.useState(false);
+    const [isInView, setIsInView] = React.useState(false);
+    const [hasMounted, setHasMounted] = React.useState(false);
+    // Visibility API (Intersection Observer)
+    React.useEffect(() => {
+        if (mode === 'visibility' || mode === 'hybrid') {
+            const observer = new IntersectionObserver(([entry]) => {
+                const visible = entry.isIntersecting;
+                setIsVisible(visible);
+                setIsInView(visible);
+                if (visible) {
+                    onVisible === null || onVisible === void 0 ? void 0 : onVisible();
+                    setHasMounted(true); // Keep mounted once visible
+                }
+                else {
+                    onHidden === null || onHidden === void 0 ? void 0 : onHidden();
+                    if (mode === 'visibility') {
+                        setHasMounted(false); // Unmount when not visible
+                    }
+                }
+            }, { threshold, rootMargin });
+            if (ref.current) {
+                observer.observe(ref.current);
+            }
+            return () => observer.disconnect();
+        }
+    }, [mode, threshold, rootMargin, onVisible, onHidden]);
+    // Determine if should render based on mode
+    const shouldRender = React.useCallback(() => {
+        switch (mode) {
+            case 'virtual':
+                return true; // Always render, control visibility with CSS
+            case 'visibility':
+                return hasMounted; // Mount when visible, keep mounted
+            case 'hybrid':
+                return hasMounted; // Mount when visible, keep mounted
+            default:
+                return true;
+        }
+    }, [mode, hasMounted]);
+    // Determine if should mount based on mode
+    const shouldMount = React.useCallback(() => {
+        switch (mode) {
+            case 'virtual':
+                return true; // Always mount
+            case 'visibility':
+                return isVisible; // Mount only when visible
+            case 'hybrid':
+                return isVisible; // Mount only when visible
+            default:
+                return true;
+        }
+    }, [mode, isVisible]);
+    return {
+        isVisible,
+        isInView,
+        ref,
+        shouldRender: shouldRender(),
+        shouldMount: shouldMount()
+    };
+}
+/**
+ * HOC for lazy rendering components
+ *
+ * Usage:
+ * const LazyCard = withLazyRender(Card);
+ *
+ * <LazyCard mode="hybrid" />
+ */
+function withLazyRender(WrappedComponent) {
+    return function LazyComponent(props) {
+        const { isVisible, ref, shouldMount } = useLazyComponent({
+            mode: props.mode || 'hybrid'
+        });
+        if (!shouldMount) {
+            return React.createElement("div", { ref: ref, style: { height: '100px', background: '#f0f0f0' } }, "Loading...");
+        }
+        return (React.createElement("div", { ref: ref, style: { opacity: isVisible ? 1 : 0, transition: 'opacity 0.3s' } },
+            React.createElement(WrappedComponent, { ...props })));
+    };
+}
+
+/**
+ * Higher-Order Component for lazy rendering
+ *
+ * Usage:
+ * const LazyCard = withLazyRender(Card);
+ *
+ * <LazyCard mode="hybrid" placeholder={<div>Loading...</div>} />
+ */
+function createLazyComponent(WrappedComponent, options = {}) {
+    return function LazyComponent(props) {
+        const { mode = options.mode || 'hybrid', placeholder = options.placeholder || React.createElement("div", null, "Loading..."), onVisible, onHidden, ...rest } = props;
+        const [isVisible, setIsVisible] = React.useState(false);
+        const [hasMounted, setHasMounted] = React.useState(false);
+        const ref = React.useRef(null);
+        React.useEffect(() => {
+            if (mode === 'visibility' || mode === 'hybrid') {
+                const observer = new IntersectionObserver(([entry]) => {
+                    const visible = entry.isIntersecting;
+                    setIsVisible(visible);
+                    if (visible) {
+                        onVisible === null || onVisible === void 0 ? void 0 : onVisible();
+                        setHasMounted(true);
+                    }
+                    else {
+                        onHidden === null || onHidden === void 0 ? void 0 : onHidden();
+                        if (mode === 'visibility') {
+                            setHasMounted(false);
+                        }
+                    }
+                }, { threshold: 0, rootMargin: '0px' });
+                if (ref.current) {
+                    observer.observe(ref.current);
+                }
+                return () => observer.disconnect();
+            }
+        }, [mode, onVisible, onHidden]);
+        const shouldRender = React.useCallback(() => {
+            switch (mode) {
+                case 'virtual':
+                    return true;
+                case 'visibility':
+                case 'hybrid':
+                    return hasMounted;
+                default:
+                    return true;
+            }
+        }, [mode, hasMounted]);
+        if (!shouldRender()) {
+            return React.createElement("div", { ref: ref }, placeholder);
+        }
+        return (React.createElement("div", { ref: ref, style: {
+                opacity: isVisible ? 1 : 0,
+                transition: 'opacity 0.3s ease-in-out'
+            } },
+            React.createElement(WrappedComponent, { ...rest })));
+    };
+}
+
 class LazyScroll {
   constructor(container, config) {
     this.container = container;
@@ -4052,6 +4317,7 @@ exports.DevicePerformanceMonitor = DevicePerformanceMonitor;
 exports.DynamicHeightEngine = DynamicHeightEngine;
 exports.Engine = Engine;
 exports.GPUAccelerator = GPUAccelerator;
+exports.GlobalScrollManager = GlobalScrollManager;
 exports.HeightMeasurementCache = HeightMeasurementCache;
 exports.IntelligentPagination = IntelligentPagination;
 exports.IntelligentScrollDetector = IntelligentScrollDetector;
@@ -4074,8 +4340,11 @@ exports.ScrollObserver = ScrollObserver;
 exports.SmartPrefetchAlgorithm = SmartPrefetchAlgorithm;
 exports.VariableHeightManager = VariableHeightManager;
 exports.WindowManager = WindowManager;
+exports.createLazyComponent = createLazyComponent;
 exports.createLazyScroll = createLazyScroll;
 exports.debounce = debounce;
 exports.throttle = throttle;
+exports.useLazyComponent = useLazyComponent;
 exports.useLazyList = useLazyList;
+exports.withLazyRender = withLazyRender;
 //# sourceMappingURL=index.js.map