@dxtmisha/functional 1.12.1 → 1.13.1

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.12.3] - 2026-05-25
+
+### Changed / Improved
+- **Build System**: Configured `ui-priority: 200` inside `package.json` to ensure prioritized dependency order sorting during workspace build actions.
+- **Maintenance**: Version bumped to `1.12.3` for consistency.
+
+## [1.12.2] - 2026-05-25
+
+### Changed / Improved
+- **Tests**: Configured vitest runner execution environment via the `--no-webstorage` flag inside `package.json` to avoid persistent localStorage/sessionStorage warning outputs.
+
 ## [1.12.1] - 2026-05-21
 
 ### Fixed

package/dist/library.js

@@ -335,25 +335,22 @@ var Oe = class {
 	}
 }, Ae = class {
 	constructor(e = u.getLocation()) {
-		H(this, "code", void 0), H(this, "flag", void 0), this.code = K(e), this.flag = new d(this.code.value), B(this.code, (e) => this.flag.setCode(e));
+		H(this, "flag", void 0), this.flag = I(() => new d(U(e)));
 	}
 	getCode() {
-		return this.code;
+		return this.flag.value.getCode();
 	}
-	get(e = this.code.value) {
-		return I(() => this.flag.get(U(e)));
+	get(e = this.getCode()) {
+		return I(() => this.flag.value.get(U(e)));
 	}
-	getFlag(e = this.code.value) {
-		return I(() => {
-			var t;
-			return (t = this.flag.get(U(e))) == null ? void 0 : t.icon;
-		});
+	getFlag(e = this.getCode()) {
+		return I(() => this.flag.value.getFlag(U(e)));
 	}
 	getList(e) {
-		return I(() => this.flag.getList(U(e)));
+		return I(() => this.flag.value.getList(U(e)));
 	}
 	getNational(e) {
-		return I(() => this.flag.getNational(U(e)));
+		return I(() => this.flag.value.getNational(U(e)));
 	}
 }, J, Y = class {
 	static get() {
@@ -1325,20 +1322,25 @@ function kt(e) {
 	}
 }
 //#endregion
+//#region src/functions/ref/executeFunctionRef.ts
+function At(e) {
+	return U(x(e));
+}
+//#endregion
 //#region src/functions/render/getBind.ts
-function At(e, t = {}, n = "value", r = !1) {
+function jt(e, t = {}, n = "value", r = !1) {
 	let i = typeof t == "string", a = i ? t : n, o = i ? {} : t;
 	return e ? e && M(e) && (a in e || r) ? W(o, e) : W(o, { [a]: e }) : i ? {} : { ...o };
 }
 //#endregion
 //#region src/functions/ref/getBindRef.ts
-function jt(e, t = {}, n = "value") {
-	return I(() => At(U(e), U(t), n));
+function Mt(e, t = {}, n = "value") {
+	return I(() => jt(U(e), U(t), n));
 }
 //#endregion
 //#region src/functions/ref/setRef.ts
-function Mt(e, t) {
+function Nt(e, t) {
 	e.value !== t && (e.value = t);
 }
 //#endregion
-export { Oe as DatetimeRef, be as DesignAbstract, xe as DesignAsyncAbstract, ye as DesignChanged, Ee as DesignComp, G as DesignComponents, De as DesignConstructorAbstract, q as EffectScopeGlobal, ke as EventRef, st as ExecuteUseType, Ae as GeoFlagRef, je as GeoIntlRef, Y as GeoRef, Me as ListDataRef, X as RouterItemRef, Pe as ScrollbarWidthRef, Tt as computedAsync, Et as computedByLanguage, Dt as computedEternity, Ot as dxtFunctionalPlugin, $ as executeUse, ft as executeUseGlobal, ht as executeUseGlobalInit, mt as executeUseLocal, pt as executeUseProvide, Fe as getApiErrorRef, At as getBind, jt as getBindRef, Se as getClassName, Ce as getIndexForRender, kt as getInject, Ie as getOptions, U as getRef, we as render, Re as setApiRefGlobalConditions, Mt as setRef, wt as t, W as toBind, Te as toBinds, K as toRefItem, ze as useApiAsyncRef, Be as useApiDelete, Ve as useApiGet, Je as useApiManagementAsyncRef, qe as useApiManagementRef, He as useApiPost, Ue as useApiPut, Le as useApiRef, Q as useApiRequest, Xe as useBroadcastValueRef, Qe as useCookieRef, We as useFormattersRef, $e as useGeoIntlRef, tt as useHashRef, at as useLazyItemByMarginRef, nt as useLazyRef, ot as useLoadingRef, _t as useMeta, vt as useRouterList, Ke as useSearchRef, Ge as useSearchValueRef, bt as useSessionRef, St as useStorageRef, Ct as useTranslateRef };
+export { Oe as DatetimeRef, be as DesignAbstract, xe as DesignAsyncAbstract, ye as DesignChanged, Ee as DesignComp, G as DesignComponents, De as DesignConstructorAbstract, q as EffectScopeGlobal, ke as EventRef, st as ExecuteUseType, Ae as GeoFlagRef, je as GeoIntlRef, Y as GeoRef, Me as ListDataRef, X as RouterItemRef, Pe as ScrollbarWidthRef, Tt as computedAsync, Et as computedByLanguage, Dt as computedEternity, Ot as dxtFunctionalPlugin, At as executeFunctionRef, $ as executeUse, ft as executeUseGlobal, ht as executeUseGlobalInit, mt as executeUseLocal, pt as executeUseProvide, Fe as getApiErrorRef, jt as getBind, Mt as getBindRef, Se as getClassName, Ce as getIndexForRender, kt as getInject, Ie as getOptions, U as getRef, we as render, Re as setApiRefGlobalConditions, Nt as setRef, wt as t, W as toBind, Te as toBinds, K as toRefItem, ze as useApiAsyncRef, Be as useApiDelete, Ve as useApiGet, Je as useApiManagementAsyncRef, qe as useApiManagementRef, He as useApiPost, Ue as useApiPut, Le as useApiRef, Q as useApiRequest, Xe as useBroadcastValueRef, Qe as useCookieRef, We as useFormattersRef, $e as useGeoIntlRef, tt as useHashRef, at as useLazyItemByMarginRef, nt as useLazyRef, ot as useLoadingRef, _t as useMeta, vt as useRouterList, Ke as useSearchRef, Ge as useSearchValueRef, bt as useSessionRef, St as useStorageRef, Ct as useTranslateRef };

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

@@ -1,4 +1,4 @@
-import { ComputedRef, Ref } from 'vue';
+import { ComputedRef } from 'vue';
 import { GeoFlag, GeoFlagItem, GeoFlagNational } from '@dxtmisha/functional-basic';
 import { RefOrNormal } from '../../types/refTypes';
 /**
@@ -7,45 +7,52 @@ import { RefOrNormal } from '../../types/refTypes';
  * Класс для работы с Флагами.
  */
 export declare class GeoFlagRef {
-    protected code: Ref<string>;
-    protected flag: GeoFlag;
+    /** Instance for working with flags / Экземпляр для работы с флагами */
+    protected flag: ComputedRef<GeoFlag>;
     /**
-     * Constructor
-     * @param code country and language code/ код страны и языка
+     * Constructor.
+     *
+     * Конструктор.
+     * @param code country and language code / код страны и языка
      */
-    constructor(code?: RefOrNormal<string>);
+    constructor(code?: RefOrNormal<string | undefined>);
     /**
-     * Obtaining a reactive object with the country code.
+     * Getting the country code.
      *
-     * Получение реактивного объекта с кодом страны.
+     * Получение кода страны.
+     * @returns country code / код страны
      */
-    getCode(): Ref<string>;
+    getCode(): string;
     /**
      * Returns information about the country and its flag.
      *
      * Возвращает информацию о стране и её флаге.
-     * @param code country code/ код страны
+     * @param code country code / код страны
+     * @returns reactive object with country information / реактивный объект с информацией о стране
      */
     get(code?: RefOrNormal<string>): ComputedRef<GeoFlagItem | undefined>;
     /**
      * Getting a link to the flag.
      *
      * Получение ссылки на флаг.
-     * @param code country code/ код страны
+     * @param code country code / код страны
+     * @returns reactive link to the flag / реактивная ссылка на флаг
      */
     getFlag(code?: RefOrNormal<string>): ComputedRef<string | undefined>;
     /**
      * Getting a list of countries by an array of codes.
      *
      * Получение списка стран по массиву с кодами.
-     * @param codes country code/ код страны
+     * @param codes list of country codes / список кодов стран
+     * @returns reactive list of country flag items / реактивный список элементов флагов стран
      */
     getList(codes?: RefOrNormal<string[] | undefined>): ComputedRef<GeoFlagItem[]>;
     /**
      * Getting a list of countries by an array of codes in national language.
      *
-     * Получение списка стран по массиву с кодами на национальный язык.
-     * @param codes country code/ код страны.
+     * Получение списка стран по массиву с кодами на национальном языке.
+     * @param codes list of country codes / список кодов стран
+     * @returns reactive list of country flag items in national language / реактивный список элементов флагов стран на национальном языке
      */
     getNational(codes?: RefOrNormal<string[] | undefined>): ComputedRef<GeoFlagNational[]>;
 }

package/dist/src/functions/ref/executeFunctionRef.d.ts

@@ -0,0 +1,11 @@
+import { RefOrNormalOrFunction } from '../../types/refTypes';
+/**
+ * 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.
+ *
+ * Выполняет функцию, если переданный аргумент является функцией, и распаковывает полученный Vue Ref, если он реактивный.
+ * Если аргумент является Vue Ref или простым значением, распаковывает или возвращает его напрямую.
+ * @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;

package/dist/src/library.d.ts

@@ -45,6 +45,7 @@ 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';

package/dist/src/types/refTypes.d.ts

@@ -14,6 +14,13 @@ export type RefUndefined<T> = RefType<T | undefined>;
  * Объединенный тип, который может быть либо Vue реактивной ссылкой, либо обычным значением
  */
 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/
+ * Объединенный тип, который может быть либо Vue реактивной ссылкой, либо обычным
+ * значением, либо функцией, которая возвращает Vue реактивную ссылку или обычное значение
+ */
+export type RefOrNormalOrFunction<T> = RefOrNormal<T> | (() => RefOrNormal<T>);
 /**
  * Union type for Vue raw children content
  * (strings, numbers, booleans, VNodes, arrays, functions)/

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/functional",
   "private": false,
-  "version": "1.12.1",
+  "version": "1.13.1",
   "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": [
@@ -38,7 +38,7 @@
     "dev": "vite",
     "build": "vue-tsc -b && vite build",
     "preview": "vite preview",
-    "test": "vitest",
+    "test": "NODE_OPTIONS=\"--no-webstorage\" vitest",
     "library": "dxt-library",
     "types": "dxt-types",
     "prepublishOnly": "npm run library && npm run build",
@@ -77,5 +77,6 @@
     "vue": "*"
   },
   "dependencies": {},
-  "sideEffects": false
+  "sideEffects": false,
+  "ui-priority": 200
 }