@dxtmisha/functional 1.14.5 → 1.15.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.15.0] - 2026-07-02
+
+### Added
+- **GeoUnitRef**: Introduced a new reactive class wrapper `GeoUnitRef` that wraps the isomorphic `GeoUnit` class to support Vue 3 `Ref` values as input parameters, returning `ComputedRef<string>` values for all unit formatting methods.
+- **useGeoUnitRef**: Added a new composable function `useGeoUnitRef()` to return a `GeoUnitRef` instance.
+- **Tests**: Created comprehensive unit tests in `GeoUnitRef.test.ts` and `useGeoUnitRef.test.ts` to verify Vue reactivity integration.
+
 ## [1.14.5] - 2026-06-29
 
 ### Changed

package/ai-description.md

@@ -1,18 +1,25 @@
-Core Purpose: A reactive framework for Vue 3 providing architectural abstractions for components, advanced API request orchestration with SSR support, internationalization (Intl), data list management, and global utility state synchronization.
+### Core Purpose
+A high-level utility library designed for Vue 3 providing architectural abstractions for component design, reactive state management, sophisticated API orchestration with SSR support, and localized geographic/unit formatting.
 
-Key Expositions:
-- Component Architecture: `DesignConstructorAbstract`, `DesignComponents`, and `DesignAbstract` provide base classes for creating reactive functional components with automatic class/style/slot handling.
-- API Management: `useApiRef` (core), `useApiAsyncRef` (SSR-enabled), and `useApiManagementRef` (CRUD/list orchestration) manage requests, caching, validation (integration with `@effect/schema`), and automatic loading states.
-- Reactive Utilities: `DatetimeRef`, `GeoRef`, `GeoIntlRef`, `GeoFlagRef` for locale-aware data management; `ListDataRef` for complex list manipulation; `useMeta` for reactive document head management.
-- Singleton/State Factories: `executeUse` (global, provide, or local scopes) for managing shared state instances.
-- Primitive Wrappers: `useCookieRef`, `useStorageRef`, `useSessionRef`, `useQueryRef`, and `useHashRef` for reactive access to browser storage and URL state.
+### Key Expositions
+*   **Design Architecture:** `DesignConstructorAbstract`, `DesignComponents`, and `DesignAbstract` provide a structured class-based inheritance model for building complex, reactive functional components with automatic lifecycle handling, style/class management, and slotted rendering.
+*   **API Orchestration:**
+    *   `useApiRef`: Centralized reactive API request handler with built-in SSR, caching, transformation, validation (supporting `@effect/schema`), and error handling.
+    *   `useApiManagementRef` / `useApiManagementAsyncRef`: High-level orchestration for CRUD operations (GET/POST/PUT/DELETE) with client-side searching, list formatting, and atomic mutation state management.
+    *   Standard wrappers: `useApiGet`, `useApiPost`, `useApiPut`, `useApiDelete` for cleaner endpoint interaction.
+*   **Reactive Utilities:** 
+    *   `executeUse`: A factory for creating managed singletons (`global`, `provide`, `local`) to ensure unified state across component trees.
+    *   `useTranslateRef`, `useStorageRef`, `useCookieRef`, `useSessionRef`: Reactive bridges to local persistence and internationalization.
+    *   `computedAsync`, `computedEternity`: Advanced reactive primitives for asynchronous data flow and on-demand caching.
+*   **Data Formatting:** `GeoIntlRef`, `GeoUnitRef`, and `useFormattersRef` provide reactive, localized formatting for numbers, currencies, units (metric/imperial conversion), and dates.
+*   **List & Search Logic:** `ListDataRef` and `useSearchRef` manage complex hierarchical or flat data structures with optimized search and filtering capabilities.
 
-Triggers for Studying ai-types.md: 
-- When implementing complex component logic involving lifecycle-dependent design systems or custom Vue components using `DesignConstructorAbstract`.
-- When dealing with API state, validation contracts, or SSR pre-fetching logic (mandatory for `useApiAsyncRef` or `useApiManagementRef`).
-- When defining shared singleton services or managing complex reactive states that require specific injection or scope strategies (`executeUse`).
+### Triggers for Studying ai-types.md
+Mandatory to review `ai-types.md` when:
+1.  **System Integration:** You are implementing new API endpoints, configuring `dxtFunctionalPlugin`, or setting up global state providers (`executeUseProvide`).
+2.  **Schema Validation:** You are utilizing `validateResponseContract` or `validateRequestContract` and require the expected structure for `ApiDataValidation` or error storage interfaces.
+3.  **Component Construction:** You are extending `DesignConstructorAbstract` or implementing custom component modifications.
+4.  **Type Mapping:** You encounter complex generic constraints in the `useApiManagementRef` signature or `Constr` prefixed utility types (e.g., `ConstrBind`, `ConstrOptions`, `ConstrEmit`).
 
-Integration Context: 
-- Stack: Built for Vue 3 (Composition API).
-- Dependencies: Extends `vue`, `vue-router`, and relies heavily on `@dxtmisha/functional-basic` for underlying logic. 
-- Infrastructure: Designed to be initialized via `dxtFunctionalPlugin` for global services (API, Translate, Meta, Router). Requires environment-aware implementation for SSR/hydration sequences.
+### Integration Context
+The library acts as a foundational service layer in the system stack. It integrates directly with Vue 3's composition API, Vue Router for navigation, and `@dxtmisha/functional-basic` for core network and utility logic. It is intended to be used as a singleton-pattern service provider within an application's plugin system via `dxtFunctionalPlugin` to facilitate consistent SSR state hydration and global dependency injection.

package/ai-types.md

@@ -19,7 +19,6 @@ export declare abstract class DesignAbstract<T extends Record<string, any>, C ex
     constructor(props: T, callback?: ((event: C) => void) | undefined, changed?: string[]);
     make(compelled?: boolean): this;
     makeCallback(compelled?: boolean): void;
-    protected abstract initEvent(): void;
 }
 
 // File: src/classes/design/DesignAsyncAbstract.d.ts
@@ -27,7 +26,6 @@ import { DesignAbstract } from './DesignAbstract';
 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>;
 }
 
 // File: src/classes/design/DesignChanged.d.ts
@@ -49,7 +47,6 @@ import { ComputedRef, VNode } from 'vue';
 import { RawChildren, RawSlots } from '../../types/refTypes';
 import { ConstrComponent, ConstrComponentMod, ConstrItem } from '../../types/constructorTypes';
 export declare class DesignComponents<COMP extends ConstrComponent, P extends ConstrItem> {
-    protected caching: Record<string, ComputedRef<any>>;
     constructor(components?: COMP, modification?: ConstrComponentMod<P> | undefined);
     is<K extends keyof COMP>(name: K): name is K;
     get<K extends keyof COMP>(name: K): COMP[K];
@@ -62,20 +59,8 @@ export declare class DesignComponents<COMP extends ConstrComponent, P extends Co
 // File: src/classes/design/DesignConstructorAbstract.d.ts
 import { ComputedRef, ToRefs, VNode, Ref } from 'vue';
 import { DesignComponents } from './DesignComponents';
-import { ConstrClass, ConstrClassObject, ConstrComponent, ConstrEmit, ConstrExpose, ConstrItem, ConstrOptions, ConstrStyles } from '../../types/constructorTypes';
+import { ConstrClass, ConstrClasses, ConstrClassObject, ConstrComponent, ConstrEmit, ConstrExpose, ConstrItem, ConstrOptions, ConstrStyles } from '../../types/constructorTypes';
 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> {
-    protected readonly props: Readonly<P>;
-    protected readonly options?: ConstrOptions<COMP, EMITS, P> | undefined;
-    protected readonly name: string[];
-    protected readonly element: Ref<E | undefined, E | undefined>;
-    protected readonly refs: ToRefs<P>;
-    protected readonly components: DesignComponents<COMP, P>;
-    protected readonly emits?: ConstrEmit<EMITS>;
-    protected readonly classes?: ComputedRef<CLASSES>;
-    protected readonly styles?: ComputedRef<ConstrStyles>;
-    protected attrs?: ConstrItem;
-    protected slots?: SLOTS;
-    protected dataExpose?: EXPOSE;
     protected constructor(name: string, props: Readonly<P>, options?: ConstrOptions<COMP, EMITS, P> | undefined);
     protected init(): this;
     getName(): string;
@@ -86,10 +71,6 @@ 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;
@@ -131,7 +112,7 @@ export declare class EventRef<E extends ElementOrWindow, O extends Event, D exte
 
 // File: src/classes/ref/GeoFlagRef.d.ts
 import { ComputedRef } from 'vue';
-import { GeoFlagItem, GeoFlagNational } from '@dxtmisha/functional-basic';
+import { GeoFlag, GeoFlagItem, GeoFlagNational } from '@dxtmisha/functional-basic';
 import { RefOrNormal } from '../../types/refTypes';
 export declare class GeoFlagRef {
     constructor(code?: RefOrNormal<string | undefined>);
@@ -191,9 +172,31 @@ export declare class GeoRef {
     static setValueDefault(code?: string | (() => string)): void;
 }
 
+// File: src/classes/ref/GeoUnitRef.d.ts
+import { ComputedRef, Ref } from 'vue';
+import { GeoUnit, NumberOrString } from '@dxtmisha/functional-basic';
+import { RefOrNormal } from '../../types/refTypes';
+export declare class GeoUnitRef {
+    constructor(code?: RefOrNormal<string>);
+    getLocation(): ComputedRef<string>;
+    millimeter(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    centimeter(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    meter(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    kilometer(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    squareMeter(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    hectare(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    gram(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    kilogram(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    tonne(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    milliliter(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    liter(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    celsius(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    kilometerPerHour(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+}
+
 // File: src/classes/ref/ListDataRef.d.ts
 import { RefOrNormal, RefType } from '../../types/refTypes';
-import { ListDataFull, ListDataItem, ListList, ListNames, ListSelectedItem, ListSelectedList } from '../../types/listTypes';
+import { ListDataFull, ListDataItem, ListList, ListListInput, ListNames, ListSelectedItem, ListSelectedList } from '../../types/listTypes';
 import { ComputedRef } from 'vue';
 export declare class ListDataRef {
     constructor(list: RefOrNormal<ListListInput | undefined>, focus?: RefType<ListSelectedItem | undefined> | undefined, highlight?: RefType<string | undefined> | undefined, highlightLengthStart?: RefType<number | undefined> | undefined, filterMode?: RefType<boolean | undefined> | undefined, selected?: RefType<ListSelectedList | undefined> | undefined, keyValue?: RefType<string | undefined> | undefined, keyLabel?: RefType<string | undefined> | undefined, lite?: RefType<number | undefined> | undefined, min?: RefOrNormal<number | string | undefined>, max?: RefOrNormal<number | string | undefined>, parent?: string | undefined);
@@ -272,7 +275,8 @@ export declare function useApiAsyncRef<R, T = R>(path?: RefOrNormal<string | und
 import { ApiData, ApiFetch } from '@dxtmisha/functional-basic';
 import { UseApiRequestSetup } from './useApiRequest';
 import { Ref } from 'vue';
-export interface UseApiDeleteSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> extends Omit<UseApiRequestSetup<T, Request, Return>, 'method'> {}
+export interface UseApiDeleteSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> extends Omit<UseApiRequestSetup<T, Request, Return>, '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>;
@@ -282,7 +286,8 @@ export declare function useApiDelete<T, Request extends ApiFetch['request'] = Ap
 import { ApiData, ApiFetch } from '@dxtmisha/functional-basic';
 import { UseApiRequestSetup } from './useApiRequest';
 import { Ref } from 'vue';
-export interface UseApiGetSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> extends Omit<UseApiRequestSetup<T, Request, Return>, 'method'> {}
+export interface UseApiGetSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> extends Omit<UseApiRequestSetup<T, Request, Return>, '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>;
@@ -354,7 +359,8 @@ export declare function useApiManagementRef<Return extends ApiManagementValue, F
 import { ApiData, ApiFetch } from '@dxtmisha/functional-basic';
 import { UseApiRequestSetup } from './useApiRequest';
 import { Ref } from 'vue';
-export interface UseApiPostSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> extends Omit<UseApiRequestSetup<T, Request, Return>, 'method'> {}
+export interface UseApiPostSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> extends Omit<UseApiRequestSetup<T, Request, Return>, '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>;
@@ -364,7 +370,8 @@ export declare function useApiPost<T, Request extends ApiFetch['request'] = ApiF
 import { ApiData, ApiFetch } from '@dxtmisha/functional-basic';
 import { UseApiRequestSetup } from './useApiRequest';
 import { Ref } from 'vue';
-export interface UseApiPutSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> extends Omit<UseApiRequestSetup<T, Request, Return>, 'method'> {}
+export interface UseApiPutSetup<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>> extends Omit<UseApiRequestSetup<T, Request, Return>, '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>;
@@ -422,7 +429,8 @@ export declare function useApiRequest<T, Request extends ApiFetch['request'] = A
 
 // File: src/composables/ref/useBroadcastValueRef.d.ts
 import { Ref } from 'vue';
-export declare function useBroadcastValueRef<T>(name: string, defaultValue?: T | string | (() => (T | string))): Ref<T | string | undefined>;
+type BroadcastValueItem<T> = T | string | undefined;
+export declare function useBroadcastValueRef<T>(name: string, defaultValue?: T | string | (() => (T | string))): Ref<BroadcastValueItem<T>>;
 
 // File: src/composables/ref/useCookieRef.d.ts
 import { Ref } from 'vue';
@@ -442,12 +450,17 @@ export declare function useFormattersRef<Options extends FormattersOptionsList =
 import { GeoIntlRef } from '../../classes/ref/GeoIntlRef';
 export declare function useGeoIntlRef(): GeoIntlRef;
 
+// File: src/composables/ref/useGeoUnitRef.d.ts
+import { GeoUnitRef } from '../../classes/ref/GeoUnitRef';
+export declare function useGeoUnitRef(): GeoUnitRef;
+
 // File: src/composables/ref/useHashRef.d.ts
 import { ShallowRef } from 'vue';
 export declare function useHashRef<T>(name: string, defaultValue?: T | (() => T)): ShallowRef<T>;
 
 // File: src/composables/ref/useLazyItemByMarginRef.d.ts
 import { RefType } from '../../types/refTypes';
+export type LazyItemByMargin = { rootMargin: string; item: any; };
 export declare const useLazyItemByMarginRef: (element: RefType<HTMLElement | undefined>, rootMargin: string) => {
     lazyItemStatus: any;
     readonly lazyItem: any;
@@ -455,9 +468,16 @@ export declare const useLazyItemByMarginRef: (element: RefType<HTMLElement | und
 
 // File: src/composables/ref/useLazyRef.d.ts
 import { Ref, ShallowRef } from 'vue';
+export type LazyItem = {
+    status: ShallowRef<boolean>;
+    ratio: ShallowRef<number>;
+    entry: ShallowRef<IntersectionObserverEntry | undefined>;
+    stopWatch: () => void;
+};
+export type LazyList = Record<string, LazyItem>;
 export declare const useLazyRef: (options?: IntersectionObserverInit) => {
     intersectionObserver: IntersectionObserver | undefined;
-    getItem(element: HTMLElement): any;
+    getItem(element: HTMLElement): LazyItem;
     addLazyItem(element: Ref<HTMLElement | undefined>): ShallowRef<boolean, boolean>;
     removeLazyItem: (element?: HTMLElement) => void;
     disconnectLazy: () => void | undefined;
@@ -493,10 +513,33 @@ export declare const useMeta: () => Readonly<{
     setRobots: (value: MetaRobots) => void;
     setSiteName: (value: string) => void;
     setSuffix: (suffix: string) => typeof MetaStatic;
-}> & {
-    init(): any;
+} & {
+    init(): Readonly<{
+        meta: typeof MetaStatic;
+        title: Ref<string, string>;
+        keyword: Ref<string, string>;
+        description: Ref<string, string>;
+        author: Ref<string, string>;
+        image: Ref<string, string>;
+        canonical: Ref<string, string>;
+        robots: Ref<MetaRobots, MetaRobots>;
+        siteName: Ref<string, string>;
+        getHtmlMeta: () => string;
+        sync: () => void;
+        update: () => void;
+        updateSsr: () => void;
+        setTitle: (value: string) => void;
+        setKeywords: (value: string) => void;
+        setDescription: (value: string) => void;
+        setAuthor: (value: string) => void;
+        setImage: (value: string) => void;
+        setCanonical: (value: string) => void;
+        setRobots: (value: MetaRobots) => void;
+        setSiteName: (value: string) => void;
+        setSuffix: (suffix: string) => typeof MetaStatic;
+    }>;
     destroyExecute?(): void;
-};
+}>;
 
 // File: src/composables/ref/useQueryRef.d.ts
 import { ShallowRef } from 'vue';
@@ -685,6 +728,7 @@ export * from './classes/ref/EventRef';
 export * from './classes/ref/GeoFlagRef';
 export * from './classes/ref/GeoIntlRef';
 export * from './classes/ref/GeoRef';
+export * from './classes/ref/GeoUnitRef';
 export * from './classes/ref/ListDataRef';
 export * from './classes/ref/RouterItemRef';
 export * from './classes/ref/ScrollbarWidthRef';
@@ -701,6 +745,7 @@ export * from './composables/ref/useBroadcastValueRef';
 export * from './composables/ref/useCookieRef';
 export * from './composables/ref/useFormattersRef';
 export * from './composables/ref/useGeoIntlRef';
+export * from './composables/ref/useGeoUnitRef';
 export * from './composables/ref/useHashRef';
 export * from './composables/ref/useLazyItemByMarginRef';
 export * from './composables/ref/useLazyRef';
@@ -805,8 +850,17 @@ export type ConstrSetup<E extends Element, CLASSES extends ConstrClasses, SETUP
     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 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; };
@@ -815,11 +869,25 @@ export type ConstrHrefProps = { href?: string; };
 import { NumberOrString, NumberOrStringOrBoolean } from '@dxtmisha/functional-basic';
 import { ConstrBind } from './constructorTypes';
 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 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 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>;

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

@@ -0,0 +1,153 @@
+import { ComputedRef, Ref } from 'vue';
+import { GeoUnit, NumberOrString } from '@dxtmisha/functional-basic';
+import { RefOrNormal } from '../../types/refTypes';
+/**
+ * Reactive class for managing localized unit formatting and automatic conversions.
+ *
+ * Реактивный класс для управления локализованным форматированием единиц измерения и автоматической конвертацией.
+ */
+export declare class GeoUnitRef {
+    /** Location reference / Ссылка на локацию */
+    protected location: Ref<string | undefined>;
+    /** Computed instance of GeoUnit / Вычисляемый экземпляр GeoUnit */
+    protected unitInstance: ComputedRef<GeoUnit>;
+    /**
+     * Constructor.
+     * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
+     */
+    constructor(code?: RefOrNormal<string>);
+    /**
+     * Returns the standard location code.
+     *
+     * Возвращает стандартный код местоположения.
+     * @returns standard location code / стандартный код местоположения
+     */
+    getLocation(): ComputedRef<string>;
+    /**
+     * Formats millimeter value, converting to inches if overridden by locale unit settings.
+     *
+     * Форматирует значение в миллиметрах, конвертируя в дюймы, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    millimeter(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats centimeter value, converting to inches if overridden by locale unit settings.
+     *
+     * Форматирует значение в сантиметрах, конвертируя в дюймы, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    centimeter(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats meter value, converting to feet if overridden by locale unit settings.
+     *
+     * Форматирует значение в метрах, конвертируя в футы, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    meter(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats kilometer value, converting to miles if overridden by locale unit settings.
+     *
+     * Форматирует значение в километрах, конвертируя в мили, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    kilometer(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats square meter value, converting to square feet if overridden by locale unit settings.
+     *
+     * Форматирует значение в квадратных метрах, конвертируя в квадратные футы, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    squareMeter(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats hectare value, converting to acres if overridden by locale unit settings.
+     *
+     * Форматирует значение в гектарах, конвертируя в акры, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    hectare(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats gram value, converting to ounces if overridden by locale unit settings.
+     *
+     * Форматирует значение в граммах, конвертируя в унции, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    gram(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats kilogram value, converting to pounds if overridden by locale unit settings.
+     *
+     * Форматирует значение в килограммах, конвертируя в фунты, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    kilogram(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats tonne value, converting to short tons if overridden by locale unit settings.
+     *
+     * Форматирует значение в тоннах, конвертируя в короткие тонны, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    tonne(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats milliliter value, converting to fluid ounces if overridden by locale unit settings.
+     *
+     * Форматирует значение в миллилитрах, конвертируя в жидкие унции, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    milliliter(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats liter value, converting to gallons if overridden by locale unit settings.
+     *
+     * Форматирует значение в литрах, конвертируя в галлоны, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    liter(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats celsius value, converting to fahrenheit if overridden by locale unit settings.
+     *
+     * Форматирует значение в градусах Цельсия, конвертируя в градусы Фаренгейта, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    celsius(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats kilometer per hour value, converting to miles per hour if overridden by locale unit settings.
+     *
+     * Форматирует значение в километрах в час, конвертируя в мили в час, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    kilometerPerHour(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+    /**
+     * Formats the value for the specified unit reactively, converting and formatting it according to the locale.
+     *
+     * Форматирует значение для указанной единицы измерения реактивно, преобразуя и форматируя его в соответствии с локалью.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param unit unit of measurement / единица измерения
+     * @param options formatting options / параметры форматирования
+     * @returns computed formatted unit string / вычисляемая отформатированная строка единицы измерения
+     */
+    format(value: RefOrNormal<NumberOrString>, unit: RefOrNormal<string>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
+}

package/dist/{src/classes → classes}/ref/RouterItemRef.d.ts

@@ -1,4 +1,4 @@
-import { RouteLocationRaw, Router } from 'vue-router';
+import { RouteLocationRaw, Router, _RouterClassic } from 'vue-router';
 import { ConstrHrefProps } from '../../types/constructorTypes';
 /**
  * Router management class.
@@ -11,7 +11,7 @@ export declare class RouterItemRef {
      *
      * Получить экземпляр роутера.
      */
-    static get(): Router;
+    static get(): _RouterClassic;
     /**
      * Returns the link by name.
      *

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

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

package/dist/{src/library.d.ts → library.d.ts}

@@ -10,6 +10,7 @@ export * from './classes/ref/EventRef';
 export * from './classes/ref/GeoFlagRef';
 export * from './classes/ref/GeoIntlRef';
 export * from './classes/ref/GeoRef';
+export * from './classes/ref/GeoUnitRef';
 export * from './classes/ref/ListDataRef';
 export * from './classes/ref/RouterItemRef';
 export * from './classes/ref/ScrollbarWidthRef';
@@ -26,6 +27,7 @@ export * from './composables/ref/useBroadcastValueRef';
 export * from './composables/ref/useCookieRef';
 export * from './composables/ref/useFormattersRef';
 export * from './composables/ref/useGeoIntlRef';
+export * from './composables/ref/useGeoUnitRef';
 export * from './composables/ref/useHashRef';
 export * from './composables/ref/useLazyItemByMarginRef';
 export * from './composables/ref/useLazyRef';