Imported from ZhukovskyGamesStudio/takeRoot (.claude/skills/takeroot-ui-mvp/SKILL.md). Install upstream with npx skills add ZhukovskyGamesStudio/takeRoot --skill takeroot-ui-mvp. Copyright stays with the author.

Take Root — UI (uGUI + MVP)

Сначала takeroot-project-context. Стек — uGUI + TextMeshPro только; UI Toolkit в геймплее нет. ⚠️ UIElementsSchema в корне репо — это редакторные XSD, игнорируй.

MVP везде

• View = пассивный MonoBehaviour: [SerializeField]-виджеты + методы SetData/Init (тупой рендер).
• Presenter = plain-C# класс, создаётся в CoreEntryPoint.InitPresenters() (точка регистрации), держит сервисы через ServiceLocator.Single<T>(), подписывается на реактивное состояние, часто IUpdatable + IDisposable.

Рецепт: добавить панель

1. Добавь значение в enum PanelType.
2. В сцене: GameObject панели → CoreCanvasUi.PanelsView.Panels; Toggle → PanelTogglesView.Toggles; соответствующую запись ToggleData (требования по Research/Race).
3. Создай View (SetData/Init) + plain-C# Presenter.
4. Сошлись на View из CoreCanvasUi или CoreEntryPoint.
5. Создай Presenter в CoreEntryPoint.InitPresenters, прокинув Single<IService>()-зависимости.
6. Расово-вариативный визуал — через IHasRaceVariant, не ветвлением по расе.

Конвенции

• Открытие/закрытие: SerializedDictionary<enum, Toggle/GameObject> + Toggle.onValueChanged + GameObject.SetActive.
• Панели взаимоисключающи: открытие панели снимает выделение, выделение закрывает панели.
• Видимость toggle гейтится ToggleData (ResearchRequirement/RaceRequirement) через UpdatePanels.

Реактивщина

• UniRx ReactiveProperty для выделения / pending-команды / готовности времени / ingame-времени.
• Plain Action-события для сигналов (OnResearchFinished, NewNotification, OnJobChanged).
• Пер-кадровый рефреш — IUpdatable+IUpdateService или Update/FixedUpdate во View. ⚠️ Следи за пер-кадровым LINQ/аллокациями (горячая точка — TimeStatusUI colony stress).

Сетевой сплит UI

• Клиент-локальные: панели, выделение, инфо, камера, нотификации, оверлеи, ingame-часы.
• Сетевые:
  • Скорость/пауза — GameSpeedView → ServerRpc → NetworkDataHolder.SetGameSpeedClientRpc, выставляет глобальный Time.timeScale (побеждает минимум из двух игроков; пауза гейтится заряженной TimeMachine).
  • Исследования — NetworkDataHolder.ResearchNetworkData.
• ⚠️ NetworkDataHolder.Instance должен быть заспавнен до вызовов времени/исследований (иначе NRE). См. takeroot-netcode.

Время

Time.timeScale — единственные синхронизируемые часы (глобально через ClientRpc). ⚠️ UI, который должен работать на паузе, нужен на unscaledDeltaTime (по большей части не сделано). IngameTimeService — по-клиентный (не сетевой), масштабируется с timeScale.

Выделение → инфо

• ISelectionService.SelectedReactive — единый источник истины.
• SelectionServicePresenter type-switch'ит SettlerSelectable vs CommandTargetSelectable. ⚠️ Безусловный каст к InfoDataCombined может бросить.
• SettlerInfoPanel свапает render-слой + портрет-камеру.
• Выделение выключено, пока висит pending JobType-команда.

Известные опасные места

⚠️ требует проверки у Гоши.

• ⚠️ Dispose() презентеров часто пуст/не вызывается → подписки живут весь lifetime сцены, утекают при перезагрузке.
• ⚠️ Смешан legacy Input и новый Input System (камера); EventSystem.current разыменовывается без null-чека.
• OverlayService — заглушка (см. takeroot-grid-pathfinding).
• CoreCanvasUi.OpenInfoPanel — [Obsolete] (используй SelectionServicePresenter).
• Строки RU/EN захардкожены, локализации нет.
• Кнопки меню провязаны через инспектор onClick — открой префаб, чтобы найти вызовы. MenuEntryPoint.Play — host-only.