@dxtmisha/functional-basic 1.1.0 → 1.1.6

package/dist/media/errorCauseList.d.ts

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

package/dist/types/apiTypes.d.ts

@@ -0,0 +1,217 @@
+/**
+ * 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?: Record<string, string>;
+    /** Default request data for API requests/ Данные запроса по умолчанию для API-запросов */
+    requestDefault?: Record<string, any>;
+    /** 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;
+};
+/**
+ * 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;
+};
+/**
+ * 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;
+};
+/**
+ * Default API request data type/ Тип данных запроса API по умолчанию
+ */
+export type ApiDefaultValue = 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;
+    /** 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;
+};
+/**
+ * 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[];
+/**
+ * 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

@@ -0,0 +1,131 @@
+/** 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/errorCenter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Error group identifier / Идентификатор группы ошибок
+ */
+export type ErrorCenterGroup = string | undefined;
+/**
+ * Interface for an error item / Интерфейс для элемента ошибки
+ */
+export type ErrorCenterCauseItem = {
+    /** Error group / Группа ошибки */
+    group?: ErrorCenterGroup;
+    /** Error code / Код ошибки */
+    code: string;
+    /** Priority / Приоритет */
+    priority?: number;
+    /** Error label / Название ошибки */
+    label?: string;
+    /** Error message / Сообщение ошибки */
+    message?: string;
+    /** Additional details / Дополнительные детали */
+    details?: any;
+};
+/**
+ * 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[];

package/dist/types/formattersTypes.d.ts

@@ -0,0 +1,224 @@
+import { ArrayToItem } from './basicTypes';
+import { GeoDate } from './geoTypes';
+/**
+ * Enumeration of available formatter types.
+ *
+ * Перечисление доступных типов форматировщиков.
+ */
+export declare enum FormattersType {
+    /** Currency formatting / Форматирование валюты. */
+    currency = "currency",
+    /** Date formatting / Форматирование даты. */
+    date = "date",
+    /** Name formatting / Форматирование имени. */
+    name = "name",
+    /** Number formatting / Форматирование чисел. */
+    number = "number",
+    /** Plural forms formatting / Форматирование форм множественного числа. */
+    plural = "plural",
+    /** Unit formatting (e.g., meters, kilograms) / Форматирование единиц измерения (например, метры, килограммы). */
+    unit = "unit"
+}
+/**
+ * Options for currency formatting.
+ *
+ * Параметры для форматирования валюты.
+ */
+export type FormattersOptionsCurrency = {
+    /** The name of the property in the data item that contains the currency code / Имя свойства в элементе данных, которое содержит код валюты. */
+    currencyPropName?: string;
+    /** Currency code or international number format options / Код валюты или международные параметры форматирования чисел. */
+    options?: string | Intl.NumberFormatOptions;
+    /** If true, only the numeric value will be returned / Если true, будет возвращено только числовое значение. */
+    numberOnly?: boolean;
+};
+/**
+ * Options for date formatting.
+ *
+ * Параметры для форматирования даты.
+ */
+export type FormattersOptionsDate = {
+    /** The type of date representation / Тип представления даты. */
+    type?: GeoDate;
+    /** International date-time format options / Междунар. параметры форматирования даты и времени. */
+    options?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions;
+    /** Use 24-hour format if true / Использовать 24-часовой формат, если true. */
+    hour24?: boolean;
+};
+/**
+ * Options for name formatting.
+ *
+ * Параметры для форматирования имени.
+ */
+export type FormattersOptionsName = {
+    /** Property name for the last name / Имя свойства для фамилии. */
+    lastPropName?: string;
+    /** Property name for the first name / Имя свойства для имени. */
+    firstPropName?: string;
+    /** Property name for the middle name / Имя свойства для отчества. */
+    surname?: string;
+    /** If true, returns a short version of the name / Если true, возвращает сокращенную версию имени. */
+    short?: boolean;
+};
+/**
+ * Options for number formatting.
+ *
+ * Параметры для форматирования чисел.
+ */
+export type FormattersOptionsNumber = {
+    /** International number format options / Междунар. параметры форматирования чисел. */
+    options?: Intl.NumberFormatOptions;
+};
+/**
+ * Options for plural forms formatting.
+ *
+ * Параметры для форматирования форм множественного числа.
+ */
+export type FormattersOptionsPlural = {
+    /** A string containing plural forms / Строка, содержащая формы множественного числа. */
+    words: string;
+    /** International plural rules options / Междунар. параметры правил множественного числа. */
+    options?: Intl.PluralRulesOptions;
+    /** International number format options for the numeric part / Междунар. параметры форматирования чисел для числовой части. */
+    optionsNumber?: Intl.NumberFormatOptions;
+};
+/**
+ * Options for unit formatting.
+ *
+ * Параметры для форматирования единиц измерения.
+ */
+export type FormattersOptionsUnit = {
+    /** The unit to format or international number format options / Ед. изм. для форматирования или междунар. параметры форматирования чисел. */
+    unit: string | Intl.NumberFormatOptions;
+};
+/**
+ * Mapping of formatter types to their respective option types.
+ *
+ * Соответствие типов форматировщиков их типам параметров.
+ *
+ * @template Type - The formatter type / Тип форматировщика.
+ */
+export type FormattersOptionsInformation<Type extends FormattersType> = Type extends FormattersType.currency ? FormattersOptionsCurrency : Type extends FormattersType.date ? FormattersOptionsDate : Type extends FormattersType.name ? FormattersOptionsName : Type extends FormattersType.number ? FormattersOptionsNumber : Type extends FormattersType.plural ? FormattersOptionsPlural : Type extends FormattersType.unit ? FormattersOptionsUnit : Record<string, any>;
+/**
+ * Configuration for a single property formatter.
+ *
+ * Конфигурация для форматировщика одного свойства.
+ *
+ * @template Type - The type of formatter / Тип форматировщика.
+ * @template R - The return type / Возвращаемый тип.
+ */
+export type FormattersOptionsItem<Type extends FormattersType = FormattersType, R = string> = {
+    /** The type of formatter / Тип форматировщика. */
+    type?: Type;
+    /** Custom transformation function / Пользовательская функция преобразования. */
+    transformation?: (valueOriginal: any, item: any, options?: FormattersOptionsInformation<Type>) => R;
+    /** Options for the specified formatter type / Параметры для указанного типа форматировщика. */
+    options?: FormattersOptionsInformation<Type>;
+};
+/**
+ * A dictionary mapping property paths to their formatting configurations.
+ *
+ * Словарь, сопоставляющий пути к свойствам с их конфигурациями форматирования.
+ */
+export type FormattersOptionsList = Record<string, FormattersOptionsItem>;
+/**
+ * Represents a single data item as a key-value record.
+ *
+ * Представляет один элемент данных как запись "ключ-значение".
+ */
+export type FormattersListItem = Record<string, any>;
+/**
+ * An array of data items to be formatted.
+ *
+ * Массив элементов данных для форматирования.
+ *
+ * @template Item - The type of data items / Тип элементов данных.
+ */
+export type FormattersList<Item extends FormattersListItem> = Item[];
+/**
+ * Utility type to capitalize a camelCase or dot-notated string.
+ *
+ * Вспомогательный тип для капитализации строки.
+ *
+ * @template K - The string to capitalize / Строка для капитализации.
+ */
+export type FormattersCapitalize<K extends string> = K extends `${infer First}.${infer Rest}` ? `${First}${Capitalize<FormattersCapitalize<Rest>>}` : K;
+/**
+ * Utility type to extract column keys from formatting options.
+ *
+ * Вспомогательный тип для извлечения ключей столбцов.
+ *
+ * @template T - The formatting options list type / Тип списка параметров форматирования.
+ */
+export type FormattersColumns<T extends FormattersOptionsList> = (keyof T & string)[];
+/**
+ * Utility type to generate a formatted property key.
+ *
+ * Вспомогательный тип для генерации ключа отформатированного свойства.
+ *
+ * @template K - The original property key / Ключ исходного свойства.
+ * @template A - The suffix to add / Суффикс.
+ */
+export type FormattersKey<K, A extends string = 'Format'> = K extends string ? `${FormattersCapitalize<K>}${A}` : never;
+/**
+ * Represents a data item with additional formatted properties.
+ *
+ * Представляет элемент данных с доп. отформатированными свойствами.
+ *
+ * @template T - The original item type / Исходный тип элемента.
+ * @template KT - Array of property keys / Массив ключей свойств.
+ */
+export type FormattersDataItem<T extends FormattersListItem, KT extends string[]> = {
+    [K in keyof T | FormattersKey<KT[number]>]: K extends keyof T ? T[K] : string;
+};
+/**
+ * An array of data items with additional formatted properties.
+ *
+ * Массив элементов данных с доп. отформатированными свойствами.
+ *
+ * @template T - The original item type / Исходный тип элемента.
+ * @template K - Array of property keys / Массив ключей свойств.
+ */
+export type FormattersListFormat<T extends FormattersListItem, K extends string[]> = FormattersDataItem<T, K>[];
+/**
+ * A single data item formatted based on the provided options list.
+ *
+ * Один элемент данных, отформатированный на основе параметров.
+ *
+ * @template T - The original item type / Исходный тип элемента.
+ * @template O - The formatting options / Параметры форматирования.
+ */
+export type FormattersListColumnItem<T extends FormattersListItem, O extends FormattersOptionsList> = FormattersDataItem<T, FormattersColumns<O>>;
+/**
+ * A list of data items formatted based on the provided options list.
+ *
+ * Список элементов данных, отформатированных на основе параметров.
+ *
+ * @template T - The original item type / Исходный тип элемента.
+ * @template O - The formatting options / Параметры форматирования.
+ */
+export type FormattersListColumns<T extends FormattersListItem, O extends FormattersOptionsList> = FormattersListFormat<T, FormattersColumns<O>>;
+/**
+ * Possible formats for input data: either a single item or a list of items.
+ *
+ * Возможные форматы входных данных: либо один элемент, либо список элементов.
+ */
+export type FormattersListProp = FormattersList<FormattersListItem> | FormattersListItem;
+/**
+ * Extracts the single item type from a single item or a list of items.
+ *
+ * Извлекает тип одного элемента из одного элемента или из списка элементов.
+ *
+ * @template List - The type of the input data / Тип входных данных.
+ */
+export type FormattersItemProp<List extends FormattersListProp> = ArrayToItem<List>;
+/**
+ * The return type of the formatter, matching the structure of the input data.
+ *
+ * Возвращаемый тип форматировщика, соответствующий структуре входных данных.
+ *
+ * @template List - The input data type / Тип входных данных.
+ * @template Options - The formatting options / Параметры форматирования.
+ * @template Item - The type of a single item / Тип одного элемента.
+ */
+export type FormattersReturn<List extends FormattersListProp, Options extends FormattersOptionsList = FormattersOptionsList, Item extends FormattersItemProp<List> = FormattersItemProp<List>> = List extends any[] ? FormattersListColumns<Item, Options> : (FormattersListColumnItem<Item, Options> | undefined);