ADR 0168: Раскладка двух мониторов — (P+F)(M) и бюджет PFD / Forward

Статус: Proposed
Дата: 2026-06-28

Резюме

Канон 0017 описывает три якоря на трёх экранах (P)(F)(M). У оператора часто два монитора: (P+F)(M) или (0.25P + 0.75F)(M) — PFD и Forward делят один экран, MFD на втором.

При такой топологии semantic map на PFD (дефолт pfd_primary = "workspace_map") и широкий chrome Monaco (minimap, будущий outline) на узком Forward дают плохую читаемость. Принято:

1. Для P+F на одном экране — PFD по умолчанию схлопнут (колонка 0 / только полоса cockpit при необходимости). Не map и не Solution Explorer на PFD — оба отъедают Forward без пользы на ~220 px.
2. Файловая навигация: Ctrl+P (0167) + Solution Explorer на MFD (страница); Semantic Map — тоже MFD.
3. Forward editor budget — topology-aware: minimap / outline не съедают кодовую колонку на узком F.

Три монитора (P)(F)(M) — отдельный дефолт: на своём экране P допустимы map или SE (0039).

Связанные ADR

Вне ADR

Снимок (на момент ADR)

1. Контекст

1.1 Два монитора vs канон трёх

На 2 мониторах PFD — не «боковая панель на всём экране F», а ~25% ширины монитора (или фиксированные 220 px в MainGrid). Semantic map с графом/подписями в 220 px нечитаема; оператор feedback: «плохо читается».

1.2 Forward: Monaco отъедает место

На том же экране Forward делит ширину с PFD. Дополнительно:

• Minimap (включён в cide-editor-bridge.js);
• Inlay hints;
• планируемый outline / breadcrumbs в dock chrome (0164);
• HUD / diagnostic strips.

Итог: эффективная ширина кода < ожиданий VS/Rider на одном мониторе.

1.3 Согласование с 0039

0039 уже допускает: semantic map на PFD, дерево на MFD. Для 2 экранов приоритет: не дублировать «шкаф» рядом с редактором — файлы через Ctrl+P и страницы MFD; PFD не обязан показывать ни map, ни SE.

1.4 Зачем не SE на PFD при 2 мониторах

Вывод: на (P+F)(M) PFD default = hidden/collapsed; SE и map — opt-in (меню «Вид») или MFD, не дефолт на PFD.

2. Решение

2.1 Topology-aware PFD (2-screen: не map, не SE)

Правило: при IsPmPlusForwardTwoScreenPreset (P+F на одном physical screen) effective default:

Реализация: CockpitPresentationLayoutPolicy + существующие IsPfdColumnVisible / IsPfdRegionExpanded.

Три монитора (P)(F)(M): на отдельном экране P — workspace_map или solution_tree по вкусу (широкая колонка).

2.2 MFD — дом для «шкафа» и карты

Переключение страниц MFD — как сейчас; не требовать дублирования SE на PFD.

2.3 Бюджет ширины на 2-screen

2.4 Forward editor chrome (topology-aware)

ForwardEditorChromePolicy (новый маленький сервис или флаги в settings):

Порог: forwardColumnWidth < 900 (настраиваемо) → apply narrow preset.

Monaco options push через editor/setIntelligence или dedicated editor/setLayoutChrome.

2.5 Рекомендуемые пресеты settings (документация)

[display.screens]
topology = "(0.25P + 0.75F) (M)"

[display.instruments]
# 2-screen policy: PFD collapsed unless user sets pfd_primary explicitly
# pfd_primary = "collapsed"   # future explicit key; until then IsPfdColumnVisible default false

[display.forward]
# narrow_chrome_auto = true
# minimap = "auto"

2.6 MLP вместе с 0167

MLP layout (2 монитора):

• PFD скрыт по умолчанию при P+F shared
• Ctrl+P — основной путь к файлам
• SE / map — страницы MFD, не дефолт на PFD
• Minimap off при narrow Forward (или user toggle)

3. Не цели

• Отмена (P)(F)(M) для 3 мониторов.
• Новый четвёртый якорь в EBNF presentation.
• Автоматическое определение числа мониторов без topology (оператор задаёт строку явно).

4. Последствия

• defaults-settings.toml: для 2-screen — policy скрывает PFD (IsPfdColumnVisible default false), не меняет pfd_primary на SE; map/SE — MFD + Ctrl+P.
• Playbook layout: симптом «map/SE бесполезны на PFD» → topology (P+F)(M) → скрыть PFD, открыть MFD.
• Тесты: IsPmPlusForwardTwoScreenPreset → IsPfdColumnVisible == false при старте (без user override).

5. История