@dxtmisha/functional-basic 1.3.12 → 1.3.15

package/dist/library.js

@@ -225,7 +225,11 @@ var le = class {
 		return n && n.handlers.forEach((t) => t(e)), this.toConsole(e), this;
 	}
 	toConsole(e) {
-		return console.error(`Error Center: ${e.code}`), console.error("Error Center/message: ", e.message), console.error("Error Center/details", e.details), s() || console.trace("Error Center: trace"), this;
+		if (console.error(`Error Center: ${e.code}`), console.error("Error Center/message: ", e.message), console.error("Error Center/details: ", e.details), !s()) {
+			let e = (/* @__PURE__ */ Error()).stack;
+			console.error("Error Center/trace: ", e);
+		}
+		return this;
 	}
 }, ue = class {
 	constructor(e, t = new le()) {
@@ -793,12 +797,14 @@ var Te = () => E.get("__ui:cookie-items__", () => ({})), Ee = class e {
 	getLocation() {
 		return this.location;
 	}
+	getLocationCountry() {
+		return this.toCountry(this.getLocation());
+	}
+	getLocationLanguage() {
+		return this.toLanguage(this.getLocation());
+	}
 	getItem() {
-		return {
-			...this.item,
-			language: this.language,
-			standard: `${this.language}-${this.item.country}`
-		};
+		return this.item;
 	}
 	getList() {
 		return e;
@@ -806,7 +812,7 @@ var Te = () => E.get("__ui:cookie-items__", () => ({})), Ee = class e {
 	getByCode(e) {
 		var t;
 		let n;
-		return e && (/([A-Z]{2}-[a-z]{2})|([a-z]{2}-[A-Z]{2})/.test(e) && (n = this.getByCodeFull(e)), !n && /[a-z]{2}/.test(e) && (n = this.getByLanguage(this.toLanguage(e))), !n && /[A-Z]{2}/.test(e) && (n = this.getByCountry(this.toCountry(e)))), this.toFull((t = n) == null ? this.getList()[0] : t);
+		return e && (/([A-Z]{2}-[a-z]{2})|([a-z]{2}-[A-Z]{2})/.test(e) && (n = this.getByCodeFull(e)), !n && /[A-Z]{2}/.test(e) && (n = this.getByCountry(this.toCountry(e))), !n && /[a-z]{2}/.test(e) && (n = this.getByLanguage(this.toLanguage(e)))), this.toFull((t = n) == null ? this.getList()[0] : t, e);
 	}
 	getByCodeFull(e) {
 		return this.getList().find((t) => x(e, [`${t.language}-${t.country}`, `${t.country}-${t.language}`]));
@@ -833,7 +839,12 @@ var Te = () => E.get("__ui:cookie-items__", () => ({})), Ee = class e {
 	find(e) {
 		return this.getByCode(e);
 	}
-	toStandard(e) {
+	toStandard(e, t) {
+		if (t) {
+			var n;
+			let r = (n = this.getByLanguage(t)) == null ? void 0 : n.language;
+			if (r) return `${r}-${e.country}`;
+		}
 		return `${e.language}-${e.country}`;
 	}
 	set(e, t) {
@@ -849,7 +860,7 @@ var Te = () => E.get("__ui:cookie-items__", () => ({})), Ee = class e {
 		return Ee.getInstance(De);
 	}
 	findLocation() {
-		return this.findLocationDom() || this.getCookie().get() || m(this.valueDefault) || "en-GB";
+		return this.getCookie().get() || this.findLocationDom() || m(this.valueDefault) || "en-GB";
 	}
 	findLocationDom() {
 		var e;
@@ -864,11 +875,15 @@ var Te = () => E.get("__ui:cookie-items__", () => ({})), Ee = class e {
 	toLanguage(e) {
 		return e.replace(/[^a-z]+/g, "");
 	}
-	toFull(e) {
+	toFull(e, t) {
+		let n = t && this.toLanguage(t) || e.language, r = this.toStandard(e, n);
 		return {
 			...e,
-			standard: this.toStandard(e),
-			firstDay: (e == null ? void 0 : e.firstDay) || "Mo"
+			standard: r,
+			firstDay: (e == null ? void 0 : e.firstDay) || "Mo",
+			location: t == null ? r : t,
+			locationCountry: t && this.toCountry(t) || e.country,
+			locationLanguage: n
 		};
 	}
 }, k = class {
@@ -893,6 +908,12 @@ var Te = () => E.get("__ui:cookie-items__", () => ({})), Ee = class e {
 	static getLocation() {
 		return this.getObject().getLocation();
 	}
+	static getLocationCountry() {
+		return this.getObject().getLocationCountry();
+	}
+	static getLocationLanguage() {
+		return this.getObject().getLocationLanguage();
+	}
 	static getItem() {
 		return this.getObject().getItem();
 	}

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

@@ -57,6 +57,20 @@ export declare class Geo {
      * @returns location string / строка местоположения
      */
     static getLocation(): string;
+    /**
+     * Returns the country code extracted from the location string.
+     *
+     * Возвращает код страны, извлеченный из строки местоположения.
+     * @returns country code / код страны
+     */
+    static getLocationCountry(): string;
+    /**
+     * Returns the language code extracted from the location string.
+     *
+     * Возвращает код языка, извлеченный из строки местоположения.
+     * @returns language code / код языка
+     */
+    static getLocationLanguage(): string;
     /**
      * Returns fully processed geo data updated with the current language.
      *

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

@@ -92,6 +92,20 @@ export declare class GeoInstance {
      * @returns location string / строка местоположения
      */
     getLocation(): string;
+    /**
+     * Getting the country code from the location.
+     *
+     * Получение кода страны из местоположения.
+     * @returns country code / код страны
+     */
+    getLocationCountry(): string;
+    /**
+     * Getting the language code from the location.
+     *
+     * Получение кода языка из местоположения.
+     * @returns language code / код языка
+     */
+    getLocationLanguage(): string;
     /**
      * Getting processed data including the current language.
      *
@@ -167,7 +181,7 @@ export declare class GeoInstance {
      * @param item geo item data / данные гео-объекта
      * @returns standard code string / строка стандартного кода
      */
-    toStandard(item: GeoItem): string;
+    toStandard(item: GeoItem, language?: string): string;
     /**
      * Updates the current location and related data.
      *
@@ -242,6 +256,7 @@ export declare class GeoInstance {
      *
      * Внутренний метод для заполнения отсутствующих полей в гео-объекте.
      * @param item basic geo item / базовый гео-объект
+     * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
      * @returns full geo item data / полные данные гео-объекта
      */
     private toFull;

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

@@ -38,6 +38,12 @@ export interface GeoItemFull extends Omit<GeoItem, 'firstDay'> {
     standard: string;
     /** First day of week (required)/ Первый день недели (обязательный) */
     firstDay: string;
+    /** Current location string/ Строка текущего местоположения */
+    location: string;
+    /** Current country code from location/ Текущий код страны из местоположения */
+    locationCountry: string;
+    /** Current language code from location/ Текущий код языка из местоположения */
+    locationLanguage: string;
 }
 /** Geographic flag item for country flag display/ Элемент географического флага для отображения флага страны */
 export interface GeoFlagItem {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/functional-basic",
   "private": false,
-  "version": "1.3.12",
+  "version": "1.3.15",
   "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": [
@@ -59,9 +59,9 @@
   },
   "files": [
     "dist",
-    "ai-description.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 comprehensive, isomorphic utility toolkit for TypeScript applications, focusing on data management, HTTP communication, internationalization, and DOM manipulation. 
-
-1. Core Purpose:
-The library acts as a centralized foundation for common application tasks. It provides a robust HTTP client (Fetch wrapper with built-in retries, caching, and hydration support), state management (localized storage, cookie handling, URL hash synchronization), internationalization (translation management, date/time/currency formatting), and DOM utility functions (event listeners, scroll management, meta tag management).
-
-2. Usage Scenarios:
-- API Orchestration: Use the Api/ApiInstance classes for unified fetch requests, centralized error handling (ErrorCenter), and automatic response caching.
-- State Synchronization: Essential for SSR-compliant state management (ServerStorage) and syncing application state with URL hashes or Cookies.
-- Localization: Indispensable for applications requiring multi-language support (Translate), dynamic date/time formatting (GeoIntl, Datetime), and locale-aware number/currency formatting.
-- DOM & Event Management: Use EventItem for lifecycle-safe event listeners (with automatic cleanup) and scroll/resize optimizations; use Meta and its derivatives for SEO and social media metadata management.
-- Data Processing: Highly useful for search-as-you-type implementations (SearchList) and complex data transformations (Formatters).
-
-3. Integration Context:
-- SSR & Hydration: The library includes specialized handlers (ApiHydration, ServerStorage, getHydrationData) designed to bridge the gap between server-rendered state and client-side execution, preventing hydration mismatches.
-- Architecture: It follows a singleton-friendly patterns (e.g., Api.getItem(), Geo.getObject()) that facilitate global access to state and configurations across disparate modules without tight coupling.
-- Type Safety: Extensively typed (TypeScript), providing full autocompletion and structural validation for search, API, translation, and formatting configurations.
-
-An AI assistant should study this library when tasked with building enterprise-grade, localized web applications that require standardized API communication, cross-browser DOM event management, or robust SSR data state serialization.

package/ai-doc.txt

@@ -1,54 +0,0 @@
-This is the basic functional library (@dxtmisha/functional-basic). It contains framework-agnostic algorithms, utilities, and classes.
-
-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`.