@dxtmisha/functional-basic 1.8.10 → 1.10.0

package/dist/functions/toKebabCase.d.ts

@@ -1,15 +0,0 @@
-/**
- * Преобразует строку в формат kebab-case.
- * Преобразует все заглавные буквы в строчные, заменяет пробелы и другие символы на дефисы.
- *
- * Converts a string to kebab-case.
- * It converts uppercase letters to lowercase, replaces spaces and other characters with dashes.
- *
- * @param value - Строка, которую необходимо преобразовать.
- *
- * The string to be converted.
- * @returns Строка в формате kebab-case.
- *
- * The string in kebab-case format.
- */
-export declare function toKebabCase(value: string): string;

package/dist/functions/toNumber.d.ts

@@ -1,19 +0,0 @@
-import { NumberOrString } from '../types/basicTypes';
-/**
- * Converts a string or number to a finite floating-point number.
- * Handles various separators (spaces, commas, dots) and strips non-numeric characters.
- * Safe for use in SSR (Server-Side Rendering) environments.
- *
- * Преобразует строку или число в конечное число с плавающей точкой.
- * Обрабатывает различные разделители (пробелы, запятые, точки) и удаляет нечисловые символы.
- * Безопасно для использования в SSR (Server-Side Rendering) средах.
- *
- * @param value - The input value to convert / Входное значение для преобразования
- * @returns The parsed number or 0 if conversion fails / Распарсенное число или 0, если конвертация не удалась
- *
- * @example
- * toNumber("1 234,56") // 1234.56
- * toNumber("1,234.56") // 1234.56
- * toNumber("1,234")    // 1.234
- */
-export declare function toNumber(value?: NumberOrString): number;

package/dist/functions/toNumberByMax.d.ts

@@ -1,11 +0,0 @@
-/**
- * Converts the data into a number, taking into account the maximum permissible value.
- *
- * Преобразует данные в число с учетом максимально допустимого значения.
- * @param value input value / входное значение
- * @param max maximum achievable value / максимально достижимое значение
- * @param formatting format the number / форматировать число
- * @param language formatting language / язык форматирования
- * @returns formatted number string or number/ форматированная строка числа или число
- */
-export declare function toNumberByMax(value: string | number, max?: string | number, formatting?: boolean, language?: string): string | number;

package/dist/functions/toNumberPositive.d.ts

@@ -1,9 +0,0 @@
-/**
- * Converts a value to a positive finite number (> 0), or returns default value (0) if invalid.
- *
- * Преобразует значение в конечное положительное число (> 0) или возвращает значение по умолчанию (0), если невалидно.
- * @param value input value / входное значение
- * @param defaultValue default fallback value if invalid / значение по умолчанию, если невалидно
- * @returns parsed positive number or defaultValue / распарсенное положительное число или defaultValue
- */
-export declare function toNumberPositive(value?: number | string | null, defaultValue?: number): number;

package/dist/functions/toPercent.d.ts

@@ -1,9 +0,0 @@
-/**
- * Converts values to percentages
- *
- * Преобразует значения в проценты
- * @param maxValue maximum value/ максимальное значение
- * @param value current value/ текущее значение
- * @returns percentage value / значение в процентах
- */
-export declare function toPercent(maxValue: number, value: number): number;

package/dist/functions/toPercentBy100.d.ts

@@ -1,9 +0,0 @@
-/**
- * Converts values to percentages (three-digit)
- *
- * Преобразует значения в проценты (трёхзначный)
- * @param maxValue maximum value/ максимальное значение
- * @param value current value/ текущее значение
- * @returns percentage value * 100 / значение в процентах * 100
- */
-export declare function toPercentBy100(maxValue: number, value: number): number;

package/dist/functions/toString.d.ts

@@ -1,8 +0,0 @@
-/**
- * Converts the given value to a string. Returns an empty string if the value is null or undefined.
- *
- * Преобразование значения в строку. Возвращает пустую строку, если значение равно null или undefined.
- * @param value value for conversion / значение для преобразования
- * @returns string representation of the value / строковое представление значения
- */
-export declare function toString<T>(value: T): string;

package/dist/functions/transformation.d.ts

@@ -1,21 +0,0 @@
-/**
- * Преобразует строку в соответствующий тип данных.
- * В зависимости от содержания строки, она может быть преобразована в
- * `undefined`, `null`, `true`, `false`, объект, число или функцию.
- *
- * Transforms a string into the corresponding data type.
- * Based on the string content, it may be transformed into `undefined`,
- * `null`, `true`, `false`, object, number, or function.
- *
- * @param value - Значение, которое необходимо преобразовать
- *
- * The value to be transformed
- * @param isFunction - Флаг, который указывает, необходимо ли проверять функцию
- * в глобальном объекте window
- *
- * A flag that indicates whether to check for a function in the global window object
- * @returns Преобразованное значение
- *
- * The transformed value
- */
-export declare function transformation(value: any, isFunction?: boolean): any;

package/dist/functions/uint8ArrayToBase64.d.ts

@@ -1,8 +0,0 @@
-/**
- * Converts a Uint8Array to a base64 encoded string.
- *
- * Преобразует Uint8Array в строку, закодированную в base64.
- * @param bytes binary data as Uint8Array / бинарные данные в виде Uint8Array
- * @returns base64 encoded string / строка, закодированная в base64
- */
-export declare function uint8ArrayToBase64(bytes: Uint8Array): string;

package/dist/functions/uniqueArray.d.ts

@@ -1,8 +0,0 @@
-/**
- * Removes duplicate entries in an array.
- *
- * Удаляет повторяющиеся записи в массиве.
- * @param value input value/ входное значение
- * @returns array without duplicates / массив без дубликатов
- */
-export declare function uniqueArray<T>(value: T[]): T[];

package/dist/functions/writeClipboardData.d.ts

@@ -1,8 +0,0 @@
-/**
- * Writes data to the buffer.
- *
- * Записывает данные в буфер.
- * @param text text for recording/ текст для записи
- * @returns promise without return value / промис без возвращаемого значения
- */
-export declare function writeClipboardData(text: string): Promise<void>;

package/dist/media/errorCauseList.d.ts

@@ -1,2 +0,0 @@
-import { ErrorCenterCauseList } from '../types/errorCenterTypes';
-export declare const errorCauseList: ErrorCenterCauseList;

package/dist/types/apiTypes.d.ts

@@ -1,259 +0,0 @@
-import { ApiErrorItem } from '../classes/ApiErrorItem';
-/**
- * Supported HTTP methods for API requests.
- * Поддерживаемые HTTP-методы для API-запросов.
- */
-export declare enum ApiMethodItem {
-    /**
-     * HTTP DELETE — used to delete resources.
-     * HTTP DELETE — используется для удаления ресурсов.
-     */
-    delete = "DELETE",
-    /**
-     * HTTP GET — used to retrieve resources (no request body).
-     * HTTP GET — используется для получения ресурсов (без тела запроса).
-     */
-    get = "GET",
-    /**
-     * HTTP POST — used to create resources or send data.
-     * HTTP POST — используется для создания ресурсов или отправки данных.
-     */
-    post = "POST",
-    /**
-     * HTTP PUT — used to update/replace resources.
-     * HTTP PUT — используется для обновления/замены ресурсов.
-     */
-    put = "PUT",
-    /**
-     * HTTP PATCH — used to partially update resources.
-     * HTTP PATCH — используется для частичного обновления ресурсов.
-     */
-    patch = "PATCH"
-}
-/**
- * Saved value in cache/ Сохраненное значение в кэше
- */
-export type ApiCacheItem<T = any> = {
-    /** Saved value / Сохраненное значение */
-    value: T;
-    /** Age of the cache / Возраст кэша */
-    age?: number;
-    /** Cache age in seconds / Возраст кэша в секундах */
-    cacheAge: number;
-};
-/**
- * List of saved values in cache/ Список сохраненных значений в кэше
- */
-export type ApiCacheList = Record<string, ApiCacheItem>;
-/**
- * API configuration/ Конфигурация API
- */
-export type ApiConfig = {
-    /** Base URL for API requests/ Базовый URL для API-запросов */
-    urlRoot?: string;
-    /** Base origin for API requests (protocol and domain)/ Базовый источник для API-запросов (протокол и домен) */
-    origin?: string;
-    /** Default headers for API requests/ Заголовки по умолчанию для API-запросов */
-    headers?: ApiHeadersValue;
-    /** Default request data for API requests/ Данные запроса по умолчанию для API-запросов */
-    requestDefault?: ApiDefaultValue;
-    /** Function to call before request/ Функция для вызова перед запросом */
-    preparation?: (apiFetch: ApiFetch) => Promise<void>;
-    /** Function to call after request/ Функция для вызова после запроса */
-    end?: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>;
-    /** Timeout for the request in milliseconds/ Таймаут запроса в миллисекундах */
-    timeout?: number;
-    /** Enable development logging/ Включить логирование разработки */
-    devMode?: boolean;
-    /** Wrapper function for requests / Функция-обертка для запросов */
-    wrapper?: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>;
-};
-/**
- * Shape of API response data wrapper/ Структура обёртки данных ответа API
- */
-export type ApiData<T = any> = T extends any[] ? T : ApiDataItem<T>;
-/**
- * API response validation result/ Результат валидации ответа API
- */
-export type ApiDataValidation = {
-    /** Status/ Статус */
-    status?: ApiStatusType;
-    /** Code / Код */
-    code?: string | number;
-    /** Message/ Сообщение */
-    message?: string;
-    /** Error/ Ошибка */
-    error?: {
-        /** Code / Код */
-        code?: string | number;
-        /** Message/ Сообщение */
-        message?: string;
-    };
-};
-/**
- * Type of API response data item/ Тип элемента данных ответа API
- */
-export type ApiDataItem<T = any> = T & ApiDataValidation & {
-    /** Primary payload (optional)/ Основная полезная нагрузка (опционально) */
-    data?: T;
-    /** Success flag/ Флаг успешности */
-    success?: boolean;
-    /** Status object/ Объект статуса */
-    statusObject?: ApiStatusItem;
-    /** Error object/ Объект ошибки */
-    errorObject?: ApiErrorItem;
-};
-/**
- * Type for API request headers / Тип для заголовков запроса API
- */
-export type ApiHeadersValue = Record<string, string> | (() => Record<string, string>);
-/**
- * Default API request data type/ Тип данных запроса API по умолчанию
- */
-export type ApiDefaultValue = Record<string, any> | (() => Record<string, any>);
-/**
- * Options for making API requests/ Опции для выполнения API-запросов
- */
-export type ApiFetch = {
-    /** Use base API URL/ Использовать базовый URL API */
-    api?: boolean;
-    /** Endpoint path relative to base URL/ Путь endpoint относительно базового URL */
-    path?: string;
-    /** Complete URL (overrides api + path)/ Полный URL (переопределяет api + path) */
-    pathFull?: string;
-    /** HTTP method/ HTTP метод */
-    method?: ApiMethod;
-    /** Request body data or query parameters/ Данные тела запроса или параметры запроса */
-    request?: FormData | Record<string, any> | string;
-    /** Include authentication headers/ Включить заголовки аутентификации */
-    auth?: boolean;
-    /** Custom headers (null = no headers)/ Пользовательские заголовки (null = без заголовков) */
-    headers?: Record<string, string> | null;
-    /** Content-Type header value/ Значение заголовка Content-Type */
-    type?: string;
-    /** Extract 'data' field from response/ Извлечь поле 'data' из ответа */
-    toData?: boolean;
-    /** Use global response cache/ Использовать глобальный кеш ответов */
-    global?: boolean;
-    /** Enable development logging/ Включить логирование разработки */
-    devMode?: boolean;
-    /** Suppress error logging/ Подавить логирование ошибок */
-    hideError?: boolean;
-    /** Suppress loading/ Подавить загрузку */
-    hideLoading?: boolean;
-    /** Retry count/ Количество повторов */
-    retry?: number;
-    /** Retry delay in milliseconds/ Задержка повтора в миллисекундах */
-    retryDelay?: number;
-    /** Custom response processor/ Пользовательский процессор ответа */
-    queryReturn?: (query: Response) => Promise<any | ApiDataValidation>;
-    /** Run global preparation hooks/ Запускать глобальные хуки подготовки */
-    globalPreparation?: boolean;
-    /** Run global end hooks/ Запускать глобальные хуки завершения */
-    globalEnd?: boolean;
-    /** Additional fetch() options/ Дополнительные опции fetch() */
-    init?: RequestInit;
-    initError?: boolean;
-    /** Timeout for the request in milliseconds/ Таймаут запроса в миллисекундах */
-    timeout?: number;
-    /** AbortController for canceling the request/ AbortController для отмены запроса */
-    controller?: AbortController;
-    /** Cache age in seconds/ Возраст кэша в секундах */
-    cache?: number;
-    enableClientCache?: boolean;
-    /** Cache ID for grouping/ ID кэша для группировки */
-    cacheId?: number | string;
-    /** Limit of end reset/ Лимит сброса end */
-    endResetLimit?: number;
-    /** Wrapper function for requests / Функция-обертка для запросов */
-    wrapper?: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>;
-};
-/**
- * Type of API hydration item/ Тип элемента гидратации API
- */
-export type ApiHydrationItem = {
-    /** Path string or RegExp to match request URL/ Путь или RegExp для сопоставления URL */
-    path: string;
-    /** Expected HTTP method/ Ожидаемый HTTP метод */
-    method: ApiMethod;
-    /** Expected request payload or special marker '*any'/ Ожидаемая нагрузка запроса или маркер '*any' */
-    request?: ApiFetch['request'];
-    /** Static response or factory function/ Статический ответ или функция, возвращающая ответ */
-    response: any;
-};
-/**
- * List of API hydration items/ Список элементов гидратации API
- */
-export type ApiHydrationList = ApiHydrationItem[];
-/**
- * Item for API error storage/ Элемент для хранилища ошибок API
- */
-export type ApiErrorStorageItem = Record<string, any> & {
-    /** URL string or RegExp to match request URL/ Строка URL или RegExp для сопоставления URL */
-    url: string | RegExp;
-    /** HTTP method/ HTTP метод */
-    method: ApiMethodItem;
-    /** Error code/ Код ошибки */
-    code?: string;
-    /** HTTP status code/ Код статуса HTTP */
-    status?: number;
-    /** Validation function/ Функция валидации */
-    validation?: (response: Response) => boolean;
-    /** Error message or function that returns message/ Сообщение об ошибке или функция, возвращающая сообщение */
-    message?: string | ((response?: Response) => string);
-};
-/**
- * List of API error storage items/ Список элементов хранилища ошибок API
- */
-export type ApiErrorStorageList = ApiErrorStorageItem[];
-/**
- * Supported HTTP methods type/ Тип HTTP-методов
- * (derived from ApiMethodItem enum)/ (получен из перечисления ApiMethodItem)
- */
-export type ApiMethod = string | ApiMethodItem;
-/**
- * Result of global preparation/end hooks/ Результат глобальных хуков
- */
-export type ApiPreparationEnd = {
-    /** Reset flag to indicate state reset/ Флаг сброса состояния */
-    reset?: boolean;
-    /** Arbitrary data returned by hook/ Произвольные данные, возвращаемые хуком */
-    data?: any;
-};
-/**
- * Mock API response descriptor/ Описание мок-ответа API
- */
-export type ApiResponseItem = {
-    /** Path string or RegExp to match request URL/ Путь или RegExp для сопоставления URL */
-    path: string | RegExp;
-    /** Expected HTTP method/ Ожидаемый HTTP метод */
-    method: ApiMethod;
-    /** Expected request payload or special marker '*any'/ Ожидаемая нагрузка запроса или маркер '*any' */
-    request?: ApiFetch['request'] | '*any';
-    /** Static response or factory function/ Статический ответ или функция, возвращающая ответ */
-    response: any | ((request?: ApiFetch['request']) => any);
-    /** Disable this mock/ Отключить этот мок */
-    disable?: any;
-    /** Mark as global mock/ Мок для глобального использования */
-    isForGlobal?: boolean;
-    /** Simulate network lag/ Имитировать задержку */
-    lag?: any;
-};
-export type ApiStatusItem = {
-    /** HTTP status code/ Код статуса HTTP */
-    status?: number;
-    /** HTTP status text/ Текст статуса HTTP */
-    statusText?: string;
-    /** Error message/ Сообщение об ошибке */
-    error?: string;
-    /** Last response/ Последний ответ */
-    lastResponse?: any;
-    /** Last status/ Последний статус */
-    lastStatus?: ApiStatusType;
-    /** Last code / Последний код */
-    lastCode?: string;
-    /** Last message/ Последнее сообщение */
-    lastMessage?: string;
-};
-/** API status type/ Тип статуса API */
-export type ApiStatusType = 'success' | 'error' | 'warning' | 'info';

package/dist/types/basicTypes.d.ts

@@ -1,131 +0,0 @@
-/** Union type for undefined and null values/ Объединенный тип для undefined и null значений */
-export type Undefined = undefined | null;
-/**
- * Union type for all "empty" values including falsy primitives and string representations/
- * Объединенный тип для всех "пустых" значений включая ложные примитивы и строковые представления
- */
-export type EmptyValue = Undefined | 0 | false | '' | 'undefined' | 'null' | '0' | 'false' | '[]';
-/** Union type for numeric and string values/ Объединенный тип для числовых и строковых значений */
-export type NumberOrString = number | string;
-/**
- * Union type for numeric, string, and boolean values/
- * Объединенный тип для числовых, строковых и булевых значений
- */
-export type NumberOrStringOrBoolean = number | string | boolean;
-/**
- * Union type for numeric, string, and Date values/
- * Объединенный тип для числовых, строковых значений и Date
- */
-export type NumberOrStringOrDate = NumberOrString | Date;
-/**
- * Generic type that can be either a single value or an array of values/
- * Дженерик тип для одиночного значения или массива значений
- */
-export type NormalOrArray<T = NumberOrString> = T | T[];
-/**
- * Generic type that can be either a direct value or a Promise resolving to that value/
- * Дженерик тип для прямого значения или Promise
- */
-export type NormalOrPromise<T> = T | Promise<T>;
-/**
- * Generic record/object type with string keys/
- * Дженерик тип записи/объекта со строковыми ключами
- */
-export type ObjectItem<T = any> = Record<string, T>;
-/** Generic type that can be either an array or an object/ Дженерик тип для массива или объекта */
-export type ObjectOrArray<T = any> = T[] | ObjectItem<T>;
-/**
- * Converts an array type to an item type (extracts the item type from an array)/
- * Преобразует тип массива в тип элемента (извлекает тип элемента из массива)
- */
-export type ArrayToItem<T> = T extends any[] ? T[number] : T;
-/**
- * Function type that returns a value of type R/
- * Тип функции, возвращающей значение типа R
- */
-export type FunctionReturn<R = any> = () => R;
-/** Function type that returns void/ Тип функции, возвращающей void */
-export type FunctionVoid = () => void;
-/**
- * Function type that accepts multiple arguments of type T and returns type R/
- * Тип функции с переменными аргументами
- */
-export type FunctionArgs<T, R> = (...args: T[]) => R;
-/**
- * Most generic function type that accepts any arguments and returns any value/
- * Наиболее общий тип функции
- */
-export type FunctionAnyType<T = any, R = any> = (...args: T[]) => R;
-/**
- * Generic record type for lists with string keys/
- * Дженерик тип записи для списков со строковыми ключами
- */
-export type ItemList<T = any> = Record<string, T>;
-/**
- * Generic item type with index and value properties/
- * Дженерик тип элемента со свойствами index и value
- */
-export type Item<V> = {
-    /** Unique string identifier for the item/ Уникальный строковый идентификатор элемента */
-    index: string;
-    /** The actual value of the item/ Фактическое значение элемента */
-    value: V;
-};
-/**
- * Generic item type with label and value properties/
- * Дженерик тип элемента со свойствами label и value
- */
-export type ItemValue<V> = {
-    /** Display text for the item/ Отображаемый текст для элемента */
-    label: string;
-    /** The actual value of the item/ Фактическое значение элемента */
-    value: V;
-};
-/**
- * Generic item type with name and value properties/
- * Дженерик тип элемента со свойствами name и value
- */
-export type ItemName<V> = {
-    /** Name identifier (string or number)/ Идентификатор имени (строка или число) */
-    name: string | number;
-    /** The actual value of the item/ Фактическое значение элемента */
-    value: V;
-};
-/**
- * Union type for HTML elements and Window object/
- * Объединенный тип для HTML элементов и объекта Window
- */
-export type ElementOrWindow = HTMLElement | Window;
-/**
- * Generic type that can be either an element or a string selector/
- * Дженерик тип для элемента или строкового селектора
- */
-export type ElementOrString<E extends ElementOrWindow> = E | string;
-/** Type for event listener options/ Тип для опций обработчика событий */
-export type EventOptions = AddEventListenerOptions | boolean | undefined;
-/**
- * Generic event listener function type with additional detail parameter/
- * Дженерик тип функции обработчика событий с дополнительным параметром detail
- */
-export type EventListenerDetail<O extends Event, D extends Record<string, any>> = (event: O, detail?: D) => void;
-/**
- * Type for tracking active event listeners and observers/
- * Тип для отслеживания активных обработчиков событий и наблюдателей
- */
-export type EventActivityItem<E extends ElementOrWindow> = {
-    /** The target element for the event/ Целевой элемент для события */
-    element: E | undefined;
-    /** The event type name/ Название типа события */
-    type: string;
-    /** Optional custom event listener/ Опциональный пользовательский обработчик событий */
-    listener?: (event: any | Event) => void;
-    /** Optional ResizeObserver instance/ Опциональный экземпляр ResizeObserver */
-    observer?: ResizeObserver;
-};
-/** Type for 2D coordinates/ Тип для 2D координат */
-export type ImageCoordinator = {
-    /** X-axis coordinate/ Координата по оси X */
-    x: number;
-    /** Y-axis coordinate/ Координата по оси Y */
-    y: number;
-};

package/dist/types/errorCenterTypes.d.ts

@@ -1,50 +0,0 @@
-/**
- * Error group identifier / Идентификатор группы ошибок
- */
-export type ErrorCenterGroup = string | undefined;
-/**
- * Interface for an error item / Интерфейс для элемента ошибки
- */
-export type ErrorCenterCauseItem<D = any> = {
-    /** Error group / Группа ошибки */
-    group?: ErrorCenterGroup;
-    /** Error code / Код ошибки */
-    code: string;
-    /** Priority / Приоритет */
-    priority?: number;
-    /** Error label / Название ошибки */
-    label?: string;
-    /** Error message / Сообщение ошибки */
-    message?: string;
-    /** Additional details / Дополнительные детали */
-    details?: D;
-};
-/**
- * List of error items / Список элементов ошибок
- */
-export type ErrorCenterCauseList = ErrorCenterCauseItem[];
-/**
- * Callback function for error handling / Функция обратного вызова для обработки ошибок
- */
-export type ErrorCenterHandlerCallback = (cause: ErrorCenterCauseItem) => void;
-/**
- * Interface for error handler storage / Интерфейс для хранения обработчика ошибок
- */
-export type ErrorCenterHandlerItem = {
-    /** Targeted error group / Целевая группа ошибок */
-    group?: ErrorCenterGroup;
-    /** List of handlers / Список обработчиков */
-    handlers: ErrorCenterHandlerCallback[];
-};
-/**
- * List of error handlers / Список обработчиков ошибок
- */
-export type ErrorCenterHandlerList = ErrorCenterHandlerItem[];
-/**
- * Callback function to check whether to log error to console / Функция обратного вызова для проверки вывода ошибки в консоль
- */
-export type ErrorCenterHandlerIsConsoleCallback = (cause: ErrorCenterCauseItem) => boolean;
-/**
- * Type for console logging configuration / Тип для конфигурации вывода в консоль
- */
-export type ErrorCenterHandlerIsConsole = boolean | ErrorCenterHandlerIsConsoleCallback;