vimp-engine 0.24.2 → 0.26.0

package/src/client/main.js

@@ -35,8 +35,13 @@ import { normalizeAuthParams } from './lib/authParams.js';
 import { renderProjectLink } from './lib/footerLink.js';
 import { createGameActivator } from './lib/gameActivator.js';
 import createAutostart from './lib/autostart.js';
+import { applyCatalogState } from './lib/catalogState.js';
 import { getBootConfig, resolveBootConfig } from './boot.js';
-import { ensureGameShell, ensureCanvas } from './views/gameShell.js';
+import {
+  ensureGameShell,
+  ensureCanvas,
+  showBootFailure,
+} from './views/gameShell.js';
 import { createContextTracker } from './lib/contextTracker.js';
 import { createLocalPlayer } from './lib/localPlayer.js';
 import { createAccolades } from './lib/accolades.js';
@@ -73,6 +78,9 @@ import LobbyCtrl from './components/controller/Lobby.js';
 import LobbyAuthModel from './components/model/LobbyAuth.js';
 import LobbyAuthView from './components/view/LobbyAuth.js';
 import LobbyAuthCtrl from './components/controller/LobbyAuth.js';
+import GamesModel from './components/model/Games.js';
+import GamesView from './components/view/Games.js';
+import GamesCtrl from './components/controller/Games.js';
 import BakingProvider from './providers/BakingProvider.js';
 import DependencyProvider from './providers/DependencyProvider.js';
 import { HOT_FLAGS } from '../config/opcodes.js';
@@ -99,6 +107,10 @@ let activeGameManifest;
 let clientPlugin;
 let gamesManifest;
 
+// почему активной игры нет, если каталог непуст: строка отказа лобби вместо
+// общего «игр пока не опубликовано» (см. pickActiveGame)
+let catalogProblem = null;
+
 // узел игрового CSS: при переключении игры его текст заменяется, иначе стили
 // двух игр жили бы в head одновременно и конфликтовали селекторами
 let gameStyleNode = null;
@@ -154,20 +166,40 @@ try {
       throw gamesManifest;
     }
 
-    // недоступная игра активной быть не может (lib/pickActiveGame.js)
-    activeGameManifest = pickActiveGame(gamesManifest, boot.gameId);
+    try {
+      // недоступная игра активной быть не может (lib/pickActiveGame.js)
+      activeGameManifest = pickActiveGame(gamesManifest, boot.gameId);
+    } catch (e) {
+      // «каталог непустой, но играбельного в нём нет» (движок обновили, все
+      // опубликованные игры просят возможность, которой в нём уже нет) — для
+      // лобби это то же самое, что пустой каталог: играть не во что, но
+      // модерация и заявка на месте, и только они это чинят. Терять их из-за
+      // такого нельзя, поэтому причина едет строкой отказа лобби, а не
+      // терминальным оверлеем. В solo/dedicated отказ остаётся отказом
+      if (!isLobbyMode) {
+        throw e;
+      }
+
+      catalogProblem = e.message;
+    }
   }
 
-  if (!activeGameManifest) {
+  // пустой каталог — состояние лобби, а не отказ загрузки: модератор вправе
+  // отключить последнюю игру, реестр вправе ещё ничего не одобрить, и вернуть
+  // каталог к жизни можно только из панели, которая живёт в этой же вкладке.
+  // В solo/dedicated игры нет — это отказ: там весь смысл вкладки в матче
+  if (!activeGameManifest && !isLobbyMode) {
     throw new Error('master has no games in its catalog');
   }
 
-  bindActiveGame(
-    activeGameManifest,
-    boot.clientPlugin ?? (await loadClientPlugin(activeGameManifest)),
-  );
+  if (activeGameManifest) {
+    bindActiveGame(
+      activeGameManifest,
+      boot.clientPlugin ?? (await loadClientPlugin(activeGameManifest)),
+    );
+  }
 } catch (e) {
-  document.body.textContent = `Failed to load the game: ${e.message}`;
+  showBootFailure(`Failed to load the game: ${e.message}`, gameContainer);
   throw e;
 }
 
@@ -1718,8 +1750,7 @@ let hostRegistration = null;
 // Этап 5.1/6.4: скачивает каталог карт мастера активной игры (манифест +
 // все карты)
 async function fetchMasterMaps() {
-  const gameId = activeGameManifest.id;
-  const manifestRes = await fetch(lobbyConfig.maps.manifestUrl(gameId));
+  const manifestRes = await fetch(lobbyConfig.maps.manifestUrl(activeGameManifest));
 
   if (!manifestRes.ok) {
     throw new Error(`maps manifest: HTTP ${manifestRes.status}`);
@@ -1729,7 +1760,7 @@ async function fetchMasterMaps() {
 
   const entries = await Promise.all(
     manifest.maps.map(async name => {
-      const url = `${lobbyConfig.maps.baseUrl(gameId)}/${encodeURIComponent(name)}`;
+      const url = `${lobbyConfig.maps.baseUrl(activeGameManifest)}/${encodeURIComponent(name)}`;
       const res = await fetch(url);
 
       if (!res.ok) {
@@ -1840,8 +1871,16 @@ async function fetchServers({ offset, limit, search }) {
     params.set('limit', limit);
   }
 
+  // токен едет и сюда (master-game-registry, этап 4): список серверов
+  // публичный, но админу мастер отдаёт вместе с ним скрытые тестовые
+  // комнаты застейдженных версий
+  const token = lobbyAuthModel?.getToken();
+
   try {
-    const res = await fetch(`${lobbyConfig.serversUrl}?${params}`);
+    const res = await fetch(
+      `${lobbyConfig.serversUrl}?${params}`,
+      token ? { headers: { authorization: `Bearer ${token}` } } : undefined,
+    );
 
     return res.ok ? await res.json() : null;
   } catch (e) {
@@ -1939,6 +1978,11 @@ function populateRoomForm(manifest) {
   }
 }
 
+// роли, которым лобби показывает кнопку «Moderation» (master-game-registry,
+// этап 4). Это подсказка интерфейсу: доступ к данным проверяет мастер, а
+// запись — auth-сервис, перечитывая роль из БД
+const ADMIN_ROLES = ['admin', 'superadmin'];
+
 // каталог манифестов по id: форма и leaderboard селектора игр, а также
 // активация игры перед созданием комнаты и входом в чужую
 const gamesById = new Map(
@@ -1972,7 +2016,15 @@ function clearLobbyError() {
 // активирует игру и перепривязывает манифест/плагин/CSS; false — отказ уже
 // показан игроку, лобби остаётся рабочим
 async function selectActiveGame(gameId) {
-  if (gameId === activeGameManifest.id) {
+  // сверка идёт с самим манифестом, а не с его id: каталог вкладки может
+  // пополниться застейдженной версией той же игры (registerGameManifest), и
+  // сравнение по id оставило бы активной одобренную версию
+  // activeGameManifest?. — каталог платформы может быть пуст: активной игры
+  // у вкладки тогда нет вовсе, и первая же активация обязана состояться
+  if (
+    gameId === activeGameManifest?.id &&
+    gamesById.get(gameId) === activeGameManifest
+  ) {
     return true;
   }
 
@@ -1993,8 +2045,39 @@ async function selectActiveGame(gameId) {
   }
 }
 
+// очередь активации черновиков (см. подписку на 'staged' в initLobby)
+let stagedActivation = Promise.resolve();
+
+// id игр, чей манифест в каталоге вкладки подменён застейдженной версией
+// (master-game-registry, этап 4): в селекторе такая игра помечается, чтобы
+// админ видел, что поднимет комнату НЕ на одобренной версии
+const stagedGameIds = new Set();
+
+/**
+ * Кладёт манифест застейдженной (не одобренной) версии в каталог вкладки —
+ * так админ может поднять по нему комнату, не трогая каталог игроков.
+ * Дальше всё работает существующим путём: createGameActivator грузит
+ * ClientPlugin по entries.client (ключ кеша версионный, поэтому плагин
+ * черновика не подменит одобренный), connectAsHost поднимает комнату, а
+ * мастер помечает её скрытой по версии манифеста.
+ * @param {Object} manifest - Манифест застейдженной версии из /admin/games.
+ * @returns {void}
+ */
+function registerGameManifest(manifest) {
+  if (!manifest?.id) {
+    return;
+  }
+
+  gamesById.set(manifest.id, manifest);
+  stagedGameIds.add(manifest.id);
+  populateGameSelect();
+}
+
 // заполняет #lobby-game всем каталогом манифестов мастера — раньше туда
-// попадал только gamesManifest[0], теперь селектор рабочий
+// попадал только gamesManifest[0], теперь селектор рабочий.
+// Источник — gamesById, а не gamesManifest: каталог вкладки пополняется на
+// лету застейдженными версиями (registerGameManifest), и селектор
+// перерисовывается целиком
 function populateGameSelect() {
   const gameSelect = document.getElementById(lobbyConfig.elems.gameId);
 
@@ -2002,7 +2085,13 @@ function populateGameSelect() {
     return;
   }
 
-  gamesManifest.forEach(manifest => {
+  // перерисовка не должна сбрасывать выбор игрока: селектор целиком
+  // пересобирается и при добавлении застейдженной версии
+  const selected = gameSelect.value;
+
+  gameSelect.textContent = '';
+
+  gamesById.forEach(manifest => {
     const option = document.createElement('option');
     const available = isGameAvailable(manifest);
 
@@ -2011,14 +2100,36 @@ function populateGameSelect() {
     // каталога, и игрок видел пустое лобби без причины), но выбрать её
     // нельзя: комнату по ней всё равно не поднять
     option.textContent = available
-      ? manifest.title
+      ? `${manifest.title}${stagedGameIds.has(manifest.id) ? lobbyConfig.games.stagedSuffix : ''}`
       : `${manifest.title} — unavailable`;
     option.disabled = !available;
     option.title = available ? '' : manifest.compat.text;
     gameSelect.appendChild(option);
   });
 
-  gameSelect.value = activeGameManifest.id;
+  if (selected && gamesById.has(selected)) {
+    gameSelect.value = selected;
+  } else if (activeGameManifest) {
+    gameSelect.value = activeGameManifest.id;
+  }
+  // без активной игры выбор не трогаем: каталог был пуст, и селектор только
+  // что получил первую строку — она и стоит выбранной по умолчанию.
+  // Присваивание `''` вместо этого сняло бы выбор совсем (selectedIndex = -1)
+}
+
+// форма комнаты, Leaderboard и «Create server» по активной игре; пустой
+// каталог — вторая законная ветка (client/lib/catalogState.js)
+function syncCatalogState() {
+  applyCatalogState(activeGameManifest, {
+    hostBtn: document.getElementById(lobbyConfig.elems.hostBtnId),
+    emptyText: catalogProblem ?? lobbyConfig.create.emptyCatalogText,
+    bindGame: manifest => {
+      populateRoomForm(manifest);
+      lobby.gameChanged(manifest.id, manifest.title);
+    },
+    showError: showLobbyError,
+    clearError: clearLobbyError,
+  });
 }
 
 // поднимает лобби после welcome от мастера (iceServers уже получены);
@@ -2064,7 +2175,15 @@ function initLobby() {
   // хостов старше 6.4 — тогда заходим на активной игре, как раньше: неизвестная
   // версия не повод запретить вход
   lobbyModel.publisher.on('join', async ({ hostId, gameId }) => {
-    if (gameId && gamesById.has(gameId) && !(await selectActiveGame(gameId))) {
+    if (gameId && gamesById.has(gameId)) {
+      if (!(await selectActiveGame(gameId))) {
+        return;
+      }
+    } else if (!activeGameManifest) {
+      // комната пережила свою игру: её сняли с раздачи, пока комната шла, и
+      // каталог вкладки пуст — заходить не на чем
+      showLobbyError('This room runs a game that is no longer published');
+
       return;
     }
 
@@ -2114,10 +2233,53 @@ function initLobby() {
     () => ({ descriptors: roomFormDescriptors, fields: roomFormFields }),
   );
 
+  // реестр игр (master-game-registry, этап 4): заявка разработчика и панель
+  // модерации живут в том же лобби. Триплет поднимается вместе с лобби —
+  // панель доступна любому авторизованному, кнопку модерации показывает роль
+  const gamesModel = new GamesModel(lobbyConfig.games, () => lobbyAuthModel.getToken());
+  const gamesView = new GamesView(gamesModel, lobbyConfig.games);
+  const games = new GamesCtrl(gamesModel, gamesView);
+
+  games.setAdmin(ADMIN_ROLES.includes(lobbyAuthModel.getRole()));
+
+  // «Test»: манифест застейдженной версии кладётся в каталог вкладки, и
+  // админ поднимает по нему комнату обычной кнопкой Create server
+  games.publisher.on('staged', ({ manifest }) => {
+    registerGameManifest(manifest);
+    gamesView.hide();
+
+    // каталог был пуст (первое развёртывание платформы либо снятая с раздачи
+    // последняя игра): черновик — единственная игра вкладки, и создание
+    // комнаты включается только после того, как её плагин привязан
+    if (activeGameManifest) {
+      return;
+    }
+
+    // строго по очереди: loadStaged() восстанавливает все черновики этого
+    // мастера синхронным циклом, и без очереди два черновика при пустом
+    // каталоге ушли бы активироваться одновременно — активной осталась бы
+    // одна игра, а форма комнаты собралась бы по другой
+    stagedActivation = stagedActivation.then(async () => {
+      if (activeGameManifest) {
+        return; // предыдущий черновик уже стал активным
+      }
+
+      // только на успехе: отказ активации уже написал в ту же строку СВОЮ
+      // причину («Failed to load X: …»), и общее «игр пока не опубликовано»
+      // затёрло бы её — админ увидел бы не то, что случилось
+      if (await selectActiveGame(manifest.id)) {
+        syncCatalogState();
+      }
+    }).catch(e => {
+      // отказ не должен заклинить очередь: следующий черновик обязан
+      // получить свой шанс стать активной игрой
+      console.error('[game] staged activation failed:', e);
+    });
+  });
+
   // создание комнаты в этой же вкладке (хост-игрок через loopback)
   populateGameSelect();
-  populateRoomForm(activeGameManifest);
-  lobby.gameChanged(activeGameManifest.id, activeGameManifest.title);
+  syncCatalogState();
 
   // селектор игр: меняет форму создания комнаты и Leaderboard сразу
   // (синхронно, без сети); сама игра активируется уже по клику

package/src/client/style.css

@@ -1053,3 +1053,104 @@ body.hide-cursor {
   color: #f56;
   margin: 8px 0;
 }
+
+/*games*/
+
+/* панель реестра игр (master-game-registry, этап 4): открывается вместо
+   #lobby теми же кнопками бейджа пользователя. Каркас — тот же, что у
+   лобби (.card, .form-row, .lobby-column), собственных цветовых переменных
+   секция не заводит */
+#games-panel {
+  background-color: #222;
+  position: absolute;
+  width: 100%;
+  min-height: 100%;
+  top: 0;
+  left: 0;
+  z-index: 8;
+  display: flex;
+  align-items: flex-start;
+  justify-content: center;
+  box-sizing: border-box;
+}
+
+#games-mine,
+#games-moderation {
+  width: 700px;
+  padding: 10px;
+  text-align: left;
+}
+
+/* заголовок панели и кнопка возврата в одной строке */
+.games-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+
+.games-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.games-item {
+  border-bottom: 1px solid #444;
+  padding: 8px;
+}
+
+.games-item-title {
+  font-weight: bold;
+}
+
+/* поля прямо в карточке заявки: версия и причина отклонения относятся к
+   конкретной строке списка, а не к форме панели */
+.games-version-input,
+.games-note-input {
+  width: 200px;
+  text-align: left;
+  margin-right: 8px;
+}
+
+/* поля заявки — текстовые, а не счётчики: правило .form-row
+   input[type='text'] рассчитано на «max players» room-формы */
+#games-submit-form .form-row input[type='text'] {
+  width: 260px;
+  max-width: 100%;
+  text-align: left;
+}
+
+.games-filters {
+  display: flex;
+  gap: 12px;
+  border-bottom: 1px solid #444;
+  margin-bottom: 12px;
+}
+
+.games-filter-btn {
+  background: none;
+  border: none;
+  color: #888;
+  font-weight: bold;
+  padding: 6px 4px 8px;
+  margin: 0;
+  text-shadow: none;
+}
+
+.games-filter-btn.active {
+  color: #eee;
+}
+
+/* кнопки входа в панель стоят рядом с Sign out в бейдже пользователя */
+.lobby-user-actions {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+}
+
+@media (max-width: 900px) {
+  #games-mine,
+  #games-moderation {
+    width: 100%;
+  }
+}

package/src/client/views/gameShell.js

@@ -135,6 +135,37 @@ export function ensureCanvas(canvasId, size, container = document.body) {
   return canvas;
 }
 
+/**
+ * Терминальный отказ загрузки — поверх страницы, а не вместо неё.
+ *
+ * Раньше здесь стояло `document.body.textContent = …`: разметка страницы
+ * стиралась целиком, вместе с формой входа и панелью реестра игр, — то есть
+ * любая ошибка загрузки игры уносила с собой и путь к её исправлению.
+ * `#tech-informer` для того и есть: полноэкранный слой поверх (z-index 9),
+ * под которым разметка остаётся целой и рабочей после перезагрузки вкладки.
+ *
+ * Слой ТЕРМИНАЛЬНЫЙ и снять его нечем — он кроет и `#lobby-auth`, и
+ * `#games-panel` (обе z-index 8). Поэтому сюда попадает только то, что и
+ * правда терминально: отсутствие каталога само по себе не терминально, и в
+ * lobby-режиме оно идёт строкой отказа лобби (client/lib/catalogState.js).
+ * @param {string} text - Сообщение игроку.
+ * @param {HTMLElement} [container] - Точка монтирования каркаса.
+ * @returns {void}
+ */
+export function showBootFailure(text, container = document.body) {
+  let elem = document.getElementById('tech-informer');
+
+  if (!elem) {
+    // каркаса нет (отказ случился до ensureGameShell): добавляем узел ПЕРЕД
+    // содержимым, а не вместо него
+    elem = createNode({ tag: 'div', id: 'tech-informer' });
+    container.prepend(elem);
+  }
+
+  elem.textContent = text;
+  elem.style.display = 'block';
+}
+
 /**
  * Набор id, которые собирает каркас. Нужен тесту паритета с pug.
  * @returns {Set<string>}

package/src/client/views/includes/games.pug

@@ -0,0 +1,36 @@
+//- Реестр игр в лобби (master-game-registry, этап 4): разработчик подаёт
+//- заявку и следит за её статусом, админ модерирует и играет в черновик.
+//- Панель скрыта по умолчанию — открывается кнопками бейджа пользователя
+//- (#lobby-user в lobby.pug); id элементов перечислены в config/lobby.js.
+//- Подписи — по-английски, как и остальное лобби
+div#games-panel(style='display:none')
+  div.lobby-column
+    div.card#games-mine
+      div.games-head
+        h3.lobby-section-title= 'My games'
+        input#games-close(type='button', value='Back to lobby')
+      ul#games-mine-list.games-list
+      form#games-submit-form
+        div.form-row
+          label.form-label(for='games-field-id')= 'Game id'
+          input#games-field-id.field-text(type='text', name='id', maxlength='32', autocomplete='off')
+        div.form-row
+          label.form-label(for='games-field-package')= 'npm package'
+          input#games-field-package.field-text(type='text', name='packageName', maxlength='214', autocomplete='off')
+        div.form-row
+          label.form-label(for='games-field-version')= 'Version'
+          input#games-field-version.field-text(type='text', name='version', maxlength='64', autocomplete='off')
+        div.form-row
+          label.form-label(for='games-field-repo')= 'Repository URL'
+          input#games-field-repo.field-text(type='text', name='repoUrl', maxlength='256', autocomplete='off')
+        div.form-row
+          label.form-label(for='games-field-title')= 'Title'
+          input#games-field-title.field-text(type='text', name='title', maxlength='64', autocomplete='off')
+        div#games-submit-error.form-error
+        input#games-submit(type='submit', value='Submit for review')
+
+    div.card#games-moderation(style='display:none')
+      h3.lobby-section-title= 'Moderation'
+      div#games-filters.games-filters
+      ul#games-admin-list.games-list
+      div#games-admin-error.form-error

package/src/client/views/includes/lobby.pug

@@ -14,7 +14,13 @@ div#lobby(style='display:none')
           div
             span= 'Signed in as '
             b#lobby-user-nick
-          input#lobby-user-logout(type='button', value='Sign out')
+          //- вход в панель реестра игр (master-game-registry, этап 4):
+          //- «My games» видит любой авторизованный, «Moderation» — только
+          //- админская роль (main.js по LobbyAuthModel.getRole())
+          div.lobby-user-actions
+            input#games-open-mine(type='button', value='My games')
+            input#games-open-moderation(type='button', value='Moderation', style='display:none')
+            input#lobby-user-logout(type='button', value='Sign out')
         hr.lobby-divider
         h3.lobby-section-title= 'HOST A GAME'
         div#lobby-create

package/src/client/views/index.pug

@@ -4,5 +4,6 @@ include includes/chat
 include includes/stat
 include includes/lobbyAuth
 include includes/lobby
+include includes/games
 include includes/auth
 include includes/informer

package/src/config/env.js

@@ -26,10 +26,10 @@ export function applyMasterEnv(config, env = process.env) {
     config.set('master:security:authServiceUrl', env.VIMP_AUTH_SERVICE_URL);
   }
 
-  // список игр-плагинов мастера (Этап A2), по образцу остальных *_MATRIX
-  // env-переопределений — JSON-массив {id, package}
-  if (env.GAMES_MATRIX) {
-    config.set('master:games', JSON.parse(env.GAMES_MATRIX));
+  // корень хранилища игровых пакетов (направление master-game-registry) —
+  // в проде это смонтированный том, переживающий пересоздание контейнера
+  if (env.VIMP_GAMES_DIR) {
+    config.set('master:gameStore:dir', env.VIMP_GAMES_DIR);
   }
 }
 

package/src/config/lobby.js

@@ -11,10 +11,19 @@ export default {
 
   // каталог карт мастера, per-game (Этап 6.4): комната хоста стартует на
   // актуальных картах активной игры, недоступность каталога — fallback на
-  // карты из бандла
+  // карты из бандла.
+  //
+  // Аргумент — МАНИФЕСТ, а не gameId (master-game-registry, этап 3): карты
+  // клиент берёт не из assetsBase, а по отдельному URL, и версионность
+  // каталога обязана доехать и сюда, иначе комната на застейдженной версии
+  // играла бы на картах одобренной. `mapsBase` проставляет мастер при
+  // ребейзе версионного каталога; его отсутствие (dev, standalone,
+  // dedicated, старый мастер) — законный случай, тогда работает прежний
+  // путь по id
   maps: {
-    manifestUrl: gameId => `/games/${gameId}/maps/manifest.json`,
-    baseUrl: gameId => `/games/${gameId}/maps`,
+    manifestUrl: manifest =>
+      `${manifest.mapsBase ?? `/games/${manifest.id}/maps`}/manifest.json`,
+    baseUrl: manifest => manifest.mapsBase ?? `/games/${manifest.id}/maps`,
   },
 
   // манифест конкретной игры (Этап 6.5): эстафета Worker'ов перечитывает его
@@ -184,12 +193,88 @@ export default {
     linkId: 'lobby-link',
   },
 
+  // реестр игр (master-game-registry, этап 4): заявка разработчика и панель
+  // модерации живут в том же лобби, без правки конфигов и рестартов.
+  // Все URL и id элементов — здесь: правило репозитория, модули их не
+  // хардкодят (games.pug)
+  games: {
+    urls: {
+      // заявки вызывающего со статусами и замечаниями модератора
+      mine: '/games/mine',
+      // заявка на новую игру платформы (валидируется мастером до записи)
+      submit: '/games/submit',
+      // заявка на новую версию уже заведённой игры
+      version: id => `/games/mine/${encodeURIComponent(id)}/version`,
+      // очередь модерации целиком плюс локальное состояние на этом мастере
+      admin: '/admin/games',
+      // манифесты застейдженных версий — по ним админ поднимает тестовую
+      // комнату, не трогая каталог игроков
+      staged: '/admin/games/manifest.json',
+      // «Test»: скачать версию и положить её в каталог не раздаваемой
+      stage: id => `/admin/games/${encodeURIComponent(id)}/stage`,
+      // решение модератора
+      moderate: id => `/admin/games/${encodeURIComponent(id)}`,
+      // что опубликовано в npm — индикатор «есть версия новее»
+      versions: id => `/admin/games/${encodeURIComponent(id)}/versions`,
+    },
+
+    // фильтры очереди модерации: id статуса реестра -> подпись кнопки.
+    // Значения обязаны совпадать со статусами auth-сервиса
+    statuses: [
+      { id: 'pending', title: 'Pending' },
+      { id: 'approved', title: 'Published' },
+      { id: 'rejected', title: 'Rejected' },
+      { id: 'disabled', title: 'Disabled' },
+    ],
+    defaultStatus: 'pending',
+
+    // суффикс игры, поднятой из застейдженной версии: в селекторе она
+    // стоит рядом с одобренной, и различать их обязано быть видно
+    stagedSuffix: ' (test)',
+
+    // DOM-элементы панели (из games.pug)
+    elems: {
+      panelId: 'games-panel',
+      // панель и лобби делят место: открытая панель прячет #lobby целиком
+      lobbyId: 'lobby',
+      // кнопки в бейдже пользователя (lobby.pug)
+      openMineBtnId: 'games-open-mine',
+      openModerationBtnId: 'games-open-moderation',
+      closeBtnId: 'games-close',
+
+      // «My games»
+      mineListId: 'games-mine-list',
+      submitFormId: 'games-submit-form',
+      submitErrorId: 'games-submit-error',
+      submitBtnId: 'games-submit',
+      fieldIds: {
+        id: 'games-field-id',
+        packageName: 'games-field-package',
+        version: 'games-field-version',
+        repoUrl: 'games-field-repo',
+        title: 'games-field-title',
+      },
+
+      // модерация
+      moderationId: 'games-moderation',
+      adminListId: 'games-admin-list',
+      adminErrorId: 'games-admin-error',
+      filtersId: 'games-filters',
+    },
+  },
+
   // создание комнаты (хост в этой же вкладке); лимит игроков/время
   // раунда-карты/огонь по своим/карта по умолчанию — из roomDefaults
   // манифеста активной игры (Этап 6.3), не бандлятся здесь
   create: {
     defaultName: 'My Server',
 
+    // каталог платформы пуст: реестр ещё ничего не одобрил либо модератор
+    // снял с раздачи последнюю игру. Комнату создавать не на чем, но лобби
+    // живо — и текст называет то единственное, что выводит его из этого
+    // состояния
+    emptyCatalogText: 'No games are published yet — see “My games”',
+
     // период heartbeat/актуализации комнаты у мастера (мс); должен быть
     // меньше master.host.heartbeatTimeout (30 c), иначе комнату выметет
     heartbeatInterval: 10000,