@dxtmisha/functional 1.3.0 → 1.6.4

package/dist/functions/isDomRuntime.d.ts

@@ -1,10 +0,0 @@
-/**
- * Проверяет, выполняется ли код в браузере, где доступен объект `window`.
- * Возвращает `true`, если `window` доступен, что означает, что код выполняется в браузере.
- *
- * Checks if the code is running in a browser where the `window` object is available.
- * Returns `true` if `window` is defined, indicating the code is running in a browser.
- *
- * @returns `true`, если выполняется в браузере, иначе `false`/ `true` if running in a browser, otherwise `false`
- */
-export declare function isDomRuntime(): boolean;

package/dist/functions/isFilled.d.ts

@@ -1,9 +0,0 @@
-import { EmptyValue } from '../types/basicTypes';
-/**
- * Checks if the field is filled.
- *
- * Проверяет, заполнено ли поле.
- * @param value input value/ входное значение
- * @param zeroTrue if true, '0' is considered filled/ если true, то '0' считается заполненным
- */
-export declare function isFilled<T>(value: T, zeroTrue?: boolean): value is Exclude<T, EmptyValue>;

package/dist/functions/isFloat.d.ts

@@ -1,7 +0,0 @@
-/**
- * Checks if the value is an integer or a floating-point number.
- *
- * Проверяет, является ли значение числом или дробным числом.
- * @param value values for checking/ значения для проверки
- */
-export declare function isFloat(value: any): boolean;

package/dist/functions/isFunction.d.ts

@@ -1,8 +0,0 @@
-import { FunctionArgs } from '../types/basicTypes';
-/**
- * Checks if the function is a callback function.
- *
- * Проверяет, является ли функция обратного вызова.
- * @param callback the value being checked/ проверяемое значение
- */
-export declare function isFunction<T>(callback: T): callback is Extract<T, FunctionArgs<any, any>>;

package/dist/functions/isInDom.d.ts

@@ -1,8 +0,0 @@
-import { ElementOrString, ElementOrWindow } from '../types/basicTypes';
-/**
- * Checks if an element is still in the DOM tree.
- *
- * Проверяет, находится ли еще элемент в дереве DOM.
- * @param element selectors for matching or an Element/ селекторов для сопоставления или Element
- */
-export declare function isInDom<E extends ElementOrWindow>(element?: ElementOrString<E>): boolean;

package/dist/functions/isIntegerBetween.d.ts

@@ -1,8 +0,0 @@
-/**
- * Checks if the value is between integers.
- *
- * Проверяет, лежит ли значение между целыми числами.
- * @param value input value/ входное значение
- * @param between value for rounding/ значение для округления
- */
-export declare function isIntegerBetween(value: number, between: number): boolean;

package/dist/functions/isNull.d.ts

@@ -1,8 +0,0 @@
-import { Undefined } from '../types/basicTypes';
-/**
- * Is the variable equal to null or undefined.
- *
- * Является ли переменная равной null или undefined.
- * @param value input value/ входное значение
- */
-export declare function isNull<T>(value: T): value is Extract<T, Undefined>;

package/dist/functions/isNumber.d.ts

@@ -1,7 +0,0 @@
-/**
- * Checks if the value is a number.
- *
- * Проверяет, является ли значение числом.
- * @param value values for checking/ значения для проверки
- */
-export declare function isNumber(value: any): boolean;

package/dist/functions/isObject.d.ts

@@ -1,7 +0,0 @@
-/**
- * Checks if a value is an object.
- *
- * Проверяет, является ли значение объектом.
- * @param value input value/ входное значение
- */
-export declare function isObject<T>(value: T): value is Extract<T, Record<any, any>>;

package/dist/functions/isObjectNotArray.d.ts

@@ -1,7 +0,0 @@
-/**
- * Checks if the value is an object or not an array.
- *
- * Проверяет, является ли значение объектом и не является массивом.
- * @param value input value/ входное значение
- */
-export declare function isObjectNotArray<T>(value: T): value is Exclude<Extract<T, Record<any, any>>, any[] | undefined | null>;

package/dist/functions/isSelected.d.ts

@@ -1,8 +0,0 @@
-/**
- * Checks if value is in the array selected or if value equals selected, if selected is a string.
- *
- * Проверяет, есть ли value в массиве selected или равен ли value selected, если selected - строка.
- * @param value input value/ входное значение
- * @param selected array or string for comparison/ массив или строка для сравнения
- */
-export declare function isSelected<T, S>(value: T, selected: T | T[] | S): boolean;

package/dist/functions/isSelectedByList.d.ts

@@ -1,8 +0,0 @@
-/**
- * Testing isSelected property for the entire list of values.
- *
- * Проверка свойства isSelected для всех значений списка.
- * @param values list of values for comparison/ список значений для сравнения
- * @param selected array or string for comparison/ массив или строка для сравнения
- */
-export declare function isSelectedByList<T>(values: T | T[], selected: T | T[]): boolean;

package/dist/functions/isString.d.ts

@@ -1,7 +0,0 @@
-/**
- * Checks if the value is of type string.
- *
- * Проверяет, является ли значение типом строки.
- * @param value input value/ входное значение
- */
-export declare function isString<T>(value: T): value is Extract<T, string>;

package/dist/functions/isWindow.d.ts

@@ -1,7 +0,0 @@
-/**
- * Checks if object is Window.
- *
- * Проверяет, является ли объект Window.
- * @param element selectors for matching or an Element/ селекторов для сопоставления или Element
- */
-export declare function isWindow<E>(element: E): element is Extract<E, Window>;

package/dist/functions/random.d.ts

@@ -1,8 +0,0 @@
-/**
- * Generate a random integer.
- *
- * Генерирует случайное число.
- * @param min the lowest value to return/ наименьшее значение
- * @param max the highest value to return/ наибольшее значение
- */
-export declare function random(min: number, max: number): number;

package/dist/functions/replaceRecursive.d.ts

@@ -1,10 +0,0 @@
-import { ObjectItem, ObjectOrArray } from '../types/basicTypes';
-/**
- * Merge one or more arrays recursively.
- *
- * Рекурсивное слияние одного или более массивов.
- * @param array the array in which elements are replaced/ массив, элементы которого будут заменены
- * @param replacement arrays from which elements will be extracted/ массивы, из которых будут браться элементы для замены
- * @param isMerge merge one or more arrays/ сливает один или большее количество массивов
- */
-export declare function replaceRecursive<I>(array: ObjectItem<I>, replacement?: ObjectOrArray<I>, isMerge?: boolean): ObjectItem<I>;

package/dist/functions/replaceTemplate.d.ts

@@ -1,9 +0,0 @@
-import { FunctionReturn } from '../types/basicTypes';
-/**
- * Replacing the value from replaces in value.
- *
- * Замена значения из replaces в value.
- * @param value template string/ строка шаблона
- * @param replaces object with data for replacement/ объект с данными для замены
- */
-export declare function replaceTemplate(value: string, replaces: Record<string, string | FunctionReturn<string>>): string;

package/dist/functions/secondToTime.d.ts

@@ -1,7 +0,0 @@
-/**
- * Converts seconds into a time string.
- *
- * Преобразовывает секунды в строку с временем.
- * @param second specified seconds/ указанные секунды
- */
-export declare function secondToTime(second: number | string | undefined): string;

package/dist/functions/setElementItem.d.ts

@@ -1,10 +0,0 @@
-import { ElementOrString, ElementOrWindow } from '../types/basicTypes';
-/**
- * Modifies the value of an element identified by its key.
- *
- * Изменяет значение элемента, определенного ключом.
- * @param element checked element/ проверяемый элемент
- * @param index index at which we retrieve values/ индекс, по которому получаем значения
- * @param value new value/ новое значение
- */
-export declare function setElementItem<E extends ElementOrWindow, K extends keyof E, V extends E[K] = E[K]>(element: ElementOrString<E>, index: K, value: V | Record<string, V>): E | undefined;

package/dist/functions/setValues.d.ts

@@ -1,17 +0,0 @@
-/**
- * Modifies data according to its type and settings.
- *
- * Изменяет данные в соответствии с их типом и настройками.
- * @param selected base values/ базовые значения
- * @param value new values/ новые значения
- * @param multiple support for multiple values/ поддержка нескольких значений
- * @param maxlength maximum values/ максимальные значения
- * @param alwaysChange updating values in any case/ обновление значений при любом случае
- * @param notEmpty do not make the values empty/ не делать значения пустыми
- */
-export declare function setValues<T>(selected: T | T[] | undefined, value: any, { multiple, maxlength, alwaysChange, notEmpty }: {
-    multiple?: boolean | undefined;
-    maxlength?: number | undefined;
-    alwaysChange?: boolean | undefined;
-    notEmpty?: boolean | undefined;
-}): T | T[] | undefined;

package/dist/functions/splice.d.ts

@@ -1,12 +0,0 @@
-import { ObjectItem } from '../types/basicTypes';
-/**
- * This method is used to copy the values of all enumerable own properties from one source object to a target object.
- * In priority according to the processing list.
- *
- * Метод используется для копирования значений всех перечисляемых свойств одного объекта в другой.
- * В приоритете по списку обработки.
- * @param array the target object/ целевой объект
- * @param replacement the source object/ исходные объекты
- * @param indexStart index at which to start changing the array/ индекс, по которому начинает изменять массив
- */
-export declare function splice<I>(array: ObjectItem<I>, replacement?: ObjectItem<I> | I, indexStart?: string): ObjectItem<I>;

package/dist/functions/strFill.d.ts

@@ -1,8 +0,0 @@
-/**
- * The method creates a string of length count, consisting of the characters value.
- *
- * Метод создает строку длиной count, состоящую из символов value.
- * @param value character for filling/ символ для заполнения
- * @param count length of the string/ длина строки
- */
-export declare function strFill(value: string, count: number): string;

package/dist/functions/toArray.d.ts

@@ -1,17 +0,0 @@
-/**
- * Преобразует значение в массив.
- * Если переданное значение уже является массивом, возвращается оно само.
- * В противном случае значение оборачивается в массив.
- *
- * Converts a value to an array.
- * If the value is already an array, it returns it as is.
- * Otherwise, it wraps the value in an array.
- *
- * @param value - Значение, которое необходимо преобразовать в массив.
- *
- * The value to be converted into an array.
- * @returns Массив, содержащий переданное значение.
- *
- * An array containing the provided value.
- */
-export declare function toArray<T>(value: T): T extends any[] ? T : [T];

package/dist/functions/toCamelCase.d.ts

@@ -1,7 +0,0 @@
-/**
- * Convert a String to Camel Case (upper).
- *
- * Преобразование строки в Camel Case (upper).
- * @param value input value/ входное значение
- */
-export declare function toCamelCase(value: string): string;

package/dist/functions/toCamelCaseFirst.d.ts

@@ -1,7 +0,0 @@
-/**
- * Convert a String to Camel Case (+ first letter).
- *
- * Преобразование строки в Camel Case (+ первая буква).
- * @param value input value/ входное значение
- */
-export declare function toCamelCaseFirst(value: string): string;

package/dist/functions/toDate.d.ts

@@ -1,7 +0,0 @@
-/**
- * Conversion to Date object.
- *
- * Преобразование в объект Date.
- * @param value input value/ входное значение
- */
-export declare function toDate<T extends Date | number | string>(value?: T): (T & Date) | Date;

package/dist/functions/toKebabCase.d.ts

@@ -1,15 +0,0 @@
-/**
- * Преобразует строку в формат kebab-case.
- * Преобразует все заглавные буквы в строчные, заменяет пробелы и другие символы на дефисы.
- *
- * Converts a string to kebab-case.
- * It converts uppercase letters to lowercase, replaces spaces and other characters with dashes.
- *
- * @param value - Строка, которую необходимо преобразовать.
- *
- * The string to be converted.
- * @returns Строка в формате kebab-case.
- *
- * The string in kebab-case format.
- */
-export declare function toKebabCase(value: string): string;

package/dist/functions/toNumber.d.ts

@@ -1,8 +0,0 @@
-import { NumberOrString } from '../types/basicTypes';
-/**
- * The method parses a string argument and returns a floating point number.
- *
- * Метод принимает строку в качестве аргумента и возвращает десятичное число
- * @param value input value/ входное значение
- */
-export declare function toNumber<T extends NumberOrString>(value?: T): (T & number) | number;

package/dist/functions/toNumberByMax.d.ts

@@ -1,9 +0,0 @@
-/**
- * Converts the data into a number, taking into account the maximum permissible value.<br>
- * Преобразует данные в число с учетом максимально допустимого значения.
- * @param value input value /<br>входное значение
- * @param max maximum achievable value /<br>максимально достижимое значение
- * @param formatting format the number /<br>форматировать число
- * @param language formatting language /<br>язык форматирования
- */
-export declare function toNumberByMax(value: string | number, max?: string | number, formatting?: boolean, language?: string): string | number;

package/dist/functions/toPercent.d.ts

@@ -1,8 +0,0 @@
-/**
- * Converts values to percentages
- *
- * Преобразует значения в проценты
- * @param maxValue maximum value/ максимальное значение
- * @param value current value/ текущее значение
- */
-export declare function toPercent(maxValue: number, value: number): number;

package/dist/functions/toPercentBy100.d.ts

@@ -1,8 +0,0 @@
-/**
- * Converts values to percentages (three-digit)
- *
- * Преобразует значения в проценты (трёхзначный)
- * @param maxValue maximum value/ максимальное значение
- * @param value current value/ текущее значение
- */
-export declare function toPercentBy100(maxValue: number, value: number): number;

package/dist/functions/transformation.d.ts

@@ -1,21 +0,0 @@
-/**
- * Преобразует строку в соответствующий тип данных.
- * В зависимости от содержания строки, она может быть преобразована в
- * `undefined`, `null`, `true`, `false`, объект, число или функцию.
- *
- * Transforms a string into the corresponding data type.
- * Based on the string content, it may be transformed into `undefined`,
- * `null`, `true`, `false`, object, number, or function.
- *
- * @param value - Значение, которое необходимо преобразовать
- *
- * The value to be transformed
- * @param isFunction - Флаг, который указывает, необходимо ли проверять функцию
- * в глобальном объекте window
- *
- * A flag that indicates whether to check for a function in the global window object
- * @returns Преобразованное значение
- *
- * The transformed value
- */
-export declare function transformation(value: any, isFunction?: boolean): any;

package/dist/functions/uniqueArray.d.ts

@@ -1,7 +0,0 @@
-/**
- * Removes duplicate entries in an array.
- *
- * Удаляет повторяющиеся записи в массиве.
- * @param value input value/ входное значение
- */
-export declare function uniqueArray<T>(value: T[]): T[];

package/dist/functions/writeClipboardData.d.ts

@@ -1,7 +0,0 @@
-/**
- * Writes data to the buffer.
- *
- * Записывает данные в буфер.
- * @param text text for recording/ текст для записи
- */
-export declare function writeClipboardData(text: string): Promise<void>;

package/dist/types/basicTypes.d.ts

@@ -1,126 +0,0 @@
-/** Union type for undefined and null values/ Объединенный тип для undefined и null значений */
-export type Undefined = undefined | null;
-/**
- * Union type for all "empty" values including falsy primitives and string representations/
- * Объединенный тип для всех "пустых" значений включая ложные примитивы и строковые представления
- */
-export type EmptyValue = Undefined | 0 | false | '' | 'undefined' | 'null' | '0' | 'false' | '[]';
-/** Union type for numeric and string values/ Объединенный тип для числовых и строковых значений */
-export type NumberOrString = number | string;
-/**
- * Union type for numeric, string, and boolean values/
- * Объединенный тип для числовых, строковых и булевых значений
- */
-export type NumberOrStringOrBoolean = number | string | boolean;
-/**
- * Union type for numeric, string, and Date values/
- * Объединенный тип для числовых, строковых значений и Date
- */
-export type NumberOrStringOrDate = NumberOrString | Date;
-/**
- * Generic type that can be either a single value or an array of values/
- * Дженерик тип для одиночного значения или массива значений
- */
-export type NormalOrArray<T = NumberOrString> = T | T[];
-/**
- * Generic type that can be either a direct value or a Promise resolving to that value/
- * Дженерик тип для прямого значения или Promise
- */
-export type NormalOrPromise<T> = T | Promise<T>;
-/**
- * Generic record/object type with string keys/
- * Дженерик тип записи/объекта со строковыми ключами
- */
-export type ObjectItem<T = any> = Record<string, T>;
-/** Generic type that can be either an array or an object/ Дженерик тип для массива или объекта */
-export type ObjectOrArray<T = any> = T[] | ObjectItem<T>;
-/**
- * Function type that returns a value of type R/
- * Тип функции, возвращающей значение типа R
- */
-export type FunctionReturn<R = any> = () => R;
-/** Function type that returns void/ Тип функции, возвращающей void */
-export type FunctionVoid = () => void;
-/**
- * Function type that accepts multiple arguments of type T and returns type R/
- * Тип функции с переменными аргументами
- */
-export type FunctionArgs<T, R> = (...args: T[]) => R;
-/**
- * Most generic function type that accepts any arguments and returns any value/
- * Наиболее общий тип функции
- */
-export type FunctionAnyType<T = any, R = any> = (...args: T[]) => R;
-/**
- * Generic record type for lists with string keys/
- * Дженерик тип записи для списков со строковыми ключами
- */
-export type ItemList<T = any> = Record<string, T>;
-/**
- * Generic item type with index and value properties/
- * Дженерик тип элемента со свойствами index и value
- */
-export type Item<V> = {
-    /** Unique string identifier for the item/ Уникальный строковый идентификатор элемента */
-    index: string;
-    /** The actual value of the item/ Фактическое значение элемента */
-    value: V;
-};
-/**
- * Generic item type with label and value properties/
- * Дженерик тип элемента со свойствами label и value
- */
-export type ItemValue<V> = {
-    /** Display text for the item/ Отображаемый текст для элемента */
-    label: string;
-    /** The actual value of the item/ Фактическое значение элемента */
-    value: V;
-};
-/**
- * Generic item type with name and value properties/
- * Дженерик тип элемента со свойствами name и value
- */
-export type ItemName<V> = {
-    /** Name identifier (string or number)/ Идентификатор имени (строка или число) */
-    name: string | number;
-    /** The actual value of the item/ Фактическое значение элемента */
-    value: V;
-};
-/**
- * Union type for HTML elements and Window object/
- * Объединенный тип для HTML элементов и объекта Window
- */
-export type ElementOrWindow = HTMLElement | Window;
-/**
- * Generic type that can be either an element or a string selector/
- * Дженерик тип для элемента или строкового селектора
- */
-export type ElementOrString<E extends ElementOrWindow> = E | string;
-/** Type for event listener options/ Тип для опций обработчика событий */
-export type EventOptions = AddEventListenerOptions | boolean | undefined;
-/**
- * Generic event listener function type with additional detail parameter/
- * Дженерик тип функции обработчика событий с дополнительным параметром detail
- */
-export type EventListenerDetail<O extends Event, D extends Record<string, any>> = (event: O, detail?: D) => void;
-/**
- * Type for tracking active event listeners and observers/
- * Тип для отслеживания активных обработчиков событий и наблюдателей
- */
-export type EventActivityItem<E extends ElementOrWindow> = {
-    /** The target element for the event/ Целевой элемент для события */
-    element: E | undefined;
-    /** The event type name/ Название типа события */
-    type: string;
-    /** Optional custom event listener/ Опциональный пользовательский обработчик событий */
-    listener?: (event: any | Event) => void;
-    /** Optional ResizeObserver instance/ Опциональный экземпляр ResizeObserver */
-    observer?: ResizeObserver;
-};
-/** Type for 2D coordinates/ Тип для 2D координат */
-export type ImageCoordinator = {
-    /** X-axis coordinate/ Координата по оси X */
-    x: number;
-    /** Y-axis coordinate/ Координата по оси Y */
-    y: number;
-};

package/dist/types/geoTypes.d.ts

@@ -1,86 +0,0 @@
-/**
- * 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=суббота) */
-export type GeoFirstDay = 1 | 6 | 0;
-/** Hour format type (12-hour or 24-hour)/ Тип формата часов (12-часовой или 24-часовой) */
-export type GeoHours = '12' | '24';
-/** Timezone display style options/ Опции стиля отображения часового пояса */
-export type GeoTimeZoneStyle = 'minute' | 'hour' | 'ISO8601' | 'RFC';
-/** Geographic item interface for country and language data/ Интерфейс географического элемента для данных страны и языка */
-export interface GeoItem {
-    /** Country code/ Код страны */
-    country: string;
-    /** Alternative country codes/ Альтернативные коды стран */
-    countryAlternative?: string[];
-    /** Language code/ Код языка */
-    language: string;
-    /** Alternative language codes/ Альтернативные коды языков */
-    languageAlternative?: string[];
-    /** First day of week/ Первый день недели */
-    firstDay?: string | null;
-    /** Timezone/ Часовой пояс */
-    zone?: string | null;
-    /** Phone country code/ Телефонный код страны */
-    phoneCode?: string;
-    /** Phone code for domestic calls/ Телефонный код для внутренних звонков */
-    phoneWithin?: string;
-    /** Phone number mask/ Маска телефонного номера */
-    phoneMask?: string | string[];
-    /** Name format pattern/ Шаблон формата имени */
-    nameFormat?: 'fl' | 'fsl' | 'lf' | 'lsf' | string;
-}
-/** Extended geographic item with required fields/ Расширенный географический элемент с обязательными полями */
-export interface GeoItemFull extends Omit<GeoItem, 'firstDay'> {
-    /** Standard locale code/ Стандартный код локали */
-    standard: string;
-    /** First day of week (required)/ Первый день недели (обязательный) */
-    firstDay: string;
-}
-/** Geographic flag item for country flag display/ Элемент географического флага для отображения флага страны */
-export interface GeoFlagItem {
-    /** Language name/ Название языка */
-    language: string;
-    /** Country name/ Название страны */
-    country: string;
-    /** Standard locale code/ Стандартный код локали */
-    standard: string;
-    /** Flag icon identifier/ Идентификатор иконки флага */
-    icon?: string;
-    /** Display label/ Отображаемая метка */
-    label: string;
-    /** Value for selection/ Значение для выбора */
-    value: string;
-}
-/**
- * Extended geographic flag item with national language information/
- * Расширенный элемент географического флага с информацией о национальном языке
- */
-export interface GeoFlagNational extends GeoFlagItem {
-    /** Description in national language/ Описание на национальном языке */
-    description: string;
-    /** Language name in national language/ Название языка на национальном языке */
-    nationalLanguage: string;
-    /** Country name in national language/ Название страны на национальном языке */
-    nationalCountry: string;
-}
-export interface GeoPhoneValue {
-    phone: number;
-    within: number;
-    mask: string[];
-    value: string;
-}
-export interface GeoPhoneMap {
-    items: GeoPhoneValue[];
-    info: GeoPhoneValue | undefined;
-    value: string | undefined;
-    mask: string[];
-    maskFull: string[];
-    next: Record<string, GeoPhoneMap>;
-}
-export interface GeoPhoneMapInfo {
-    item?: GeoPhoneMap;
-    phone?: string;
-}