feat: Ren'Py screens (screen/call screen/show screen) with actions and styles

Converter
- screens.py parses the screen language: containers (fixed, frame, vbox, hbox,
  grid, vpgrid, viewport, button, has), widgets (text, textbutton, imagebutton,
  add, bar ...), if/for/use/transclude, default, python, key, timer, on, inline ATL,
  conditional properties, and decompiled forms (unparenthesised operators,
  glued property values, comma separated actions)
- style statements, call/show/hide screen operators and Python-level
  renpy.show_screen are translated; only screens the game shows are audited,
  unused stock screens no longer block an import; undefined screens do
- ATL values may be computed at run time and transforms take parameters
  (at blink(0.2, 0.3)); blur property

Player
- screens.ts builds the DOM from the IR and rebuilds it on state changes;
  buttons with idle/hover/selected/insensitive states, tooltips, sounds, modal
  screens, timers and keys that survive re-rendering, saved with the save file
- Actions: Jump, Call, Return, SetVariable, Toggle*, SetScreenVariable, Show, Hide,
  ToggleScreen, Function, Play, Notify, If, Language, ShowMenu, OpenURL ...
- Crop/LiveCrop/Solid/Frame/Transform/DynamicDisplayable values, crop property,
  globals(), renpy.variant/change_language/seen_image, transition stubs

Tests: screen parser and runtime (linkedom DOM), screens fixture compiled from
tests/fixtures/screens.rpy. Docs: docs/SCREENS.md.

Twisted-Thoughts now passes the strict compatibility check.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
mrleo1nidandClaude Sonnet 5.5 committed 2026-10-25 13:17:11 +03:00
1 parent 47fc121e7d
commit 62ece25902
24 files changed
+2997 -60

No files matched your search

+50
View File
@@ -0,0 +1,50 @@
# Экраны Ren'Py (screen)
Игры показывают свой интерфейс (HUD, карты-хотспоты, телефон, инвентарь) экранами
`screen`. Конвертер переводит их в IR, плеер строит из IR DOM и пересчитывает его при
каждом изменении состояния. Выражения выполняются в той же песочнице Python, что и сценарий.
* разбор: `backend/app/converter/screens.py` (язык экранов), `rpy_parser.py` (`screen`, `style`,
`call/show/hide screen`), `atl.py` (анимации виджетов);
* плеер: `frontend/src/player/screens.ts`, подключение — в `engine.ts`.
## Что поддерживается
* **Операторы сценария:** `call screen name(args)` (ждёт `Return`, значение в `_return`),
`show screen`, `hide screen`; из Python — `renpy.show_screen`, `renpy.hide_screen`.
* **Контейнеры:** `fixed`, `frame`, `window`, `vbox`, `hbox`, `grid`, `vpgrid`, `viewport`
(прокрутка), `button`, `has`.
* **Элементы:** `text`, `label`, `textbutton`, `imagebutton` (`idle`/`hover`/`insensitive`/`auto`),
`add`, `null`, `bar`/`vbar` (отображение и перетаскивание для `VariableValue`).
* **Управление:** `if`/`elif`/`else`, `showif`, `for`, `use` (в том числе с `transclude`),
`default`, `$` и `python:`, `key`, `timer`, `on "show"`/`"hide"`.
* **Свойства:** размеры, позиции и якоря, отступы, `spacing`, `background`/`foreground`, `crop`,
цвета и шрифты текста, `outlines`, `alpha`, `zoom`, `rotate`, `blur`, `selected`, `sensitive`,
`tooltip` (`GetTooltip()`), `hover_sound`/`activate_sound`, `at` с анимированными transform,
условные свойства (`if` внутри виджета, который только задаёт свойства).
* **Стили:** `style name is parent:` и `style_prefix`; состояния `idle_`/`hover_`/`selected_`/
`insensitive_`. Неизвестные декоративные свойства стилей молча отбрасываются.
* **Действия:** `Jump`, `Call`, `Return`, `SetVariable`, `ToggleVariable`, `SetScreenVariable`,
`ToggleScreenVariable`, `SetDict`, `SetField`, `ToggleField`, `Show`, `Hide`, `ToggleScreen`,
`Function`, `Play`, `Stop`, `Notify`, `If`, `SelectedIf`, `SensitiveIf`, `NullAction`, `Language`,
`ShowMenu` (открывает меню плеера), `OpenURL` (только http/https), `Quit`, `MainMenu`.
* **Изображения-значения:** `Crop`, `LiveCrop`, `Solid`, `Frame`, `Null`, `Transform`,
`DynamicDisplayable`, `Color`.
Стандартные экраны движка (`say`, `choice`, `input`, главное меню, настройки, сохранения, история)
плеер не использует: у него свой интерфейс. `ShowMenu("preferences")` открывает его меню.
## Правила импорта
Экран проверяется только если игра его показывает (`call/show screen`, `Show("name")`,
`renpy.show_screen("name")`, `use name`). Неподдерживаемое внутри такого экрана останавливает
импорт, внутри неиспользуемого (например, стандартного) — нет. Экран, который вызывают, но нигде
не определили, тоже останавливает импорт. Экраны для `variant "touch"`/`"phone"` отбрасываются.
## Ограничения
* Не поддерживаются `input`, `imagemap`/`hotspot`, `mousearea`, `drag`/`draggroup`, `side`,
`matrixcolor`, шейдеры и `im.*`; такие экраны блокируют импорт.
* Экран перестраивается целиком; положение прокрутки сохраняется, фокус и ввод — нет.
* Позиции без точки (`xpos 1`) читаются как доля, а целые больше 1 — как пиксели.
* Фокус с клавиатуры — только Tab и Enter/Space на кнопках.