@zappzarapp/browser-utils 1.0.0

package/dist/network/RetryQueue.js

@@ -0,0 +1,222 @@
+import { NetworkError } from '../core';
+import { NetworkStatus } from './NetworkStatus.js';
+export class RetryQueue {
+    options;
+    queue = [];
+    processing = false;
+    paused = false;
+    stats = { succeeded: 0, failed: 0, retries: 0 };
+    retryHandlers = [];
+    networkCleanup = null;
+    operationTimestamps = [];
+    constructor(options = {}) {
+        this.options = {
+            maxRetries: options.maxRetries ?? 3,
+            backoff: options.backoff ?? 'exponential',
+            baseDelay: options.baseDelay ?? 1000,
+            maxDelay: options.maxDelay ?? 30000,
+            networkAware: options.networkAware ?? true,
+            jitter: options.jitter ?? true,
+            rateLimit: options.rateLimit,
+        };
+        if (this.options.baseDelay <= 0) {
+            throw new NetworkError('NETWORK_INVALID_OPTIONS', 'baseDelay must be positive');
+        }
+        if (this.options.maxDelay <= 0) {
+            throw new NetworkError('NETWORK_INVALID_OPTIONS', 'maxDelay must be positive');
+        }
+        if (this.options.networkAware) {
+            this.setupNetworkAwareness();
+        }
+    }
+    static create(options) {
+        return new RetryQueue(options);
+    }
+    add(operation) {
+        return new Promise((resolve, reject) => {
+            this.queue.push({
+                operation: operation,
+                resolve: resolve,
+                reject,
+                attempts: 0,
+            });
+            void this.processQueue();
+        });
+    }
+    pause() {
+        this.paused = true;
+    }
+    resume() {
+        this.paused = false;
+        void this.processQueue();
+    }
+    clear() {
+        for (const item of this.queue) {
+            item.reject(NetworkError.aborted());
+        }
+        this.queue.length = 0;
+    }
+    destroy() {
+        this.clear();
+        this.retryHandlers = [];
+        if (this.networkCleanup !== null) {
+            this.networkCleanup();
+            this.networkCleanup = null;
+        }
+    }
+    onRetry(handler) {
+        this.retryHandlers.push(handler);
+        return () => {
+            const index = this.retryHandlers.indexOf(handler);
+            if (index !== -1) {
+                this.retryHandlers.splice(index, 1);
+            }
+        };
+    }
+    getStats() {
+        return {
+            pending: this.queue.length,
+            succeeded: this.stats.succeeded,
+            failed: this.stats.failed,
+            retries: this.stats.retries,
+            paused: this.paused,
+        };
+    }
+    isPaused() {
+        return this.paused;
+    }
+    isEmpty() {
+        return this.queue.length === 0;
+    }
+    async processQueue() {
+        if (this.processing || this.paused || this.queue.length === 0) {
+            return;
+        }
+        if (this.options.networkAware && NetworkStatus.isOffline()) {
+            return;
+        }
+        this.processing = true;
+        while (this.queue.length > 0 && !this.paused) {
+            if (this.options.networkAware && NetworkStatus.isOffline()) {
+                break;
+            }
+            const shouldContinue = await this.waitForRateLimit();
+            if (shouldContinue) {
+                continue;
+            }
+            const item = this.queue[0];
+            await this.processQueueItem(item);
+        }
+        this.processing = false;
+    }
+    async waitForRateLimit() {
+        if (!this.options.rateLimit) {
+            return false;
+        }
+        const canProcess = this.checkRateLimit();
+        if (!canProcess) {
+            const delay = this.calculateRateLimitDelay();
+            await this.delay(delay);
+            return true;
+        }
+        return false;
+    }
+    async processQueueItem(item) {
+        try {
+            const result = await item.operation();
+            this.queue.shift();
+            this.stats.succeeded++;
+            item.resolve(result);
+            if (this.options.rateLimit) {
+                this.recordOperation();
+            }
+        }
+        catch (error) {
+            item.attempts++;
+            if (item.attempts <= this.options.maxRetries) {
+                this.stats.retries++;
+                this.emitRetry(item.attempts, error);
+                const delay = this.calculateDelay(item.attempts);
+                await this.delay(delay);
+            }
+            else {
+                this.queue.shift();
+                this.stats.failed++;
+                item.reject(NetworkError.maxRetries(item.attempts, error));
+            }
+        }
+    }
+    calculateDelay(attempt) {
+        let delay;
+        switch (this.options.backoff) {
+            case 'constant':
+                delay = this.options.baseDelay;
+                break;
+            case 'linear':
+                delay = this.options.baseDelay * attempt;
+                break;
+            case 'exponential':
+            default:
+                delay = this.options.baseDelay * Math.pow(2, attempt - 1);
+                break;
+        }
+        delay = Math.min(delay, this.options.maxDelay);
+        if (this.options.jitter) {
+            delay = delay * (0.5 + this.cryptoRandom());
+        }
+        return Math.floor(delay);
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    emitRetry(attempt, error) {
+        for (const handler of this.retryHandlers) {
+            try {
+                handler(attempt, error);
+            }
+            catch {
+            }
+        }
+    }
+    setupNetworkAwareness() {
+        this.networkCleanup = NetworkStatus.onOnline(() => {
+            if (!this.paused) {
+                void this.processQueue();
+            }
+        });
+    }
+    cryptoRandom() {
+        const buffer = new Uint32Array(1);
+        crypto.getRandomValues(buffer);
+        return buffer[0] / 0xffffffff;
+    }
+    checkRateLimit() {
+        if (!this.options.rateLimit) {
+            return true;
+        }
+        const now = Date.now();
+        const { windowMs, maxRequestsPerWindow } = this.options.rateLimit;
+        const cutoff = now - windowMs;
+        while (this.operationTimestamps.length > 0 && this.operationTimestamps[0] < cutoff) {
+            this.operationTimestamps.shift();
+        }
+        return this.operationTimestamps.length < maxRequestsPerWindow;
+    }
+    recordOperation() {
+        if (!this.options.rateLimit) {
+            return;
+        }
+        this.operationTimestamps.push(Date.now());
+    }
+    calculateRateLimitDelay() {
+        if (!this.options.rateLimit || this.operationTimestamps.length === 0) {
+            return 0;
+        }
+        const now = Date.now();
+        const { windowMs } = this.options.rateLimit;
+        const oldestTimestamp = this.operationTimestamps[0];
+        const timeUntilExpiry = oldestTimestamp + windowMs - now;
+        return Math.max(1, timeUntilExpiry);
+    }
+}
+//# sourceMappingURL=RetryQueue.js.map

package/dist/network/RetryQueue.js.map

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

package/dist/network/index.d.ts

@@ -0,0 +1,5 @@
+export { NetworkStatus } from './NetworkStatus.js';
+export type { ConnectionType, NetworkInfo, NetworkInformation } from './NetworkStatus.js';
+export { RetryQueue } from './RetryQueue.js';
+export type { RetryQueueOptions, RetryStats, BackoffStrategy } from './RetryQueue.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/network/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/network/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/network/index.js

@@ -0,0 +1,3 @@
+export { NetworkStatus } from './NetworkStatus.js';
+export { RetryQueue } from './RetryQueue.js';
+//# sourceMappingURL=index.js.map

package/dist/network/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/network/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/notification/BrowserNotification.d.ts

@@ -0,0 +1,20 @@
+import { Result, NotificationError } from '../core';
+export declare const BrowserNotification: {
+    readonly isSupported: () => boolean;
+    readonly permission: () => NotificationPermission;
+    readonly isGranted: () => boolean;
+    readonly isDenied: () => boolean;
+    readonly requestPermission: () => Promise<Result<NotificationPermission, NotificationError>>;
+    readonly show: (title: string, options?: NotificationOptions) => Promise<Result<Notification, NotificationError>>;
+    readonly showWithHandlers: (title: string, options: NotificationOptions & {
+        onClick?: (event: Event) => void;
+        onClose?: (event: Event) => void;
+        onError?: (event: Event) => void;
+        onShow?: (event: Event) => void;
+    }) => Promise<Result<Notification, NotificationError>>;
+    readonly close: (notification: Notification) => void;
+    readonly closeAll: () => void;
+    readonly activeCount: () => number;
+    readonly showViaServiceWorker: (title: string, options?: NotificationOptions) => Promise<Result<void, NotificationError>>;
+};
+//# sourceMappingURL=BrowserNotification.d.ts.map

package/dist/notification/BrowserNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserNotification.d.ts","sourceRoot":"","sources":["../../src/notification/BrowserNotification.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAKpD,eAAO,MAAM,mBAAmB;gCAQf,OAAO;+BAOR,sBAAsB;8BAUvB,OAAO;6BAOR,OAAO;sCAOQ,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;2BA2B5E,MAAM,YACH,mBAAmB,KAC5B,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;uCA0C1C,MAAM,WACJ,mBAAmB,GAAG;QAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QACjC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;KACjC,KACA,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;mCAgC/B,YAAY,KAAG,IAAI;6BAQ3B,IAAI;gCAUD,MAAM;2CAaZ,MAAM,YACH,mBAAmB,KAC5B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;CAyBnC,CAAC"}

package/dist/notification/BrowserNotification.js

@@ -0,0 +1,120 @@
+import { Result, NotificationError } from '../core';
+const activeNotifications = new Set();
+export const BrowserNotification = {
+    isSupported() {
+        return typeof Notification !== 'undefined';
+    },
+    permission() {
+        if (!BrowserNotification.isSupported()) {
+            return 'denied';
+        }
+        return Notification.permission;
+    },
+    isGranted() {
+        return BrowserNotification.permission() === 'granted';
+    },
+    isDenied() {
+        return BrowserNotification.permission() === 'denied';
+    },
+    async requestPermission() {
+        if (!BrowserNotification.isSupported()) {
+            return Result.err(NotificationError.notSupported());
+        }
+        try {
+            const permission = await Notification.requestPermission();
+            if (permission === 'denied') {
+                return Result.err(NotificationError.permissionDenied());
+            }
+            return Result.ok(permission);
+        }
+        catch (e) {
+            return Result.err(NotificationError.showFailed(e));
+        }
+    },
+    async show(title, options) {
+        if (!BrowserNotification.isSupported()) {
+            return Result.err(NotificationError.notSupported());
+        }
+        if (BrowserNotification.permission() === 'denied') {
+            return Result.err(NotificationError.permissionDenied());
+        }
+        if (BrowserNotification.permission() === 'default') {
+            const permResult = await BrowserNotification.requestPermission();
+            if (Result.isErr(permResult)) {
+                return permResult;
+            }
+            if (permResult.value !== 'granted') {
+                return Result.err(NotificationError.permissionDenied());
+            }
+        }
+        try {
+            const notification = new Notification(title, options);
+            activeNotifications.add(notification);
+            notification.onclose = () => {
+                activeNotifications.delete(notification);
+            };
+            return Result.ok(notification);
+        }
+        catch (e) {
+            return Result.err(NotificationError.showFailed(e));
+        }
+    },
+    async showWithHandlers(title, options) {
+        const { onClick, onClose, onError, onShow, ...notificationOptions } = options;
+        const result = await BrowserNotification.show(title, notificationOptions);
+        if (Result.isErr(result)) {
+            return result;
+        }
+        const notification = result.value;
+        if (onClick)
+            notification.onclick = onClick;
+        if (onClose) {
+            const originalOnClose = notification.onclose;
+            notification.onclose = (e) => {
+                originalOnClose?.call(notification, e);
+                onClose(e);
+            };
+        }
+        if (onError)
+            notification.onerror = onError;
+        if (onShow)
+            notification.onshow = onShow;
+        return Result.ok(notification);
+    },
+    close(notification) {
+        notification.close();
+        activeNotifications.delete(notification);
+    },
+    closeAll() {
+        for (const notification of activeNotifications) {
+            notification.close();
+        }
+        activeNotifications.clear();
+    },
+    activeCount() {
+        return activeNotifications.size;
+    },
+    async showViaServiceWorker(title, options) {
+        if (!BrowserNotification.isSupported()) {
+            return Result.err(NotificationError.notSupported());
+        }
+        if (!('serviceWorker' in navigator)) {
+            return Result.err(NotificationError.notSupported());
+        }
+        if (BrowserNotification.permission() !== 'granted') {
+            const permResult = await BrowserNotification.requestPermission();
+            if (Result.isErr(permResult) || permResult.value !== 'granted') {
+                return Result.err(NotificationError.permissionDenied());
+            }
+        }
+        try {
+            const registration = await navigator.serviceWorker.ready;
+            await registration.showNotification(title, options);
+            return Result.ok(undefined);
+        }
+        catch (e) {
+            return Result.err(NotificationError.showFailed(e));
+        }
+    },
+};
+//# sourceMappingURL=BrowserNotification.js.map

package/dist/notification/BrowserNotification.js.map

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

package/dist/notification/index.d.ts

@@ -0,0 +1,2 @@
+export { BrowserNotification } from './BrowserNotification.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/notification/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notification/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/notification/index.js

@@ -0,0 +1,2 @@
+export { BrowserNotification } from './BrowserNotification.js';
+//# sourceMappingURL=index.js.map

package/dist/notification/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notification/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/observe/IntersectionObserverWrapper.d.ts

@@ -0,0 +1,21 @@
+import type { CleanupFn } from '../core';
+export interface IntersectionOptions {
+    readonly root?: Element | Document | null;
+    readonly rootMargin?: string;
+    readonly threshold?: number | number[];
+}
+export interface ObserveResult {
+    readonly cleanup: CleanupFn;
+    readonly observer: IntersectionObserver | null;
+}
+export declare const IntersectionObserverWrapper: {
+    readonly isSupported: () => boolean;
+    readonly observe: (element: Element, callback: (entry: IntersectionObserverEntry, observer: IntersectionObserver | null) => void, options?: IntersectionOptions) => CleanupFn;
+    readonly observeAll: (elements: Iterable<Element>, callback: (entry: IntersectionObserverEntry, observer: IntersectionObserver | null) => void, options?: IntersectionOptions) => ObserveResult;
+    readonly onceVisible: (element: Element, options?: IntersectionOptions) => Promise<IntersectionObserverEntry>;
+    readonly lazyLoad: <T extends Element>(elements: Iterable<T>, loader: (element: T) => void, options?: IntersectionOptions) => CleanupFn;
+    readonly trackVisibility: (element: Element, callback: (ratio: number, entry: IntersectionObserverEntry) => void, steps?: number) => CleanupFn;
+    readonly infiniteScroll: (sentinel: Element, loadMore: () => void | Promise<void>, options?: IntersectionOptions) => CleanupFn;
+    readonly createFallbackEntry: (target: Element, isIntersecting: boolean) => IntersectionObserverEntry;
+};
+//# sourceMappingURL=IntersectionObserverWrapper.d.ts.map

package/dist/observe/IntersectionObserverWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntersectionObserverWrapper.d.ts","sourceRoot":"","sources":["../../src/observe/IntersectionObserverWrapper.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,WAAW,mBAAmB;IAIlC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;IAM1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAM7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAI5B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAM5B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAChD;AAED,eAAO,MAAM,2BAA2B;gCAQvB,OAAO;gCAYX,OAAO,YACN,CAAC,KAAK,EAAE,yBAAyB,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,KAAK,IAAI,YACjF,mBAAmB,KAC5B,SAAS;oCAqCA,QAAQ,CAAC,OAAO,CAAC,YACjB,CAAC,KAAK,EAAE,yBAAyB,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,KAAK,IAAI,YACjF,mBAAmB,KAC5B,aAAa;oCA8CK,OAAO,YAAY,mBAAmB,KAAG,OAAO,CAAC,yBAAyB,CAAC;wBAsCvF,CAAC,SAAS,OAAO,YACd,QAAQ,CAAC,CAAC,CAAC,UACb,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,YAClB,mBAAmB,KAC5B,SAAS;wCAwCD,OAAO,YACN,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,KAAK,IAAI,qBAElE,SAAS;wCAoBA,OAAO,YACP,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,YAC1B,mBAAmB,KAC5B,SAAS;2CA6BgB,OAAO,kBAAkB,OAAO,KAAG,yBAAyB;CAYhF,CAAC"}

package/dist/observe/IntersectionObserverWrapper.js

@@ -0,0 +1,134 @@
+export const IntersectionObserverWrapper = {
+    isSupported() {
+        return typeof IntersectionObserver !== 'undefined';
+    },
+    observe(element, callback, options) {
+        if (!IntersectionObserverWrapper.isSupported()) {
+            const entry = IntersectionObserverWrapper.createFallbackEntry(element, true);
+            callback(entry, null);
+            return () => { };
+        }
+        const observer = new IntersectionObserver((entries, obs) => {
+            for (const entry of entries) {
+                callback(entry, obs);
+            }
+        }, {
+            root: options?.root,
+            rootMargin: options?.rootMargin ?? '0px',
+            threshold: options?.threshold ?? 0,
+        });
+        observer.observe(element);
+        return () => {
+            observer.unobserve(element);
+            observer.disconnect();
+        };
+    },
+    observeAll(elements, callback, options) {
+        if (!IntersectionObserverWrapper.isSupported()) {
+            for (const element of elements) {
+                const entry = IntersectionObserverWrapper.createFallbackEntry(element, true);
+                callback(entry, null);
+            }
+            return {
+                cleanup: () => { },
+                observer: null,
+            };
+        }
+        const observer = new IntersectionObserver((entries, obs) => {
+            for (const entry of entries) {
+                callback(entry, obs);
+            }
+        }, {
+            root: options?.root,
+            rootMargin: options?.rootMargin ?? '0px',
+            threshold: options?.threshold ?? 0,
+        });
+        for (const element of elements) {
+            observer.observe(element);
+        }
+        return {
+            cleanup: () => observer.disconnect(),
+            observer,
+        };
+    },
+    onceVisible(element, options) {
+        return new Promise((resolve) => {
+            if (!IntersectionObserverWrapper.isSupported()) {
+                resolve(IntersectionObserverWrapper.createFallbackEntry(element, true));
+                return;
+            }
+            const observer = new IntersectionObserver((entries, obs) => {
+                for (const entry of entries) {
+                    if (entry.isIntersecting) {
+                        obs.disconnect();
+                        resolve(entry);
+                        return;
+                    }
+                }
+            }, {
+                root: options?.root,
+                rootMargin: options?.rootMargin ?? '0px',
+                threshold: options?.threshold ?? 0,
+            });
+            observer.observe(element);
+        });
+    },
+    lazyLoad(elements, loader, options) {
+        if (!IntersectionObserverWrapper.isSupported()) {
+            for (const element of elements) {
+                loader(element);
+            }
+            return () => { };
+        }
+        const observer = new IntersectionObserver((entries, obs) => {
+            for (const entry of entries) {
+                if (entry.isIntersecting) {
+                    loader(entry.target);
+                    obs.unobserve(entry.target);
+                }
+            }
+        }, {
+            root: options?.root,
+            rootMargin: options?.rootMargin ?? '50px',
+            threshold: options?.threshold ?? 0,
+        });
+        for (const element of elements) {
+            observer.observe(element);
+        }
+        return () => observer.disconnect();
+    },
+    trackVisibility(element, callback, steps = 10) {
+        const thresholds = Array.from({ length: steps + 1 }, (_, i) => i / steps);
+        return IntersectionObserverWrapper.observe(element, (entry) => {
+            callback(entry.intersectionRatio, entry);
+        }, { threshold: thresholds });
+    },
+    infiniteScroll(sentinel, loadMore, options) {
+        let loading = false;
+        return IntersectionObserverWrapper.observe(sentinel, (entry) => {
+            if (entry.isIntersecting && !loading) {
+                loading = true;
+                void Promise.resolve(loadMore()).finally(() => {
+                    loading = false;
+                });
+            }
+        }, {
+            root: options?.root,
+            rootMargin: options?.rootMargin ?? '100px',
+            threshold: options?.threshold ?? 0,
+        });
+    },
+    createFallbackEntry(target, isIntersecting) {
+        const rect = target.getBoundingClientRect();
+        return {
+            target,
+            isIntersecting,
+            intersectionRatio: isIntersecting ? 1 : 0,
+            boundingClientRect: rect,
+            intersectionRect: isIntersecting ? rect : new DOMRect(),
+            rootBounds: null,
+            time: performance.now(),
+        };
+    },
+};
+//# sourceMappingURL=IntersectionObserverWrapper.js.map

package/dist/observe/IntersectionObserverWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntersectionObserverWrapper.js","sourceRoot":"","sources":["../../src/observe/IntersectionObserverWrapper.ts"],"names":[],"mappings":"AA2EA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IAQzC,WAAW;QACT,OAAO,OAAO,oBAAoB,KAAK,WAAW,CAAC;IACrD,CAAC;IASD,OAAO,CACL,OAAgB,EAChB,QAA2F,EAC3F,OAA6B;QAE7B,IAAI,CAAC,2BAA2B,CAAC,WAAW,EAAE,EAAE,CAAC;YAE/C,MAAM,KAAK,GAAG,2BAA2B,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC7E,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACtB,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACvC,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;YACf,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACvB,CAAC;QACH,CAAC,EACD;YACE,IAAI,EAAE,OAAO,EAAE,IAAI;YACnB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,KAAK;YACxC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;SACnC,CACF,CAAC;QAEF,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE1B,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC5B,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC;IASD,UAAU,CACR,QAA2B,EAC3B,QAA2F,EAC3F,OAA6B;QAE7B,IAAI,CAAC,2BAA2B,CAAC,WAAW,EAAE,EAAE,CAAC;YAE/C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,2BAA2B,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC7E,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACxB,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,GAAS,EAAE,GAAE,CAAC;gBACvB,QAAQ,EAAE,IAAI;aACf,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACvC,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;YACf,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACvB,CAAC;QACH,CAAC,EACD;YACE,IAAI,EAAE,OAAO,EAAE,IAAI;YACnB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,KAAK;YACxC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;SACnC,CACF,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO;YACL,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE;YACpC,QAAQ;SACT,CAAC;IACJ,CAAC;IAYD,WAAW,CAAC,OAAgB,EAAE,OAA6B;QACzD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,2BAA2B,CAAC,WAAW,EAAE,EAAE,CAAC;gBAE/C,OAAO,CAAC,2BAA2B,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;gBACxE,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACvC,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;gBACf,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;oBAC5B,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;wBACzB,GAAG,CAAC,UAAU,EAAE,CAAC;wBACjB,OAAO,CAAC,KAAK,CAAC,CAAC;wBACf,OAAO;oBACT,CAAC;gBACH,CAAC;YACH,CAAC,EACD;gBACE,IAAI,EAAE,OAAO,EAAE,IAAI;gBACnB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,KAAK;gBACxC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;aACnC,CACF,CAAC;YAEF,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAWD,QAAQ,CACN,QAAqB,EACrB,MAA4B,EAC5B,OAA6B;QAE7B,IAAI,CAAC,2BAA2B,CAAC,WAAW,EAAE,EAAE,CAAC;YAE/C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,CAAC,OAAO,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACvC,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;YACf,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;oBACzB,MAAM,CAAC,KAAK,CAAC,MAAW,CAAC,CAAC;oBAC1B,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC,EACD;YACE,IAAI,EAAE,OAAO,EAAE,IAAI;YACnB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,MAAM;YACzC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;SACnC,CACF,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC;IASD,eAAe,CACb,OAAgB,EAChB,QAAmE,EACnE,KAAK,GAAG,EAAE;QAEV,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAE1E,OAAO,2BAA2B,CAAC,OAAO,CACxC,OAAO,EACP,CAAC,KAAK,EAAE,EAAE;YACR,QAAQ,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC,EACD,EAAE,SAAS,EAAE,UAAU,EAAE,CAC1B,CAAC;IACJ,CAAC;IASD,cAAc,CACZ,QAAiB,EACjB,QAAoC,EACpC,OAA6B;QAE7B,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,OAAO,2BAA2B,CAAC,OAAO,CACxC,QAAQ,EACR,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrC,OAAO,GAAG,IAAI,CAAC;gBACf,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;oBAC5C,OAAO,GAAG,KAAK,CAAC;gBAClB,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,EACD;YACE,IAAI,EAAE,OAAO,EAAE,IAAI;YACnB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,OAAO;YAC1C,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;SACnC,CACF,CAAC;IACJ,CAAC;IAUD,mBAAmB,CAAC,MAAe,EAAE,cAAuB;QAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAC5C,OAAO;YACL,MAAM;YACN,cAAc;YACd,iBAAiB,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,kBAAkB,EAAE,IAAI;YACxB,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE;YACvD,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE;SACxB,CAAC;IACJ,CAAC;CACO,CAAC"}

package/dist/observe/MutationObserverWrapper.d.ts

@@ -0,0 +1,26 @@
+import type { CleanupFn } from '../core';
+export interface MutationOptions {
+    readonly attributes?: boolean;
+    readonly childList?: boolean;
+    readonly characterData?: boolean;
+    readonly subtree?: boolean;
+    readonly attributeOldValue?: boolean;
+    readonly characterDataOldValue?: boolean;
+    readonly attributeFilter?: readonly string[];
+}
+export interface ObserveResult {
+    readonly cleanup: CleanupFn;
+    readonly observer: MutationObserver | null;
+    readonly takeRecords: () => MutationRecord[];
+}
+export declare const MutationObserverWrapper: {
+    readonly isSupported: () => boolean;
+    readonly observe: (node: Node, callback: (mutations: MutationRecord[], observer: MutationObserver | null) => void, options?: MutationOptions) => ObserveResult;
+    readonly onAttributeChange: (element: Element, callback: (attributeName: string, newValue: string | null, oldValue: string | null, target: Element) => void, attributeFilter?: readonly string[]) => CleanupFn;
+    readonly onChildChange: (element: Element, callback: (addedNodes: Node[], removedNodes: Node[], target: Node) => void, subtree?: boolean) => CleanupFn;
+    readonly onTextChange: (node: Node, callback: (newValue: string | null, oldValue: string | null, target: Node) => void, subtree?: boolean) => CleanupFn;
+    readonly onClassChange: (element: Element, className: string, callback: (hasClass: boolean) => void) => CleanupFn;
+    readonly onElementAdded: (parent: Element, selector: string, callback: (element: Element) => void) => CleanupFn;
+    readonly onElementRemoved: (parent: Element, selector: string, callback: (element: Element) => void) => CleanupFn;
+};
+//# sourceMappingURL=MutationObserverWrapper.d.ts.map

package/dist/observe/MutationObserverWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutationObserverWrapper.d.ts","sourceRoot":"","sources":["../../src/observe/MutationObserverWrapper.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,WAAW,eAAe;IAK9B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAM9B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAM7B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAMjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAM3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAMrC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAKzC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,aAAa;IAI5B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAM5B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAK3C,QAAQ,CAAC,WAAW,EAAE,MAAM,cAAc,EAAE,CAAC;CAC9C;AAED,eAAO,MAAM,uBAAuB;gCAQnB,OAAO;6BAYd,IAAI,YACA,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,YACxE,eAAe,KACxB,aAAa;0CAqDL,OAAO,YACN,CACR,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,OAAO,KACZ,IAAI,oBACS,SAAS,MAAM,EAAE,KAClC,SAAS;sCAkCD,OAAO,YACN,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,KAAK,IAAI,wBAEzE,SAAS;kCA+BJ,IAAI,YACA,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,KAAK,IAAI,wBAEjF,SAAS;sCA4BD,OAAO,aACL,MAAM,YACP,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,KACpC,SAAS;sCA0BF,OAAO,YACL,MAAM,YACN,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,KACnC,SAAS;wCA2BF,OAAO,YACL,MAAM,YACN,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,KACnC,SAAS;CAkBJ,CAAC"}