@dxtmisha/functional 1.13.5 → 1.13.7

package/CHANGELOG.md

@@ -2,8 +2,17 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.13.7] - 2026-06-19
+
+### Added
+- **GeoRef**: Added static reactive `getLocation()`, `getLocationCountry()`, and `getLocationLanguage()` methods returning isolated `ComputedRef<string>` representations of location components.
+
+### Fixed
+- **Tests**: Adjusted test assertions in `GeoRef.test.ts` for `'en-VN'` to expect country `'VN'` and standard `'en-VN'` under the country-first matching priority.
+
 ## [1.13.5] - 2026-06-17
 
+
 ### Changed / Improved
 - **GeoRef**: Refactored static getters (`getCountry`, `getLanguage`, `getStandard`, `getFirstDay`) to use request-isolated computed references via `ServerStorage.get`. This isolates their reactive state per request, resolving potential cross-request state pollution during SSR.
 

package/ai-description.md

@@ -0,0 +1,18 @@
+Core Purpose: A high-level reactive framework for Vue 3 that abstracts complex state, API orchestration, and UI design patterns. It provides a standardized layer for API management (including SSR support), data formatting, list manipulation, and design component architecture.
+
+Key Expositions:
+1. API Management: `useApiRef` (standard reactive fetch), `useApiManagementRef` (orchestrates GET/POST/PUT/DELETE with search/formatting), and SSR-specific versions (`useApiAsyncRef`, `useApiManagementAsyncRef`).
+2. Design System Components: `DesignConstructorAbstract` and `DesignComponents` for building reactive, theme-aware components; `DesignChanged` for tracking property mutations.
+3. Geo/Intl Utilities: `GeoIntlRef` (localized formatting for numbers, dates, currency, size), `GeoRef` (locale/country state management), and `GeoFlagRef`.
+4. Reactive Ref Utilities: `ListDataRef` (complex list management, grouping, selection, navigation), `EventRef` (reactive event listeners), and various composables for `localStorage`/`sessionStorage`/`cookies`.
+5. Functional Helpers: `executeUse` (singleton management: global/provide/local), `computedAsync`/`computedEternity` (advanced reactivity wrappers).
+
+Triggers for Studying ai-types.md:
+- When implementing or consuming API requests with `useApi...` hooks to understand data contracts and error handling.
+- When configuring `executeUse` strategies (global vs provide) for service injection.
+- When defining component properties or structures using `Constr...` types (e.g., `ConstrBind`, `ConstrOptions`).
+- When managing complex lists or search logic requiring `ListDataRef` or `Search...` types.
+- When creating custom design classes inheriting from `DesignConstructorAbstract`.
+
+Integration Context: 
+This library serves as a middleware layer between raw API responses/browser APIs and Vue components. It is designed to work with `@dxtmisha/functional-basic` (the core utility provider) and relies on Vue's reactivity system. It is meant to be registered as a plugin (`dxtFunctionalPlugin`) to provide global configurations for API clients, translation services, and routing.

package/ai-doc.md

@@ -0,0 +1,226 @@
+This is the main functional library for the Vue environment (@dxtmisha/functional). It contains Vue-specific utilities, composables, and reactive classes.
+
+USAGE RULES:
+1. When developing in Vue, always use this library for functionality, logic, and composables instead of `@dxtmisha/functional-basic` whenever possible.
+2. It wraps basic non-reactive logic into Vue's reactivity system. If the required function or composable exists here, it has absolute priority.
+3. Import utilities from `@dxtmisha/functional` for reactive UI behavior, composables, and state management.
+
+WORKING WITH API AND STATE (useApi / executeUse):
+A set of composables is provided for network requests: `useApiGet`, `useApiPost`, `useApiPut`, `useApiDelete`, `useApiRequest`, `useApiRef`, `useApiAsyncRef`, `useApiManagementRef`, `useApiManagementAsyncRef`.
+Strictly follow these rules for their application:
+
+1. DO NOT call these composables directly in the Vue components (SFC).
+2. Move all API configurations and `useApi*` calls into SEPARATE FILES (services/stores).
+3. Wrap the API configurations inside the `executeUse` factory (specifically: `executeUseGlobal`, `executeUseProvide`, or `executeUseLocal` from `src/functions/executeUse.ts`). This guarantees the creation of managed singletons (single access point) and prevents duplicated requests and reactive states.
+4. Perform any additional request processing (e.g., data mapping, preparing structures for skeletons before loading a form) in the same file, inside the `executeUse` callback, and return a fully prepared set of data and methods.
+   *Example of correct usage:*
+   ```ts
+   import { executeUseGlobal } from '@dxtmisha/functional';
+   import { useApiManagementRef } from '@dxtmisha/functional';
+
+   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
+       { path: (o) => `/api/users/${o.id}` },  // PUT
+       { path: (o) => `/api/users/${o.id}` }   // DELETE
+     );
+     // Logic for skeletons, additional formatting, etc., should be added here,
+     // and then return the extended object.
+   });
+   ```
+5. Within the Vue component itself, simply import and call your custom singleton composable: `const { list, loading, sendPost } = useUserManagement();`
+
+CHOOSING THE executeUse STRATEGY:
+1. `executeUseLocal` (PREFERRED):
+   - When to use: For most API requests and services.
+   - Key Features: Works "lazily" (lazy initialization) — initializes only when first called. The instance persists until the end of the session. This prevents overloading the application start with unnecessary requests.
+2. `executeUseGlobal`:
+   - When to use: When data or a service must be loaded/initialized IMMEDIATELY at application start (e.g., critical settings, SDKs).
+   - Key Features: Creates a single instance for the entire application. All global singletons are forcibly initialized via `executeUseGlobalInit()`.
+3. `executeUseProvide`:
+   - When to use: For state shared between a parent and a group of child components (e.g., tabs, complex forms with sub-components).
+   - Key Features: Uses provide/inject. The first component in the tree that calls the hook becomes the "provider", others become consumers.
+
+=============================================================================
+DEVELOPER GUIDE: USING `@dxtmisha/functional` AS A LIBRARY
+=============================================================================
+
+This section contains instructions and code guidelines for AI models on how to import and use the Vue-specific reactive classes, composables, and utility functions provided by this library in Vue 3 / Nuxt applications.
+
+---
+
+### 1. Reactive Storage & State Composables
+
+These composables bind browser storages reactively to Vue `Ref` objects, keeping them in sync.
+
+#### `useStorageRef` (localStorage)
+Reactively binds a key from `localStorage`.
+```typescript
+import { useStorageRef } from '@dxtmisha/functional';
+
+// Bind to key with optional initial default value
+const theme = useStorageRef<'light' | 'dark'>('theme_key', 'light');
+
+// Setting the value triggers an immediate update to localStorage reactively
+theme.value = 'dark';
+```
+
+#### `useSessionRef` (sessionStorage) & `useCookieRef` (Cookies)
+```typescript
+import { useSessionRef, useCookieRef } from '@dxtmisha/functional';
+
+// sessionStorage
+const step = useSessionRef<number>('form_step', 1);
+
+// CookieStorage
+const token = useCookieRef<string>('auth_token', '', { secure: true });
+```
+
+#### `useBroadcastValueRef` (Cross-Tab Synchronization)
+Synchronizes a state value reactively across multiple browser tabs under the same origin.
+```typescript
+import { useBroadcastValueRef } from '@dxtmisha/functional';
+
+// Synchronizes the value of the ref across tabs using BroadcastChannel
+const syncState = useBroadcastValueRef<string>('active_channel', 'idle');
+```
+
+#### `useHashRef` (URL Hash)
+Reactively binds Vue state to the URL hash parameters.
+```typescript
+import { useHashRef } from '@dxtmisha/functional';
+
+const hashPage = useHashRef<string>('page', 'home');
+```
+
+---
+
+### 2. Reactive Geolocation & Internationalization (`GeoRef`, `GeoIntlRef`, `GeoFlagRef`, `useTranslateRef`)
+
+Provides reactive integrations for internationalization APIs.
+
+#### `GeoRef` & `GeoIntlRef`
+```typescript
+import { GeoRef, useGeoIntlRef } from '@dxtmisha/functional';
+
+// Reactive tracking of user location details
+const currentCountry = GeoRef.getCountry(); // ComputedRef<string>
+
+// Reactive i18n formatter hook
+const intl = useGeoIntlRef();
+const formattedPrice = intl.currency(150, 'EUR'); // ComputedRef<string>
+```
+
+#### `useTranslateRef`
+Reactively loads and gets translation tokens.
+```typescript
+import { useTranslateRef } from '@dxtmisha/functional';
+
+const translations = useTranslateRef(['global.save', 'global.cancel']);
+// returns: ShallowRef<Record<string, string>> containing loaded translations
+```
+
+---
+
+### 3. SEO & Layout Utilities
+
+#### `useMeta`
+Manages page metadata reactively. Calling setters will update document headers and tags reactively.
+```typescript
+import { useMeta } from '@dxtmisha/functional';
+
+const metaManager = useMeta();
+metaManager.setTitle('My Product Page');
+metaManager.setDescription('Product details and configurations.');
+```
+
+#### `ScrollbarWidthRef`
+Tracks the scrollbar width reactively to solve layout shift issues.
+```typescript
+import { ScrollbarWidthRef } from '@dxtmisha/functional';
+
+const scrollbar = new ScrollbarWidthRef();
+const width = scrollbar.width; // Ref<number>
+const hasScroll = scrollbar.is; // ComputedRef<boolean>
+```
+
+---
+
+### 4. Advanced Reactivity Helpers
+
+#### `computedAsync`
+Creates a computed property that resolves its value asynchronously. Useful for async tasks inside computed getters.
+```typescript
+import { computedAsync } from '@dxtmisha/functional';
+
+// Performs asynchronous data lookup and reactively returns the result
+const asyncData = computedAsync(async () => {
+  return await fetchSomeData(activeId.value);
+}, 'initial_loading_value');
+```
+
+#### `computedEternity`
+Computes an asynchronous value once and caches it indefinitely unless manually refreshed.
+```typescript
+import { computedEternity } from '@dxtmisha/functional';
+
+const cachedData = computedEternity(async () => {
+  return await fetchStaticData();
+}, 'loading_state');
+```
+
+---
+
+### 5. List & Search Orchestration
+
+#### `ListDataRef`
+A powerful reactive state orchestrator for managing lists, groups, items, pagination, highlight paths, and selections.
+```typescript
+import { ListDataRef } from '@dxtmisha/functional';
+
+const items = ref([
+  { value: 'id1', label: 'First Option' },
+  { value: 'id2', label: 'Second Option' },
+]);
+const selectedId = ref('id1');
+
+const listData = new ListDataRef(items, selectedId);
+const isSelected = listData.isSelected; // ComputedRef<boolean>
+const nextItem = listData.getSelectedNext(); // returns next select item
+```
+
+#### `useSearchRef`
+Combines a source list, target fields, search query, and options to reactively search a list with built-in delay and highlight support.
+```typescript
+import { useSearchRef } from '@dxtmisha/functional';
+
+const query = ref('second');
+const { listSearch, loading, length } = useSearchRef(items, ['label'], query);
+```
+
+---
+
+### 6. DOM & Lazy Rendering
+
+#### `EventRef`
+Reactive wrapper for DOM events. Starts and stops event binding cleanly inside Vue component lifecycles (runs setup and teardown hooks automatically).
+```typescript
+import { EventRef } from '@dxtmisha/functional';
+
+// Listens reactively; auto-starts on setup and auto-stops on unmounted
+const keyListener = new EventRef(window, window, 'keydown', (event) => {
+  console.log('Key pressed', event.key);
+});
+```
+
+#### `useLazyRef`
+Reactive manager utilizing `IntersectionObserver` to defer rendering of off-screen components.
+```typescript
+import { useLazyRef } from '@dxtmisha/functional';
+
+const lazyManager = useLazyRef();
+const isVisible = lazyManager.addLazyItem(elementRef); // ShallowRef<boolean>
+```

package/{ai-types.txt → ai-types.md}

@@ -16,10 +16,6 @@ The following is the content of "exports" from package.json:
 
 // File: src/classes/design/DesignAbstract.d.ts
 export declare abstract class DesignAbstract<T extends Record<string, any>, C extends Record<string, any>> {
-    protected readonly props: T;
-    protected readonly callback?: ((event: C) => void) | undefined;
-    protected readonly event: C;
-    protected readonly changed: DesignChanged<T>;
     constructor(props: T, callback?: ((event: C) => void) | undefined, changed?: string[]);
     make(compelled?: boolean): this;
     makeCallback(compelled?: boolean): void;
@@ -35,8 +31,6 @@ export declare abstract class DesignAsyncAbstract<T extends Record<string, any>,
 
 // File: src/classes/design/DesignChanged.d.ts
 export declare class DesignChanged<T extends Record<string, any>> {
-    protected readonly props: T;
-    protected readonly watch: string[];
     constructor(props: T, watch?: string[]);
     is(name: string | string[]): boolean;
     isChanged(): boolean;
@@ -49,9 +43,6 @@ export declare class DesignComp<COMP extends ConstrComponent, P extends ConstrIt
 
 // File: src/classes/design/DesignComponents.d.ts
 export declare class DesignComponents<COMP extends ConstrComponent, P extends ConstrItem> {
-    protected readonly components: COMP;
-    protected readonly modification?: ConstrComponentMod<P> | undefined;
-    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];
@@ -63,20 +54,6 @@ export declare class DesignComponents<COMP extends ConstrComponent, P extends Co
 
 // File: src/classes/design/DesignConstructorAbstract.d.ts
 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 classesSub?: ComputedRef<Partial<CLASSES>>;
-    protected readonly styles?: ComputedRef<ConstrStyles>;
-    protected stylesSub?: 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;
@@ -91,24 +68,10 @@ export declare abstract class DesignConstructorAbstract<E extends Element, COMP
     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;
 }
 
 // File: src/classes/ref/DatetimeRef.d.ts
 export declare class DatetimeRef {
-    protected item: Ref<NumberOrStringOrDate>;
-    protected type: Ref<GeoDate>;
-    protected code: Ref<string>;
-    protected date: Ref<Date>;
-    protected datetime: Datetime;
-    protected year: Ref<number, number>;
-    protected month: Ref<number, number>;
-    protected day: Ref<number, number>;
-    protected hour: Ref<number, number>;
-    protected minute: Ref<number, number>;
-    protected second: Ref<number, number>;
     constructor(date: RefOrNormal<NumberOrStringOrDate>, type?: RefOrNormal<GeoDate>, code?: RefOrNormal<string>);
     getItem(): Ref<NumberOrStringOrDate>;
     getDate(): Ref<Date>;
@@ -138,7 +101,6 @@ export declare class EventRef<E extends ElementOrWindow, O extends Event, D exte
 
 // File: src/classes/ref/GeoFlagRef.d.ts
 export declare class GeoFlagRef {
-    protected flag: ComputedRef<GeoFlag>;
     constructor(code?: RefOrNormal<string | undefined>);
     getCode(): string;
     get(code?: RefOrNormal<string>): ComputedRef<GeoFlagItem | undefined>;
@@ -181,25 +143,15 @@ export declare class GeoRef {
     static getLanguage(): ComputedRef<string>;
     static getStandard(): ComputedRef<string>;
     static getFirstDay(): ComputedRef<string>;
+    static getLocation(): ComputedRef<string>;
+    static getLocationCountry(): ComputedRef<string>;
+    static getLocationLanguage(): ComputedRef<string>;
     static set(code: string): void;
     static setValueDefault(code?: string | (() => string)): void;
 }
 
 // File: src/classes/ref/ListDataRef.d.ts
 export declare class ListDataRef {
-    protected readonly list: RefOrNormal<ListListInput | undefined>;
-    protected readonly focus?: RefType<ListSelectedItem | undefined> | undefined;
-    protected readonly highlight?: RefType<string | undefined> | undefined;
-    protected readonly highlightLengthStart?: RefType<number | undefined> | undefined;
-    protected readonly filterMode?: RefType<boolean | undefined> | undefined;
-    protected readonly selected?: RefType<ListSelectedList | undefined> | undefined;
-    protected readonly keyValue?: RefType<string | undefined> | undefined;
-    protected readonly keyLabel?: RefType<string | undefined> | undefined;
-    protected readonly lite?: RefType<number | undefined> | undefined;
-    protected readonly min: RefOrNormal<number | string | undefined>;
-    protected readonly max: RefOrNormal<number | string | undefined>;
-    protected readonly parent?: string | undefined;
-    protected subList: Record<any, 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);
     readonly data: ComputedRef<ListList>;
     readonly liteData: ComputedRef<ListList>;
@@ -415,23 +367,71 @@ export declare const useLazyItemByMarginRef: (element: RefType<HTMLElement | und
 
 // File: src/composables/ref/useLazyRef.d.ts
 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): LazyItem; addLazyItem(element: Ref<HTMLElement | undefined>): ShallowRef<boolean, boolean>; removeLazyItem: (element?: HTMLElement) => void; disconnectLazy: () => void | undefined; };
+export declare const useLazyRef: (options?: IntersectionObserverInit) => {
+    intersectionObserver: IntersectionObserver | undefined;
+    getItem(element: HTMLElement): LazyItem;
+    addLazyItem(element: Ref<HTMLElement | undefined>): ShallowRef<boolean, boolean>;
+    removeLazyItem: (element?: HTMLElement) => void;
+    disconnectLazy: () => void | undefined;
+};
 
 // File: src/composables/ref/useLoadingRef.d.ts
 export declare function useLoadingRef(): ShallowRef<boolean, boolean>;
 
 // File: src/composables/ref/useMeta.d.ts
-export declare const useMeta: () => 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; } & { init(): Readonly<any>; destroyExecute?(): void; }>;
+export declare const useMeta: () => 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;
+} & {
+    init(): any;
+    destroyExecute?(): void;
+}>;
 
 // File: src/composables/ref/useRouterList.d.ts
-export declare const useRouterList: <T extends ListDataBasic>(list: RefType<ConstrBind<T>[] | undefined>, selected?: Ref<string> | string, hasTo?: boolean) => { item: ComputedRef<T | undefined>; selected: Ref<string, string>; label: ComputedRef<NumberOrString>; list: ComputedRef<ConstrBind<T>[]>; to: (name?: string) => void; toMain(): void; };
+export declare const useRouterList: <T extends ListDataBasic>(list: RefType<ConstrBind<T>[] | undefined>, selected?: Ref<string> | string, hasTo?: boolean) => {
+    item: ComputedRef<T | undefined>;
+    selected: Ref<string, string>;
+    label: ComputedRef<NumberOrString>;
+    list: ComputedRef<ConstrBind<T>[]>;
+    to: (name?: string) => void;
+    toMain(): void;
+};
 
 // File: src/composables/ref/useSearchRef.d.ts
-export declare function useSearchRef<T extends SearchItem, K extends SearchColumns<T>>(list: SearchListInput<T>, columns: K, value?: Ref<string>, options?: SearchOptions): { isSearch: ComputedRef<boolean>; search: Ref<string, string>; loading: Ref<boolean, boolean>; listSearch: ComputedRef<SearchFormatList<T, K>>; length: ComputedRef<number>; };
+export declare function useSearchRef<T extends SearchItem, K extends SearchColumns<T>>(list: SearchListInput<T>, columns: K, value?: Ref<string>, options?: SearchOptions): {
+    isSearch: ComputedRef<boolean>;
+    search: Ref<string, string>;
+    loading: Ref<boolean, boolean>;
+    listSearch: ComputedRef<SearchFormatList<T, K>>;
+    length: ComputedRef<number>;
+};
 
 // File: src/composables/ref/useSearchValueRef.d.ts
-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>; loading: Ref<boolean, boolean>; };
+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>;
+    loading: Ref<boolean, boolean>;
+};
 
 // File: src/composables/ref/useSessionRef.d.ts
 export declare function useSessionRef<T>(name: string, defaultValue?: T | (() => T)): Ref<T | undefined>;
@@ -459,16 +459,25 @@ export declare function computedByLanguage<T, R extends (T | undefined) = T | un
 export declare function computedEternity<T>(getter: () => Promise<T> | T, initialState?: (() => T) | T): Ref<T, T>;
 
 // File: src/functions/dxtFunctionalPlugin.d.ts
-export interface FunctionalPluginOptions { api?: ApiConfig; translate?: TranslateConfig; location?: string | (() => string); metaSuffix?: string; icons?: IconsConfig; router?: Router; errorCauses?: ErrorCenterCauseList; errorHandlers?: ErrorCenterHandlerList; }
+export interface FunctionalPluginOptions {
+    api?: ApiConfig;
+    translate?: TranslateConfig;
+    location?: string | (() => string);
+    metaSuffix?: string;
+    icons?: IconsConfig;
+    router?: Router;
+    errorCauses?: ErrorCenterCauseList;
+    errorHandlers?: ErrorCenterHandlerList;
+}
 export declare const dxtFunctionalPlugin: Plugin;
 
 // File: src/functions/executeUse.d.ts
 export declare enum ExecuteUseType { global = "global", provide = "provide", local = "local" }
 export type ExecuteUseReturn<R> = Readonly<R & { init(): Readonly<R>; destroyExecute?(): void; }>;
 export declare function executeUse<R, O extends any[], RI extends ExecuteUseReturn<R> = ExecuteUseReturn<R>>(callback: (...args: O) => R, type?: ExecuteUseType): ((...args: O) => RI) | (() => RI);
-export declare function executeUseGlobal<R>(callback: () => R): (() => Readonly<any>) | (() => Readonly<any>);
-export declare function executeUseProvide<R, O extends any[]>(callback: (...args: O) => R): ((...args: O) => Readonly<any>) | (() => Readonly<any>);
-export declare function executeUseLocal<R, O extends any[]>(callback: (...args: O) => R): ((...args: O) => Readonly<any>) | (() => Readonly<any>);
+export declare function executeUseGlobal<R>(callback: () => R): any;
+export declare function executeUseProvide<R, O extends any[]>(callback: (...args: O) => R): any;
+export declare function executeUseLocal<R, O extends any[]>(callback: (...args: O) => R): any;
 export declare function executeUseGlobalInit(): void;
 
 // File: src/functions/getInject.d.ts
@@ -513,12 +522,98 @@ export declare function toBind<R extends ItemList = ItemList>(extra: ItemList, v
 // File: src/functions/toBinds.d.ts
 export declare function toBinds<R extends ItemList = ItemList>(...values: (ItemList | undefined)[]): ConstrBind<R>;
 
+// File: src/library.d.ts
+export * from './classes/design/DesignAbstract';
+export * from './classes/design/DesignAsyncAbstract';
+export * from './classes/design/DesignChanged';
+export * from './classes/design/DesignComp';
+export * from './classes/design/DesignComponents';
+export * from './classes/design/DesignConstructorAbstract';
+export * from './classes/ref/DatetimeRef';
+export * from './classes/ref/EffectScopeGlobal';
+export * from './classes/ref/EventRef';
+export * from './classes/ref/GeoFlagRef';
+export * from './classes/ref/GeoIntlRef';
+export * from './classes/ref/GeoRef';
+export * from './classes/ref/ListDataRef';
+export * from './classes/ref/RouterItemRef';
+export * from './classes/ref/ScrollbarWidthRef';
+export * from './composables/ref/useApiAsyncRef';
+export * from './composables/ref/useApiDelete';
+export * from './composables/ref/useApiGet';
+export * from './composables/ref/useApiManagementAsyncRef';
+export * from './composables/ref/useApiManagementRef';
+export * from './composables/ref/useApiPost';
+export * from './composables/ref/useApiPut';
+export * from './composables/ref/useApiRef';
+export * from './composables/ref/useApiRequest';
+export * from './composables/ref/useBroadcastValueRef';
+export * from './composables/ref/useCookieRef';
+export * from './composables/ref/useFormattersRef';
+export * from './composables/ref/useGeoIntlRef';
+export * from './composables/ref/useHashRef';
+export * from './composables/ref/useLazyItemByMarginRef';
+export * from './composables/ref/useLazyRef';
+export * from './composables/ref/useLoadingRef';
+export * from './composables/ref/useMeta';
+export * from './composables/ref/useRouterList';
+export * from './composables/ref/useSearchRef';
+export * from './composables/ref/useSearchValueRef';
+export * from './composables/ref/useSessionRef';
+export * from './composables/ref/useStorageRef';
+export * from './composables/ref/useTranslateRef';
+export * from './functions/basic';
+export * from './functions/computedAsync';
+export * from './functions/computedByLanguage';
+export * from './functions/computedEternity';
+export * from './functions/dxtFunctionalPlugin';
+export * from './functions/executeUse';
+export * from './functions/getInject';
+export * from './functions/getOptions';
+export * from './functions/ref/executeFunctionRef';
+export * from './functions/ref/getApiErrorRef';
+export * from './functions/ref/getBindRef';
+export * from './functions/ref/getRef';
+export * from './functions/ref/render';
+export * from './functions/ref/setRef';
+export * from './functions/ref/toRefItem';
+export * from './functions/render/getBind';
+export * from './functions/render/getClassName';
+export * from './functions/render/getIndexForRender';
+export * from './functions/toBind';
+export * from './functions/toBinds';
+export * from './types/apiTypes';
+export * from './types/constructorTypes';
+export * from './types/listTypes';
+export * from './types/refTypes';
+export * from './types/searchTypes';
+
 // File: src/types/apiTypes.d.ts
 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 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 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;
+};
 
 // File: src/types/constructorTypes.d.ts
 export type ConstrItem = Record<string, any>;
@@ -535,8 +630,19 @@ 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 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; };

package/dist/library.js

@@ -368,6 +368,15 @@ var Oe = class {
 	static getFirstDay() {
 		return y.get("__ui:geo-ref-first-day__", () => I(() => this.get().value.firstDay));
 	}
+	static getLocation() {
+		return y.get("__ui:geo-ref-location__", () => I(() => this.get().value.location));
+	}
+	static getLocationCountry() {
+		return y.get("__ui:geo-ref-location-country__", () => I(() => this.get().value.locationCountry));
+	}
+	static getLocationLanguage() {
+		return y.get("__ui:geo-ref-location-language__", () => I(() => this.get().value.locationLanguage));
+	}
 	static set(e) {
 		u.set(e, !0), this.get().value = u.getItem();
 	}

package/dist/src/classes/ref/GeoRef.d.ts

@@ -43,6 +43,27 @@ export declare class GeoRef {
      * реактивная строка, представляющая первый день недели
      */
     static getFirstDay(): ComputedRef<string>;
+    /**
+     * Current location string.
+     *
+     * Текущее местоположение.
+     * @returns reactive string with the current location/ реактивная строка с текущим местоположением
+     */
+    static getLocation(): ComputedRef<string>;
+    /**
+     * Current country code from the location.
+     *
+     * Текущий код страны из местоположения.
+     * @returns reactive string with the current country code from location/ реактивная строка с кодом текущей страны из местоположения
+     */
+    static getLocationCountry(): ComputedRef<string>;
+    /**
+     * Current language code from the location.
+     *
+     * Текущий код языка из местоположения.
+     * @returns reactive string with the current language code from location/ реактивная строка с кодом текущего языка из местоположения
+     */
+    static getLocationLanguage(): ComputedRef<string>;
     /**
      * Changes the data by the full code.
      *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/functional",
   "private": false,
-  "version": "1.13.5",
+  "version": "1.13.7",
   "type": "module",
   "description": "A comprehensive library of utilities, base classes, and Vue 3 composables for reactive web development. Extends @dxtmisha/functional-basic with Composition API.",
   "keywords": [
@@ -46,10 +46,9 @@
   },
   "files": [
     "dist",
-    "ai-description.txt",
-    "ai-doc.ru.txt",
-    "ai-doc.txt",
-    "ai-types.txt",
+    "ai-description.md",
+    "ai-doc.md",
+    "ai-types.md",
     "CHANGELOG.md",
     "LICENSE",
     "package.json",

package/ai-description.txt

@@ -1,18 +0,0 @@
-This library is a collection of Vue 3-based utility classes and composables designed for building complex, reactive, and SSR-ready interfaces. It provides a standardized framework for API management, component state, geographic/localization data, and dynamic rendering.
-
-1. Core Purpose:
-An infrastructure-level toolkit for Vue 3 that abstracts asynchronous data fetching, state management, and UI rendering logic. It provides structured classes and composables to handle API lifecycle (GET/POST/PUT/DELETE), reactive data transformations, internationalization (Intl), and component orchestration.
-
-2. Usage Scenarios:
-- API Orchestration: When building complex forms, data tables, or dashboards requiring integrated state, validation (via @effect/schema compatibility), and SSR support. Use `useApiManagementRef` for unified CRUD handling or `useApiRef` for individual requests.
-- Reactive Data Management: When you need synchronized data across browser tabs (`useBroadcastValueRef`) or persistence across reloads (`useStorageRef`, `useCookieRef`).
-- Localization & Formatting: When the application needs to dynamically handle geographic data, currency formatting, file sizes, or date manipulation via `GeoIntlRef` and `useGeoIntlRef`.
-- Component Design System: When building modular UI components that require consistent prop-to-style/class mapping (`DesignConstructorAbstract`, `DesignComponents`).
-- Lifecycle & DOM Utilities: When implementing lazy loading (`useLazyRef`) or global state management using `executeUse` for singletons.
-
-3. Integration Context:
-- Vue 3 Core: Heavily leverages `Ref`, `ComputedRef`, and `provide/inject`.
-- Data Fetching: Acts as a high-level wrapper over an underlying `functional-basic` library.
-- Routing: Integrates with `vue-router` via `RouterItemRef` and `useRouterList`.
-- SSR: Provides specific `Async` variants (e.g., `useApiAsyncRef`) for server-side pre-fetching.
-- Schema Validation: Designed to work with `@effect/schema` for robust API contract validation.

package/ai-doc.ru.txt

@@ -1,45 +0,0 @@
-Это главная функциональная библиотека для среды Vue (@dxtmisha/functional). Здесь собраны утилиты, composables и реактивные классы, заточенные под Vue.
-
-ПРАВИЛА ИСПОЛЬЗОВАНИЯ:
-1. При разработке на Vue всегда отдавайте приоритет этой библиотеке для работы с логикой и composables, а не `@dxtmisha/functional-basic`.
-2. Библиотека оборачивает базовую нереактивную логику в систему реактивности Vue. Если нужная функция или класс есть здесь, они имеют абсолютный приоритет.
-3. Импортируйте утилиты из `@dxtmisha/functional` для реактивного поведения UI, composables и управления состоянием.
-
-РАБОТА С API И СОСТОЯНИЕМ (useApi / executeUse):
-Для работы с сетевыми запросами в библиотеке предусмотрен набор хуков: `useApiGet`, `useApiPost`, `useApiPut`, `useApiDelete`, `useApiRequest`, `useApiRef`, `useApiAsyncRef`, `useApiManagementRef`, `useApiManagementAsyncRef`.
-Строго соблюдайте следующие правила их применения:
-
-1. НЕ ВЫЗЫВАЙТЕ эти хуки напрямую в компонентах (SFC).
-2. Выносите всю настройку и вызовы `useApi*` в ОТДЕЛЬНЫЕ ФАЙЛЫ (сервисы / хранилища).
-3. Оборачивайте настройку API в фабрику `executeUse` (а именно: `executeUseGlobal`, `executeUseProvide` или `executeUseLocal` из `src/functions/executeUse.ts`). Это гарантирует создание синглтонов (одна точка доступа) и предотвращает создание дубликатов запросов и хранилищ состояния.
-4. Выполняйте любую дополнительную обработку запросов (например: маппинг данных, подготовка структуры для отображения скелетона перед загрузкой формы) в этом же файле, внутри коллбэка `executeUse`, а наружу возвращайте уже полностью готовый набор данных и методов.
-   *Пример правильного использования:*
-   ```ts
-   import { executeUseGlobal } from '@dxtmisha/functional';
-   import { useApiManagementRef } from '@dxtmisha/functional';
-
-   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
-       { path: (o) => `/api/users/${o.id}` },  // PUT
-       { path: (o) => `/api/users/${o.id}` }   // DELETE
-     );
-     // Здесь же можно добавить логику подготовки скелетонов, форматирования и т.д.
-     // и затем вернуть расширенный объект
-   });
-   ```
-5. В самом Vue-компоненте просто импортируйте и вызывайте созданный синглтон-хук: `const { list, loading, sendPost } = useUserManagement();`
-
-ВЫБОР СТРАТЕГИИ executeUse:
-1. `executeUseLocal` (ПРЕДПОЧТИТЕЛЬНО):
-   - Когда использовать: Для большинства API-запросов и сервисов.
-   - Особенности: Работает «лениво» (lazy) — инициализируется только в момент первого вызова. Экземпляр сохраняется до конца сессии. Это позволяет не перегружать старт приложения лишними запросами.
-2. `executeUseGlobal`:
-   - Когда использовать: Когда данные или сервис должны быть загружены/инициализированы СРАЗУ при старте приложения (например: критические настройки, SDK).
-   - Особенности: Создает один экземпляр на всё приложение. Все глобальные синглтоны инициализируются принудительно через `executeUseGlobalInit()`.
-3. `executeUseProvide`:
-   - Когда использовать: Для состояния, разделяемого между родителем и группой дочерних компонентов (например: табы, сложные формы с подкомпонентами).
-   - Особенности: Использует provide/inject. Первый компонент в дереве, вызвавший хук, становится «провайдером», остальные — потребителями.

package/ai-doc.txt

@@ -1,45 +0,0 @@
-This is the main functional library for the Vue environment (@dxtmisha/functional). It contains Vue-specific utilities, composables, and reactive classes.
-
-USAGE RULES:
-1. When developing in Vue, always use this library for functionality, logic, and composables instead of `@dxtmisha/functional-basic` whenever possible.
-2. It wraps basic non-reactive logic into Vue's reactivity system. If the required function or composable exists here, it has absolute priority.
-3. Import utilities from `@dxtmisha/functional` for reactive UI behavior, composables, and state management.
-
-WORKING WITH API AND STATE (useApi / executeUse):
-A set of composables is provided for network requests: `useApiGet`, `useApiPost`, `useApiPut`, `useApiDelete`, `useApiRequest`, `useApiRef`, `useApiAsyncRef`, `useApiManagementRef`, `useApiManagementAsyncRef`.
-Strictly follow these rules for their application:
-
-1. DO NOT call these composables directly in the Vue components (SFC).
-2. Move all API configurations and `useApi*` calls into SEPARATE FILES (services/stores).
-3. Wrap the API configurations inside the `executeUse` factory (specifically: `executeUseGlobal`, `executeUseProvide`, or `executeUseLocal` from `src/functions/executeUse.ts`). This guarantees the creation of managed singletons (single access point) and prevents duplicated requests and reactive states.
-4. Perform any additional request processing (e.g., data mapping, preparing structures for skeletons before loading a form) in the same file, inside the `executeUse` callback, and return a fully prepared set of data and methods.
-   *Example of correct usage:*
-   ```ts
-   import { executeUseGlobal } from '@dxtmisha/functional';
-   import { useApiManagementRef } from '@dxtmisha/functional';
-
-   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
-       { path: (o) => `/api/users/${o.id}` },  // PUT
-       { path: (o) => `/api/users/${o.id}` }   // DELETE
-     );
-     // Logic for skeletons, additional formatting, etc., should be added here,
-     // and then return the extended object.
-   });
-   ```
-5. Within the Vue component itself, simply import and call your custom singleton composable: `const { list, loading, sendPost } = useUserManagement();`
-
-CHOOSING THE executeUse STRATEGY:
-1. `executeUseLocal` (PREFERRED):
-   - When to use: For most API requests and services.
-   - Key Features: Works "lazily" (lazy initialization) — initializes only when first called. The instance persists until the end of the session. This prevents overloading the application start with unnecessary requests.
-2. `executeUseGlobal`:
-   - When to use: When data or a service must be loaded/initialized IMMEDIATELY at application start (e.g., critical settings, SDKs).
-   - Key Features: Creates a single instance for the entire application. All global singletons are forcibly initialized via `executeUseGlobalInit()`.
-3. `executeUseProvide`:
-   - When to use: For state shared between a parent and a group of child components (e.g., tabs, complex forms with sub-components).
-   - Key Features: Uses provide/inject. The first component in the tree that calls the hook becomes the "provider", others become consumers.