@nemigo/helpers 0.13.2 → 1.5.0

package/dist/datetime/plural.js

@@ -0,0 +1,78 @@
+import { createValuePluralizer } from "../index.js";
+/**
+ * Склонение слова "секунда" в зависимости от числа
+ *
+ * @example
+ * ```typescript
+ * pluralSeconds(1); // "секунда"
+ * pluralSeconds(3); // "секунды"
+ * pluralSeconds(155); // "секунд"
+ * ```
+ */
+export const pluralSeconds = createValuePluralizer("секунда", "секунды", "секунд");
+/**
+ * Склонение слова "минута" в зависимости от числа
+ *
+ * @example
+ * ```typescript
+ * pluralMinutes(1); // "минута"
+ * pluralMinutes(3); // "минуты"
+ * pluralMinutes(155); // "минут"
+ * ```
+ */
+export const pluralMinutes = createValuePluralizer("минута", "минуты", "минут");
+/**
+ * Склонение слова "час" в зависимости от числа
+ *
+ * @example
+ * ```typescript
+ * pluralHours(1); // "час"
+ * pluralHours(3); // "часа"
+ * pluralHours(155); // "часов"
+ * ```
+ */
+export const pluralHours = createValuePluralizer("час", "часа", "часов");
+/**
+ * Склонение слова "день" в зависимости от числа
+ *
+ * @example
+ * ```typescript
+ * pluralDays(1); // "день"
+ * pluralDays(3); // "дня"
+ * pluralDays(155); // "дней"
+ * ```
+ */
+export const pluralDays = createValuePluralizer("день", "дня", "дней");
+/**
+ * Склонение слова "неделя" в зависимости от числа
+ *
+ * @example
+ * ```typescript
+ * pluralWeeks(1); // "неделя"
+ * pluralWeeks(3); // "недели"
+ * pluralWeeks(155); // "недель"
+ * ```
+ */
+export const pluralWeeks = createValuePluralizer("неделя", "недели", "недель");
+/**
+ * Склонение слова "месяц" в зависимости от числа
+ *
+ * @example
+ * ```typescript
+ * pluralMonths(1); // "месяц"
+ * pluralMonths(3); // "месяца"
+ * pluralMonths(155); // "месяцев"
+ * ```
+ */
+export const pluralMonths = createValuePluralizer("месяц", "месяца", "месяцев");
+/**
+ * Склонение слова "год" в зависимости от числа
+ *
+ * @example
+ * ```typescript
+ * pluralYears(1); // "год"
+ * pluralYears(3); // "года"
+ * pluralYears(155); // "лет"
+ * ```
+ */
+export const pluralYears = createValuePluralizer("год", "года", "лет");

package/dist/emitter.d.ts

@@ -1,28 +1,40 @@
-import { Promoter } from "./promoter.js";
-import type { RID } from "./types.js";
+import type { KEYS, RID } from "./types.js";
 /**
- * Класс `Emitter` реализует простую систему событийного взаимодействия.
- * Позволяет подписываться на события, уведомлять и удалять обработчики
+ * Реализует простую систему событийного взаимодействия
  *
- * @template Events - Схема событий вида `{ [key]: data }`
+ * @template Schema - Схема событий вида `{ [key]: data }`
  */
-export declare class Emitter<Events extends object> extends Promoter<{
-    type: keyof Events;
-    data: Events[keyof Events];
-}> {
-    /**
-     * Вызывает все обработчики, связанные с указанным событием
-     */
-    dispatch<K extends keyof Events>(target: K, data: Events[K]): void;
+export declare class Emitter<Schema extends object> {
+    __listeners: Map<RID, {
+        event: KEYS<Schema>;
+        callback: (data: Schema[KEYS<Schema>]) => void;
+        once?: boolean;
+    }>;
+    dispatch<K extends KEYS<Schema>>(event: K, data: Schema[K]): void;
     /**
-     * Добавляет обработчик для события
+     * @param event - Ключ события
+     * @param callback - Обработчик события
+     * @param [options] - Опции запуска
+     * @param [options.once] - Одноразовая подписка
+     * @param [options.key=Symbol()] - Ключ подписчика
+     *
+     * @returns - Функция для удаления обработчика
      */
-    on<K extends keyof Events>(event: K, call: (data: Events[K]) => void, params?: {
+    on<K extends KEYS<Schema>>(event: K, callback: (data: Schema[K]) => void, options?: {
         key?: RID;
         once?: boolean;
     }): () => void;
     /**
-     * Удаляет обработчик события по ключу. Если не указан, очищаются все обработчики
+     * **Если ключ не указан, очищаются все**
+     *
+     * @example
+     * ```typescript
+     * // Удаление конкретного обработчика
+     * emitter.un("my-handler")
+     *
+     * // Очистка всех обработчиков
+     * emitter.un()
+     * ```
      */
-    un(key?: RID): boolean;
+    un(key?: RID): void;
 }

package/dist/emitter.js

@@ -1,33 +1,47 @@
-import { Promoter } from "./promoter.js";
 /**
- * Класс `Emitter` реализует простую систему событийного взаимодействия.
- * Позволяет подписываться на события, уведомлять и удалять обработчики
+ * Реализует простую систему событийного взаимодействия
  *
- * @template Events - Схема событий вида `{ [key]: data }`
+ * @template Schema - Схема событий вида `{ [key]: data }`
  */
-export class Emitter extends Promoter {
-    /**
-     * Вызывает все обработчики, связанные с указанным событием
-     */
-    dispatch(target, data) {
-        super.notify({ type: target, data });
+export class Emitter {
+    __listeners = new Map();
+    dispatch(event, data) {
+        this.__listeners.forEach((handler, key) => {
+            if (event === handler.event)
+                handler.callback(data);
+            if (handler.once)
+                this.__listeners.delete(key);
+        });
     }
     /**
-     * Добавляет обработчик для события
+     * @param event - Ключ события
+     * @param callback - Обработчик события
+     * @param [options] - Опции запуска
+     * @param [options.once] - Одноразовая подписка
+     * @param [options.key=Symbol()] - Ключ подписчика
+     *
+     * @returns - Функция для удаления обработчика
      */
-    on(event, call, params = {}) {
-        const { key = Symbol(), once } = params;
-        return super.sub((payload) => {
-            if (payload.type === event) {
-                // @ts-expect-error <оно не может корректно сузить тип>
-                call(payload.data);
-            }
-        }, { key, once });
+    on(event, callback, options = {}) {
+        const { key = Symbol(), once } = options;
+        this.__listeners.set(key, { event, callback, once });
+        return () => this.__listeners.delete(key);
     }
     /**
-     * Удаляет обработчик события по ключу. Если не указан, очищаются все обработчики
+     * **Если ключ не указан, очищаются все**
+     *
+     * @example
+     * ```typescript
+     * // Удаление конкретного обработчика
+     * emitter.un("my-handler")
+     *
+     * // Очистка всех обработчиков
+     * emitter.un()
+     * ```
      */
     un(key) {
-        return super.unsub(key);
+        if (key)
+            return void this.__listeners.delete(key);
+        this.__listeners.clear();
     }
 }

package/dist/explorer.d.ts

@@ -1,15 +1,19 @@
 import type { PathLike, Stats } from "node:fs";
 /**
- * Проверяет существование пути и его тип (файл или папка) через {@link stat}
+ * @param path - Проверяет существование пути через {@link stat}
+ * @param [expected] - Ожидаемый тип: `"file"` (файл) или `"folder"` (директория)
+ * @param [strict=false] - Выбрасывает ошибку, если путь не существует
  *
- * @param path - Путь для проверки
- * @param [expected] - Ожидаемый тип: `"file"` (файл) или `"folder"` (папка)
- * @param [strict=false] - Если `true`, выбрасывает ошибку, если путь не существует
- *
- * @returns {@link Stats}, если путь существует и соответствует ожидаемому типу (если указан). Иначе возвращает `null`, если `strict = false`
  * @throws {Error} Если `strict = true` и путь не существует или не соответствует ожидаемому типу
  */
 declare function exists(path: PathLike, expected?: "file" | "folder", strict?: boolean): Promise<Stats | null>;
+/**
+ * @param path - Проверяет существование пути через {@link stat}
+ * @param [expected] - Ожидаемый тип: `"file"` (файл) или `"folder"` (директория)
+ * @param strict - Выбрасывает ошибку, если путь не существует
+ *
+ * @throws {Error} Если путь не существует или не соответствует ожидаемому типу
+ */
 declare function exists(path: PathLike, expected: "file" | "folder" | undefined, strict: true): Promise<Stats>;
 export { exists };
 /**
@@ -17,37 +21,29 @@ export { exists };
  */
 export interface RemoveOptions {
     /**
-     * Если `true` и это была не пустая папка, бросит ошибку.
-     * Параметр `expected` приводится к `"folder"`
-     *
-     * @default false
+     * Если это была не пустая директория, бросит ошибку
+     * @remarks {@link RemoveOptions.expected} приводится к `"folder"`
      */
     empty?: boolean;
     /**
      * Проверка перед удалением
-     *
-     * @default undefined
      */
     expected?: "file" | "folder";
 }
 /**
  * Удаляет файл или папку по указанному пути
  *
- * @param path - Путь к файлу или папке
- * @param options - Опции поведения {@link RemoveOptions}
+ * @returns {@link Stats} удалённого элемента или `null`, если он не существовал
  *
- * @returns {@link Stats}, если путь существовал и был удалён, иначе `null`
- * @throws {Error} Если путь не существует или не соответствует ожидаемому типу
+ * @throws {Error} Если это была не пустая директория при {@link RemoveOptions.empty} или не соответствует ожидаемому типу {@link RemoveOptions.expected}
  */
 export declare function remove(path: PathLike, options?: RemoveOptions): Promise<Stats | null>;
 /**
- * Опции для функции {@link remake}
+ * Опции поведения для функции {@link remake}
  */
 export interface RemakeOptions {
     /**
-     * Если `true` и это была не пустая папка, бросит ошибку
-     *
-     * @default false
+     * Если это была не пустая директория, бросит ошибку
      */
     empty?: boolean;
     /**
@@ -58,23 +54,20 @@ export interface RemakeOptions {
     recursive?: boolean;
 }
 /**
- * Удаляет (если существовала) и заново создаёт папку по указанному пути
+ * Удаляет (если существовала) и заново создаёт директорию по указанному пути
  *
- * @param path - Путь к папке
- * @param options - Опции поведения {@link RemakeOptions}
+ * @returns {@link Stats} удалённой директории или `null`, если она не существовала
  *
- * @returns {@link Stats}, если папка существовала и была удалена, иначе `null`
- * @throws {Error} Если путь не существует или не является папкой
+ * @throws {Error} Если это была не пустая директория при {@link RemakeOptions.empty} или нет родительской папки при отключённом {@link RemakeOptions.recursive}
  */
-export declare function remake(path: PathLike, options?: RemakeOptions): Promise<Stats | null>;
+export declare const remake: (path: PathLike, options?: RemakeOptions) => Promise<Stats | null>;
 /**
  * Сравнивает содержимое файла с ожидаемым значением
  *
  * @param path - Путь к файлу
  * @param expected - Ожидаемое содержимое файла
- * @param [strict=true] - Если `true`, выбрасывает ошибку, если файл не существует. Если `false`, возвращает `false`
+ * @param [strict=false] - Выбрасывает ошибку, если файл не существует
  *
- * @returns `true`, если содержимое файла совпадает с ожидаемым, иначе `false`
  * @throws {Error} Если `strict = true` и файл не существует
  */
-export declare function compare(path: PathLike, expected: string, strict?: boolean): Promise<boolean>;
+export declare const compare: (path: PathLike, expected: string, strict?: boolean) => Promise<boolean>;

package/dist/explorer.js

@@ -1,4 +1,11 @@
 import { mkdir, readdir, readFile, rm, stat } from "node:fs/promises";
+/**
+ * @param path - Проверяет существование пути через {@link stat}
+ * @param [expected] - Ожидаемый тип: `"file"` (файл) или `"folder"` (директория)
+ * @param [strict=false] - Выбрасывает ошибку, если путь не существует
+ *
+ * @throws {Error} Если `strict = true` и путь не существует или не соответствует ожидаемому типу
+ */
 async function exists(path, expected, strict = false) {
     let existed;
     try {
@@ -22,11 +29,9 @@ export { exists };
 /**
  * Удаляет файл или папку по указанному пути
  *
- * @param path - Путь к файлу или папке
- * @param options - Опции поведения {@link RemoveOptions}
+ * @returns {@link Stats} удалённого элемента или `null`, если он не существовал
  *
- * @returns {@link Stats}, если путь существовал и был удалён, иначе `null`
- * @throws {Error} Если путь не существует или не соответствует ожидаемому типу
+ * @throws {Error} Если это была не пустая директория при {@link RemoveOptions.empty} или не соответствует ожидаемому типу {@link RemoveOptions.expected}
  */
 export async function remove(path, options = {}) {
     const { empty = false, expected } = options;
@@ -37,7 +42,7 @@ export async function remove(path, options = {}) {
             return null;
         const entries = await readdir(path, { withFileTypes: true });
         if (entries.length > 0) {
-            throw new Error(`Ожидалось, что папка "${path}" будет пуста`);
+            throw new Error(`Ожидалось, что директория "${path}" будет пуста`);
         }
     }
     else {
@@ -49,35 +54,32 @@ export async function remove(path, options = {}) {
     return existed;
 }
 /**
- * Удаляет (если существовала) и заново создаёт папку по указанному пути
+ * Удаляет (если существовала) и заново создаёт директорию по указанному пути
  *
- * @param path - Путь к папке
- * @param options - Опции поведения {@link RemakeOptions}
+ * @returns {@link Stats} удалённой директории или `null`, если она не существовала
  *
- * @returns {@link Stats}, если папка существовала и была удалена, иначе `null`
- * @throws {Error} Если путь не существует или не является папкой
+ * @throws {Error} Если это была не пустая директория при {@link RemakeOptions.empty} или нет родительской папки при отключённом {@link RemakeOptions.recursive}
  */
-export async function remake(path, options = {}) {
+export const remake = async (path, options = {}) => {
     const { empty = false, recursive = true } = options;
     const existed = await remove(path, { empty, expected: "folder" });
     await mkdir(path, { recursive });
     return existed;
-}
+};
 //...
 /**
  * Сравнивает содержимое файла с ожидаемым значением
  *
  * @param path - Путь к файлу
  * @param expected - Ожидаемое содержимое файла
- * @param [strict=true] - Если `true`, выбрасывает ошибку, если файл не существует. Если `false`, возвращает `false`
+ * @param [strict=false] - Выбрасывает ошибку, если файл не существует
  *
- * @returns `true`, если содержимое файла совпадает с ожидаемым, иначе `false`
  * @throws {Error} Если `strict = true` и файл не существует
  */
-export async function compare(path, expected, strict = true) {
+export const compare = async (path, expected, strict = false) => {
     const existed = await exists(path, "file", strict);
     if (!existed)
         return false;
     const content = await readFile(path, "utf-8");
     return content === expected;
-}
+};

package/dist/files.d.ts

@@ -1,8 +1,37 @@
+/**
+ * Конвертирует файл в строку base64 используя {@link FileReader.readAsDataURL}
+ *
+ * @throws {Error} Если чтение файла завершается с ошибкой
+ */
 export declare const fileToBase64: (file: File) => Promise<string>;
 /**
- * Проверяет, является ли файл изображением. SVG данную проверку не проходят.
+ * Проверяет, является ли файл изображением.
+ * SVG данную проверку не проходят
  */
 export declare const isImage: (file: File) => boolean;
+/**
+ * Проверяет, является ли файл видео
+ */
 export declare const isVideo: (file: File) => boolean;
+/**
+ * Проверяет, является ли файл аудио
+ */
 export declare const isAudio: (file: File) => boolean;
-export declare const getFileSize: (size: number) => string;
+/**
+ * Словарь степеней байтов для {@link getFileSize}
+ */
+export declare const BYTES_UNITS: string[];
+/**
+ * Форматирует размер файла в читаемом виде
+ *
+ * @param size - Размер файла в байтах
+ * @param [dictionary=BYTES_UNITS] - Словарь степеней байтов
+ *
+ * @example
+ * ```typescript
+ * getFileSize(1024) // "1 kB"
+ * getFileSize(1048576) // "1 MB"
+ * getFileSize(500) // "500 B"
+ * ```
+ */
+export declare const getFileSize: (size: number, dictionary?: string[]) => string;

package/dist/files.js

@@ -1,18 +1,32 @@
+/**
+ * Конвертирует файл в строку base64 используя {@link FileReader.readAsDataURL}
+ *
+ * @throws {Error} Если чтение файла завершается с ошибкой
+ */
 export const fileToBase64 = (file) => new Promise((resolve, reject) => {
     const reader = new FileReader();
     reader.onload = () => resolve(reader.result);
     reader.onerror = reject;
     reader.readAsDataURL(file);
 });
-//...
 /**
- * Проверяет, является ли файл изображением. SVG данную проверку не проходят.
+ * Проверяет, является ли файл изображением.
+ * SVG данную проверку не проходят
  */
 export const isImage = (file) => file.type.startsWith("image/") && !file.type.includes("svg");
+/**
+ * Проверяет, является ли файл видео
+ */
 export const isVideo = (file) => file.type.startsWith("video/");
+/**
+ * Проверяет, является ли файл аудио
+ */
 export const isAudio = (file) => file.type.startsWith("audio/");
 //...
-const UNITS = [
+/**
+ * Словарь степеней байтов для {@link getFileSize}
+ */
+export const BYTES_UNITS = [
     "B",
     "kB",
     "MB",
@@ -23,13 +37,24 @@ const UNITS = [
     "ZB",
     "YB",
 ];
-export const getFileSize = (size) => {
+/**
+ * Форматирует размер файла в читаемом виде
+ *
+ * @param size - Размер файла в байтах
+ * @param [dictionary=BYTES_UNITS] - Словарь степеней байтов
+ *
+ * @example
+ * ```typescript
+ * getFileSize(1024) // "1 kB"
+ * getFileSize(1048576) // "1 MB"
+ * getFileSize(500) // "500 B"
+ * ```
+ */
+export const getFileSize = (size, dictionary = BYTES_UNITS) => {
     const bytes = Math.round(size);
-    if (bytes === 0)
-        return "0 B";
     if (bytes < 1000)
         return bytes.toString() + " B";
-    const exponent = Math.min(Math.floor(Math.log10(bytes) / 3), UNITS.length - 1);
+    const exponent = Math.min(Math.floor(Math.log10(bytes) / 3), dictionary.length - 1);
     const result = bytes / 1000 ** exponent;
-    return Math.round(result) + " " + UNITS[exponent];
+    return Math.round(result) + " " + dictionary[exponent];
 };

package/dist/fish.d.ts

@@ -0,0 +1,29 @@
+import type { AnyFunc, Args, Dictionary, FuncCopy, Return } from "./types.js";
+/**
+ * Выполнение функции только один раз, после будет возвращать уже полученный ранее результат
+ *
+ * @throws {unknown} Если первый вызов будет с ошибкой, можно попровать ещё раз
+ */
+export declare const oncefish: <F extends AnyFunc>(func: F) => FuncCopy<F>;
+/**
+ * Однократное выполнение асинхронной функции, после будет возвращать уже полученный ранее промисс
+ *
+ * @throws {unknown} Если первый вызов будет с ошибкой, можно попровать ещё раз
+ */
+export declare const profish: <T, A extends any[] = any[]>(func: (...args: A) => Promise<T>) => ((...args: A) => Promise<T>);
+/**
+ * Оборачивает функцию так, чтобы она запоминала **только последний вызов**.
+ * При повторном аналогичном (согласно `strategy`) вызове возвращается сохранённый результат
+ *
+ * @throws {unknown} Если вызов `func` завершается ошибкой, новый результат не кэшируется, и ошибка пробрасывается
+ */
+export declare const goldfish: <F extends AnyFunc>(func: F, strategy: (curr: Args<F>, prev: Args<F>, result: Return<F>) => boolean) => FuncCopy<F>;
+/**
+ * Оборачивает функцию так, чтобы она кэшировала результаты вызовов по ключу,
+ * полученному с помощью функции `serialize`
+ *
+ * Кэш хранится в обычной `Map`, ключи генерируются вызовом `serialize` от аргументов
+ *
+ * @throws {unknown} Если вызов `func` завершается ошибкой, результат не кэшируется, и ошибка пробрасывается
+ */
+export declare const memofish: <F extends AnyFunc, Cache extends Dictionary<any, Return<F>>>(func: F, serialize: (args: Args<F>, cache: Cache) => Args<Cache["get"]>[0], cache?: Cache) => FuncCopy<F>;

package/dist/fish.js

@@ -0,0 +1,70 @@
+/**
+ * Выполнение функции только один раз, после будет возвращать уже полученный ранее результат
+ *
+ * @throws {unknown} Если первый вызов будет с ошибкой, можно попровать ещё раз
+ */
+export const oncefish = (func) => {
+    let ready = false;
+    let result;
+    return (...args) => {
+        if (!ready) {
+            result = func(args);
+            ready = true;
+        }
+        return result;
+    };
+};
+/**
+ * Однократное выполнение асинхронной функции, после будет возвращать уже полученный ранее промисс
+ *
+ * @throws {unknown} Если первый вызов будет с ошибкой, можно попровать ещё раз
+ */
+export const profish = (func) => {
+    let promise;
+    return (...args) => {
+        if (!promise) {
+            promise = func(...args).catch((err) => {
+                promise = undefined;
+                throw err;
+            });
+        }
+        return promise;
+    };
+};
+/**
+ * Оборачивает функцию так, чтобы она запоминала **только последний вызов**.
+ * При повторном аналогичном (согласно `strategy`) вызове возвращается сохранённый результат
+ *
+ * @throws {unknown} Если вызов `func` завершается ошибкой, новый результат не кэшируется, и ошибка пробрасывается
+ */
+export const goldfish = (func, strategy) => {
+    let lastArgs;
+    let lastResult;
+    return (...args) => {
+        if (lastArgs && strategy(args, lastArgs, lastResult)) {
+            return lastResult;
+        }
+        lastResult = func(args);
+        lastArgs = args;
+        return lastResult;
+    };
+};
+/**
+ * Оборачивает функцию так, чтобы она кэшировала результаты вызовов по ключу,
+ * полученному с помощью функции `serialize`
+ *
+ * Кэш хранится в обычной `Map`, ключи генерируются вызовом `serialize` от аргументов
+ *
+ * @throws {unknown} Если вызов `func` завершается ошибкой, результат не кэшируется, и ошибка пробрасывается
+ */
+export const memofish = (func, serialize, cache = new Map()) => {
+    return (...args) => {
+        const key = serialize(args, cache);
+        const existed = cache.get(key);
+        if (existed)
+            return existed;
+        const result = func(...args);
+        cache.set(key, result);
+        return result;
+    };
+};

package/dist/html/cookie.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Политика {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie/SameSite SameSite} приватности кук для {@link setDocumentCookie}
+ *
+ * - Strict: Куки будут отправляться только при навигации внутри сайта
+ * - Lax: Куки доступны для навигации с одного сайта на другой (рекомендуется)
+ * - None: Куки доступны для всех запросов, требуется параметр Secure (для кросс-сайтовых запросов)
+ */
+export type CookieSameSite = "Strict" | "Lax" | "None";
+/**
+ * Опции установки куки для {@link setDocumentCookie}
+ */
+export interface SetDocumentCookieOptions {
+    SameSite?: CookieSameSite;
+    /**
+     * Максимальное время жизни куки в секундах
+     *
+     * @remarks `MaxAge === null` делает хранение сессионным!
+     */
+    MaxAge?: number | null;
+    /**
+     * Флаг, указывающий, что кука будет передаваться только по защищенному соединению (HTTPS)
+     */
+    Secure?: boolean;
+    /**
+     * Путь раздела, для которого кука существует при отправке на сервер
+     */
+    Path?: string;
+    /**
+     * Для установки куки, которая будет доступна на текущем домене и всех его поддоменах `.${window.location.hostname}`
+     */
+    Domain?: string;
+}
+/**
+ * @param name - Имя куки
+ * @param value - Значение куки
+ * @param [options] - Опции куки
+ * @param [options.MaxAge=21days] - {@link SetDocumentCookieOptions.MaxAge}
+ * @param [options.SameSite="Lax"] - {@link SetDocumentCookieOptions.SameSite}
+ * @param [options.Secure=true] - {@link SetDocumentCookieOptions.Secure}
+ * @param [options.Path="/"] - {@link SetDocumentCookieOptions.Path}
+ * @param [options.Domain] - {@link SetDocumentCookieOptions.Domain}
+ */
+export declare const setDocumentCookie: (name: string, value: string, options?: SetDocumentCookieOptions) => void;
+export declare const getDocumentCookie: (name: string) => string | undefined;
+/**
+ * Удаляет куку по имени, устанавливая Max-Age=0 через {@link setDocumentCookie}
+ */
+export declare const deleteDocumentCookie: (name: string, Path?: string) => void;