@vpmedia/simplify 1.74.0 → 1.75.0

package/dist/util/async.js

@@ -0,0 +1,39 @@
+import { getTypedError } from './error.js';
+/**
+ * Returns a promise with delayed resolve.
+ */
+export const delayPromise = (delayMS) => new Promise((resolve) => {
+    setTimeout(resolve, delayMS);
+});
+/**
+ * Async method call retry helper.
+ */
+export const retryAsync = async (method, numTries = 1, delayMs = 100) => {
+    for (let attempt = 0; attempt <= numTries; attempt += 1) {
+        try {
+            // oxlint-disable-next-line no-await-in-loop
+            return await method();
+        }
+        catch (error) {
+            if (attempt === numTries) {
+                throw getTypedError(error);
+            }
+            if (delayMs > 0) {
+                // oxlint-disable-next-line no-await-in-loop
+                await delayPromise(delayMs);
+            }
+        }
+    }
+    throw new Error('Unknown error');
+};
+/**
+ * Load JSON file using a fetch GET request.
+ */
+export const loadJSON = async (url) => {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new DOMException(`Fetch error ${response.status}`, 'FetchError');
+    }
+    return response.json();
+};
+//# sourceMappingURL=async.js.map

package/dist/util/async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.js","sourceRoot":"","sources":["../../src/util/async.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAiB,EAAE,CAC7D,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC,CAAC,CAAC;AAEL;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAK,MAAwB,EAAE,QAAQ,GAAG,CAAC,EAAE,OAAO,GAAG,GAAG,EAAc,EAAE;IACvG,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,QAAQ,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,4CAA4C;YAC5C,OAAO,MAAM,MAAM,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACzB,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;YACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,4CAA4C;gBAC5C,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,GAAW,EAAoB,EAAE;IAC9D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,YAAY,CAAC,eAAe,QAAQ,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC,CAAC"}

package/dist/util/error.d.ts

@@ -0,0 +1,16 @@
+export interface ErrorDetails {
+    name: string;
+    type: string;
+    message?: string;
+    cause?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Retrieves detailed information from an error object.
+ */
+export declare const getErrorDetails: (error: Error, excludes?: string[] | null) => ErrorDetails;
+/**
+ * Get typed error from an unknown type.
+ */
+export declare const getTypedError: (error: unknown) => Error;
+//# sourceMappingURL=error.d.ts.map

package/dist/util/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/util/error.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,EAAE,WAAW,MAAM,EAAE,GAAG,IAAI,KAAG,YAiB1E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KACY,CAAC"}

package/dist/util/error.js

@@ -0,0 +1,27 @@
+const DEFAULT_EXCLUDES = new Set(['stack']);
+/**
+ * Retrieves detailed information from an error object.
+ */
+export const getErrorDetails = (error, excludes) => {
+    const errorDetails = {
+        name: error.name,
+        type: error.constructor?.name ?? typeof error,
+    };
+    if (error.message) {
+        errorDetails.message = error.message;
+    }
+    if (error.cause) {
+        errorDetails.cause = error.cause;
+    }
+    for (const key of Object.getOwnPropertyNames(error)) {
+        if (!excludes?.includes(key) && !DEFAULT_EXCLUDES.has(key)) {
+            errorDetails[key] = error[key];
+        }
+    }
+    return errorDetails;
+};
+/**
+ * Get typed error from an unknown type.
+ */
+export const getTypedError = (error) => error instanceof Error ? error : new Error(String(error));
+//# sourceMappingURL=error.js.map

package/dist/util/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/util/error.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAU5C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAY,EAAE,QAA0B,EAAgB,EAAE;IACxF,MAAM,YAAY,GAAiB;QACjC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,OAAO,KAAK;KAC9C,CAAC;IACF,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,YAAY,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACnC,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3D,YAAY,CAAC,GAAG,CAAC,GAAI,KAA4C,CAAC,GAAG,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAS,EAAE,CACrD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC"}

package/dist/util/event_emitter.d.ts

@@ -0,0 +1,42 @@
+export type EventListener = (...args: any[]) => void;
+/**
+ * Event emitter implementation inspired by Node.js/EventEmitter3.
+ */
+export declare class EventEmitter {
+    #private;
+    constructor();
+    /**
+     * Get all registered event names.
+     */
+    eventNames(): (string | symbol)[];
+    /**
+     * Get all listener functions registered for an event.
+     */
+    listeners(event: string | symbol): EventListener[];
+    /**
+     * Get the number of listeners registered for an event.
+     */
+    listenerCount(event: string | symbol): number;
+    /**
+     * Emit an event, invoking all registered listeners.
+     */
+    emit(event: string | symbol, ...args: unknown[]): boolean;
+    /**
+     * Register a persistent listener for an event.
+     */
+    on(event: string | symbol, fn: EventListener, context?: unknown): this;
+    /**
+     * Register a one-time listener for an event.
+     */
+    once(event: string | symbol, fn: EventListener, context?: unknown): this;
+    /**
+     * Remove a specific listener, or all listeners for an event.
+     */
+    off(event: string | symbol, fn?: EventListener, context?: unknown): this;
+    /**
+     * Remove all listeners from the emitter,
+     * or all listeners for a specific event.
+     */
+    removeAllListeners(event?: string | symbol): this;
+}
+//# sourceMappingURL=event_emitter.d.ts.map

package/dist/util/event_emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event_emitter.d.ts","sourceRoot":"","sources":["../../src/util/event_emitter.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAkBrD;;GAEG;AACH,qBAAa,YAAY;;;IAOvB;;OAEG;IACH,UAAU,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE;IAIjC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,EAAE;IAKlD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAK7C;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO;IAiCzD;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAItE;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAIxE;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IA6BxE;;;OAGG;IACH,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CASlD"}

package/dist/util/event_emitter.js

@@ -0,0 +1,127 @@
+/**
+ * Internal listener wrapper that stores metadata
+ * about a registered event listener.
+ */
+class Listener {
+    fn;
+    context;
+    once;
+    constructor(fn, context, once = false) {
+        this.fn = fn;
+        this.context = context;
+        this.once = once;
+    }
+}
+/**
+ * Event emitter implementation inspired by Node.js/EventEmitter3.
+ */
+export class EventEmitter {
+    #events;
+    constructor() {
+        this.#events = new Map();
+    }
+    /**
+     * Get all registered event names.
+     */
+    eventNames() {
+        return [...this.#events.keys()];
+    }
+    /**
+     * Get all listener functions registered for an event.
+     */
+    listeners(event) {
+        const listeners = this.#events.get(event);
+        return listeners ? listeners.map((l) => l.fn) : [];
+    }
+    /**
+     * Get the number of listeners registered for an event.
+     */
+    listenerCount(event) {
+        const listeners = this.#events.get(event);
+        return listeners ? listeners.length : 0;
+    }
+    /**
+     * Emit an event, invoking all registered listeners.
+     */
+    emit(event, ...args) {
+        const listeners = this.#events.get(event);
+        if (!listeners || listeners.length === 0) {
+            return false;
+        }
+        for (const listener of [...listeners]) {
+            listener.fn.apply(listener.context, args);
+            if (listener.once) {
+                this.off(event, listener.fn, listener.context);
+            }
+        }
+        return true;
+    }
+    #addListener(event, fn, context, once) {
+        if (typeof fn !== 'function') {
+            throw new TypeError('Listener must be a function');
+        }
+        const listener = new Listener(fn, context ?? this, once);
+        const listeners = this.#events.get(event);
+        if (listeners) {
+            listeners.push(listener);
+        }
+        else {
+            this.#events.set(event, [listener]);
+        }
+        return this;
+    }
+    /**
+     * Register a persistent listener for an event.
+     */
+    on(event, fn, context) {
+        return this.#addListener(event, fn, context, false);
+    }
+    /**
+     * Register a one-time listener for an event.
+     */
+    once(event, fn, context) {
+        return this.#addListener(event, fn, context, true);
+    }
+    /**
+     * Remove a specific listener, or all listeners for an event.
+     */
+    off(event, fn, context) {
+        if (!this.#events.has(event)) {
+            return this;
+        }
+        if (!fn) {
+            this.#events.delete(event);
+            return this;
+        }
+        const filtered = this.#events.get(event).filter((listener) => {
+            if (listener.fn !== fn) {
+                return true;
+            }
+            if (context !== undefined && listener.context !== context) {
+                return true;
+            }
+            return false;
+        });
+        if (filtered.length > 0) {
+            this.#events.set(event, filtered);
+        }
+        else {
+            this.#events.delete(event);
+        }
+        return this;
+    }
+    /**
+     * Remove all listeners from the emitter,
+     * or all listeners for a specific event.
+     */
+    removeAllListeners(event) {
+        if (event === undefined) {
+            this.#events.clear();
+        }
+        else {
+            this.#events.delete(event);
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=event_emitter.js.map

package/dist/util/event_emitter.js.map

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

package/dist/util/fetch.d.ts

@@ -0,0 +1,22 @@
+export declare const HTTP_0_ANY = 0;
+export interface FetchRetryOptions {
+    delay?: number;
+    numTries?: number;
+    statusExcludes?: number[];
+    timeout?: number;
+}
+export declare class FetchError extends Error {
+    resource: string | URL | Request;
+    fetchOptions: RequestInit;
+    response: Response | null;
+    cause: number | null;
+    /**
+     * Creates a new FetchError instance.
+     */
+    constructor(message: string, resource: string | URL | Request, fetchOptions: RequestInit, response: Response | null);
+}
+/**
+ * Fetch with retry.
+ */
+export declare const fetchRetry: (resource: string | URL | Request, fetchOptions: RequestInit, retryOptions?: FetchRetryOptions) => Promise<Response>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/util/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/util/fetch.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC;IACjC,YAAY,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;gBACS,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAQpH;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,GAAG,GAAG,GAAG,OAAO,EAChC,cAAc,WAAW,EACzB,eAAe,iBAAiB,KAC/B,OAAO,CAAC,QAAQ,CAkDlB,CAAC"}

package/dist/util/fetch.js

@@ -0,0 +1,75 @@
+import { HTTP_401_UNAUTHORIZED, HTTP_403_FORBIDDEN, HTTP_405_METHOD_NOT_ALLOWED, HTTP_422_UNPROCESSABLE_CONTENT, } from '../const/http_status.js';
+import { Logger } from '../logging/Logger.js';
+import { delayPromise } from './async.js';
+import { getErrorDetails } from './error.js';
+const logger = new Logger('fetch');
+export const HTTP_0_ANY = 0;
+export class FetchError extends Error {
+    resource;
+    fetchOptions;
+    response;
+    cause;
+    /**
+     * Creates a new FetchError instance.
+     */
+    constructor(message, resource, fetchOptions, response) {
+        super(message);
+        this.name = 'FetchError';
+        this.resource = resource;
+        this.fetchOptions = fetchOptions;
+        this.response = response;
+        this.cause = response?.status ?? null;
+    }
+}
+/**
+ * Fetch with retry.
+ */
+export const fetchRetry = async (resource, fetchOptions, retryOptions) => {
+    const opts = {
+        timeout: Math.max(retryOptions?.timeout ?? 30_000, 1),
+        delay: Math.max(retryOptions?.delay ?? 1000, 1),
+        numTries: Math.max(retryOptions?.numTries ?? 1, 1),
+        statusExcludes: retryOptions?.statusExcludes ?? [
+            HTTP_401_UNAUTHORIZED,
+            HTTP_403_FORBIDDEN,
+            HTTP_405_METHOD_NOT_ALLOWED,
+            HTTP_422_UNPROCESSABLE_CONTENT,
+        ],
+    };
+    while (opts.numTries > 0) {
+        const isOnline = globalThis.navigator?.onLine;
+        logger.info('request', { resource: String(resource), fetchOptions, retryOptions: { ...opts }, isOnline });
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(new DOMException('Fetch timed out', 'AbortError')), opts.timeout);
+        const options = {
+            ...fetchOptions,
+            signal: controller.signal,
+        };
+        try {
+            const response = await fetch(resource, options);
+            if (!response.ok) {
+                throw new FetchError(`Fetch error ${response.status}`, resource, options, response);
+            }
+            logger.info('response', { status: response.status });
+            return response;
+        }
+        catch (error) {
+            const typedError = error instanceof Error ? error : new Error(String(error));
+            logger.debug('error', getErrorDetails(typedError));
+            opts.numTries -= 1;
+            if (opts.numTries === 0 ||
+                (typedError instanceof FetchError &&
+                    (opts.statusExcludes.includes(typedError.response?.status ?? -1) ||
+                        opts.statusExcludes.includes(HTTP_0_ANY)))) {
+                throw error;
+            }
+            await delayPromise(opts.delay);
+            opts.delay *= 2;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    throw new Error('Fetch failed');
+};
+//# sourceMappingURL=fetch.js.map

package/dist/util/fetch.js.map

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

package/dist/util/number.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Converts degrees to radians.
+ */
+export declare const deg2rad: (degrees: number) => number;
+/**
+ * Converts radians to degrees.
+ */
+export declare const rad2deg: (radians: number) => number;
+/**
+ * Returns random integer in range.
+ */
+export declare const getRandomInt: (min: number, max: number) => number;
+/**
+ * Normalizes floating point precision (e.g. 0.20000000000000004 → 0.2).
+ */
+export declare const fixFloatPrecision: (value: number | string | null | undefined) => number;
+export declare const isGreater: (value: number, min: number) => boolean;
+export declare const isGreaterOrEqual: (value: number, min: number) => boolean;
+export declare const isLess: (value: number, min: number) => boolean;
+export declare const isLessOrEqual: (value: number, min: number) => boolean;
+export declare const isInRange: (value: number, min: number, max: number) => boolean;
+export declare const isEqual: (value: number, expected: number) => boolean;
+//# sourceMappingURL=number.d.ts.map

package/dist/util/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/util/number.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,KAAG,MAKzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,KAAG,MAKzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,MAQvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAM7E,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,KAAG,OAAsB,CAAC;AAC9E,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,KAAG,OAAuB,CAAC;AACtF,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,KAAG,OAAsB,CAAC;AAC3E,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,KAAG,OAAuB,CAAC;AACnF,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,OAAuC,CAAC;AAC5G,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,EAAE,UAAU,MAAM,KAAG,OAA6B,CAAC"}

package/dist/util/number.js

@@ -0,0 +1,52 @@
+import { TypeCheckError } from '../typecheck/TypeCheckError.js';
+const DEG_TO_RAD = Math.PI / 180;
+const RAD_TO_DEG = 180 / Math.PI;
+const PRECISION = 12;
+const EPSILON = 1e-11;
+/**
+ * Converts degrees to radians.
+ */
+export const deg2rad = (degrees) => {
+    if (!Number.isFinite(degrees)) {
+        throw new TypeCheckError('Argument degrees must be a finite number', { value: degrees });
+    }
+    return degrees * DEG_TO_RAD;
+};
+/**
+ * Converts radians to degrees.
+ */
+export const rad2deg = (radians) => {
+    if (!Number.isFinite(radians)) {
+        throw new TypeCheckError('Argument radians must be a finite number', { value: radians });
+    }
+    return radians * RAD_TO_DEG;
+};
+/**
+ * Returns random integer in range.
+ */
+export const getRandomInt = (min, max) => {
+    if (!Number.isFinite(min)) {
+        throw new TypeCheckError('Argument min must be finite number', { value: min });
+    }
+    if (!Number.isFinite(max)) {
+        throw new TypeCheckError('Argument max must be finite number', { value: max });
+    }
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+};
+/**
+ * Normalizes floating point precision (e.g. 0.20000000000000004 → 0.2).
+ */
+export const fixFloatPrecision = (value) => {
+    const parsedValue = typeof value === 'string' ? Number(value) : value;
+    if (parsedValue === null || parsedValue === undefined || !Number.isFinite(parsedValue)) {
+        return Number.NaN;
+    }
+    return Math.abs(parsedValue) < EPSILON ? 0 : Number(parsedValue.toPrecision(PRECISION));
+};
+export const isGreater = (value, min) => value > min;
+export const isGreaterOrEqual = (value, min) => value >= min;
+export const isLess = (value, min) => value < min;
+export const isLessOrEqual = (value, min) => value <= min;
+export const isInRange = (value, min, max) => value >= min && value <= max;
+export const isEqual = (value, expected) => value === expected;
+//# sourceMappingURL=number.js.map

package/dist/util/number.js.map

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

package/dist/util/object.d.ts

@@ -0,0 +1,24 @@
+type AnyRecord = Record<string, any>;
+/**
+ * Purges object properties to free up memory.
+ */
+export declare const purgeObject: (target: AnyRecord | null | undefined) => void;
+/**
+ * Merge two objects.
+ */
+export declare const deepMerge: (target: AnyRecord | null, source: AnyRecord | null) => AnyRecord | null;
+/**
+ * Returns the sum value of an array of objects field.
+ */
+export declare const getObjArrayPropSum: (arr: AnyRecord[], prop: string) => number;
+/**
+ * Get object value by path.
+ */
+export declare const getObjValueByPath: (obj: AnyRecord | null | undefined, path: string | null | undefined) => unknown;
+/**
+ * Set object value by path.
+ * @throws {SyntaxError} Error when illegal path value has been provided.
+ */
+export declare const setObjValueByPath: (obj: AnyRecord | null | undefined, path: string | null | undefined, value: unknown) => void;
+export {};
+//# sourceMappingURL=object.d.ts.map

package/dist/util/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/util/object.ts"],"names":[],"mappings":"AAEA,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,SAAS,GAAG,IAAI,GAAG,SAAS,KAAG,IAOlE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,SAAS,GAAG,IAAI,EAAE,QAAQ,SAAS,GAAG,IAAI,KAAG,SAAS,GAAG,IAsB1F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,SAAS,EAAE,EAAE,MAAM,MAAM,KAAG,MACY,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,SAAS,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,OAatG,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,KAAK,SAAS,GAAG,IAAI,GAAG,SAAS,EACjC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,OAAO,OAAO,KACb,IAiBF,CAAC"}

package/dist/util/object.js

@@ -0,0 +1,83 @@
+const PROHIBITED_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+/**
+ * Purges object properties to free up memory.
+ */
+export const purgeObject = (target) => {
+    if (!target) {
+        return;
+    }
+    for (const entry of Object.keys(target)) {
+        target[entry] = null;
+    }
+};
+/**
+ * Merge two objects.
+ */
+export const deepMerge = (target, source) => {
+    if (typeof target !== 'object' || target === null) {
+        return source;
+    }
+    if (typeof source !== 'object' || source === null) {
+        return target;
+    }
+    for (const key of Object.keys(source)) {
+        if (PROHIBITED_KEYS.has(key)) {
+            throw new SyntaxError(`Security violation error. Cannot use "${key}" as object key.`);
+        }
+        if (typeof source[key] === 'object' && source[key] !== null) {
+            if (!target[key] || typeof target[key] !== 'object') {
+                target[key] = {};
+            }
+            deepMerge(target[key], source[key]);
+        }
+        else {
+            target[key] = source[key];
+        }
+    }
+    return target;
+};
+/**
+ * Returns the sum value of an array of objects field.
+ */
+export const getObjArrayPropSum = (arr, prop) => arr.reduce((accumulator, object) => accumulator + object[prop], 0);
+/**
+ * Get object value by path.
+ */
+export const getObjValueByPath = (obj, path) => {
+    if (!obj || !path) {
+        return null;
+    }
+    const keyParts = path.split('.');
+    const nextKey = keyParts[0];
+    if (keyParts.length === 1) {
+        return obj[nextKey] === undefined ? null : obj[nextKey];
+    }
+    if (obj[nextKey] === undefined || obj[nextKey] === null) {
+        return null;
+    }
+    return getObjValueByPath(obj[nextKey], keyParts.slice(1).join('.'));
+};
+/**
+ * Set object value by path.
+ * @throws {SyntaxError} Error when illegal path value has been provided.
+ */
+export const setObjValueByPath = (obj, path, value) => {
+    if (!obj || !path) {
+        return;
+    }
+    const keyParts = path.split('.');
+    const nextKey = keyParts[0];
+    if (PROHIBITED_KEYS.has(nextKey)) {
+        throw new SyntaxError(`Security violation error. Cannot use "${nextKey}" as parameter.`);
+    }
+    if (keyParts.length === 1) {
+        obj[nextKey] = value;
+    }
+    else {
+        if (obj[nextKey] === undefined || obj[nextKey] === null) {
+            obj[nextKey] = {};
+        }
+        setObjValueByPath(obj[nextKey], keyParts.slice(1).join('.'), value);
+    }
+};
+//# sourceMappingURL=object.js.map

package/dist/util/object.js.map

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

package/dist/util/query.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sanitizes URL parameters allowing only alpha-numeric characters and dash.
+ */
+export declare function sanitizeURLParam(input: string): string;
+export declare function sanitizeURLParam(input: null | undefined): null | undefined;
+export declare function sanitizeURLParam(input: string | null | undefined): string | null | undefined;
+/**
+ * Get a URL parameter value.
+ */
+export declare function getURLParam<T = null>(key: string | null | undefined, defaultValue?: T, isSanitize?: boolean): string | T;
+//# sourceMappingURL=query.d.ts.map

package/dist/util/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/util/query.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;AACxD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;AAC5E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAQ9F;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,IAAI,EAClC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,YAAY,CAAC,EAAE,CAAC,EAChB,UAAU,CAAC,EAAE,OAAO,GACnB,MAAM,GAAG,CAAC,CAYZ"}

package/dist/util/query.js

@@ -0,0 +1,24 @@
+const urlSearchParams = new URLSearchParams(globalThis.location?.search);
+export function sanitizeURLParam(input) {
+    if (!input) {
+        return input;
+    }
+    return input.replaceAll(/[^\w-]/giu, '');
+}
+/**
+ * Get a URL parameter value.
+ */
+export function getURLParam(key, defaultValue, isSanitize) {
+    if (!key) {
+        return (defaultValue ?? null);
+    }
+    const paramValue = urlSearchParams.get(key);
+    if (paramValue === null || paramValue === undefined) {
+        return (defaultValue ?? null);
+    }
+    if (isSanitize !== false) {
+        return sanitizeURLParam(paramValue);
+    }
+    return paramValue;
+}
+//# sourceMappingURL=query.js.map

package/dist/util/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/util/query.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAQzE,MAAM,UAAU,gBAAgB,CAAC,KAAgC;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,GAA8B,EAC9B,YAAgB,EAChB,UAAoB;IAEpB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,YAAY,IAAI,IAAI,CAAM,CAAC;IACrC,CAAC;IACD,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QACpD,OAAO,CAAC,YAAY,IAAI,IAAI,CAAM,CAAC;IACrC,CAAC;IACD,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO,gBAAgB,CAAC,UAAU,CAAW,CAAC;IAChD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/util/state.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Maps server data to client data.
+ */
+export declare const serverDataToState: (data: unknown, isRecursive?: boolean) => any;
+//# sourceMappingURL=state.d.ts.map