49 lines
3.2 KiB
Markdown
49 lines
3.2 KiB
Markdown
# 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](../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) |
|