@emaxe/tuigram 1.1.0 → 1.2.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,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 - English localization of the TUI and CLI interface strings.
 
+## [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 +118,8 @@ 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.2.0...HEAD
+[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,13 @@
 
 - Английская локализация строк интерфейса TUI и CLI.
 
+## [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 +120,8 @@
 - Тест контраста по WCAG (порог 3:1) для каждой темы — **после** конверсии в xterm-256,
   то есть ровно в том виде, в каком цвет увидит пользователь.
 
-[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.1.0...HEAD
+[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.2.0...HEAD
+[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

@@ -55,6 +55,7 @@ TuiGram lets you use Telegram entirely from the terminal: browse your dialog lis
 - [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 +75,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`);
@@ -512,6 +514,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 +631,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

@@ -51,6 +51,7 @@
 - [Слэш-команды](#-слэш-команды-в-поле-ввода)
 - [Отправка файлов и картинок](#-отправка-файлов-и-картинок)
 - [Темы оформления](#-темы-оформления)
+- [Превью изображений в сообщениях](#️-превью-изображений-в-сообщениях)
 - [Прокси-сервер](#-прокси-сервер)
 - [Использование через консоль (CLI)](#️-использование-через-консоль-cli)
 - [Структура проекта](#-структура-проекта)
@@ -70,6 +71,7 @@
   - Мгновенный поиск и фильтрация чатов по названию и `@username` (`/`);
   - Отображение статуса набора текста («Собеседник печатает...») в реальном времени;
   - Цветовое форматирование Telegram Entities (Bold, Italic, Monospace Code, URLs, Mentions, Spoilers);
+  - Цветные превью изображений высокого разрешения прямо в чате (Unicode Half-Block `▀` pixel art);
   - Индикаторы медиа-вложений (фото, видео, документы, голосовые, стикеры, опросы);
   - Реакции на сообщения (👍, 🔥, ❤️);
   - Бесконечная пагинация истории сообщений вверх (`PageUp` / `Ctrl+U`);
@@ -506,6 +508,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 +625,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.2.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";
@@ -128,6 +128,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 +158,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");
@@ -291,9 +293,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 +322,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 +501,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();

package/src/ui/components/chatView.js

@@ -38,7 +38,6 @@ export function createChatView(screen, theme, { onLoadMoreHistory, onActionMenu
         bottom: 0,
         tags: true,
         scrollable: true,
-        alwaysScroll: true,
         mouse: true,
         keys: true,
         vi: true,
@@ -99,8 +98,19 @@ export function createChatView(screen, theme, { onLoadMoreHistory, onActionMenu
 
             // Текст сообщения и entities
             let bodyText = formatMessageText(msg.text, msg.entities);
-            if (msg.mediaDescription) {
-                bodyText = bodyText ? `${msg.mediaDescription}\n  ${bodyText}` : msg.mediaDescription;
+
+            // Блок медиа-вложения и превью изображения
+            let mediaBlock = "";
+            if (msg.imagePreview) {
+                mediaBlock = msg.mediaDescription
+                    ? `${msg.mediaDescription}\n${msg.imagePreview}`
+                    : msg.imagePreview;
+            } else if (msg.mediaDescription) {
+                mediaBlock = msg.mediaDescription;
+            }
+
+            if (mediaBlock) {
+                bodyText = bodyText ? `${mediaBlock}\n${bodyText}` : mediaBlock;
             }
 
             // Отступ строк текста сообщения
@@ -135,26 +145,60 @@ export function createChatView(screen, theme, { onLoadMoreHistory, onActionMenu
      */
     function setMessages(messages, autoScrollToBottom = true) {
         currentMessages = messages;
+        const prevScroll = scrollBox.getScroll();
+        const prevHeight = scrollBox.getScrollHeight();
+
         scrollBox.setContent(renderMessages(messages));
+
         if (autoScrollToBottom) {
             scrollBox.setScrollPerc(100);
+        } else {
+            // Сохраняем относительную позицию скролла: если добавились старые сообщения сверху,
+            // компенсируем сдвиг высоты ленты
+            const newHeight = scrollBox.getScrollHeight();
+            const addedLines = newHeight - prevHeight;
+            if (addedLines > 0 && prevScroll > 0) {
+                scrollBox.scrollTo(prevScroll + addedLines);
+            } else if (prevScroll > 0) {
+                scrollBox.scrollTo(prevScroll);
+            }
         }
         screen.render();
     }
 
     // Обработка прокрутки вверх для подгрузки истории
-    scrollBox.key(["pageup", "C-u"], () => {
-        scrollBox.scroll(-10);
+    function handleScrollUp(step = 10) {
+        scrollBox.scroll(-step);
         if (scrollBox.getScroll() <= 0) {
             onLoadMoreHistory?.();
         }
         screen.render();
-    });
+    }
+
+    function handleScrollDown(step = 10) {
+        scrollBox.scroll(step);
+        screen.render();
+    }
 
-    scrollBox.key(["pagedown", "C-d"], () => {
-        scrollBox.scroll(10);
+    scrollBox.key(["pageup", "C-u"], () => handleScrollUp(10));
+    scrollBox.key(["pagedown", "C-d"], () => handleScrollDown(10));
+    scrollBox.key(["up", "k"], () => handleScrollUp(2));
+    scrollBox.key(["down", "j"], () => handleScrollDown(2));
+    scrollBox.key(["home"], () => {
+        scrollBox.scrollTo(0);
+        onLoadMoreHistory?.();
         screen.render();
     });
+    scrollBox.key(["end"], () => {
+        scrollBox.setScrollPerc(100);
+        screen.render();
+    });
+
+    scrollBox.on("wheelup", () => {
+        if (scrollBox.getScroll() <= 0) {
+            onLoadMoreHistory?.();
+        }
+    });
 
     // Ctrl+M терминал шлёт как "\r" (имя клавиши "return"), поэтому меню действий
     // висит на Ctrl+A — иначе оно недостижимо.
@@ -169,6 +213,7 @@ export function createChatView(screen, theme, { onLoadMoreHistory, onActionMenu
         container,
         scrollBox,
         setMessages,
+        loadMore: () => onLoadMoreHistory?.(),
         scrollToBottom: () => {
             scrollBox.setScrollPerc(100);
             screen.render();

package/src/utils/image.js

@@ -0,0 +1,343 @@
+/**
+ * Модуль обработки и рендеринга изображений в терминале (Unicode Half-Block).
+ * Преобразует растровые изображения (JPEG, PNG, PhotoStrippedSize) в псевдографику
+ * высокого разрешения с разметкой blessed и 24-битными hex-цветами.
+ */
+
+import jpegJs from "jpeg-js";
+import { PNG } from "pngjs";
+
+/** Заголовок стандартного JPEG для распаковки Telegram PhotoStrippedSize. */
+const JPEG_HEADER = Buffer.from([
+    0xff, 0xd8, 0xff, 0xe0, 0x00, 0x10, 0x4a, 0x46, 0x49, 0x46, 0x00, 0x01,
+    0x01, 0x00, 0x00, 0x01, 0x00, 0x01, 0x00, 0x00, 0xff, 0xdb, 0x00, 0x43,
+    0x00, 0x28, 0x1c, 0x1e, 0x23, 0x1e, 0x19, 0x28, 0x23, 0x21, 0x23, 0x2d,
+    0x2b, 0x28, 0x30, 0x3c, 0x64, 0x41, 0x3c, 0x37, 0x37, 0x3c, 0x7b, 0x58,
+    0x5d, 0x49, 0x64, 0x91, 0x80, 0x99, 0x96, 0x8f, 0x80, 0x8c, 0x8a, 0xa0,
+    0xb4, 0xe6, 0xc3, 0xa0, 0xaa, 0xda, 0xad, 0x8a, 0x8c, 0xc8, 0xff, 0xcb,
+    0xda, 0xee, 0xf5, 0xff, 0xff, 0xff, 0x9b, 0xc1, 0xff, 0xff, 0xf7, 0xfa,
+    0xff, 0xe6, 0xfd, 0xff, 0xf8, 0xff, 0xdb, 0x00, 0x43, 0x01, 0x2b, 0x2d,
+    0x2d, 0x3c, 0x35, 0x3c, 0x75, 0x41, 0x41, 0x75, 0xf8, 0xa5, 0x8c, 0xa5,
+    0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8,
+    0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8,
+    0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8,
+    0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xf8, 0xff, 0xc0, 0x00,
+    0x11, 0x08, 0x00, 0x00, 0x00, 0x00, 0x03, 0x01, 0x22, 0x00, 0x02, 0x11,
+    0x01, 0x03, 0x11, 0x01, 0xff, 0xc4, 0x00, 0x1f, 0x00, 0x00, 0x01, 0x05,
+    0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0a,
+    0x0b, 0xff, 0xc4, 0x00, 0xb5, 0x10, 0x00, 0x02, 0x01, 0x03, 0x03, 0x02,
+    0x04, 0x03, 0x05, 0x05, 0x04, 0x04, 0x00, 0x00, 0x01, 0x7d, 0x01, 0x02,
+    0x03, 0x00, 0x04, 0x11, 0x05, 0x12, 0x21, 0x31, 0x41, 0x06, 0x13, 0x51,
+    0x61, 0x07, 0x22, 0x71, 0x14, 0x32, 0x81, 0x91, 0xa1, 0x08, 0x23, 0x42,
+    0xb1, 0xc1, 0x15, 0x52, 0xd1, 0xf0, 0x24, 0x33, 0x62, 0x72, 0x82, 0x09,
+    0x0a, 0x16, 0x17, 0x18, 0x19, 0x1a, 0x25, 0x26, 0x27, 0x28, 0x29, 0x2a,
+    0x34, 0x35, 0x36, 0x37, 0x38, 0x39, 0x3a, 0x43, 0x44, 0x45, 0x46, 0x47,
+    0x48, 0x49, 0x4a, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58, 0x59, 0x5a, 0x63,
+    0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x6a, 0x73, 0x74, 0x75, 0x76, 0x77,
+    0x78, 0x79, 0x7a, 0x83, 0x84, 0x85, 0x86, 0x87, 0x88, 0x89, 0x8a, 0x92,
+    0x93, 0x94, 0x95, 0x96, 0x97, 0x98, 0x99, 0x9a, 0xa2, 0xa3, 0xa4, 0xa5,
+    0xa6, 0xa7, 0xa8, 0xa9, 0xaa, 0xb2, 0xb3, 0xb4, 0xb5, 0xb6, 0xb7, 0xb8,
+    0xb9, 0xba, 0xc2, 0xc3, 0xc4, 0xc5, 0xc6, 0xc7, 0xc8, 0xc9, 0xca, 0xd2,
+    0xd3, 0xd4, 0xd5, 0xd6, 0xd7, 0xd8, 0xd9, 0xda, 0xe1, 0xe2, 0xe3, 0xe4,
+    0xe5, 0xe6, 0xe7, 0xe8, 0xe9, 0xea, 0xf1, 0xf2, 0xf3, 0xf4, 0xf5, 0xf6,
+    0xf7, 0xf8, 0xf9, 0xfa, 0xff, 0xc4, 0x00, 0x1f, 0x01, 0x00, 0x03, 0x01,
+    0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0a,
+    0x0b, 0xff, 0xc4, 0x00, 0xb5, 0x11, 0x00, 0x02, 0x01, 0x02, 0x04, 0x04,
+    0x03, 0x04, 0x07, 0x05, 0x04, 0x04, 0x00, 0x01, 0x02, 0x77, 0x00, 0x01,
+    0x02, 0x03, 0x11, 0x04, 0x05, 0x21, 0x31, 0x06, 0x12, 0x41, 0x51, 0x07,
+    0x61, 0x71, 0x13, 0x22, 0x32, 0x81, 0x08, 0x14, 0x42, 0x91, 0xa1, 0xb1,
+    0xc1, 0x09, 0x23, 0x33, 0x52, 0xf0, 0x15, 0x62, 0x72, 0xd1, 0x0a, 0x16,
+    0x24, 0x34, 0xe1, 0x25, 0xf1, 0x17, 0x18, 0x19, 0x1a, 0x26, 0x27, 0x28,
+    0x29, 0x2a, 0x35, 0x36, 0x37, 0x38, 0x39, 0x3a, 0x43, 0x44, 0x45, 0x46,
+    0x47, 0x48, 0x49, 0x4a, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58, 0x59, 0x5a,
+    0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x6a, 0x73, 0x74, 0x75, 0x76,
+    0x77, 0x78, 0x79, 0x7a, 0x82, 0x83, 0x84, 0x85, 0x86, 0x87, 0x88, 0x89,
+    0x8a, 0x92, 0x93, 0x94, 0x95, 0x96, 0x97, 0x98, 0x99, 0x9a, 0xa2, 0xa3,
+    0xa4, 0xa5, 0xa6, 0xa7, 0xa8, 0xa9, 0xaa, 0xb2, 0xb3, 0xb4, 0xb5, 0xb6,
+    0xb7, 0xb8, 0xb9, 0xba, 0xc2, 0xc3, 0xc4, 0xc5, 0xc6, 0xc7, 0xc8, 0xc9,
+    0xca, 0xd2, 0xd3, 0xd4, 0xd5, 0xd6, 0xd7, 0xd8, 0xd9, 0xda, 0xe2, 0xe3,
+    0xe4, 0xe5, 0xe6, 0xe7, 0xe8, 0xe9, 0xea, 0xf2, 0xf3, 0xf4, 0xf5, 0xf6,
+    0xf7, 0xf8, 0xf9, 0xfa, 0xff, 0xda, 0x00, 0x0c, 0x03, 0x01, 0x00, 0x02,
+    0x11, 0x03, 0x11, 0x00, 0x3f, 0x00
+]);
+
+/** Завершающий маркер JPEG (End Of Image). */
+const JPEG_FOOTER = Buffer.from([0xff, 0xd9]);
+
+/**
+ * Память кэша для готовых строк псевдографики.
+ * @type {Map<string, string>}
+ */
+export const imagePreviewCache = new Map();
+const MAX_CACHE_SIZE = 500;
+
+/**
+ * Распаковывает PhotoStrippedSize Telegram в валидный JPEG буфер.
+ * @param {Buffer|Uint8Array} stripped
+ * @returns {Buffer}
+ */
+export function strippedPhotoToJpg(stripped) {
+    if (!stripped || stripped.length < 3) {
+        return Buffer.isBuffer(stripped) ? stripped : Buffer.from(stripped || []);
+    }
+    const buf = Buffer.isBuffer(stripped) ? stripped : Buffer.from(stripped);
+    if (buf[0] !== 1) {
+        return buf;
+    }
+    const header = Buffer.from(JPEG_HEADER);
+    header[164] = buf[1];
+    header[166] = buf[2];
+    return Buffer.concat([header, buf.subarray(3), JPEG_FOOTER]);
+}
+
+/**
+ * Декодирует буфер изображения (JPEG или PNG) в сырой RGBA буфер.
+ * @param {Buffer|Uint8Array} buffer
+ * @param {string} [mimeType]
+ * @returns {{ width: number, height: number, data: Uint8Array }}
+ */
+export function decodeImageBuffer(buffer, mimeType = "") {
+    if (!buffer || buffer.length === 0) {
+        throw new Error("Пустой буфер изображения");
+    }
+
+    const buf = Buffer.isBuffer(buffer) ? buffer : Buffer.from(buffer);
+
+    // Определение формата по magic bytes или mimeType
+    const isPng = (buf.length >= 8 && buf[0] === 0x89 && buf[1] === 0x50 && buf[2] === 0x4e && buf[3] === 0x47)
+        || mimeType.includes("png");
+
+    if (isPng) {
+        const png = PNG.sync.read(buf);
+        return {
+            width: png.width,
+            height: png.height,
+            data: png.data,
+        };
+    }
+
+    // По умолчанию считаем JPEG
+    const decoded = jpegJs.decode(buf, { useTArray: true, formatAsRGBA: true });
+    return {
+        width: decoded.width,
+        height: decoded.height,
+        data: decoded.data,
+    };
+}
+
+/**
+ * Рассчитывает целевые размеры изображения в терминале с сохранением пропорций.
+ * Каждый терминальный ряд Half-Block вмещает 2 вертикальных субпикселя.
+ * @param {number} srcW Исходная ширина в пикселях
+ * @param {number} srcH Исходная высота в пикселях
+ * @param {number} [maxWidth=36] Максимальная ширина в колонках символов
+ * @param {number} [maxHeight=14] Максимальная высота в строках терминала
+ * @returns {{ dstW: number, dstH: number, rows: number }}
+ */
+export function calculateTargetDimensions(srcW, srcH, maxWidth = 36, maxHeight = 14) {
+    const safeW = Math.max(1, srcW || 1);
+    const safeH = Math.max(1, srcH || 1);
+    const maxPixelH = Math.max(2, maxHeight * 2);
+
+    const aspect = safeW / safeH;
+    const maxAspect = maxWidth / maxPixelH;
+
+    let dstW = maxWidth;
+    let dstPixelH = maxPixelH;
+
+    if (aspect >= maxAspect) {
+        dstW = Math.min(maxWidth, safeW);
+        dstPixelH = Math.max(2, Math.round(dstW / aspect));
+    } else {
+        dstPixelH = Math.min(maxPixelH, safeH * 2);
+        dstW = Math.max(1, Math.round(dstPixelH * aspect));
+    }
+
+    // Округляем пиксельную высоту до четного числа (для парных субпикселей ▀)
+    const rows = Math.max(1, Math.ceil(dstPixelH / 2));
+    dstPixelH = rows * 2;
+
+    return { dstW, dstH: dstPixelH, rows };
+}
+
+/**
+ * Масштабирует RGBA буфер методом билинейной интерполяции.
+ * @param {Uint8Array} src RGBA буфер исходного изображения
+ * @param {number} srcW Исходная ширина
+ * @param {number} srcH Исходная высота
+ * @param {number} dstW Целевая ширина
+ * @param {number} dstH Целевая высота
+ * @returns {Uint8Array} Результирующий RGBA буфер длины dstW * dstH * 4
+ */
+export function resizeRgba(src, srcW, srcH, dstW, dstH) {
+    const dst = new Uint8Array(dstW * dstH * 4);
+    if (srcW === dstW && srcH === dstH) {
+        dst.set(src);
+        return dst;
+    }
+
+    const xRatio = srcW / dstW;
+    const yRatio = srcH / dstH;
+
+    for (let dy = 0; dy < dstH; dy++) {
+        const srcY = (dy + 0.5) * yRatio - 0.5;
+        const y0 = Math.max(0, Math.min(srcH - 1, Math.floor(srcY)));
+        const y1 = Math.max(0, Math.min(srcH - 1, y0 + 1));
+        const yWeight = Math.max(0, Math.min(1, srcY - y0));
+
+        const y0Offset = y0 * srcW * 4;
+        const y1Offset = y1 * srcW * 4;
+        const dstRowOffset = dy * dstW * 4;
+
+        for (let dx = 0; dx < dstW; dx++) {
+            const srcX = (dx + 0.5) * xRatio - 0.5;
+            const x0 = Math.max(0, Math.min(srcW - 1, Math.floor(srcX)));
+            const x1 = Math.max(0, Math.min(srcW - 1, x0 + 1));
+            const xWeight = Math.max(0, Math.min(1, srcX - x0));
+
+            const p00 = y0Offset + x0 * 4;
+            const p10 = y0Offset + x1 * 4;
+            const p01 = y1Offset + x0 * 4;
+            const p11 = y1Offset + x1 * 4;
+
+            const dstOffset = dstRowOffset + dx * 4;
+
+            // Интерполяция 4 каналов: R, G, B, A
+            for (let c = 0; c < 4; c++) {
+                const top = (1 - xWeight) * src[p00 + c] + xWeight * src[p10 + c];
+                const bot = (1 - xWeight) * src[p01 + c] + xWeight * src[p11 + c];
+                dst[dstOffset + c] = Math.round((1 - yWeight) * top + yWeight * bot);
+            }
+        }
+    }
+
+    return dst;
+}
+
+/**
+ * Преобразует компоненты цвета R, G, B в hex-строку вида "#rrggbb".
+ * @param {number} r
+ * @param {number} g
+ * @param {number} b
+ * @returns {string}
+ */
+export function rgbaToHex(r, g, b) {
+    const hexR = (r < 16 ? "0" : "") + r.toString(16);
+    const hexG = (g < 16 ? "0" : "") + g.toString(16);
+    const hexB = (b < 16 ? "0" : "") + b.toString(16);
+    return `#${hexR}${hexG}${hexB}`;
+}
+
+/**
+ * Преобразует масштабированный RGBA буфер в многострочный текст Blessed
+ * с использованием символов верхнего полублока (▀ U+2580).
+ *
+ * Верхний пиксель ячейки задаётся через тег цвета текста (`{ #rrggbb-fg }`),
+ * нижний пиксель — через тег цвета фона (`{ #rrggbb-bg }`).
+ *
+ * @param {Uint8Array} data RGBA буфер
+ * @param {number} width Ширина в символах/пикселях
+ * @param {number} height Высота в пикселях (должна быть четной, = rows * 2)
+ * @returns {string}
+ */
+export function rgbaToHalfBlockBlessed(data, width, height) {
+    const rows = Math.floor(height / 2);
+    const lines = [];
+
+    for (let r = 0; r < rows; r++) {
+        let line = "";
+        let currentFg = null;
+        let currentBg = null;
+
+        const topRowOffset = (r * 2) * width * 4;
+        const botRowOffset = (r * 2 + 1) * width * 4;
+
+        for (let x = 0; x < width; x++) {
+            const topOffset = topRowOffset + x * 4;
+            const botOffset = botRowOffset + x * 4;
+
+            const topHex = rgbaToHex(data[topOffset], data[topOffset + 1], data[topOffset + 2]);
+            const botHex = rgbaToHex(data[botOffset], data[botOffset + 1], data[botOffset + 2]);
+
+            if (topHex !== currentFg) {
+                line += `{${topHex}-fg}`;
+                currentFg = topHex;
+            }
+            if (botHex !== currentBg) {
+                line += `{${botHex}-bg}`;
+                currentBg = botHex;
+            }
+
+            line += "▀";
+        }
+
+        if (currentFg || currentBg) {
+            line += "{/}";
+        }
+
+        lines.push(line);
+    }
+
+    return lines.join("\n");
+}
+
+/**
+ * Выполняет полный цикл декодирования, масштабирования и рендеринга изображения в Blessed-строку.
+ * @param {Buffer|Uint8Array} buffer Исходный буфер изображения (JPEG или PNG)
+ * @param {object} [options]
+ * @param {string} [options.mimeType=""] MIME-тип изображения
+ * @param {number} [options.maxWidth=36] Максимальная ширина
+ * @param {number} [options.maxHeight=14] Максимальная высота
+ * @param {string} [options.cacheKey] Ключ для сохранения в кэш
+ * @returns {string}
+ */
+export function renderImageBuffer(buffer, { mimeType = "", maxWidth = 36, maxHeight = 14, cacheKey } = {}) {
+    if (cacheKey && imagePreviewCache.has(cacheKey)) {
+        return imagePreviewCache.get(cacheKey);
+    }
+
+    try {
+        const decoded = decodeImageBuffer(buffer, mimeType);
+        const { dstW, dstH } = calculateTargetDimensions(decoded.width, decoded.height, maxWidth, maxHeight);
+        const resized = resizeRgba(decoded.data, decoded.width, decoded.height, dstW, dstH);
+        const blessedText = rgbaToHalfBlockBlessed(resized, dstW, dstH);
+
+        if (cacheKey) {
+            if (imagePreviewCache.size >= MAX_CACHE_SIZE) {
+                const firstKey = imagePreviewCache.keys().next().value;
+                imagePreviewCache.delete(firstKey);
+            }
+            imagePreviewCache.set(cacheKey, blessedText);
+        }
+
+        return blessedText;
+    } catch {
+        return "";
+    }
+}
+
+/**
+ * Синхронно распаковывает и рендерит PhotoStrippedSize Telegram в Blessed Half-Block строку.
+ * @param {Buffer|Uint8Array} strippedBytes Байты PhotoStrippedSize
+ * @param {object} [options]
+ * @param {number} [options.maxWidth=36]
+ * @param {number} [options.maxHeight=14]
+ * @param {string} [options.cacheKey]
+ * @returns {string}
+ */
+export function renderStrippedThumbnail(strippedBytes, { maxWidth = 36, maxHeight = 14, cacheKey } = {}) {
+    if (!strippedBytes || strippedBytes.length < 3) return "";
+
+    if (cacheKey && imagePreviewCache.has(cacheKey)) {
+        return imagePreviewCache.get(cacheKey);
+    }
+
+    try {
+        const jpgBuf = strippedPhotoToJpg(strippedBytes);
+        return renderImageBuffer(jpgBuf, { mimeType: "image/jpeg", maxWidth, maxHeight, cacheKey });
+    } catch {
+        return "";
+    }
+}