@emaxe/tuigram 1.2.0 → 1.4.0

package/src/utils/image.js

@@ -294,8 +294,11 @@ export function rgbaToHalfBlockBlessed(data, width, height) {
  * @returns {string}
  */
 export function renderImageBuffer(buffer, { mimeType = "", maxWidth = 36, maxHeight = 14, cacheKey } = {}) {
-    if (cacheKey && imagePreviewCache.has(cacheKey)) {
-        return imagePreviewCache.get(cacheKey);
+    // Размер входит в ключ: одно и то же фото рисуется и миниатюрой в ленте, и на весь
+    // экран в просмотрщике. Без размера полноэкранный рендер подменял бы превью в ленте.
+    const key = cacheKey ? `${cacheKey}@${maxWidth}x${maxHeight}` : null;
+    if (key && imagePreviewCache.has(key)) {
+        return imagePreviewCache.get(key);
     }
 
     try {
@@ -304,12 +307,12 @@ export function renderImageBuffer(buffer, { mimeType = "", maxWidth = 36, maxHei
         const resized = resizeRgba(decoded.data, decoded.width, decoded.height, dstW, dstH);
         const blessedText = rgbaToHalfBlockBlessed(resized, dstW, dstH);
 
-        if (cacheKey) {
+        if (key) {
             if (imagePreviewCache.size >= MAX_CACHE_SIZE) {
                 const firstKey = imagePreviewCache.keys().next().value;
                 imagePreviewCache.delete(firstKey);
             }
-            imagePreviewCache.set(cacheKey, blessedText);
+            imagePreviewCache.set(key, blessedText);
         }
 
         return blessedText;
@@ -330,10 +333,7 @@ export function renderImageBuffer(buffer, { mimeType = "", maxWidth = 36, maxHei
 export function renderStrippedThumbnail(strippedBytes, { maxWidth = 36, maxHeight = 14, cacheKey } = {}) {
     if (!strippedBytes || strippedBytes.length < 3) return "";
 
-    if (cacheKey && imagePreviewCache.has(cacheKey)) {
-        return imagePreviewCache.get(cacheKey);
-    }
-
+    // Кэш проверяет renderImageBuffer: только он знает итоговый ключ с размером
     try {
         const jpgBuf = strippedPhotoToJpg(strippedBytes);
         return renderImageBuffer(jpgBuf, { mimeType: "image/jpeg", maxWidth, maxHeight, cacheKey });

package/src/utils/mouse.js

@@ -0,0 +1,223 @@
+/**
+ * Утилиты для обработки координат и сценариев взаимодействия с мышью в TUI.
+ */
+
+import unicode from "neo-blessed/lib/unicode.js";
+
+/** Пиктограммы и эмодзи, занимающие две ячейки терминала. */
+const EMOJI_REGEX = /\p{Extended_Pictographic}/u;
+
+/**
+ * Вычисляет ширину строки в терминальных ячейках.
+ * Учитывает двухъячеечные эмодзи и разметку blessed.
+ * @param {string} text
+ * @returns {number}
+ */
+export function stringCellWidth(text) {
+    if (!text) return 0;
+    const clean = text.replace(/\{[^{}]+\}/g, "");
+    let width = 0;
+    for (const char of clean) {
+        const byBlessed = unicode.strWidth(char);
+        width += EMOJI_REGEX.test(char) ? Math.max(2, byBlessed) : byBlessed;
+    }
+    return width;
+}
+
+/**
+ * Отличает клик правой кнопкой от остальных.
+ * neo-blessed эмитит одно и то же событие "click" для любой кнопки мыши,
+ * поэтому компоненты, где правый клик не имеет смысла, обязаны его отсеивать.
+ * @param {{ button?: string }} [data] данные события мыши blessed
+ * @returns {boolean}
+ */
+export function isRightClick(data) {
+    return data?.button === "right";
+}
+
+/**
+ * Проверяет, попадают ли координаты (x, y) внутрь прямоугольной области.
+ * @param {number} x абсолютная или относительная X-координата
+ * @param {number} y абсолютная или относительная Y-координата
+ * @param {{ left: number, top: number, width: number, height: number }} bounds
+ * @returns {boolean}
+ */
+export function isInsideBox(x, y, bounds) {
+    if (!bounds) return false;
+    const { left = 0, top = 0, width = 0, height = 0 } = bounds;
+    return x >= left && x < left + width && y >= top && y < top + height;
+}
+
+const DEFAULT_TAB_KEYS = ["all", "users", "groups", "channels", "bots", "unread"];
+const DEFAULT_TAB_NAMES = ["1:Все", "2:ЛС", "3:Группы", "4:Каналы", "5:Боты", "6:Непроч"];
+
+/**
+ * Определяет ключ вкладки диалогов по относительному горизонтальному смещению курсора мыши.
+ * @param {number} relativeX смещение по X от левого края строки вкладок (в ячейках)
+ * @param {string[]} [tabKeys] ключи вкладок
+ * @param {string[]} [tabNames] отображаемые названия вкладок
+ * @returns {string|null} ключ выбранной вкладки или null
+ */
+export function getTabByCoordinate(relativeX, tabKeys = DEFAULT_TAB_KEYS, tabNames = DEFAULT_TAB_NAMES) {
+    if (relativeX < 0) return null;
+
+    let currentX = 0;
+    for (let i = 0; i < tabNames.length; i++) {
+        // Каждая вкладка оформляется с одним ведущим и одним замыкающим пробелом
+        const tabWidth = stringCellWidth(` ${tabNames[i]} `);
+        if (relativeX >= currentX && relativeX < currentX + tabWidth) {
+            return tabKeys[i] || null;
+        }
+        currentX += tabWidth;
+    }
+
+    return null;
+}
+
+/**
+ * Находит сообщение в ленте по номеру отображаемой строки с учётом текущей прокрутки.
+ * Карту строк строит ChatView при отрисовке ленты — только он знает реальную вёрстку.
+ * @param {number} lineIndex индекс строки в буфере ленты (0-based)
+ * @param {Array<{ message: object, startLine: number, endLine: number }>} ranges
+ * @returns {object|null}
+ */
+export function getMessageAtLine(lineIndex, ranges) {
+    if (!ranges || ranges.length === 0 || lineIndex < 0) return null;
+
+    for (const item of ranges) {
+        if (lineIndex >= item.startLine && lineIndex <= item.endLine) {
+            return item.message;
+        }
+    }
+
+    return null;
+}
+
+/**
+ * Определяет, в какую часть сообщения попал клик: в превью изображения или в остальной текст.
+ * @param {number} lineIndex индекс строки в буфере ленты (0-based)
+ * @param {number} relativeX смещение по X от левого края ленты (в ячейках)
+ * @param {Array<{ message: object, startLine: number, endLine: number, image?: object|null }>} ranges
+ * @returns {{ message: object, part: "image"|"body" }|null}
+ */
+export function getMessagePartAtPoint(lineIndex, relativeX, ranges) {
+    if (!ranges || ranges.length === 0 || lineIndex < 0) return null;
+
+    for (const item of ranges) {
+        if (lineIndex < item.startLine || lineIndex > item.endLine) continue;
+
+        const image = item.image;
+        const insideImage = Boolean(image)
+            && lineIndex >= image.startLine && lineIndex <= image.endLine
+            && relativeX >= image.left && relativeX < image.right;
+
+        return { message: item.message, part: insideImage ? "image" : "body" };
+    }
+
+    return null;
+}
+
+/**
+ * Определяет действие по клику на строку состояния внизу экрана.
+ * @param {number} relativeX смещение по X от левого края строки состояния
+ * @param {number} [totalWidth=120] общая ширина терминала
+ * @returns {"focus"|"select"|"tabs"|"search"|"help"|"actions"|"info"|"quit"|null}
+ */
+export function getStatusBarActionAt(relativeX, totalWidth = 120) {
+    if (relativeX < 0 || relativeX >= totalWidth) return null;
+
+    // Сегменты подсказок в строке состояния:
+    // [Tab] Панель │ [Enter] Выбрать/Отправить │ [1-6] Вкладки │ [/] Поиск │ [F1] Помощь │ [Ctrl+A] Действия │ [Ctrl+P] Инфо │ [Ctrl+Q] Выход
+    const segments = [
+        { id: "focus", label: " [Tab] Панель " },
+        { id: "select", label: " [Enter] Выбрать/Отправить " },
+        { id: "tabs", label: " [1-6] Вкладки " },
+        { id: "search", label: " [/] Поиск " },
+        { id: "help", label: " [F1] Помощь " },
+        { id: "actions", label: " [Ctrl+A] Действия " },
+        { id: "info", label: " [Ctrl+P] Инфо " },
+        { id: "quit", label: " [Ctrl+Q] Выход" },
+    ];
+
+    let currentX = 0;
+    for (const seg of segments) {
+        const segWidth = stringCellWidth(seg.label) + 1; // +1 на разделитель "│"
+        if (relativeX >= currentX && relativeX < currentX + segWidth) {
+            return seg.id;
+        }
+        currentX += segWidth;
+    }
+
+    return null;
+}
+
+/** Ширина логотипа « 🚀 TuiGram» в ячейках — кликабельная зона вызова справки. */
+const HEADER_LOGO_WIDTH = stringCellWidth(" 🚀 TuiGram");
+
+/**
+ * Определяет действие при клике на верхнюю шапку приложения.
+ * @param {number} relativeX смещение по X от левого края шапки
+ * @param {number} relativeY смещение по Y от верхнего края шапки (0..3)
+ * @param {object} [options]
+ * @param {boolean} [options.hasActiveChat=false] есть ли выбранный активный чат
+ * @returns {"help"|"info"|"status"|null}
+ */
+export function getHeaderActionAt(relativeX, relativeY, { hasActiveChat = false } = {}) {
+    // Внутренняя строка 1 (верхняя линия контента): логотип TuiGram, имя пользователя, статус
+    if (relativeY === 1) {
+        // Контент шапки начинается после рамки, поэтому логотип занимает ячейки 1..HEADER_LOGO
+        if (relativeX >= 1 && relativeX <= HEADER_LOGO_WIDTH) {
+            return "help";
+        }
+        return "status";
+    }
+
+    // Внутренняя строка 2 (нижняя линия контента): активный чат
+    if (relativeY === 2) {
+        if (hasActiveChat) {
+            return "info";
+        }
+    }
+
+    return null;
+}
+
+/**
+ * Сегменты подсказок контекстной строки ввода в том порядке и с теми подписями,
+ * какими их рисует inputBox.renderContext. Ширины считаются из самих подписей —
+ * зашитые вручную координаты разъезжались при любой правке текста.
+ */
+const INPUT_HINT_SEGMENTS = [
+    { id: null, label: " Введите сообщение...  " },
+    { id: null, label: "[Enter] Отправить  " },
+    { id: null, label: "[Ctrl+J] Новая строка  " },
+    { id: "reply", label: "[Ctrl+R] Ответ  " },
+    { id: "edit", label: "[Ctrl+E] Правка  " },
+    { id: "commands", label: "[/] Команды" },
+];
+
+/**
+ * Определяет действие при клике на контекстную строку поля ввода.
+ * @param {number} relativeX смещение по X от левого края контекстной строки
+ * @param {string|null} mode текущий режим ("reply"|"edit"|null)
+ * @returns {"cancel"|"reply"|"edit"|"commands"|null}
+ */
+export function getInputContextActionAt(relativeX, mode) {
+    if (mode === "reply" || mode === "edit") {
+        // Любой клик по плашке ответа/редактирования (или по кнопке [Esc: Отмена]) сбрасывает режим
+        return "cancel";
+    }
+
+    if (relativeX < 0) return null;
+
+    let currentX = 0;
+    for (const seg of INPUT_HINT_SEGMENTS) {
+        const segWidth = stringCellWidth(seg.label);
+        if (relativeX >= currentX && relativeX < currentX + segWidth) {
+            return seg.id;
+        }
+        currentX += segWidth;
+    }
+
+    return null;
+}