docs: reorganize into en/ru and add English translation

docs/ru/modules/07-app-perf.md

@@ -0,0 +1,109 @@
+# App и Perf модули
+
+## `src/app.rs` — GlintApp
+
+Точка входа Iced-приложения. Держит состояние и реализует `update`/`view`.
+
+### `GlintApp`
+
+```rust
+pub struct GlintApp {
+    pub doc:        Document<'static>,
+    pub vdom_roots: Vec<Element<'static>>,
+    pub rhei:       RheiContext,
+}
+```
+
+- `doc` — оригинальный Document (стили, переменные, tracker)
+- `vdom_roots` — результат последнего evaluate_vdom (_incr)
+- `rhei` — Rhai-движок с кэшированными AST
+
+### `update(&mut self, message: Message) -> iced::Task<Message>`
+
+Обработка сообщений от Iced:
+
+| Message | Действие |
+|---------|----------|
+| `WindowScrolled(y)` | Установить `__scroll_y`, вызвать `on_variable_changed` |
+| `ScrollableScrolled(id, y)` | Установить `__scroll_{id}`, вызвать `on_variable_changed` |
+| `EventTriggered(script)` | `execute_action()`, затем diff переменных для поиска изменившихся |
+| `InputChanged(var, val)` | Установить переменную, вызвать `on_variable_changed` |
+| `ToggleChanged(var, val)` | Установить `Bool`, вызвать `on_variable_changed` |
+| `SliderChanged(var, val)` | Установить `Float`, вызвать `on_variable_changed` |
+
+После обработки сообщения:
+1. `tracker.take_dirty_set()` — получить dirty элементы
+2. `evaluate_vdom_incr()` — пересчитать VDOM
+3. Сохранить в `self.vdom_roots`
+
+**Perf:** VDOM фаза замеряется `PerfScope::new("vdom")`.
+
+### `view(&self) -> iced::Element`
+
+Построить Iced-виджеты из `self.vdom_roots`:
+
+1. Собрать scroll_positions из `__scroll_*` переменных
+2. Для каждого root: `render_element()` → push в column
+3. Наложить global fixed/absolute/sticky слои
+4. Вернуть `container(layout).into()`
+
+**Perf:** Render фаза замеряется `PerfScope::new("render")`.
+В конце `perf::print_frame()` — вывод в stderr.
+
+---
+
+## `src/perf.rs` — Performance Monitoring
+
+Система замера времени по фазам (VDOM, Style, Render). Включение: флаг `--perf`.
+
+### `PerfReport`
+
+```rust
+pub struct PerfReport {
+    pub vdom_eval: f64,  // ms
+    pub style: f64,      // ms
+    pub render: f64,     // ms
+    pub total: f64,      // ms
+}
+```
+
+Хранится в `thread_local!` `RefCell<PerfReport>`.
+
+### `PerfScope`
+
+Drop-guard: замеряет время от создания до разрушения.
+
+```rust
+pub struct PerfScope {
+    name: &'static str,
+    start: Instant,
+}
+```
+
+При `drop()`: добавляет elapsed ms к соответствующему полю `PerfReport`.
+Имена: `"vdom"`, `"style"`, `"render"`.
+
+### Функции
+
+| Функция | Описание |
+|---------|----------|
+| `set_enabled(bool)` | Включить/выключить замеры |
+| `is_enabled() -> bool` | Проверить состояние |
+| `report_and_reset() -> Option<String>` | Собрать отчёт, проверить >16ms threshold |
+| `reset()` | Обнулить PerfReport |
+| `print_frame()` | Вызвать report_and_reset + сброс, напечатать в stderr |
+
+### Пример вывода
+
+```
+[perf] VDOM: 6.63ms | Style: 0.26ms | Render: 7.19ms | Total: 14.08ms
+[perf] VDOM: 13.26ms | Style: 0.52ms | Render: 7.18ms | Total: 20.95ms ⚠️ Frame budget exceeded! 20.95ms > 16ms
+```
+
+### Точки инструментирования
+
+| Файл | Фаза | Место |
+|------|------|-------|
+| `app.rs:update` | vdom | Вокруг `evaluate_vdom_incr()` |
+| `app.rs:view` | render | Вся функция `view()` |
+| `style.rs:compute_cached` | style | Внутри `StyleSheet::compute_cached()` |