@dxtmisha/functional-basic 1.8.6 → 1.8.9

package/dist/classes/Meta.d.ts

@@ -8,8 +8,11 @@ import { MetaRobots, MetaTag } from '../types/metaTypes';
  * Унифицированный класс для управления всеми типами мета-тегов (стандартные HTML, Open Graph, Twitter Card).
  */
 export declare class Meta extends MetaManager<MetaTag[]> {
+    /** Page title suffix / Суффикс заголовка страницы */
     protected suffix?: string;
+    /** Open Graph meta instance / Экземпляр мета-тегов Open Graph */
     protected og: MetaOg;
+    /** Twitter Card meta instance / Экземпляр мета-тегов Twitter Card */
     protected twitter: MetaTwitter;
     /**
      * Creates an instance of Meta with integrated Open Graph and Twitter Card support.
@@ -160,7 +163,7 @@ export declare class Meta extends MetaManager<MetaTag[]> {
      *
      * Устанавливает суффикс для добавления к заголовку страницы.
      * @param suffix title suffix (e.g. 'My Site') / суффикс заголовка (например, 'Мой Сайт')
-     * @returns void
+     * @returns void / ничего не возвращает
      */
     setSuffix(suffix?: string): void;
     /**

package/dist/classes/MetaManager.d.ts

@@ -1,3 +1,4 @@
+/** Meta-tags dictionary structure / Структура словаря мета-тегов */
 type MetaList<T extends readonly string[]> = {
     [K in T[number]]?: string;
 };
@@ -9,6 +10,7 @@ type MetaList<T extends readonly string[]> = {
 export declare class MetaManager<T extends readonly string[], Key extends keyof MetaList<T> = keyof MetaList<T>> {
     protected readonly listMeta: T;
     protected readonly isProperty: boolean;
+    /** Meta tags map / Карта мета-тегов */
     protected readonly items: MetaList<T>;
     /**
      * Creates an instance of MetaManager.

package/dist/classes/MetaOg.d.ts

@@ -6,6 +6,11 @@ import { MetaOpenGraphTag, MetaOpenGraphType } from '../types/metaTypes';
  * Класс для управления мета-тегами Open Graph.
  */
 export declare class MetaOg extends MetaManager<MetaOpenGraphTag[]> {
+    /**
+     * Constructor for MetaOg.
+     *
+     * Конструктор для MetaOg.
+     */
     constructor();
     /**
      * Gets the Open Graph title.
@@ -25,7 +30,7 @@ export declare class MetaOg extends MetaManager<MetaOpenGraphTag[]> {
      * Gets the Open Graph URL.
      *
      * Получает URL Open Graph.
-     * @returns URL / URL
+     * @returns URL / URL адрес
      */
     getUrl(): string;
     /**
@@ -76,7 +81,7 @@ export declare class MetaOg extends MetaManager<MetaOpenGraphTag[]> {
      * Sets the Open Graph URL.
      *
      * Устанавливает URL Open Graph.
-     * @param url URL / URL
+     * @param url URL / URL адрес
      * @returns current instance / текущий экземпляр
      */
     setUrl(url: string): this;

package/dist/classes/MetaTwitter.d.ts

@@ -6,6 +6,11 @@ import { MetaTwitterCard, MetaTwitterTag } from '../types/metaTypes';
  * Класс для управления мета-тегами Twitter Card.
  */
 export declare class MetaTwitter extends MetaManager<MetaTwitterTag[]> {
+    /**
+     * Constructor for MetaTwitter.
+     *
+     * Конструктор для MetaTwitter.
+     */
     constructor();
     /**
      * Gets the Twitter Card type.
@@ -32,7 +37,7 @@ export declare class MetaTwitter extends MetaManager<MetaTwitterTag[]> {
      * Gets the page URL.
      *
      * Получает URL страницы.
-     * @returns URL / URL
+     * @returns URL / URL адрес
      */
     getUrl(): string;
     /**
@@ -84,7 +89,7 @@ export declare class MetaTwitter extends MetaManager<MetaTwitterTag[]> {
      * Sets the page URL.
      *
      * Устанавливает URL страницы.
-     * @param url URL / URL
+     * @param url URL / URL адрес
      * @returns current instance / текущий экземпляр
      */
     setUrl(url: string): this;

package/dist/classes/Query.d.ts

@@ -51,7 +51,7 @@ export declare class Query {
      * Update query variables from URL string.
      *
      * Обновление переменных query-параметров из строки URL.
-     * @returns void
+     * @returns void / ничего не возвращает
      */
     static reload(): void;
 }

package/dist/classes/ResumableTimer.d.ts

@@ -7,9 +7,13 @@ import { FunctionVoid } from '../types/basicTypes';
 export declare class ResumableTimer {
     protected callback: FunctionVoid;
     protected delay: number;
+    /** setTimeout identifier / Идентификатор setTimeout */
     protected timerId?: ReturnType<typeof setTimeout>;
+    /** Timestamp when timer started / Метка времени старта таймера */
     protected startTime?: number;
+    /** Remaining milliseconds / Оставшиеся миллисекунды */
     protected remaining?: number;
+    /** Completion flag / Флаг завершения */
     protected completed: boolean;
     /**
      * Constructor

package/dist/classes/ScrollbarWidth.d.ts

@@ -5,6 +5,7 @@ import { DataStorage } from './DataStorage';
  * Класс для получения ширины скролла.
  */
 export declare class ScrollbarWidth {
+    /** Calculation state flag / Флаг состояния вычисления */
     private static calculate;
     /**
      * Checks whether to enable scroll hiding.

package/dist/classes/SearchList.d.ts

@@ -11,9 +11,13 @@ import { SearchCacheItem, SearchColumns, SearchFormatItem, SearchFormatList, Sea
  * Координирует работу опций, состояния элементов, логики сопоставления и хранения данных.
  */
 export declare class SearchList<T extends SearchItem, K extends SearchColumns<T>> {
+    /** Search options instance / Экземпляр опций поиска */
     protected options: SearchListOptions;
+    /** Search list item state / Состояние элемента списка поиска */
     protected item: SearchListItem;
+    /** Search matcher instance / Экземпляр сопоставителя поиска */
     protected matcher: SearchListMatcher;
+    /** Search data storage instance / Экземпляр хранилища данных поиска */
     protected data: SearchListData<T, K>;
     /**
      * Constructor for SearchList.

package/dist/classes/SearchListData.d.ts

@@ -11,6 +11,7 @@ export declare class SearchListData<T extends SearchItem, K extends SearchColumn
     protected columns: K | undefined;
     protected item: SearchListItem;
     protected options: SearchListOptions;
+    /** Search items cache / Кэш элементов поиска */
     protected listCache?: SearchCache<T>;
     /**
      * Constructor for SearchListData.
@@ -130,14 +131,14 @@ export declare class SearchListData<T extends SearchItem, K extends SearchColumn
      * Initializes the search cache.
      *
      * Инициализирует кэш поиска.
-     * @returns void
+     * @returns void / ничего не возвращает
      */
     protected initCache(): void;
     /**
      * Resets the search cache.
      *
      * Сбрасывает кэш поиска.
-     * @returns void
+     * @returns void / ничего не возвращает
      */
     protected resetCache(): void;
 }

package/dist/classes/SearchListMatcher.d.ts

@@ -9,6 +9,7 @@ import { SearchCacheItem } from '../types/searchTypes';
 export declare class SearchListMatcher {
     protected item: SearchListItem;
     protected options: SearchListOptions;
+    /** Regular expression matcher instance / Экземпляр регулярного выражения сопоставителя */
     protected matcher: RegExp | undefined;
     /**
      * Constructor for SearchListMatcher.
@@ -44,14 +45,14 @@ export declare class SearchListMatcher {
      * Updates the matcher based on the current item value and options.
      *
      * Обновляет сопоставитель на основе текущего значения элемента и опций.
-     * @returns void
+     * @returns void / ничего не возвращает
      */
     update(): void;
     /**
      * Initializes or resets the regular expression matcher.
      *
      * Инициализирует или сбрасывает сопоставитель регулярных выражений.
-     * @returns void
+     * @returns void / ничего не возвращает
      */
     protected initMatcher(): void;
 }

package/dist/classes/ServerStorage.d.ts

@@ -3,6 +3,7 @@ type ServerStorageItem = {
     value: any;
     hydration: boolean;
 };
+/** Map of server storage items / Карта элементов серверного хранилища */
 type ServerStorageList = Record<string, ServerStorageItem>;
 /**
  * Class for managing data storage during server-side rendering (SSR).
@@ -12,8 +13,11 @@ type ServerStorageList = Record<string, ServerStorageItem>;
  * Обеспечивает изоляцию данных между параллельными запросами, используя контекст конкретного запроса.
  */
 export declare class ServerStorage {
+    /** In-memory storage fallback / Резервное хранилище в памяти */
     protected static storage?: ServerStorageList;
+    /** Request context listener / Слушатель контекста запроса */
     protected static listener?: () => Record<string, any> | undefined;
+    /** Flag to hide missing storage error / Флаг скрытия ошибки отсутствия хранилища */
     protected static hideError?: boolean;
     /**
      * Initializes the storage with a context listener.
@@ -83,8 +87,7 @@ export declare class ServerStorage {
      * Returns storage.
      *
      * Возвращает хранилище.
-     * @param isInit whether to initialize the storage if it does not exist /
-     * инициализировать ли хранилище, если оно не существует
+     * @param isInit whether to initialize the storage if it does not exist / инициализировать ли хранилище, если оно не существует
      * @param status optional status for error reporting / необязательный статус для отчета об ошибках
      * @returns storage list / список хранилища
      */

package/dist/classes/StorageCallback.d.ts

@@ -15,10 +15,12 @@ export declare class StorageCallback<T = any, Callback = (value: T) => void | Pr
      * @returns StorageCallback instance / экземпляр StorageCallback
      */
     static getInstance<T>(name: string, group?: string): StorageCallback<T, (value: T) => void | Promise<void>>;
+    /** List of registered callbacks / Список зарегистрированных колбэков */
     protected callbacks: {
         callback: Callback;
         isOnce?: boolean;
     }[];
+    /** Loading state / Состояние загрузки */
     protected loading: boolean;
     /**
      * Constructor for initialization.

package/dist/classes/Translate.d.ts

@@ -6,6 +6,7 @@ import { TranslateCode, TranslateConfig, TranslateDataFile, TranslateList } from
  * Класс для получения переведенного текста.
  */
 export declare class Translate {
+    /** TranslateInstance singleton item / Экземпляр синглтона TranslateInstance */
     protected static item?: TranslateInstance;
     /**
      * Getting the translation text by its code.
@@ -27,11 +28,9 @@ export declare class Translate {
      * Getting the translation text by its code (Sync).
      *
      * Получение текста перевода по его коду (Sync).
-     * @param name code name/ название кода
-     * @param first If set to false, returns an empty string if there is no text/
-     * если установлено false, возвращает пустую строку, если нет текста
-     * @param replacement If set, replaces the text with the specified values/
-     * если установлено, заменяет текст на указанные значения
+     * @param name code name / название кода
+     * @param first If set to false, returns an empty string if there is no text / если установлено false, возвращает пустую строку, если нет текста
+     * @param replacement If set, replaces the text with the specified values / если установлено, заменяет текст на указанные значения
      * @returns translation text / текст перевода
      */
     static getSync(name: string, first?: boolean, replacement?: string[] | Record<string, string | number>): string;
@@ -47,9 +46,8 @@ export declare class Translate {
      * Getting a list of translations by an array of text codes.
      *
      * Получение списка переводов по массиву кодов текста.
-     * @param names list of codes to get translations/ список кодов для получения переводов
-     * @param first If set to false, returns an empty string if there is no text/
-     * если установлено false, возвращает пустую строку, если нет текста
+     * @param names list of codes to get translations / список кодов для получения переводов
+     * @param first If set to false, returns an empty string if there is no text / если установлено false, возвращает пустую строку, если нет текста
      * @returns object with translations / объект с переводами
      */
     static getListSync<T extends TranslateCode[]>(names: T, first?: boolean): TranslateList<T>;

package/dist/classes/TranslateInstance.d.ts

@@ -42,10 +42,8 @@ export declare class TranslateInstance {
      *
      * Получение текста перевода по его коду (Sync).
      * @param name code name/ название кода
-     * @param first If set to false, returns an empty string if there is no text/
-     * если установлено false, возвращает пустую строку, если нет текста
-     * @param replacement If set, replaces the text with the specified values/
-     * если установлено, заменяет текст на указанные значения
+     * @param first If set to false, returns an empty string if there is no text / если установлено false, возвращает пустую строку, если нет текста
+     * @param replacement If set, replaces the text with the specified values / если установлено, заменяет текст на указанные значения
      * @returns translation text / текст перевода
      */
     getSync(name: string, first?: boolean, replacement?: string[] | Record<string, string | number>): string;
@@ -61,9 +59,8 @@ export declare class TranslateInstance {
      * Getting a list of translations by an array of text codes.
      *
      * Получение списка переводов по массиву кодов текста.
-     * @param names list of codes to get translations/ список кодов для получения переводов
-     * @param first If set to false, returns an empty string if there is no text/
-     * если установлено false, возвращает пустую строку, если нет текста
+     * @param names list of codes to get translations / список кодов для получения переводов
+     * @param first If set to false, returns an empty string if there is no text / если установлено false, возвращает пустую строку, если нет текста
      * @returns object with translations / объект с переводами
      */
     getListSync<T extends TranslateCode[]>(names: T, first?: boolean): TranslateList<T>;

package/dist/classes/UrlInstanceAbstract.d.ts

@@ -4,9 +4,13 @@
  * Базовый абстрактный класс для работы с состояниями на основе URL (Hash, Query).
  */
 export declare abstract class UrlInstanceAbstract {
+    /** URL state data record / Запись данных состояния URL */
     protected data?: Record<string, any>;
+    /** Watchers map for URL state variables / Карта слушателей для переменных состояния URL */
     protected watch: Record<string, ((value: any) => void)[]>;
+    /** Update block flag / Флаг блокировки обновления */
     protected block: boolean;
+    /** Debounce timer instance / Экземпляр таймера задержки */
     protected time?: any;
     /**
      * Get data.

package/dist/functions/getMouseClient.d.ts

@@ -6,4 +6,4 @@ import { ImageCoordinator } from '../types/basicTypes';
  * @param event event object/ объект события
  * @returns coordinates of the mouse cursor / координаты курсора мыши
  */
-export declare function getMouseClient(event: MouseEvent & TouchEvent): ImageCoordinator;
+export declare function getMouseClient(event: MouseEvent | TouchEvent): ImageCoordinator;

package/dist/functions/getMouseClientX.d.ts

@@ -5,4 +5,4 @@
  * @param event event object/ объект события
  * @returns X coordinate / координата X
  */
-export declare function getMouseClientX(event: MouseEvent & TouchEvent): number;
+export declare function getMouseClientX(event: MouseEvent | TouchEvent): number;

package/dist/functions/getMouseClientY.d.ts

@@ -5,4 +5,4 @@
  * @param event event object/ объект события
  * @returns Y coordinate / координата Y
  */
-export declare function getMouseClientY(event: MouseEvent & TouchEvent): number;
+export declare function getMouseClientY(event: MouseEvent | TouchEvent): number;

package/dist/library.js

@@ -123,9 +123,11 @@ function g(e) {
 var _ = /[^-+\d., ]+/g, v = /( [0-9]{3}[ ,.]|[0-9] [0-9])/, te = / /g, y = /,/g, ne = /,[0-9]{3}[,.]/, re = /[.][0-9]{3}[,.]/, ie = /[.]/g;
 function b(e) {
 	if (typeof e == "number") return Number.isFinite(e) && e || 0;
-	if (!e) return 0;
-	let t = e.replace(_, "");
-	return t = v.test(t) ? t.replace(te, "").replace(y, ".") : ne.test(t) ? t.replace(y, "") : re.test(t) ? t.replace(ie, "").replace(y, ".") : t.replace(y, "."), parseFloat(t) || 0;
+	if (l(e) && d(e)) {
+		let t = e.replace(_, "");
+		return t = v.test(t) ? t.replace(te, "").replace(y, ".") : ne.test(t) ? t.replace(y, "") : re.test(t) ? t.replace(ie, "").replace(y, ".") : t.replace(y, "."), parseFloat(t) || 0;
+	}
+	return 0;
 }
 //#endregion
 //#region src/functions/isSelected.ts
@@ -160,7 +162,7 @@ function oe(e, t, n) {
 	return i.length === a.length ? i : (i.pop(), [...i, a.slice(n - 1).join(t)]);
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.143.0/helpers/esm/typeof.js
+//#region \0@oxc-project+runtime@0.144.0/helpers/esm/typeof.js
 function C(e) {
 	"@babel/helpers - typeof";
 	return C = typeof Symbol == "function" && typeof Symbol.iterator == "symbol" ? function(e) {
@@ -170,7 +172,7 @@ function C(e) {
 	}, C(e);
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.143.0/helpers/esm/toPrimitive.js
+//#region \0@oxc-project+runtime@0.144.0/helpers/esm/toPrimitive.js
 function se(e, t) {
 	if (C(e) != "object" || !e) return e;
 	var n = e[Symbol.toPrimitive];
@@ -182,13 +184,13 @@ function se(e, t) {
 	return (t === "string" ? String : Number)(e);
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.143.0/helpers/esm/toPropertyKey.js
+//#region \0@oxc-project+runtime@0.144.0/helpers/esm/toPropertyKey.js
 function ce(e) {
 	var t = se(e, "string");
 	return C(t) == "symbol" ? t : t + "";
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.143.0/helpers/esm/defineProperty.js
+//#region \0@oxc-project+runtime@0.144.0/helpers/esm/defineProperty.js
 function w(e, t, n) {
 	return (t = ce(t)) in e ? Object.defineProperty(e, t, {
 		value: n,
@@ -4737,13 +4739,13 @@ function Bn(e) {
 //#region src/functions/getMouseClientX.ts
 function Vn(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;
+	return "clientX" in e ? 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 Hn(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;
+	return "clientY" in e ? 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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/functional-basic",
   "private": false,
-  "version": "1.8.6",
+  "version": "1.8.9",
   "type": "module",
   "description": "Foundational isomorphic utility library for modern web and SSR development — HTTP client, state storage, i18n localization, SEO metadata, DOM events, formatting, and data utilities. Framework-agnostic, TypeScript-first.",
   "keywords": [
@@ -63,10 +63,10 @@
     "dev": "vite",
     "build": "vite build",
     "preview": "vite preview",
-    "test": "NODE_OPTIONS=\"--no-webstorage\" vitest",
+    "test": "vitest",
     "library": "dxt-library",
-    "types": "dxt-types",
-    "prepublishOnly": "npm run library && npm run build",
+    "types": "npm run library && npm run build && dxt-types",
+    "prepublishOnly": "npm run library && npm run build && dxt-types-save",
     "publish-to-npm": "npm publish --access public"
   },
   "files": [