@lowentry/utils 1.25.3 → 2.0.3

package/dist/src/LeUtils.d.ts

@@ -0,0 +1,745 @@
+/**
+ * LeUtils - Core utility functions
+ */
+/**
+ * Transactional Value Types
+ */
+export interface TransactionChange {
+    id: string;
+    value: unknown;
+}
+export interface TransactionalValue {
+    value: unknown;
+    changes: TransactionChange[];
+}
+/**
+ * Deep equality comparison.
+ * Compares objects, arrays, Maps, Sets, primitives, and handles special cases.
+ *
+ * @param a - First value to compare
+ * @param b - Second value to compare
+ * @returns true if values are equivalent
+ */
+export declare function equals(a: unknown, b: unknown): boolean;
+/**
+ * Deep clones a value.
+ *
+ * @param value - Value to clone
+ * @returns Deep cloned value
+ */
+export declare function clone<T>(value: T): T;
+/**
+ * Checks if the given elements can be iterated over using each().
+ *
+ * @param elements - Value to check
+ * @returns true if can iterate
+ */
+export declare function supportsEach(elements: unknown): boolean;
+/**
+ * Returns an iterator that yields [value, key/index] for each element.
+ *
+ * @param elements - Collection to iterate
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty check
+ * @yields [value, key/index]
+ */
+export declare function eachIterator(elements: unknown, optionalSkipHasOwnPropertyCheck?: boolean): Generator<[unknown, unknown]>;
+/**
+ * Loops through each element and calls callback.
+ * Callback can return false to break iteration.
+ *
+ * @param elements - Collection to iterate
+ * @param callback - Function called for each element
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty check
+ * @returns Original elements
+ */
+export declare function each<T>(elements: T, callback: (value: unknown, key: unknown) => boolean | void, optionalSkipHasOwnPropertyCheck?: boolean): T;
+/**
+ * Like each(), except that it expects an async callback.
+ *
+ * @param elements - Collection to iterate
+ * @param asyncCallback - Async function called for each element
+ * @param parallelCount - Number of parallel executions (default 1)
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty check
+ * @returns Promise resolving to original elements
+ */
+export declare function eachAsync<T>(elements: T, asyncCallback: (value: unknown, key: unknown) => Promise<boolean | void>, parallelCount?: number, optionalSkipHasOwnPropertyCheck?: boolean): Promise<T>;
+/**
+ * Returns empty collection matching type of input, plus add function.
+ *
+ * @param elements - Source collection to match type
+ * @returns [success, emptyCollection, addFunction]
+ */
+export declare function getEmptySimplifiedCollection(elements: unknown): [boolean, unknown, (value: unknown, index: unknown) => void];
+/**
+ * Filters collection, returning only elements matching predicate.
+ *
+ * @param elements - Collection to filter
+ * @param callback - Predicate function (truthy = keep)
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty
+ * @returns Filtered collection (same type as input)
+ */
+export declare function filter(elements: unknown, callback?: (value: unknown, index: unknown) => boolean, optionalSkipHasOwnPropertyCheck?: boolean): unknown;
+/**
+ * Maps collection, transforming each element.
+ *
+ * @param elements - Collection to map
+ * @param callback - Transform function
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty
+ * @returns Mapped collection (same type as input)
+ */
+export declare function map(elements: unknown, callback?: (value: unknown, index: unknown) => unknown, optionalSkipHasOwnPropertyCheck?: boolean): unknown;
+/**
+ * Maps collection to array.
+ *
+ * @param elements - Collection to map
+ * @param callback - Transform function
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty
+ * @returns Array of transformed values
+ */
+export declare function mapToArray<T = unknown>(elements: unknown, callback?: (value: unknown, index: unknown) => T, optionalSkipHasOwnPropertyCheck?: boolean): T[];
+/**
+ * Sorts keys by comparing values with comparator.
+ *
+ * @param elements - Collection to get keys from
+ * @param comparator - Comparison function
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty
+ * @returns Sorted array of keys
+ */
+export declare function sortKeys(elements: unknown, comparator: (a: unknown, b: unknown) => number, optionalSkipHasOwnPropertyCheck?: boolean): unknown[];
+/**
+ * Gets value at index/key from collection.
+ *
+ * @param elements - Collection
+ * @param index - Key or index
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty
+ * @returns Value at index, or undefined
+ */
+export declare function getValueAtIndex(elements: unknown, index: unknown, optionalSkipHasOwnPropertyCheck?: boolean): unknown;
+/**
+ * Flattens nested arrays to single level (like Array.flat(Infinity)).
+ *
+ * @param array - Array to flatten
+ * @returns Flattened array
+ */
+export declare function flattenArray(array: unknown): unknown[];
+/**
+ * Flattens any collection (arrays, Sets, Maps, objects) to single array.
+ *
+ * @param elements - Collection to flatten
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty
+ * @returns Flattened array
+ */
+export declare function flattenToArray(elements: unknown, optionalSkipHasOwnPropertyCheck?: boolean): unknown[];
+/**
+ * Maps and sorts collection to array.
+ *
+ * @param elements - Collection to process
+ * @param comparator - Sort comparison function
+ * @param callback - Optional transform
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty
+ * @returns Sorted array
+ */
+export declare function mapToArraySorted(elements: unknown, comparator: (a: unknown, b: unknown) => number, callback?: (value: unknown, key: unknown) => unknown, optionalSkipHasOwnPropertyCheck?: boolean): unknown[];
+/**
+ * Generic comparison function for sorting.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns -1 if a < b, 1 if a > b, 0 if equal
+ */
+export declare function compare(a: unknown, b: unknown): number;
+/**
+ * Compares two numbers (for sorting).
+ *
+ * @param a - First number
+ * @param b - Second number
+ * @returns Difference (a - b)
+ */
+export declare function compareNumbers(a: number, b: number): number;
+/**
+ * Compares two numeric strings (like version numbers).
+ * Splits on '.', compares each part numerically considering length.
+ *
+ * @param a - First numeric string
+ * @param b - Second numeric string
+ * @returns Comparison result
+ */
+export declare function compareNumericStrings(a: string | number, b: string | number): number;
+/**
+ * Natural string comparison (numbers in strings compared numerically).
+ * "file5.txt" sorts before "file10.txt".
+ *
+ * @param a - First string
+ * @param b - Second string
+ * @returns Comparison result
+ */
+export declare function compareNaturalStrings(a: string, b: string): number;
+/**
+ * Checks if object is empty (no own properties).
+ *
+ * @param obj - Object to check
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty
+ * @returns true if empty
+ */
+export declare function isEmptyObject(obj: unknown, optionalSkipHasOwnPropertyCheck?: boolean): boolean;
+/**
+ * Counts own properties in object.
+ *
+ * @param obj - Object to count
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty
+ * @returns Number of own properties
+ */
+export declare function getObjectFieldsCount(obj: unknown, optionalSkipHasOwnPropertyCheck?: boolean): number;
+/**
+ * Capitalizes first character of string.
+ *
+ * @param string - String to capitalize
+ * @returns Capitalized string
+ */
+export declare function capitalize(string: unknown): string;
+/**
+ * Checks if string ends with any of the given suffixes.
+ *
+ * @param string - String to check
+ * @param endingCharsStringOrArray - String of chars or array of suffixes
+ * @returns true if ends with any
+ */
+export declare function endsWithAny(string: unknown, endingCharsStringOrArray: string | string[]): boolean;
+/**
+ * Checks if string starts with any of the given prefixes.
+ *
+ * @param string - String to check
+ * @param startingCharsStringOrArray - String of chars or array of prefixes
+ * @returns true if starts with any
+ */
+export declare function startsWithAny(string: unknown, startingCharsStringOrArray: string | string[]): boolean;
+/**
+ * Trims specific characters from end of string.
+ *
+ * @param string - String to trim
+ * @param trimCharsStringOrArray - Characters to remove
+ * @returns Trimmed string
+ */
+export declare function trimEnd(string: unknown, trimCharsStringOrArray: string | string[]): string;
+/**
+ * Trims specific characters from start of string.
+ *
+ * @param string - String to trim
+ * @param trimCharsStringOrArray - Characters to remove
+ * @returns Trimmed string
+ */
+export declare function trimStart(string: unknown, trimCharsStringOrArray: string | string[]): string;
+/**
+ * Trims specific characters from both ends of string.
+ *
+ * @param string - String to trim
+ * @param trimCharsStringOrArray - Characters to remove
+ * @returns Trimmed string
+ */
+export declare function trim(string: unknown, trimCharsStringOrArray: string | string[]): string;
+/**
+ * Checks if collection contains value (string comparison).
+ *
+ * @param array - Collection to search
+ * @param value - Value to find
+ * @returns true if found
+ */
+export declare function contains(array: unknown, value: unknown): boolean;
+/**
+ * Checks if collection contains value (case-insensitive).
+ *
+ * @param array - Collection to search
+ * @param value - Value to find
+ * @returns true if found
+ */
+export declare function containsCaseInsensitive(array: unknown, value: unknown): boolean;
+/**
+ * Checks if collection contains all given values.
+ *
+ * @param array - Collection to search
+ * @param values - Values to find
+ * @returns true if all found
+ */
+export declare function containsAll(array: unknown, values: unknown): boolean;
+/**
+ * Checks if collection contains any of given values.
+ *
+ * @param array - Collection to search
+ * @param values - Values to find
+ * @returns true if any found
+ */
+export declare function containsAny(array: unknown, values: unknown): boolean;
+/**
+ * Checks if collection contains none of given values.
+ *
+ * @param array - Collection to search
+ * @param values - Values to check
+ * @returns true if none found
+ */
+export declare function containsNone(array: unknown, values: unknown): boolean;
+/**
+ * Finds first element matching predicate, returns {index, value}.
+ *
+ * @param elements - Collection to search
+ * @param callback - Predicate function
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty
+ * @returns {index, value} or null
+ */
+export declare function findIndexValue(elements: unknown, callback: (value: unknown, index: unknown) => boolean, optionalSkipHasOwnPropertyCheck?: boolean): {
+    index: unknown;
+    value: unknown;
+} | null;
+/**
+ * Finds first element matching predicate, returns index.
+ *
+ * @param elements - Collection to search
+ * @param callback - Predicate function
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty
+ * @returns Index/key or null
+ */
+export declare function findIndex(elements: unknown, callback: (value: unknown, index: unknown) => boolean, optionalSkipHasOwnPropertyCheck?: boolean): unknown;
+/**
+ * Finds first element matching predicate, returns value.
+ *
+ * @param elements - Collection to search
+ * @param callback - Predicate function
+ * @param optionalSkipHasOwnPropertyCheck - Skip hasOwnProperty
+ * @returns Value or null
+ */
+export declare function find(elements: unknown, callback: (value: unknown, index: unknown) => boolean, optionalSkipHasOwnPropertyCheck?: boolean): unknown;
+/**
+ * Generates a base64 string (with +/ replaced by -_) that is guaranteed to be unique.
+ *
+ * @returns Unique ID string
+ */
+export declare const uniqueId: () => string;
+/**
+ * Generates a base64 string (with +/ replaced by -_) of the current time.
+ *
+ * @param now - Optional time to use
+ * @returns Timestamp string
+ */
+export declare const timestamp: (now?: number | null) => string;
+/**
+ * Checks if value is a generator function.
+ *
+ * @param value - Value to check
+ * @returns true if generator, false otherwise
+ */
+export declare const isGeneratorFunction: (value: unknown) => boolean;
+/**
+ * Environment-safe btoa.
+ *
+ * @param str - String to encode
+ * @returns Base64 string
+ */
+export declare function btoa(str: string): string;
+/**
+ * Environment-safe atob.
+ *
+ * @param str - Base64 string to decode
+ * @returns Decoded string
+ */
+export declare function atob(str: string): string;
+/**
+ * Encodes a UTF-8 string into a base64 string.
+ *
+ * @param string - UTF-8 string
+ * @returns Base64 string
+ */
+export declare function utf8ToBase64(string: string): string;
+/**
+ * Decodes a base64 string back into a UTF-8 string.
+ *
+ * @param base64string - Base64 string
+ * @returns Decoded UTF-8 string
+ */
+export declare function base64ToUtf8(base64string: string): string;
+/**
+ * Converts a base64 string into a hex string.
+ *
+ * @param base64string - Base64 string
+ * @returns Hex string
+ */
+export declare function base64ToHex(base64string: string): string;
+/**
+ * Converts a hex string into a base64 string.
+ *
+ * @param hexstring - Hex string
+ * @returns Base64 string
+ */
+export declare function hexToBase64(hexstring: string): string;
+/**
+ * Converts a base64 string into bytes (Uint8Array).
+ *
+ * @param base64string - Base64 string
+ * @returns Bytes
+ */
+export declare function base64ToBytes(base64string: string): Uint8Array;
+/**
+ * Converts bytes into a base64 string.
+ *
+ * @param arraybuffer - Bytes source
+ * @returns Base64 string
+ */
+export declare function bytesToBase64(arraybuffer: ArrayLike<number> | ArrayBuffer): string;
+/**
+ * Executes callback after ms. Delta time in seconds passed to callback.
+ *
+ * @param callback - Function to call
+ * @param ms - Milliseconds to wait
+ * @returns Handler with remove() method
+ */
+export declare function setTimeout(callback: (deltaTime: number) => unknown, ms: number): {
+    remove: () => void;
+};
+/**
+ * Executes callback every intervalMs. Delta time in seconds passed to callback.
+ *
+ * @param callback - Function to call
+ * @param intervalMs - Interval in milliseconds
+ * @param fireImmediately - Whether to call immediately
+ * @returns Handler with remove() method
+ */
+export declare function setInterval(callback: (deltaTime: number) => unknown, intervalMs?: number, fireImmediately?: boolean): {
+    remove: () => void;
+};
+/**
+ * Executes callback after frames. Delta time in seconds passed to callback.
+ *
+ * @param callback - Function to call
+ * @param frames - Number of frames to wait
+ * @returns Handler with remove() method
+ */
+export declare function setAnimationFrameTimeout(callback: (deltaTime: number) => unknown, frames?: number): {
+    remove: () => void;
+};
+/**
+ * Executes callback every intervalFrames. Delta time in seconds passed to callback.
+ *
+ * @param callback - Function to call
+ * @param intervalFrames - Interval in frames
+ * @param fireImmediately - Whether to call immediately
+ * @returns Handler with remove() method
+ */
+export declare function setAnimationFrameInterval(callback: (deltaTime: number) => unknown, intervalFrames?: number, fireImmediately?: boolean): {
+    remove: () => void;
+};
+/**
+ * Returns a promise resolved after ms.
+ *
+ * @param ms - Milliseconds to wait
+ * @returns Promise resolving to delta time
+ */
+export declare function promiseTimeout(ms: number): Promise<number>;
+/**
+ * Returns a promise resolved after frames.
+ *
+ * @param frames - Number of frames to wait
+ * @returns Promise resolving to delta time
+ */
+export declare function promiseAnimationFrameTimeout(frames: number): Promise<number>;
+/**
+ * Fetch with retry and abort functionality.
+ *
+ * @param url - URL to fetch
+ * @param options - Fetch options including retries and delay
+ * @returns Object with then(), catch(), finally(), remove(), isRemoved()
+ */
+export declare function fetch(url: string, options?: unknown): {
+    then: (onfulfilled?: (value: Response) => unknown, onrejected?: (reason: unknown) => unknown) => unknown;
+    catch: (onrejected?: (reason: unknown) => unknown) => unknown;
+    finally: (onfinally?: () => unknown) => unknown;
+    remove: () => unknown;
+    isRemoved: () => boolean;
+};
+/**
+ * Cached version of fetch.
+ *
+ * @param url - URL to fetch
+ * @param options - Fetch options
+ * @param responseFunction - Optional function to process response before caching
+ * @returns Promise resolving to data
+ */
+export declare const cachedFetch: (url: string, options?: unknown, responseFunction?: (response: Response) => unknown) => Promise<unknown>;
+/**
+ * Creates a new transactional value.
+ *
+ * @param value - Initial value
+ * @returns Transactional value object
+ */
+export declare function createTransactionalValue(value?: unknown): TransactionalValue;
+/**
+ * Validates a transactional value structure.
+ *
+ * @param transactionalValue - Value to check
+ * @returns true if valid
+ */
+export declare function isTransactionalValueValid(transactionalValue: unknown): transactionalValue is TransactionalValue;
+/**
+ * Converts transactional value to string representation of its state.
+ *
+ * @param transactionalValue - Transactional value
+ * @returns State string
+ */
+export declare function transactionalValueToString(transactionalValue: unknown): string;
+/**
+ * Sets and commits a value, clearing all uncommitted changes.
+ *
+ * @param transactionalValue - Transactional value
+ * @param value - New value
+ */
+export declare function transactionSetAndCommit(transactionalValue: TransactionalValue, value: unknown): void;
+/**
+ * Adds an uncommitted change. Returns change ID.
+ *
+ * @param transactionalValue - Transactional value
+ * @param value - New value
+ * @returns Change ID
+ */
+export declare function transactionSetWithoutCommitting(transactionalValue: TransactionalValue, value: unknown): string;
+/**
+ * Commits a specific change by ID.
+ *
+ * @param transactionalValue - Transactional value
+ * @param changeId - Change ID
+ * @returns true if committed
+ */
+export declare function transactionCommitChange(transactionalValue: TransactionalValue, changeId: string): boolean;
+/**
+ * Cancels a specific change by ID.
+ *
+ * @param transactionalValue - Transactional value
+ * @param changeId - Change ID
+ * @returns true if cancelled
+ */
+export declare function transactionCancelChange(transactionalValue: TransactionalValue, changeId: string): boolean;
+/**
+ * Checks if a change is still relevant.
+ *
+ * @param transactionalValue - Transactional value
+ * @param changeId - Change ID
+ * @returns true if relevant
+ */
+export declare function transactionIsChangeRelevant(transactionalValue: TransactionalValue, changeId: string): boolean;
+/**
+ * Gets current committed value.
+ *
+ * @param transactionalValue - Transactional value
+ * @returns Committed value
+ */
+export declare function transactionGetCommittedValue(transactionalValue: TransactionalValue): unknown;
+/**
+ * Gets current value (including most recent uncommitted change).
+ *
+ * @param transactionalValue - Transactional value
+ * @returns Current value
+ */
+export declare function transactionGetValue(transactionalValue: TransactionalValue): unknown;
+/**
+ * Performs a deep equality comparison between two collections, sorting on keys first.
+ *
+ * @param elementsA - First collection
+ * @param elementsB - Second collection
+ * @param ignoreKeys - Keys to ignore
+ * @returns true if equivalent
+ */
+export declare function equalsMapLike(elementsA: unknown, elementsB: unknown, ignoreKeys?: string | string[]): boolean;
+/**
+ * Executes callback when document is ready.
+ *
+ * @param callback - Function to call
+ * @returns Handler with remove() method
+ */
+export declare function onDomReady(callback: () => void): {
+    remove: () => void;
+};
+/**
+ * Parses version string into object with comparison helpers.
+ *
+ * @param version - Version string or object
+ * @returns Version object with comparison methods
+ */
+export declare function parseVersionString(version: unknown): {
+    major: number;
+    minor: number;
+    patch: number;
+    toString: () => string;
+    equals: (other: unknown) => boolean;
+    largerThan: (other: unknown) => boolean;
+    largerThanOrEquals: (other: unknown) => boolean;
+    smallerThan: (other: unknown) => boolean;
+    smallerThanOrEquals: (other: unknown) => boolean;
+};
+/**
+ * Increases numeric string by 1 without limit.
+ *
+ * @param str - Numeric string
+ * @returns Increased string
+ */
+export declare function increaseNumericStringByOne(str: string): string;
+/**
+ * Checks if collection contains all given values (case-insensitive).
+ *
+ * @param array - Collection to search
+ * @param values - Values to find
+ * @returns true if all found
+ */
+export declare function containsAllCaseInsensitive(array: unknown, values: unknown): boolean;
+/**
+ * Checks if collection contains any of given values (case-insensitive).
+ *
+ * @param array - Collection to search
+ * @param values - Values to find
+ * @returns true if any found
+ */
+export declare function containsAnyCaseInsensitive(array: unknown, values: unknown): boolean;
+/**
+ * Checks if collection contains none of given values (case-insensitive).
+ *
+ * @param array - Collection to search
+ * @param values - Values to find
+ * @returns true if none found
+ */
+export declare function containsNoneCaseInsensitive(array: unknown, values: unknown): boolean;
+/**
+ * Returns string with start/end trimmed and ensures valid sentence ending.
+ *
+ * @param sentence - String to purge
+ * @returns Purged sentence
+ */
+export declare function purgeSentence(sentence: unknown): string;
+/**
+ * Obtains error message from any input.
+ *
+ * @param error - Error source
+ * @returns Error message string
+ */
+export declare function purgeErrorMessage(error: unknown): string;
+/**
+ * Generates permutations of names (e.g. foobar, fooBar, FooBar, foo-bar, foo_bar).
+ *
+ * @param names - Parts to combine
+ * @returns Array of permutations
+ */
+export declare function generateNamePermutations(...names: unknown[]): string[];
+/**
+ * Compares two strings generated by LeUtils.timestamp(). Primarily used for sorting.
+ */
+export declare function compareTimestampStrings(a: string | null, b: string | null): number;
+/**
+ * Returns true if the user is on a smartphone device (mobile).
+ */
+export declare function platformIsMobile(): boolean;
+/**
+ * Returns true if the user has a cursor (mouse).
+ */
+export declare function platformHasCursor(): boolean;
+/**
+ * Returns string with email purged (lowercased, trimmed).
+ */
+export declare function purgeEmail(email: unknown): string;
+/**
+ * Returns true if the focus is effectively clear, meaning that the user is not typing in an input field.
+ */
+export declare const isFocusClear: () => boolean;
+/**
+ * Returns the user's locale. Returns 'en-US' if it can't be determined.
+ */
+export declare const getUserLocale: () => string;
+/**
+ * Returns the user's locale date format. Always returns YYYY MM DD, with the character in between depending on the user's locale. Returns 'YYYY/MM/DD' if the user's locale can't be determined.
+ */
+export declare const getUserLocaleDateFormat: () => string;
+/**
+ * Returns an empty 1x1 transparent image data URL.
+ */
+export declare function getEmptyImageSrc(): string;
+/**
+ * Calculates and returns the percentage of the part and total ((part / total) * 100).
+ */
+export declare function getPercentage(part: number | string, total: number | string): number;
+/**
+ * Returns the pixels of the given Image object.
+ */
+export declare function getImagePixels(image: HTMLImageElement): Promise<Uint8ClampedArray>;
+/**
+ * Returns the data URL (mimetype "image/png") of a colored version of the given Image object.
+ */
+export declare function getColoredImage(image: HTMLImageElement, color: string): Promise<string>;
+/**
+ * Returns the hex color of the given RGB(A).
+ */
+export declare function rgbToHex(rgb: number[]): string;
+/**
+ * Returns the RGB(A) of the given hex color.
+ */
+export declare function hexToRgb(hexstring: string): number[];
+/**
+ * Returns the HSL(A) of the given RGB(A).
+ */
+export declare function rgbToHsl(rgb: number[]): number[];
+/**
+ * Returns the RGB(A) of the given HSL(A).
+ */
+export declare const hslToRgb: (hsl: number[]) => number[];
+/**
+ * Returns the LAB(A) of the given RGB(A).
+ */
+export declare function rgbToLab(rgb: number[]): number[];
+/**
+ * Returns the difference (calculated with DeltaE) of the LAB values of the given RGB values.
+ */
+export declare function getDifferenceBetweenRgb(rgbA: number[], rgbB: number[]): number;
+/**
+ * Returns the difference (calculated with DeltaE) of the given LAB values.
+ */
+export declare function getDifferenceBetweenLab(labA: number[], labB: number[]): number;
+/**
+ * Returns the RGB(A) between the two given RGB(A) values, based on the given percentage (0-100).
+ */
+export declare function getRgbBetween(startRgb: number[], endRgb: number[], percentage: number): number[];
+/**
+ * Returns the RGB(A) of the given RGB(A) values, based on the given percentage (0-100).
+ */
+export declare function getRgbOfGradient(gradient: Record<number, number[]>, percentage: number): number[];
+/**
+ * Download file from URL or data.
+ */
+export declare function downloadFile(name: string, data: string | Blob): void;
+/**
+ * LocalStorage Get.
+ */
+export declare function localStorageGet(key: string): string | null;
+/**
+ * LocalStorage Set.
+ */
+export declare function localStorageSet(key: string, value: string): void;
+/**
+ * LocalStorage Remove.
+ */
+export declare function localStorageRemove(key: string): void;
+/**
+ * Checks if given host is private.
+ */
+export declare function isGivenHostPrivate(host: string): boolean;
+/**
+ * Checks if current host is private.
+ */
+export declare function isCurrentHostPrivate(): boolean;
+/**
+ * Create worker thread.
+ */
+export declare function createWorkerThread(name: string): {
+    worker: Worker | null;
+    sendMessage: (data: unknown, options?: {
+        timeout?: number;
+    }) => Promise<unknown>;
+};
+/**
+ * Send message to worker.
+ */
+export declare const sendWorkerMessage: (workerName: string, data: unknown, options?: {
+    timeout?: number;
+}) => Promise<unknown>;
+//# sourceMappingURL=LeUtils.d.ts.map