toolbar

DOCS.md

@@ -325,6 +325,39 @@ end
 > `--config` меняет только каталог `init.lua`, поэтому `root = "."` указывает
 > на текущий каталог запуска — проект должен быть текущим рабочим каталогом.
 
+## Верхняя панель редактора
+
+Полоса между вкладками и редактором. У панели две области: элементы левой
+выстраиваются от левого края вправо, элементы правой — от правого края влево.
+
+| Метод | Описание |
+| --- | --- |
+| `app.toolbar:add_label(text, icon, background, id, side)` | Добавить лейбл |
+| `app.toolbar:add_button(text, icon, background, id, side, fn)` | Добавить кнопку |
+| `app.toolbar:hide(id)` | Скрыть элемент; `false`, если элемента с таким `id` нет |
+| `app.toolbar:show(id)` | Снова показать скрытый элемент |
+| `app.toolbar:clear()` | Удалить все элементы панели |
+
+- `icon` — имя иконки Lucide (`play`, `settings`, `file`, ...) или `nil`.
+- `background` — `#RGB`, `#RGBA`, `#RRGGBB`, `#RRGGBBAA` или `nil` (прозрачный
+  фон). Цвет текста подбирается автоматически: тёмный на светлом фоне, светлый
+  на тёмном.
+- `id` — идентификатор элемента для `hide` и `show`. Повторное добавление с тем
+  же `id` заменяет элемент, а не создаёт дубликат.
+- `side` — `"left"` или `"right"`.
+- `fn` — обработчик нажатия; вызывается без аргументов.
+
+```lua
+app.toolbar:add_label("Готово", nil, nil, "status", "left")
+app.toolbar:add_label("UTF-8", nil, "#3f3f46", "encoding", "right")
+app.toolbar:add_button("Запустить", "play", nil, "run", "right", function()
+  print("Запуск")
+end)
+
+app.toolbar:hide("run")
+app.toolbar:show("run")
+```
+
 ## Панели окна
 
 По умолчанию панели закрыты, размер меняется перетаскиванием.