Сопровождающий Ratatui предложил протокол рамок терминала без потери строк

Автор, который поддерживает библиотеку Ratatui для текстовых интерфейсов (TUI), предложил черновик терминального протокола, рисующего тонкие линии на краях ячеек. Рамка в нём, атрибут ячейки, как цвет фона. Она не занимает ни строку, ни столбец. Работающая реализация, патч к терминалу Ghostty (ранняя версия была в Rio), демо-приложения сделаны на Ratatui. Автор просит отзывов у разработчиков терминалов и TUI.
Проблема в том, что обычные рамки из блока Unicode Box Drawing (в нём 128 символов для линий, углов и стыков), это текст: каждая линия занимает целую ячейку. Автор приводит прикидку: на 16-дюймовом ноутбуке с читаемым шрифтом терминал около 200x50, и при нескольких уровнях вложенных панелей на одни линии легко уходит 6 или 8 из 50 строк. Между двумя занятыми ячейками линию не провести, поэтому поле ввода нельзя подчеркнуть вплотную к тексту, а кнопку обвести без отступов. У скруглённых углов цвет фона один на весь символ, и в углах получаются квадратики не того цвета. Толщину и положение линии определяет шрифт. При копировании текста из рамки в буфер попадают и символы рамки, знакомая всем чистка символов «│» после вставки в Slack.
Как это устроено. Ячейка может нести до двенадцати отрезков: по две половины каждого из четырёх краёв и четыре луча от центра. У каждого отрезка свои цвет, ширина, положение и стиль. Терминал рисует их поверх сетки ячеек. Рамки хранятся в ячейках, поэтому прокручиваются, стираются, вставляются и переносятся вместе с текстом; при стирании и прокрутке работают те же правила, что для цвета. Края разбиты на половины, чтобы рамка совпадала с символами-четвертинками (▖▗▘▝) и можно было обвести фигуру, сдвинутую на полячейки. Линии бывают сплошными, двойными, пунктирными и точечными; углы и центры, прямыми или скруглёнными с настраиваемым радиусом и сглаженными дугами. У скруглённого угла можно указать внешний цвет, чтобы область за дугой закрашивалась правильно.
Если две соседние ячейки рисуют линию на общем краю, линии сливаются в одну. Побеждает штрих с более высоким приоритетом, затем более широкий, затем тот, что справа или снизу. Так сфокусированная панель может поднять приоритет и сохранить контур целиком. Первая попытка автора была проще, «правее и ниже всегда побеждает», пока у сфокусированной панели сосед не отнял половину контура.
Формат передачи, одна строка DCS с пространством имён: ESC P 1 + b cell-border ; OP ; FIELDS... ESC . Основной путь, «перо» (pen), которое хранится в курсоре, как текущий цвет фона: задал перо, напечатал текст, и напечатанные ячейки получили рамки; сброс, SGR 0. Есть также команды для прямоугольников, которые ставят или стирают рамки у уже существующих ячеек, и запрос возможностей. Приложение шлёт запрос, а следом DA1. Если ответ на DA1 пришёл без ответа cell-border, терминал протокол не поддерживает, и приложение переходит на символы рамок, резервируя под них место. Терминалы, не знающие этой DCS-строки, её игнорируют. Минимум для терминала, перо, команды для прямоугольников и сплошные штрихи; стили линий, скруглённые стыки, приоритет и внешние цвета, необязательные расширения, о них сообщает ответ на запрос возможностей, а неизвестные поля игнорируются. Версия «1», это «1» в DCS 1 + b; по словам автора, это не «готово и стабильно», а первый вариант, который он решился записать, и его можно читать как v0.1 или черновик.
Прецеденты есть, но неполные. Линии DEC в DECterm (расширение 43 в ответе DA1) идут отдельным слоем: очистка экрана их не убирает, они всегда в один пиксель и цвета обычного текста. Атрибуты SGR 51-65 (рамка, обводка, надчёркивание, боковые линии для иероглифов) только включаются и выключаются, без цвета, ширины и стыков, и у них нет нижнего края. В консоли Win32 есть флаги сетки для верхнего, левого и правого краёв, похожие атрибуты, в PDCurses и X/Open curses; это ближе всего к новому протоколу, но нет нижнего края (в Win32), цвета, ширины и половин. Терминалы IBM 3270 умеют обводить целые поля ввода. Ни одно из решений не даёт линию со своими цветом и шириной на каждом крае. Первый прототип автор сделал в Rio (raphamorim/rio#1947) на APC, но отзывы показали, что APC небезопасно использовать повторно: Kermit 95 с 90-х исполняет APC как команды Kermit. Автор перешёл на DCS: там уже живут структурированные команды, а нераспознанные DCS терминалы игнорируют.
Граничные случаи. Мультиплексоры вроде tmux перерисовывают панели по собственной сетке ячеек, поэтому прямая передача последовательностей поставила бы рамки не туда. Мультиплексор, не знающий протокола, должен отбросить их и сам ответить на DA1, тогда приложения откатятся к символам рамок. Знающий протокол мультиплексор может хранить рамки как обычный атрибут и перерисовывать. Конфликты на общем краю решаются при отрисовке по правилу приоритета, поэтому порядок записи ячеек неважен. Стирание, вставка и удаление работают как для фона: стёртые ячейки получают текущее перо, а вставленные и удалённые строки уносят рамки с собой. Прокрутка, альтернативный экран и перенос строк в основном работают сами, раз рамка живёт в ячейке.
Стоимость. Изменение в Ghostty, около 1650 строк, значительная часть из них тесты. Каждая ячейка получает 16-битный идентификатор рамки, он помещается в уже имевшееся выравнивание, так что ячейки не растут, а экран без рамок ничего не стоит. Идентификаторы указывают в общую для терминала таблицу различных наборов рамок (около 100 байт на набор). Типичному TUI хватает нескольких наборов, но таблица не освобождается, и в худшем случае (заняты все 65 535 идентификаторов) это порядка 10-15 МБ. Отрисовка дополнительно работает только для ячеек с рамками: каждая смотрит на четырёх соседей для разрешения общих краёв, так что изменение строки перестраивает и соседние. Прямые линии, несколько сплошных четырёхугольников на ячейку, скруглённые углы дороже: дуга рисуется рядами маленьких четырёхугольников, примерно по одному на пиксель края. Автор пока не делал нормальных замеров производительности и именно здесь просит помощи.
Как попробовать. Спецификация и обоснование лежат в форке Ghostty автора; ветка joshka/cell-borders реализует всю версию 1. Автор собирал и запускал её только на macOS, сборки GTK и OpenGL не проверены. Нужны Zig 0.17 и Xcode: клонировать ветку, собрать zig build -Doptimize=ReleaseFast -Dxcframework-target=native, открыть zig-out/Ghostty.app. В ветке есть скрипт-галерея scripts/cell-borders.py, который сначала проверяет поддержку, поэтому им можно быстро проверить реализацию в другом терминале. Автор отдельно оговаривает, что пост и код написаны при большой помощи ИИ.
Ключевые факты
- Черновик протокола (строка DCS с пространством имён cell-border) рисует линии на краях ячеек как атрибут ячейки: рамки не занимают строк и столбцов и не попадают в копируемый текст.
- Ячейка может нести до двенадцати отрезков с собственными цветом, шириной, положением и стилем; стили: сплошной, двойной, пунктирный, точечный, углы прямые или скруглённые.
- Есть рабочий патч для Ghostty примерно на 1650 строк (ранняя версия была в Rio) и демо на Ratatui; сборка, Zig 0.17 и Xcode, проверено только на macOS.
- Приложение проверяет поддержку запросом и DA1; без поддержки откатывается к символам Box Drawing. Мультиплексор, не знающий протокол, должен отбрасывать последовательности.
- Издержки: 16-битный идентификатор на ячейку в уже имевшемся выравнивании, таблица наборов до 10-15 МБ в худшем случае; замеров производительности пока нет.
Почему это важно
Рамки из символов Unicode занимают целые ячейки, поэтому слои вложенных панелей съедают заметную часть экрана (по прикидке автора, 6-8 из 50 строк), а поля ввода и кнопки приходится окружать отступами. Протокол предлагает вынести линии из текста в атрибут ячейки: тогда они не попадают в копируемый текст, прокручиваются вместе с содержимым и позволяют рисовать подчёркивание вплотную к тексту, сетку на графиках и меню поверх другого содержимого. Это попытка исправить давнюю слабость терминальных интерфейсов на уровне самого терминала, а не очередными приёмами с символами.
Кому это важно
Авторам эмуляторов терминала и мультиплексоров, к которым прямо обращён запрос на отзывы, а также авторам TUI-библиотек и приложений: Ratatui, btop-подобных мониторов, форм и панельных интерфейсов. Тем, кому надоело вычищать символы рамок при копировании из терминала, тоже интересно, но пока поддержка есть только в патче автора.
Как это применить
Попробовать можно только в патче Ghostty: клонировать ветку joshka/cell-borders из форка автора, собрать при Zig 0.17 и Xcode командой zig build -Doptimize=ReleaseFast -Dxcframework-target=native и запустить zig-out/Ghostty.app. Скрипт scripts/cell-borders.py рисует галерею стилей и заодно проверяет поддержку, так что подойдёт для проверки чужой реализации. Приложениям предлагается слать запрос возможностей и DA1: нет ответа cell-border, рисовать обычные символы и заранее резервировать для них место. Реализовать минимум терминалу достаточно: перо, команды для прямоугольников и сплошные штрихи, остальное, необязательные расширения.
Можно ли доверять
Это личный проект и черновик: автор сам говорит, что версия 1 не означает «готово и стабильно». Пост и код написаны при большой помощи ИИ, о чём автор сообщает в начале. Сам автор оговаривает, что проверил сборку только на macOS (GTK и OpenGL не тестировались) и пока не делал нормальных замеров производительности. В тексте нет данных о том, что патч принят в основную ветку Ghostty или Rio, что другие терминалы или мультиплексоры поддерживают протокол. Число 1650 строк и оценка памяти 10-15 МБ, слова автора.
Риски и подводные камни
Производительность не измерена; автор особо отмечает, что скруглённые углы рисуются рядами маленьких четырёхугольников и стоят дороже, а изменение строки заставляет перестраивать и соседние. Таблица наборов рамок не освобождается, и в худшем случае занимает порядка 10-15 МБ. Мультиплексоры вроде tmux перерисовывают панели по своей сетке, поэтому без явной поддержки они должны отбрасывать эти последовательности, и приложения внутри них вернутся к символам рамок. Приложениям придётся поддерживать два варианта отрисовки с разной раскладкой: в запасном варианте панели теряют строку и столбец с каждой стороны, а подписи вкладок переезжают внутрь рамки. Рамки не являются текстом, так что в копируемый текст они не попадают, даже когда это было бы нужно, например при вставке таблицы в чат.
«Моя первая попытка была такой: «правее и ниже всегда побеждает», и продержалась она до тех пор, пока у сфокусированной панели сосед не отнял половину контура.»
— Автор поста, сопровождающий Ratatui