@nemigo/helpers 0.13.3 → 1.5.2

package/dist/html.js

@@ -1,205 +0,0 @@
-import { useConditionGuard } from "./index.js";
-/**
- * `true`, если глобальный объект `window` отсутствует.
- */
-export const isSSR = typeof window === "undefined";
-//...
-/**
- * Предотвращает стандартное поведение события и останавливает его всплытие.
- */
-export const preventStop = (e) => (e.preventDefault(), e.stopPropagation());
-/**
- * Создаёт обработчик события с вызовом {@link preventStop}, если условие `usePreventStop` истинно.
- *
- * 1. Если `usePreventStop` → true (или функция вернёт true), то событие будет остановлено.
- * 2. Если `condition` → true (или функция вернёт true), то выполнится переданный коллбэк.
- *
- * @template T Тип события
- * @param call Коллбэк для вызова после проверки условия
- * @param usePreventStop Флаг или функция-условие для вызова {@link preventStop}
- * @param condition Флаг или функция-условие для вызова `call`
- * @returns Обработчик события
- */
-export const preventStopHook = (call, { usePreventStop = true, condition = true, } = {}) => (e) => {
-    if (useConditionGuard(usePreventStop, e))
-        preventStop(e);
-    if (useConditionGuard(condition, e))
-        call?.(e);
-};
-//...
-/**
- * Возвращает обработчик клавиатурных событий.
- *
- * Логика:
- * 1. Если `usePreventStop === "enter"` и нажата клавиша Enter → вызовется {@link preventStop}.
- * 2. Если `usePreventStop` — функция/флаг, и она вернёт true → вызовется {@link preventStop}.
- * 3. Если нажата Enter и `condition` → true, вызовется основной коллбэк.
- *
- * @template T Тип события клавиатуры
- * @param call - Основной коллбэк, вызываемый при Enter
- * @param onkeydown - Для иных клавиш вызывается всегда, кроме `"Enter`
- * @param usePreventStop - Условие для вызова {@link preventStop}
- * @param condition - Условие для вызова основного коллбэка
- */
-export const enterKeyHook = (call, { onkeydown, usePreventStop = "enter", condition = true, } = {}) => (e) => {
-    const isEnter = e.key === "Enter";
-    if (usePreventStop === "enter") {
-        if (isEnter)
-            preventStop(e);
-    }
-    else {
-        if (useConditionGuard(usePreventStop, e, isEnter))
-            preventStop(e);
-    }
-    if (isEnter) {
-        if (useConditionGuard(condition))
-            call?.(e);
-    }
-    else {
-        onkeydown?.(e);
-    }
-};
-/**
- * Проверяет, является ли событие клавиатурным.
- */
-export const isKeyboardEvent = (e) => !!e.code;
-//...
-/**
- * Создаёт обработчик контекстного меню.
- *
- * Если событие вызвано клавиатурой:
- *   — координаты берутся из `getBoundingClientRect` текущего элемента.
- * Если мышью:
- *   — координаты берутся из `clientX` / `clientY`.
- *
- * @param call Коллбэк, принимающий позицию и метаданные о событии
- */
-export const createCtxMenuHandler = (call) => preventStopHook((event) => {
-    if (isKeyboardEvent(event)) {
-        const { x, y } = event.currentTarget.getBoundingClientRect();
-        call({ left: x, top: y }, { isKeyboardEvent: true, event });
-    }
-    else {
-        call({ left: event.clientX, top: event.clientY }, { isKeyboardEvent: false, event });
-    }
-});
-//...
-export const createClickHandlers = (singleClickHandler, doubleClickHandler, delay = 75) => {
-    let clickTimer = 0;
-    let isDoubleClick = false;
-    const onclick = (e) => {
-        e.preventDefault();
-        if (clickTimer)
-            return;
-        clickTimer = setTimeout(() => {
-            if (!isDoubleClick) {
-                singleClickHandler(e);
-            }
-            clickTimer = 0;
-            isDoubleClick = false;
-        }, delay);
-    };
-    const ondblclick = (e) => {
-        e.preventDefault();
-        isDoubleClick = true;
-        if (clickTimer) {
-            clearTimeout(clickTimer);
-            clickTimer = 0;
-        }
-        doubleClickHandler(e);
-    };
-    return { onclick, ondblclick };
-};
-//...
-/**
- * Создаёт слушатель события на указанном элементе.
- *
- * @template M Карта событий
- * @template T Ключ события
- * @template E Тип события
- * @param event Название события
- * @param call Обработчик события
- * @param options Параметры слушателя
- * @param target Целевой элемент (по умолчанию `window`)
- * @returns Функция для удаления обработчика
- */
-export const createEventListener = (event, call, options = {}, target = window) => {
-    target.addEventListener(event, call, options);
-    return () => target.removeEventListener(event, call);
-};
-//...
-/**
- * Убирает фокус на активном элементе страницы
- */
-export const unfocus = () => 
-// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-document.activeElement?.blur?.();
-/**
- * Снимает текущее выделение текста на странице.
- */
-export const unselect = () => document.getSelection()?.removeAllRanges();
-/**
- * Добавляет одноразовый обработчик `mousedown`, который снимает выделение текста.
- *
- * @returns Функция для удаления обработчика
- */
-export const unselectByMousedown = () => createEventListener("mousedown", unselect, { once: true });
-/**
- * Создаёт обработчик кастомного события `rescroll`, который плавно прокручивает элемент наверх.
- *
- * @param element Целевой элемент (по умолчанию `document.documentElement`)
- * @param options Доп. параметры слушателя
- * @returns Функция для удаления обработчика
- */
-export const createRescrollListener = (element = document.documentElement, options) => createEventListener("rescroll", 
-// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-() => element?.scrollTo?.({ top: 0, behavior: "smooth" }), options);
-/**
- * Диспатчит событие `rescroll` на указанный элемент или окно.
- *
- * @param element Элемент или окно (по умолчанию `window`)
- * @returns Было ли событие успешно отправлено
- */
-export const rescrollDispatch = (element = window) => 
-// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-element?.dispatchEvent?.(new CustomEvent("rescroll"));
-//...
-/**
- * Автоматически изменяет высоту `textarea` в зависимости от содержимого.
- *
- * @param area Текстовое поле
- */
-export const autoAreaHeight = (area) => {
-    if (!area)
-        return;
-    area.style.height = "auto";
-    area.style.height = `${area.scrollHeight}px`;
-    area.scrollTop = area.scrollHeight;
-};
-/**
- * Преобразует {@link FormData} в объект.
- *
- * @param form Данные формы
- * @param multi Если true, то поддерживаются массивы значений для одинаковых ключей
- * @returns Объект с данными формы
- */
-export const formon = (form, multi = false) => {
-    if (multi) {
-        const result = {};
-        for (const { 0: key, 1: value } of form.entries()) {
-            if (result[key] !== undefined) {
-                if (!Array.isArray(result[key])) {
-                    result[key] = [result[key]];
-                }
-                result[key].push(value);
-            }
-            else {
-                result[key] = value;
-            }
-        }
-        return result;
-    }
-    else {
-        return Object.fromEntries(form.entries());
-    }
-};

package/dist/humanly.d.ts

@@ -1,9 +0,0 @@
-export type RU_CASES = "nominative" | "genitive" | "dative" | "accusative" | "ablative";
-/**
- * Форма слова 'рубль' в правильном падеже и числе в зависимости от количества
- */
-export declare const Rubles: (value: number, form?: RU_CASES) => string;
-/**
- * Форма слова 'секунда' в правильном падеже и числе в зависимости от количества
- */
-export declare const Seconds: (value: number, form?: RU_CASES) => string;

package/dist/humanly.js

@@ -1,93 +0,0 @@
-//...
-/**
- * Основные формы слова 'рубль'
- */
-const RublesMainSwitch = (form) => {
-    switch (form) {
-        case "dative":
-            return "рублям";
-        case "ablative":
-            return "рублями";
-        default:
-            return "рублей";
-    }
-};
-/**
- * Форма слова 'рубль' в правильном падеже и числе в зависимости от количества
- */
-export const Rubles = (value, form = "nominative") => {
-    const lastTwoDigits = Math.abs(value % 100);
-    if (lastTwoDigits > 4 && lastTwoDigits < 21)
-        return RublesMainSwitch(form);
-    const lastDigit = Math.abs(value % 10);
-    if (lastDigit >= 2 && lastDigit <= 4) {
-        switch (form) {
-            case "nominative":
-            case "accusative":
-                return "рубля";
-            default:
-                return RublesMainSwitch(form);
-        }
-    }
-    if (lastDigit === 1) {
-        switch (form) {
-            case "nominative":
-            case "accusative":
-                return "рубль";
-            case "genitive":
-                return "рубля";
-            case "dative":
-                return "рублю";
-            case "ablative":
-                return "рублём";
-        }
-    }
-    return RublesMainSwitch(form);
-};
-//...
-/**
- * Основные формы слова 'секунда'
- */
-const SecondsMainSwitch = (form) => {
-    switch (form) {
-        case "dative":
-            return "секундам";
-        case "ablative":
-            return "секундами";
-        default:
-            return "секунд";
-    }
-};
-/**
- * Форма слова 'секунда' в правильном падеже и числе в зависимости от количества
- */
-export const Seconds = (value, form = "nominative") => {
-    const lastTwoDigits = Math.abs(value % 100);
-    if (lastTwoDigits > 4 && lastTwoDigits < 21)
-        return SecondsMainSwitch(form);
-    const lastDigit = Math.abs(value % 10);
-    if (lastDigit >= 2 && lastDigit <= 4) {
-        switch (form) {
-            case "nominative":
-            case "accusative":
-                return "секунды";
-            default:
-                return SecondsMainSwitch(form);
-        }
-    }
-    if (lastDigit === 1) {
-        switch (form) {
-            case "nominative":
-                return "секунда";
-            case "accusative":
-                return "секунду";
-            case "genitive":
-                return "секунды";
-            case "dative":
-                return "секунде";
-            case "ablative":
-                return "секундой";
-        }
-    }
-    return SecondsMainSwitch(form);
-};

package/dist/lru.d.ts

@@ -1,77 +0,0 @@
-import type { RID, Timestamp } from "./types.js";
-/**
- * LRU (Least Recently Used) кэш с поддержкой TTL (time-to-live)
- *
- * Элементы кэша удаляются при превышении максимального размера либо по истечении заданного TTL.
- * TTL для каждого элемента можно задать как глобально при создании кэша, так и индивидуально при установке
- *
- * @template V - Тип значения для кэша
- * @template K - Тип ключа для кэша
- *
- * @example
- * const lruCache = new LRU<string, number>(2, 5); // Глобальный TTL 5 минут
- * lruCache.set('one', 1);
- * lruCache.set('two', 2);
- * lruCache.set('three', 3); // Если кэш переполнен, удалится наименее недавно использованный или устаревший элемент
- * console.log(lruCache.get('one')); // undefined, если значение устарело или удалено
- * console.log(lruCache.get('two')); // 2
- */
-export declare class LRU<V = unknown, K extends RID = string> {
-    /**
-     * Максимальное количество элементов в кэше
-     */
-    readonly max: number;
-    /**
-     * Глобальный TTL (time-to-live) для каждого элемента в {@link Timestamp}.
-     * Если не задан (`undefined`), элементы не устаревают глобально
-     */
-    readonly ttl?: Timestamp;
-    /**
-     * Внутреннее хранилище кэша.
-     * Хранит значения вместе с информацией о времени истечения срока их действия
-     */
-    private readonly cache;
-    /**
-     * @param [max=200] - Максимальное количество элементов в кэше
-     * @param ttl - Глобальный TTL (time-to-live) для каждого элемента в **минутах**
-     * Если не задан, элементы не устаревают глобально
-     */
-    constructor(max?: number, ttl?: number);
-    /**
-     * Перевод минут в {@link Timestamp}
-     */
-    private toTimeStamp;
-    /**
-     * Проверяет, устарел ли элемент кэша
-     *
-     * @param entry - Элемент кэша для проверки
-     * @returns `true`, если элемент устарел, иначе `false`
-     */
-    private isExpired;
-    /**
-     * Получает значение из кэша по ключу
-     *
-     * - Если элемент найден и не устарел, он перемещается в конец кэша (обновляется порядок использования)
-     * - Если элемент устарел, он удаляется, и возвращается `undefined`
-     *
-     * @param key - Ключ для получения значения
-     * @returns Значение из кэша или `undefined`, если ключ отсутствует или значение устарело
-     */
-    get(key: K): V | undefined;
-    /**
-     * Устанавливает значение в кэш
-     *
-     * - Если ключ уже существует, его значение обновляется и перемещается в конец
-     * - Если размер кэша превышает максимальное значение, производится очистка устаревших элементов
-     * - Если после очистки кэш все еще переполнен, удаляется наименее недавно использованный элемент
-     *
-     * @param key - Ключ для установки значения
-     * @param value - Значение для установки в кэш
-     * @param ttl - Индивидуальный TTL для данного элемента в **минутах**. Если не задан, используется TTL экземпляра, если он установлен
-     */
-    set(key: K, value: V, ttl?: number): void;
-    /**
-     * Очищает кэш
-     */
-    clear(key?: K): void;
-}

package/dist/lru.js

@@ -1,128 +0,0 @@
-/**
- * LRU (Least Recently Used) кэш с поддержкой TTL (time-to-live)
- *
- * Элементы кэша удаляются при превышении максимального размера либо по истечении заданного TTL.
- * TTL для каждого элемента можно задать как глобально при создании кэша, так и индивидуально при установке
- *
- * @template V - Тип значения для кэша
- * @template K - Тип ключа для кэша
- *
- * @example
- * const lruCache = new LRU<string, number>(2, 5); // Глобальный TTL 5 минут
- * lruCache.set('one', 1);
- * lruCache.set('two', 2);
- * lruCache.set('three', 3); // Если кэш переполнен, удалится наименее недавно использованный или устаревший элемент
- * console.log(lruCache.get('one')); // undefined, если значение устарело или удалено
- * console.log(lruCache.get('two')); // 2
- */
-export class LRU {
-    /**
-     * Максимальное количество элементов в кэше
-     */
-    max;
-    /**
-     * Глобальный TTL (time-to-live) для каждого элемента в {@link Timestamp}.
-     * Если не задан (`undefined`), элементы не устаревают глобально
-     */
-    ttl;
-    /**
-     * Внутреннее хранилище кэша.
-     * Хранит значения вместе с информацией о времени истечения срока их действия
-     */
-    cache;
-    /**
-     * @param [max=200] - Максимальное количество элементов в кэше
-     * @param ttl - Глобальный TTL (time-to-live) для каждого элемента в **минутах**
-     * Если не задан, элементы не устаревают глобально
-     */
-    constructor(max = 200, ttl) {
-        this.max = max;
-        if (ttl)
-            this.ttl = this.toTimeStamp(ttl);
-        this.cache = new Map();
-    }
-    /**
-     * Перевод минут в {@link Timestamp}
-     */
-    toTimeStamp(min) {
-        return min * 60 * 1000;
-    }
-    /**
-     * Проверяет, устарел ли элемент кэша
-     *
-     * @param entry - Элемент кэша для проверки
-     * @returns `true`, если элемент устарел, иначе `false`
-     */
-    isExpired(entry) {
-        return Boolean(entry.expired && Date.now() > entry.expired);
-    }
-    /**
-     * Получает значение из кэша по ключу
-     *
-     * - Если элемент найден и не устарел, он перемещается в конец кэша (обновляется порядок использования)
-     * - Если элемент устарел, он удаляется, и возвращается `undefined`
-     *
-     * @param key - Ключ для получения значения
-     * @returns Значение из кэша или `undefined`, если ключ отсутствует или значение устарело
-     */
-    get(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return undefined;
-        // Если элемент устарел, удаляем его и возвращаем undefined
-        if (this.isExpired(entry)) {
-            this.cache.delete(key);
-            return undefined;
-        }
-        // Обновляем порядок использования: удаляем и добавляем элемент в конец
-        this.cache.delete(key);
-        this.cache.set(key, entry);
-        return entry.value;
-    }
-    /**
-     * Устанавливает значение в кэш
-     *
-     * - Если ключ уже существует, его значение обновляется и перемещается в конец
-     * - Если размер кэша превышает максимальное значение, производится очистка устаревших элементов
-     * - Если после очистки кэш все еще переполнен, удаляется наименее недавно использованный элемент
-     *
-     * @param key - Ключ для установки значения
-     * @param value - Значение для установки в кэш
-     * @param ttl - Индивидуальный TTL для данного элемента в **минутах**. Если не задан, используется TTL экземпляра, если он установлен
-     */
-    set(key, value, ttl) {
-        // Если ключ уже существует, удаляем его для обновления порядка использования
-        if (this.cache.has(key))
-            this.cache.delete(key);
-        else {
-            if (this.cache.size >= this.max) {
-                // Если кэш достиг максимального размера, пробегаем по ключам и удаляем устаревшие элементы
-                for (const key of this.cache.keys()) {
-                    const entry = this.cache.get(key);
-                    if (!entry || this.isExpired(entry)) {
-                        this.cache.delete(key);
-                    }
-                }
-                // Если после очистки устаревших значений кэш все еще переполнен, удаляем первый (наименее недавно использованный) элемент
-                if (this.cache.size >= this.max) {
-                    const first = this.cache.keys().next().value;
-                    if (first !== undefined)
-                        this.cache.delete(first);
-                }
-            }
-        }
-        // Вычисляем время истечения для данного элемента
-        // prettier-ignore
-        const expired = ttl ? (Date.now() + this.toTimeStamp(ttl)) : (this.ttl ? (Date.now() + this.ttl) : undefined);
-        this.cache.set(key, { value, expired });
-    }
-    /**
-     * Очищает кэш
-     */
-    clear(key) {
-        if (key)
-            this.cache.delete(key);
-        else
-            this.cache.clear();
-    }
-}

package/dist/queue.d.ts

@@ -1,40 +0,0 @@
-import type { Timestamp } from "./types.js";
-/**
- * Абстрактный класс очереди
- *
- * @template T - Тип элементов в очереди
- */
-export declare abstract class Queue<T> {
-    _queue: T[];
-    _delay: number;
-    private timeout;
-    /**
-     * @param [delay=25] - Задержка (в миллисекундах) между обработкой элементов очереди
-     */
-    constructor(delay?: Timestamp);
-    /**
-     * Добавляет элемент в очередь и запускает обработку
-     *
-     * @param item - Элемент для добавления в очередь
-     * @param run - Запуск очереди
-     */
-    protected push(item: T, run?: boolean): void;
-    /**
-     * Запускает обработку очереди с задержкой
-     */
-    run(): void;
-    /**
-     * Метод для обработки элемента очереди
-     *
-     * @param item - Элемент для обработки
-     */
-    protected abstract handle(item: T): void;
-    /**
-     * Сброс таймера шага
-     */
-    private stop;
-    /**
-     * Сброс очереди
-     */
-    reset(): void;
-}

package/dist/queue.js

@@ -1,56 +0,0 @@
-/**
- * Абстрактный класс очереди
- *
- * @template T - Тип элементов в очереди
- */
-export class Queue {
-    _queue = [];
-    _delay;
-    timeout = 0;
-    // noinspection TypeScriptAbstractClassConstructorCanBeMadeProtected
-    /**
-     * @param [delay=25] - Задержка (в миллисекундах) между обработкой элементов очереди
-     */
-    constructor(delay = 25) {
-        this._delay = delay;
-    }
-    /**
-     * Добавляет элемент в очередь и запускает обработку
-     *
-     * @param item - Элемент для добавления в очередь
-     * @param run - Запуск очереди
-     */
-    push(item, run = true) {
-        this._queue.push(item);
-        if (run)
-            this.run();
-    }
-    /**
-     * Запускает обработку очереди с задержкой
-     */
-    run() {
-        this.stop();
-        this.timeout = setTimeout(() => {
-            if (this._queue.length === 0)
-                return this.stop();
-            const item = this._queue.shift();
-            this.handle(item);
-            this._queue.length > 0 ? this.run() : this.stop();
-        }, this._delay);
-    }
-    /**
-     * Сброс таймера шага
-     */
-    stop() {
-        if (this.timeout)
-            clearTimeout(this.timeout);
-        this.timeout = 0;
-    }
-    /**
-     * Сброс очереди
-     */
-    reset() {
-        this.stop();
-        this._queue.length = 0;
-    }
-}

package/dist/url.d.ts

@@ -1,61 +0,0 @@
-import type { CanBeNullable } from "./types.js";
-/**
- * Возможные значения параметра для {@link pushParams} и {@link clearParams}
- */
-export type ParamValue = CanBeNullable<string | number | boolean>;
-/**
- * KV-параметры для URL для {@link pushParams} и {@link clearParams}
- */
-export type ParamKV<V extends ParamValue = ParamValue> = {
-    key: string;
-    value?: V;
-};
-/**
- * Параметры для URL для {@link pushParams} и {@link clearParams}
- */
-export type Params<V extends ParamValue = ParamValue> = CanBeNullable<string | ParamKV<V>>[];
-/**
- * Добавляет параметры в URL
- *
- * Для каждого параметра из массива:
- * - Если параметр равен `null` или `undefined`, он пропускается
- * - Если параметр имеет тип `string`, то в строке запроса добавляется параметр с ключом равным значению строки и значением `"true"`
- * - Если параметр является объектом с ключом и значением, то, если значение не `undefined` и не является объектом, оно приводится к строке и устанавливается в качестве значения
- *
- * **Небезопасное поведение:**
- * - При передаче параметра типа `string` он добавляется как `?param1&param2` (без значения, то есть без `true`)
- * - При передаче параметра, значение которого равно `true` или пустой строке, параметр добавляется без значения
- *
- * @param url - URL, в который будут добавлены параметры
- * @param params - Массив параметров
- * @param [unsafe=false] - Небезопасное поведение
- */
-export declare const pushParams: (url: URL, params: Params, unsafe?: boolean) => URL;
-export type StrictPushParams = Required<ParamKV<string | boolean | number>>[];
-/**
- * Объединяет массивы параметров для {@link pushParams} в один массив, исключая дубликаты
- *
- * @param args - Массивы параметров для объединения
- * @returns Массив параметров без дубликатов
- */
-export declare const mergePushParams: (...args: Params[]) => StrictPushParams;
-/**
- * Удаляет из URL параметры
- *
- * Для каждого элемента массива:
- * - Если параметр отсутствует или равен `null` или `undefined`, он пропускается
- * - Если параметр имеет тип `string`, из URL удаляется параметр с таким именем
- * - Если параметр является объектом с ключом (`key`), из URL удаляется параметр с этим ключом
- *
- * @param url - URL, из которого будут удалены параметры
- * @param params - Массив параметров для удаления
- */
-export declare const clearParams: (url: URL, params: Params) => URL;
-export type StrictClearParams = string[];
-/**
- * Объединяет массивы параметров для {@link clearParams} в один массив, исключая дубликаты
- *
- * @param args - Массивы параметров для объединения
- * @returns Массив параметров без дубликатов
- */
-export declare const mergeClearParams: (...args: Params[]) => StrictClearParams;