@dxtmisha/functional 1.11.6 → 1.11.7

package/dist/classes/ref/RouterItemRef.d.ts

@@ -0,0 +1,61 @@
+import { RouteLocationRaw, Router } from 'vue-router';
+import { ConstrHrefProps } from '../../types/constructorTypes';
+/**
+ * Router management class.
+ *
+ * Класс управления роутером.
+ */
+export declare class RouterItemRef {
+    /**
+     * Get router instance.
+     *
+     * Получить экземпляр роутера.
+     */
+    static get(): Router;
+    /**
+     * Returns the link by name.
+     *
+     * Возвращает ссылку по имени.
+     * @param name route name/ имя маршрута
+     * @param params route parameters/ параметры маршрута
+     * @param query route query/ запрос маршрута
+     */
+    static getLink(name: string, params?: any, query?: any): string | undefined;
+    /**
+     * Returns the link property by name.
+     *
+     * Возвращает свойство ссылки по имени.
+     * @param name route name/ имя маршрута
+     * @param params route parameters/ параметры маршрута
+     * @param query route query/ запрос маршрута
+     */
+    static getHref(name?: string, params?: any, query?: any): ConstrHrefProps;
+    /**
+     * Site path change.
+     *
+     * Изменение пути сайта.
+     * @param to new path/ новый путь
+     */
+    static push(to: string | RouteLocationRaw): void;
+    /**
+     * Set router instance.
+     *
+     * Установить экземпляр роутера.
+     * @param router router instance/ экземпляр роутера
+     */
+    static set(router: Router): void;
+    /**
+     * Set router instance only once.
+     *
+     * Установить экземпляр роутера только один раз.
+     * @param router router instance/ экземпляр роутера
+     */
+    static setOneTime(router: Router): void;
+    /**
+     * Converts the raw route location to href properties.
+     *
+     * Преобразует необработанное местоположение маршрута в свойства href.
+     * @param to raw route location/ необработанное местоположение маршрута
+     */
+    static rawToHref(to?: string | RouteLocationRaw): ConstrHrefProps;
+}

package/dist/classes/ref/ScrollbarWidthRef.d.ts

@@ -0,0 +1,22 @@
+import { Ref, ComputedRef } from 'vue';
+/**
+ * Class for getting the scroll width as a reactive item.
+ *
+ * Класс для получения ширины скролла в виде реактивного элемента.
+ */
+export declare class ScrollbarWidthRef {
+    /** Reactive item/ Реактивный элемент */
+    readonly item: Ref<boolean | undefined, boolean | undefined>;
+    /** Reactive width/ Реактивная ширина */
+    readonly width: Ref<number, number>;
+    /**
+     * Constructor
+     */
+    constructor();
+    /**
+     * Checks whether the scroll width is defined.
+     *
+     * Проверяет, определена ли ширина скролла.
+     */
+    readonly is: ComputedRef<boolean>;
+}

package/dist/composables/ref/useApiAsyncRef.d.ts

@@ -0,0 +1,18 @@
+import { ApiInstance, ApiData, ApiDataValidation } from '@dxtmisha/functional-basic';
+import { UseApiRef } from './useApiRef';
+import { RefOrNormal, RefType } from '../../types/refTypes';
+import { ApiOptions } from '../../types/apiTypes';
+/**
+ * Executes a request and immediately initializes it asynchronously.
+ *
+ * Выполняет запрос и сразу инициализирует его асинхронно.
+ * @param path path to request / путь к запросу
+ * @param options data for the request / данные для запроса
+ * @param reactivity should reactivity be enabled / включить ли reactivity
+ * @param conditions conditions for executing the request / условия выполнения запроса
+ * @param transformation transforms the received request / преобразовывает полученный запрос
+ * @param validateResponseContract function to validate response data contract / функция для проверки контракта данных ответа
+ * @param unmounted delete data from the cache / удалить ли данные из кеша
+ * @param apiInstance Api instance / Экземпляр Api
+ */
+export declare function useApiAsyncRef<R, T = R>(path?: RefOrNormal<string | undefined>, options?: ApiOptions, reactivity?: boolean, conditions?: RefType<boolean>, transformation?: (data: T, isResponseContractValid?: ApiDataValidation) => ApiData<R>, validateResponseContract?: (data: T) => ApiDataValidation, unmounted?: boolean, apiInstance?: ApiInstance): UseApiRef<R>;

package/dist/composables/ref/useApiDelete.d.ts

@@ -0,0 +1,20 @@
+import { ApiInstance, ApiData, ApiFetch } from '@dxtmisha/functional-basic';
+import { ApiOptions } from '../../types/apiTypes';
+import { RefOrNormal } from '../../types/refTypes';
+import { Ref } from 'vue';
+/**
+ * Use API delete request.
+ *
+ * Использование API delete запроса.
+ * @param path Path to the API endpoint / Путь к endpoint API
+ * @param action Action to perform after the request / Действие, выполняемое после запроса
+ * @param transformation Transformation function / Функция трансформации
+ * @param toData Extract 'data' field from response / Извлечь поле 'data' из ответа
+ * @param options Additional request options / Дополнительные опции запроса
+ * @param apiInstance Api instance / Экземпляр Api
+ * @returns Object with loading state and send method / Объект с состоянием загрузки и методом отправки
+ */
+export declare function useApiDelete<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
+    loading: Ref<boolean, boolean>;
+    send(request?: Request | undefined): Promise<Return | undefined>;
+};

package/dist/composables/ref/useApiGet.d.ts

@@ -0,0 +1,20 @@
+import { ApiInstance, ApiData, ApiFetch } from '@dxtmisha/functional-basic';
+import { ApiOptions } from '../../types/apiTypes';
+import { RefOrNormal } from '../../types/refTypes';
+import { Ref } from 'vue';
+/**
+ * Use API get request.
+ *
+ * Использование API get запроса.
+ * @param path Path to the API endpoint / Путь к endpoint API
+ * @param action Action to perform after the request / Действие, выполняемое после запроса
+ * @param transformation Transformation function / Функция трансформации
+ * @param toData Extract 'data' field from response / Извлечь поле 'data' из ответа
+ * @param options Additional request options / Дополнительные опции запроса
+ * @param apiInstance Api instance / Экземпляр Api
+ * @returns Object with loading state and send method / Объект с состоянием загрузки и методом отправки
+ */
+export declare function useApiGet<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
+    loading: Ref<boolean, boolean>;
+    send(request?: Request | undefined): Promise<Return | undefined>;
+};

package/dist/composables/ref/useApiManagementAsyncRef.d.ts

@@ -0,0 +1,49 @@
+import { ApiInstance, ArrayToItem, FormattersListColumns, FormattersOptionsList, SearchColumns, SearchFormatList, ApiData, ApiFetch } from '@dxtmisha/functional-basic';
+import { ApiManagementGet, ApiManagementRequest, ApiManagementSearch, ApiManagementValue } from '../../types/apiTypes';
+import { ComputedRef, Ref } from 'vue';
+/**
+ * Executes an API management request and immediately initializes it asynchronously.
+ *
+ * Выполняет запрос управления API и сразу инициализирует его асинхронно.
+ * @template Return type of data returned by the API / тип данных, возвращаемых API
+ * @template FormattersOptions optional formatting rules / опциональные правила форматирования
+ * @template Post data type for POST creation request / тип данных для POST-запроса создания
+ * @template Put data type for PUT update request / тип данных для PUT-запроса обновления
+ * @template Delete data type for DELETE removal request / тип данных для DELETE-запроса удаления
+ * @template Type original data type (before transformation) / тип исходных данных (до трансформации)
+ * @template Item type of a single item in the data list / тип одного элемента из списка данных
+ * @template ItemFormatters item type after formatters are applied / тип элемента после применения форматировщиков
+ * @template Columns search columns derived from formatting / колонки, по которым производится поиск
+ *
+ * @param propsGet main GET request settings (path, reactivity, skeleton, etc.) / настройки главного GET-запроса
+ * @param formattersOptions optional reactive formatting rules / правила для реактивного форматирования данных
+ * @param searchOptions optional client-side search settings / настройки для клиентского поиска по списку
+ * @param postRequest optional POST mutation settings / настройки для POST-запроса создания
+ * @param putRequest optional PUT mutation settings / настройки для PUT-запроса обновления
+ * @param deleteRequest optional DELETE mutation settings / настройки для DELETE-запроса удаления
+ * @param action common callback executed after any successful mutation / общий коллбэк после любой успешной мутации
+ * @param apiInstance API instance for requests (defaults to Api.getItem()) / экземпляр API для выполнения запроса
+ */
+export declare function useApiManagementAsyncRef<Return extends ApiManagementValue, FormattersOptions extends FormattersOptionsList, Post extends Record<string, any>, Put extends Record<string, any>, Delete extends Record<string, any>, Type extends ApiManagementValue = Return, Item extends ArrayToItem<Return> = ArrayToItem<Return>, ItemFormatters extends FormattersListColumns<Item, FormattersOptions>[number] = FormattersListColumns<Item, FormattersOptions>[number], Columns extends SearchColumns<ItemFormatters> = []>(propsGet: ApiManagementGet<Return, Type>, formattersOptions?: FormattersOptions, searchOptions?: ApiManagementSearch<Item, Columns>, postRequest?: ApiManagementRequest<Post>, putRequest?: ApiManagementRequest<Put>, deleteRequest?: ApiManagementRequest<Delete>, action?: () => Promise<void> | void, apiInstance?: ApiInstance): {
+    isValid: ComputedRef<boolean>;
+    list: ComputedRef<SearchFormatList<ItemFormatters, Columns>>;
+    readonly data: ComputedRef< ApiData<Return> | undefined>;
+    readonly length: ComputedRef<number>;
+    lengthData: ComputedRef<number>;
+    starting: ComputedRef<boolean>;
+    reading: Ref<boolean, boolean>;
+    loading: Ref<boolean, boolean>;
+    loadingSearch: Ref<boolean, boolean> | undefined;
+    loadingPost: Ref<boolean, boolean> | undefined;
+    loadingPut: Ref<boolean, boolean> | undefined;
+    loadingDelete: Ref<boolean, boolean> | undefined;
+    isSearch: ComputedRef<boolean> | undefined;
+    search: Ref<string, string> | undefined;
+    init: () => void;
+    initSsr: () => void;
+    reset: () => Promise<void>;
+    abort: () => void;
+    sendPost: (request?: ApiFetch["request"]) => Promise< ApiData<Post> | undefined>;
+    sendPut: (request?: ApiFetch["request"]) => Promise< ApiData<Put> | undefined>;
+    sendDelete: (request?: ApiFetch["request"]) => Promise< ApiData<Delete> | undefined>;
+};

package/dist/composables/ref/useApiManagementRef.d.ts

@@ -0,0 +1,155 @@
+import { FormattersOptionsList, ApiData, ApiInstance, ArrayToItem, SearchColumns, SearchFormatList, FormattersListColumns, ApiFetch } from '@dxtmisha/functional-basic';
+import { ApiManagementGet, ApiManagementRequest, ApiManagementSearch, ApiManagementValue } from '../../types/apiTypes';
+import { ComputedRef, Ref } from 'vue';
+/**
+ * A powerful composable for comprehensive API request orchestration.
+ * It centrally manages data loading (GET), list formatting, client-side searching,
+ * and mutations (POST, PUT, DELETE) through a single reactive interface.
+ *
+ * Мощный композабл для комплексной оркестрации API-запросов.
+ * Он централизованно управляет загрузкой данных (GET), форматированием списков,
+ * клиентским поиском и мутациями (POST, PUT, DELETE) через единый реактивный интерфейс.
+ *
+ * @template Return type of data returned by the API / тип данных, возвращаемых API
+ * @template FormattersOptions optional formatting rules / опциональные правила форматирования
+ * @template Post data type for POST creation request / тип данных для POST-запроса создания
+ * @template Put data type for PUT update request / тип данных для PUT-запроса обновления
+ * @template Delete data type for DELETE removal request / тип данных для DELETE-запроса удаления
+ * @template Type original data type (before transformation) / тип исходных данных (до трансформации)
+ * @template Item type of a single item in the data list / тип одного элемента из списка данных
+ * @template ItemFormatters item type after formatters are applied / тип элемента после применения форматировщиков
+ * @template Columns search columns derived from formatting / колонки, по которым производится поиск
+ *
+ * @param propsGet main GET request settings (path, reactivity, skeleton, etc.) / настройки главного GET-запроса
+ * @param formattersOptions optional reactive formatting rules / правила для реактивного форматирования данных
+ * @param searchOptions optional client-side search settings / настройки для клиентского поиска по списку
+ * @param postRequest optional POST mutation settings / настройки для POST-запроса создания
+ * @param putRequest optional PUT mutation settings / настройки для PUT-запроса обновления
+ * @param deleteRequest optional DELETE mutation settings / настройки для DELETE-запроса удаления
+ * @param action common callback executed after any successful mutation / общий коллбэк после любой успешной мутации
+ * @param apiInstance API instance for requests (defaults to Api.getItem()) / экземпляр API для выполнения запроса
+ *
+ * @returns reactive API management interface / реактивный интерфейс управления API
+ *
+ * @note This hook is recommended to be used in tandem with `executeUse` for centralized state management.
+ * By wrapping `useApiManagementRef` in `executeUseProvide` or `executeUseGlobal`, you can ensure
+ * a single source of truth across the component tree or the entire application.
+ *
+ * Рекомендуется использовать этот хук в тандеме с `executeUse` для централизованного управления состоянием.
+ * Обернув `useApiManagementRef` в `executeUseProvide` или `executeUseGlobal`, вы обеспечите
+ * единый источник истины в дереве компонентов или во всем приложении.
+ *
+ * @remarks
+ * Data formatting guidelines for `formattersOptions`:
+ * - **Recommended for formatting:** Numbers that represent values (prices, counts), dates, currency, units, and statuses.
+ * - **Not recommended for formatting:** Technical identifiers such as ID, UUID, account numbers (if used for logic), types, or internal codes.
+ *
+ * Рекомендации по форматированию данных для `formattersOptions`:
+ * - **Рекомендуется для форматирования:** Числа, представляющие значения (цены, количества), даты, валюта, единицы измерения и статусы.
+ * - **Не рекомендуется для форматирования:** Технические идентификаторы, такие как ID, UUID, номера счетов (если они используются для логики), типы или внутренние коды.
+ *
+ * @example
+ * // 1. Comprehensive API orchestration/ Комплексная оркестрация API
+ * const products = useApiManagementRef(
+ *   {
+ *     path: '/api/v1/products',
+ *     skeleton: () => Array(5).fill({ id: 0, name: 'Loading...', price: 0 })
+ *   },
+ *   {
+ *     // Formatters for display/ Форматтеры для отображения
+ *     price: (v) => `${v} USD`,
+ *     created_at: (v) => new Date(v).toLocaleDateString()
+ *   },
+ *   {
+ *     // Client-side search setup/ Настройка поиска на стороне клиента
+ *     columns: ['name', 'category']
+ *   },
+ *   { path: '/api/v1/products' }, // POST (create)
+ *   { path: (data) => `/api/v1/products/${data.id}` }, // PUT (update)
+ *   { path: (data) => `/api/v1/products/${data.id}` }  // DELETE (remove)
+ * );
+ *
+ * // Accessing data/ Доступ к данным:
+ * // products.list.value -> processed, formatted, and searched list
+ * // products.sendPost({ name: 'New Product', price: 100 }) -> execute mutation
+ */
+export declare function useApiManagementRef<Return extends ApiManagementValue, FormattersOptions extends FormattersOptionsList, Post extends Record<string, any>, Put extends Record<string, any>, Delete extends Record<string, any>, Type extends ApiManagementValue = Return, Item extends ArrayToItem<Return> = ArrayToItem<Return>, ItemFormatters extends FormattersListColumns<Item, FormattersOptions>[number] = FormattersListColumns<Item, FormattersOptions>[number], Columns extends SearchColumns<ItemFormatters> = []>(propsGet: ApiManagementGet<Return, Type>, formattersOptions?: FormattersOptions, searchOptions?: ApiManagementSearch<Item, Columns>, postRequest?: ApiManagementRequest<Post>, putRequest?: ApiManagementRequest<Put>, deleteRequest?: ApiManagementRequest<Delete>, action?: () => Promise<void> | void, apiInstance?: ApiInstance): {
+    /** Whether data passed the `typeData` check / `true`, если данные прошли проверку `typeData` */
+    isValid: ComputedRef<boolean>;
+    /** Processed data array (supports Skeleton, formatters, and search) / Обработанный массив данных (поддерживает Skeleton, форматтеры и поиск) */
+    list: ComputedRef<SearchFormatList<ItemFormatters, Columns>>;
+    /** Raw reactive data from `useApiRef` / «Сырые» реактивные данные из `useApiRef` */
+    readonly data: ComputedRef<ApiData<Return> | undefined>;
+    /** Current number of items in `list` (changes with search) / Текущее количество элементов в `list` (меняется при поиске) */
+    readonly length: ComputedRef<number>;
+    /** Total number of items in raw `data` / Общее количество элементов в исходном `data` */
+    lengthData: ComputedRef<number>;
+    /** Initial loading flag (true when no data yet) / Флаг первичной загрузки (когда данных еще нет) */
+    starting: ComputedRef<boolean>;
+    /** Active read process flag / Флаг активного процесса чтения данных */
+    reading: Ref<boolean, boolean>;
+    /** Loading state for the main GET request / Общее состояние загрузки главного GET-запроса */
+    loading: Ref<boolean, boolean>;
+    /** Loading state during search processing / Состояние загрузки в процессе поиска */
+    loadingSearch: Ref<boolean, boolean> | undefined;
+    /** Loading state for POST mutation / Состояние загрузки для POST мутации */
+    loadingPost: Ref<boolean, boolean> | undefined;
+    /** Loading state for PUT mutation / Состояние загрузки для PUT мутации */
+    loadingPut: Ref<boolean, boolean> | undefined;
+    /** Loading state for DELETE mutation / Состояние загрузки для DELETE мутации */
+    loadingDelete: Ref<boolean, boolean> | undefined;
+    /** Whether search is currently active / Активен ли поиск (есть ли поисковый запрос) */
+    isSearch: ComputedRef<boolean> | undefined;
+    /** Reactive search string (Proxy to `searchOptions.value`) / Реактивная строка поиска (Proxy к переданному `searchOptions.value`) */
+    search: Ref<string, string> | undefined;
+    /**
+     * Manual initialization
+     *
+     * Ручная инициализация
+     */
+    init: () => void;
+    /**
+     * SSR initialization
+     *
+     * Инициализация SSR
+     */
+    initSsr: () => void;
+    /**
+     * Default reset
+     *
+     * Сброс по умолчанию
+     */
+    /**
+     * Force reset the GET request and clear state.
+     *
+     * Принудительный перезапуск GET-запроса и очистка состояния.
+     */
+    reset: () => Promise<void>;
+    /**
+     * Abort the current network request.
+     *
+     * Прекращение текущего сетевого запроса.
+     */
+    abort: () => void;
+    /**
+     * Execute POST mutation request.
+     *
+     * Выполнить POST запрос мутации.
+     * @param request request data / данные запроса
+     */
+    sendPost: (request?: ApiFetch["request"]) => Promise<ApiData<Post> | undefined>;
+    /**
+     * Execute PUT mutation request.
+     *
+     * Выполнить PUT запрос мутации.
+     * @param request request data / данные запроса
+     */
+    sendPut: (request?: ApiFetch["request"]) => Promise<ApiData<Put> | undefined>;
+    /**
+     * Execute DELETE mutation request.
+     *
+     * Выполнить DELETE запрос мутации.
+     * @param request request data / данные запроса
+     */
+    sendDelete: (request?: ApiFetch["request"]) => Promise<ApiData<Delete> | undefined>;
+};

package/dist/composables/ref/useApiPost.d.ts

@@ -0,0 +1,20 @@
+import { ApiInstance, ApiData, ApiFetch } from '@dxtmisha/functional-basic';
+import { ApiOptions } from '../../types/apiTypes';
+import { RefOrNormal } from '../../types/refTypes';
+import { Ref } from 'vue';
+/**
+ * Use API post request.
+ *
+ * Использование API post запроса.
+ * @param path Path to the API endpoint / Путь к endpoint API
+ * @param action Action to perform after the request / Действие, выполняемое после запроса
+ * @param transformation Transformation function / Функция трансформации
+ * @param toData Extract 'data' field from response / Извлечь поле 'data' из ответа
+ * @param options Additional request options / Дополнительные опции запроса
+ * @param apiInstance Api instance / Экземпляр Api
+ * @returns Object with loading state and send method / Объект с состоянием загрузки и методом отправки
+ */
+export declare function useApiPost<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
+    loading: Ref<boolean, boolean>;
+    send(request?: Request | undefined): Promise<Return | undefined>;
+};

package/dist/composables/ref/useApiPut.d.ts

@@ -0,0 +1,20 @@
+import { ApiInstance, ApiData, ApiFetch } from '@dxtmisha/functional-basic';
+import { ApiOptions } from '../../types/apiTypes';
+import { RefOrNormal } from '../../types/refTypes';
+import { Ref } from 'vue';
+/**
+ * Use API put request.
+ *
+ * Использование API put запроса.
+ * @param path Path to the API endpoint / Путь к endpoint API
+ * @param action Action to perform after the request / Действие, выполняемое после запроса
+ * @param transformation Transformation function / Функция трансформации
+ * @param toData Extract 'data' field from response / Извлечь поле 'data' из ответа
+ * @param options Additional request options / Дополнительные опции запроса
+ * @param apiInstance Api instance / Экземпляр Api
+ * @returns Object with loading state and send method / Объект с состоянием загрузки и методом отправки
+ */
+export declare function useApiPut<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
+    loading: Ref<boolean, boolean>;
+    send(request?: Request | undefined): Promise<Return | undefined>;
+};

package/dist/composables/ref/useApiRef.d.ts

@@ -0,0 +1,106 @@
+import { ComputedRef, Ref } from 'vue';
+import { ApiInstance, ApiData, ApiDataValidation } from '@dxtmisha/functional-basic';
+import { ApiOptions } from '../../types/apiTypes';
+import { RefOrNormal, RefType } from '../../types/refTypes';
+/**
+ * Use api ref return type.
+ *
+ * Тип возвращаемого значения для useApiRef.
+ */
+export interface UseApiRef<R> {
+    /** Reactive data (Computed) / Реактивные данные (Computed) */
+    data: ComputedRef<ApiData<R> | undefined>;
+    /** Item (Ref) / Элемент (Ref) */
+    item: Ref<ApiData<R> | undefined>;
+    /**
+     * Status of response contract validation.
+     *
+     * Статус валидации контракта ответа.
+     */
+    isResponseContractValid: ComputedRef<boolean>;
+    /**
+     * Result of response validation.
+     *
+     * Результат валидации ответа.
+     */
+    responseValidationResult: ComputedRef<ApiDataValidation | undefined>;
+    /** Length of the list (Computed) / Длина списка (Computed) */
+    length: ComputedRef<number>;
+    /** Start request flag (true if no data yet) / Флаг начала запроса (true если еще нет данных) */
+    starting: ComputedRef<boolean>;
+    /** Request load flag / Флаг загрузки запроса */
+    loading: Ref<boolean>;
+    /** Active reading flag / Флаг активного чтения */
+    reading: Ref<boolean>;
+    /** Checks if the request is starting (true if no data yet) / Проверяет, начинается ли запрос (true, если данных еще нет) */
+    isStarting(): boolean;
+    /**
+     * Checks if the request is currently loading.
+     *
+     * Проверяет, загружается ли запрос в данный момент.
+     */
+    isLoading(): boolean;
+    /**
+     * Checks if the request is currently reading.
+     *
+     * Проверяет, читается ли запрос в данный момент.
+     */
+    isReading(): boolean;
+    /**
+     * Gets the current item data.
+     *
+     * Получает текущие данные элемента.
+     */
+    getItem(): ApiData<R> | undefined;
+    /**
+     * Manual initialization
+     *
+     * Ручная инициализация
+     */
+    init(): void;
+    /**
+     * SSR initialization
+     *
+     * Инициализация SSR
+     */
+    initSsr(): void;
+    /**
+     * Default reset.
+     *
+     * Сброс по умолчанию.
+     */
+    reset(): Promise<void>;
+    /**
+     * Stop request.
+     *
+     * Остановка запроса.
+     */
+    stop(): void;
+    /**
+     * Abort request.
+     *
+     * Отмена запроса.
+     */
+    abort(): void;
+}
+/**
+ * Returns data for working with requests.
+ *
+ * Возвращает данные для работы с запросами.
+ * @param path path to request / путь к запросу
+ * @param options data for the request / данные для запроса
+ * @param reactivity should reactivity be enabled / включить ли реактивность
+ * @param conditions conditions for executing the request / условия выполнения запроса
+ * @param transformation transforms the received request / преобразовывает полученный запрос
+ * @param validateResponseContract function to validate response data contract / функция для проверки контракта данных ответа
+ * @param unmounted delete data from the cache / удалить ли данные из кеша
+ * @param apiInstance Api instance / Экземпляр Api
+ */
+export declare function useApiRef<R, T = R>(path?: RefOrNormal<string | undefined>, options?: ApiOptions, reactivity?: boolean, conditions?: RefType<boolean>, transformation?: (data: T, isResponseContractValid?: ApiDataValidation) => ApiData<R>, validateResponseContract?: (data: T) => ApiDataValidation, unmounted?: boolean, apiInstance?: ApiInstance): UseApiRef<R>;
+/**
+ * Defines global conditions for the API request.
+ *
+ * Определяет глобальные условия для API запроса.
+ * @param conditions conditions for executing the request/ условия выполнения запроса
+ */
+export declare const setApiRefGlobalConditions: (conditions: RefType<any>) => void;

package/dist/composables/ref/useApiRequest.d.ts

@@ -0,0 +1,28 @@
+import { ApiInstance, ApiMethodItem, ApiData, ApiFetch } from '@dxtmisha/functional-basic';
+import { ApiOptions } from '../../types/apiTypes';
+import { RefOrNormal } from '../../types/refTypes';
+import { Ref } from 'vue';
+/**
+ * Use api request.
+ *
+ * Использование запроса api.
+ * @param path Path to the API endpoint / Путь к endpoint API
+ * @param method HTTP method / HTTP метод
+ * @param action Action to perform after the request / Действие, выполняемое после запроса
+ * @param transformation Transformation function / Функция трансформации
+ * @param toData Extract 'data' field from response / Извлечь поле 'data' из ответа
+ * @param options Additional request options / Дополнительные опции запроса
+ * @param apiInstance Api instance / Экземпляр Api
+ * @returns Object with loading state and send method / Объект с состоянием загрузки и методом отправки
+ */
+export declare function useApiRequest<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, method?: ApiMethodItem, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
+    loading: Ref<boolean, boolean>;
+    /**
+     * Send request.
+     *
+     * Отправка запроса.
+     * @param request Request data / Данные запроса
+     * @returns Response data / Данные ответа
+     */
+    send(request?: Request): Promise<Return | undefined>;
+};

package/dist/composables/ref/useBroadcastValueRef.d.ts

@@ -0,0 +1,11 @@
+import { Ref } from 'vue';
+type BroadcastValueItem<T> = T | string | undefined;
+/**
+ * Creates a reactive variable to manage data between browser tabs.
+ *
+ * Создает реактивную переменную для управления данными между вкладками браузера.
+ * @param name value name/ название значения
+ * @param defaultValue default value/ значение по умолчанию
+ */
+export declare function useBroadcastValueRef<T>(name: string, defaultValue?: T | string | (() => (T | string))): Ref<BroadcastValueItem<T>>;
+export {};

package/dist/composables/ref/useCookieRef.d.ts

@@ -0,0 +1,11 @@
+import { Ref } from 'vue';
+import { CookieOptions } from '@dxtmisha/functional-basic';
+/**
+ * Creates a reactive variable to manage cookies.
+ *
+ * Создает реактивную переменную для управления cookie.
+ * @param name cookie name / название cookie
+ * @param defaultValue value or function to change data / значение или функция для изменения данных
+ * @param options additional parameters / дополнительные параметры
+ */
+export declare function useCookieRef<T>(name: string, defaultValue?: T | string | (() => (T | string)), options?: CookieOptions): Ref<T | string | undefined>;

package/dist/composables/ref/useFormattersRef.d.ts

@@ -0,0 +1,21 @@
+import { FormattersListProp, FormattersOptionsList, FormattersReturn } from '@dxtmisha/functional-basic';
+import { RefType } from '../../types/refTypes';
+import { ComputedRef } from 'vue';
+/**
+ * Composable for reactive formatting of data lists based on specified rules for each property. /
+ * Композабл для реактивного форматирования списков данных на основе заданных правил для каждого свойства.
+ * @param list source data list (Ref or ComputedRef) / исходный список данных (Ref или ComputedRef)
+ * @param options formatting settings for each property / настройки форматирования для каждого свойства
+ */
+export declare function useFormattersRef<Options extends FormattersOptionsList = FormattersOptionsList, List extends FormattersListProp = FormattersListProp>(list: RefType<List | undefined>, options: Options): {
+    /**
+     * Formatted data list (ComputedRef) /
+     * Отформатированный список данных (ComputedRef)
+     */
+    listFormat: ComputedRef<FormattersReturn<List, Options>>;
+    /**
+     * Returns the count of records in the list (ComputedRef) /
+     * Возвращает количество записей в списке (ComputedRef)
+     */
+    length: ComputedRef<number>;
+};

package/dist/composables/ref/useGeoIntlRef.d.ts

@@ -0,0 +1,7 @@
+import { GeoIntlRef } from '../../classes/ref/GeoIntlRef';
+/**
+ * Returns a class object for working with data formatting.
+ *
+ * Возвращает объект класса для работы с форматированием данных.
+ */
+export declare function useGeoIntlRef(): GeoIntlRef;

package/dist/composables/ref/useHashRef.d.ts

@@ -0,0 +1,9 @@
+import { ShallowRef } from 'vue';
+/**
+ * Creates a reactive variable to manage the hash.
+ *
+ * Создает реактивную переменную для управления хэшем.
+ * @param name value name / название значения
+ * @param defaultValue default value / значение по умолчанию
+ */
+export declare function useHashRef<T>(name: string, defaultValue?: T | (() => T)): ShallowRef<T>;

package/dist/composables/ref/useLazyItemByMarginRef.d.ts

@@ -0,0 +1,22 @@
+import { RefType } from '../../types/refTypes';
+export type LazyItemByMargin = {
+    rootMargin: string;
+    item: any;
+};
+/**
+ * Hook for initializing the tracking of an element's appearance on the screen by margin.
+ *
+ * Хук для инициализации отслеживания появления элемента на экране по отступу.
+ * @param element element for tracking/ элемента для отслеживания
+ * @param rootMargin root margin for IntersectionObserver/ отступ для IntersectionObserver
+ */
+export declare const useLazyItemByMarginRef: (element: RefType<HTMLElement | undefined>, rootMargin: string) => {
+    /** Lazy item status/ Статус ленивого элемента */
+    lazyItemStatus: any;
+    /**
+     * Getting a tracked lazy item.
+     *
+     * Получение отслеживаемого ленивого элемента.
+     */
+    readonly lazyItem: any;
+};