input

DOCS.md

@@ -284,6 +284,31 @@ tree:map_key("v", "<A-f>", function() print("tree v") end)
 | `app:minimize()` | Свернуть окно |
 | `app:is_maximized()` | Развёрнуто ли окно прямо сейчас |
 
+### Плавающее поле ввода
+
+`app:open_input(options)` открывает однострочное поле ввода чуть выше
+центра окна. Параметры передаются таблицей:
+
+| Поле | Описание |
+| --- | --- |
+| `title` | Текст над полем; если не задан, окно состоит из одной строки ввода |
+| `placeholder` | Подсказка внутри пустого поля ввода |
+| `callback` | `function(text)` — вызывается после Enter, когда окно уже закрыто |
+
+Пока окно открыто, сочетания клавиш приложения не работают. Текст набирается
+в поле; `Enter` подтверждает ввод и запускает `callback`, `Esc` и клик мышью
+вне окна закрывают его без вызова колбэка.
+
+```lua
+app:open_input({
+  title = "Имя файла",
+  placeholder = "src/main.rs",
+  callback = function(text)
+    app.editor:open(text, {})
+  end,
+})
+```
+
 ## LSP-серверы
 
 Запуск серверов целиком настраивается Lua-сценарием.