@vnejs/docs 0.2.60 → 0.2.62

package/CHANGELOG.md

@@ -2,8 +2,30 @@
 
 Краткая история изменений движка (плагины, helpers, packages, CLI и прочий runtime) и внешнего API. Версии — релизы пакета `@vnejs/docs`.
 
+## 0.2.62
+
+- `module.components` — при `isForce` `onUpdateStoreComponent` ждёт `ViewStoreApi.notifyIsForce(true)` и затем пишет `isForce: false`. Фиксированный `waitTimeout(100)` снят. API: `ViewStoreApi.notifyIsForce`, `ViewIsForceNotify`.
+- `uis/react/hooks/use-store-state` — подписка через `useSyncExternalStore`. После коммита стейта с `isForce` зовёт `store.notifyIsForce(true)`. Это единственный сигнал, который отпускает ожидание в `onUpdateStoreComponent`.
+- `uis/react/hooks/use-is-force-hook` — таймаут сброса `isRealForce` снимается, если `isForce` снова стал `true`.
+- `views/fps`, `views/gamepad.debug`, `views/achievement` — в `View` уходит `isForce` из стора. Задержку кадра делает сам `View`.
+- `views.scenario/interface` — `isForce` доходит до `SmoothText` в `InterfaceViewDialog`, `InterfaceViewLine` и `InterfaceViewWall`. Иначе форс-кадр оставляет посимвольный переход.
+- `uis/react/composites/smooth-text` — смена `tokens` рисуется без `opacity`-перехода. Дальнейший рост `tokensVisibleForce` анимируется и когда за кадр появляется несколько символов. `tokensVisibleForce` применяется до отрисовки.
+
+## 0.2.61
+
+- `views.scenario/interface` — подписки `INTERFACE.SHOW` и `INTERFACE.HIDE` в модуле `interface.actions.show`. На `GATE` они обрывают остальных подписчиков, если интерфейс уже показан или уже скрыт, либо show/hide уже выполняется. Показ скрытого слоя шлёт `EVENTS.INTERFACE.VISIBLE`. API: `InterfaceShow.onShowGate`, `InterfaceShow.onHideGate`, `InterfaceShow.isInShowOrHideProcess`, `InterfaceShow.setShow`, `CONST.COMPONENTS.LIFECYCLE_PRIORITY.SHOW.GATE`, `CONST.COMPONENTS.LIFECYCLE_PRIORITY.HIDE.GATE`.
+- `views/controls.hints` — show/hide группы по `showEvents` / `hideEvents` сохраняют `isForce` исходного события: `isForce: true` обновляет view через `UPDATE_FORCE`, иначе через `UPDATE_FAST`. API: `ControlsHintsController.onGroupShow`, `ControlsHintsController.onGroupHide`, `ControlsHintsController.updateGroupStateAndView`.
+- `backends/auth`, `backends/content` — локальный запуск: `npm run dev` (`npm start` то же самое), auth `127.0.0.1:8787`, content `127.0.0.1:8788`. Секрет из `.env`; пустой `AUTH_SECRET` → `500`, не ошибка WebCrypto.
+- `backends/auth` — `GET /` показывает статус входа и кнопку на `/steam/start`. Origin самого воркера для этой страницы допускается вместе с `ALLOWED_ORIGINS`.
+- `backends/auth` — `isOwnedByUser` (ранее `isPurchasedByUser`): `ownsApp` в JWT без требования `permanent` в ответе CheckAppOwnership; по-прежнему отсекаются `sitelicense` и чужой `ownersteamid`.
+- `backends/auth` — env `APP_DEMO_ID` (по умолчанию `5081630`); CheckAppOwnership для демо, в JWT и на тестовой странице `GET /` — `ownsDemoApp` отдельно от `ownsApp`.
+- `backends/auth` — тестовая страница и `/session`: имя (`GetPlayerSummaries`), локальное время окончания JWT (`expiresAt`, формат `DD.MM hh:mm:ss`), кнопка «Обновить сессию» (`GET /session`).
+- `backends/shared` — `TOKEN_TTL_SECONDS`: JWT живёт 3 суток.
+- `backends/auth`, `backends/content` — HTTP на Fastify; локально `npm run dev` (`node --env-file=.env` + `tsx`, порты 8787/8788). Опционально `npm run dev:worker` (Wrangler + Fastify через `inject`).
+
 ## 0.2.60
 
+- `backends/auth`, `backends/content` — воркеры токена Steam и выдачи `dist/label`. Контент отдаётся только с JWT, в котором `ownsApp` true.
 - `views.screens/history` — закрытие крестиком сверху справа, клик шлёт `EVENTS.HISTORY_VIEW.HIDE`. Текстовая кнопка внизу снята. Список реплик высотой 1800 по вертикали по центру экрана. API: `PARAMS.HISTORY_VIEW.VIEW_PROPS.close` теперь `{ position, svg }`.
 - `module.controller.arrows.vertical`, `module.controller.arrows.horizontal`, `module.controller.arrows.grid` — на `HIDE.CLEANUP` позиция пункта в стейте становится `undefined` через `UPDATE_STATE`, затем `UPDATE_FAST` перерисовывает view. API: `currentArrowVerticalItem`, `currentArrowHorizontalItem`, `gridRow`, `gridColumn`, `CONST.COMPONENTS.LIFECYCLE_PRIORITY.HIDE.CLEANUP`.
 

package/README.md

@@ -45,6 +45,7 @@ npm i @vnejs/docs
 | [`uis/`](./architecture.md#uis)                               | React-компоненты для view-плагинов       |
 | [`cli/`](./architecture.md#cli)                               | Сборка монорепы и игр                    |
 | [`games/`](./architecture.md#games)                           | Проекты игр: сценарий, entry, dist       |
+| [`backends/`](./architecture.md#backends)                     | Workers: токен Steam и JSON меток        |
 | [`vs_code_extensions/`](./architecture.md#vs_code_extensions) | Подсветка `.vne` в редакторе             |
 
 `games/` подключает один `bundles/` и получает `VneCore` — точку входа в движок.

package/architecture.md

@@ -40,6 +40,7 @@ flowchart LR
 flowchart TD
   G[games/] --> B[bundles/]
   G --> CLI[cli/]
+  G -.->|HTTP| BE[backends/]
   B --> P[plugins/]
   B --> C[compatibility/]
   P --> CT[contracts/]
@@ -60,6 +61,7 @@ flowchart TD
 | От               | К                                   | Смысл                                                    |
 | ---------------- | ----------------------------------- | -------------------------------------------------------- |
 | `games/`         | `bundles/`, `cli/`                  | Игра не знает про отдельные плагины; сборка через `cli/` |
+| `games/`         | `backends/`                         | HTTP к воркерам токена и меток, без импорта пакетов      |
 | `bundles/`       | `plugins/`, `compatibility/`        | Только импорт нужного набора                             |
 | `plugins/`       | `contracts/`                        | Реализация следует объявленному API                      |
 | `plugins/`       | `modules_extensions/` → `packages/` | Модули наследуют базы, базы опираются на shared/observer |
@@ -460,6 +462,27 @@ flowchart LR
 
 ---
 
+## backends/
+
+**Отдельные Cloudflare Workers** — не плагины и не часть `VneCore`. Игра ходит к ним по HTTP. Пакеты в `plugins/` их не импортируют.
+
+| Пакет                  | Назначение                                                                                                                     |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| **`backends/auth`**    | Steam OpenID и проверка покупки своего AppID. Отдаёт подписанный JWT (`steamId`, `ownsApp`, `exp`).                            |
+| **`backends/content`** | `GET /label/*` — JSON меток из `dist/label`. Пускает только запрос с тем же JWT и `ownsApp`. Картинки и `mods.json` не отдаёт. |
+
+Оба воркера знают один `AUTH_SECRET`. Контент-воркер Steam не вызывает. Каталог ассетов при деплое указывает на `dist` игры, сами JSON в репозиторий воркера не копируются. Закрытый деплой не кладёт то же дерево `label/` рядом со статикой игры.
+
+```mermaid
+flowchart LR
+  Game[games/] -->|popup OpenID| Auth[backends/auth]
+  Auth --> Steam[steamcommunity.com]
+  Game -->|GET /label Bearer| Content[backends/content]
+  Auth -.->|общий AUTH_SECRET| Content
+```
+
+---
+
 ## vs_code_extensions/
 
 **Расширения редактора** для формата сценария — не runtime.
@@ -524,19 +547,20 @@ flowchart TD
 
 ## Резюме
 
-| Каталог                   | Одной фразой                |
-| ------------------------- | --------------------------- |
-| **`packages/`**           | Реестр, шина, VneCore       |
-| **`modules_extensions/`** | Базовые классы модулей      |
-| **`configs/`**            | Общие tsconfig              |
-| **`contracts/`**          | API плагина: события, типы  |
-| **`plugins/`**            | Реализация на шине          |
-| **`compatibility/`**      | Opt-in связка двух плагинов |
-| **`bundles/`**            | Набор способностей для игры |
-| **`helpers/`**            | Утилиты без движка          |
-| **`uis/`**                | React/UI для view           |
-| **`cli/`**                | Сборка монорепы и игр       |
-| **`games/`**              | Сценарий + entry + dist     |
-| **`vs_code_extensions/`** | Подсветка `.vne`            |
+| Каталог                   | Одной фразой                      |
+| ------------------------- | --------------------------------- |
+| **`packages/`**           | Реестр, шина, VneCore             |
+| **`modules_extensions/`** | Базовые классы модулей            |
+| **`configs/`**            | Общие tsconfig                    |
+| **`contracts/`**          | API плагина: события, типы        |
+| **`plugins/`**            | Реализация на шине                |
+| **`compatibility/`**      | Opt-in связка двух плагинов       |
+| **`bundles/`**            | Набор способностей для игры       |
+| **`helpers/`**            | Утилиты без движка                |
+| **`uis/`**                | React/UI для view                 |
+| **`cli/`**                | Сборка монорепы и игр             |
+| **`games/`**              | Сценарий + entry + dist           |
+| **`backends/`**           | Workers: токен Steam и JSON меток |
+| **`vs_code_extensions/`** | Подсветка `.vne`                  |
 
 **Главное правило:** `plugins/` не знают друг о друге; интеграция — через события по `contracts/` и явный `compatibility/` в `bundles/`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vnejs/docs",
-  "version": "0.2.60",
+  "version": "0.2.62",
   "description": "VNEJS documentation for engine consumers and coding agents",
   "files": [
     "*.md",

package/plugins/views/controls.hints.md

@@ -33,7 +33,7 @@ Payloads и результаты хендлеров типизированы ч
 
 Для экрана обычно задают `position.zIndex = PARAMS.<SCREEN>.ZINDEX + 100`, чтобы другие экраны могли перекрыть подсказки.
 
-Появление/скрытие группы анимируется через `View` с `transition={PARAMS.TRANSITION}` (по умолчанию `300` ms). Группа видима, если `isShow` и есть контролы для текущего device (с учётом `hideOnDevices`). При уходе в пустой список (например keyboard) предыдущие иконки держатся до конца transition, чтобы fade-out успел отрисоваться.
+Появление и скрытие группы по `showEvents` / `hideEvents` обновляет view через `UPDATE_FAST`. Если у исходного события `isForce: true`, обновление идёт через `UPDATE_FORCE`. Обычный `UPDATE` с ожиданием `TRANSITION` на этих событиях не вызывается. Сам `View` по-прежнему анимируется с `transition={PARAMS.TRANSITION}` (по умолчанию `300` ms), кроме `isForce`. Группа видима, если `isShow` и есть контролы для текущего device (с учётом `hideOnDevices`). При уходе в пустой список (например keyboard) предыдущие иконки держатся до конца transition, чтобы fade-out успел отрисоваться.
 
 Элемент `controls[]`: `{ locKey, keyboard: string[], xbox: string[], playstation: string[], hideOnDevices?: ControlsDevice[] }` — пути внутри `media/view/{quality}/` (ведущий `/` снимается). `hideOnDevices` — девайсы, на которых контрол не рендерится (`CONTROLS.DEVICES.*`).
 
@@ -43,10 +43,10 @@ Payloads и результаты хендлеров типизированы ч
 
 ## Модули
 
-| Модуль                      | Зона ответственности                                                                                                                                           |
-| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `controls.hints.controller` | Preload иконок в `start` и на `MEMORY.CLEARED`; show/hide групп; `DEVICE_CHANGED`. `EXTERNAL_UPDATE` всегда вызывает `updateViewFast` (без проверки `isShow`). |
-| `controls.hints.view`       | Рендер нескольких `View` + `Flex` + `Icon` + `Text`.                                                                                                           |
+| Модуль                      | Зона ответственности                                                                                                                                                                                                                    |
+| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `controls.hints.controller` | Preload иконок в `start` и на `MEMORY.CLEARED`; show/hide групп сохраняют `isForce` исходного события (`UPDATE_FORCE` или `UPDATE_FAST`); `DEVICE_CHANGED`. `EXTERNAL_UPDATE` всегда вызывает `updateViewFast` (без проверки `isShow`). |
+| `controls.hints.view`       | Рендер нескольких `View` + `Flex` + `Icon` + `Text`.                                                                                                                                                                                    |
 
 ## Близкие плагины
 

package/plugins/views.scenario/interface.md

@@ -54,14 +54,15 @@ Payloads и результаты хендлеров типизированы ч
 
 ## Модули
 
-| Модуль                        | Зона ответственности                                                                                                                                                                                        |
-| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `interface.controller`        | Обрабатывает VIEW_UPDATE, VIEW_SHOW, VIEW_HIDE, …. Пустой `controls` на `ZINDEX`; `CONTROLS_UNVISIBLE` при скрытии слоя. `SHOULD_CLEAR_STATE_ON_CLEANUP` — `false`, поэтому текст и задник переживают hide. |
-| `interface.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `INTERFACE.INTERACT`; видимый слой → `INTERACT.EMIT`, скрытый → `INTERFACE.VISIBLE`; PUSH/POP на VIEW_SHOW/HIDE.                       |
-| `interface`                   | STATE.SET / STATE.CLEAR → STATE_CHANGED.                                                                                                                                                                    |
-| `interface.scenario`          | `$ interface`: `LINE_EXEC_REG` → SHOW / HIDE / VIEW по `CONST.INTERFACE.EXEC_ACTIONS`.                                                                                                                      |
-| `interface.actions`           | SHOW / HIDE / VISIBLE / TEXT_HIDE / VIEW через `globalState.interface`.                                                                                                                                     |
-| `interface.view`              | Подмодуль `view` плагина.                                                                                                                                                                                   |
+| Модуль                        | Зона ответственности                                                                                                                                                                                             |
+| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `interface.controller`        | Обрабатывает VIEW_UPDATE, VIEW_SHOW, VIEW_HIDE, …. Пустой `controls` на `ZINDEX`; `CONTROLS_UNVISIBLE` при скрытии слоя. `SHOULD_CLEAR_STATE_ON_CLEANUP` — `false`, поэтому текст и задник переживают hide.      |
+| `interface.controller.accept` | Наследует `@vnejs/module.controller.accept`: `ACCEPT` / `INTERACT` → `INTERFACE.INTERACT`; видимый слой → `INTERACT.EMIT`, скрытый → `INTERFACE.VISIBLE`; PUSH/POP на VIEW_SHOW/HIDE.                            |
+| `interface`                   | STATE.SET / STATE.CLEAR → STATE_CHANGED.                                                                                                                                                                         |
+| `interface.scenario`          | `$ interface`: `LINE_EXEC_REG` → SHOW / HIDE / VIEW по `CONST.INTERFACE.EXEC_ACTIONS`.                                                                                                                           |
+| `interface.actions`           | VISIBLE / TEXT_HIDE / VIEW через `globalState.interface`.                                                                                                                                                        |
+| `interface.actions.show`      | Подписки `SHOW` и `HIDE`. На `GATE` (`breakFollowing`): если интерфейс уже в целевом состоянии или цикл show/hide уже идёт, остальные подписчики этих событий не вызываются. Показ скрытого слоя шлёт `VISIBLE`. |
+| `interface.view`              | `isForce` доходит до `SmoothText` в `InterfaceViewDialog`, `InterfaceViewLine` и `InterfaceViewWall`.                                                                                                            |
 
 ## Compatibility