zcw-shared 1.21.0 → 1.23.0

package/dist/functions/array-object/omit.js

@@ -0,0 +1,8 @@
+export function omit(obj, keys) {
+    const result = { ...obj };
+    for (const key of keys) {
+        delete result[key];
+    }
+    return result;
+}
+//# sourceMappingURL=omit.js.map

package/dist/functions/array-object/omit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit.js","sourceRoot":"","sources":["../../../src/functions/array-object/omit.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,IAAI,CAClB,GAAM,EACN,IAAS;IAET,MAAM,MAAM,GAAG,EAAE,GAAG,GAAG,EAAS,CAAA;IAEhC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;IACpB,CAAC;IAED,OAAO,MAAoB,CAAA;AAC7B,CAAC"}

package/dist/functions/array-object/pick.d.ts

@@ -0,0 +1 @@
+export declare function pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;

package/dist/functions/array-object/pick.js

@@ -0,0 +1,10 @@
+export function pick(obj, keys) {
+    const result = {};
+    for (const key of keys) {
+        if (key in obj) {
+            result[key] = obj[key];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=pick.js.map

package/dist/functions/array-object/pick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.js","sourceRoot":"","sources":["../../../src/functions/array-object/pick.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,IAAI,CAClB,GAAM,EACN,IAAS;IAET,MAAM,MAAM,GAAG,EAAgB,CAAA;IAE/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;YACf,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QACxB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/functions/array-object/shuffle.d.ts

@@ -0,0 +1 @@
+export declare function shuffle<T>(array: T[]): T[];

package/dist/functions/array-object/shuffle.js

@@ -0,0 +1,9 @@
+export function shuffle(array) {
+    const result = [...array];
+    for (let i = result.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [result[i], result[j]] = [result[j], result[i]];
+    }
+    return result;
+}
+//# sourceMappingURL=shuffle.js.map

package/dist/functions/array-object/shuffle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.js","sourceRoot":"","sources":["../../../src/functions/array-object/shuffle.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,OAAO,CAAI,KAAU;IACnC,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;IAEzB,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAC5C;QAAA,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAClD,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/functions/array-object/sortBy.d.ts

@@ -0,0 +1 @@
+export declare function sortBy<T>(array: T[], keyOrFn: keyof T | ((item: T) => any), order?: 'asc' | 'desc'): T[];

package/dist/functions/array-object/sortBy.js

@@ -0,0 +1,13 @@
+export function sortBy(array, keyOrFn, order = 'asc') {
+    const sorted = [...array].sort((a, b) => {
+        const aValue = typeof keyOrFn === 'function' ? keyOrFn(a) : a[keyOrFn];
+        const bValue = typeof keyOrFn === 'function' ? keyOrFn(b) : b[keyOrFn];
+        if (aValue < bValue)
+            return order === 'asc' ? -1 : 1;
+        if (aValue > bValue)
+            return order === 'asc' ? 1 : -1;
+        return 0;
+    });
+    return sorted;
+}
+//# sourceMappingURL=sortBy.js.map

package/dist/functions/array-object/sortBy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortBy.js","sourceRoot":"","sources":["../../../src/functions/array-object/sortBy.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,MAAM,CACpB,KAAU,EACV,OAAqC,EACrC,QAAwB,KAAK;IAE7B,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACtE,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAEtE,IAAI,MAAM,GAAG,MAAM;YAAE,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACpD,IAAI,MAAM,GAAG,MAAM;YAAE,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACpD,OAAO,CAAC,CAAA;IACV,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/functions/async/cachedAsync.d.ts

@@ -0,0 +1,27 @@
+import { LRUCache } from '../data-structures/LRUCache';
+export interface CachedAsyncOptions {
+    keyGenerator?: (...args: any[]) => string;
+    ttl?: number;
+    maxSize?: number;
+    cache?: LRUCache<string, any>;
+    cacheErrors?: boolean;
+    debug?: boolean;
+    console?: {
+        log: (...args: any[]) => void;
+        warn: (...args: any[]) => void;
+    };
+}
+export interface CachedAsyncFunction<T extends (...args: any[]) => Promise<any>> {
+    (...args: Parameters<T>): ReturnType<T>;
+    clear: () => void;
+    delete: (...args: Parameters<T>) => void;
+    has: (...args: Parameters<T>) => boolean;
+    getStats: () => {
+        size: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+}
+export declare function cachedAsync<T extends (...args: any[]) => Promise<any>>(fn: T, options?: CachedAsyncOptions): CachedAsyncFunction<T>;
+export declare function createCachedAsyncWithCache(cache: LRUCache<string, any>): <T extends (...args: any[]) => Promise<any>>(fn: T, options?: Omit<CachedAsyncOptions, "cache">) => CachedAsyncFunction<T>;

package/dist/functions/async/cachedAsync.js

@@ -0,0 +1,123 @@
+import { LRUCache } from '../data-structures/LRUCache';
+function defaultKeyGenerator(...args) {
+    try {
+        return JSON.stringify(args);
+    }
+    catch (error) {
+        return args.map(arg => String(arg)).join('_');
+    }
+}
+export function cachedAsync(fn, options = {}) {
+    const { keyGenerator = defaultKeyGenerator, ttl = 0, maxSize = 500, cache: customCache, cacheErrors = false, debug = false, console: customConsole } = options;
+    const cache = customCache || new LRUCache({
+        capacity: maxSize,
+        debug,
+        console: customConsole
+    });
+    const pendingRequests = new Map();
+    let hits = 0;
+    let misses = 0;
+    const log = (message) => {
+        if (debug && customConsole) {
+            customConsole.log(`[CachedAsync] ${message}`);
+        }
+    };
+    const warn = (message) => {
+        if (debug && customConsole) {
+            customConsole.warn(`[CachedAsync] ${message}`);
+        }
+    };
+    function isExpired(entry) {
+        if (!entry.expiresAt) {
+            return false;
+        }
+        return Date.now() > entry.expiresAt;
+    }
+    async function cachedFunction(...args) {
+        const cacheKey = keyGenerator(...args);
+        const cachedEntry = cache.get(cacheKey);
+        if (cachedEntry && !isExpired(cachedEntry)) {
+            hits++;
+            log(`Cache HIT for key: ${cacheKey}`);
+            if (cachedEntry.isError) {
+                throw cachedEntry.value;
+            }
+            return cachedEntry.value;
+        }
+        if (cachedEntry && isExpired(cachedEntry)) {
+            cache.delete(cacheKey);
+            log(`Cache EXPIRED for key: ${cacheKey}`);
+        }
+        misses++;
+        log(`Cache MISS for key: ${cacheKey}`);
+        const pendingRequest = pendingRequests.get(cacheKey);
+        if (pendingRequest) {
+            log(`Reusing pending request for key: ${cacheKey}`);
+            return pendingRequest;
+        }
+        const promise = fn(...args)
+            .then((result) => {
+            const entry = {
+                value: result,
+                expiresAt: ttl > 0 ? Date.now() + ttl : undefined,
+                isError: false
+            };
+            cache.put(cacheKey, entry);
+            log(`Cache SET for key: ${cacheKey}`);
+            pendingRequests.delete(cacheKey);
+            return result;
+        })
+            .catch((error) => {
+            pendingRequests.delete(cacheKey);
+            if (cacheErrors) {
+                const entry = {
+                    value: error,
+                    expiresAt: ttl > 0 ? Date.now() + ttl : undefined,
+                    isError: true
+                };
+                cache.put(cacheKey, entry);
+                log(`Cache SET ERROR for key: ${cacheKey}`);
+            }
+            else {
+                log(`Error not cached for key: ${cacheKey}`);
+            }
+            throw error;
+        });
+        pendingRequests.set(cacheKey, promise);
+        return promise;
+    }
+    cachedFunction.clear = () => {
+        cache.clear();
+        pendingRequests.clear();
+        hits = 0;
+        misses = 0;
+        log('All cache cleared');
+    };
+    cachedFunction.delete = (...args) => {
+        const cacheKey = keyGenerator(...args);
+        cache.delete(cacheKey);
+        pendingRequests.delete(cacheKey);
+        log(`Cache deleted for key: ${cacheKey}`);
+    };
+    cachedFunction.has = (...args) => {
+        const cacheKey = keyGenerator(...args);
+        const entry = cache.get(cacheKey);
+        return entry !== undefined && !isExpired(entry);
+    };
+    cachedFunction.getStats = () => {
+        const totalRequests = hits + misses;
+        return {
+            size: cache.size,
+            hits,
+            misses,
+            hitRate: totalRequests > 0 ? hits / totalRequests : 0
+        };
+    };
+    return cachedFunction;
+}
+export function createCachedAsyncWithCache(cache) {
+    return function (fn, options = {}) {
+        return cachedAsync(fn, { ...options, cache });
+    };
+}
+//# sourceMappingURL=cachedAsync.js.map

package/dist/functions/async/cachedAsync.js.map

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

package/dist/functions/async/promiseLimit.d.ts

@@ -0,0 +1,10 @@
+export type PromiseTask<T> = () => Promise<T>;
+export interface PromiseLimitResult<T> {
+    results: PromiseSettledResult<T>[];
+    successCount: number;
+    failureCount: number;
+    totalTime: number;
+}
+export declare function promiseLimit<T>(tasks: PromiseTask<T>[], limit: number): Promise<PromiseLimitResult<T>>;
+export declare function promiseLimitBatch<T>(tasks: PromiseTask<T>[], limit: number): Promise<PromiseLimitResult<T>>;
+export declare function promiseLimitSemaphore<T>(tasks: PromiseTask<T>[], limit: number): Promise<PromiseLimitResult<T>>;

package/dist/functions/async/promiseLimit.js

@@ -0,0 +1,125 @@
+export async function promiseLimit(tasks, limit) {
+    const startTime = Date.now();
+    const results = [];
+    let currentIndex = 0;
+    let successCount = 0;
+    let failureCount = 0;
+    const executeTask = async (index) => {
+        if (index >= tasks.length) {
+            return;
+        }
+        const task = tasks[index];
+        try {
+            const result = await task();
+            results[index] = {
+                status: 'fulfilled',
+                value: result
+            };
+            successCount++;
+        }
+        catch (error) {
+            results[index] = {
+                status: 'rejected',
+                reason: error
+            };
+            failureCount++;
+        }
+        const nextIndex = currentIndex++;
+        if (nextIndex < tasks.length) {
+            await executeTask(nextIndex);
+        }
+    };
+    const initialTasks = [];
+    for (let i = 0; i < Math.min(limit, tasks.length); i++) {
+        initialTasks.push(executeTask(currentIndex++));
+    }
+    await Promise.all(initialTasks);
+    const totalTime = Date.now() - startTime;
+    return {
+        results,
+        successCount,
+        failureCount,
+        totalTime
+    };
+}
+export async function promiseLimitBatch(tasks, limit) {
+    const startTime = Date.now();
+    const results = [];
+    let successCount = 0;
+    let failureCount = 0;
+    for (let i = 0; i < tasks.length; i += limit) {
+        const batch = tasks.slice(i, i + limit);
+        const batchResults = await Promise.allSettled(batch.map(task => task()));
+        batchResults.forEach(result => {
+            results.push(result);
+            if (result.status === 'fulfilled') {
+                successCount++;
+            }
+            else {
+                failureCount++;
+            }
+        });
+    }
+    const totalTime = Date.now() - startTime;
+    return {
+        results,
+        successCount,
+        failureCount,
+        totalTime
+    };
+}
+export async function promiseLimitSemaphore(tasks, limit) {
+    const startTime = Date.now();
+    let activeCount = 0;
+    const results = [];
+    let successCount = 0;
+    let failureCount = 0;
+    const waitQueue = [];
+    const acquire = () => {
+        if (activeCount < limit) {
+            activeCount++;
+            return Promise.resolve();
+        }
+        return new Promise(resolve => {
+            waitQueue.push(resolve);
+        });
+    };
+    const release = () => {
+        activeCount--;
+        if (waitQueue.length > 0) {
+            const resolve = waitQueue.shift();
+            activeCount++;
+            resolve();
+        }
+    };
+    const promises = tasks.map(async (task, index) => {
+        await acquire();
+        try {
+            const result = await task();
+            results[index] = {
+                status: 'fulfilled',
+                value: result
+            };
+            successCount++;
+        }
+        catch (error) {
+            results[index] = {
+                status: 'rejected',
+                reason: error
+            };
+            failureCount++;
+        }
+        finally {
+            release();
+        }
+    });
+    await Promise.all(promises);
+    const totalTime = Date.now() - startTime;
+    return {
+        results,
+        successCount,
+        failureCount,
+        totalTime
+    };
+}
+//# sourceMappingURL=promiseLimit.js.map

package/dist/functions/async/promiseLimit.js.map

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

package/dist/functions/async/retryWithBackoff.d.ts

@@ -0,0 +1,12 @@
+import type { setTimeout } from '../../../references/timer.d';
+export declare function retryWithBackoff<T extends (...args: any[]) => Promise<any>>(fn: T, options: {
+    maxAttempts?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+    backoffMultiplier?: number;
+    jitter?: boolean;
+    shouldRetry?: (error: any, attempt: number) => boolean;
+    onRetry?: (error: any, attempt: number, delay: number) => void;
+} | undefined, host: {
+    setTimeout: typeof setTimeout;
+}): T;

package/dist/functions/async/retryWithBackoff.js

@@ -0,0 +1,29 @@
+export function retryWithBackoff(fn, options = {}, host) {
+    const { maxAttempts = 3, baseDelay = 1000, maxDelay = 10000, backoffMultiplier = 2, jitter = true, shouldRetry, onRetry } = options;
+    return ((...args) => {
+        const attempt = async (attemptNumber) => {
+            try {
+                return await fn(...args);
+            }
+            catch (error) {
+                if (attemptNumber >= maxAttempts) {
+                    throw error;
+                }
+                if (shouldRetry && !shouldRetry(error, attemptNumber)) {
+                    throw error;
+                }
+                const delay = Math.min(baseDelay * Math.pow(backoffMultiplier, attemptNumber - 1), maxDelay);
+                const finalDelay = jitter
+                    ? delay * (0.5 + Math.random() * 0.5)
+                    : delay;
+                if (onRetry) {
+                    onRetry(error, attemptNumber, finalDelay);
+                }
+                await new Promise(resolve => host.setTimeout(resolve, finalDelay));
+                return attempt(attemptNumber + 1);
+            }
+        };
+        return attempt(1);
+    });
+}
+//# sourceMappingURL=retryWithBackoff.js.map

package/dist/functions/async/retryWithBackoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryWithBackoff.js","sourceRoot":"","sources":["../../../src/functions/async/retryWithBackoff.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,gBAAgB,CAC9B,EAAK,EACL,UAQI,EAAE,EACN,IAEC;IAED,MAAM,EACJ,WAAW,GAAG,CAAC,EACf,SAAS,GAAG,IAAI,EAChB,QAAQ,GAAG,KAAK,EAChB,iBAAiB,GAAG,CAAC,EACrB,MAAM,GAAG,IAAI,EACb,WAAW,EACX,OAAO,EACR,GAAG,OAAO,CAAA;IAEX,OAAO,CAAC,CAAC,GAAG,IAAmB,EAA0B,EAAE;QACzD,MAAM,OAAO,GAAG,KAAK,EAAE,aAAqB,EAA0B,EAAE;YACtE,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;YAC1B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAEf,IAAI,aAAa,IAAI,WAAW,EAAE,CAAC;oBACjC,MAAM,KAAK,CAAA;gBACb,CAAC;gBAED,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC;oBACtD,MAAM,KAAK,CAAA;gBACb,CAAC;gBAGD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,aAAa,GAAG,CAAC,CAAC,EAC1D,QAAQ,CACT,CAAA;gBAGD,MAAM,UAAU,GAAG,MAAM;oBACvB,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;oBACrC,CAAC,CAAC,KAAK,CAAA;gBAGT,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,CAAC,CAAA;gBAC3C,CAAC;gBAGD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;gBAGlE,OAAO,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC,CAAA;YACnC,CAAC;QACH,CAAC,CAAA;QAED,OAAO,OAAO,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC,CAAM,CAAA;AACT,CAAC"}

package/dist/functions/browser/detectBrowser.d.ts

@@ -0,0 +1,39 @@
+import type { Navigator } from '../../../references/browser.d';
+export interface DetectBrowserDeps {
+    userAgent: Navigator['userAgent'];
+    innerWidth?: number;
+    innerHeight?: number;
+}
+export interface BrowserInfo {
+    browser: {
+        name: string;
+        version: string;
+        majorVersion: number;
+    };
+    os: {
+        name: string;
+        version: string;
+        platform: string;
+    };
+    device: {
+        type: 'mobile' | 'tablet' | 'desktop';
+        vendor: string;
+        model: string;
+    };
+    engine: {
+        name: string;
+        version: string;
+    };
+    screen: {
+        width: number;
+        height: number;
+    };
+    features: {
+        isMobile: boolean;
+        isTablet: boolean;
+        isDesktop: boolean;
+        isTouchDevice: boolean;
+        isRetina: boolean;
+    };
+}
+export declare function detectBrowser(deps: DetectBrowserDeps): BrowserInfo;

package/dist/functions/browser/detectBrowser.js

@@ -0,0 +1,193 @@
+export function detectBrowser(deps) {
+    const ua = deps.userAgent;
+    const uaLower = ua.toLowerCase();
+    const result = {
+        browser: {
+            name: 'Unknown',
+            version: '0.0.0',
+            majorVersion: 0
+        },
+        os: {
+            name: 'Unknown',
+            version: '0.0',
+            platform: 'unknown'
+        },
+        device: {
+            type: 'desktop',
+            vendor: 'Unknown',
+            model: 'Unknown'
+        },
+        engine: {
+            name: 'Unknown',
+            version: '0.0'
+        },
+        screen: {
+            width: deps.innerWidth || 0,
+            height: deps.innerHeight || 0
+        },
+        features: {
+            isMobile: false,
+            isTablet: false,
+            isDesktop: true,
+            isTouchDevice: false,
+            isRetina: false
+        }
+    };
+    if (uaLower.includes('edg/')) {
+        result.browser.name = 'Edge';
+        const match = uaLower.match(/edg\/([\d.]+)/);
+        if (match) {
+            result.browser.version = match[1];
+            result.browser.majorVersion = parseInt(match[1]);
+        }
+        result.engine.name = 'Blink';
+    }
+    else if (uaLower.includes('chrome/') && !uaLower.includes('edg/')) {
+        result.browser.name = 'Chrome';
+        const match = uaLower.match(/chrome\/([\d.]+)/);
+        if (match) {
+            result.browser.version = match[1];
+            result.browser.majorVersion = parseInt(match[1]);
+        }
+        result.engine.name = 'Blink';
+    }
+    else if (uaLower.includes('firefox/')) {
+        result.browser.name = 'Firefox';
+        const match = uaLower.match(/firefox\/([\d.]+)/);
+        if (match) {
+            result.browser.version = match[1];
+            result.browser.majorVersion = parseInt(match[1]);
+        }
+        result.engine.name = 'Gecko';
+    }
+    else if (uaLower.includes('safari/') && !uaLower.includes('chrome/')) {
+        result.browser.name = 'Safari';
+        const match = uaLower.match(/version\/([\d.]+)/);
+        if (match) {
+            result.browser.version = match[1];
+            result.browser.majorVersion = parseInt(match[1]);
+        }
+        result.engine.name = 'WebKit';
+    }
+    else if (uaLower.includes('opera/') || uaLower.includes('opr/')) {
+        result.browser.name = 'Opera';
+        const match = uaLower.match(/(?:opera|opr)\/([\d.]+)/);
+        if (match) {
+            result.browser.version = match[1];
+            result.browser.majorVersion = parseInt(match[1]);
+        }
+        result.engine.name = 'Blink';
+    }
+    if (/iPhone|iPad|iPod/.test(ua)) {
+        result.os.name = 'iOS';
+        result.os.platform = 'ios';
+        const match = ua.match(/OS ([\d_]+)/);
+        if (match) {
+            result.os.version = match[1].replace(/_/g, '.');
+        }
+    }
+    else if (/Android/.test(ua)) {
+        result.os.name = 'Android';
+        result.os.platform = 'android';
+        const match = ua.match(/Android ([\d.]+)/);
+        if (match) {
+            result.os.version = match[1];
+        }
+    }
+    else if (/Mac OS X/.test(ua)) {
+        result.os.name = 'macOS';
+        result.os.platform = 'darwin';
+        const match = ua.match(/Mac OS X ([\d_]+)/);
+        if (match) {
+            result.os.version = match[1].replace(/_/g, '.');
+        }
+    }
+    else if (/Windows/.test(ua)) {
+        result.os.name = 'Windows';
+        result.os.platform = 'win32';
+        if (/Windows NT 10/.test(ua)) {
+            result.os.version = '10';
+        }
+        else if (/Windows NT 6.3/.test(ua)) {
+            result.os.version = '8.1';
+        }
+        else if (/Windows NT 6.2/.test(ua)) {
+            result.os.version = '8';
+        }
+        else if (/Windows NT 6.1/.test(ua)) {
+            result.os.version = '7';
+        }
+    }
+    else if (/Linux/.test(ua)) {
+        result.os.name = 'Linux';
+        result.os.platform = 'linux';
+    }
+    if (/iPad/.test(ua)) {
+        result.device.type = 'tablet';
+        result.device.vendor = 'Apple';
+        result.device.model = 'iPad';
+    }
+    else if (/iPhone/.test(ua)) {
+        result.device.type = 'mobile';
+        result.device.vendor = 'Apple';
+        result.device.model = 'iPhone';
+    }
+    else if (/iPod/.test(ua)) {
+        result.device.type = 'mobile';
+        result.device.vendor = 'Apple';
+        result.device.model = 'iPod';
+    }
+    else if (/Android/.test(ua)) {
+        result.device.type = /Mobile/.test(ua) ? 'mobile' : 'tablet';
+        result.device.vendor = 'Android';
+        const modelMatch = ua.match(/Android.*;\s*([^)]+)\s*Build/);
+        if (modelMatch) {
+            result.device.model = modelMatch[1].trim();
+        }
+        else {
+            result.device.model = 'Android Device';
+        }
+    }
+    else if (/Windows Phone/.test(ua)) {
+        result.device.type = 'mobile';
+        result.device.vendor = 'Microsoft';
+        result.device.model = 'Windows Phone';
+    }
+    else {
+        result.device.type = 'desktop';
+        if (/Mac/.test(ua)) {
+            result.device.vendor = 'Apple';
+            result.device.model = 'Macintosh';
+        }
+        else if (/Windows/.test(ua)) {
+            result.device.vendor = 'Microsoft';
+            result.device.model = 'Windows PC';
+        }
+        else if (/Linux/.test(ua)) {
+            result.device.vendor = 'Linux';
+            result.device.model = 'Linux PC';
+        }
+    }
+    if (result.engine.name === 'Blink' || result.engine.name === 'WebKit') {
+        const match = uaLower.match(/applewebkit\/([\d.]+)/);
+        if (match) {
+            result.engine.version = match[1];
+        }
+    }
+    else if (result.engine.name === 'Gecko') {
+        const match = uaLower.match(/rv:([\d.]+)/);
+        if (match) {
+            result.engine.version = match[1];
+        }
+    }
+    result.features.isMobile = result.device.type === 'mobile';
+    result.features.isTablet = result.device.type === 'tablet';
+    result.features.isDesktop = result.device.type === 'desktop';
+    result.features.isTouchDevice = /touch|android|iphone|ipad|ipod/i.test(uaLower);
+    if (deps.innerWidth && deps.innerHeight) {
+        const isLikelyRetina = deps.innerWidth >= 2560 || deps.innerHeight >= 1440;
+        result.features.isRetina = isLikelyRetina;
+    }
+    return result;
+}
+//# sourceMappingURL=detectBrowser.js.map