@emaxe/tuigram 1.0.0

package/src/ui/components/modals/fileModal.js

@@ -0,0 +1,355 @@
+import blessed from "neo-blessed";
+import path from "node:path";
+import { inspectLocalFile } from "../../../utils/storage.js";
+import { formatFileSize } from "../../../utils/time.js";
+import { createFilePickerModal } from "./filePickerModal.js";
+import { fg } from "../../theme.js";
+
+/** Разделитель нескольких путей в поле ввода. */
+const PATH_SEPARATOR = "|";
+
+/**
+ * Создаёт модальное окно отправки локальных файлов.
+ * @param {blessed.Widgets.Screen} screen
+ * @param {object} theme
+ * @param {object} callbacks
+ * @param {(files: Array<object>, options: { caption: string, asDocument: boolean }) => void} callbacks.onSendFile
+ * @returns {{ show: () => void, hide: () => void }}
+ */
+export function createFileModal(screen, theme, { onSendFile } = {}) {
+    // Высота 14 = рамка (2) + 12 внутренних строк под поля, чекбокс,
+    // строку состояния, кнопки и подсказку.
+    const modal = blessed.box({
+        parent: screen,
+        top: "center",
+        left: "center",
+        width: "60%",
+        height: 14,
+        hidden: true,
+        tags: true,
+        border: {
+            type: "line",
+        },
+        shadow: true,
+        style: {
+            bg: theme.modal.bg,
+            fg: theme.modal.fg,
+            border: {
+                fg: theme.modal.borderFg,
+            },
+        },
+    });
+
+    blessed.box({
+        parent: modal,
+        top: 0,
+        left: 1,
+        right: 1,
+        height: 1,
+        tags: true,
+        content: " {bold}📤 Отправка файла или документа{/bold}",
+        style: { bg: theme.modal.bg, fg: theme.modal.fg },
+    });
+
+    blessed.box({
+        parent: modal,
+        top: 2,
+        left: 2,
+        right: 2,
+        height: 1,
+        tags: true,
+        content: `Путь к файлу ${fg(theme.modal.hintFg, `(несколько — через ${PATH_SEPARATOR})`)}{|}${fg(theme.accent, "[Ctrl+F] Обзор")} `,
+        style: { bg: theme.modal.bg, fg: theme.modal.fg },
+    });
+
+    const pathInput = blessed.textbox({
+        parent: modal,
+        top: 3,
+        left: 2,
+        right: 2,
+        height: 1,
+        inputOnFocus: true,
+        style: {
+            bg: theme.modal.inputBg,
+            fg: theme.modal.inputFg,
+            focus: { bg: theme.modal.inputFocusBg, fg: theme.modal.inputFocusFg },
+        },
+    });
+
+    blessed.box({
+        parent: modal,
+        top: 5,
+        left: 2,
+        right: 2,
+        height: 1,
+        content: "Подпись (необязательно):",
+        style: { bg: theme.modal.bg, fg: theme.modal.fg },
+    });
+
+    const captionInput = blessed.textbox({
+        parent: modal,
+        top: 6,
+        left: 2,
+        right: 2,
+        height: 1,
+        inputOnFocus: true,
+        style: {
+            bg: theme.modal.inputBg,
+            fg: theme.modal.inputFg,
+            focus: { bg: theme.modal.inputFocusBg, fg: theme.modal.inputFocusFg },
+        },
+    });
+
+    const asDocumentCheck = blessed.checkbox({
+        parent: modal,
+        top: 8,
+        left: 2,
+        right: 2,
+        height: 1,
+        mouse: true,
+        text: "Как файл, без сжатия      [Ctrl+D]",
+        style: {
+            bg: theme.modal.bg,
+            fg: theme.modal.fg,
+            focus: { bg: theme.modal.selectedBg, fg: theme.modal.selectedFg, bold: true },
+        },
+    });
+
+    const statusLine = blessed.box({
+        parent: modal,
+        top: 9,
+        left: 2,
+        right: 2,
+        height: 1,
+        tags: true,
+        style: { bg: theme.modal.bg, fg: theme.modal.fg },
+    });
+
+    const sendBtn = blessed.button({
+        parent: modal,
+        bottom: 1,
+        left: 4,
+        width: 14,
+        height: 1,
+        mouse: true,
+        content: " [ Отправить ] ",
+        align: "center",
+        style: {
+            bg: theme.modal.buttonBg,
+            fg: theme.modal.buttonFg,
+            focus: { bg: theme.modal.buttonFocusBg, fg: theme.modal.buttonFocusFg, bold: true },
+        },
+    });
+
+    const cancelBtn = blessed.button({
+        parent: modal,
+        bottom: 1,
+        right: 4,
+        width: 14,
+        height: 1,
+        mouse: true,
+        content: " [ Отмена ] ",
+        align: "center",
+        style: {
+            bg: theme.modal.dangerBg,
+            fg: theme.modal.dangerFg,
+            focus: { bg: theme.modal.buttonFocusBg, fg: theme.modal.buttonFocusFg, bold: true },
+        },
+    });
+
+    blessed.box({
+        parent: modal,
+        bottom: 0,
+        left: 2,
+        right: 2,
+        height: 1,
+        tags: true,
+        align: "center",
+        content: fg(theme.modal.hintFg, "[Tab] Поля  [Enter] Далее  [Ctrl+F] Обзор  [Ctrl+D] Без сжатия  [Esc] Выход"),
+        style: { bg: theme.modal.bg, fg: theme.modal.fg },
+    });
+
+    const picker = createFilePickerModal(screen, theme);
+
+    let previousFocus = null;
+    let lastDir = null;
+
+    const KIND_LABEL = { photo: "уйдёт как фото", video: "уйдёт как видео", document: "уйдёт как документ" };
+
+    /** Разбирает поле пути в список введённых путей. */
+    function currentPaths() {
+        return pathInput
+            .getValue()
+            .split(PATH_SEPARATOR)
+            .map((part) => part.trim())
+            .filter(Boolean);
+    }
+
+    function setError(text) {
+        statusLine.setContent(fg(theme.error, `✕ ${text}`));
+        screen.render();
+    }
+
+    /**
+     * Проверяет введённые пути и обновляет строку состояния.
+     * Значение поля НИКОГДА не перезаписывается — ошибка живёт отдельно.
+     * @returns {Array<object>|null} валидные файлы либо null при ошибке
+     */
+    function validate({ quiet = false } = {}) {
+        const raw = currentPaths();
+        if (raw.length === 0) {
+            statusLine.setContent("");
+            screen.render();
+            return null;
+        }
+
+        const files = [];
+        for (const entry of raw) {
+            const info = inspectLocalFile(entry);
+            if (!info.ok) {
+                if (!quiet) setError(info.error);
+                return null;
+            }
+            files.push(info);
+        }
+
+        lastDir = path.dirname(files[files.length - 1].filePath);
+
+        const asDocument = Boolean(asDocumentCheck.checked);
+        const totalSize = files.reduce((sum, f) => sum + f.size, 0);
+
+        if (files.length === 1) {
+            const [file] = files;
+            const kind = asDocument ? "уйдёт как файл" : KIND_LABEL[file.kind];
+            statusLine.setContent(fg(theme.success, `✓ ${file.name} · ${formatFileSize(file.size)} · ${kind}`));
+        } else {
+            statusLine.setContent(
+                fg(theme.success, `✓ Альбом из ${files.length} файлов · ${formatFileSize(totalSize)}`)
+            );
+        }
+        screen.render();
+        return files;
+    }
+
+    function hide() {
+        picker.hide();
+        modal.hide();
+        if (previousFocus) {
+            previousFocus.focus();
+            previousFocus = null;
+        }
+        screen.render();
+    }
+
+    function show() {
+        pathInput.setValue("");
+        captionInput.setValue("");
+        asDocumentCheck.uncheck();
+        statusLine.setContent("");
+        previousFocus = screen.focused;
+        modal.show();
+        modal.setFront();
+        pathInput.focus();
+        screen.render();
+    }
+
+    function submit() {
+        const files = validate();
+        if (!files) {
+            if (currentPaths().length === 0) setError("Укажите путь к файлу или нажмите Ctrl+F");
+            pathInput.focus();
+            return;
+        }
+
+        const caption = captionInput.getValue().trim();
+        const asDocument = Boolean(asDocumentCheck.checked);
+        hide();
+        onSendFile?.(files, { caption, asDocument });
+    }
+
+    /** Завершает режим чтения textbox — иначе он заберёт фокус обратно по blur. */
+    function releaseInputs() {
+        for (const el of [pathInput, captionInput]) {
+            if (el._reading && typeof el._done === "function") el._done("stop");
+        }
+    }
+
+    function openPicker() {
+        releaseInputs();
+        picker.pick(
+            lastDir,
+            (filePath) => {
+                const existing = currentPaths();
+                existing.push(filePath);
+                pathInput.setValue(existing.join(` ${PATH_SEPARATOR} `));
+                validate();
+            },
+            () => {
+                // И после выбора, и после отмены возвращаемся в поле пути
+                modal.setFront();
+                pathInput.focus();
+                screen.render();
+            }
+        );
+    }
+
+    function toggleAsDocument() {
+        asDocumentCheck.toggle();
+        validate({ quiet: true });
+        screen.render();
+    }
+
+    // --- Кольцо фокуса ---
+    const RING = [pathInput, captionInput, asDocumentCheck, sendBtn, cancelBtn];
+
+    function moveFocus(step) {
+        // blessed вставляет "\t" в значение textbox ДО вызова обработчика
+        for (const el of [pathInput, captionInput]) {
+            if (typeof el.getValue === "function") {
+                const cleaned = el.getValue().replace(/\t+$/, "");
+                if (cleaned !== el.getValue()) el.setValue(cleaned);
+            }
+        }
+        const current = RING.indexOf(screen.focused);
+        const index = current === -1 ? 0 : current;
+        releaseInputs();
+        RING[(index + step + RING.length) % RING.length].focus();
+        screen.render();
+    }
+
+    for (const el of RING) {
+        el.key(["tab"], () => moveFocus(1));
+        el.key(["S-tab"], () => moveFocus(-1));
+        el.key(["C-f"], openPicker);
+        el.key(["C-d"], toggleAsDocument);
+    }
+
+    // Escape: у textbox он приходит событием "cancel", у остальных — клавишей
+    pathInput.on("cancel", hide);
+    captionInput.on("cancel", hide);
+    asDocumentCheck.key(["escape"], hide);
+    sendBtn.key(["escape"], hide);
+    cancelBtn.key(["escape"], hide);
+
+    // Enter ведёт по цепочке, с последнего поля — отправляет
+    pathInput.on("submit", () => {
+        validate();
+        captionInput.focus();
+    });
+    captionInput.on("submit", submit);
+    sendBtn.on("press", submit);
+    cancelBtn.on("press", hide);
+    asDocumentCheck.on("check", () => validate({ quiet: true }));
+    asDocumentCheck.on("uncheck", () => validate({ quiet: true }));
+
+    return {
+        modal,
+        pathInput,
+        captionInput,
+        asDocumentCheck,
+        statusLine,
+        picker,
+        show,
+        hide,
+    };
+}

package/src/ui/components/modals/filePickerModal.js

@@ -0,0 +1,214 @@
+import blessed from "neo-blessed";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { formatFileSize } from "../../../utils/time.js";
+import { fg } from "../../theme.js";
+
+/**
+ * Модальное окно выбора локального файла (обёртка над blessed.filemanager).
+ *
+ * Клавиши вешаются на сам список: blessed рассылает события только
+ * сфокусированному элементу, обработчики на контейнере не срабатывают.
+ * @param {blessed.Widgets.Screen} screen
+ * @param {object} theme
+ * @returns {{ modal: object, pick: (startDir: string|null, onPick: (filePath: string) => void) => void, hide: () => void }}
+ */
+export function createFilePickerModal(screen, theme) {
+    const modal = blessed.box({
+        parent: screen,
+        top: "center",
+        left: "center",
+        width: "60%",
+        height: "60%",
+        hidden: true,
+        tags: true,
+        border: {
+            type: "line",
+        },
+        shadow: true,
+        style: {
+            bg: theme.modal.bg,
+            fg: theme.modal.fg,
+            border: {
+                fg: theme.modal.borderFg,
+            },
+        },
+    });
+
+    const header = blessed.box({
+        parent: modal,
+        top: 0,
+        left: 1,
+        right: 1,
+        height: 1,
+        tags: true,
+        style: { bg: theme.modal.bg, fg: theme.modal.fg },
+    });
+
+    const manager = blessed.filemanager({
+        parent: modal,
+        top: 1,
+        left: 1,
+        right: 1,
+        bottom: 2,
+        keys: true,
+        vi: true,
+        mouse: true,
+        cwd: os.homedir(),
+        scrollbar: {
+            ch: "│",
+            style: { bg: theme.scrollbar.bg, fg: theme.scrollbar.fg },
+        },
+        style: {
+            bg: theme.modal.bg,
+            fg: theme.modal.fg,
+            selected: {
+                bg: theme.modal.selectedBg,
+                fg: theme.modal.selectedFg,
+                bold: true,
+            },
+        },
+    });
+
+    const footer = blessed.box({
+        parent: modal,
+        bottom: 0,
+        left: 1,
+        right: 1,
+        height: 2,
+        tags: true,
+        style: { bg: theme.modal.bg, fg: theme.modal.fg },
+    });
+
+    let onPickCallback = null;
+    let onCloseCallback = null;
+
+    function renderHeader() {
+        const cwd = manager.cwd.replace(os.homedir(), "~");
+        header.setContent(` {bold}📁 Выбор файла:{/bold} ${cwd}`);
+    }
+
+    /**
+     * Показывает размер подсвеченного файла — filemanager сам этого не умеет.
+     * Имя берём из ritems (исходная строка с тегами), а не из getContent():
+     * последний уже содержит ANSI-последовательности, из которых имя не вычленить.
+     * @param {number} index
+     */
+    function renderFooter(index) {
+        const hint = fg(theme.modal.hintFg, "[↑↓] Выбор  [Enter] Открыть/Выбрать  [Esc] Отмена");
+        const raw = manager.ritems?.[index];
+        let info = "";
+
+        if (raw) {
+            const name = String(raw).replace(/\{[^{}]+\}/g, "").replace(/[@/]$/, "");
+            if (name && name !== "..") {
+                try {
+                    const stat = fs.statSync(path.resolve(manager.cwd, name));
+                    info = stat.isDirectory()
+                        ? fg(theme.picker.dirFg, `${name}/ — папка`)
+                        : fg(theme.success, `${name} · ${formatFileSize(stat.size)}`);
+                } catch {
+                    info = fg(theme.error, `${name} — недоступен`);
+                }
+            }
+        }
+        footer.setContent(` ${info}\n ${hint}`);
+    }
+
+    function hide() {
+        if (modal.hidden) return;
+        modal.hide();
+        onPickCallback = null;
+        // Куда вернуть фокус, решает вызывающая сторона: собственный previousFocus
+        // здесь ненадёжен, потому что textbox по blur успевает сделать rewindFocus.
+        const close = onCloseCallback;
+        onCloseCallback = null;
+        close?.();
+        screen.render();
+    }
+
+    /**
+     * Перекрашивает элементы под тему.
+     *
+     * blessed.filemanager жёстко вписывает {light-blue-fg} для папок и
+     * {light-cyan-fg} для симлинков — на фоне модалки такие имена нечитаемы.
+     * Формат "имя" + "/" или "@" сохраняем: по нему виджет находит файл обратно.
+     */
+    function recolorItems() {
+        const source = manager.ritems.slice();
+        if (source.length === 0) return;
+
+        const selected = manager.selected;
+        const painted = source.map((raw) => {
+            const bare = String(raw).replace(/\{[^{}]+\}/g, "");
+            if (bare.endsWith("/")) {
+                return `${fg(theme.picker.dirFg, bare.slice(0, -1))}/`;
+            }
+            if (bare.endsWith("@")) {
+                return `${fg(theme.picker.linkFg, bare.slice(0, -1))}@`;
+            }
+            return fg(theme.picker.fileFg, bare);
+        });
+
+        if (painted.every((text, i) => text === source[i])) return;
+        manager.setItems(painted);
+        manager.select(Math.min(selected, painted.length - 1));
+    }
+
+    manager.on("refresh", recolorItems);
+
+    manager.on("select item", (item, index) => {
+        renderFooter(index);
+        screen.render();
+    });
+
+    manager.on("cd", () => {
+        renderHeader();
+        renderFooter(-1);
+        screen.render();
+    });
+
+    manager.on("file", (filePath) => {
+        // Сначала отдаём результат, потом закрываем: onClose возвращает фокус,
+        // и вызывающая сторона уже видит проставленное значение.
+        const cb = onPickCallback;
+        onPickCallback = null;
+        cb?.(filePath);
+        hide();
+    });
+
+
+    manager.on("error", () => {
+        renderFooter(-1);
+        screen.render();
+    });
+
+    // filemanager сам отдаёт "cancel" по Escape (list.js), но у него нет hide()
+    manager.key(["escape", "q"], hide);
+    manager.on("cancel", hide);
+
+    return {
+        modal,
+        manager,
+        /**
+         * @param {string|null} startDir каталог, с которого начать
+         * @param {(filePath: string) => void} onPick вызывается при выборе файла
+         * @param {() => void} [onClose] вызывается после закрытия — и при выборе, и при отмене
+         */
+        pick: (startDir, onPick, onClose) => {
+            onPickCallback = onPick;
+            onCloseCallback = onClose;
+            const cwd = startDir && fs.existsSync(startDir) ? startDir : os.homedir();
+            modal.show();
+            modal.setFront();
+            manager.refresh(cwd, () => {
+                renderHeader();
+                renderFooter(manager.selected);
+                manager.focus();
+                screen.render();
+            });
+        },
+        hide,
+    };
+}

package/src/ui/components/modals/helpModal.js

@@ -0,0 +1,131 @@
+import blessed from "neo-blessed";
+
+/**
+ * Создаёт модальное окно справки по всем горячим клавишам и возможностям.
+ * @param {blessed.Widgets.Screen} screen
+ * @param {object} theme
+ * @returns {{ show: () => void, hide: () => void }}
+ */
+export function createHelpModal(screen, theme) {
+    const modal = blessed.box({
+        parent: screen,
+        top: "center",
+        left: "center",
+        width: "70%",
+        height: "80%",
+        hidden: true,
+        tags: true,
+        border: {
+            type: "line",
+        },
+        shadow: true,
+        style: {
+            bg: theme.modal.bg,
+            fg: theme.modal.fg,
+            border: {
+                fg: theme.modal.borderFg,
+            },
+        },
+    });
+
+    const K_CYAN = `{${theme.accent}-fg}`;
+    const K_GREEN = `{${theme.success}-fg}`;
+    const K_YELLOW = `{${theme.warning}-fg}`;
+    const K_MAGENTA = `{${theme.info}-fg}`;
+    const K_RED = `{${theme.error}-fg}`;
+    const K_GRAY = `{${theme.modal.hintFg}-fg}`;
+    const K_END = "{/}";
+
+    const content = `
+ {bold}{underline}🚀 TuiGram — Горячие клавиши и управление{/underline}{/bold}
+
+ {bold}Навигация и фокус:{/bold}
+   ${K_CYAN}[Tab]${K_END} / ${K_CYAN}[Shift+Tab]${K_END}  Фокус по кругу: Список чатов → Лента сообщений → Ввод
+   ${K_CYAN}[↑] / [↓]${K_END}           Перемещение по списку чатов
+   ${K_CYAN}[Enter]${K_END}             Открыть выбранный чат / Загрузить историю
+   ${K_CYAN}[PageUp] / [Ctrl+U]${K_END} Прокрутка сообщений вверх / Подгрузка старой истории
+   ${K_CYAN}[PageDown] / [Ctrl+D]${K_END}Прокрутка сообщений вниз
+
+ {bold}Вкладки фильтрации диалогов (нажмите цифру в списке чатов):{/bold}
+   ${K_YELLOW}[1]${K_END} Все чаты       ${K_YELLOW}[2]${K_END} Личные (ЛС)     ${K_YELLOW}[3]${K_END} Группы
+   ${K_YELLOW}[4]${K_END} Каналы         ${K_YELLOW}[5]${K_END} Боты            ${K_YELLOW}[6]${K_END} Непрочитанные
+   ${K_YELLOW}[/]${K_END} Поиск чатов по названию/username
+
+ {bold}Работа с сообщениями:{/bold}
+   ${K_GREEN}[Enter]${K_END}             Отправить набранный текст
+   ${K_GREEN}[Ctrl+J]${K_END}            Перенос строки без отправки
+   ${K_GREEN}[Ctrl+R]${K_END}            Ответить (Reply) на последнее сообщение
+   ${K_GREEN}[Ctrl+E]${K_END}            Редактировать своё последнее сообщение
+   ${K_GREEN}[Ctrl+A]${K_END}            Контекстное меню действий (Реакции, Удаление, Скачивание)
+   ${K_GREEN}[Ctrl+O]${K_END}            Отправить файл / картинку / документ
+   ${K_GREEN}  [Ctrl+F]${K_END}          — в окне отправки: обзор файлов
+   ${K_GREEN}  [Ctrl+D]${K_END}          — в окне отправки: послать без сжатия, файлом
+   ${K_GREEN}[Ctrl+P]${K_END}            Информация о текущем чате (ID, участники, ссылки)
+   ${K_GREEN}[Esc]${K_END}               Сбросить режим ответа / редактирования / закрыть окно
+
+ {bold}Слэш-команды в поле ввода:{/bold}
+   ${K_MAGENTA}/help${K_END}               Показать данную справку
+   ${K_MAGENTA}/info${K_END}               Сведения о текущем чате
+   ${K_MAGENTA}/sendfile${K_END}           Открыть окно отправки файла
+   ${K_MAGENTA}/sendfile <путь>${K_END}    Отправить файл (поддерживает ~ и пути с пробелами)
+   ${K_MAGENTA}/sendfile a | b -- текст${K_END}
+                       Альбом из нескольких файлов с подписью
+   ${K_MAGENTA}/clear${K_END}              Очистить историю сообщений на экране
+   ${K_MAGENTA}/logout${K_END}             Выйти из аккаунта
+
+ {bold}Выход:{/bold}
+   ${K_RED}[Ctrl+Q]${K_END} или ${K_RED}[Ctrl+C]${K_END}   Безопасный выход из клиента
+`;
+
+    modal.setContent(content);
+
+    const closeBtn = blessed.button({
+        parent: modal,
+        bottom: 1,
+        left: "center",
+        width: 16,
+        height: 1,
+        mouse: true,
+        content: " [ Закрыть ] ",
+        align: "center",
+        tags: true,
+        style: {
+            bg: theme.accent,
+            fg: theme.onAccent,
+            focus: {
+                bg: theme.modal.buttonFocusBg,
+                fg: theme.modal.buttonFocusFg,
+                bold: true,
+            },
+        },
+    });
+
+    let previousFocus = null;
+
+    function hide() {
+        modal.hide();
+        if (previousFocus) {
+            previousFocus.focus();
+            previousFocus = null;
+        }
+        screen.render();
+    }
+
+    function show() {
+        previousFocus = screen.focused;
+        modal.show();
+        modal.setFront();
+        closeBtn.focus();
+        screen.render();
+    }
+
+    closeBtn.on("press", hide);
+    // Клавиши вешаем на кнопку: blessed отдаёт события только сфокусированному элементу.
+    closeBtn.key(["escape", "q", "f1"], hide);
+
+    return {
+        modal,
+        show,
+        hide,
+    };
+}