@dxtmisha/functional-basic 1.4.2 → 1.5.0

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

@@ -62,6 +62,13 @@ export declare class ErrorCenter {
      * @param handlers handlers list / список обработчиков
      */
     static addHandlerList(handlers: ErrorCenterHandlerList): void;
+    /**
+     * Adds a callback to be executed on any error.
+     *
+     * Добавляет обратный вызов, который будет выполняться при любой ошибке.
+     * @param callback callback function / функция обратного вызова
+     */
+    static addCallback(callback: ErrorCenterHandlerCallback): void;
     /**
      * Triggers error handling for a group.
      *

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

@@ -7,6 +7,8 @@ import { ErrorCenterCauseItem, ErrorCenterGroup, ErrorCenterHandlerCallback, Err
 export declare class ErrorCenterHandler {
     /** Registered handlers list / Список зарегистрированных обработчиков */
     protected handlers: ErrorCenterHandlerList;
+    /** Callbacks executed on every error / Обратные вызовы, выполняемые при каждой ошибке */
+    protected callbacks: ErrorCenterHandlerCallback[];
     /**
      * Constructor
      * @param handlers initial handlers list / начальный список обработчиков
@@ -45,6 +47,14 @@ export declare class ErrorCenterHandler {
      * @returns this instance / текущий экземпляр
      */
     addList(handlers: ErrorCenterHandlerList): this;
+    /**
+     * Adds a callback to be executed on any error.
+     *
+     * Добавляет обратный вызов, который будет выполняться при любой ошибке.
+     * @param callback callback function / функция обратного вызова
+     * @returns this instance / текущий экземпляр
+     */
+    addCallback(callback: ErrorCenterHandlerCallback): this;
     /**
      * Triggers handlers for a group and logs to console.
      *

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

@@ -66,6 +66,14 @@ export declare class ErrorCenterInstance {
      * @returns this instance / текущий экземпляр
      */
     addHandlerList(handlers: ErrorCenterHandlerList): this;
+    /**
+     * Adds a callback to be executed on any error.
+     *
+     * Добавляет обратный вызов, который будет выполняться при любой ошибке.
+     * @param callback callback function / функция обратного вызова
+     * @returns this instance / текущий экземпляр
+     */
+    addCallback(callback: ErrorCenterHandlerCallback): this;
     /**
      * Triggers error handling for a group.
      *

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

@@ -0,0 +1,207 @@
+import { NumberOrString } from '../types/basicTypes';
+import { GeoItemFull } from '../types/geoTypes';
+/**
+ * Class for localized unit formatting and automatic conversions.
+ * Automatically translates metric units (like gram, meter) to local equivalents
+ * (like ounce, foot) for non-metric regions (US, MM, LR) and formats them.
+ *
+ * Класс для локализованного форматирования единиц измерения и автоматической конвертации.
+ * Автоматически преобразует метрические единицы (такие как грамм, метр) в локальные аналоги
+ * (такие как унция, фут) для неметрических регионов (США, Мьянма, Либерия) и форматирует их.
+ */
+export declare class GeoUnit {
+    /** Detailed data about the current country / Детальные данные о текущей стране */
+    protected readonly geo: GeoItemFull;
+    /**
+     * Returns a request-isolated instance of GeoUnit or cached instance.
+     *
+     * Возвращает изолированный в рамках запроса экземпляр GeoUnit или кэшированный экземпляр.
+     * @param code country or language code / код страны или языка
+     * @returns GeoUnit instance / экземпляр GeoUnit
+     */
+    static getInstance(code?: string): GeoUnit;
+    /**
+     * Constructor.
+     * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
+     */
+    constructor(code?: string);
+    /**
+     * Returns the standard location code.
+     *
+     * Возвращает стандартный код местоположения.
+     * @returns standard location code / стандартный код местоположения
+     */
+    getLocation(): string;
+    /**
+     * Formats millimeter value, converting to inches if overridden by locale unit settings.
+     *
+     * Форматирует значение в миллиметрах, конвертируя в дюймы, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    millimeter(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats centimeter value, converting to inches if overridden by locale unit settings.
+     *
+     * Форматирует значение в сантиметрах, конвертируя в дюймы, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    centimeter(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats meter value, converting to feet if overridden by locale unit settings.
+     *
+     * Форматирует значение в метрах, конвертируя в футы, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    meter(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats kilometer value, converting to miles if overridden by locale unit settings.
+     *
+     * Форматирует значение в километрах, конвертируя в мили, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    kilometer(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats square meter value, converting to square feet if overridden by locale unit settings.
+     *
+     * Форматирует значение в квадратных метрах, конвертируя в квадратные футы, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    squareMeter(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats hectare value, converting to acres if overridden by locale unit settings.
+     *
+     * Форматирует значение в гектарах, конвертируя в акры, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    hectare(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats gram value, converting to ounces if overridden by locale unit settings.
+     *
+     * Форматирует значение в граммах, конвертируя в унции, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    gram(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats kilogram value, converting to pounds if overridden by locale unit settings.
+     *
+     * Форматирует значение в килограммах, конвертируя в фунты, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    kilogram(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats tonne value, converting to short tons if overridden by locale unit settings.
+     *
+     * Форматирует значение в тоннах, конвертируя в короткие тонны, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    tonne(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats milliliter value, converting to fluid ounces if overridden by locale unit settings.
+     *
+     * Форматирует значение в миллилитрах, конвертируя в жидкие унции, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    milliliter(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats liter value, converting to gallons if overridden by locale unit settings.
+     *
+     * Форматирует значение в литрах, конвертируя в галлоны, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    liter(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats celsius value, converting to fahrenheit if overridden by locale unit settings.
+     *
+     * Форматирует значение в градусах Цельсия, конвертируя в градусы Фаренгейта, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    celsius(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats kilometer per hour value, converting to miles per hour if overridden by locale unit settings.
+     *
+     * Форматирует значение в километрах в час, конвертируя в мили в час, если это переопределено настройками локали.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    kilometerPerHour(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Formats the value for the specified unit, converting and formatting it according to the locale.
+     *
+     * Форматирует значение для указанной единицы измерения, преобразуя и форматируя его в соответствии с локалью.
+     * @param value numeric value to format / числовое значение для форматирования
+     * @param unit unit of measurement / единица измерения
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string or original value / отформатированная строка или исходное значение
+     */
+    format(value: NumberOrString, unit: string, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Checks if the conversion is from Celsius to Fahrenheit.
+     *
+     * Проверяет, является ли конвертация переходом из градусов Цельсия в градусы Фаренгейта.
+     * @param from source unit identifier / исходный идентификатор единицы измерения
+     * @param to target unit identifier / целевой идентификатор единицы измерения
+     * @returns true if conversion is Celsius to Fahrenheit / true, если конвертация из Цельсия в Фаренгейт
+     */
+    protected isCelsiusToFahrenheit(from: string, to: string): boolean;
+    /**
+     * Retrieves the target unit configured for the given source unit.
+     *
+     * Получает целевую единицу измерения, настроенную для заданной исходной единицы измерения.
+     * @param sourceUnit metric unit identifier / метрический идентификатор единицы измерения
+     * @returns target unit identifier / целевой идентификатор единицы измерения
+     */
+    protected getTargetUnit(sourceUnit: string): string;
+    /**
+     * Internal helper method to perform unit conversion and formatting.
+     *
+     * Внутренний вспомогательный метод для выполнения конвертации и форматирования единиц измерения.
+     * @param value value to format / значение для форматирования
+     * @param sourceUnit metric unit identifier / метрический идентификатор единицы измерения
+     * @param options formatting options / параметры форматирования
+     * @returns formatted unit string / отформатированная строка единицы измерения
+     */
+    protected formatUnit(value: NumberOrString, sourceUnit: string, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Performs conversion between units.
+     *
+     * Выполняет конвертацию между единицами измерения.
+     * @param value value to convert / значение для конвертации
+     * @param from source unit identifier / исходный идентификатор единицы измерения
+     * @param to target unit identifier / целевой идентификатор единицы измерения
+     * @returns converted value / сконвертированное значение
+     */
+    protected convert(value: number, from: string, to: string): number;
+    /**
+     * Converts temperature value from Celsius to Fahrenheit.
+     *
+     * Конвертирует значение температуры из градусов Цельсия в градусы Фаренгейта.
+     * @param value temperature value in Celsius / значение температуры в градусах Цельсия
+     * @returns temperature value in Fahrenheit / значение температуры в градусах Фаренгейта
+     */
+    protected celsiusToFahrenheit(value: number): number;
+}

package/dist/src/library.d.ts

@@ -31,6 +31,7 @@ export * from './classes/GeoFlag';
 export * from './classes/GeoInstance';
 export * from './classes/GeoIntl';
 export * from './classes/GeoPhone';
+export * from './classes/GeoUnit';
 export * from './classes/Global';
 export * from './classes/Hash';
 export * from './classes/HashInstance';

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

@@ -1,98 +1,142 @@
 /**
- * Union type for date format options in geographic context/
+ * Union type for date format options in geographic context /
  * Объединенный тип для опций формата даты в географическом контексте
  */
 export type GeoDate = 'full' | 'datetime' | 'date' | 'year-month' | 'year' | 'month' | 'day' | 'day-month' | 'time' | 'hour-minute' | 'hour' | 'minute' | 'second';
-/** First day of week code (0=Sunday, 1=Monday, 6=Saturday)/ Код первого дня недели (0=воскресенье, 1=понедельник, 6=суббота) */
+/** First day of week code (0 = Sunday, 1 = Monday, 6 = Saturday) / Код первого дня недели (0 = воскресенье, 1 = понедельник, 6 = суббота) */
 export type GeoFirstDay = 1 | 6 | 0;
-/** Hour format type (12-hour or 24-hour)/ Тип формата часов (12-часовой или 24-часовой) */
+/** Hour format type (12-hour or 24-hour) / Тип формата часов (12-часовой или 24-часовой) */
 export type GeoHours = '12' | '24';
-/** Timezone display style options/ Опции стиля отображения часового пояса */
+/** Timezone display style options / Опции стиля отображения часового пояса */
 export type GeoTimeZoneStyle = 'minute' | 'hour' | 'ISO8601' | 'RFC';
-/** Geographic item interface for country and language data/ Интерфейс географического элемента для данных страны и языка */
+/** Geographic item interface for country and language data / Интерфейс географического элемента для данных страны и языка */
 export interface GeoItem {
-    /** Country code/ Код страны */
+    /** Country code / Код страны */
     country: string;
-    /** Alternative country codes/ Альтернативные коды стран */
+    /** Alternative country codes / Альтернативные коды стран */
     countryAlternative?: string[];
-    /** Language code/ Код языка */
+    /** Language code / Код языка */
     language: string;
-    /** Alternative language codes/ Альтернативные коды языков */
+    /** Alternative language codes / Альтернативные коды языков */
     languageAlternative?: string[];
-    /** First day of week/ Первый день недели */
+    /** First day of week / Первый день недели */
     firstDay?: string | null;
-    /** Timezone/ Часовой пояс */
+    /** Timezone / Часовой пояс */
     zone?: string | null;
-    /** Phone country code/ Телефонный код страны */
+    /** Phone country code / Телефонный код страны */
     phoneCode?: string;
-    /** Phone code for domestic calls/ Телефонный код для внутренних звонков */
+    /** Phone code for domestic calls / Телефонный код для внутренних звонков */
     phoneWithin?: string;
-    /** Phone number mask/ Маска телефонного номера */
+    /** Phone number mask / Маска телефонного номера */
     phoneMask?: string | string[];
-    /** Name format pattern/ Шаблон формата имени */
+    /** Name format pattern / Шаблон формата имени */
     nameFormat?: 'fl' | 'fsl' | 'lf' | 'lsf' | string;
+    /** Units of measurement configuration / Конфигурация единиц измерения */
+    unit?: {
+        /** Millimeter unit format or symbol / Формат или символ единицы измерения миллиметра */
+        'millimeter'?: string;
+        /** Centimeter unit format or symbol / Формат или символ единицы измерения сантиметра */
+        'centimeter'?: string;
+        /** Meter unit format or symbol / Формат или символ единицы измерения метра */
+        'meter'?: string;
+        /** Kilometer unit format or symbol / Формат или символ единицы измерения километра */
+        'kilometer'?: string;
+        /** Square meter unit format or symbol / Формат или символ единицы измерения квадратного метра */
+        'square-meter'?: string;
+        /** Hectare unit format or symbol / Формат или символ единицы измерения гектара */
+        'hectare'?: string;
+        /** Gram unit format or symbol / Формат или символ единицы измерения грамма */
+        'gram'?: string;
+        /** Kilogram unit format or symbol / Формат или символ единицы измерения килограмма */
+        'kilogram'?: string;
+        /** Tonne unit format or symbol / Формат или символ единицы измерения тонны */
+        'tonne'?: string;
+        /** Milliliter unit format or symbol / Формат или символ единицы измерения миллилитра */
+        'milliliter'?: string;
+        /** Liter unit format or symbol / Формат или символ единицы измерения литра */
+        'liter'?: string;
+        /** Celsius unit format or symbol / Формат или символ единицы измерения градуса Цельсия */
+        'celsius'?: string;
+        /** Kilometer per hour unit format or symbol / Формат или символ единицы измерения километра в час */
+        'kilometer-per-hour'?: string;
+    };
 }
-/** Extended geographic item with required fields/ Расширенный географический элемент с обязательными полями */
+/** Extended geographic item with required fields / Расширенный географический элемент с обязательными полями */
 export interface GeoItemFull extends Omit<GeoItem, 'firstDay'> {
-    /** Standard locale code/ Стандартный код локали */
+    /** Standard locale code / Стандартный код локали */
     standard: string;
-    /** First day of week (required)/ Первый день недели (обязательный) */
+    /** First day of week (required) / Первый день недели (обязательный) */
     firstDay: string;
-    /** Current location string/ Строка текущего местоположения */
+    /** Current location string / Строка текущего местоположения */
     location: string;
-    /** Current country code from location/ Текущий код страны из местоположения */
+    /** Current country code from location / Текущий код страны из местоположения */
     locationCountry: string;
-    /** Current language code from location/ Текущий код языка из местоположения */
+    /** Current language code from location / Текущий код языка из местоположения */
     locationLanguage: string;
 }
-/** Geographic flag item for country flag display/ Элемент географического флага для отображения флага страны */
+/** Geographic flag item for country flag display / Элемент географического флага для отображения флага страны */
 export interface GeoFlagItem {
-    /** Language name/ Название языка */
+    /** Language name / Название языка */
     language: string;
-    /** Language code/ Код языка */
+    /** Language code / Код языка */
     languageCode: string;
-    /** Country name/ Название страны */
+    /** Country name / Название страны */
     country: string;
-    /** Country code/ Код страны */
+    /** Country code / Код страны */
     countryCode: string;
-    /** Standard locale code/ Стандартный код локали */
+    /** Standard locale code / Стандартный код локали */
     standard: string;
-    /** Flag icon identifier/ Идентификатор иконки флага */
+    /** Flag icon identifier / Идентификатор иконки флага */
     icon?: string;
-    /** Display label/ Отображаемая метка */
+    /** Display label / Отображаемая метка */
     label: string;
-    /** Value for selection/ Значение для выбора */
+    /** Value for selection / Значение для выбора */
     value: string;
-    /** Phone country code/ Телефонный код страны */
+    /** Phone country code / Телефонный код страны */
     phoneCode?: string;
 }
 /**
- * Extended geographic flag item with national language information/
+ * Extended geographic flag item with national language information /
  * Расширенный элемент географического флага с информацией о национальном языке
  */
 export interface GeoFlagNational extends GeoFlagItem {
-    /** Description in national language/ Описание на национальном языке */
+    /** Description in national language / Описание на национальном языке */
     description: string;
-    /** Language name in national language/ Название языка на национальном языке */
+    /** Language name in national language / Название языка на национальном языке */
     nationalLanguage: string;
-    /** Country name in national language/ Название страны на национальном языке */
+    /** Country name in national language / Название страны на национальном языке */
     nationalCountry: string;
 }
+/** Phone configuration metadata for a country / Структура метаданных для конфигурации телефона страны */
 export interface GeoPhoneValue {
+    /** Phone country code (e.g., 7) / Телефонный код страны (например, 7) */
     phone: number;
+    /** Internal dialing rule code / Код внутреннего правила набора */
     within: number;
+    /** Array of mask patterns assigned to the country / Массив паттернов масок, закрепленных за страной */
     mask: string[];
+    /** Country identifier (ISO 3166) / Идентификатор страны (ISO 3166) */
     value: string;
 }
+/** Node in the internal phone prefix tree (Trie) / Узел внутреннего префиксного дерева телефонов (Trie) */
 export interface GeoPhoneMap {
+    /** List of all items available in this branch of the tree / Список всех элементов, доступных в данной ветви дерева */
     items: GeoPhoneValue[];
+    /** Phone metadata if the current node is a complete code / Метаданные телефона, если текущий узел является завершенным кодом */
     info: GeoPhoneValue | undefined;
+    /** Country identifier for this node / Идентификатор страны для данного узла */
     value: string | undefined;
+    /** Array of masks with substituted internal symbols / Массив масок с подставленными спецсимволами */
     mask: string[];
+    /** Full masks including the international code / Полные маски, включая международный код */
     maskFull: string[];
+    /** Pointers to the next digits in the search tree / Указатели на следующие цифры номера в дереве поиска */
     next: Record<string, GeoPhoneMap>;
 }
+/** Result of searching a country by phone number / Результат поиска страны по номеру телефона */
 export interface GeoPhoneMapInfo {
+    /** The found tree node with country and mask information / Найденный узел дерева с информацией о стране и масках */
     item?: GeoPhoneMap;
+    /** The remaining part of the number after separating the country code / Оставшаяся часть номера после отделения кода страны */
     phone?: string;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/functional-basic",
   "private": false,
-  "version": "1.4.2",
+  "version": "1.5.0",
   "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": [
@@ -79,7 +79,7 @@
   "engines": {
     "node": ">=20.0.0"
   },
-  "peerDependencies": {
+  "dependencies": {
     "@dxtmisha/media": "*"
   },
   "sideEffects": false,