@dxtmisha/functional-basic 1.2.10 → 1.3.4

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.3.1] - 2026-05-25
+
+### Changed / Improved
+- **Maintenance**: Incremented version to `1.3.1` to align with monorepo release updates.
+
+## [1.3.0] - 2026-05-25
+
+### Added
+- **`getLength`**: Introduced a new `getLength` utility function to determine the length/size of strings, arrays, Maps, Sets, and objects reactively and safely, accompanied by complete bilingual JSDocs.
+- **Tests**: Created a comprehensive unit test suite (`getLength.test.ts`) to validate length computation across all supported data types.
+
+### Changed / Improved
+- **Build System**: Added `ui-priority: 100` attribute to `package.json` to facilitate prioritized build sorting of foundational libraries.
+
+## [1.2.11] - 2026-05-25
+
+### Changed / Improved
+- **Tests**: Configured the vitest runner command to execute with `NODE_OPTIONS="--no-webstorage"` in `package.json` to prevent environment-related web storage warnings.
+
+## [1.2.10] - 2026-05-24
+
+### Added
+- **isTab**: Introduced `isTab` utility function to reliably detect Tab key presses across different browser environments by checking `key`, `code`, and `keyCode`.
+- **isTab**: Added comprehensive unit tests in `src/functions/__tests__/isTab.test.ts` to verify tab-detection behavior under multiple key configurations.
+
+### Changed / Improved
+- **isInput**: Refactored `isInput` helper to correctly return `false` for elements with `readonly` or `disabled` attributes.
+- **getKey**: Updated return type of `getKey` helper function to return `string | number | undefined` instead of forcing a strict `string`.
+- **ErrorCenter**: Enhanced `ErrorCenterCauseItem` type inside `errorCenter.ts` with generic parameter support (`ErrorCenterCauseItem<D = any>`) to support strictly-typed structures for error cause detail records.
+- **Maintenance**: Excluded auto-generated AI description files from package assets, standardized type outputs and version bumped to `1.2.10`.
+
 ## [1.2.5] - 2026-05-17
 
 ### Changed / Improved

package/ai-doc.ru.txt

@@ -1,5 +1,54 @@
-Это базовая функциональная библиотека (@dxtmisha/functional-basic). Здесь собраны алгоритмы, утилиты и классы, независимые от фреймворка.
+Esto базовая функциональная библиотека (@dxtmisha/functional-basic). Здесь собраны алгоритмы, утилиты и классы, независимые от фреймворка.
 
 ВНИМАНИЕ ДЛЯ СРЕДЫ VUE:
 Если вы разрабатываете под Vue, СНАЧАЛА всегда ищите нужный функционал (composables, реактивные классы) в библиотеке `@dxtmisha/functional`.
 И ТОЛЬКО если там нет нужного реактивного/специфичного для Vue аналога, используйте функционал напрямую из этой библиотеки (@dxtmisha/functional-basic).
+
+=============================================================================
+СТРУКТУРА КЛАССОВ И СТАНДАРТЫ КОДА (ПРАВИЛА ДЛЯ AI)
+=============================================================================
+
+Для обеспечения согласованности и высокого промышленного качества кодовой базы dxt-ui, все классы TypeScript внутри `@dxtmisha/functional-basic` должны строго следовать следующим правилам относительно структуры, порядка членов и стилей.
+
+1. ПОРЯДОК ЧЛЕНОВ ВНУТРИ КЛАССА
+Члены каждого класса ДОЛЖНЫ быть упорядочены в следующей последовательности:
+
+   А. Свойства класса / Переменные-члены:
+      - Располагаются в самом верху тела класса.
+      - Сортируются по видимости: сначала Public, затем Protected и в конце Private.
+      - Внутри каждого уровня видимости группируются по смыслу или по алфавиту.
+      - Инициализируйте значения по умолчанию прямо при объявлении, если это возможно.
+
+   Б. Конструктор:
+      - Располагается сразу после объявлений всех свойств.
+      - Разрешено объявление свойств через параметры конструктора (например, `protected url: string`) для упрощения кода.
+
+   В. Публичные методы (Public Methods):
+      - Располагаются после конструктора.
+      - Группируются логически:
+        1. Геттеры, методы проверки состояния и статуса (например, `is*`, `get*`).
+        2. Сеттеры и методы конфигурации (например, `set*`).
+        3. Основные методы выполнения и экшены (например, `request()`, `fetch()`, `show()`).
+
+   Г. Защищенные методы (Protected Methods):
+      - Располагаются после всех публичных методов.
+      - Содержат внутреннюю вспомогательную логику, доступную для наследников класса.
+
+   Д. Приватные методы (Private Methods):
+      - Располагаются в самом конце класса.
+      - Строгая инкапсуляция внутренней логики.
+
+2. СТИЛЬ И СОГЛАШЕНИЯ ПО НАПИСАНИЮ КОДА
+   - Именование:
+     * Классы: PascalCase (например, `LoadingInstance`).
+     * Методы и свойства: camelCase (например, `registrationEvent`, `registrationList`).
+     * Константы внутри файлов: UPPER_SNAKE_CASE (например, `LOADING_EVENT_NAME`).
+   - Безопасность TypeScript:
+     * Никогда не используйте тип `any`. Используйте дженерики или `unknown`, если тип динамический/неопределенный.
+     * Явно указывайте возвращаемые типы для ВСЕХ публичных, защищенных и приватных методов (включая `void`).
+     * Используйте интерфейсы/типы для определения структурных контрактов сложных входящих и исходящих данных.
+   - SSR Изоляция (Server-Side Rendering):
+     * Библиотека должна быть полностью изоморфной и безопасной для SSR.
+     * Избегайте прямого хранения специфичного для запроса состояния в глобальных/статических свойствах классов.
+     * Используйте `ServerStorage.get('key', () => new Instance())` для синглтонов, изолированных в рамках запроса.
+     * Используйте проверку `isDomRuntime()` перед обращением к браузерным API, таким как `window`, `document` или `location`.

package/ai-doc.txt

@@ -1,5 +1,54 @@
 This is the basic functional library (@dxtmisha/functional-basic). It contains framework-agnostic algorithms, utilities, and classes.
 
-ATTENTION FOR VUE ENVIROMENT:
+ATTENTION FOR VUE ENVIRONMENT:
 If you are developing in Vue, ALWAYS look for the required functionality (composables, reactive wrappers) inside the `@dxtmisha/functional` library FIRST.
 And ONLY if there is no reactive or Vue-specific analog there, you may use the functionality directly from this library (@dxtmisha/functional-basic).
+
+=============================================================================
+CLASS STRUCTURE & CODING STANDARDS (RULES FOR AI)
+=============================================================================
+
+To maintain consistency and high industrial quality across the dxt-ui codebase, all TypeScript classes inside `@dxtmisha/functional-basic` must strictly adhere to the following rules regarding structure, member ordering, and styles.
+
+1. ORDER OF MEMBERS WITHIN A CLASS
+Members in every class MUST be ordered in the following sequence:
+
+   A. Class Properties / Member Variables:
+      - Placed at the very top of the class body.
+      - Ordered by visibility: Public first, then Protected, and Private last.
+      - Within each visibility level, group by logical connection or alphabetically.
+      - Initialize default values directly on declaration when possible.
+
+   B. Constructor:
+      - Placed immediately after all property declarations.
+      - Parameter properties (e.g., `protected url: string`) are allowed to simplify declaration.
+
+   C. Public Methods:
+      - Placed after the constructor.
+      - Grouped logically:
+        1. Getters, checkers, and status-check methods (e.g., `is*`, `get*`).
+        2. Setters and configuration methods (e.g., `set*`).
+        3. Core executors and action methods (e.g., `request()`, `fetch()`, `show()`).
+
+   D. Protected Methods:
+      - Placed after all public methods.
+      - Contain internal utility and helper logic accessible to subclasses.
+
+   E. Private Methods:
+      - Placed at the very end of the class.
+      - Strict encapsulation of internal logic.
+
+2. CODING & STYLE CONVENTIONS
+   - Naming:
+     * Classes: PascalCase (e.g., `LoadingInstance`).
+     * Methods & Properties: camelCase (e.g., `registrationEvent`, `registrationList`).
+     * Constants inside files: UPPER_SNAKE_CASE (e.g., `LOADING_EVENT_NAME`).
+   - TypeScript Safety:
+     * Never use `any`. Use generic parameters or `unknown` if the type is dynamic/undefined.
+     * Explicitly declare return types for ALL public, protected, and private methods (including `void`).
+     * Use interfaces/types to define structural contracts for complex inputs and outputs.
+   - SSR Isolation (Server-Side Rendering):
+     * The library must be fully isomorphic and safe for SSR.
+     * Avoid storing request-specific state in global/static class properties directly.
+     * Use `ServerStorage.get('key', () => new Instance())` for request-isolated singletons.
+     * Use `isDomRuntime()` checks before accessing browser-only APIs like `window`, `document`, or `location`.

package/dist/library.js

@@ -1245,7 +1245,8 @@ var Oe = class {
 	get(e, t = "application/json;charset=UTF-8") {
 		if (e === null) return;
 		let r = { ...S(this.headers) };
-		return n(e) && Object.assign(r, e), l(t) && (r["Content-Type"] = t), r;
+		if (n(e)) for (let t in e) r[t.toLowerCase()] = e[t];
+		return l(t) && (r["content-type"] = t), r;
 	}
 	getByRequest(e, t, n = "application/json;charset=UTF-8") {
 		return e instanceof FormData ? this.get(t, null) : this.get(t, n);
@@ -2645,7 +2646,7 @@ var H = /* @__PURE__ */ function(e) {
 	constructor(e = O.getLocation()) {
 		w(this, "code", void 0), this.code = e;
 	}
-	get(t = this.code) {
+	get(t = this.getCode()) {
 		let n = O.find(t);
 		if (n) {
 			var r;
@@ -2656,19 +2657,24 @@ var H = /* @__PURE__ */ function(e) {
 				standard: n.standard,
 				icon: (r = e.flags) == null ? void 0 : r[n.country],
 				label: t,
-				value: n.country
+				value: n.country,
+				phoneCode: n.phoneCode
 			};
 		}
 	}
-	getFlag(e = this.code) {
+	getCode() {
+		return this.code || O.getLocation();
+	}
+	getFlag(e = this.getCode()) {
 		var t;
 		return (t = this.get(e)) == null ? void 0 : t.icon;
 	}
-	getList(e) {
-		return r(this.getCodes(e), (e) => this.get(e));
+	getList(e, t = !0) {
+		let n = r(this.getCodes(e), (e) => this.get(e));
+		return t ? new R().sort(n, (e, t) => [e.label, t.label]) : n;
 	}
-	getNational(t) {
-		return r(this.getList(t), (t) => {
+	getNational(t, n = !0) {
+		let i = r(this.getList(t, !1), (t) => {
 			let n = new e(t.standard).get(t.standard);
 			return {
 				...t,
@@ -2677,6 +2683,7 @@ var H = /* @__PURE__ */ function(e) {
 				nationalCountry: n == null ? void 0 : n.country
 			};
 		});
+		return n ? new R().sort(i, (e, t) => [e.label, t.label]) : i;
 	}
 	setCode(e) {
 		return this.code = e, this;
@@ -4363,8 +4370,13 @@ function En(e) {
 	return (t = (n = e == null ? void 0 : e.key) == null ? e == null ? void 0 : e.code : n) == null ? e == null || (r = e.keyCode) == null ? void 0 : r.toString() : t;
 }
 //#endregion
-//#region src/functions/getLengthOfAllArray.ts
+//#region src/functions/getLength.ts
 function Dn(e) {
+	return e == null ? 0 : typeof e == "string" || Array.isArray(e) ? e.length : e instanceof Map || e instanceof Set ? e.size : t(e) ? Object.keys(e).length : 0;
+}
+//#endregion
+//#region src/functions/getLengthOfAllArray.ts
+function On(e) {
 	return r(e, (e) => {
 		var t;
 		return (t = e == null ? void 0 : e.length) == null ? 0 : t;
@@ -4372,41 +4384,41 @@ function Dn(e) {
 }
 //#endregion
 //#region src/functions/getMaxLengthAllArray.ts
-function On(e) {
+function kn(e) {
 	if (!l(e)) return 0;
-	let t = Dn(e);
+	let t = On(e);
 	return t.length > 1e4 ? t.reduce((e, t) => Math.max(e, t)) : Math.max(...t);
 }
 //#endregion
 //#region src/functions/getMinLengthAllArray.ts
-function kn(e) {
+function An(e) {
 	if (!l(e)) return 0;
-	let t = Dn(e);
+	let t = On(e);
 	return t.length > 1e4 ? t.reduce((e, t) => Math.min(e, t)) : Math.min(...t);
 }
 //#endregion
 //#region src/functions/getMouseClientX.ts
-function An(e) {
+function jn(e) {
 	var t, n;
 	return (e == null ? void 0 : e.clientX) || (e == null || (t = e.targetTouches) == null || (t = t[0]) == null ? void 0 : t.clientX) || (e == null || (n = e.touches) == null || (n = n[0]) == null ? void 0 : n.clientX) || 0;
 }
 //#endregion
 //#region src/functions/getMouseClientY.ts
-function jn(e) {
+function Mn(e) {
 	var t, n;
 	return (e == null ? void 0 : e.clientY) || (e == null || (t = e.targetTouches) == null || (t = t[0]) == null ? void 0 : t.clientY) || (e == null || (n = e.touches) == null || (n = n[0]) == null ? void 0 : n.clientY) || 0;
 }
 //#endregion
 //#region src/functions/getMouseClient.ts
-function Mn(e) {
+function Nn(e) {
 	return {
-		x: An(e),
-		y: jn(e)
+		x: jn(e),
+		y: Mn(e)
 	};
 }
 //#endregion
 //#region src/functions/getObjectByKeys.ts
-function Nn(e, t) {
+function Pn(e, t) {
 	let r = {};
 	return n(e) && t.forEach((t) => {
 		t in e && e[t] !== void 0 && (r[t] = e[t]);
@@ -4414,7 +4426,7 @@ function Nn(e, t) {
 }
 //#endregion
 //#region src/functions/getObjectNoUndefined.ts
-function Pn(e, t = void 0) {
+function Fn(e, t = void 0) {
 	let n = {};
 	return r(e, (e, r) => {
 		e !== t && (n[r] = e);
@@ -4422,42 +4434,42 @@ function Pn(e, t = void 0) {
 }
 //#endregion
 //#region src/functions/getObjectOrNone.ts
-function Fn(e) {
+function In(e) {
 	return n(e) ? e : {};
 }
 //#endregion
 //#region src/functions/getOnlyText.ts
-function In(e) {
+function Ln(e) {
 	return F(e).replace(/[^\p{L}\p{N}\s]+/gu, "").trim();
 }
 //#endregion
 //#region src/functions/strFill.ts
-function Ln(e, t) {
+function Rn(e, t) {
 	return String(e).repeat(t);
 }
 //#endregion
 //#region src/functions/getRandomText.ts
-function Rn(e, t, n = "#", r = 2, i = 12) {
+function zn(e, t, n = "#", r = 2, i = 12) {
 	let a = f(e, t), o = [];
-	for (let e = 0; e < a; e++) o.push(Ln(n, f(r, i)));
+	for (let e = 0; e < a; e++) o.push(Rn(n, f(r, i)));
 	return o.join(" ");
 }
 //#endregion
 //#region src/functions/getStepPercent.ts
-function zn(e, t) {
+function Bn(e, t) {
 	let n = e == null ? 0 : e;
 	return t > n ? 100 / (t - n) : 0;
 }
 //#endregion
 //#region src/functions/getStepValue.ts
-function Bn(e, t) {
+function Vn(e, t) {
 	let n = e == null ? 0 : e;
 	return t > n ? (t - n) / 100 : 0;
 }
 //#endregion
 //#region src/functions/goScroll.ts
-var Vn = 0;
-function Hn(e, t, n) {
+var Hn = 0;
+function Un(e, t, n) {
 	if (!s()) return;
 	let r = t == null ? void 0 : t.closest(e);
 	if (t && r && r.scrollHeight !== r.offsetHeight) {
@@ -4465,12 +4477,12 @@ function Hn(e, t, n) {
 		if (n) {
 			let a = n.getBoundingClientRect();
 			r.scrollTop = t.offsetTop - (a.top - e.top) - (a.height / 2 - i.height / 2), r.scrollTop + r.offsetHeight < t.offsetTop + t.offsetHeight && (r.scrollTop = t.offsetTop + t.offsetHeight - r.offsetHeight);
-		} else r.scrollTop > t.offsetTop ? r.scrollTop = i.top - e.top - Vn : r.scrollTop + r.offsetHeight < t.offsetTop + t.offsetHeight && (r.scrollTop = i.top - e.top + i.height - e.height + Vn);
+		} else r.scrollTop > t.offsetTop ? r.scrollTop = i.top - e.top - Hn : r.scrollTop + r.offsetHeight < t.offsetTop + t.offsetHeight && (r.scrollTop = i.top - e.top + i.height - e.height + Hn);
 	}
 }
 //#endregion
 //#region src/functions/goScrollSmooth.ts
-function Un(e, t, n = 0) {
+function Wn(e, t, n = 0) {
 	if (!s()) return;
 	let r = (t == null ? void 0 : t.behavior) || "smooth";
 	if ("scrollIntoView" in e && !n) {
@@ -4492,7 +4504,7 @@ function Un(e, t, n = 0) {
 }
 //#endregion
 //#region src/functions/goScrollTo.ts
-function Wn(e, t, n = "smooth") {
+function Gn(e, t, n = "smooth") {
 	if (!s() || !e || !t) return;
 	let r = e.getBoundingClientRect(), i = t.getBoundingClientRect();
 	e.scrollBy({
@@ -4503,13 +4515,13 @@ function Wn(e, t, n = "smooth") {
 }
 //#endregion
 //#region src/functions/isShare.ts
-function Gn() {
+function Kn() {
 	return s() && typeof navigator < "u" && !!navigator.share;
 }
 //#endregion
 //#region src/functions/handleShare.ts
-async function Kn(e) {
-	if (Gn() && navigator.canShare && navigator.canShare(e)) try {
+async function qn(e) {
+	if (Kn() && navigator.canShare && navigator.canShare(e)) try {
 		return await navigator.share(e), !0;
 	} catch (e) {
 		T.on({
@@ -4522,12 +4534,12 @@ async function Kn(e) {
 }
 //#endregion
 //#region src/functions/inArray.ts
-function qn(e, t) {
+function Jn(e, t) {
 	return e.includes(t);
 }
 //#endregion
 //#region src/functions/initScrollbarOffset.ts
-async function Jn() {
+async function Yn() {
 	if (s()) {
 		let e = await At.get();
 		document.body.style.setProperty("--sys-scrollbar-offset", `${e}px`);
@@ -4535,7 +4547,7 @@ async function Jn() {
 }
 //#endregion
 //#region src/functions/intersectKey.ts
-function Yn(e, n) {
+function Xn(e, n) {
 	let i = {};
 	return t(e) && t(n) && r(e, (e, t) => {
 		t in n && (i[t] = e);
@@ -4543,7 +4555,7 @@ function Yn(e, n) {
 }
 //#endregion
 //#region src/functions/isDifferent.ts
-function Xn(e, t) {
+function Zn(e, t) {
 	let n = Object.keys(e).length !== Object.keys(t).length;
 	return n || r(e, (e, r) => {
 		e !== (t == null ? void 0 : t[r]) && (n = !0);
@@ -4551,7 +4563,7 @@ function Xn(e, t) {
 }
 //#endregion
 //#region src/functions/isElementVisible.ts
-function Zn(e) {
+function Qn(e) {
 	if (!s()) return !1;
 	let t = k(e);
 	if (!t || "isConnected" in t && t.isConnected === !1) return !1;
@@ -4560,16 +4572,16 @@ function Zn(e) {
 }
 //#endregion
 //#region src/functions/isInput.ts
-var Qn = (e) => {
+var $n = (e) => {
 	if (e instanceof HTMLElement) {
 		let t = e.tagName.toLowerCase();
 		return !!(t === "input" || t === "textarea" || t === "select" || e.isContentEditable || e.getAttribute("contenteditable") === "true") && !(e != null && e.readOnly) && !(e != null && e.disabled);
 	}
 	return !1;
-}, $n = (e, t) => e.code === "Space" || e.code === "Enter" || e.key === " " || e.key === "Spacebar" || e.key === "Enter" || e.keyCode === 13 || e.keyCode === 32 ? t === void 0 ? !Qn(e.target) : !t : !1;
+}, er = (e, t) => e.code === "Space" || e.code === "Enter" || e.key === " " || e.key === "Spacebar" || e.key === "Enter" || e.keyCode === 13 || e.keyCode === 32 ? t === void 0 ? !$n(e.target) : !t : !1;
 //#endregion
 //#region src/functions/isFloat.ts
-function er(e) {
+function tr(e) {
 	switch (typeof e) {
 		case "number": return !0;
 		case "string": return /^-?\d+(\.\d+)?$/.test(e);
@@ -4578,21 +4590,21 @@ function er(e) {
 }
 //#endregion
 //#region src/functions/isIntegerBetween.ts
-function tr(e, t) {
+function nr(e, t) {
 	let n = Math.floor(t);
 	return e >= n && e < n + 1;
 }
 //#endregion
 //#region src/functions/isSelectedByList.ts
-function nr(e, t) {
+function rr(e, t) {
 	return Array.isArray(e) ? e.every((e) => b(e, t)) : b(e, t);
 }
 //#endregion
 //#region src/functions/isTab.ts
-var rr = (e) => e.key === "Tab" || e.code === "Tab" || e.keyCode === 9;
+var ir = (e) => e.key === "Tab" || e.code === "Tab" || e.keyCode === 9;
 //#endregion
 //#region src/functions/removeCommonPrefix.ts
-function ir(e, t) {
+function ar(e, t) {
 	if (e.startsWith(t)) return e.slice(t.length).trim();
 	let n = 0;
 	for (; e[n] === t[n] && n < e.length && n < t.length;) n++;
@@ -4600,13 +4612,13 @@ function ir(e, t) {
 }
 //#endregion
 //#region src/functions/replaceComponentName.ts
-var ar = (e, t, n) => {
+var or = (e, t, n) => {
 	var r;
 	return e == null || (r = e.replace(RegExp(`<${t}`, "ig"), `<${n}`)) == null || (r = r.replace(RegExp(`</${t}`, "ig"), `</${n}`)) == null ? void 0 : r.trim();
 };
 //#endregion
 //#region src/functions/uniqueArray.ts
-function or(e) {
+function sr(e) {
 	return [...new Set(e)];
 }
 //#endregion
@@ -4615,12 +4627,12 @@ function $(e, n, i = !0) {
 	let a = Z(e);
 	return t(e) && t(n) && r(n, (n, r) => {
 		let o = e == null ? void 0 : e[r];
-		t(o) && t(n) ? i && Array.isArray(o) && Array.isArray(n) ? a[r] = Z(or([...o, ...n])) : a[r] = $(Array.isArray(o) ? { ...o } : o, n, i) : a[r] = t(n) ? Z(n) : n;
+		t(o) && t(n) ? i && Array.isArray(o) && Array.isArray(n) ? a[r] = Z(sr([...o, ...n])) : a[r] = $(Array.isArray(o) ? { ...o } : o, n, i) : a[r] = t(n) ? Z(n) : n;
 	}), a;
 }
 //#endregion
 //#region src/functions/replaceTemplate.ts
-function sr(e, t) {
+function cr(e, t) {
 	let n = e;
 	return r(t, (e, t) => {
 		n = n.replace(Lt(`[${t}]`), S(e));
@@ -4628,7 +4640,7 @@ function sr(e, t) {
 }
 //#endregion
 //#region src/functions/secondToTime.ts
-function cr(e, t) {
+function lr(e, t) {
 	let n = y(e);
 	if (n > 0) {
 		let e = String(Math.floor(n / 60)).padStart(2, "0"), r = String(n % 60).padStart(2, "0");
@@ -4638,7 +4650,7 @@ function cr(e, t) {
 }
 //#endregion
 //#region src/functions/setValues.ts
-function lr(e, t, { multiple: n = !1, maxlength: r = 0, alwaysChange: a = !0, notEmpty: o = !1 }) {
+function ur(e, t, { multiple: n = !1, maxlength: r = 0, alwaysChange: a = !0, notEmpty: o = !1 }) {
 	if (n) {
 		if (i(e)) {
 			let n = e.indexOf(t), i = [...e];
@@ -4650,7 +4662,7 @@ function lr(e, t, { multiple: n = !1, maxlength: r = 0, alwaysChange: a = !0, no
 }
 //#endregion
 //#region src/functions/splice.ts
-function ur(e, n, i) {
+function dr(e, n, i) {
 	if (t(e) && t(n)) {
 		if (i) {
 			let a = {}, o = !1;
@@ -4664,34 +4676,34 @@ function ur(e, n, i) {
 }
 //#endregion
 //#region src/functions/toCamelCaseFirst.ts
-function dr(e) {
+function fr(e) {
 	return it(e).replace(/^([a-z])/, (e) => `${e.toUpperCase()}`);
 }
 //#endregion
 //#region src/functions/toKebabCase.ts
-function fr(e) {
+function pr(e) {
 	return e.toString().trim().replace(/[^\w-. ]+/g, "").replace(/[ .]+/g, "-").replace(/(?<=[A-Z])([A-Z])/g, (e) => `${e.toLowerCase()}`).replace(/^[A-Z]/, (e) => e.toLowerCase()).replace(/(?<=[\w ])[A-Z]/g, (e) => `-${e.toLowerCase()}`).replace(/[A-Z]/g, (e) => e.toLowerCase());
 }
 //#endregion
 //#region src/functions/toNumberByMax.ts
-function pr(e, t, n, r) {
+function mr(e, t, n, r) {
 	let i = y(e), a = y(t);
-	return t && a < i ? `${mr(a, n, r)}+` : mr(i, n, r);
+	return t && a < i ? `${hr(a, n, r)}+` : hr(i, n, r);
 }
-var mr = (e, t, n) => t ? new R(n).number(e) : e;
+var hr = (e, t, n) => t ? new R(n).number(e) : e;
 //#endregion
 //#region src/functions/toPercent.ts
-function hr(e, t) {
+function gr(e, t) {
 	return e === 0 ? t : 1 / e * t;
 }
 //#endregion
 //#region src/functions/toPercentBy100.ts
-function gr(e, t) {
-	return hr(e, t) * 100;
+function _r(e, t) {
+	return gr(e, t) * 100;
 }
 //#endregion
 //#region src/functions/uint8ArrayToBase64.ts
-function _r(e) {
+function vr(e) {
 	let t = "";
 	for (let n of e) t += String.fromCharCode(n);
 	if (s()) return window.btoa(t);
@@ -4703,7 +4715,7 @@ function _r(e) {
 }
 //#endregion
 //#region src/functions/writeClipboardData.ts
-async function vr(e) {
+async function yr(e) {
 	if (s()) try {
 		await navigator.clipboard.writeText(e);
 	} catch (n) {
@@ -4712,4 +4724,4 @@ async function vr(e) {
 	}
 }
 //#endregion
-export { P as Api, M as ApiCache, Ae as ApiDataReturn, je as ApiDefault, Pe as ApiError, Me as ApiErrorItem, Ne as ApiErrorStorage, Fe as ApiHeaders, Le as ApiHydration, He as ApiInstance, N as ApiMethodItem, Re as ApiPreparation, Ve as ApiResponse, Oe as ApiStatus, Ue as BroadcastMessage, Ke as Cache, Ge as CacheItem, qe as CacheStatic, tt as Cookie, Qe as CookieBlock, Ze as CookieBlockInstance, I as CookieStorage, D as DataStorage, rt as Datetime, T as ErrorCenter, le as ErrorCenterHandler, ue as ErrorCenterInstance, Ce as EventItem, at as Formatters, H as FormattersType, ot as GEO_FLAG_ICON_NAME, O as Geo, st as GeoFlag, ye as GeoInstance, R as GeoIntl, ct as GeoPhone, lt as Global, dt as Hash, ut as HashInstance, mt as Icons, j as Loading, Te as LoadingInstance, Dt as Meta, G as MetaManager, Tt as MetaOg, St as MetaOpenGraphAge, bt as MetaOpenGraphAvailability, xt as MetaOpenGraphCondition, Ct as MetaOpenGraphGender, q as MetaOpenGraphTag, yt as MetaOpenGraphType, vt as MetaRobots, Ot as MetaStatic, K as MetaTag, Et as MetaTwitter, wt as MetaTwitterCard, J as MetaTwitterTag, kt as ResumableTimer, At as ScrollbarWidth, Ht as SearchList, Ft as SearchListData, It as SearchListItem, Bt as SearchListMatcher, Vt as SearchListOptions, E as ServerStorage, Wt as StorageCallback, Yt as TRANSLATE_GLOBAL_PREFIX, Xt as TRANSLATE_TIME_OUT, $t as Translate, Zt as TranslateFile, Qt as TranslateInstance, Pt as addTagHighlightMatch, F as anyToString, qt as applyTemplate, en as arrFill, on as blobToBase64, sn as capitalize, Z as copyObject, cn as copyObjectLite, U as createElement, ln as domQuerySelector, un as domQuerySelectorAll, W as encodeAttribute, ae as encodeLiteAttribute, mn as ensureMaxSize, Y as escapeExp, hn as eventStopPropagation, S as executeFunction, ze as executePromise, r as forEach, gn as frame, _n as getArrayHighlightMatch, vn as getAttributes, yn as getClipboardData, nt as getColumn, bn as getCurrentDate, xn as getCurrentTime, k as getElement, Cn as getElementId, dn as getElementImage, ht as getElementItem, xe as getElementOrWindow, fe as getElementSafeScript, Rt as getExactSearchExp, Lt as getExp, Tn as getFirst, pe as getHydrationData, V as getItemByPath, En as getKey, Dn as getLengthOfAllArray, On as getMaxLengthAllArray, kn as getMinLengthAllArray, Mn as getMouseClient, An as getMouseClientX, jn as getMouseClientY, Nn as getObjectByKeys, Pn as getObjectNoUndefined, Fn as getObjectOrNone, In as getOnlyText, Rn as getRandomText, o as getRequestString, zt as getSearchExp, jt as getSeparatingSearchExp, zn as getStepPercent, Bn as getStepValue, Hn as goScroll, Un as goScrollSmooth, Wn as goScrollTo, Kn as handleShare, qn as inArray, wn as initGetElementId, Jn as initScrollbarOffset, Yn as intersectKey, Jt as isApiSuccess, i as isArray, Xn as isDifferent, oe as isDomData, s as isDomRuntime, Zn as isElementVisible, $n as isEnter, l as isFilled, er as isFloat, x as isFunction, Se as isInDom, Qn as isInput, tr as isIntegerBetween, c as isNull, p as isNumber, t as isObject, n as isObjectNotArray, u as isOnLine, b as isSelected, nr as isSelectedByList, Gn as isShare, d as isString, rr as isTab, be as isWindow, f as random, ir as removeCommonPrefix, ar as replaceComponentName, $ as replaceRecursive, sr as replaceTemplate, pn as resizeImageByMax, cr as secondToTime, gt as setElementItem, lr as setValues, ee as sleep, ur as splice, Ln as strFill, Je as strSplit, A as toArray, it as toCamelCase, dr as toCamelCaseFirst, L as toDate, fr as toKebabCase, y as toNumber, pr as toNumberByMax, hr as toPercent, gr as toPercentBy100, a as toString, Ye as transformation, _r as uint8ArrayToBase64, or as uniqueArray, vr as writeClipboardData };
+export { P as Api, M as ApiCache, Ae as ApiDataReturn, je as ApiDefault, Pe as ApiError, Me as ApiErrorItem, Ne as ApiErrorStorage, Fe as ApiHeaders, Le as ApiHydration, He as ApiInstance, N as ApiMethodItem, Re as ApiPreparation, Ve as ApiResponse, Oe as ApiStatus, Ue as BroadcastMessage, Ke as Cache, Ge as CacheItem, qe as CacheStatic, tt as Cookie, Qe as CookieBlock, Ze as CookieBlockInstance, I as CookieStorage, D as DataStorage, rt as Datetime, T as ErrorCenter, le as ErrorCenterHandler, ue as ErrorCenterInstance, Ce as EventItem, at as Formatters, H as FormattersType, ot as GEO_FLAG_ICON_NAME, O as Geo, st as GeoFlag, ye as GeoInstance, R as GeoIntl, ct as GeoPhone, lt as Global, dt as Hash, ut as HashInstance, mt as Icons, j as Loading, Te as LoadingInstance, Dt as Meta, G as MetaManager, Tt as MetaOg, St as MetaOpenGraphAge, bt as MetaOpenGraphAvailability, xt as MetaOpenGraphCondition, Ct as MetaOpenGraphGender, q as MetaOpenGraphTag, yt as MetaOpenGraphType, vt as MetaRobots, Ot as MetaStatic, K as MetaTag, Et as MetaTwitter, wt as MetaTwitterCard, J as MetaTwitterTag, kt as ResumableTimer, At as ScrollbarWidth, Ht as SearchList, Ft as SearchListData, It as SearchListItem, Bt as SearchListMatcher, Vt as SearchListOptions, E as ServerStorage, Wt as StorageCallback, Yt as TRANSLATE_GLOBAL_PREFIX, Xt as TRANSLATE_TIME_OUT, $t as Translate, Zt as TranslateFile, Qt as TranslateInstance, Pt as addTagHighlightMatch, F as anyToString, qt as applyTemplate, en as arrFill, on as blobToBase64, sn as capitalize, Z as copyObject, cn as copyObjectLite, U as createElement, ln as domQuerySelector, un as domQuerySelectorAll, W as encodeAttribute, ae as encodeLiteAttribute, mn as ensureMaxSize, Y as escapeExp, hn as eventStopPropagation, S as executeFunction, ze as executePromise, r as forEach, gn as frame, _n as getArrayHighlightMatch, vn as getAttributes, yn as getClipboardData, nt as getColumn, bn as getCurrentDate, xn as getCurrentTime, k as getElement, Cn as getElementId, dn as getElementImage, ht as getElementItem, xe as getElementOrWindow, fe as getElementSafeScript, Rt as getExactSearchExp, Lt as getExp, Tn as getFirst, pe as getHydrationData, V as getItemByPath, En as getKey, Dn as getLength, On as getLengthOfAllArray, kn as getMaxLengthAllArray, An as getMinLengthAllArray, Nn as getMouseClient, jn as getMouseClientX, Mn as getMouseClientY, Pn as getObjectByKeys, Fn as getObjectNoUndefined, In as getObjectOrNone, Ln as getOnlyText, zn as getRandomText, o as getRequestString, zt as getSearchExp, jt as getSeparatingSearchExp, Bn as getStepPercent, Vn as getStepValue, Un as goScroll, Wn as goScrollSmooth, Gn as goScrollTo, qn as handleShare, Jn as inArray, wn as initGetElementId, Yn as initScrollbarOffset, Xn as intersectKey, Jt as isApiSuccess, i as isArray, Zn as isDifferent, oe as isDomData, s as isDomRuntime, Qn as isElementVisible, er as isEnter, l as isFilled, tr as isFloat, x as isFunction, Se as isInDom, $n as isInput, nr as isIntegerBetween, c as isNull, p as isNumber, t as isObject, n as isObjectNotArray, u as isOnLine, b as isSelected, rr as isSelectedByList, Kn as isShare, d as isString, ir as isTab, be as isWindow, f as random, ar as removeCommonPrefix, or as replaceComponentName, $ as replaceRecursive, cr as replaceTemplate, pn as resizeImageByMax, lr as secondToTime, gt as setElementItem, ur as setValues, ee as sleep, dr as splice, Rn as strFill, Je as strSplit, A as toArray, it as toCamelCase, fr as toCamelCaseFirst, L as toDate, pr as toKebabCase, y as toNumber, mr as toNumberByMax, gr as toPercent, _r as toPercentBy100, a as toString, Ye as transformation, vr as uint8ArrayToBase64, sr as uniqueArray, yr as writeClipboardData };

package/dist/src/classes/GeoFlag.d.ts

@@ -30,6 +30,13 @@ export declare class GeoFlag {
      * @returns country information / информация о стране
      */
     get(code?: string): GeoFlagItem | undefined;
+    /**
+     * Returns the country code.
+     *
+     * Возвращает код страны.
+     * @returns country code / код страны
+     */
+    getCode(): string;
     /**
      * Returns the identifier of the flag icon.
      *
@@ -45,17 +52,19 @@ export declare class GeoFlag {
      * Возвращает список стран на основе предоставленных кодов.
      * Если коды не переданы, возвращает все доступные страны.
      * @param codes array of country codes / массив кодов стран
+     * @param sort whether to sort the list / сортировать ли список
      * @returns list of countries / список стран
      */
-    getList(codes?: string[]): GeoFlagItem[];
+    getList(codes?: string[], sort?: boolean): GeoFlagItem[];
     /**
      * Returns a list of countries in their national languages.
      *
      * Возвращает список стран на их национальных языках.
      * @param codes array of country codes / массив кодов стран
+     * @param sort whether to sort the list / сортировать ли список
      * @returns list of countries with national names / список стран с национальными названиями
      */
-    getNational(codes?: string[]): GeoFlagNational[];
+    getNational(codes?: string[], sort?: boolean): GeoFlagNational[];
     /**
      * Changes the current locale/location.
      *

package/dist/src/functions/getLength.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns the length or size of various data types including Arrays, Objects, Maps, Sets, and Strings.
+ * If the value is null, undefined, or an unsupported type (e.g. number, boolean), it returns 0.
+ *
+ * Возвращает длину или размер различных типов данных, включая массивы, объекты, Map, Set и строки.
+ * Если значение равно null, undefined или имеет неподдерживаемый тип (например, число, булево), возвращает 0.
+ * @param value input value to measure / входное значение для измерения
+ * @returns the length or size of the value / длина или размер значения
+ */
+export declare function getLength(value: any): number;

package/dist/src/library.d.ts

@@ -92,6 +92,7 @@ export * from './functions/getFirst';
 export * from './functions/getHydrationData';
 export * from './functions/getItemByPath';
 export * from './functions/getKey';
+export * from './functions/getLength';
 export * from './functions/getLengthOfAllArray';
 export * from './functions/getMaxLengthAllArray';
 export * from './functions/getMinLengthAllArray';

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

@@ -53,6 +53,8 @@ export interface GeoFlagItem {
     label: string;
     /** Value for selection/ Значение для выбора */
     value: string;
+    /** Phone country code/ Телефонный код страны */
+    phoneCode?: string;
 }
 /**
  * Extended geographic flag item with national language information/

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/functional-basic",
   "private": false,
-  "version": "1.2.10",
+  "version": "1.3.4",
   "type": "module",
   "description": "Foundational utility library for modern web development — HTTP client, geolocation, i18n, SEO meta tags, caching, storage, DOM utilities, and more. Framework-agnostic, zero dependencies, TypeScript-first.",
   "keywords": [
@@ -51,7 +51,7 @@
     "dev": "vite",
     "build": "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",
@@ -83,5 +83,6 @@
   "peerDependencies": {
     "@dxtmisha/media": "*"
   },
-  "sideEffects": false
+  "sideEffects": false,
+  "ui-priority": 100
 }