@dxtmisha/functional 1.15.8 → 1.15.9

package/ai-types.md

@@ -1,154 +1,30 @@
 All these methods are in the @dxtmisha/functional library.
 
-import { ComputedRef, Ref, ShallowRef, ToRefs, VNode, VNodeArrayChildren, ComputedGetter, DebuggerOptions, Plugin, PropType } from 'vue';
-import { Datetime, GeoDate, GeoFirstDay, GeoHours, NumberOrStringOrDate, ElementOrString, ElementOrWindow, EventItem, EventListenerDetail, EventOptions, GeoFlag, GeoFlagItem, GeoFlagNational, ItemValue, NumberOrString, GeoItemFull, GeoUnit, ApiInstance, ApiData, ApiDataValidation, ApiErrorStorageList, ApiErrorItem, ApiFetch, FormattersListColumns, FormattersOptionsList, SearchColumns, SearchFormatList, FormattersListProp, FormattersReturn, MetaRobots, Meta, SearchItem, SearchOptions, TranslateInstance, TranslateList, ApiConfig, ErrorCenterCauseList, ErrorCenterHandlerCallback, ErrorCenterHandlerList, IconsConfig, TranslateConfig, ItemList, ApiDefaultValue, ApiMethodItem, Undefined, NumberOrStringOrBoolean, SearchListValue } from '@dxtmisha/functional-basic';
-import { InputSocialIcons } from '@dxtmisha/media';
-import { RouteLocationRaw, Router, _RouterClassic } from 'vue-router';
-export type RefType<T> = ComputedRef<T> | Ref<T>;
-export type RefUndefined<T> = RefType<T | undefined>;
-export type RefOrNormal<T> = RefType<T> | T;
-export type RefOrNormalOrFunction<T> = RefOrNormal<T> | (() => RefOrNormal<T>);
-export type RawChildren = string | number | boolean | VNode | VNodeArrayChildren | (() => any);
-export type RawSlots = {
-    [name: string]: unknown;
-    $stable?: boolean;
-};
-export type ApiOptions = ApiMethodItem | RefOrNormal<ApiFetch>;
-export type ApiManagementValue = ApiDefaultValue | ApiDefaultValue[];
-export type ApiManagementGet<Return extends ApiManagementValue, Type extends ApiManagementValue = Return> = {
-    path?: RefOrNormal<string | undefined>;
-    options?: ApiOptions;
-    reactivity?: boolean;
-    conditions?: RefType<boolean>;
-    transformation?: (data: Type, isResponseContractValid?: ApiDataValidation) => ApiData<Return>;
-    validateResponseContract?: (data: Type) => ApiDataValidation;
-    errorContract?: ApiErrorStorageList;
-    typeData?: ((data: Return) => boolean) | any;
-    unmounted?: boolean;
-    skeleton?: () => Return;
-};
-export type ApiManagementSearch<T extends SearchItem, K extends SearchColumns<T>> = {
-    columns: K;
-    value?: Ref<string>;
-    options?: SearchOptions;
-};
-export type ApiManagementRequest<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;
-    validateRequestContract?: (data: Request) => ApiDataValidation & Return;
-    validateResponseContract?: (data: T) => ApiDataValidation & Return;
-    errorContract?: ApiErrorStorageList;
-    toData?: boolean;
-    options?: ApiOptions;
-};
-export type ConstrItem = Record<string, any>;
-export type ConstrValue<T = any> = {
-    value?: T;
-};
-export type ConstrComponent = Record<string, any>;
-export type ConstrComponentMod<P extends ConstrItem> = ConstrItem | {
-    [K in keyof P]?: RefOrNormal<P[K]>;
-};
-export type ConstrExpose<E extends Element, EXPOSE extends ConstrItem> = EXPOSE & {
-    elementHtml?: ComputedRef<E | undefined>;
-};
-export type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
-export type ConstrEmitItem<T extends ConstrItem> = T[keyof T];
-export type ConstrEmit<T extends ConstrItem = ConstrItem> = UnionToIntersection<ConstrEmitItem<{
-    [K in keyof T]: (evt: K, ...args: T[K]) => void;
-}>>;
-export type ConstrClassObject = Record<string, boolean | undefined>;
-export type ConstrClass = string | (string | ConstrClass | Undefined)[] | ConstrClassObject;
-export type ConstrClassList = Record<string, ConstrClass>;
-export type ConstrClasses = {
-    main: ConstrClass;
-} & ConstrClassList;
-export type ConstrStylesItem = string | null;
-export type ConstrStyles = Record<string, ConstrStylesItem> | ConstrStyles[];
-export type ConstrOptions<COMP extends ConstrComponent, EMITS extends ConstrItem, P extends ConstrItem> = {
-    components?: COMP;
-    compMod?: ConstrComponentMod<P>;
-    emits?: ConstrEmit<EMITS>;
-    classes?: RefType<ConstrClasses>;
-    styles?: RefType<ConstrStyles>;
-};
-export type ConstrSetup<E extends Element, CLASSES extends ConstrClasses, SETUP extends ConstrItem> = {
-    name: string;
-    element: Ref<E | undefined>;
-    classes: RefType<CLASSES>;
-    styles: RefType<ConstrStyles>;
-} & SETUP;
-export type ConstrRegistration = {
-    flag?: boolean;
-    translate?: Record<string, string>;
-};
-export type ConstrBind<T> = T & Record<string, any> & {
-    key?: string;
-    class?: ConstrClass;
-    style?: ConstrStyles;
-};
-export type ConstrPropItemOptions<T = any> = {
-    type?: PropType<T>;
-    required?: boolean;
-    default?: any;
-    validator?(value: any, props: any): boolean;
-};
-export type ConstrPropItem<T = any> = ConstrPropItemOptions<T> | PropType<T>;
-export type ConstrProps<P = Record<string, any>> = {
-    [K in keyof P]: ConstrPropItem<P[K]>;
-};
-export type ConstrHrefProps = {
-    href?: string;
-};
-export type ListType = 'item' | 'space' | 'line' | 'subtitle' | 'html' | 'menu' | 'menu-group' | 'group';
-export type ListDataBasic = {
-    label?: NumberOrString;
-    value?: any;
-    search?: string;
-};
-export type ListDataItem<Item extends ListDataBasic = ListDataBasic> = ConstrBind<Item & {
-    parent?: string;
-    type: ListType;
-    index: string;
-    disabled?: boolean;
-}>;
-export type ListList<Item extends ListDataBasic = ListDataBasic> = ListDataItem<Item>[];
-export type ListRecord<Item extends ListDataBasic = ListDataBasic> = ListList<Item> | Record<string, any>;
-export type ListDataFullItem<Item extends ListDataBasic = ListDataBasic> = ListDataItem<Item> & {
-    focus: boolean;
-    highlight?: string;
-    selected: boolean;
-    disabled?: boolean;
-};
-export type ListDataFull<Item extends ListDataBasic = ListDataBasic> = ListDataFullItem<Item>[];
-export type ListListInputItem<Item extends ListDataBasic = ListDataBasic> = ConstrBind<Item>;
-export type ListListInput<Item extends ListDataBasic = ListDataBasic> = ListListInputItem<Item>[] | string[] | Record<string, ListListInputItem<Item>> | Record<string, string>;
-export type ListSelectedItem = NumberOrStringOrBoolean;
-export type ListSelectedList = ListSelectedItem | ListSelectedItem[];
-export type ListName = string | number | undefined;
-export type ListNames = ListName[];
-export type SearchListValueRef<T extends SearchItem> = RefOrNormal<SearchListValue<T>>;
-export type SearchListInput<T extends SearchItem> = SearchListValueRef<T> | (() => SearchListValueRef<T>);
-export type SearchColumnsRef<T extends SearchItem, K extends SearchColumns<T>> = RefOrNormal<K>;
-export type SearchColumnsInput<T extends SearchItem, K extends SearchColumns<T>> = SearchColumnsRef<T, K> | (() => SearchColumnsRef<T, K>);
+/** Base class for working with the constructor. */
 export declare abstract class DesignAbstract<T extends Record<string, any>, C extends Record<string, any>> {
+    protected readonly callback?: ((event: C) => void) | undefined;
     constructor(props: T, callback?: ((event: C) => void) | undefined, changed?: string[]);
     make(compelled?: boolean): this;
+    protected is<K extends keyof T>(name: K): boolean;
+    protected isChanged<K extends keyof C & string, KT extends keyof T & string>(name: K, nameProp?: KT | KT[]): boolean;
     makeCallback(compelled?: boolean): void;
+    protected makeCallbackItem(): void;
+    protected abstract initEvent(): void;
 }
+/**
 export declare abstract class DesignAsyncAbstract<T extends Record<string, any>, C extends Record<string, any>> extends DesignAbstract<T, C> {
     make(compelled?: boolean): this;
     makeCallback(compelled?: boolean): Promise<void>;
+    protected abstract initEvent(): Promise<void>;
 }
 export declare class DesignChanged<T extends Record<string, any>> {
     constructor(props: T, watch?: string[]);
     is(name: string | string[]): boolean;
     isChanged(): boolean;
     update(): void;
+    protected isDifferent(name: string): boolean;
 }
-export declare class DesignComp<COMP extends ConstrComponent, P extends ConstrItem> extends DesignComponents<COMP, P> {
-}
+export declare class DesignComp<COMP extends ConstrComponent, P extends ConstrItem> extends DesignComponents<COMP, P> {}
 export declare class DesignComponents<COMP extends ConstrComponent, P extends ConstrItem> {
     constructor(components?: COMP, modification?: ConstrComponentMod<P> | undefined);
     is<K extends keyof COMP>(name: K): name is K;
@@ -157,9 +33,11 @@ export declare class DesignComponents<COMP extends ConstrComponent, P extends Co
     render<K extends keyof COMP, PK extends keyof P>(name: K & string, props?: P[PK] & ConstrItem | ConstrItem, children?: RawChildren | RawSlots, index?: PK & string | string): VNode[];
     renderOne<K extends keyof COMP, PK extends keyof P>(name: K & string, props?: P[PK] & ConstrItem | ConstrItem, children?: RawChildren | RawSlots, index?: PK & string | string): VNode | undefined;
     renderAdd<K extends keyof COMP, PK extends keyof P>(item: any[], name: K & string, props?: P[PK] & ConstrItem | ConstrItem, children?: RawChildren | RawSlots, index?: PK & string | string): this;
+    protected computeModification<K extends keyof P>(index: K & string | string): Record<string, any>;
 }
 export declare abstract class DesignConstructorAbstract<E extends Element, COMP extends ConstrComponent, EMITS extends ConstrItem, EXPOSE extends ConstrItem, SLOTS extends ConstrItem, CLASSES extends ConstrClasses, P extends ConstrItem> {
-    constructor(name: string, props: Readonly<P>, options?: ConstrOptions<COMP, EMITS, P> | undefined);
+    protected constructor(name: string, props: Readonly<P>, options?: ConstrOptions<COMP, EMITS, P> | undefined);
+    protected init(): this;
     getName(): string;
     getDesign(): string;
     getSubClass(name: string | string[]): string;
@@ -168,6 +46,13 @@ export declare abstract class DesignConstructorAbstract<E extends Element, COMP
     getAttrs(): ConstrItem;
     expose(): ConstrExpose<E, EXPOSE>;
     render(): () => VNode | (VNode | any)[] | undefined;
+    protected abstract initExpose(): EXPOSE;
+    protected abstract initClasses(): Partial<CLASSES>;
+    protected abstract initStyles(): ConstrStyles;
+    protected abstract initRender(): VNode | (VNode | any)[] | undefined;
+    protected initSlot<K extends keyof SLOTS>(name: K, children?: any[], props?: ConstrItem): VNode | undefined;
+    protected toClass(classes?: ConstrClass): ConstrClassObject;
+    protected toClassName<T extends ConstrItem>(classes?: ConstrItem): T;
 }
 export declare class DatetimeRef {
     constructor(date: RefOrNormal<NumberOrStringOrDate>, type?: RefOrNormal<GeoDate>, code?: RefOrNormal<string>);
@@ -185,11 +70,30 @@ export declare class DatetimeRef {
     getMaxDay(): ComputedRef<number>;
     locale(type?: GeoDate, styleOptions?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions): ComputedRef<string>;
     standard(timeZone?: boolean): ComputedRef<string>;
+    protected updateDate(): this;
 }
 export declare class EffectScopeGlobal {
     static run<T>(fn: () => T): T | undefined;
 }
+import { ElementOrString, ElementOrWindow, EventItem, EventListenerDetail, EventOptions } from '@dxtmisha/functional-basic';
+/**
+ * Class for working with events (Ref).
+ *
+ * Класс для работа с события (Ref).
+ */
 export declare class EventRef<E extends ElementOrWindow, O extends Event, D extends Record<string, any> = Record<string, any>> extends EventItem<E, O, D> {
+    /**
+     * Classes Constructor
+     * @param elementSelector element/ элемент
+     * @param elementSelectorControl control element/ элемент управления
+     * @param type type/ тип
+     * @param listener the object that receives a notification (an object that implements the
+     * Event interface) when an event of the specified type occurs/ объект, который принимает
+     * уведомление, когда событие указанного типа произошло
+     * @param options object that specifies characteristics/ объект options
+     * @param detail an event-dependent value associated with the event/ зависимое от события
+     * значение, связанное с событием
+     */
     constructor(elementSelector?: RefOrNormal<ElementOrString<E> | undefined>, elementSelectorControl?: RefOrNormal<ElementOrString<HTMLElement>>, type?: string | string[], listener?: EventListenerDetail<O, D>, options?: EventOptions, detail?: D);
 }
 export declare class GeoFlagRef {
@@ -203,6 +107,10 @@ export declare class GeoFlagRef {
     getNational(codes?: RefOrNormal<string[] | undefined>): ComputedRef<GeoFlagNational[]>;
     getNationalLanguage(codes?: RefOrNormal<string[] | undefined>): ComputedRef<GeoFlagNational[]>;
 }
+/**
+ * Reactive class for managing the formatting of numbers and dates.
+ * @remarks Avoid using this reactive class if reactive updates are not required. For non-reactive formatting, use the standard `GeoIntl` class from `@dxtmisha/functional-basic`.
+ */
 export declare class GeoIntlRef {
     constructor(code?: RefOrNormal<string>);
     display(value?: RefOrNormal<string>, typeOptions?: Intl.DisplayNamesOptions['type'] | Intl.DisplayNamesOptions): ComputedRef<string>;
@@ -303,6 +211,10 @@ export declare class ListDataRef {
     getFirstItemByParent(parent: string | undefined): ListDataItem | undefined;
     getLastItemByParent(parent: string | undefined): ListDataItem | undefined;
     getSubList(item: ListDataItem): ListDataRef;
+    protected isItem(item: ListDataItem): boolean;
+    protected isInParent(parent: string | undefined, item: ListDataItem): boolean;
+    protected getIndex(index: string | number | undefined, value: any, key: string | number | undefined, label: string | number | undefined): string | number | undefined;
+    protected initItem(key: string | number, item: any): ListDataItem;
 }
 export declare class RouterItemRef {
     static get(): _RouterClassic;
@@ -332,20 +244,21 @@ export declare class ScrollbarWidthRef {
  *
  * const userSchema = S.Struct({ id: S.Number, name: S.String })
  *
+ * // Data will be pre-fetched on the server during SSR (onServerPrefetch)
  * const { data, loading, errorItem, isResponseContractValid } = useApiAsyncRef(
  *   '/users/1',
  *   { method: 'GET' },
- *   true,
- *   undefined,
- *   undefined,
- *   (data) => {
+ *   true, // reactivity
+ *   undefined, // conditions
+ *   undefined, // transformation
+ *   (data) => { // validateResponseContract
  *     try {
  *       return { status: 'success', data: S.decodeUnknownSync(userSchema)(data) }
  *     } catch (e) {
  *       return { status: 'error', errors: e }
  *     }
  *   },
- *   [
+ *   [ // errorContract
  *     { status: 404, message: 'User not found' }
  *   ]
  * )
@@ -354,29 +267,62 @@ export declare class ScrollbarWidthRef {
 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, errorContract?: ApiErrorStorageList, unmounted?: boolean, apiInstance?: ApiInstance): UseApiRef<R>;
 export interface UseApiDeleteSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> extends Omit<UseApiRequestSetup<T, Request, Return>, 'method'> {
 }
+/**
+ * Use API delete request.
+ * This is a convenient wrapper over `useApiRequest` that pre-fills the DELETE method.
+ */
 export declare function useApiDelete<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(setup: UseApiDeleteSetup<T, Request, Return>): {
     loading: Ref<boolean, boolean>;
     send(request?: Request | undefined): Promise<Return | undefined>;
 };
 export interface UseApiGetSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> extends Omit<UseApiRequestSetup<T, Request, Return>, 'method'> {
 }
+/**
+ * Use API get request.
+ * This is a convenient wrapper over `useApiRequest` that pre-fills the GET method.
+ */
 export declare function useApiGet<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(setup: UseApiGetSetup<T, Request, Return>): {
     loading: Ref<boolean, boolean>;
     send(request?: Request | undefined): Promise<Return | undefined>;
 };
+import { ApiInstance, ArrayToItem, FormattersListColumns, FormattersOptionsList, SearchColumns, ApiDataValidation, SearchFormatList, ApiData, ApiErrorItem, ApiFetch } from '@dxtmisha/functional-basic';
+import { ComputedRef, Ref } from 'vue';
 /**
  * Asynchronous reactive composable for API management requests with built-in SSR support.
  * Wraps `useApiManagementRef` and immediately calls `initSsr()` to ensure data is pre-fetched on the server side.
  * Use this composable ONLY if you need the request to be executed on the server side during SSR.
  * For all other cases, use `useApiManagementRef`.
+ *
+ * Асинхронный реактивный composable для запросов управления API со встроенной поддержкой SSR.
+ * Оборачивает `useApiManagementRef` и сразу вызывает `initSsr()`, чтобы гарантировать предзагрузку данных на сервере.
+ * Используйте этот composable ТОЛЬКО если вам необходимо, чтобы запрос был выполнен на стороне сервера
+ * во время SSR. Во всех остальных случаях используйте обычный `useApiManagementRef`.
+ * @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>;
     isResponseContractValid: ComputedRef<boolean>;
-    responseValidationResult: ComputedRef<ApiDataValidation | undefined>;
+    responseValidationResult: ComputedRef< ApiDataValidation | undefined>;
     list: ComputedRef<SearchFormatList<ItemFormatters, Columns>>;
-    readonly data: ComputedRef<ApiData<Return> | undefined>;
-    errorItem: ComputedRef<ApiErrorItem | undefined>;
+    readonly data: ComputedRef< ApiData<Return> | undefined>;
+    errorItem: ComputedRef< ApiErrorItem | undefined>;
     readonly length: ComputedRef<number>;
     lengthData: ComputedRef<number>;
     starting: ComputedRef<boolean>;
@@ -392,49 +338,77 @@ export declare function useApiManagementAsyncRef<Return extends ApiManagementVal
     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>;
+    sendPost: (request?: ApiFetch["request"]) => Promise< ApiData<Post> | undefined>;
+    sendPut: (request?: ApiFetch["request"]) => Promise< ApiData<Put> | undefined>;
+    sendDelete: (request?: ApiFetch["request"]) => Promise< ApiData<Delete> | undefined>;
 };
 /**
  * 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.
  *
+ * @template Return type of data returned by the API
+ * @template FormattersOptions optional formatting rules
+ * @template Post data type for POST creation request
+ * @template Put data type for PUT update request
+ * @template Delete data type for DELETE removal request
+ * @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.)
+ * @param formattersOptions optional reactive formatting rules
+ * @param searchOptions optional client-side search settings
+ * @param postRequest optional POST mutation settings
+ * @param putRequest optional PUT mutation settings
+ * @param deleteRequest optional DELETE mutation settings
+ * @param action common callback executed after any successful mutation
+ * @param apiInstance API instance for requests (defaults to Api.getItem())
+ *
+ * @returns reactive API management interface
+ *
  * @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.
  *
  * @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, types, or internal codes.
+ * - **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.
  *
  * @example
+ * // 1. Comprehensive API orchestration
  * 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' },
- *   { path: (data) => `/api/v1/products/${data.id}` },
- *   { path: (data) => `/api/v1/products/${data.id}` }
+ *   { 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): {
     isValid: ComputedRef<boolean>;
     isResponseContractValid: ComputedRef<boolean>;
-    responseValidationResult: ComputedRef<ApiDataValidation | undefined>;
+    responseValidationResult: ComputedRef< ApiDataValidation | undefined>;
     list: ComputedRef<SearchFormatList<ItemFormatters, Columns>>;
     readonly data: ComputedRef<ApiData<Return> | undefined>;
-    errorItem: ComputedRef<ApiErrorItem | undefined>;
+    errorItem: ComputedRef< ApiErrorItem | undefined>;
     readonly length: ComputedRef<number>;
     lengthData: ComputedRef<number>;
     starting: ComputedRef<boolean>;
@@ -456,12 +430,20 @@ export declare function useApiManagementRef<Return extends ApiManagementValue, F
 };
 export interface UseApiPostSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> extends Omit<UseApiRequestSetup<T, Request, Return>, 'method'> {
 }
+/**
+ * Use API post request.
+ * This is a convenient wrapper over `useApiRequest` that pre-fills the POST method.
+ */
 export declare function useApiPost<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(setup: UseApiPostSetup<T, Request, Return>): {
     loading: Ref<boolean, boolean>;
     send(request?: Request | undefined): Promise<Return | undefined>;
 };
 export interface UseApiPutSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> extends Omit<UseApiRequestSetup<T, Request, Return>, 'method'> {
 }
+/**
+ * Use API put request.
+ * This is a convenient wrapper over `useApiRequest` that pre-fills the PUT method.
+ */
 export declare function useApiPut<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(setup: UseApiPutSetup<T, Request, Return>): {
     loading: Ref<boolean, boolean>;
     send(request?: Request | undefined): Promise<Return | undefined>;
@@ -495,22 +477,23 @@ export interface UseApiRef<R> {
  * import { Schema as S } from '@effect/schema'
  * import { useApiRef } from '@dxtmisha/functional'
  *
+ * // Define a schema using @effect/schema
  * const userSchema = S.Struct({ id: S.Number, name: S.String })
  *
  * const { data, loading, errorItem, isResponseContractValid } = useApiRef(
  *   '/users/1',
  *   { method: 'GET' },
- *   true,
- *   undefined,
- *   (data) => ({ ...data, isTransformed: true }),
- *   (data) => {
+ *   true, // reactivity
+ *   undefined, // conditions
+ *   (data) => ({ ...data, isTransformed: true }), // transformation
+ *   (data) => { // validateResponseContract
  *     try {
  *       return { status: 'success', data: S.decodeUnknownSync(userSchema)(data) }
  *     } catch (e) {
  *       return { status: 'error', errors: e }
  *     }
  *   },
- *   [
+ *   [ // errorContract (ApiErrorStorageList)
  *     {
  *       status: 404,
  *       message: 'User not found'
@@ -520,17 +503,95 @@ export interface UseApiRef<R> {
  * ```
  */
 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, errorContract?: ApiErrorStorageList, 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;
+import { ApiInstance, ApiMethodItem, ApiData, ApiFetch, ApiErrorStorageList, ApiDataValidation } from '@dxtmisha/functional-basic';
+import { Ref } from 'vue';
+/**
+ * Setup interface for API request.
+ *
+ * Интерфейс настроек для запроса API.
+ */
 export interface UseApiRequestSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> {
+    /**
+     * Path to the API endpoint. Can be a reactive Ref or a normal string.
+     *
+     * Путь к endpoint API. Может быть реактивным Ref или обычной строкой.
+     */
     path?: RefOrNormal<string | undefined>;
+    /**
+     * HTTP method used for the request (e.g., GET, POST, PUT, DELETE). Defaults to POST.
+     *
+     * HTTP метод, используемый для запроса (например, GET, POST, PUT, DELETE). По умолчанию POST.
+     */
     method?: ApiMethodItem;
+    /**
+     * Action/callback to perform after the request has successfully completed.
+     * Can return a Promise for asynchronous operations.
+     *
+     * Действие/колбэк, выполняемое после успешного завершения запроса.
+     * Может возвращать Promise для асинхронных операций.
+     */
     action?: (data: Return | undefined) => Promise<void> | void;
+    /**
+     * Transformation function that modifies the raw response data before returning it.
+     *
+     * Функция трансформации, которая преобразует исходные данные ответа перед их возвратом.
+     */
     transformation?: (data: T) => Return;
+    /**
+     * Function to validate the request payload contract. Used to ensure that the API
+     * request payload matches the expected structure.
+     *
+     * Функция для проверки контракта данных запроса. Используется для гарантии того,
+     * что отправляемая полезная нагрузка запроса API соответствует ожидаемой структуре.
+     */
     validateRequestContract?: (data: Request) => ApiDataValidation & Return;
+    /**
+     * Function to validate response data contract. Used to ensure that the API
+     * response matches the expected structure. Highly recommended to use with `@effect/schema`.
+     * It should return `ApiDataValidation` containing a `status` ('success' or 'error')
+     * and the parsed data or errors.
+     *
+     * Функция для проверки контракта данных ответа. Используется для гарантии того, что ответ API соответствует
+     * ожидаемой структуре. Настоятельно рекомендуется использовать с `@effect/schema`. Должна возвращать объект
+     * `ApiDataValidation`, содержащий `status` ('success' или 'error') и распарсенные данные или ошибки.
+     */
     validateResponseContract?: (data: T) => ApiDataValidation & Return;
+    /**
+     * Array of expected error contracts for the request (`ApiErrorStorageList`).
+     * Highly recommended to add if there is information about possible request errors. Allows you to predefine
+     * possible errors (by code, status, or custom validation) which will be centrally processed by the application.
+     *
+     * Массив контрактов ожидаемых ошибок для запроса (`ApiErrorStorageList`). Желательно добавлять, если есть
+     * информация о возможных ошибках запроса. Позволяет заранее описать возможные ошибки (по коду, статусу или
+     * кастомной валидации) для централизованной обработки в приложении.
+     */
     errorContract?: ApiErrorStorageList;
+    /**
+     * If true, extracts the nested 'data' field from the response object instead of returning the raw envelope.
+     * Defaults to true.
+     *
+     * Если true, извлекает вложенное поле 'data' из объекта ответа вместо возврата исходного конверта.
+     * По умолчанию true.
+     */
     toData?: boolean;
+    /**
+     * Additional request options (headers, query params, etc.).
+     *
+     * Дополнительные опции запроса (заголовки, параметры запроса и т.д.).
+     */
     options?: ApiOptions;
+    /**
+     * Custom Api instance to execute the request on. Defaults to global Api singleton instance.
+     *
+     * Кастомный экземпляр класса Api для выполнения запроса. По умолчанию используется глобальный синглтон Api.
+     */
     apiInstance?: ApiInstance;
 }
 export declare function useApiRequest<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>({ path, method, action, transformation, validateRequestContract, validateResponseContract, errorContract, toData, options, apiInstance }: UseApiRequestSetup<T, Request, Return>): {
@@ -540,6 +601,11 @@ export declare function useApiRequest<T, Request extends ApiFetch['request'] = A
 type BroadcastValueItem<T> = T | string | undefined;
 export declare function useBroadcastValueRef<T>(name: string, defaultValue?: T | string | (() => (T | string))): Ref<BroadcastValueItem<T>>;
 export declare function useCookieRef<T>(name: string, defaultValue?: T | string | (() => (T | string)), options?: CookieOptions): Ref<T | string | undefined>;
+/**
+ * Composable for reactive formatting of data lists based on specified rules for each property.
+ * @param list source data list (Ref or 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): {
     listFormat: ComputedRef<FormattersReturn<List, Options>>;
     length: ComputedRef<number>;
@@ -577,6 +643,10 @@ export declare const useLazyRef: (options?: IntersectionObserverInit) => {
     disconnectLazy: () => void | undefined;
 };
 export declare function useLoadingRef(): ShallowRef<boolean, boolean>;
+/**
+ * Vue composable for reactive meta tags management with automatic DOM synchronization.
+ * Uses singleton pattern - all components share the same meta state.
+ */
 export declare const useMeta: () => Readonly<{
     meta: Meta;
     title: Ref<string, string>;
@@ -600,7 +670,7 @@ export declare const useMeta: () => Readonly<{
     setRobots: (value: MetaRobots) => void;
     setSiteName: (value: string) => void;
     setSuffix: (suffix: string) => void;
-}> & {
+} & {
     init(): Readonly<{
         meta: Meta;
         title: Ref<string, string>;
@@ -636,6 +706,13 @@ export declare const useRouterList: <T extends ListDataBasic>(list: RefType<Cons
     to: (name?: string) => void;
     toMain(): void;
 };
+/**
+ * Composable for handling search logic with reactive data.
+ * @param list list of items to search
+ * @param columns columns to search in
+ * @param value reactive search string
+ * @param options search options
+ */
 export declare function useSearchRef<T extends SearchItem, K extends SearchColumns<T>>(list: SearchListInput<T>, columns?: SearchColumnsInput<T, K>, value?: Ref<string>, options?: SearchOptions): {
     isSearch: ComputedRef<boolean>;
     search: Ref<string, string>;
@@ -643,6 +720,11 @@ export declare function useSearchRef<T extends SearchItem, K extends SearchColum
     listSearch: ComputedRef<SearchFormatList<T, K>>;
     length: ComputedRef<number>;
 };
+/**
+ * Composable for managing search value state and handling delays.
+ * @param item search list instance
+ * @param value reactive search string (optional)
+ */
 export declare function useSearchValueRef<T extends SearchItem, K extends SearchColumns<T>>(item: SearchList<T, K>, value?: Ref<string>): {
     search: Ref<string, string>;
     searchDelay: Ref<string, string>;
@@ -650,87 +732,131 @@ export declare function useSearchValueRef<T extends SearchItem, K extends Search
 };
 export declare function useSessionRef<T>(name: string, defaultValue?: T | (() => T)): Ref<T | undefined>;
 export declare function useStorageRef<T>(name: string, defaultValue?: T | (() => T), cache?: number): Ref<T | undefined>;
+import { ShallowRef } from 'vue';
+import { TranslateInstance, TranslateList } from '@dxtmisha/functional-basic';
 /**
  * Getting the translated text by an array of keys or a string with a key.
- * Returns a `ShallowRef` that automatically updates when the global language changes.
+ *
+ * It returns a `ShallowRef` that automatically updates when the global language changes.
  * Use `as const` for arrays to ensure proper TypeScript key inference.
  *
- * @example
+ * ### Examples
  * ```typescript
+ * // 1. Using the main composable
  * const translations = useTranslateRef(['home.title', 'home.description'] as const);
+ *
+ * // 2. Using the shorthand 't'
  * const labels = t(['button.save', 'button.cancel'] as const);
  * ```
+ *
+ * @param names a string or an array with keys
+ * @param translateInstance a translate instance
  */
 export declare function useTranslateRef<T extends (string | string[])[]>(names: T, translateInstance?: TranslateInstance): ShallowRef<TranslateList<T>>;
+/**
+ * Shorthand for useTranslateRef.
+ * Use `as const` for arrays to ensure proper TypeScript key inference.
+ *
+ * @param names a string or an array with keys
+ */
 export declare const t: <T extends string[]>(names: T) => ShallowRef<TranslateList<T>>;
 export declare const uiMakeFlags: () => void;
 export * from '@dxtmisha/functional-basic';
+import { ComputedRef, DebuggerOptions } from 'vue';
+/**
+ * Creates a computed property that can handle asynchronous getters.
+ * @param getter Asynchronous function, synchronous function, or direct value to compute the result
+ * @param initialState initial value of result
+ * @param ignore values to be ignored
+ * @param debugOptions Used for debugging reactive computations. Supported by Vue.js library
+ */
 export declare function computedAsync<R>(getter: (() => Promise<R>) | (() => R) | R, initialState?: (() => R) | R, ignore?: R, debugOptions?: DebuggerOptions): ComputedRef<R | undefined>;
-export declare function computedByLanguage<T, R extends (T | undefined) = T | undefined>(getter: ComputedGetter<R>, getterNone?: R | (() => R), conditions?: () => boolean, debugOptions?: DebuggerOptions): ComputedRef<R>;
-export declare function computedEternity<T>(getter: () => Promise<T> | T, initialState?: (() => T) | T): Ref<T, T>;
-export interface FunctionalPluginOptions {
-    api?: ApiConfig;
-    translate?: TranslateConfig;
-    location?: string | (() => string);
-    metaSuffix?: string;
-    icons?: IconsConfig;
-    iconsSocial?: InputSocialIcons;
-    router?: Router;
-    errorCauses?: ErrorCenterCauseList;
-    errorHandlers?: ErrorCenterHandlerList;
-    errorCallbacks?: ErrorCenterHandlerCallback[];
-}
+import { ComputedGetter } from 'vue';
 /**
- * Vue plugin for initializing and configuring global functional services
- * (Api, Translate, Icons, Meta).
- *
- * @example
- * ```typescript
- * import { createApp } from 'vue'
- * import { dxtFunctionalPlugin } from '@dxtmisha/functional'
- * import router from './router'
- *
- * const app = createApp(App)
- * app.use(dxtFunctionalPlugin, {
- *   api: { url: 'https://api.example.com' },
- *   metaSuffix: ' | My App',
- *   router
- * })
- * ```
+ * Provides a `computed` reactive property whose value changes based on the current language or other conditions.
+ * @param getter A function that provides the main value depending on the current language or other factors.
+ * @param getterNone An alternative value returned if conditions are not met or the main getter returns undefined.
+ * @param conditions A condition determining when the main getter/**
+ * Types of initialization for a singleton
  */
-export declare const dxtFunctionalPlugin: Plugin;
 export declare enum ExecuteUseType {
     global = "global",
     provide = "provide",
     local = "local"
 }
+/**
+ * The object returned by the factory function
+ */
 export type ExecuteUseReturn<R> = Readonly<R & {
     init(): Readonly<R>;
     destroyExecute?(): void;
 }>;
 /**
  * Creates a managed singleton that encapsulates initialization logic and access mode.
- * Supports initialization strategies: 'global', 'provide', 'local'.
+ *
+ * It supports three initialization strategies:
+ * - `global`: A single instance for the entire application.
+ * - `provide`: Shared via provide/inject in the component tree (standard for Vue 3).
+ * - `local`: A single instance within the closure of the returned function.
+ *
+ * @template R return type of the factory function
+ * @template O argument types for the factory function
+ * @template RI instance type with management methods
+ * @param callback initialization function
+ * @param type initialization strategy (defaults to provide)
+ * @returns accessor function for the singleton
  *
  * @remarks
- * Use this function for API services, shared reactive states, and singleton resource optimizations.
+ * Use this function in the following cases:
+ * - **API Services:** Always wrap API clients to ensure a single connection point and unified state.
+ * - **Resource Optimization:** For functions where creating multiple instances is undesirable (e.g., heavy objects, event buses).
+ * - **Shared State:** To share reactive state within a component tree using the `provide` strategy.
+ * - **External SDKs:** Initializing third-party libraries (analytics, maps, charts) that should be singletons.
  *
  * @example
+ * // 1. Global API singleton (useApiGet)
  * export const useUserApi = executeUseGlobal(() => {
  *   return useApiGet('/api/user');
  * });
  *
+ * @example
+ * // 2. Shared Reactive State
  * export const useFeatureState = executeUseProvide(() => {
  *   const items = [];
  *   const addItem = (item) => items.push(item);
  *   return { items, addItem };
  * });
+ *
+ * @example
+ * // 3. Local Caching
+ * export const useHeavyResource = executeUseLocal((config) => {
+ *   return new HeavyResource(config);
+ * });
+ *
+ * @example
+ * // 4. Complex API Service (useApiManagementRef)
+ * export const useUserManagement = executeUseGlobal(() => {
+ *   return useApiManagementRef(
+ *     { path: '/api/users' },                 // GET setup
+ *     { date: (v) => new Date(v).toLocaleString() }, // Formatters
+ *     { columns: ['name', 'email'] },         // Search
+ *     { path: '/api/users' },                 // POST (create)
+ *     { path: (o) => `/api/users/${o.id}` },  // PUT (update)
+ *     { path: (o) => `/api/users/${o.id}` }   // DELETE (remove)
+ *   );
+ * });
+ *
+ * // Usage in component:
+ * // const { list, loading, sendPost, sendDelete } = useUserManagement();
  */
 export declare function executeUse<R, O extends any[], RI extends ExecuteUseReturn<R> = ExecuteUseReturn<R>>(callback: (...args: O) => R, type?: ExecuteUseType): ((...args: O) => RI) | (() => RI);
-
 /**
  * Creates a global singleton.
- * @remarks See {@link executeUse} for more details.
+ *
+ * @remarks
+ * See {@link executeUse} for more details.
+ *
+ * @param callback Initialization function
  */
 export declare function executeUseGlobal<R>(callback: () => R): (() => Readonly<R & {
     init(): Readonly<R>;
@@ -739,10 +865,14 @@ export declare function executeUseGlobal<R>(callback: () => R): (() => Readonly<
     init(): Readonly<R>;
     destroyExecute?(): void;
 }>);
-
 /**
  * Creates a component-scoped singleton.
- * @remarks Best for sharing state within a component sub-tree. See {@link executeUse} for more details.
+ *
+ * @remarks
+ * Best for sharing state within a component sub-tree.
+ * See {@link executeUse} for more details.
+ *
+ * @param callback Initialization function
  */
 export declare function executeUseProvide<R, O extends any[]>(callback: (...args: O) => R): ((...args: O) => Readonly<R & {
     init(): Readonly<R>;
@@ -751,10 +881,14 @@ export declare function executeUseProvide<R, O extends any[]>(callback: (...args
     init(): Readonly<R>;
     destroyExecute?(): void;
 }>);
-
 /**
  * Creates a local singleton.
- * @remarks Best for internal state preservation within a closure. See {@link executeUse} for more details.
+ *
+ * @remarks
+ * Best for internal state preservation within a closure.
+ * See {@link executeUse} for more details.
+ *
+ * @param callback Initialization function
  */
 export declare function executeUseLocal<R, O extends any[]>(callback: (...args: O) => R): ((...args: O) => Readonly<R & {
     init(): Readonly<R>;
@@ -762,11 +896,114 @@ export declare function executeUseLocal<R, O extends any[]>(callback: (...args:
 }>) | (() => Readonly<R & {
     init(): Readonly<R>;
     destroyExecute?(): void;
+}>);itialization function/ Функция инициализации
+ */
+export declare function executeUseGlobal<R>(callback: () => R): (() => Readonly<R & {
+    /**
+     * Returns the raw instance without management methods/
+     * Возвращает чистый экземпляр без методов управления
+     */
+    init(): Readonly<R>;
+    /**
+     * Resets the cached instance (available for local and global)/
+     * Сбрасывает закешированный экземпляр (доступно для local и global)
+     */
+    destroyExecute?(): void;
+}>) | (() => Readonly<R & {
+    /**
+     * Returns the raw instance without management methods/
+     * Возвращает чистый экземпляр без методов управления
+     */
+    init(): Readonly<R>;
+    /**
+     * Resets the cached instance (available for local and global)/
+     * Сбрасывает закешированный экземпляр (доступно для local и global)
+     */
+    destroyExecute?(): void;
+}>);
+/**
+ * Creates a component-scoped singleton.
+ *
+ * Создает компонентный синглтон.
+ *
+ * @remarks
+ * Best for sharing state within a component sub-tree.
+ * See {@link executeUse} for more details.
+ *
+ * Лучше всего подходит для совместного использования состояния внутри поддерева компонентов.
+ * Подробнее см. {@link executeUse}.
+ *
+ * @param callback Initialization function/ Функция инициализации
+ */
+export declare function executeUseProvide<R, O extends any[]>(callback: (...args: O) => R): ((...args: O) => Readonly<R & {
+    /**
+     * Returns the raw instance without management methods/
+     * Возвращает чистый экземпляр без методов управления
+     */
+    init(): Readonly<R>;
+    /**
+     * Resets the cached instance (available for local and global)/
+     * Сбрасывает закешированный экземпляр (доступно для local и global)
+     */
+    destroyExecute?(): void;
+}>) | (() => Readonly<R & {
+    /**
+     * Returns the raw instance without management methods/
+     * Возвращает чистый экземпляр без методов управления
+     */
+    init(): Readonly<R>;
+    /**
+     * Resets the cached instance (available for local and global)/
+     * Сбрасывает закешированный экземпляр (доступно для local и global)
+     */
+    destroyExecute?(): void;
+}>);
+/**
+ * Creates a local singleton.
+ *
+ * Создает локальный синглтон.
+ *
+ * @remarks
+ * Best for internal state preservation within a closure.
+ * See {@link executeUse} for more details.
+ *
+ * Лучше всего подходит для сохранения внутреннего состояния внутри замыкания.
+ * Подробнее см. {@link executeUse}.
+ *
+ * @param callback Initialization function/ Функция инициализации
+ */
+export declare function executeUseLocal<R, O extends any[]>(callback: (...args: O) => R): ((...args: O) => Readonly<R & {
+    /**
+     * Returns the raw instance without management methods/
+     * Возвращает чистый экземпляр без методов управления
+     */
+    init(): Readonly<R>;
+    /**
+     * Resets the cached instance (available for local and global)/
+     * Сбрасывает закешированный экземпляр (доступно для local и global)
+     */
+    destroyExecute?(): void;
+}>) | (() => Readonly<R & {
+    /**
+     * Returns the raw instance without management methods/
+     * Возвращает чистый экземпляр без методов управления
+     */
+    init(): Readonly<R>;
+    /**
+     * Resets the cached instance (available for local and global)/
+     * Сбрасывает закешированный экземпляр (доступно для local и global)
+     */
+    destroyExecute?(): void;
 }>);
-
 export declare function executeUseGlobalInit(): void;
 export declare function getInject<T>(name: string): T | undefined;
 export declare const getOptions: (options?: ApiOptions) => RefOrNormal<ApiFetch>;
+/**
+ * Executes a function if the provided argument is a function, and unwraps the resulting Vue Ref if it is reactive.
+ * If the argument is a Vue Ref or a primitive value, it unwraps or returns it directly.
+ * @param data reactive reference, plain value, or a function returning them
+ * @returns the resolved and unwrapped value
+ */
 export declare function executeFunctionRef<T>(data: RefOrNormalOrFunction<T>): T;
 export declare function getApiErrorRef<R>(data: RefType<ApiData<R> | undefined>): ComputedRef<ApiErrorItem | undefined>;
 export declare function getBindRef<T, R extends ItemList>(value: RefOrNormal<T | R> | undefined, nameExtra?: RefOrNormal<ItemList> | string, name?: string): ComputedRef<R>;
@@ -776,6 +1013,274 @@ export declare function setRef<T>(item: Ref<T>, value: T): void;
 export declare function toRefItem<T>(item: RefOrNormal<T>): Ref<T>;
 export declare function getBind<T, R extends ItemList>(value: T | R | undefined | null, nameExtra?: ItemList | string, name?: string, except?: boolean): ConstrBind<R>;
 export declare function getClassName<T extends ItemList>(props?: T): string | undefined;
+/**
+ * Returns or generates a new element.
+ *
+ * Возвращает или генерирует новый элемент.
+ * @param name name of the component/ названия компонента
+ * @param props property of the component/ свойство компонента
+ * @param index the name of the key/ названия ключа
+ */
 export declare function getIndexForRender<T extends ItemList>(name: string | any, props?: T, index?: string): string | undefined;
+import { ItemList } from '@dxtmisha/functional-basic';
+/**
+ * Merges two objects with properties, taking into account their classes and styles
+ *
+ * Объединяет два объекта со свойствами с учётом классов и стилей в них
+ * @param extra additional property/ дополнительное свойство
+ * @param value input value/ входное значение
+ */
 export declare function toBind<R extends ItemList = ItemList>(extra: ItemList, value: ItemList): ConstrBind<R>;
-export declare function toBinds<R extends ItemList = ItemList>(...values: (ItemList | undefined)[]): ConstrBind<R>;
+import { ItemList } from '@dxtmisha/functional-basic';
+/**
+ * Merges multiple objects with properties, taking into account their classes and styles
+ *
+ * Объединяет несколько объектов со свойствами с учётом классов и стилей в них
+ * @param values list of input values/ список входных значений
+ */
+export declare function toBinds<R extends ItemList = ItemList>(...values: (ItemList | undefined)[]): ConstrBind<R>;
+import { ApiData, ApiDataValidation, ApiDefaultValue, ApiErrorStorageList, ApiFetch, ApiMethodItem, SearchColumns, SearchItem, SearchOptions } from '@dxtmisha/functional-basic';
+import { Ref } from 'vue';
+/** Options for api requests/ Опции для запросов api */
+export type ApiOptions = ApiMethodItem | RefOrNormal<ApiFetch>;
+/**
+ * Base type for API management values, either a single value or an array.
+ *
+ * Базовый тип для значений управления API: одиночное значение или массив.
+ */
+export type ApiManagementValue = ApiDefaultValue | ApiDefaultValue[];
+/**
+ * Configuration for the main GET request in API management.
+ */
+export type ApiManagementGet<Return extends ApiManagementValue, Type extends ApiManagementValue = Return> = {
+    /** API endpoint path */
+    path?: RefOrNormal<string | undefined>;
+    /** Additional request options */
+    options?: ApiOptions;
+    /** Enable reactive updates when path or options change */
+    reactivity?: boolean;
+    /** Condition to trigger the request */
+    conditions?: RefType<boolean>;
+    /** Custom transformation for the fetched data */
+    transformation?: (data: Type, isResponseContractValid?: ApiDataValidation) => ApiData<Return>;
+    /** Function to validate response data contract */
+    validateResponseContract?: (data: Type) => ApiDataValidation;
+    /** Storage of response error contracts */
+    errorContract?: ApiErrorStorageList;
+    /** Validation function or class constructor for data */
+    typeData?: ((data: Return) => boolean) | any;
+    /** Whether to clear data when the component is unmounted */
+    unmounted?: boolean;
+    /** Function to provide skeleton data during loading */
+    skeleton?: () => Return;
+};
+/**
+ * Configuration for client-side search across API data.
+ */
+export type ApiManagementSearch<T extends SearchItem, K extends SearchColumns<T>> = {
+    /** List of columns to search through */
+    columns: K;
+    /** Reactive search query */
+    value?: Ref<string>;
+    /** Additional search algorithm options */
+    options?: SearchOptions;
+};
+/**
+ * Configuration for mutation requests (POST, PUT, DELETE).
+ */
+export type ApiManagementRequest<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> = {
+    /** Target API endpoint path */
+    path?: RefOrNormal<string | undefined>;
+    /** Action to perform after a successful request */
+    action?: (data: Return | undefined) => Promise<void> | void;
+    /** Transformation before sending data */
+    transformation?: (data: T) => Return;
+    /** Request contract validation function */
+    validateRequestContract?: (data: Request) => ApiDataValidation & Return;
+    /** Response contract validation function */
+    validateResponseContract?: (data: T) => ApiDataValidation & Return;
+    /** Storage of response error contracts */
+    errorContract?: ApiErrorStorageList;
+    /** Whether to wrap the payload in a 'data' property */
+    toData?: boolean;
+    /** Additional mutation request options */
+    options?: ApiOptions;
+};
+import { Ref, PropType, ComputedRef } from 'vue';
+import { Undefined } from '@dxtmisha/functional-basic';
+/** Generic record type for constructor items */
+export type ConstrItem = Record<string, any>;
+/** Constructor value wrapper with optional value property */
+export type ConstrValue<T = any> = {
+    /** Optional value of type T */
+    value?: T;
+};
+/** Generic record type for constructor components */
+export type ConstrComponent = Record<string, any>;
+/** Constructor component modification type with reactive or normal values */
+export type ConstrComponentMod<P extends ConstrItem> = ConstrItem | {
+    [K in keyof P]?: RefOrNormal<P[K]>;
+};
+export type ConstrExpose<E extends Element, EXPOSE extends ConstrItem> = EXPOSE & {
+    elementHtml?: ComputedRef<E | undefined>;
+};
+/** Utility type to convert union types to intersection types */
+export type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+/** Extract emit item type from constructor item */
+export type ConstrEmitItem<T extends ConstrItem> = T[keyof T];
+/** Constructor emit type with proper event handler signatures */
+export type ConstrEmit<T extends ConstrItem = ConstrItem> = UnionToIntersection<ConstrEmitItem<{
+    [K in keyof T]: (evt: K, ...args: T[K]) => void;
+}>>;
+/** Object type for CSS class names with boolean values */
+export type ConstrClassObject = Record<string, boolean | undefined>;
+/** Constructor class type supporting strings, arrays, and objects */
+export type ConstrClass = string | (string | ConstrClass | Undefined)[] | ConstrClassObject;
+/** Record type for mapping class names to class definitions */
+export type ConstrClassList = Record<string, ConstrClass>;
+/** Constructor classes with required main class and additional class list */
+export type ConstrClasses = {
+    main: ConstrClass;
+} & ConstrClassList;
+/** Constructor style item type for individual style properties */
+export type ConstrStylesItem = string | null;
+/** Constructor styles type supporting objects and arrays of style definitions */
+export type ConstrStyles = Record<string, ConstrStylesItem> | ConstrStyles[];
+/** Constructor options interface for component configuration */
+export type ConstrOptions<COMP extends ConstrComponent, EMITS extends ConstrItem, P extends ConstrItem> = {
+    /** Optional components configuration */
+    components?: COMP;
+    /** Optional component modifications */
+    compMod?: ConstrComponentMod<P>;
+    /** Optional emit handlers */
+    emits?: ConstrEmit<EMITS>;
+    /** Optional reactive classes */
+    classes?: RefType<ConstrClasses>;
+    /** Optional reactive styles */
+    styles?: RefType<ConstrStyles>;
+};
+/** Constructor setup interface for component initialization */
+export type ConstrSetup<E extends Element, CLASSES extends ConstrClasses, SETUP extends ConstrItem> = {
+    /** Component name */
+    name: string;
+    /** Reactive element reference */
+    element: Ref<E | undefined>;
+    /** Reactive classes */
+    classes: RefType<CLASSES>;
+    /** Reactive styles */
+    styles: RefType<ConstrStyles>;
+} & SETUP;
+/** Constructor registration configuration */
+export type ConstrRegistration = {
+    /** Optional flag for registration */
+    flag?: boolean;
+    /** Optional translation map */
+    translate?: Record<string, string>;
+};
+/** Constructor bind type for component binding with class and style support */
+export type ConstrBind<T> = T & Record<string, any> & {
+    /** Optional key */
+    key?: string;
+    /** Optional CSS classes */
+    class?: ConstrClass;
+    /** Optional styles */
+    style?: ConstrStyles;
+};
+/** Constructor prop item options for Vue prop definitions */
+export type ConstrPropItemOptions<T = any> = {
+    /** Vue prop type */
+    type?: PropType<T>;
+    /** Required flag */
+    required?: boolean;
+    /** Default value */
+    default?: any;
+    /** Custom validator function */
+    validator?(value: any, props: any): boolean;
+};
+/** Constructor prop item type with options or direct PropType */
+export type ConstrPropItem<T = any> = ConstrPropItemOptions<T> | PropType<T>;
+/** Constructor props type for component prop definitions */
+export type ConstrProps<P = Record<string, any>> = {
+    [K in keyof P]: ConstrPropItem<P[K]>;
+};
+/** Props for link handling */
+export type ConstrHrefProps = {
+    /** Hyperlink reference */
+    href?: string;
+};
+/** Type of list item */
+export type ListType = 'item' | 'space' | 'line' | 'subtitle' | 'html' | 'menu' | 'menu-group' | 'group';
+/** Basic data structure for list item */
+export type ListDataBasic = {
+    /** Optional display label */
+    label?: NumberOrString;
+    /** Any value associated with the item */
+    value?: any;
+    /** Search text for filtering */
+    search?: string;
+};
+/** Extended list item with type and index */
+export type ListDataItem<Item extends ListDataBasic = ListDataBasic> = ConstrBind<Item & {
+    /** Parent item identifier */
+    parent?: string;
+    /** Type of list item */
+    type: ListType;
+    /** Unique item identifier */
+    index: string;
+    /** Whether the item is disabled */
+    disabled?: boolean;
+}>;
+/** Array of list data items */
+export type ListList<Item extends ListDataBasic = ListDataBasic> = ListDataItem<Item>[];
+/** List or record structure for list data */
+export type ListRecord<Item extends ListDataBasic = ListDataBasic> = Item[] | Record<string, Item>;
+/** Extended list item with additional state properties */
+export type ListDataFullItem<Item extends ListDataBasic = ListDataBasic> = ListDataItem<Item> & {
+    /** Whether the item has focus */
+    focus: boolean;
+    /** Highlighted text portion */
+    highlight?: string;
+    /** Whether the item is selected */
+    selected: boolean;
+    /** Whether the item is disabled */
+    disabled?: boolean;
+};
+/** Array of extended list items with state */
+export type ListDataFull<Item extends ListDataBasic = ListDataBasic> = ListDataFullItem<Item>[];
+/** Input item for list creation */
+export type ListListInputItem<Item extends ListDataBasic = ListDataBasic> = ConstrBind<Item>;
+/** Various input formats for list creation */
+export type ListListInput<Item extends ListDataBasic = ListDataBasic> = ListListInputItem<Item>[] | string[] | Record<string, ListListInputItem<Item>> | Record<string, string>;
+/** Single selected item identifier */
+export type ListSelectedItem = NumberOrStringOrBoolean;
+/** Single or multiple selected items */
+export type ListSelectedList = ListSelectedItem | ListSelectedItem[];
+/** Name of selected list item */
+export type ListName = string | number | undefined;
+/** Array of list item names */
+export type ListNames = ListName[];
+/** Union type for Vue reactive references (computed or ref) */
+export type RefType<T> = ComputedRef<T> | Ref<T>;
+/** Union type for Vue reactive references that can be undefined */
+export type RefUndefined<T> = RefType<T | undefined>;
+/** Union type that can be either a Vue reactive reference or a normal value */
+export type RefOrNormal<T> = RefType<T> | T;
+/** Union type that can be either a Vue reactive reference or a normal value or a function that returns a Vue reactive reference or a normal value */
+export type RefOrNormalOrFunction<T> = RefOrNormal<T> | (() => RefOrNormal<T>);
+/** Union type for Vue raw children content (strings, numbers, booleans, VNodes, arrays, functions) */
+export type RawChildren = string | number | boolean | VNode | VNodeArrayChildren | (() => any);
+/** Type for Vue raw slots with optional stability flag */
+export type RawSlots = {
+    /** Slot name mapping to unknown content */
+    [name: string]: unknown;
+    /** Optional stability flag for performance optimization */
+    $stable?: boolean;
+};
+/** Search list data */
+export type SearchListValueRef<T extends SearchItem> = RefOrNormal<SearchListValue<T>>;
+/** Search list input */
+export type SearchListInput<T extends SearchItem> = SearchListValueRef<T> | (() => SearchListValueRef<T>);
+/** Search columns ref */
+export type SearchColumnsRef<T extends SearchItem, K extends SearchColumns<T>> = RefOrNormal<K>;
+/** Search columns input */
+export type SearchColumnsInput<T extends SearchItem, K extends SearchColumns<T>> = SearchColumnsRef<T, K> | (() => SearchColumnsRef<T, K>);