@dxtmisha/functional-basic 1.8.10 → 1.10.1

package/dist/classes/Translate.d.ts

@@ -1,117 +0,0 @@
-import { TranslateInstance } from './TranslateInstance';
-import { TranslateCode, TranslateConfig, TranslateDataFile, TranslateList } from '../types/translateTypes';
-/**
- * Class for getting the translated text.
- *
- * Класс для получения переведенного текста.
- */
-export declare class Translate {
-    /** TranslateInstance singleton item / Экземпляр синглтона TranslateInstance */
-    protected static item?: TranslateInstance;
-    /**
-     * Getting the translation text by its code.
-     *
-     * Получение текста перевода по его коду.
-     * @param name code name/ название кода
-     * @param replacement If set, replaces the text with the specified values/ если установлено, заменяет текст на указанные значения
-     * @returns translation text / текст перевода
-     */
-    static get(name: string, replacement?: string[] | Record<string, string | number>): Promise<string>;
-    /**
-     * Returns a request-isolated instance of TranslateInstance.
-     *
-     * Возвращает изолированный в рамках запроса экземпляр TranslateInstance.
-     * @returns TranslateInstance instance / экземпляр TranslateInstance
-     */
-    static getItem(): TranslateInstance;
-    /**
-     * 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 / если установлено, заменяет текст на указанные значения
-     * @returns translation text / текст перевода
-     */
-    static getSync(name: string, first?: boolean, replacement?: string[] | Record<string, string | number>): string;
-    /**
-     * Getting a list of translations by an array of text codes.
-     *
-     * Получение списка переводов по массиву кодов текста.
-     * @param names list of codes to get translations/ список кодов для получения переводов
-     * @returns object with translations / объект с переводами
-     */
-    static getList<T extends TranslateCode[]>(names: T): Promise<TranslateList<T>>;
-    /**
-     * 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, возвращает пустую строку, если нет текста
-     * @returns object with translations / объект с переводами
-     */
-    static getListSync<T extends TranslateCode[]>(names: T, first?: boolean): TranslateList<T>;
-    /**
-     * Added a list of translated texts.
-     *
-     * Добавлен список переведенных текстов.
-     * @param names list of codes to get translations/ список кодов для получения переводов
-     */
-    static add(names: string | string[]): Promise<void>;
-    /**
-     * Adds texts in sync mode.
-     *
-     * Добавляет тексты в режиме синхронизации.
-     * @param data list of texts in the form of key-value/ список текстов в виде ключ-значение
-     */
-    static addSync(data: Record<string, string>): void;
-    /**
-     * Adding data in the form of a query or directly, depending on the execution environment.
-     *
-     * Добавление данных в виде запроса или напрямую, в зависимости от среды выполнения.
-     * @param data list of texts in the form of key-value/ список текстов в виде ключ-значение
-     */
-    static addNormalOrSync(data: Record<string, string>): Promise<void>;
-    /**
-     * Adds texts synchronously by location.
-     *
-     * Добавляет тексты синхронно по местоположению.
-     * @param data list of texts by location/ список текстов по местоположению
-     */
-    static addSyncByLocation(data: Record<string, Record<string, string>>): void;
-    /**
-     * Adds texts synchronously from the file.
-     *
-     * Добавляет тексты синхронно из файла.
-     * @param data file with translations/ файл с переводами
-     */
-    static addSyncByFile(data: TranslateDataFile): void;
-    /**
-     * Change the path to the script for obtaining the translation.
-     *
-     * Изменить путь к скрипту для получения перевода.
-     * @param url path to the script/ путь к скрипту
-     */
-    static setUrl(url: string): void;
-    /**
-     * Change the name of the property to get the translation.
-     *
-     * Изменить имя свойства для получения перевода.
-     * @param name property name/ имя свойства
-     */
-    static setPropsName(name: string): void;
-    /**
-     * Change the read mode from the API.
-     *
-     * Изменить режим чтения из API.
-     * @param value read mode/ режим чтения
-     */
-    static setReadApi(value: boolean): void;
-    /**
-     * Set the configuration for the translation.
-     *
-     * Установить конфигурацию для перевода.
-     * @param config configuration/ конфигурация
-     */
-    static setConfig(config: TranslateConfig): void;
-}

package/dist/classes/TranslateFile.d.ts

@@ -1,81 +0,0 @@
-import { TranslateDataFile, TranslateDataFileList } from '../types/translateTypes';
-/**
- * Class for working with translation files.
- *
- * Класс для работы с файлами перевода.
- */
-export declare class TranslateFile {
-    protected language: string | (() => string);
-    protected location: string | (() => string);
-    /** List of files with translations/ Список файлов с переводами */
-    protected files: TranslateDataFile;
-    /** Data from files/ Данные из файлов */
-    protected data: Record<string, TranslateDataFileList>;
-    /**
-     * Creates an instance of the class.
-     *
-     * Создает экземпляр класса.
-     * @param data list of files/ список файлов
-     * @param language language/ язык
-     * @param location location/ местоположение
-     */
-    constructor(data?: TranslateDataFile, language?: string | (() => string), location?: string | (() => string));
-    /**
-     * Checks if there are files for the current location or language.
-     *
-     * Проверяет, есть ли файлы для текущего местоположения или языка.
-     * @returns boolean / логическое значение
-     */
-    isFile(): boolean;
-    /**
-     * Returns the location.
-     *
-     * Возвращает местоположение.
-     * @returns location / местоположение
-     */
-    getLocation(): string;
-    /**
-     * Returns the language.
-     *
-     * Возвращает язык.
-     * @returns language / язык
-     */
-    getLanguage(): string;
-    /**
-     * Returns a list of translations from the file for the current location.
-     *
-     * Возвращает список переводов из файла для текущего местоположения.
-     * @returns promise with list of translations / промис со списком переводов
-     */
-    getList(): Promise<TranslateDataFileList | undefined>;
-    /**
-     * Adds a list of files with translations.
-     *
-     * Добавляет список файлов с переводами.
-     * @param data list of files/ список файлов
-     */
-    add(data: TranslateDataFile): void;
-    /**
-     * Returns the key for the current location from the list of files.
-     *
-     * Возвращает ключ для текущего местоположения из списка файлов.
-     * @returns file key or undefined / ключ файла или undefined
-     */
-    protected getIndex(): string | undefined;
-    /**
-     * Returns a list of translations from the cache.
-     *
-     * Возвращает список переводов из кэша.
-     * @param index file key/ ключ файла
-     * @returns list of translations or undefined / список переводов или undefined
-     */
-    protected getByData(index: string): TranslateDataFileList | undefined;
-    /**
-     * Returns a list of translations from the file and caches the result.
-     *
-     * Возвращает список переводов из файла и кэширует результат.
-     * @param index file key/ ключ файла
-     * @returns promise with list of translations or undefined / промис со списком переводов или undefined
-     */
-    protected getByFile(index: string): Promise<TranslateDataFileList | undefined>;
-}

package/dist/classes/TranslateInstance.d.ts

@@ -1,203 +0,0 @@
-import { TranslateFile } from './TranslateFile';
-import { TranslateCode, TranslateDataFile, TranslateList } from '../types/translateTypes';
-/**
- * Class for getting the translated text.
- *
- * Класс для получения переведенного текста.
- */
-export declare class TranslateInstance {
-    protected url: string;
-    protected propsName: string;
-    protected readonly files: TranslateFile;
-    /** List of translations/ Список переводов */
-    protected readonly data: Record<string, string>;
-    /** Cache of codes to get/ Кэш кодов для получения */
-    protected cache: string[];
-    /** List of resolves for promises/ Список разрешений для промисов */
-    protected resolveList: (() => void)[];
-    /** Timeout for getting translations/ Таймаут для получения переводов */
-    protected timeout?: any;
-    /** Flag indicating whether to read from the API/ Флаг, указывающий, нужно ли читать из API */
-    protected isReadApi: boolean;
-    /**
-     * Creates an instance of the class.
-     *
-     * Создает экземпляр класса.
-     * @param url URL for getting translations/ URL для получения переводов
-     * @param propsName Property name for getting translations/ Имя свойства для получения переводов
-     * @param files List of files with translations/ Список файлов с переводами
-     */
-    constructor(url?: string, propsName?: string, files?: TranslateFile);
-    /**
-     * Getting the translation text by its code.
-     *
-     * Получение текста перевода по его коду.
-     * @param name code name/ название кода
-     * @param replacement If set, replaces the text with the specified values/ если установлено, заменяет текст на указанные значения
-     * @returns translation text / текст перевода
-     */
-    get(name: string, replacement?: string[] | Record<string, string | number>): Promise<string>;
-    /**
-     * 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 / если установлено, заменяет текст на указанные значения
-     * @returns translation text / текст перевода
-     */
-    getSync(name: string, first?: boolean, replacement?: string[] | Record<string, string | number>): string;
-    /**
-     * Getting a list of translations by an array of text codes.
-     *
-     * Получение списка переводов по массиву кодов текста.
-     * @param names list of codes to get translations/ список кодов для получения переводов
-     * @returns object with translations / объект с переводами
-     */
-    getList<T extends TranslateCode[]>(names: T): Promise<TranslateList<T>>;
-    /**
-     * 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, возвращает пустую строку, если нет текста
-     * @returns object with translations / объект с переводами
-     */
-    getListSync<T extends TranslateCode[]>(names: T, first?: boolean): TranslateList<T>;
-    /**
-     * Added a list of translated texts.
-     *
-     * Добавлен список переведенных текстов.
-     * @param names list of codes to get translations/ список кодов для получения переводов
-     * @returns promise resolving when translations are added / промис, разрешающийся после добавления переводов
-     */
-    add(names: string | string[]): Promise<void>;
-    /**
-     * Adds texts in sync mode.
-     *
-     * Добавляет тексты в режиме синхронизации.
-     * @param data list of texts in the form of key-value/ список текстов в виде ключ-значение
-     */
-    addSync(data: Record<string, string>): void;
-    /**
-     * Adding data in the form of a query or directly, depending on the execution environment.
-     *
-     * Добавление данных в виде запроса или напрямую, в зависимости от среды выполнения.
-     * @param data list of texts in the form of key-value/ список текстов в виде ключ-значение
-     * @returns promise / промис
-     */
-    addNormalOrSync(data: Record<string, string>): Promise<void>;
-    /**
-     * Adds texts synchronously by location.
-     *
-     * Добавляет тексты синхронно по местоположению.
-     * @param data list of texts by location/ список текстов по местоположению
-     */
-    addSyncByLocation(data: Record<string, Record<string, string>>): void;
-    /**
-     * Adds texts synchronously from the file.
-     *
-     * Добавляет тексты синхронно из файла.
-     * @param data file with translations/ файл с переводами
-     */
-    addSyncByFile(data: TranslateDataFile): void;
-    /**
-     * Change the path to the script for obtaining the translation.
-     *
-     * Изменить путь к скрипту для получения перевода.
-     * @param url path to the script/ путь к скрипту
-     */
-    setUrl(url: string): this;
-    /**
-     * Change the name of the property to get the translation.
-     *
-     * Изменить имя свойства для получения перевода.
-     * @param name property name/ имя свойства
-     */
-    setPropsName(name: string): this;
-    /**
-     * Change the read mode from the API.
-     *
-     * Изменить режим чтения из API.
-     * @param value read mode/ режим чтения
-     */
-    setReadApi(value: boolean): this;
-    /**
-     * Checks for translation by code, taking into account fallback options.
-     *
-     * Проверяет наличие перевода по коду с учетом запасных вариантов.
-     * @param name code name/ название кода
-     * @returns boolean / логическое значение
-     */
-    protected hasName(name: string): boolean;
-    /**
-     * Retrieves translation text by code, returning the first matching fallback.
-     *
-     * Получает текст перевода по коду, возвращая первое совпадение из запасных вариантов.
-     * @param name code name/ название кода
-     * @returns translation text or undefined / текст перевода или undefined
-     */
-    protected getText(name: string): string | undefined;
-    /**
-     * Getting the full title for translation.
-     *
-     * Получение полного названия для перевода.
-     * @param name code name/ название кода
-     * @returns full title / полное название
-     */
-    protected getName(name: string): string;
-    /**
-     * Getting the title for translation by language.
-     *
-     * Получение названия для перевода по языку.
-     * @param name code name/ название кода
-     * @returns title by language / название по языку
-     */
-    protected getNameByLanguage(name: string): string;
-    /**
-     * Getting the title for translation globally.
-     *
-     * Получение названия для перевода глобально.
-     * @param name code name/ название кода
-     * @returns global title / глобальное название
-     */
-    protected getNameByGlobal(name: string): string;
-    /**
-     * Returns a list of names that are not yet in the list.
-     *
-     * Возвращает список имен, которых еще нет в списке.
-     * @param names list of codes to get translations/ список кодов для получения переводов
-     * @returns list of missing names / список отсутствующих имен
-     */
-    protected getNamesNone(names: string | string[]): string[];
-    /**
-     * Getting the list of translations from the server.
-     *
-     * Получение списка переводов с сервера.
-     * @returns promise with record of translations / промис с записью переводов
-     */
-    protected getResponse(): Promise<Record<string, string>>;
-    /**
-     * Replaces the text with the specified values.
-     *
-     * Заменяет текст на указанные значения.
-     * @param text text to replace/ текст для замены
-     * @param replacement values for replacement/ значения для замены
-     * @returns replaced text / замененный текст
-     */
-    protected replacement(text: string, replacement?: string[] | Record<string, string | number>): any;
-    /**
-     * Adding translation data from the server.
-     *
-     * Добавление данных по переводу с сервера.
-     * @returns promise / промис
-     */
-    protected make(): Promise<void>;
-    /**
-     * Adding translation data from the list.
-     *
-     * Добавление данных по переводу из списка.
-     * @param list list of translations/ список переводов
-     */
-    protected makeList(list: Record<string, string>): void;
-}

package/dist/classes/UrlInstanceAbstract.d.ts

@@ -1,98 +0,0 @@
-/**
- * Base abstract class for working with URL-based states (Hash, Query).
- *
- * Базовый абстрактный класс для работы с состояниями на основе 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.
-     *
-     * Получение данных.
-     * @param name variable name / название переменной
-     * @param defaultValue value or function to change data / значение или функция для изменения данных
-     * @returns stored value / сохранённое значение
-     */
-    get<T>(name: string, defaultValue?: T | (() => T)): T;
-    /**
-     * Change data.
-     *
-     * Изменение данных.
-     * @param name variable name / название переменной
-     * @param callback value or function to change data / значение или функция для изменения данных
-     * @returns this instance / текущий экземпляр
-     */
-    set<T>(name: string, callback: T | (() => T)): this;
-    /**
-     * Adding an event when data is changed.
-     *
-     * Добавление события при изменении данных.
-     * @param name variable name / название переменной
-     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
-     * @returns this instance / текущий экземпляр
-     */
-    addWatch<T>(name: string, callback: (value: T) => void): this;
-    /**
-     * Removing an event when data is changed.
-     *
-     * Удаление события при изменении данных.
-     * @param name variable name / название переменной
-     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
-     * @returns this instance / текущий экземпляр
-     */
-    removeWatch<T>(name: string, callback: (value: T) => void): this;
-    /**
-     * Update variables from URL string.
-     *
-     * Обновление переменных из строки URL.
-     * @returns this instance / текущий экземпляр
-     */
-    reload(): this;
-    /**
-     * Returns the query/hash data object, initializing if needed.
-     *
-     * Возвращает объект данных, инициализируя при необходимости.
-     * @returns Record<string, any> data object / объект данных
-     */
-    protected getData(): Record<string, any>;
-    /**
-     * Reads data from the URL and triggers watchers.
-     *
-     * Считывает данные из URL и вызывает наблюдателей.
-     * @returns this instance / текущий экземпляр
-     */
-    protected initData(): this;
-    /**
-     * Calling all functions whose data has changed.
-     *
-     * Вызов всех функций, у которых были изменены данные.
-     * @param location fresh data / свежие данные
-     * @returns this instance / текущий экземпляр
-     */
-    protected makeWatch(location: Record<string, any>): this;
-    /**
-     * Initializes data and event listeners.
-     *
-     * Инициализирует данные и слушатели событий.
-     */
-    protected abstract init(): this;
-    /**
-     * Obtaining data from the URL string.
-     *
-     * Получение данных из строки URL.
-     */
-    protected abstract getLocation(): Record<string, any>;
-    /**
-     * Update string in URL.
-     *
-     * Обновление строки в URL.
-     */
-    protected abstract update(): this;
-}

package/dist/classes/UrlItem.d.ts

@@ -1,119 +0,0 @@
-/**
- * Isomorphic utility class for working with URLs.
- * Provides read-only getters and a single 'set' method for modifying the URL.
- *
- * Изоморфный утилитарный класс для работы с URL.
- * Предоставляет геттеры только для чтения и единственный метод «set» для изменения URL.
- */
-export declare class UrlItem {
-    /** Underlying standard URL object / Лежащий в основе стандартный объект URL */
-    private url;
-    /**
-     * Returns a request-isolated instance of UrlItem.
-     *
-     * Возвращает изолированный в рамках запроса экземпляр UrlItem.
-     * @returns UrlItem instance / экземпляр UrlItem
-     */
-    static getInstance(): UrlItem;
-    /**
-     * Constructs a new Url instance.
-     *
-     * Создает новый экземпляр Url.
-     * @param url URL string or standard URL object / строка URL или стандартный объект URL
-     */
-    constructor(url?: string | URL);
-    /** Full URL string / Полная строка URL */
-    get href(): string;
-    /** Protocol including trailing colon / Протокол, включая ведущее двоеточие */
-    get protocol(): string;
-    /** Username / Имя пользователя */
-    get username(): string;
-    /** Password / Пароль */
-    get password(): string;
-    /** Host (hostname and port) / Хост (имя хоста и порт) */
-    get host(): string;
-    /** Hostname (excluding port) / Имя хоста (без порта) */
-    get hostname(): string;
-    /** Port / Порт */
-    get port(): string;
-    /** Path name / Путь к ресурсу */
-    get pathname(): string;
-    /** Search string including leading question mark / Строка запроса, включая ведущий вопросительный знак */
-    get search(): string;
-    /** Readonly search params object / Объекты параметров поиска только для чтения */
-    get searchParams(): URLSearchParams;
-    /** Hash string including leading hash sign / Хеш-строка, включая ведущий знак решетки */
-    get hash(): string;
-    /** Origin of the URL (readonly) / Источник URL (только для чтения) */
-    get origin(): string;
-    /**
-     * Checks if the specified query parameter exists.
-     *
-     * Проверяет, существует ли указанный параметр запроса.
-     * @param name parameter name / имя параметра
-     * @returns check result / результат проверки
-     */
-    hasParam(name: string): boolean;
-    /**
-     * Returns the value of a query parameter.
-     *
-     * Возвращает значение параметра запроса.
-     * @param name parameter name / имя параметра
-     * @returns parameter value or undefined if not found / значение параметра или undefined, если не найдено
-     */
-    getParam(name: string): string | undefined;
-    /**
-     * Returns all query parameters as an object with transformed types.
-     *
-     * Возвращает все параметры запроса в виде объекта с преобразованными типами.
-     * @returns Record<string, any> object of parameters / объект параметров
-     */
-    getParams(): Record<string, any>;
-    /**
-     * Updates the URL value.
-     *
-     * Обновляет значение URL.
-     * @param url URL string or standard URL object / строка URL или стандартный объект URL
-     * @returns this Url instance / текущий экземпляр Url
-     */
-    set(url?: string | URL): this;
-    /**
-     * Sets the value of a query parameter.
-     *
-     * Устанавливает значение параметра запроса.
-     * @param name parameter name / имя параметра
-     * @param value parameter value / значение параметра
-     * @returns this UrlItem instance / текущий экземпляр UrlItem
-     */
-    setParam(name: string, value: string): this;
-    /**
-     * Replaces all query parameters with the specified object.
-     *
-     * Заменяет все параметры запроса на указанный объект.
-     * @param params parameters to set / параметры для установки
-     * @returns this UrlItem instance / текущий экземпляр UrlItem
-     */
-    setParams(params: Record<string, any>): this;
-    /**
-     * Deletes a query parameter.
-     *
-     * Удаляет параметр запроса.
-     * @param name parameter name / имя параметра
-     * @returns this UrlItem instance / текущий экземпляр UrlItem
-     */
-    deleteParam(name: string): this;
-    /**
-     * Converts the Url instance to its string representation.
-     *
-     * Преобразует экземпляр Url в его строковое представление.
-     * @returns full URL string / полная строка URL
-     */
-    toString(): string;
-    /**
-     * Converts the Url instance to JSON string representation.
-     *
-     * Преобразует экземпляр Url в строковое представление JSON.
-     * @returns full URL string / полная строка URL
-     */
-    toJSON(): string;
-}

package/dist/functions/addTagHighlightMatch.d.ts

@@ -1,11 +0,0 @@
-/**
- * Adds a tag to highlight the match in the string.
- *
- * Добавляет тег для выделения совпадения в строке.
- * @param value initial string / исходная строка
- * @param search search string or RegExp / строка поиска или регулярное выражение
- * @param className highlighting class / класс выделения
- * @param shouldEscape should escape the string / нужно ли экранировать строку
- * @returns string with highlighting / строка с выделением
- */
-export declare function addTagHighlightMatch(value: string, search?: string | RegExp, className?: string, shouldEscape?: boolean): string;

package/dist/functions/anyToString.d.ts

@@ -1,10 +0,0 @@
-/**
- * Conversion of a value to a string.
- *
- * Преобразование значения в строку.
- * @param value values for conversion / значения для преобразования
- * @param isArrayString if true, then arrays will be converted to strings / если true, то массивы будут преобразованы в строки
- * @param trim if true, then the resulting string will be trimmed / если true, то результирующая строка будет обрезана
- * @returns string representation of the passed value / строковое представление переданного значения
- */
-export declare function anyToString<V>(value: V, isArrayString?: boolean, trim?: boolean): string;

package/dist/functions/applyTemplate.d.ts

@@ -1,10 +0,0 @@
-/**
- * Applies a template to the text, replacing keys with values from the replacement object
- *
- * Применяет шаблон к тексту, заменяя ключи на значения из объекта замены
- * @param text text with a template containing keys in square or curly brackets, for example "[key]" or "{key}"/
- * текст с шаблоном, содержащим ключи в квадратных или фигурных скобках, например "[key]" или "{key}"
- * @param replacement an object containing key-value pairs for replacement/
- * объект, содержащий пары ключ-значение для замены
- */
-export declare const applyTemplate: (text: string, replacement?: Record<string, string | number | boolean> | string[]) => string;

package/dist/functions/arrFill.d.ts

@@ -1,9 +0,0 @@
-/**
- * The method creates an array of "count" elements with values equal to `value`.
- *
- * Метод создает массив из "count" элементов со значениями равными `value`.
- * @param value value to fill the array with / значение, заполняющее массив
- * @param count the number of elements in that array / число элементов этого массива
- * @returns created array / созданный массив
- */
-export declare function arrFill<T>(value: T, count: number): T[];