Порядок вкладок 1–6 с Podcasts на 4 и миграция keymap (MR-T1) #2

Merged
ab merged 5 commits from sanapach/furumi-tui:podcasts/tab-order into federation 2026-11-20 14:11:00 +00:00
Member

Серия «Подкасты»: MR-F1 Furumi/frid#1 · MR-F2 Furumi/frid#2 · MR-F3 Furumi/frid#3 · MR-0 Furumi/furumi-tui#1 · MR-T1 Furumi/furumi-tui#2 (этот) · MR-T2 Furumi/furumi-tui#3 · MR-T3 Furumi/furumi-tui#4 · MR-W1 Furumi/furumi-web#10 · MR-W2 Furumi/furumi-web#11 · MR-W3 Furumi/furumi-web#12. Порядок merge и зависимости — в разделе зависимостей ниже.

Что сделано

Реализовано решение Р8 плана подкастов (MR-T1 серии).

  • Новый порядок вкладок: 1 Library, 2 Playlists, 3 Queue, 4 Podcasts, 5 Settings, 6 Logs. Он задан в одном месте, Tab::ALL. От него зависят панель вкладок, Tab/Shift+Tab (с переходом через край), GoToTab и выбор отрисовки.

  • Панель вкладок на узком терминале сокращается, а не обрезается. Перебираются формы, берётся первая, которая помещается:

    • полные названия с отступами (77 колонок);
    • полные названия без отступов (65);
    • короткие названия 1 Lib, 2 Lists, 3 Queue, 4 Pods, 5 Set, 6 Logs (48);
    • только номера, у активной вкладки полное название (не больше 28);
    • только номера (18).

    Все шесть номеров и подсветка активной вкладки остаются видны.

  • Вкладка Podcasts пока заглушка (src/ui/podcasts.rs): на ней сообщение, что в этой сборке подкасты ещё недоступны. Логики подкастов нет. На узком экране текст переносится и не обрезается. Добавлен контекст привязок podcasts (KeyContext::Podcasts).

  • В справке (?) для цифровых клавиш показано имя вкладки («Go to Podcasts», «Go to Settings») вместо «Go to tab N».

  • default_keymap.toml: в начале version = 2, добавлена привязка "6" → GoToTab = 5. В заголовке описаны:

    • формат версии и правило «version — до первого [[keymaps]]»;
    • пути к файлу для Linux и macOS;
    • список контекстов, включая podcasts и settings.
  • Совместимость пользовательских keymap.toml:

    • в формате появилось необязательное поле верхнего уровня version;
    • файлы без version (и с version = 1) считаются старыми. Индексы GoToTab пересчитываются в памяти: 0, 1, 2 без изменений; 3 (старый Settings) → 4; 4 (старый Logs) → 5; 5 (Podcasts из прототипа GitHub PR) → 3;
    • version = 2 используется буквально;
    • если version записан после заголовка [[keymaps]], TOML относит его к этой записи. Такой файл отклоняется с понятной ошибкой: «version must be a top-level key placed before the first keymaps entry». Без этого он молча считался бы старым и получал пересчёт. Остальные незнакомые поля в записях по-прежнему игнорируются (deny_unknown_fields не включён);
    • файл пользователя никогда не переписывается. Если хотя бы один индекс пересчитан, при запуске показывается неблокирующее уведомление в строке статуса и пишется запись в лог.
  • Стартовые сообщения объединяются через ; (app::join_status_messages). Уведомление keymap больше не скрывает предупреждение «logging disabled: …». Раньше main.rs оставлял только одно из двух.

  • Документация:

    • README: раздел «Tabs and key bindings» с таблицей, описанием version = 2, путями для Linux (~/.config/furumi/keymap.toml) и macOS (~/Library/Application Support/furumi/keymap.toml), поведением узкой панели;
    • ARCHITECTURE: раздел «Versioned key bindings»;
    • AGENTS: правило — смена Tab::ALL требует новой KEYMAP_VERSION и миграции в памяти;
    • CHANGELOG: раздел [Unreleased].

Решения и отступления от плана

  • В плане сказано «разовое уведомление». Чтобы не хранить на диске служебное состояние, уведомление показывается при каждом запуске, пока в файле нет version = 2. Работу оно не блокирует. Если в старом файле ни один индекс не изменился (например, есть только 1 → GoToTab 0), уведомления нет.
  • Краевые случаи версии, которых не было в плане:
    • version = 1 обрабатывается как старый формат;
    • version = 0 — ошибка: файл игнорируется с обычным предупреждением, как любой битый keymap;
    • версия выше 2 используется буквально, с уведомлением, что она новее поддерживаемой;
    • version внутри записи [[keymaps]] — ошибка (см. выше).
  • Сокращённые названия вкладок (Tab::short_title) добавлены только ради узких терминалов. В справке и в широкой панели остаются полные названия.
  • Навигация (j/k/Enter) на вкладке-заглушке выводит уже существующее общее сообщение «Navigation in this view: coming in a later milestone».

Совместимость и версии

  • Протоколы, wire-форматы, БД и зависимости не менялись. Cargo.lock не менялся, [patch] для frid не нужен: MR собирается против опубликованных music-dht 0.5.0 и furumi-library 0.2.0, как federation.
  • Старые пользовательские keymap открывают те же вкладки, что и раньше. Конфиги прототипа подкастов (Podcasts на 6) тоже учтены.
  • Единственное новое поведение для существующих файлов: файл с полем version внутри записи [[keymaps]] теперь отклоняется. До этого MR поля version не существовало, поэтому реальных файлов это затронуть не должно.
  • Версию крейта мейнтейнер поднимает при релизе.

Как проверено (macOS, Darwin 25.5.0, rustc 1.100.0)

cargo fmt --all -- --check   # OK
cargo check --all-targets    # OK
cargo test --all-targets     # test result: ok. 186 passed; 0 failed; 4 ignored
cargo clippy --all-targets   # 20/22 предупреждения — тот же набор, что на origin/federation; новых нет

Новые тесты:

  • app/update_tests.rs: порядок и заголовки вкладок, обход Tab/Shift+Tab с переходом через край, GoToTab по новой нумерации, подписи в справке.
  • config/keymap.rs:
    • версия стандартного keymap, цифры 1–6;
    • пересчёт старого файла, version = 1, старый файл без изменённых индексов (без уведомления);
    • version = 2 буквально, версия новее поддерживаемой, version = 0 — ошибка;
    • version внутри записи [[keymaps]] — ошибка; незнакомые поля в записях игнорируются;
    • переопределение цифр старым файлом поверх стандартных привязок, контекст podcasts.
  • ui/mod.rs (TestBackend):
    • панель вкладок с номерами в новом порядке;
    • все шесть номеров и подпись активной вкладки на ширине 80/77/76/70/65/60/48/40/30;
    • подсветка активной вкладки в компактном режиме;
    • заглушка Podcasts и перенос её текста на ширине 60 и 40;
    • имена вкладок в окне справки.
  • app/mod.rs: объединение стартовых сообщений (оба сохраняются).

Тесты не читают реальные каталоги конфигурации, не обращаются к сети и не используют аудиоустройства.

Ограничения

  • Проверено только на macOS. Linux и Windows не запускались, хотя платформенного кода в изменении нет.
  • TUI вручную не запускался — ни с реальным старым keymap.toml, ни в узком окне терминала. Пересчёт, уведомление, компактная панель и перенос текста заглушки покрыты тестами.
  • На терминале уже 18 колонок панель вкладок всё равно обрезается.
  • Вкладка Podcasts пока заглушка, функциональность придёт в MR-T2.

Зависимости

От других MR не зависит, можно вливать первым. Ветка Sanapach/furumi-tui:podcasts/tab-order → Furumi/furumi-tui:federation (база 292f17f, вершина 595c886). MR-T2 (подкасты в TUI) строится поверх этого MR и заменяет заглушку настоящим видом.

Коммиты (git log --oneline federation..podcasts/tab-order):

  • e78f162 Reorder tabs and migrate legacy keymap tab indices
  • df17120 Document the new tab order and keymap version
  • df7ad3c Reject a keymap version nested in a binding; fix macOS keymap path in docs
  • 78bf2cf Keep all tabs visible on narrow terminals and wrap the podcasts placeholder
  • 595c886 Show both keymap notice and logging warning at startup

Межклиентская проверка серии (см. MR-T2) запускала реальный бинарник TUI 0.5.0, который включает этот MR, и его вкладку Podcasts. Новый порядок вкладок и миграцию keymap она отдельно не проверяла, отдельно для этого MR ничего не прогонялось.

🤖 Generated with Claude Code

> **Серия «Подкасты»:** MR-F1 Furumi/frid#1 · MR-F2 Furumi/frid#2 · MR-F3 Furumi/frid#3 · MR-0 Furumi/furumi-tui#1 · **MR-T1 Furumi/furumi-tui#2** (этот) · MR-T2 Furumi/furumi-tui#3 · MR-T3 Furumi/furumi-tui#4 · MR-W1 Furumi/furumi-web#10 · MR-W2 Furumi/furumi-web#11 · MR-W3 Furumi/furumi-web#12. Порядок merge и зависимости — в разделе зависимостей ниже. ## Что сделано Реализовано решение **Р8** плана подкастов (MR-T1 серии). - Новый порядок вкладок: `1` Library, `2` Playlists, `3` Queue, `4` Podcasts, `5` Settings, `6` Logs. Он задан в одном месте, `Tab::ALL`. От него зависят панель вкладок, Tab/Shift+Tab (с переходом через край), `GoToTab` и выбор отрисовки. - Панель вкладок на узком терминале сокращается, а не обрезается. Перебираются формы, берётся первая, которая помещается: - полные названия с отступами (77 колонок); - полные названия без отступов (65); - короткие названия `1 Lib`, `2 Lists`, `3 Queue`, `4 Pods`, `5 Set`, `6 Logs` (48); - только номера, у активной вкладки полное название (не больше 28); - только номера (18). Все шесть номеров и подсветка активной вкладки остаются видны. - Вкладка **Podcasts** пока заглушка (`src/ui/podcasts.rs`): на ней сообщение, что в этой сборке подкасты ещё недоступны. Логики подкастов нет. На узком экране текст переносится и не обрезается. Добавлен контекст привязок `podcasts` (`KeyContext::Podcasts`). - В справке (`?`) для цифровых клавиш показано имя вкладки («Go to Podcasts», «Go to Settings») вместо «Go to tab N». - `default_keymap.toml`: в начале `version = 2`, добавлена привязка `"6"` → `GoToTab = 5`. В заголовке описаны: - формат версии и правило «`version` — до первого `[[keymaps]]`»; - пути к файлу для Linux и macOS; - список контекстов, включая `podcasts` и `settings`. - Совместимость пользовательских `keymap.toml`: - в формате появилось необязательное поле верхнего уровня `version`; - файлы **без** `version` (и с `version = 1`) считаются старыми. Индексы `GoToTab` пересчитываются в памяти: 0, 1, 2 без изменений; 3 (старый Settings) → 4; 4 (старый Logs) → 5; 5 (Podcasts из прототипа GitHub PR) → 3; - `version = 2` используется буквально; - если `version` записан после заголовка `[[keymaps]]`, TOML относит его к этой записи. Такой файл отклоняется с понятной ошибкой: «`version` must be a top-level key placed before the first [[keymaps]] entry». Без этого он молча считался бы старым и получал пересчёт. Остальные незнакомые поля в записях по-прежнему игнорируются (`deny_unknown_fields` не включён); - **файл пользователя никогда не переписывается.** Если хотя бы один индекс пересчитан, при запуске показывается неблокирующее уведомление в строке статуса и пишется запись в лог. - Стартовые сообщения объединяются через `; ` (`app::join_status_messages`). Уведомление keymap больше не скрывает предупреждение «logging disabled: …». Раньше `main.rs` оставлял только одно из двух. - Документация: - README: раздел «Tabs and key bindings» с таблицей, описанием `version = 2`, путями для Linux (`~/.config/furumi/keymap.toml`) и macOS (`~/Library/Application Support/furumi/keymap.toml`), поведением узкой панели; - ARCHITECTURE: раздел «Versioned key bindings»; - AGENTS: правило — смена `Tab::ALL` требует новой `KEYMAP_VERSION` и миграции в памяти; - CHANGELOG: раздел `[Unreleased]`. ## Решения и отступления от плана - В плане сказано «разовое уведомление». Чтобы не хранить на диске служебное состояние, уведомление показывается при каждом запуске, пока в файле нет `version = 2`. Работу оно не блокирует. Если в старом файле ни один индекс не изменился (например, есть только `1` → `GoToTab 0`), уведомления нет. - Краевые случаи версии, которых не было в плане: - `version = 1` обрабатывается как старый формат; - `version = 0` — ошибка: файл игнорируется с обычным предупреждением, как любой битый keymap; - версия выше 2 используется буквально, с уведомлением, что она новее поддерживаемой; - `version` внутри записи `[[keymaps]]` — ошибка (см. выше). - Сокращённые названия вкладок (`Tab::short_title`) добавлены только ради узких терминалов. В справке и в широкой панели остаются полные названия. - Навигация (j/k/Enter) на вкладке-заглушке выводит уже существующее общее сообщение «Navigation in this view: coming in a later milestone». ## Совместимость и версии - Протоколы, wire-форматы, БД и зависимости не менялись. **`Cargo.lock` не менялся, `[patch]` для frid не нужен:** MR собирается против опубликованных `music-dht 0.5.0` и `furumi-library 0.2.0`, как `federation`. - Старые пользовательские keymap открывают те же вкладки, что и раньше. Конфиги прототипа подкастов (Podcasts на `6`) тоже учтены. - Единственное новое поведение для существующих файлов: файл с полем `version` внутри записи `[[keymaps]]` теперь отклоняется. До этого MR поля `version` не существовало, поэтому реальных файлов это затронуть не должно. - Версию крейта мейнтейнер поднимает при релизе. ## Как проверено (macOS, Darwin 25.5.0, rustc 1.100.0) ``` cargo fmt --all -- --check # OK cargo check --all-targets # OK cargo test --all-targets # test result: ok. 186 passed; 0 failed; 4 ignored cargo clippy --all-targets # 20/22 предупреждения — тот же набор, что на origin/federation; новых нет ``` Новые тесты: - `app/update_tests.rs`: порядок и заголовки вкладок, обход Tab/Shift+Tab с переходом через край, `GoToTab` по новой нумерации, подписи в справке. - `config/keymap.rs`: - версия стандартного keymap, цифры 1–6; - пересчёт старого файла, `version = 1`, старый файл без изменённых индексов (без уведомления); - `version = 2` буквально, версия новее поддерживаемой, `version = 0` — ошибка; - `version` внутри записи `[[keymaps]]` — ошибка; незнакомые поля в записях игнорируются; - переопределение цифр старым файлом поверх стандартных привязок, контекст `podcasts`. - `ui/mod.rs` (TestBackend): - панель вкладок с номерами в новом порядке; - все шесть номеров и подпись активной вкладки на ширине 80/77/76/70/65/60/48/40/30; - подсветка активной вкладки в компактном режиме; - заглушка Podcasts и перенос её текста на ширине 60 и 40; - имена вкладок в окне справки. - `app/mod.rs`: объединение стартовых сообщений (оба сохраняются). Тесты не читают реальные каталоги конфигурации, не обращаются к сети и не используют аудиоустройства. ## Ограничения - Проверено только на macOS. Linux и Windows не запускались, хотя платформенного кода в изменении нет. - TUI вручную не запускался — ни с реальным старым `keymap.toml`, ни в узком окне терминала. Пересчёт, уведомление, компактная панель и перенос текста заглушки покрыты тестами. - На терминале уже 18 колонок панель вкладок всё равно обрезается. - Вкладка Podcasts пока заглушка, функциональность придёт в MR-T2. ## Зависимости От других MR не зависит, можно вливать первым. Ветка `Sanapach/furumi-tui:podcasts/tab-order` → `Furumi/furumi-tui:federation` (база `292f17f`, вершина `595c886`). MR-T2 (подкасты в TUI) строится поверх этого MR и заменяет заглушку настоящим видом. Коммиты (`git log --oneline federation..podcasts/tab-order`): - `e78f162` Reorder tabs and migrate legacy keymap tab indices - `df17120` Document the new tab order and keymap version - `df7ad3c` Reject a keymap version nested in a binding; fix macOS keymap path in docs - `78bf2cf` Keep all tabs visible on narrow terminals and wrap the podcasts placeholder - `595c886` Show both keymap notice and logging warning at startup Межклиентская проверка серии (см. MR-T2) запускала реальный бинарник TUI 0.5.0, который включает этот MR, и его вкладку Podcasts. Новый порядок вкладок и миграцию keymap она отдельно не проверяла, отдельно для этого MR ничего не прогонялось. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
sanapach added 5 commits 2026-11-20 13:23:08 +00:00
Tabs are now 1 Library, 2 Playlists, 3 Queue, 4 Podcasts, 5 Settings,
6 Logs. The Podcasts tab is a placeholder that states podcasts are not
available in this build yet; it gets its own "podcasts" key context.

Keymap files gain an optional top-level `version`. The default keymap
declares `version = 2` and binds "6" to the Logs tab. Files without a
version (or with version 1) have their GoToTab indices remapped in
memory (3 -> 4, 4 -> 5, and 5 -> 3 for the prototype podcast build) with
a startup notice; the user's file is never rewritten. The help window
names the target tab instead of "Go to tab N".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
sanapach changed title from Podcasts/tab order to Порядок вкладок 1–6 с Podcasts на 4 и миграция keymap (MR-T1) 2026-11-20 13:36:56 +00:00
ab merged commit 44d0bb5abe into federation 2026-11-20 14:11:00 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Furumi/furumi-tui#2