Glint-Runtime/docs/ru/README.md

Glint Runtime — документация

(да, пока-что написанное нейросетью. Её объяснений достаточно)

Бэкенд для исполнения скомпилированного байткода (.glbc) Glint UI-фреймворка. Загружает байткод, интерпретирует VDOM, применяет CSS-подобные стили, выполняет Rhai-скрипты и рендерит результат через Iced (native GPU-ускоренный GUI).

Структура проекта

• src/main.rs — точка входа, CLI парсинг
• src/lib.rs — публичное API crate'а
• src/app.rs — GlintApp: Iced-приложение, update/view
• src/cli.rs — CLI команды compile/run
• src/renderer.rs — Iced-виджеты: преобразование Element → iced::Element
• src/perf.rs — PerfScope: замер производительности по фазам
• src/interpreter/mod.rs — Interpreter: загрузка bytecode, VDOM eval
• src/interpreter/types.rs — Element, VNode, FlatVDom, Value, InternedStr, Document
• src/interpreter/style.rs — StyleSheet, StyleRule, StyleIndex, StyleCache, ComputedStyle
• src/interpreter/reactive.rs — ReactiveTracker: граф зависимостей
• src/interpreter/rhei.rs — RheiContext: интеграция Rhai скриптов
• src/interpreter/reader.rs — Reader: чтение .glbc bytecode
• src/interpreter/opcodes.rs — OP_* константы байткода

Связанные репозитории

• glt (компилятор .gltm/.glts → .glbc)

Ключевые концепции

• Document — загруженный .glbc файл: дерево Element'ов, таблица стилей, переменные
• Element — узел VDOM: type_name, properties, children, computed_style, element_id, content_hash
• VDOM — виртуальное дерево, результат интерпретации байткода
• StyleSheet — таблица стилей с индексированным поиском и кэшем computed style
• ReactiveTracker — отслеживает зависимости element → variable, dirty_set
• RheiContext — компилирует и выполняет Rhai-скрипты, кэширует AST
• ComputedStyle — результат применения CSS-правил: ~40 полей (color, padding, font-size, etc.)

Фазы оптимизации

См. ARCHITECTURE-IMPROVEMENT-PLAN.md.

Реализовано: фазы 3–8, 10, 9.1–9.2 (content_hash, стабильные Iced widget ID).

Осталось:

Фаза	Описание	Оценка ускорения
0	Профилирование (bench, flamegraph)	—
1	Типизированные Value в стилях вместо HashMap<String, String>	2–3×
2	String interning для горячих путей	1.5–2×
9.3	Кэш Iced-виджетов по content_hash	1.5–2× (render)