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

App и Perf модули

src/app.rs — GlintApp

Точка входа Iced-приложения. Держит состояние и реализует update/view.

GlintApp

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

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: замеряет время от создания до разрушения.

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()