@dxtmisha/functional-basic 1.1.0 → 1.1.6

package/dist/classes/TranslateFile.d.ts

@@ -0,0 +1,81 @@
+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

@@ -0,0 +1,206 @@
+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/functions/addTagHighlightMatch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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

@@ -0,0 +1,10 @@
+/**
+ * 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

@@ -0,0 +1,10 @@
+/**
+ * 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

@@ -0,0 +1,9 @@
+/**
+ * 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[];

package/dist/functions/blobToBase64.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert a Blob to a Base64 string.
+ *
+ * Преобразует Blob в строку Base64.
+ * @param blob The Blob to convert / Blob для преобразования
+ * @param clean if true, removes the data URL prefix / если true, удаляет префикс data URL
+ * @returns promise with the base64 string or undefined / промис со строкой base64 или undefined
+ */
+export declare function blobToBase64(blob: Blob, clean?: boolean): Promise<string | undefined>;

package/dist/functions/capitalize.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Capitalizes the first letter of a string.
+ *
+ * Делает первую букву строки заглавной.
+ * @param value string to capitalize / строка для капитализации
+ * @param isLocale use locale / использовать локаль
+ * @returns capitalized string / капитализированная строка
+ */
+export declare function capitalize(value: string, isLocale?: boolean): string;

package/dist/functions/copyObject.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Creates a deep copy of an object for independent data management.
+ * The goal of the method is to get a completely new separate instance of the object to avoid unwanted mutations.
+ *
+ * Создает глубокую копию объекта для независимого управления данными.
+ * Цель метода — получить полностью новый отдельный экземпляр объекта во избежание нежелательных мутаций.
+ * @param value object for copying / объект для копирования
+ * @returns returns a new copy of the object / возвращает новую копию объекта
+ */
+export declare function copyObject<T>(value: T): T;

package/dist/functions/copyObjectLite.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copies a simple object.
+ *
+ * Копирует простой объект.
+ * @param value object for copying / объект для копирования
+ * @param source additional properties for copying / дополнительные свойства для копирования
+ * @returns returns a new copy of the object / возвращает новую копию объекта
+ */
+export declare function copyObjectLite<T, R = T>(value: T, source?: any): R;

package/dist/functions/createElement.d.ts

@@ -0,0 +1,21 @@
+/**
+ * In HTML documents, creates an element with the tag that is specified in the argument.
+ *
+ * В HTML-документах создаёт элемент с тегом, который указан в аргументе.
+ *
+ * @param parentElement the DOM node's parent Element / родитель для нового элемента
+ * @param tagName a string that specifies the type of element to be created / строка, указывающая элемент какого типа должен быть создан
+ * @param options an object with attributes or a function for processing an element / объект с атрибутами или функция для обработки элемента
+ * @param referenceElement the node before which newNode is inserted / элемент, перед которым будет вставлен newElement
+ * @returns created element, or undefined in SSR / созданный элемент или undefined при SSR
+ *
+ * @remarks
+ * When running on the server, the function always returns `undefined`.
+ * If you use it within a component's rendering logic, it may lead to hydration mismatches.
+ * It is recommended to call this function only inside lifecycle hooks that run exclusively on the client (e.g., `onMounted` in Vue or `useEffect` in React).
+ *
+ * При выполнении на сервере функция всегда возвращает `undefined`.
+ * Если вы используете её внутри логики рендеринга компонента, это может привести к ошибкам гидратации.
+ * Рекомендуется вызывать эту функцию только в хуках жизненного цикла, которые выполняются на клиенте (например, `onMounted` в Vue или `useEffect` в React).
+ */
+export declare function createElement<T extends HTMLElement>(parentElement?: HTMLElement, tagName?: string, options?: Partial<T> | Record<keyof T, T[keyof T]> | ((element: T) => void), referenceElement?: HTMLElement): T | undefined;

package/dist/functions/domQuerySelector.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Selects the first element that matches the specified selectors.
+ *
+ * Выбирает первый элемент, который соответствует указанным селекторам.
+ * @param selectors selectors / селекторы
+ * @returns first matched element or undefined / первый найденный элемент или undefined
+ */
+export declare function domQuerySelector<E extends Element = Element>(selectors: string): E | undefined;

package/dist/functions/domQuerySelectorAll.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Selects all elements that match the specified selectors.
+ *
+ * Выбирает все элементы, которые соответствуют указанным селекторам.
+ * @param selectors selectors / селекторы
+ * @returns list of matched elements or undefined / список найденных элементов или undefined
+ */
+export declare function domQuerySelectorAll<E extends Element = Element>(selectors: string): NodeListOf<E> | undefined;

package/dist/functions/encodeAttribute.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Encodes special characters in a string for safe use in HTML attributes.
+ *
+ * Кодирует специальные символы в строке для безопасного использования в HTML-атрибутах.
+ * @param text text to encode / текст для кодирования
+ * @returns encoded text / закодированный текст
+ */
+export declare function encodeAttribute(text: string): string;

package/dist/functions/encodeLiteAttribute.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Encodes special characters in a string for safe use in HTML attributes.
+ *
+ * Кодирует специальные символы в строке для безопасного использования в HTML-атрибутах.
+ * @param text text to encode / текст для кодирования
+ * @returns encoded text / закодированный текст
+ */
+export declare function encodeLiteAttribute(text: string): string;

package/dist/functions/ensureMaxSize.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Ensures that an image does not exceed the maximum size by resizing it if needed.
+ *
+ * Гарантирует, что изображение не превышает максимальный размер, изменяя его размер при необходимости.
+ * @param file image file as Uint8Array / файл изображения в виде Uint8Array
+ * @param compress maximum size as a fraction of the original size / максимальный размер в виде доли от оригинального размера
+ * @param type image type / тип изображения
+ * @returns promise with the resized image data as base64 / промис с данными измененного изображения в формате base64
+ */
+export declare function ensureMaxSize(file: Uint8Array, compress?: number, type?: string): Promise<string>;

package/dist/functions/escapeExp.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Escapes special regex characters in a string so it can be used safely in a RegExp.
+ *
+ * Экранирует специальные символы регулярного выражения в строке, чтобы её можно было безопасно использовать в RegExp.
+ * @param value string to escape / строка для экранирования
+ */
+export declare function escapeExp(value: string): string;

package/dist/functions/eventStopPropagation.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Stop listening to events in depth.
+ *
+ * Остановить прослушивания события в глубину.
+ * @param event event instance/ экземпляр события
+ */
+export declare function eventStopPropagation(event: Event): void;

package/dist/functions/executeFunction.d.ts

@@ -0,0 +1,12 @@
+import { FunctionArgs } from '../types/basicTypes';
+/**
+ * Flexible utility that executes the provided argument if it is a function, otherwise returns it as is.
+ * Supports passing arbitrary arguments to the callback.
+ *
+ * Универсальная утилита, которая выполняет переданный аргумент, если он является функцией, иначе возвращает его без изменений.
+ * Поддерживает передачу произвольных аргументов в функцию обратного вызова.
+ * @param callback function or any value / функция или любое значение
+ * @param args arguments of the function / аргументы функции
+ * @returns result of the execution or the value itself / результат выполнения или само значение
+ */
+export declare function executeFunction<T>(callback: T | FunctionArgs<any, T>, ...args: any[]): T;

package/dist/functions/executePromise.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Safely executes a function and awaits its result if it returns a Promise.
+ * If the provided value is a static value or a synchronous function, it returns the result immediately wrapped in a Promise.
+ *
+ * Безопасно выполняет функцию и ожидает её результат, если она возвращает Promise.
+ * Если переданное значение является статическим или синхронной функцией, возвращает результат немедленно, обернутым в Promise.
+ * @param callback function, Promise or any value / функция, Promise или любое значение
+ * @param args arguments of the function / аргументы функции
+ * @returns promise resolving to the execution result / промис, разрешающийся результатом выполнения
+ */
+export declare function executePromise<T>(callback: ((...args: any[]) => Promise<T>) | ((...args: any[]) => T) | T, ...args: any[]): Promise<T>;

package/dist/functions/forEach.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The function performs the specified function once for each element in the object
+ * and returns an array with the results of executing the function.
+ *
+ * Функция выполняет указанную функцию один раз для каждого элемента в объекте
+ * и возвращает массив с результатами выполнения функции.
+ * @param data object for iteration / объект для перебора
+ * @param callback a function to execute for each element in the array /
+ * функция, которая будет вызвана для каждого элемента
+ * @param saveUndefined if true, the function will return an array with undefined values /
+ * если true, функция вернет массив с undefined значениями
+ * @returns returns an array with the results of executing the function / возвращает массив с результатами выполнения функции
+ */
+export declare function forEach<T, R, D extends T[] | Record<string, T> | Map<string, T> | Set<T> = T[] | Record<string, T> | Map<string, T> | Set<T>, K = D extends T[] ? number : string>(data: D & (T[] | Record<string, T> | Map<string, T> | Set<T>), callback: (item: T, key: K, dataMain: typeof data) => R, saveUndefined?: boolean): R[];

package/dist/functions/frame.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cyclically calls requestAnimationFrame until next returns true.
+ *
+ * Циклически вызывает requestAnimationFrame, пока next возвращает true.
+ * @param callback the function to call when it's time to update your animation / функция, которая будет вызвана, когда придёт время обновить вашу анимацию
+ * @param next function that determines repetition / функция, которая определяет повторность
+ * @param end function that is executed if the animation stops / функция, которая выполняется, если останавливается анимация
+ * @returns animation ID or undefined / ID анимации или undefined
+ */
+export declare function frame(callback: () => void, next?: () => boolean, end?: () => void): void;

package/dist/functions/getArrayHighlightMatch.d.ts

@@ -0,0 +1,10 @@
+import { HighlightMatchItem } from '../types/searchTypes';
+/**
+ * Split a string into an array of objects to highlight matches.
+ *
+ * Разделяет строку на массив объектов для выделения совпадений.
+ * @param value initial string / исходная строка
+ * @param search search string / строка поиска
+ * @returns array of objects with text and match flag / массив объектов с текстом и флагом совпадения
+ */
+export declare function getArrayHighlightMatch(value: string, search?: string | RegExp): HighlightMatchItem[];

package/dist/functions/getAttributes.d.ts

@@ -0,0 +1,9 @@
+import { ElementOrString, ElementOrWindow } from '../types/basicTypes';
+/**
+ * Gets a list of attributes of an element.
+ *
+ * Получает список атрибутов у элемента.
+ * @param element selectors for matching or an Element / селекторов для сопоставления или Element
+ * @returns list of attributes / список атрибутов
+ */
+export declare function getAttributes<E extends ElementOrWindow>(element?: ElementOrString<E>): Record<string, string | undefined>;

package/dist/functions/getClipboardData.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The method retrieves drag data (as a string) for the specified type.
+ * If the drag operation does not include data, this method returns an empty string.
+ *
+ * Метод извлекает данные перетаскивания (в виде строки) для указанного типа.
+ * @param event the ClipboardEvent interface / интерфейс ClipboardEvent
+ * @returns data from the clipboard / данные из буфера обмена
+ */
+export declare function getClipboardData(event?: ClipboardEvent): Promise<string>;

package/dist/functions/getColumn.d.ts

@@ -0,0 +1,10 @@
+import { ObjectOrArray } from '../types/basicTypes';
+/**
+ * Returns an array of values for a specific column in the input array.
+ *
+ * Возвращает массив значений для определенного столбца входного массива.
+ * @param array a multi-dimensional array or an array of objects / многомерный массив или массив объектов
+ * @param column the column of values to return / ключ столбца, значения которого нужно вернуть
+ * @returns list of values for the column / список значений для столбца
+ */
+export declare function getColumn<T, K extends keyof T>(array: ObjectOrArray<T>, column: K): (T[K] | undefined)[];

package/dist/functions/getCurrentDate.d.ts

@@ -0,0 +1,19 @@
+import { GeoDate } from '../types/geoTypes';
+/**
+ * Returns the current date in the specified format.
+ *
+ * Возвращает текущую дату в указанном формате.
+ *
+ * @remarks
+ * Using this function for rendering in SSR may lead to hydration mismatches
+ * because the time or time zone on the server may differ from the time on the client.
+ * It is recommended to use this function inside client-side hooks only (e.g., `onMounted` in Vue or `useEffect` in React).
+ *
+ * Использование этой функции для отрисовки в SSR может привести к ошибкам гидратации,
+ * так как время или часовой пояс сервера могут отличаться от времени на стороне клиента.
+ * Рекомендуется использовать эту функцию только внутри хуков, выполняющихся на клиенте (например, `onMounted` в Vue или `useEffect` in React).
+ *
+ * @param format type of date format for output / тип формата даты вывода
+ * @returns formatted current date / текущая дата в указанном формате
+ */
+export declare function getCurrentDate(format?: GeoDate): string;

package/dist/functions/getCurrentTime.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Returns the current time in milliseconds.
+ *
+ * Возвращает текущее время в миллисекундах.
+ *
+ * @remarks
+ * **Warning (SSR):** Using this function for rendering in SSR will almost certainly lead to hydration mismatches
+ * because the timestamp on the server will differ from the timestamp on the client.
+ *
+ * **Внимание (SSR):** Использование этой функции для отрисовки в SSR практически наверняка приведет к ошибкам гидратации,
+ * так как временная метка (timestamp) сервера будет отличаться от метки на стороне клиента.
+ *
+ * @returns current time in milliseconds / текущее время в миллисекундах
+ */
+export declare function getCurrentTime(): number;

package/dist/functions/getElement.d.ts

@@ -0,0 +1,9 @@
+import { ElementOrString, ElementOrWindow } from '../types/basicTypes';
+/**
+ * Returns the first Element in the document that matches the specified selector or the element.
+ *
+ * Возвращает первый Element документа, который соответствует указанному селектору или сам элемент.
+ * @param element selectors for matching or an Element / селектор для сопоставления или Element
+ * @returns found element or undefined / найденный элемент или undefined
+ */
+export declare function getElement<E extends ElementOrWindow, R extends Exclude<E, Window>>(element?: ElementOrString<E>): R | undefined;