@emaxe/tuigram 1.2.0 → 1.4.0

package/CHANGELOG.md

@@ -13,6 +13,64 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 - English localization of the TUI and CLI interface strings.
 
+## [1.4.0] — 2026-09-01
+
+### Added
+
+- Message selection in the chat feed: a left click marks a message with a colored `▌` bar
+  along all of its lines. `↑` / `↓` (and `k` / `j`) move the selection between messages and
+  scroll it into view; reaching the topmost message loads the previous page of history.
+- The message action menu now opens with the right mouse button, and with `[Enter]` on the
+  selected message. Previously any click opened it, so a message could not simply be picked.
+- The selected message became the target for actions: `[Ctrl+R]` replies to it, `[Ctrl+E]`
+  edits it (when it is yours), `[Ctrl+A]` and the status bar `[Ctrl+A]` button open the menu
+  for it. With nothing selected the previous behaviour applies — the last message in the chat.
+- Full-screen image viewer opened by clicking an image preview: the thumbnail that arrived
+  with the message is shown instantly, then replaced by the full-size version. For videos and
+  documents the largest thumbnail is used and the file itself is never downloaded. Close with
+  `[Esc]`, `[Q]`, `[Enter]` or a click; the image is re-rendered when the terminal is resized.
+- The `[Ctrl+A]` shortcut (action menu) now works from every panel, including the input box.
+- `[F12]` temporarily hands the mouse back to the terminal so text can be selected and
+  copied, and restores the capture when pressed again.
+
+### Fixed
+
+- A modal window was closed by the very click that opened it: blessed delivers a click to the
+  element first and to the screen immediately after. As a result the status bar buttons
+  `[F1]`, `[Ctrl+A]`, `[Ctrl+P]`, `[Ctrl+Q]`, the header logo and the chat title did not work
+  with the mouse at all, and the action menu only stayed open when the click happened to land
+  inside the future modal rectangle.
+- Clicking a message hit the wrong message in a scrolled feed: the position was read from
+  `getScroll()`, which adds a blessed-internal offset to the actual content shift.
+- The mouse wheel scrolled the feed twice per notch (a custom handler on top of the built-in
+  blessed one), and scrolling up from the bottom of the feed did nothing for the first notches.
+- `PageUp` / `PageDown` scrolled the feed twice as far while it had focus.
+- Clicks on the input hints were off by about 10 cells: clicking `[Ctrl+E] Правка` triggered
+  commands, and clicking the "Введите сообщение…" text switched to reply mode.
+- A right click behaved like a left one: it opened chats in the list and pressed status bar
+  buttons and filter tabs.
+- The feed layout map drifted by one line per message, so click coordinates diverged from the
+  actual text the longer the history grew.
+- A full-screen image render could evict and replace the same image's thumbnail in the feed:
+  the render size is now part of the pseudo-graphics cache key.
+
+## [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
@@ -118,7 +176,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.2.0...HEAD
+[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.4.0...HEAD
+[1.4.0]: https://github.com/emaxe/tuigram/compare/v1.3.0...v1.4.0
+[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

package/CHANGELOG.ru.md

@@ -13,6 +13,68 @@
 
 - Английская локализация строк интерфейса TUI и CLI.
 
+## [1.4.0] — 2026-09-01
+
+### Добавлено
+
+- Выделение сообщений в ленте чата: левый клик мышью помечает сообщение цветной полосой `▌`
+  слева от всех его строк. Стрелки `↑` / `↓` (и `k` / `j`) перемещают выделение между
+  сообщениями с автоподкруткой ленты; на самом верхнем сообщении подгружается предыдущая
+  страница истории.
+- Меню действий над сообщением открывается правой кнопкой мыши, а также `[Enter]` над
+  выделенным сообщением. Прежде меню открывалось любым кликом, из-за чего сообщение нельзя
+  было просто выбрать.
+- Выделенное сообщение стало целью действий: `[Ctrl+R]` отвечает именно на него, `[Ctrl+E]`
+  правит его (если оно ваше), `[Ctrl+A]` и кнопка `[Ctrl+A]` строки состояния открывают меню
+  для него. Без выделения действует прежнее поведение — последнее сообщение чата.
+- Полноэкранный просмотр изображений по клику на превью в сообщении: сначала мгновенно
+  показывается пришедшая с сообщением миниатюра, затем она заменяется полноразмерной
+  версией. У видео и документов берётся самая крупная миниатюра, сам файл не качается.
+  Закрытие — `[Esc]`, `[Q]`, `[Enter]` или клик; при изменении размера терминала
+  изображение перерисовывается.
+- Глобальное сочетание `[Ctrl+A]` (меню действий) теперь работает из любой панели, включая
+  поле ввода.
+- Клавиша `[F12]` временно отдаёт мышь терминалу, чтобы можно было выделить и скопировать
+  текст, и возвращает захват повторным нажатием.
+
+### Исправлено
+
+- Модальное окно закрывалось тем же кликом, которым его открыли: blessed рассылает клик
+  сначала элементу, а сразу за ним — экрану. Из-за этого мышью вовсе не работали кнопки
+  строки состояния `[F1]`, `[Ctrl+A]`, `[Ctrl+P]`, `[Ctrl+Q]`, логотип и заголовок чата в
+  шапке, а меню действий открывалось лишь при попадании клика в будущий прямоугольник окна.
+- Клик по сообщению попадал не в то сообщение при прокрученной ленте: позиция бралась из
+  `getScroll()`, которая складывает сдвиг содержимого со служебным смещением blessed.
+- Колесо мыши прокручивало ленту дважды за щелчок (собственный обработчик поверх
+  встроенного в blessed), а прокрутка вверх от нижнего края ленты первые несколько щелчков
+  не работала вовсе.
+- `PageUp` / `PageDown` прокручивали ленту на удвоенное расстояние, когда она была в фокусе.
+- Клики по подсказкам поля ввода были смещены примерно на 10 ячеек: клик по `[Ctrl+E] Правка`
+  вызывал команды, а клик по тексту «Введите сообщение…» включал режим ответа.
+- Правый клик срабатывал как левый: открывал чат в списке, нажимал кнопки строки состояния
+  и вкладки фильтров.
+- Разметка ленты «съезжала» на одну строку с каждым сообщением, из-за чего карта координат
+  расходилась с реальным текстом тем сильнее, чем длиннее история.
+- Полноэкранный рендер картинки мог вытеснить и подменить её же миниатюру в ленте: размер
+  теперь входит в ключ кэша псевдографики.
+
+## [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
 
 ### Добавлено
@@ -120,7 +182,9 @@
 - Тест контраста по WCAG (порог 3:1) для каждой темы — **после** конверсии в xterm-256,
   то есть ровно в том виде, в каком цвет увидит пользователь.
 
-[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.2.0...HEAD
+[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.4.0...HEAD
+[1.4.0]: https://github.com/emaxe/tuigram/compare/v1.3.0...v1.4.0
+[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

package/README.md

@@ -52,6 +52,7 @@ 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)
@@ -70,7 +71,8 @@ TuiGram lets you use Telegram entirely from the terminal: browse your dialog lis
 
 - **A complete interactive TUI**:
   - Two-pane adaptive layout (dialog list on the left, history and input box on the right);
-  - Keyboard and mouse control (clicks, wheel scrolling);
+  - Keyboard and mouse control (left click selects a message, right click opens the action
+    menu, clicking an image opens it full screen, wheel scrolling);
   - Chat categories: All, Direct messages, Groups, Channels, Bots, Unread;
   - Instant search and filtering of chats by title and `@username` (`/`);
   - Live typing indicator ("… is typing");
@@ -432,26 +434,83 @@ node scripts/check-package.js   # verifies that .env and the session do not leak
 |---|---|---|
 | `Tab` / `Shift+Tab` | Global | Cycle focus: dialog list → message feed → input box |
 | `↑` / `↓` | Dialog list | Select a chat |
+| `↑` / `↓`, `k` / `j` | Message feed | Move the selection between messages |
 | `Enter` | Dialog list | Open the selected chat and load its history |
+| `Enter` | Message feed | Action menu for the selected message |
 | `1` .. `6` | Dialog list | Switch category: `1:All`, `2:DM`, `3:Groups`, `4:Channels`, `5:Bots`, `6:Unread` |
 | `/` | Dialog list | Search / filter chats |
 | `Enter` | Input box | Send the typed message |
 | `Ctrl+J` | Input box | Insert a line break without sending |
-| `Ctrl+R` | Chat / Input | Reply to the last message |
-| `Ctrl+E` | Chat / Input | Edit your own last message |
-| `Ctrl+A` | Messages | Context action menu (reactions, delete, download, reply) |
+| `Ctrl+R` | Chat / Input | Reply to the selected message, or the last one |
+| `Ctrl+E` | Chat / Input | Edit the selected message of yours, or your last one |
+| `Ctrl+A` | Global | Context action menu (reactions, delete, download, reply) |
 | `Ctrl+O` | Global | Send a file / photo / document |
 | `Ctrl+F` | Send dialog | File browser (navigate folders) |
 | `Ctrl+D` | Send dialog | Send uncompressed, as a document |
 | `Ctrl+P` | Global | Info about the current chat (ID, members, links) |
 | `PageUp` / `Ctrl+U` | History | Scroll up / load older history |
 | `PageDown` / `Ctrl+D` | History | Scroll down |
+| `Home` / `End` | History | Jump to the top (loads history) / to the last message |
 | `Esc` | Modals | Close the modal / cancel reply or edit |
 | `F1` or `?` | Global | Help window with every shortcut |
+| `F12` | Global | Hand the mouse to the terminal for text selection (press again to return) |
 | `Ctrl+Q` / `Ctrl+C` | Global | Safely exit the client |
 
 ---
 
+## 🖱 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 |
+|---|---|---|
+| Left click | Left / Middle / Bottom panel | Focus the clicked panel |
+| Left click | Chat item in dialog list | Immediately select and open the chat |
+| Left click | Filter tabs `1:Все` .. `6:Непроч` | Switch chat category filter |
+| Left 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) |
+| **Left click** | **Message in the feed** | **Select the message — a `▌` bar marks it on the left** |
+| **Right click** | **Message in the feed** | **Open the action menu (reactions, reply, edit, download, delete)** |
+| **Left click** | **Image preview inside a message** | **Open the image full screen** |
+| Left click | Empty area of the feed | Focus the message feed |
+| Left click | Header logo 🚀 | Open Help window |
+| Left click | Header active chat title | Open Chat Info window |
+| Left click | Header connection badge | Show active network status |
+| Left click | Input context bar | Cancel reply/edit mode, trigger `[Ctrl+R]` / `[Ctrl+E]` or insert `/` |
+| Left 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) |
+
+### Message selection
+
+A left click selects a message: a colored `▌` bar appears to the left of all its lines.
+`↑` / `↓` (and `k` / `j`) move the selection between messages and scroll it into view;
+reaching the topmost message loads the previous page of history. Plain scrolling stays on
+`PageUp` / `PageDown`, the wheel and `Home` / `End`.
+
+The selected message becomes the target for actions: `[Enter]` and right click open the
+action menu, `[Ctrl+R]` replies to it, `[Ctrl+E]` edits it (when it is yours). With nothing
+selected these actions apply to the last message in the chat, as before.
+
+### Full-screen image viewer
+
+A left click on a preview opens the image across the whole terminal. The thumbnail that
+already arrived with the message is shown instantly, then it is replaced by the full-size
+version as soon as it downloads. For videos and documents the largest available thumbnail
+is shown — the file itself is never downloaded. Close with `[Esc]`, `[Q]`, `[Enter]` or a
+click anywhere.
+
+### Right click and terminal text selection
+
+> **macOS Terminal.app** captures the right click for its own context menu and never passes
+> it to the application. Use `[Enter]` or `[Ctrl+A]` on the selected message there. Right
+> click works in iTerm2, Ghostty, Alacritty, Kitty and Windows Terminal.
+
+While the app captures the mouse, the terminal cannot select text for copying. Press `[F12]`
+to hand the mouse back to the terminal, and `[F12]` again to return control to the interface.
+
+---
+
 ## 💬 Slash commands in the input box
 
 Quick commands are available in the message input box (they start with `/`):

package/README.ru.md

@@ -48,6 +48,7 @@
 - [Где хранятся файлы](#-где-хранятся-файлы)
 - [Разработка](#-разработка)
 - [Горячие клавиши](#️-горячие-клавиши)
+- [Управление мышью](#-управление-мышью)
 - [Слэш-команды](#-слэш-команды-в-поле-ввода)
 - [Отправка файлов и картинок](#-отправка-файлов-и-картинок)
 - [Темы оформления](#-темы-оформления)
@@ -66,7 +67,8 @@
 
 - **Полноценный интерактивный TUI**:
   - Двухпанельный адаптивный интерфейс (список чатов слева + история и поле ввода справа);
-  - Поддержка управления клавиатурой и мышью (клики, прокрутка колесом);
+  - Поддержка управления клавиатурой и мышью (левый клик — выделение сообщения,
+    правый — меню действий, клик по картинке — просмотр на весь экран, колесо — прокрутка);
   - Категории чатов: Все, Личные (ЛС), Группы, Каналы, Боты, Непрочитанные;
   - Мгновенный поиск и фильтрация чатов по названию и `@username` (`/`);
   - Отображение статуса набора текста («Собеседник печатает...») в реальном времени;
@@ -424,26 +426,84 @@ node scripts/check-package.js   # проверка, что в пакет не у
 |---|---|---|
 | `Tab` / `Shift+Tab` | Глобально | Фокус по кругу: Список диалогов → Лента сообщений → Поле ввода |
 | `↑` / `↓` | Список диалогов | Выбор чата |
+| `↑` / `↓`, `k` / `j` | Лента сообщений | Перемещение выделения между сообщениями |
 | `Enter` | Список диалогов | Открыть выбранный чат и загрузить историю |
+| `Enter` | Лента сообщений | Меню действий над выделенным сообщением |
 | `1` .. `6` | Список диалогов | Переключение категорий: `1:Все`, `2:ЛС`, `3:Группы`, `4:Каналы`, `5:Боты`, `6:Непроч` |
 | `/` | Список диалогов | Поиск / фильтрация чатов |
 | `Enter` | Поле ввода | Отправить набранное сообщение |
 | `Ctrl+J` | Поле ввода | Перенос строки без отправки |
-| `Ctrl+R` | Чат / Ввод | Ответить (Reply) на последнее сообщение |
-| `Ctrl+E` | Чат / Ввод | Редактировать своё последнее сообщение |
-| `Ctrl+A` | Сообщения | Контекстное меню действий (Реакции, Удаление, Скачивание, Ответ) |
+| `Ctrl+R` | Чат / Ввод | Ответить (Reply) на выделенное сообщение, иначе — на последнее |
+| `Ctrl+E` | Чат / Ввод | Редактировать выделенное своё сообщение, иначе — последнее своё |
+| `Ctrl+A` | Глобально | Контекстное меню действий (Реакции, Удаление, Скачивание, Ответ) |
 | `Ctrl+O` | Глобально | Отправить файл / фото / документ |
 | `Ctrl+F` | Окно отправки | Обзор файлов (навигация по папкам) |
 | `Ctrl+D` | Окно отправки | Отправить без сжатия, документом |
 | `Ctrl+P` | Глобально | Информация о текущем чате (ID, участники, ссылки) |
 | `PageUp` / `Ctrl+U`| История | Прокрутка вверх / подгрузка старой истории |
 | `PageDown` / `Ctrl+D`| История | Прокрутка вниз |
+| `Home` / `End` | История | В начало ленты (подгрузка истории) / к последнему сообщению |
 | `Esc` | Модальные окна | Закрыть модальное окно / отменить Reply/Edit |
 | `F1` или `?` | Глобально | Окно справки со всеми горячими клавишами |
+| `F12` | Глобально | Отдать мышь терминалу для выделения текста (повторно — вернуть) |
 | `Ctrl+Q` / `Ctrl+C` | Глобально | Безопасный выход из клиента |
 
 ---
 
+## 🖱 Управление мышью
+
+TuiGram полноценно поддерживает управление мышью во всех современных терминалах (Terminal.app, iTerm2, Alacritty, Kitty, Windows Terminal, xterm):
+
+| Действие | Где | Результат |
+|---|---|---|
+| Левый клик | Левая / Центральная / Нижняя панель | Переключение фокуса на выбранную панель |
+| Левый клик | Диалог в списке чатов | Мгновенный выбор и открытие чата |
+| Левый клик | Вкладки `1:Все` .. `6:Непроч` | Переключение фильтра категории чатов |
+| Левый клик | Поле поиска `[/]` | Фокус в поиск с очисткой подсказки |
+| Колесо мыши | Список чатов / Лента сообщений | Плавная прокрутка (прокрутка вверх в ленте подгружает историю) |
+| **Левый клик** | **Сообщение в ленте** | **Выделение сообщения — оно помечается полосой `▌` слева** |
+| **Правый клик** | **Сообщение в ленте** | **Меню действий (реакции, ответ, редактирование, скачивание, удаление)** |
+| **Левый клик** | **Превью изображения в сообщении** | **Открытие картинки на весь экран** |
+| Левый клик | Пустое место в ленте | Переключение фокуса на ленту сообщений |
+| Левый клик | Логотип 🚀 в шапке | Открытие окна справки |
+| Левый клик | Название активного чата в шапке | Открытие информации о текущем чате |
+| Левый клик | Индикатор статуса в шапке | Просмотр статуса MTProto подключения |
+| Левый клик | Контекстная плашка ввода | Сброс режима ответа/редактирования, `[Ctrl+R]`, `[Ctrl+E]` или вставка `/` |
+| Левый клик | Кнопки строки состояния | Быстрый вызов действий (`[Tab]`, `[F1]`, `[Ctrl+A]`, `[Ctrl+Q]` и др.) |
+| Клик | Мимо любого модального окна | Закрытие модального окна |
+| Клик | Кнопки в модалках | Нажатие кнопки (`[ Отправить ]`, `[ Отмена ]`, `[ Закрыть ]`, чекбоксы) |
+
+### Выделение сообщений
+
+Левый клик выделяет сообщение: слева от всех его строк появляется цветная полоса `▌`.
+Стрелки `↑` / `↓` (и `k` / `j`) в ленте двигают выделение между сообщениями и подкручивают
+ленту к выбранному; дойдя до самого верхнего сообщения, клиент подгружает предыдущую
+страницу истории. Прокрутка при этом остаётся на `PageUp` / `PageDown`, колесе и `Home` / `End`.
+
+Выделенное сообщение становится целью действий: `[Enter]` и правый клик открывают меню
+действий, `[Ctrl+R]` отвечает именно на него, `[Ctrl+E]` правит его (если оно ваше).
+Без выделения все эти действия, как и раньше, применяются к последнему сообщению чата.
+
+### Просмотр изображений на весь экран
+
+Левый клик по превью открывает изображение во весь терминал. Сначала мгновенно
+показывается миниатюра, уже пришедшая вместе с сообщением, затем она заменяется
+полноразмерной версией, как только та скачается. У видео и документов показывается
+самая крупная миниатюра — сам файл не качается. Закрыть: `[Esc]`, `[Q]`, `[Enter]`
+или клик в любом месте.
+
+### Правая кнопка и выделение текста терминалом
+
+> **macOS Terminal.app** перехватывает правый клик под собственное контекстное меню и не
+> передаёт его приложению. Там пользуйтесь `[Enter]` или `[Ctrl+A]` над выделенным
+> сообщением. В iTerm2, Ghostty, Alacritty, Kitty и Windows Terminal правый клик работает.
+
+Пока мышь захвачена приложением, терминал не даёт выделять текст для копирования.
+Нажмите `[F12]`, чтобы временно отдать мышь терминалу, и `[F12]` ещё раз, чтобы вернуть
+управление интерфейсу.
+
+---
+
 ## 💬 Слэш-команды в поле ввода
 
 В поле ввода сообщения доступны быстрые команды (начинаются с `/`):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emaxe/tuigram",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Полнофункциональный TUI & CLI клиент Telegram на Node.js на базе MTProto (teleproto)",
   "type": "module",
   "exports": {

package/src/telegram/messages.js

@@ -6,6 +6,39 @@ import { renderStrippedThumbnail, renderImageBuffer } from "../utils/image.js";
 
 const { FloodWaitError } = errors;
 
+/**
+ * Синхронно рисует миниатюру, встроенную в само сообщение (PhotoStrippedSize).
+ * Сеть не нужна — байты уже пришли вместе с сообщением, поэтому картинку можно
+ * показать мгновенно, пока качается полноразмерная версия.
+ * @param {object} rawMessage
+ * @param {object} [options]
+ * @param {number} [options.maxWidth]
+ * @param {number} [options.maxHeight]
+ * @param {boolean} [options.useCache=true] класть результат в кэш псевдографики
+ * @returns {string} разметка blessed или пустая строка
+ */
+export function renderMessageThumbnail(rawMessage, {
+    maxWidth = config.imageMaxWidth,
+    maxHeight = config.imageMaxHeight,
+    useCache = true,
+} = {}) {
+    const media = rawMessage?.media;
+    if (!media) return "";
+
+    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) return "";
+
+    // Полноэкранные рендеры не кэшируем: одна такая строка весит сотни килобайт
+    const cacheKey = useCache
+        ? (photo?.id ? `photo_${photo.id}` : (doc?.id ? `doc_${doc.id}` : `msg_${rawMessage.id}`))
+        : undefined;
+
+    return renderStrippedThumbnail(stripped.bytes, { maxWidth, maxHeight, cacheKey }) || "";
+}
+
 /**
  * Преобразует объект Message из MTProto в нормализованный объект для TUI.
  * @param {object} message
@@ -41,25 +74,9 @@ 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;
-        }
-    }
+    const imagePreview = config.showImages
+        ? (renderMessageThumbnail(message) || null)
+        : null;
 
     return {
         id: message.id,
@@ -288,6 +305,68 @@ export async function markAsRead(client, rawPeer, maxId = 0) {
     }
 }
 
+/**
+ * Выбирает самую крупную растровую миниатюру документа.
+ * PhotoPathSize (SVG-контур) и PhotoStrippedSize непригодны для полноэкранного показа.
+ * @param {Array<object>} thumbs
+ * @returns {object|null}
+ */
+function pickLargestThumb(thumbs) {
+    if (!Array.isArray(thumbs) || thumbs.length === 0) return null;
+
+    const weight = (t) => {
+        if (typeof t?.size === "number") return t.size;
+        if (Array.isArray(t?.sizes) && t.sizes.length > 0) return Math.max(...t.sizes);
+        return 0;
+    };
+
+    const usable = thumbs.filter((t) => t?.className !== "PhotoPathSize" && weight(t) > 0);
+    if (usable.length === 0) return null;
+
+    return usable.reduce((best, t) => (weight(t) > weight(best) ? t : best), usable[0]);
+}
+
+/**
+ * Загружает изображение сообщения в максимальном доступном качестве — для просмотра
+ * на весь экран.
+ *
+ * Фото качается оригиналом. У документа (видео, gif, файл) качается только самая
+ * крупная миниатюра: сам файл может весить сотни мегабайт и всё равно не рисуется.
+ *
+ * @param {import("teleproto").TelegramClient} client
+ * @param {object} rawMessage
+ * @returns {Promise<{ buffer: Buffer, mimeType: string }>}
+ */
+export async function downloadImageBuffer(client, rawMessage) {
+    const media = rawMessage?.media;
+    if (!media) {
+        throw new Error("У сообщения нет изображения.");
+    }
+
+    if (media.className === "MessageMediaPhoto") {
+        // Без thumb teleproto отдаёт самый большой размер фотографии
+        const buffer = await client.downloadMedia(media, {});
+        if (!buffer || buffer.length === 0) {
+            throw new Error("Не удалось загрузить изображение.");
+        }
+        return { buffer, mimeType: "image/jpeg" };
+    }
+
+    if (media.className === "MessageMediaDocument") {
+        const thumb = pickLargestThumb(media.document?.thumbs);
+        if (!thumb) {
+            throw new Error("У вложения нет пригодной для показа миниатюры.");
+        }
+        const buffer = await client.downloadMedia(media, { thumb });
+        if (!buffer || buffer.length === 0) {
+            throw new Error("Не удалось загрузить миниатюру вложения.");
+        }
+        return { buffer, mimeType: "image/jpeg" };
+    }
+
+    throw new Error("Этот тип вложения нельзя показать как изображение.");
+}
+
 /**
  * Асинхронно загружает и декодирует превью изображения сообщения через MTProto.
  * @param {import("teleproto").TelegramClient} client