@zappzarapp/browser-utils 1.0.0

package/dist/encryption/EncryptedStorage.d.ts

@@ -0,0 +1,56 @@
+export interface EncryptedStorageConfig {
+    readonly password: string;
+    readonly prefix?: string;
+    readonly iterations?: number;
+    readonly minCharacterClasses?: number;
+    readonly storage?: Storage;
+}
+export interface EncryptedStorageStats {
+    readonly count: number;
+    readonly prefix: string;
+    readonly iterations: number;
+    readonly isDestroyed: boolean;
+}
+export interface EncryptedStorageInstance {
+    set<T>(key: string, value: T): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    has(key: string): boolean;
+    remove(key: string): void;
+    clear(): void;
+    keys(): readonly string[];
+    stats(): EncryptedStorageStats;
+    destroy(): void;
+}
+export declare class EncryptedStorage implements EncryptedStorageInstance {
+    private readonly storage;
+    private readonly prefix;
+    private readonly iterations;
+    private cryptoKey;
+    private destroyed;
+    private constructor();
+    static create(config: EncryptedStorageConfig): Promise<EncryptedStorage>;
+    static isCryptoAvailable(): boolean;
+    set<T>(key: string, value: T): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    has(key: string): boolean;
+    remove(key: string): void;
+    clear(): void;
+    keys(): readonly string[];
+    stats(): EncryptedStorageStats;
+    destroy(): void;
+    private ensureNotDestroyed;
+    private validateKey;
+    private getFullKey;
+    private getSaltKey;
+    private static validateConfig;
+    private static countCharacterClasses;
+    private static getDefaultStorage;
+    private static getOrCreateSalt;
+    private static deriveKey;
+    private static isValidEntry;
+    private static isQuotaError;
+    private static arrayBufferToBase64;
+    private static base64ToArrayBuffer;
+    private static toBufferSource;
+}
+//# sourceMappingURL=EncryptedStorage.d.ts.map

package/dist/encryption/EncryptedStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EncryptedStorage.d.ts","sourceRoot":"","sources":["../../src/encryption/EncryptedStorage.ts"],"names":[],"mappings":"AAyEA,MAAM,WAAW,sBAAsB;IAKrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAM1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAOzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAQ7B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAMtC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAiBD,MAAM,WAAW,qBAAqB;IAEpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAKD,MAAM,WAAW,wBAAwB;IAIvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAK7C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAKvC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAK1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAK1B,KAAK,IAAI,IAAI,CAAC;IAKd,IAAI,IAAI,SAAS,MAAM,EAAE,CAAC;IAK1B,KAAK,IAAI,qBAAqB,CAAC;IAK/B,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD,qBAAa,gBAAiB,YAAW,wBAAwB;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,SAAS,CAAkB;IAEnC,OAAO;WAmBM,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyB9E,MAAM,CAAC,iBAAiB,IAAI,OAAO;IAsB7B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsD5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAkD5C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAczB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAWzB,KAAK,IAAI,IAAI;IAwBb,IAAI,IAAI,SAAS,MAAM,EAAE;IAmBzB,KAAK,IAAI,qBAAqB;IAmB9B,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,MAAM,CAAC,cAAc;IAmC7B,OAAO,CAAC,MAAM,CAAC,qBAAqB;IASpC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA4BhC,OAAO,CAAC,MAAM,CAAC,eAAe;mBAkBT,SAAS;IAkC9B,OAAO,CAAC,MAAM,CAAC,YAAY;IAa3B,OAAO,CAAC,MAAM,CAAC,YAAY;IAY3B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAYlC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAalC,OAAO,CAAC,MAAM,CAAC,cAAc;CAM9B"}

package/dist/encryption/EncryptedStorage.js

@@ -0,0 +1,287 @@
+import { EncryptionError, Validator, ValidationError } from '../core';
+const DEFAULT_ITERATIONS = 600_000;
+const MIN_ITERATIONS = 10_000;
+const SALT_LENGTH = 16;
+const IV_LENGTH = 12;
+const AES_KEY_LENGTH = 256;
+const SALT_SUFFIX = '__salt__';
+export class EncryptedStorage {
+    storage;
+    prefix;
+    iterations;
+    cryptoKey;
+    destroyed = false;
+    constructor(storage, prefix, iterations, cryptoKey) {
+        this.storage = storage;
+        this.prefix = prefix;
+        this.iterations = iterations;
+        this.cryptoKey = cryptoKey;
+    }
+    static async create(config) {
+        if (!EncryptedStorage.isCryptoAvailable()) {
+            throw EncryptionError.cryptoUnavailable();
+        }
+        EncryptedStorage.validateConfig(config);
+        const storage = config.storage ?? EncryptedStorage.getDefaultStorage();
+        const prefix = config.prefix ?? 'encrypted';
+        const iterations = config.iterations ?? DEFAULT_ITERATIONS;
+        const salt = EncryptedStorage.getOrCreateSalt(storage, prefix);
+        const cryptoKey = await EncryptedStorage.deriveKey(config.password, salt, iterations);
+        return new EncryptedStorage(storage, prefix, iterations, cryptoKey);
+    }
+    static isCryptoAvailable() {
+        const cryptoApi = globalThis.crypto;
+        if (typeof cryptoApi === 'undefined') {
+            return false;
+        }
+        return (typeof cryptoApi.subtle !== 'undefined' && typeof cryptoApi.getRandomValues === 'function');
+    }
+    async set(key, value) {
+        this.ensureNotDestroyed();
+        this.validateKey(key);
+        try {
+            const plaintext = JSON.stringify(value);
+            const iv = crypto.getRandomValues(new Uint8Array(IV_LENGTH));
+            const encodedPlaintext = new TextEncoder().encode(plaintext);
+            const ciphertext = await crypto.subtle.encrypt({ name: 'AES-GCM', iv }, this.cryptoKey, encodedPlaintext);
+            const entry = {
+                iv: EncryptedStorage.arrayBufferToBase64(iv),
+                data: EncryptedStorage.arrayBufferToBase64(ciphertext),
+                timestamp: Date.now(),
+            };
+            const fullKey = this.getFullKey(key);
+            try {
+                this.storage.setItem(fullKey, JSON.stringify(entry));
+            }
+            catch (error) {
+                if (EncryptedStorage.isQuotaError(error)) {
+                    throw EncryptionError.quotaExceeded(key, error);
+                }
+                throw error;
+            }
+        }
+        catch (error) {
+            if (error instanceof EncryptionError) {
+                throw error;
+            }
+            throw EncryptionError.encryptionFailed(key, error);
+        }
+    }
+    async get(key) {
+        this.ensureNotDestroyed();
+        this.validateKey(key);
+        const fullKey = this.getFullKey(key);
+        const raw = this.storage.getItem(fullKey);
+        if (raw === null) {
+            return null;
+        }
+        try {
+            const entry = JSON.parse(raw);
+            if (!EncryptedStorage.isValidEntry(entry)) {
+                throw EncryptionError.invalidDataFormat(key, 'missing required fields');
+            }
+            const ivBytes = EncryptedStorage.base64ToArrayBuffer(entry.iv);
+            const ciphertextBytes = EncryptedStorage.base64ToArrayBuffer(entry.data);
+            const plaintext = await crypto.subtle.decrypt({ name: 'AES-GCM', iv: EncryptedStorage.toBufferSource(ivBytes) }, this.cryptoKey, EncryptedStorage.toBufferSource(ciphertextBytes));
+            const decoded = new TextDecoder().decode(plaintext);
+            return JSON.parse(decoded);
+        }
+        catch (error) {
+            if (error instanceof EncryptionError) {
+                throw error;
+            }
+            throw EncryptionError.decryptionFailed(key, error);
+        }
+    }
+    has(key) {
+        this.ensureNotDestroyed();
+        this.validateKey(key);
+        const fullKey = this.getFullKey(key);
+        return this.storage.getItem(fullKey) !== null;
+    }
+    remove(key) {
+        this.ensureNotDestroyed();
+        this.validateKey(key);
+        const fullKey = this.getFullKey(key);
+        this.storage.removeItem(fullKey);
+    }
+    clear() {
+        this.ensureNotDestroyed();
+        const keysToRemove = [];
+        const prefixWithDot = `${this.prefix}.`;
+        const saltKey = this.getSaltKey();
+        for (let i = 0; i < this.storage.length; i++) {
+            const key = this.storage.key(i);
+            if (key !== null && key.startsWith(prefixWithDot) && key !== saltKey) {
+                keysToRemove.push(key);
+            }
+        }
+        for (const key of keysToRemove) {
+            this.storage.removeItem(key);
+        }
+    }
+    keys() {
+        this.ensureNotDestroyed();
+        const result = [];
+        const prefixWithDot = `${this.prefix}.`;
+        for (let i = 0; i < this.storage.length; i++) {
+            const key = this.storage.key(i);
+            if (key !== null && key.startsWith(prefixWithDot) && !key.endsWith(SALT_SUFFIX)) {
+                result.push(key.slice(prefixWithDot.length));
+            }
+        }
+        return result;
+    }
+    stats() {
+        return {
+            count: this.destroyed ? 0 : this.keys().length,
+            prefix: this.prefix,
+            iterations: this.iterations,
+            isDestroyed: this.destroyed,
+        };
+    }
+    destroy() {
+        this.cryptoKey = null;
+        this.destroyed = true;
+    }
+    ensureNotDestroyed() {
+        if (this.destroyed) {
+            throw EncryptionError.alreadyDestroyed();
+        }
+    }
+    validateKey(key) {
+        Validator.storageKey(key);
+    }
+    getFullKey(key) {
+        return `${this.prefix}.${key}`;
+    }
+    getSaltKey() {
+        return `${this.prefix}${SALT_SUFFIX}`;
+    }
+    static validateConfig(config) {
+        if (config.password.length < 12) {
+            throw ValidationError.invalidFormat('password', '(hidden)', 'at least 12 characters');
+        }
+        const minClasses = config.minCharacterClasses ?? 2;
+        if (!Number.isInteger(minClasses) || minClasses < 1 || minClasses > 4) {
+            throw ValidationError.outOfRange('minCharacterClasses', minClasses, 1, 4);
+        }
+        const classCount = EncryptedStorage.countCharacterClasses(config.password);
+        if (classCount < minClasses) {
+            throw ValidationError.insufficientComplexity('password', classCount, minClasses);
+        }
+        if (config.prefix !== undefined) {
+            Validator.storagePrefix(config.prefix);
+        }
+        if (config.iterations !== undefined &&
+            (!Number.isInteger(config.iterations) || config.iterations < MIN_ITERATIONS)) {
+            throw ValidationError.outOfRange('iterations', config.iterations, MIN_ITERATIONS, Infinity);
+        }
+    }
+    static countCharacterClasses(value) {
+        let count = 0;
+        if (/[a-z]/.test(value))
+            count++;
+        if (/[A-Z]/.test(value))
+            count++;
+        if (/\d/.test(value))
+            count++;
+        if (/[^a-zA-Z\d]/.test(value))
+            count++;
+        return count;
+    }
+    static getDefaultStorage() {
+        let storage;
+        try {
+            storage = localStorage;
+            if (typeof storage === 'undefined') {
+                throw EncryptionError.storageUnavailable('localStorage is not available');
+            }
+        }
+        catch (error) {
+            if (error instanceof EncryptionError) {
+                throw error;
+            }
+            throw EncryptionError.storageUnavailable('localStorage is not available');
+        }
+        try {
+            const testKey = '__encryption_test__';
+            storage.setItem(testKey, '1');
+            storage.removeItem(testKey);
+        }
+        catch {
+            throw EncryptionError.storageUnavailable('localStorage is not accessible');
+        }
+        return storage;
+    }
+    static getOrCreateSalt(storage, prefix) {
+        const saltKey = `${prefix}${SALT_SUFFIX}`;
+        const existingSalt = storage.getItem(saltKey);
+        if (existingSalt !== null) {
+            try {
+                return EncryptedStorage.base64ToArrayBuffer(existingSalt);
+            }
+            catch {
+            }
+        }
+        const salt = crypto.getRandomValues(new Uint8Array(SALT_LENGTH));
+        storage.setItem(saltKey, EncryptedStorage.arrayBufferToBase64(salt));
+        return salt;
+    }
+    static async deriveKey(password, salt, iterations) {
+        try {
+            const passwordBuffer = new TextEncoder().encode(password);
+            const keyMaterial = await crypto.subtle.importKey('raw', EncryptedStorage.toBufferSource(passwordBuffer), 'PBKDF2', false, ['deriveKey']);
+            return await crypto.subtle.deriveKey({
+                name: 'PBKDF2',
+                salt: EncryptedStorage.toBufferSource(salt),
+                iterations,
+                hash: 'SHA-256',
+            }, keyMaterial, { name: 'AES-GCM', length: AES_KEY_LENGTH }, false, ['encrypt', 'decrypt']);
+        }
+        catch (error) {
+            throw EncryptionError.keyDerivationFailed(error);
+        }
+    }
+    static isValidEntry(entry) {
+        if (typeof entry !== 'object' || entry === null) {
+            return false;
+        }
+        const obj = entry;
+        return (typeof obj.iv === 'string' &&
+            typeof obj.data === 'string' &&
+            typeof obj.timestamp === 'number');
+    }
+    static isQuotaError(error) {
+        if (!(error instanceof Error)) {
+            return false;
+        }
+        return (error.name === 'QuotaExceededError' ||
+            error.name === 'NS_ERROR_DOM_QUOTA_REACHED' ||
+            error.message.toLowerCase().includes('quota'));
+    }
+    static arrayBufferToBase64(buffer) {
+        const bytes = ArrayBuffer.isView(buffer)
+            ? new Uint8Array(buffer.buffer)
+            : new Uint8Array(buffer);
+        let binary = '';
+        for (let i = 0; i < bytes.byteLength; i++) {
+            binary += String.fromCharCode(bytes[i]);
+        }
+        return btoa(binary);
+    }
+    static base64ToArrayBuffer(base64) {
+        const binary = atob(base64);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+        return bytes;
+    }
+    static toBufferSource(data) {
+        const buffer = new ArrayBuffer(data.byteLength);
+        new Uint8Array(buffer).set(data);
+        return buffer;
+    }
+}
+//# sourceMappingURL=EncryptedStorage.js.map

package/dist/encryption/EncryptedStorage.js.map

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

package/dist/encryption/index.d.ts

@@ -0,0 +1,3 @@
+export { EncryptedStorage } from './EncryptedStorage.js';
+export type { EncryptedStorageConfig, EncryptedStorageStats, EncryptedStorageInstance, } from './EncryptedStorage.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/encryption/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/encryption/index.js

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

package/dist/encryption/index.js.map

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

package/dist/events/Debounce.d.ts

@@ -0,0 +1,13 @@
+export interface DebounceOptions {
+    readonly leading?: boolean;
+    readonly trailing?: boolean;
+    readonly maxWait?: number;
+}
+export interface DebouncedFunction<T extends (...args: any[]) => any> {
+    (...args: Parameters<T>): ReturnType<T> | undefined;
+    cancel(): void;
+    flush(): ReturnType<T> | undefined;
+    pending(): boolean;
+}
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, wait: number, options?: DebounceOptions): DebouncedFunction<T>;
+//# sourceMappingURL=Debounce.d.ts.map

package/dist/events/Debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Debounce.d.ts","sourceRoot":"","sources":["../../src/events/Debounce.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,eAAe;IAK9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAM3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAM5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAGD,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG;IAIlE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAKpD,MAAM,IAAI,IAAI,CAAC;IAMf,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAKnC,OAAO,IAAI,OAAO,CAAC;CACpB;AAWD,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,eAAoB,GAC5B,iBAAiB,CAAC,CAAC,CAAC,CAsKtB"}

package/dist/events/Debounce.js

@@ -0,0 +1,121 @@
+export function debounce(fn, wait, options = {}) {
+    const { leading = false, trailing = true, maxWait } = options;
+    let timeoutId;
+    let maxTimeoutId;
+    let lastArgs;
+    let lastThis;
+    let result;
+    let lastCallTime;
+    let lastInvokeTime = 0;
+    const invokeFunc = (time) => {
+        const args = lastArgs;
+        const thisArg = lastThis;
+        lastArgs = undefined;
+        lastThis = undefined;
+        lastInvokeTime = time;
+        if (args !== undefined) {
+            result = fn.apply(thisArg, args);
+        }
+        return result;
+    };
+    const startTimer = (pendingFunc, waitTime) => {
+        return setTimeout(pendingFunc, waitTime);
+    };
+    const cancelTimer = (id) => {
+        if (id !== undefined) {
+            clearTimeout(id);
+        }
+    };
+    const leadingEdge = (time) => {
+        lastInvokeTime = time;
+        timeoutId = startTimer(timerExpired, wait);
+        if (maxWait !== undefined) {
+            maxTimeoutId = startTimer(maxWaitExpired, maxWait);
+        }
+        return leading ? invokeFunc(time) : result;
+    };
+    const remainingWait = (time) => {
+        const timeSinceLastCall = time - (lastCallTime ?? 0);
+        const timeSinceLastInvoke = time - lastInvokeTime;
+        const timeWaiting = wait - timeSinceLastCall;
+        if (maxWait !== undefined) {
+            return Math.min(timeWaiting, maxWait - timeSinceLastInvoke);
+        }
+        return timeWaiting;
+    };
+    const shouldInvoke = (time) => {
+        const timeSinceLastCall = time - (lastCallTime ?? 0);
+        const timeSinceLastInvoke = time - lastInvokeTime;
+        return (lastCallTime === undefined ||
+            timeSinceLastCall >= wait ||
+            timeSinceLastCall < 0 ||
+            (maxWait !== undefined && timeSinceLastInvoke >= maxWait));
+    };
+    const timerExpired = () => {
+        const time = Date.now();
+        if (shouldInvoke(time)) {
+            trailingEdge(time);
+            return;
+        }
+        timeoutId = startTimer(timerExpired, remainingWait(time));
+    };
+    const maxWaitExpired = () => {
+        const time = Date.now();
+        trailingEdge(time);
+    };
+    const trailingEdge = (time) => {
+        cancelTimer(timeoutId);
+        cancelTimer(maxTimeoutId);
+        timeoutId = undefined;
+        maxTimeoutId = undefined;
+        if (trailing && lastArgs !== undefined) {
+            return invokeFunc(time);
+        }
+        lastArgs = undefined;
+        lastThis = undefined;
+        return result;
+    };
+    const cancel = () => {
+        cancelTimer(timeoutId);
+        cancelTimer(maxTimeoutId);
+        lastInvokeTime = 0;
+        lastArgs = undefined;
+        lastCallTime = undefined;
+        lastThis = undefined;
+        timeoutId = undefined;
+        maxTimeoutId = undefined;
+    };
+    const flush = () => {
+        if (timeoutId === undefined) {
+            return result;
+        }
+        return trailingEdge(Date.now());
+    };
+    const pending = () => {
+        return timeoutId !== undefined;
+    };
+    const debounced = function (...args) {
+        const time = Date.now();
+        const isInvoking = shouldInvoke(time);
+        lastArgs = args;
+        lastThis = this;
+        lastCallTime = time;
+        if (isInvoking) {
+            if (timeoutId === undefined) {
+                return leadingEdge(lastCallTime);
+            }
+            if (maxWait !== undefined) {
+                cancelTimer(timeoutId);
+                timeoutId = startTimer(timerExpired, wait);
+                return invokeFunc(lastCallTime);
+            }
+        }
+        timeoutId ??= startTimer(timerExpired, wait);
+        return result;
+    };
+    debounced.cancel = cancel;
+    debounced.flush = flush;
+    debounced.pending = pending;
+    return debounced;
+}
+//# sourceMappingURL=Debounce.js.map

package/dist/events/Debounce.js.map

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

package/dist/events/EventUtils.d.ts

@@ -0,0 +1,19 @@
+import type { CleanupFn } from '../core/types.js';
+export declare const EventUtils: {
+    readonly once: (target: EventTarget, event: string, handler: (event: Event) => void, options?: AddEventListenerOptions) => CleanupFn;
+    readonly delegate: (container: Element, selector: string, event: string, handler: (event: Event, target: Element) => void, options?: AddEventListenerOptions) => CleanupFn;
+    readonly onOutsideClick: (element: Element, handler: (event: MouseEvent) => void, options?: {
+        touch?: boolean;
+        exclude?: Element[];
+    }) => CleanupFn;
+    readonly onKey: (target: EventTarget, key: string, handler: (event: KeyboardEvent) => void, options?: {
+        capture?: boolean;
+        ctrl?: boolean;
+        shift?: boolean;
+        alt?: boolean;
+        meta?: boolean;
+        preventDefault?: boolean;
+    }) => CleanupFn;
+    readonly on: (target: EventTarget, events: string[], handler: (event: Event) => void, options?: AddEventListenerOptions) => CleanupFn;
+};
+//# sourceMappingURL=EventUtils.d.ts.map

package/dist/events/EventUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventUtils.d.ts","sourceRoot":"","sources":["../../src/events/EventUtils.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,eAAO,MAAM,UAAU;4BAcX,WAAW,SACZ,MAAM,WACJ,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,YACrB,uBAAuB,KAChC,SAAS;mCA2BC,OAAO,YACR,MAAM,SACT,MAAM,WACJ,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,YACtC,uBAAuB,KAChC,SAAS;uCA+BD,OAAO,WACP,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,YAC1B;QACR,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;KACrB,KACA,SAAS;6BAgEF,WAAW,OACd,MAAM,WACF,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,YAC7B;QACR,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,KACA,SAAS;0BAkDF,WAAW,UACX,MAAM,EAAE,WACP,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,YACrB,uBAAuB,KAChC,SAAS;CAWJ,CAAC"}

package/dist/events/EventUtils.js

@@ -0,0 +1,95 @@
+export const EventUtils = {
+    once(target, event, handler, options) {
+        const wrappedHandler = (e) => {
+            target.removeEventListener(event, wrappedHandler, options);
+            handler(e);
+        };
+        target.addEventListener(event, wrappedHandler, options);
+        return () => {
+            target.removeEventListener(event, wrappedHandler, options);
+        };
+    },
+    delegate(container, selector, event, handler, options) {
+        const delegateHandler = (e) => {
+            const eventTarget = e.target;
+            const matchedTarget = eventTarget?.closest(selector);
+            if (matchedTarget != null && container.contains(matchedTarget)) {
+                handler(e, matchedTarget);
+            }
+        };
+        container.addEventListener(event, delegateHandler, options);
+        return () => {
+            container.removeEventListener(event, delegateHandler, options);
+        };
+    },
+    onOutsideClick(element, handler, options) {
+        const { touch = false, exclude = [] } = options ?? {};
+        const isOutside = (event) => {
+            const target = event.target;
+            if (target === null)
+                return false;
+            if (element.contains(target))
+                return false;
+            for (const excluded of exclude) {
+                if (excluded.contains(target))
+                    return false;
+            }
+            return true;
+        };
+        const clickHandler = (event) => {
+            if (isOutside(event)) {
+                handler(event);
+            }
+        };
+        const touchHandler = (event) => {
+            if (isOutside(event)) {
+                handler(event);
+            }
+        };
+        document.addEventListener('click', clickHandler, true);
+        if (touch) {
+            document.addEventListener('touchstart', touchHandler, true);
+        }
+        return () => {
+            document.removeEventListener('click', clickHandler, true);
+            if (touch) {
+                document.removeEventListener('touchstart', touchHandler, true);
+            }
+        };
+    },
+    onKey(target, key, handler, options) {
+        const { capture = false, ctrl = false, shift = false, alt = false, meta = false, preventDefault = false, } = options ?? {};
+        const keyHandler = (e) => {
+            const event = e;
+            if (event.key !== key)
+                return;
+            if (ctrl && !event.ctrlKey)
+                return;
+            if (shift && !event.shiftKey)
+                return;
+            if (alt && !event.altKey)
+                return;
+            if (meta && !event.metaKey)
+                return;
+            if (preventDefault) {
+                event.preventDefault();
+            }
+            handler(event);
+        };
+        target.addEventListener('keydown', keyHandler, { capture });
+        return () => {
+            target.removeEventListener('keydown', keyHandler, { capture });
+        };
+    },
+    on(target, events, handler, options) {
+        for (const event of events) {
+            target.addEventListener(event, handler, options);
+        }
+        return () => {
+            for (const event of events) {
+                target.removeEventListener(event, handler, options);
+            }
+        };
+    },
+};
+//# sourceMappingURL=EventUtils.js.map

package/dist/events/EventUtils.js.map

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