Files

Mikhail Kilin b0f1f9fdc2 feat: implement Phase 11 — inline photo viewing with ratatui-image

Add feature-gated (`images`) inline photo support:
- New types: MediaInfo, PhotoInfo, PhotoDownloadState, ImagesConfig
- Media module: ImageCache (LRU filesystem cache), ImageRenderer (terminal protocol detection)
- Photo metadata extraction from TDLib MessagePhoto with download_file() API
- ViewImage command (v/м) to toggle photo expand/collapse in message selection
- Two-pass UI rendering: placeholder lines in message bubbles + StatefulImage overlay
- Collapse all expanded photos on Esc (exit selection mode)

Dependencies: ratatui-image 8.1, image 0.25 (optional, behind `images` feature flag)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-06 21:25:17 +03:00

5.2 KiB

Raw Blame History

Текущий контекст проекта

Статус: Фаза 11 — Inline просмотр фото (DONE)

Завершённые фазы (краткий итог)

Фаза	Описание	Статус
1	Базовая инфраструктура (ratatui + crossterm, vim-навигация)	DONE
2	TDLib интеграция (авторизация, чаты, сообщения)	DONE
3	Улучшение UX (отправка, поиск, скролл, realtime)	DONE
4	Папки и фильтрация (загрузка папок, переключение 1-9)	DONE
5	Расширенный функционал (онлайн-статус, медиа-заглушки, muted)	DONE
6	Полировка (60 FPS, память, graceful shutdown, динамический инпут)	DONE
7	Рефакторинг памяти (единый источник данных, LRU-кэш)	DONE
8	Дополнительные фичи (markdown, edit/delete, reply/forward, блочный курсор)	DONE
9	Расширенные возможности (typing, pinned, поиск в чате, черновики, профиль, копирование, реакции, конфиг)	DONE
10	Desktop уведомления (notify-rust, muted фильтр, mentions, медиа)	DONE (83%)
11	Inline просмотр фото (ratatui-image, кэш, загрузка)	DONE
13	Глубокий рефакторинг архитектуры (7 этапов)	DONE

Фаза 11: Inline фото (подробности)

5 шагов, feature-gated (images):

Типы + зависимости: MediaInfo, PhotoInfo, PhotoDownloadState, ImagesConfig; ratatui-image 8.1, image 0.25
Метаданные + API: extract_media_info() из TDLib MessagePhoto; download_file() в TdClientTrait
Media модуль: ImageCache (LRU, ~/.cache/tele-tui/images/), ImageRenderer (Picker + StatefulProtocol)
ViewImage команда: v/м toggle; collapse all on Esc; download → cache → expand
UI рендеринг: photo status в message_bubble.rs (Downloading/Error/placeholder); render_images() второй проход с StatefulImage

Фаза 13: Рефакторинг (подробности)

Разбиты 5 монолитных файлов (4582 строк) на модульную архитектуру:

input/main_input.rs (1199→164): чистый роутер + 5 handler модулей в handlers/
app/mod.rs (1015→371): 5 trait модулей в methods/ (Navigation, Message, Compose, Search, Modal)
ui/messages.rs (893→365): модули modals/ (search, pinned, delete, reactions) + compose_bar.rs
tdlib/messages.rs (836→3 файла): messages/ (mod, convert, operations)
config/mod.rs (642→3 файла): validation.rs, loader.rs
Очистка дублей: ~220 строк удалено (shared components, format_user_status, scroll_to_message)
Документация: PROJECT_STRUCTURE.md переписан, 16 файлов получили //! docs

Ключевая архитектура

main.rs → event loop (16ms poll)
├── input/ → роутер + handlers/ (chat, chat_list, compose, modal, search)
├── app/ → App<T: TdClientTrait> + methods/ (5 traits, 67 методов)
├── ui/ → рендеринг (messages, chat_list, modals/, compose_bar, components/)
├── media/ → [feature=images] cache.rs, image_renderer.rs
└── tdlib/ → TDLib wrapper (client, auth, chats, messages/, users, reactions, types)

Тестирование

500+ тестов (0 failures):

Snapshot tests: 57 (UI компоненты)
Integration tests: 93 (user flows)
E2E tests: 12 (smoke + journey)
Utils tests: 18
Performance benchmarks: 8

Ключевые решения

Неблокирующий receive: TDLib updates через mpsc::channel в отдельном потоке
Trait-based App: методы разбиты на traits — требуют use import на call site
FakeTdClient: mock для тестов без TDLib (реализует TdClientTrait)
Оптимизация рендеринга: needs_redraw флаг, рендеринг только при изменениях
Конфиг: TOML ~/.config/tele-tui/config.toml, credentials с приоритетом (XDG → .env)
Feature-gated images: images feature flag для ratatui-image + image deps

Зависимости (основные)

ratatui = "0.29"           # TUI фреймворк
crossterm = "0.28"          # Терминальный backend
tdlib-rs = "1.1"            # Telegram TDLib binding
tokio = "1"                 # Async runtime
notify-rust = "4.11"        # Desktop уведомления (feature flag)
ratatui-image = "8.1"       # Inline images (feature flag)
image = "0.25"              # Image decoding (feature flag)

Полная структура проекта: см. PROJECT_STRUCTURE.md Подробный план: см. ROADMAP.md

5.2 KiB Raw Blame History Unescape Escape