@emaxe/tuigram 1.1.0 → 1.3.0

package/.env.example

@@ -28,6 +28,13 @@ AUTO_SCROLL=true
 # Показывать уведомления о наборе текста (true/false)
 SHOW_TYPING=true
 
+# Отображение цветных превью изображений в чате (true/false)
+SHOW_IMAGES=true
+
+# Максимальные размеры превью изображений в символах терминала (ширина x высота)
+IMAGE_MAX_WIDTH=36
+IMAGE_MAX_HEIGHT=14
+
 # ── Proxy Settings ────────────────────────────────────────────────────────────
 # Поддерживаются HTTP и SOCKS5 (как с авторизацией, так и без).
 # Формат единого URL:

package/CHANGELOG.md

@@ -13,6 +13,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 - English localization of the TUI and CLI interface strings.
 
+## [1.3.0] — 2026-09-01
+
+### Added
+
+- Comprehensive mouse support across the entire TUI:
+  - Direct panel focus on click (left panel for dialog list, middle panel for message feed, bottom panel for input box).
+  - Single-click dialog selection and immediate opening.
+  - Smooth mouse wheel scrolling for dialog list and message feed with automatic loading of older history when scrolling up past the top.
+  - Clicking on any message opens its contextual action menu (reactions, replies, edits, downloads, deletion).
+  - Clickable filter tabs (`1:Все`, `2:ЛС`, `3:Группы`, `4:Каналы`, `5:Боты`, `6:Непроч`) and search input focusing.
+  - Interactive status bar buttons (`[Tab]`, `[1-6]`, `[/]`, `[F1]`, `[Ctrl+A]`, `[Ctrl+P]`, `[Ctrl+Q]`).
+  - Interactive header elements: click logo for Help, click chat title for Chat Info, click status badge for network state.
+  - Interactive context bar in input box: click to cancel reply/edit mode or trigger shortcuts.
+  - Full mouse navigation inside modals (button clicks, checkbox toggles, file browsing) and dismissing any modal by clicking outside its boundary.
+- Robust terminal mouse mode initialization (`\x1b[?1000h\x1b[?1002h\x1b[?1006h\x1b[?1015h`) supporting modern terminals (macOS Terminal.app, iTerm2, Alacritty, Kitty, Windows Terminal, xterm).
+- Pure mouse coordinate calculation utilities (`src/utils/mouse.js`) with full test coverage in `test/unit.test.js`.
+
+## [1.2.0] — 2026-09-01
+
+### Added
+
+- Display color image previews directly in chat messages using high-resolution Unicode half-block characters (`▀` `U+2580`) with instant rendering of Telegram stripped thumbnails (`PhotoStrippedSize`).
+- Configuration options `SHOW_IMAGES`, `IMAGE_MAX_WIDTH`, and `IMAGE_MAX_HEIGHT` to control image preview rendering in `.env` and `config.js`.
+
 ## [1.1.0] — 2026-08-31
 
 ### Added
@@ -111,7 +135,9 @@ First public release.
 - A WCAG contrast test (3:1 threshold) applied to every theme **after** conversion
   to xterm-256 — the colors are checked exactly as the user sees them.
 
-[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.1.0...HEAD
+[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.3.0...HEAD
+[1.3.0]: https://github.com/emaxe/tuigram/compare/v1.2.0...v1.3.0
+[1.2.0]: https://github.com/emaxe/tuigram/compare/v1.1.0...v1.2.0
 [1.1.0]: https://github.com/emaxe/tuigram/compare/v1.0.1...v1.1.0
 [1.0.1]: https://github.com/emaxe/tuigram/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/emaxe/tuigram/releases/tag/v1.0.0

package/CHANGELOG.ru.md

@@ -13,6 +13,30 @@
 
 - Английская локализация строк интерфейса TUI и CLI.
 
+## [1.3.0] — 2026-09-01
+
+### Добавлено
+
+- Полноценная поддержка управления мышью во всём TUI-интерфейсе:
+  - Фокусировка любой панели по клику (список чатов, лента сообщений, поле ввода).
+  - Открытие диалога в один клик по элементу списка.
+  - Плавная прокрутка списка чатов и ленты сообщений колесом мыши с автоматической подгрузкой старой истории при прокрутке вверх.
+  - Открытие меню действий над сообщением (реакции, ответ, редактирование, скачивание, удаление) по прямому клику на сообщение.
+  - Интерактивные вкладки фильтрации (`1:Все`, `2:ЛС`, `3:Группы`, `4:Каналы`, `5:Боты`, `6:Непроч`) и строка поиска в списке диалогов.
+  - Интерактивная нижняя строка состояния (`[Tab]`, `[1-6]`, `[/]`, `[F1]`, `[Ctrl+A]`, `[Ctrl+P]`, `[Ctrl+Q]`).
+  - Интерактивный верхний заголовок: клик по логотипу открывает справку, по названию активного чата — сведения о чате, по статусу — информацию о сети.
+  - Контекстная строка поля ввода: клик сбрасывает режим ответа/редактирования либо запускает команды.
+  - Поддержка мыши во всех модальных окнах (клики по кнопкам, чекбоксам, файлам в проводнике) и закрытие модалок по клику мимо окна.
+- Надёжная инициализация режимов мыши терминала (`\x1b[?1000h\x1b[?1002h\x1b[?1006h\x1b[?1015h`) с поддержкой современных эмуляторов (macOS Terminal.app, iTerm2, Alacritty, Kitty, Windows Terminal, xterm).
+- Чистые утилиты расчёта координат мыши (`src/utils/mouse.js`) и покрытие юнит-тестами в `test/unit.test.js`.
+
+## [1.2.0] — 2026-09-01
+
+### Добавлено
+
+- Отображение цветных превью изображений прямо в ленте сообщений чата с помощью псевдографики высокого разрешения (Unicode Half-Block `▀` `U+2580`) и мгновенного рендеринга миниатюр `PhotoStrippedSize`.
+- Параметры конфигурации `SHOW_IMAGES`, `IMAGE_MAX_WIDTH` и `IMAGE_MAX_HEIGHT` в `.env` и `config.js` для управления отображением превью и их максимальным размером.
+
 ## [1.1.0] — 2026-08-31
 
 ### Добавлено
@@ -113,7 +137,9 @@
 - Тест контраста по WCAG (порог 3:1) для каждой темы — **после** конверсии в xterm-256,
   то есть ровно в том виде, в каком цвет увидит пользователь.
 
-[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.1.0...HEAD
+[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.3.0...HEAD
+[1.3.0]: https://github.com/emaxe/tuigram/compare/v1.2.0...v1.3.0
+[1.2.0]: https://github.com/emaxe/tuigram/compare/v1.1.0...v1.2.0
 [1.1.0]: https://github.com/emaxe/tuigram/compare/v1.0.1...v1.1.0
 [1.0.1]: https://github.com/emaxe/tuigram/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/emaxe/tuigram/releases/tag/v1.0.0

package/README.md

@@ -52,9 +52,11 @@ TuiGram lets you use Telegram entirely from the terminal: browse your dialog lis
 - [Where files are stored](#-where-files-are-stored)
 - [Development](#-development)
 - [Keyboard shortcuts](#️-keyboard-shortcuts)
+- [Mouse controls](#-mouse-controls)
 - [Slash commands](#-slash-commands-in-the-input-box)
 - [Sending files and images](#-sending-files-and-images)
 - [Themes](#-themes)
+- [Inline image previews](#️-inline-image-previews)
 - [Proxy configuration](#-proxy-configuration)
 - [Command line usage (CLI)](#️-command-line-usage-cli)
 - [Project structure](#-project-structure)
@@ -74,6 +76,7 @@ TuiGram lets you use Telegram entirely from the terminal: browse your dialog lis
   - Instant search and filtering of chats by title and `@username` (`/`);
   - Live typing indicator ("… is typing");
   - Colored rendering of Telegram entities (bold, italic, monospace code, URLs, mentions, spoilers);
+  - High-resolution inline image previews (Unicode Half-Block `▀` pixel art);
   - Media attachment indicators (photo, video, document, voice, sticker, poll);
   - Message reactions (👍, 🔥, ❤️);
   - Infinite upward pagination of message history (`PageUp` / `Ctrl+U`);
@@ -450,6 +453,28 @@ node scripts/check-package.js   # verifies that .env and the session do not leak
 
 ---
 
+## 🖱 Mouse controls
+
+TuiGram fully supports mouse interaction in terminals that support mouse reporting (macOS Terminal, iTerm2, Alacritty, Kitty, Windows Terminal, Linux virtual terminals):
+
+| Action | Target | Result |
+|---|---|---|
+| Click | Left / Middle / Bottom panel | Focus the clicked panel |
+| Click | Chat item in dialog list | Immediately select and open the chat |
+| Click | Filter tabs `1:Все` .. `6:Непроч` | Switch chat category filter |
+| Click | Search bar `[/]` | Focus search box and clear placeholder |
+| Wheel scroll | Dialog list / Message feed | Smooth scroll (scrolling up to the top loads older messages) |
+| Click | Any message line | Open message action menu (reactions, reply, edit, download, delete) |
+| Click | Header logo 🚀 | Open Help window |
+| Click | Header active chat title | Open Chat Info window |
+| Click | Header connection badge | Show active network status |
+| Click | Input context bar | Cancel reply/edit mode or insert `/` |
+| Click | Status bar items | Trigger corresponding action (`[Tab]`, `[F1]`, `[Ctrl+A]`, `[Ctrl+Q]`, etc.) |
+| Click | Outside any modal window | Dismiss / close modal |
+| Click | Buttons in modals | Click buttons (`[ Отправить ]`, `[ Отмена ]`, `[ Закрыть ]`, toggle checkboxes) |
+
+---
+
 ## 💬 Slash commands in the input box
 
 Quick commands are available in the message input box (they start with `/`):
@@ -512,6 +537,23 @@ The contrast of every "text on background" pair is verified by an automated WCAG
 
 ---
 
+## 🖼️ Inline image previews
+
+TuiGram displays color image previews directly in the chat history using high-resolution Unicode half-block characters (`▀` `U+2580`). Each character cell renders 2 vertical subpixels with 24-bit RGB colors, producing crisp, proportional pixel art that scrolls naturally with messages and works across all terminals.
+
+Previews are enabled by default and can be configured in `.env`:
+
+```env
+# Enable/disable image previews in chat (true/false)
+SHOW_IMAGES=true
+
+# Maximum preview size in terminal characters (width x height)
+IMAGE_MAX_WIDTH=36
+IMAGE_MAX_HEIGHT=14
+```
+
+---
+
 ## 🌐 Proxy configuration
 
 TuiGram supports routing MTProto connections through HTTP (including HTTPS CONNECT) and SOCKS5/SOCKS4 proxies — both with and without username/password authentication.
@@ -612,6 +654,7 @@ TuiGram/
 │   │   ├── init.js              # tuigram init / paths — setup and diagnostics
 │   │   └── formatters.js        # Console table and log formatters
 │   └── utils/
+│       ├── image.js             # Image decoding, resizing and Half-Block ANSI rendering
 │       ├── storage.js           # File operations and session persistence
 │       └── time.js              # Time and date formatting
 ├── scripts/

package/README.ru.md

@@ -48,9 +48,11 @@
 - [Где хранятся файлы](#-где-хранятся-файлы)
 - [Разработка](#-разработка)
 - [Горячие клавиши](#️-горячие-клавиши)
+- [Управление мышью](#-управление-мышью)
 - [Слэш-команды](#-слэш-команды-в-поле-ввода)
 - [Отправка файлов и картинок](#-отправка-файлов-и-картинок)
 - [Темы оформления](#-темы-оформления)
+- [Превью изображений в сообщениях](#️-превью-изображений-в-сообщениях)
 - [Прокси-сервер](#-прокси-сервер)
 - [Использование через консоль (CLI)](#️-использование-через-консоль-cli)
 - [Структура проекта](#-структура-проекта)
@@ -70,6 +72,7 @@
   - Мгновенный поиск и фильтрация чатов по названию и `@username` (`/`);
   - Отображение статуса набора текста («Собеседник печатает...») в реальном времени;
   - Цветовое форматирование Telegram Entities (Bold, Italic, Monospace Code, URLs, Mentions, Spoilers);
+  - Цветные превью изображений высокого разрешения прямо в чате (Unicode Half-Block `▀` pixel art);
   - Индикаторы медиа-вложений (фото, видео, документы, голосовые, стикеры, опросы);
   - Реакции на сообщения (👍, 🔥, ❤️);
   - Бесконечная пагинация истории сообщений вверх (`PageUp` / `Ctrl+U`);
@@ -442,6 +445,28 @@ node scripts/check-package.js   # проверка, что в пакет не у
 
 ---
 
+## 🖱 Управление мышью
+
+TuiGram полноценно поддерживает управление мышью во всех современных терминалах (Terminal.app, iTerm2, Alacritty, Kitty, Windows Terminal, xterm):
+
+| Действие | Где | Результат |
+|---|---|---|
+| Клик | Левая / Центральная / Нижняя панель | Переключение фокуса на выбранную панель |
+| Клик | Диалог в списке чатов | Мгновенный выбор и открытие чата |
+| Клик | Вкладки `1:Все` .. `6:Непроч` | Переключение фильтра категории чатов |
+| Клик | Поле поиска `[/]` | Фокус в поиск с очисткой подсказки |
+| Колесо мыши | Список чатов / Лента сообщений | Плавная прокрутка (прокрутка вверх в ленте подгружает историю) |
+| Клик | Любое сообщение | Открытие меню действий (реакции, ответ, редактирование, удаление) |
+| Клик | Логотип 🚀 в шапке | Открытие окна справки |
+| Клик | Название активного чата в шапке | Открытие информации о текущем чате |
+| Клик | Индикатор статуса в шапке | Просмотр статуса MTProto подключения |
+| Клик | Контекстная плашка ввода | Сброс режима ответа/редактирования или вставка `/` |
+| Клик | Кнопки строки состояния | Быстрый вызов действий (`[Tab]`, `[F1]`, `[Ctrl+A]`, `[Ctrl+Q]` и др.) |
+| Клик | Мимо любого модального окна | Закрытие модального окна |
+| Клик | Кнопки в модалках | Нажатие кнопки (`[ Отправить ]`, `[ Отмена ]`, `[ Закрыть ]`, чекбоксы) |
+
+---
+
 ## 💬 Слэш-команды в поле ввода
 
 В поле ввода сообщения доступны быстрые команды (начинаются с `/`):
@@ -506,6 +531,23 @@ TUI_THEME=light     # светлая
 
 ---
 
+## 🖼️ Превью изображений в сообщениях
+
+TuiGram отображает цветные превью фотографий прямо в ленте сообщений чата с помощью псевдографики высокого разрешения (Unicode Half-Block `▀` `U+2580`). Каждое знакоместо терминала вмещает 2 вертикальных субпикселя с 24-битными цветами, обеспечивая чёткое пропорциональное изображение 1:1, которое плавно прокручивается вместе с сообщениями и поддерживается всеми терминалами.
+
+Отображение превью включено по умолчанию и настраивается в `.env`:
+
+```env
+# Включение/отключение превью картинок в чате (true/false)
+SHOW_IMAGES=true
+
+# Максимальный размер превью в символах терминала (ширина x высота)
+IMAGE_MAX_WIDTH=36
+IMAGE_MAX_HEIGHT=14
+```
+
+---
+
 ## 🌐 Прокси-сервер
 
 TuiGram поддерживает маршрутизацию MTProto-соединений через HTTP (включая HTTPS CONNECT) и SOCKS5/SOCKS4 прокси — как с авторизацией по логину и паролю, так и без неё.
@@ -606,6 +648,7 @@ TuiGram/
 │   │   ├── init.js              # tuigram init / paths — настройка и диагностика
 │   │   └── formatters.js        # Консольные форматтеры таблиц и логов
 │   └── utils/
+│       ├── image.js             # Декодирование, масштабирование и Half-Block ANSI рендеринг изображений
 │       ├── storage.js           # Файловые операции и сохранение сессий
 │       └── time.js              # Форматирование времени и дат
 ├── scripts/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emaxe/tuigram",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Полнофункциональный TUI & CLI клиент Telegram на Node.js на базе MTProto (teleproto)",
   "type": "module",
   "exports": {
@@ -70,7 +70,9 @@
     "colorette": "^2.0.20",
     "dotenv": "^16.4.7",
     "input": "^1.0.1",
+    "jpeg-js": "^0.4.4",
     "neo-blessed": "^0.2.0",
+    "pngjs": "^7.0.0",
     "teleproto": "^1.229.0"
   }
 }

package/src/config.js

@@ -251,6 +251,9 @@ export const config = {
     theme: process.env.TUI_THEME || "default",
     autoScroll: String(process.env.AUTO_SCROLL || "true").toLowerCase() === "true",
     showTyping: String(process.env.SHOW_TYPING || "true").toLowerCase() === "true",
+    showImages: String(process.env.SHOW_IMAGES || "true").toLowerCase() !== "false",
+    imageMaxWidth: parseInt(process.env.IMAGE_MAX_WIDTH || "36", 10) || 36,
+    imageMaxHeight: parseInt(process.env.IMAGE_MAX_HEIGHT || "14", 10) || 14,
 
     proxy: parseProxyConfig(),
 

package/src/state.js

@@ -140,7 +140,7 @@ class AppState extends EventEmitter {
         combined.sort((a, b) => (a.date || 0) - (b.date || 0) || (a.id - b.id));
 
         this.messagesByChat.set(chatId, combined);
-        this.emit("messages_updated", { chatId, messages: combined, isPrepend: prepend });
+        this.emit("messages_updated", { chatId, messages: combined, isPrepend: prepend, isUpdate: false });
     }
 
     /**
@@ -181,7 +181,7 @@ class AppState extends EventEmitter {
             this.emit("dialogs_updated", this.getVisibleDialogs());
         }
 
-        this.emit("messages_updated", { chatId, messages: list, isPrepend: false });
+        this.emit("messages_updated", { chatId, messages: list, isPrepend: false, isNewMessage: true });
     }
 
     /**
@@ -194,7 +194,7 @@ class AppState extends EventEmitter {
         const index = list.findIndex((m) => m.id === updatedMessage.id);
         if (index !== -1) {
             list[index] = { ...list[index], ...updatedMessage };
-            this.emit("messages_updated", { chatId, messages: list, isPrepend: false });
+            this.emit("messages_updated", { chatId, messages: list, isPrepend: false, isUpdate: true });
         }
     }
 
@@ -208,7 +208,7 @@ class AppState extends EventEmitter {
         const idSet = new Set(deletedIds);
         const filtered = list.filter((m) => !idSet.has(m.id));
         this.messagesByChat.set(chatId, filtered);
-        this.emit("messages_updated", { chatId, messages: filtered, isPrepend: false });
+        this.emit("messages_updated", { chatId, messages: filtered, isPrepend: false, isUpdate: true });
     }
 
     /**

package/src/telegram/messages.js

@@ -1,6 +1,8 @@
 import { Api, errors } from "teleproto";
 import { idToString, toMarkedId, getEntityDisplayName, entityCache, resolveEntity } from "./entities.js";
 import { describeMedia } from "./formatter.js";
+import { config } from "../config.js";
+import { renderStrippedThumbnail, renderImageBuffer } from "../utils/image.js";
 
 const { FloodWaitError } = errors;
 
@@ -38,6 +40,27 @@ export function normalizeMessage(message) {
         }
     }
 
+    // Извлечение и рендеринг PhotoStrippedSize в псевдографику
+    let imagePreview = null;
+    if (config.showImages && message.media) {
+        const media = message.media;
+        const photo = media.photo;
+        const doc = media.document;
+        const sizes = photo?.sizes || doc?.thumbs || [];
+        const stripped = sizes.find((s) => s?.className === "PhotoStrippedSize" || s?.type === "i" || (s?.bytes && s.bytes.length > 0));
+
+        if (stripped?.bytes) {
+            const cacheKey = photo?.id
+                ? `photo_${photo.id}`
+                : (doc?.id ? `doc_${doc.id}` : `msg_${message.id}`);
+            imagePreview = renderStrippedThumbnail(stripped.bytes, {
+                maxWidth: config.imageMaxWidth,
+                maxHeight: config.imageMaxHeight,
+                cacheKey,
+            }) || null;
+        }
+    }
+
     return {
         id: message.id,
         date: message.date ? message.date * 1000 : Date.now(),
@@ -53,6 +76,7 @@ export function normalizeMessage(message) {
         forwards: message.forwards || null,
         media: message.media || null,
         mediaDescription: describeMedia(message.media),
+        imagePreview,
         entities: message.entities || [],
         reactions,
         rawMessage: message,
@@ -263,3 +287,37 @@ export async function markAsRead(client, rawPeer, maxId = 0) {
         // Игнорируем незначительные сетевые ошибки прочтения
     }
 }
+
+/**
+ * Асинхронно загружает и декодирует превью изображения сообщения через MTProto.
+ * @param {import("teleproto").TelegramClient} client
+ * @param {object} rawMessage
+ * @param {object} [options]
+ * @param {number} [options.maxWidth]
+ * @param {number} [options.maxHeight]
+ * @returns {Promise<string>}
+ */
+export async function loadMessageImagePreview(client, rawMessage, { maxWidth = config.imageMaxWidth, maxHeight = config.imageMaxHeight } = {}) {
+    if (!rawMessage?.media) return "";
+    const media = rawMessage.media;
+    const isPhoto = media.className === "MessageMediaPhoto";
+    const isDoc = media.className === "MessageMediaDocument";
+    if (!isPhoto && !isDoc) return "";
+
+    const cacheKey = isPhoto
+        ? `photo_full_${media.photo?.id || rawMessage.id}`
+        : `doc_full_${media.document?.id || rawMessage.id}`;
+
+    try {
+        const thumbBuf = await client.downloadMedia(media, { thumb: 1 });
+        if (!thumbBuf || thumbBuf.length === 0) return "";
+        return renderImageBuffer(thumbBuf, {
+            maxWidth,
+            maxHeight,
+            cacheKey,
+        });
+    } catch {
+        return "";
+    }
+}
+

package/src/ui/app.js

@@ -16,7 +16,7 @@ import { state } from "../state.js";
 import { config } from "../config.js";
 import { fetchDialogs } from "../telegram/dialogs.js";
 import { setMessagePalette } from "../telegram/formatter.js";
-import { fetchHistory, sendMessage, editMessage, deleteMessages, sendFiles, downloadMedia, sendReaction, markAsRead } from "../telegram/messages.js";
+import { fetchHistory, sendMessage, editMessage, deleteMessages, sendFiles, downloadMedia, sendReaction, markAsRead, loadMessageImagePreview } from "../telegram/messages.js";
 import { startTelegramListener } from "../telegram/listener.js";
 import { logout } from "../telegram/auth.js";
 import { ensureDir, inspectLocalFile } from "../utils/storage.js";
@@ -43,8 +43,79 @@ export async function startTui(client, me) {
     state.setConnectionStatus("connected");
 
     // 1. Создание визуальных компонентов
-    const header = createHeader(screen, theme);
-    const statusBar = createStatusBar(screen, theme);
+    const header = createHeader(screen, theme, {
+        onHelp: () => {
+            releaseInputs();
+            helpModal.show();
+        },
+        onChatInfo: () => {
+            if (state.activeChat) {
+                releaseInputs();
+                chatInfoModal.show(state.activeChat);
+            } else {
+                statusBar.showMessage("Сначала выберите чат слева!", "warning");
+            }
+        },
+        onStatusClick: () => {
+            const statusText = state.connectionStatus === "connected"
+                ? "Подключение активно: MTProto онлайн"
+                : `Статус сети: ${state.connectionStatus}`;
+            statusBar.showMessage(statusText, "info");
+        },
+    });
+
+    const statusBar = createStatusBar(screen, theme, {
+        onFocusNext: () => moveFocus(1),
+        onSelectOrSubmit: () => {
+            const focused = detectFocus();
+            if (focused === "input") {
+                inputBox.textarea.emit("key enter");
+            } else if (focused === "chatList") {
+                chatList.list.emit("key enter");
+            }
+        },
+        onFilterTabs: () => {
+            releaseInputs();
+            chatList.focus();
+            statusBar.showMessage("Фильтры: нажмите 1-6 для выбора вкладки", "info");
+        },
+        onSearch: () => {
+            chatList.searchBox.setValue("");
+            chatList.searchBox.focus();
+            screen.render();
+        },
+        onHelp: () => {
+            releaseInputs();
+            helpModal.show();
+        },
+        onAction: () => {
+            if (!state.activeChat) {
+                statusBar.showMessage("Сначала выберите чат слева!", "warning");
+                return;
+            }
+            const msgs = state.getMessages(state.activeChat.id);
+            if (msgs.length > 0) {
+                releaseInputs();
+                actionModal.show(msgs[msgs.length - 1]);
+            }
+        },
+        onChatInfo: () => {
+            if (state.activeChat) {
+                releaseInputs();
+                chatInfoModal.show(state.activeChat);
+            } else {
+                statusBar.showMessage("Сначала выберите чат слева!", "warning");
+            }
+        },
+        onQuit: () => {
+            releaseInputs();
+            confirmModal.ask("Выйти из TuiGram?", () => {
+                listener?.stop();
+                screen.destroy();
+                process.exit(0);
+            });
+        },
+    });
 
     // Модальные окна
     const helpModal = createHelpModal(screen, theme);
@@ -128,6 +199,7 @@ export async function startTui(client, me) {
                 state.setMessages(dialog.id, history.messages);
                 markAsRead(client, dialog.peerId).catch(() => {});
                 statusBar.showMessage(`Чат: ${dialog.title}`, "info");
+                fetchMissingImagePreviews(history.messages, dialog.id);
             } catch (err) {
                 statusBar.showMessage(`Ошибка загрузки: ${err.message}`, "error");
             }
@@ -157,6 +229,7 @@ export async function startTui(client, me) {
                 if (older.messages.length > 0) {
                     state.setMessages(state.activeChat.id, older.messages, true);
                     statusBar.showMessage(`Загружено ${older.messages.length} предыдущих сообщений`, "info");
+                    fetchMissingImagePreviews(older.messages, state.activeChat.id);
                 }
             } catch (err) {
                 statusBar.showMessage(`Ошибка пагинации: ${err.message}`, "error");
@@ -203,6 +276,21 @@ export async function startTui(client, me) {
         onCancelContext: () => {
             statusBar.showMessage("Режим ответа/редактирования сброшен", "info", 2000);
         },
+        onReplyLast: () => {
+            if (!state.activeChat) return;
+            const msgs = state.getMessages(state.activeChat.id);
+            if (msgs.length > 0) {
+                inputBox.setContext("reply", msgs[msgs.length - 1]);
+            }
+        },
+        onEditLast: () => {
+            if (!state.activeChat) return;
+            const msgs = state.getMessages(state.activeChat.id);
+            const ownMsgs = msgs.filter((m) => m.out);
+            if (ownMsgs.length > 0) {
+                inputBox.setContext("edit", ownMsgs[ownMsgs.length - 1]);
+            }
+        },
         onSlashCommand: (cmd, args) => {
             switch (cmd) {
                 case "help":
@@ -267,6 +355,33 @@ export async function startTui(client, me) {
         },
     });
 
+    // Переключение фокуса по клику мышью на любую из трех панелей
+    chatList.container.on("click", () => {
+        if (screen.focused !== chatList.list && screen.focused !== chatList.searchBox) {
+            releaseInputs();
+            chatList.focus();
+            statusBar.showMessage("Фокус: список чатов", "info", 2000);
+            screen.render();
+        }
+    });
+
+    chatView.container.on("click", () => {
+        if (screen.focused !== chatView.scrollBox) {
+            releaseInputs();
+            chatView.focus();
+            statusBar.showMessage("Фокус: лента сообщений", "info", 2000);
+            screen.render();
+        }
+    });
+
+    inputBox.container.on("click", () => {
+        if (screen.focused !== inputBox.textarea) {
+            inputBox.focus();
+            statusBar.showMessage("Фокус: поле ввода", "info", 2000);
+            screen.render();
+        }
+    });
+
     // 5. Реакция на события состояния
     state.on("dialogs_updated", (dialogs) => {
         chatList.setDialogs(dialogs);
@@ -291,9 +406,13 @@ export async function startTui(client, me) {
         chatView.setMessages(msgs);
     });
 
-    state.on("messages_updated", ({ chatId, messages, isPrepend }) => {
+    state.on("messages_updated", ({ chatId, messages, isPrepend, isUpdate, isNewMessage }) => {
         if (state.activeChat?.id === chatId) {
-            chatView.setMessages(messages, !isPrepend);
+            // Скроллим в самый низ только если это новое сообщение или первая загрузка чата.
+            // При подгрузке старых сообщений (isPrepend) или фоновых обновлениях (isUpdate)
+            // позиция скролла сохраняется!
+            const shouldScrollToBottom = isNewMessage ? config.autoScroll : (!isPrepend && !isUpdate);
+            chatView.setMessages(messages, shouldScrollToBottom);
         }
     });
 
@@ -316,11 +435,41 @@ export async function startTui(client, me) {
         }
     });
 
+    /**
+     * Фоново догружает превью изображений для сообщений, не имевших встроенного PhotoStrippedSize.
+     * @param {Array<object>} messages
+     * @param {string} chatId
+     */
+    async function fetchMissingImagePreviews(messages, chatId) {
+        if (!config.showImages || !messages || messages.length === 0) return;
+        for (const msg of messages) {
+            if (state.activeChat?.id !== chatId) break;
+            if (msg.media && !msg.imagePreview && msg.rawMessage) {
+                const isPhoto = msg.media.className === "MessageMediaPhoto";
+                const isDoc = msg.media.className === "MessageMediaDocument";
+                if (isPhoto || isDoc) {
+                    try {
+                        const preview = await loadMessageImagePreview(client, msg.rawMessage);
+                        if (preview && state.activeChat?.id === chatId) {
+                            msg.imagePreview = preview;
+                            state.updateMessage(chatId, msg);
+                        }
+                    } catch {
+                        // Игнорируем сетевые ошибки фоновой загрузки превью
+                    }
+                }
+            }
+        }
+    }
+
     // 6. Подключение фонового слушателя MTProto событий
     listener = startTelegramListener(client);
 
     listener.on("new_message", ({ peerId, message }) => {
         state.addMessage(peerId, message);
+        if (!message.imagePreview && (message.media?.className === "MessageMediaPhoto" || message.media?.className === "MessageMediaDocument")) {
+            fetchMissingImagePreviews([message], peerId);
+        }
 
         if (state.activeChat?.id === peerId) {
             markAsRead(client, state.activeChat.peerId).catch(() => {});
@@ -465,6 +614,21 @@ export async function startTui(client, me) {
     screen.key(["tab"], () => moveFocus(1));
     screen.key(["S-tab"], () => moveFocus(-1));
 
+    screen.key(["pageup", "C-u"], () => {
+        if (!state.activeChat) return;
+        chatView.scrollBox.scroll(-10);
+        if (chatView.scrollBox.getScroll() <= 0) {
+            chatView.loadMore?.();
+        }
+        screen.render();
+    });
+
+    screen.key(["pagedown", "C-d"], () => {
+        if (!state.activeChat) return;
+        chatView.scrollBox.scroll(10);
+        screen.render();
+    });
+
     screen.key(["f1", "?"], () => {
         releaseInputs();
         helpModal.show();