vimp-engine 0.25.0 → 0.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vimp-engine",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "VIMP — движок-приложение (мастер, P2P-транспорт, Worker-хост, мета, MVC-каркас клиента)",
   "license": "MIT",
   "repository": {

package/src/client/components/controller/Games.js

@@ -25,14 +25,17 @@ export default class GamesCtrl {
 
     vp.on('open-mine', 'openMine', this);
     vp.on('open-moderation', 'openModeration', this);
+    vp.on('lookup', 'lookup', this);
     vp.on('submit', 'submit', this);
     vp.on('update-version', 'updateVersion', this);
+    vp.on('delete', 'remove', this);
     vp.on('filter', 'filter', this);
     vp.on('stage', 'stage', this);
     vp.on('approve', 'approve', this);
     vp.on('reject', 'reject', this);
     vp.on('disable', 'disable', this);
     vp.on('load-versions', 'loadVersions', this);
+    vp.on('set-author', 'setAuthor', this);
 
     model.publisher.on('staged', 'staged', this);
   }
@@ -55,12 +58,17 @@ export default class GamesCtrl {
     this._model.loadMine();
   }
 
+  // «Moderation» — отдельная страница панели: карточка «My games» в этом
+  // режиме не видна, и запрос за её данными был бы холостым
   openModeration() {
     this._view.show(true);
-    this._model.loadMine();
     this._model.loadAdmin();
   }
 
+  lookup({ packageName, version }) {
+    this._model.lookup(packageName, version);
+  }
+
   submit(form) {
     this._model.submit(form);
   }
@@ -69,6 +77,10 @@ export default class GamesCtrl {
     this._model.requestVersion(id, version);
   }
 
+  remove({ id, scope }) {
+    this._model.remove(id, scope);
+  }
+
   filter(status) {
     this._model.setFilter(status);
   }
@@ -93,6 +105,10 @@ export default class GamesCtrl {
     this._model.loadVersions(id);
   }
 
+  setAuthor({ id, nick }) {
+    this._model.setAuthor(id, nick);
+  }
+
   staged(data) {
     this.publisher.emit('staged', data);
   }

package/src/client/components/model/Games.js

@@ -99,6 +99,28 @@ export default class GamesModel {
     this._emitAdmin();
   }
 
+  // разбор пакета для формы заявки: мастер качает тарболл, читает манифест
+  // и отдаёт то, что раньше человек вводил руками. Отдельный запрос, а не
+  // часть submit: предпросмотр обязан быть виден ДО отправки заявки
+  async lookup(packageName, version) {
+    const query = new URLSearchParams({ package: packageName });
+
+    if (version) {
+      query.set('version', version);
+    }
+
+    const { ok, json } = await this._request(
+      `${this._config.urls.lookup}?${query}`,
+    );
+
+    if (!ok) {
+      this._fail('mine', json);
+      return;
+    }
+
+    this.publisher.emit('looked-up', json);
+  }
+
   async submit(form) {
     const { ok, json } = await this._request(this._config.urls.submit, {
       method: 'POST',
@@ -133,6 +155,26 @@ export default class GamesModel {
     await this.loadMine();
   }
 
+  // удаление игры. scope решает, чей список перечитать: карточка автора и
+  // очередь модерации показывают разные проекции одной строки
+  async remove(id, scope = 'mine') {
+    const { ok, json } = await this._request(this._config.urls.remove(id), {
+      method: 'DELETE',
+    });
+
+    if (!ok) {
+      this._fail(scope, json);
+      return;
+    }
+
+    if (scope === 'admin') {
+      await this.loadAdmin();
+      return;
+    }
+
+    await this.loadMine();
+  }
+
   // «Test»: мастер качает версию и кладёт её в каталог не раздаваемой.
   // Манифест едет наружу — по нему вкладка админа поднимает комнату
   async stage(id, version) {
@@ -162,6 +204,18 @@ export default class GamesModel {
     }
 
     await this.loadAdmin();
+
+    // после loadAdmin, а не до: renderAdmin чистит строку отказа панели, и
+    // предупреждение, показанное раньше, стёрлось бы тем же тиком
+    if (json?.warning) {
+      this.publisher.emit('warning', { scope: 'admin', code: json.warning });
+    }
+  }
+
+  // переназначение автора — тот же PATCH, что и решение модератора: наружу
+  // едет ник, пустой означает «снять автора»
+  async setAuthor(id, nick) {
+    await this.moderate(id, { authorNick: nick === '' ? null : nick });
   }
 
   _emitAdmin() {

package/src/client/components/view/Games.js

@@ -19,6 +19,8 @@ const ERROR_MESSAGES = {
   gameExists: 'A game with this id already exists',
   tooManyGames: 'Too many submissions from one author',
   unknownGame: 'Game is not in the registry',
+  gamePublished: 'Published game — ask an admin to disable it first',
+  unknownUser: 'No player with this nick',
   invalidGameId: 'Invalid game id',
   invalidPackageName: 'Invalid npm package name',
   invalidVersion: 'Invalid version',
@@ -28,6 +30,13 @@ const ERROR_MESSAGES = {
   authServiceUnavailable: 'Registry service unavailable',
 };
 
+// предупреждения: решение принято, отказа не было, но состояние платформы
+// стоит назвать вслух
+const WARNING_MESSAGES = {
+  catalogEmpty:
+    'No published games left — the lobby cannot create rooms until one is published',
+};
+
 const STATUS_TITLES = {
   pending: 'in review',
   approved: 'published',
@@ -64,6 +73,19 @@ export default class GamesView {
     this._mineList = document.getElementById(elems.mineListId);
     this._submitForm = document.getElementById(elems.submitFormId);
     this._submitError = document.getElementById(elems.submitErrorId);
+    this._submitBtn = document.getElementById(elems.submitBtnId);
+    this._lookupBtn = document.getElementById(elems.lookupBtnId);
+    this._preview = document.getElementById(elems.previewId);
+    this._versionList = document.getElementById(elems.versionListId);
+
+    this._mine = document.getElementById(elems.mineId);
+    this._title = document.getElementById(elems.titleId);
+    this._switch = document.getElementById(elems.switchBtnId);
+    // текущая страница панели: от неё зависит, куда уводит переключатель
+    this._isModeration = false;
+    // последний разобранный `${packageName}@${version}` — защита от парного
+    // разбора одного и того же пакета, см. _emitLookup
+    this._lastLookup = null;
 
     this._moderation = document.getElementById(elems.moderationId);
     this._adminList = document.getElementById(elems.adminListId);
@@ -71,10 +93,20 @@ export default class GamesView {
     this._filters = document.getElementById(elems.filtersId);
 
     this._fields = new Map(
-      Object.entries(elems.fieldIds).map(([name, id]) => [
-        name,
-        document.getElementById(id),
-      ]),
+      Object.entries(elems.fieldIds).map(([name, id]) => {
+        const field = document.getElementById(id);
+
+        // карта строится по конфигу, а используется из обработчиков событий:
+        // разъехавшийся с games.pug id дал бы здесь null, а упал бы позже —
+        // безымянным TypeError внутри clearForm или _readForm. Остальная
+        // разметка панели проверяется тем же способом, только неявно: первое
+        // же обращение к отсутствующему элементу бросает в конструкторе
+        if (!field) {
+          throw new Error(`GamesView: no element "#${id}" for field "${name}"`);
+        }
+
+        return [name, field];
+      }),
     );
 
     this.publisher = new Publisher();
@@ -82,32 +114,59 @@ export default class GamesView {
     this._openMine.onclick = () => this.publisher.emit('open-mine');
     this._openModeration.onclick = () => this.publisher.emit('open-moderation');
     this._close.onclick = () => this.hide();
+    // переключатель страниц панели: без него выход из «Moderation» в
+    // «My games» шёл бы только через лобби
+    this._switch.onclick = () =>
+      this.publisher.emit(this._isModeration ? 'open-mine' : 'open-moderation');
 
     this._submitForm.onsubmit = e => {
       e.preventDefault();
       this.publisher.emit('submit', this._readForm());
     };
 
+    const packageField = this._fields.get('packageName');
+
+    // разбор пакета по кнопке И по уходу из поля: заполнять форму
+    // предпросмотром — обычный путь, а не отдельное действие
+    this._lookupBtn.onclick = () => this._emitLookup();
+    packageField.onblur = () => this._emitLookup();
+    // правка пакета обесценивает показанный предпросмотр: заявка ушла бы с
+    // разобранным ранее пакетом, а человек читал бы карточку другого
+    packageField.oninput = () => this.clearPreview();
+
+    this.clearPreview();
+
     this._renderFilters();
 
     const mp = model.publisher;
 
     mp.on('submitted', 'clearForm', this);
+    mp.on('looked-up', 'renderPreview', this);
     mp.on('mine-changed', 'renderMine', this);
     mp.on('admin-changed', 'renderAdmin', this);
     mp.on('error', 'renderError', this);
+    mp.on('warning', 'renderWarning', this);
   }
 
   // кнопку модерации показывает не сама панель, а роль вызывающего
   // (main.js по LobbyAuthModel.getRole())
   setAdmin(isAdmin) {
     this._openModeration.style.display = isAdmin ? '' : 'none';
+    this._switch.style.display = isAdmin ? '' : 'none';
   }
 
+  // Панель — две страницы, а не одна: «My games» и «Moderation»
+  // показываются по одной. Общая шапка (заголовок, переключатель и
+  // «Back to lobby») живёт над карточками и переживает переключение
   show(moderation = false) {
+    this._isModeration = moderation;
     this._panel.style.display = 'flex';
     this._lobby.style.display = 'none';
+    this._mine.style.display = moderation ? 'none' : 'block';
     this._moderation.style.display = moderation ? 'block' : 'none';
+    this._title.textContent = moderation ? 'Moderation' : 'My games';
+    // подпись переключателя называет ту страницу, куда он уводит
+    this._switch.value = moderation ? 'My games' : 'Moderation';
   }
 
   hide() {
@@ -127,6 +186,68 @@ export default class GamesView {
     this._fields.forEach(field => {
       field.value = '';
     });
+    this.clearPreview();
+  }
+
+  // предпросмотра нет — отправлять нечего: мастер всё равно откажет, а
+  // человек не увидит, за какую игру он ручается
+  clearPreview() {
+    this._preview.textContent = '';
+    this._versionList.textContent = '';
+    this._submitBtn.disabled = true;
+    // предпросмотра нет — значит, и запрета на повторный разбор быть не
+    // должно: правка поля обесценивает прошлый вердикт
+    this._lastLookup = null;
+  }
+
+  /**
+   * Карточка разобранного пакета: то, что раньше человек вводил руками.
+   * @param {Object} data - Ответ мастера на /games/lookup.
+   */
+  renderPreview({ id, title, version, versions, repoUrl, engineApi, errors }) {
+    this._preview.textContent = '';
+    this._submitError.textContent = '';
+
+    this._preview.appendChild(
+      this._line(`${title ? `${title} · ` : ''}${id ?? '—'}`, 'games-item-title'),
+    );
+    this._preview.appendChild(this._line(`Version: ${version ?? '—'}`));
+    this._preview.appendChild(this._line(`Engine API: ${engineApi ?? '—'}`));
+    this._appendRepo(this._preview, repoUrl);
+
+    // список опубликованных версий — подсказка поля, а не отдельный контрол
+    this._versionList.textContent = '';
+    (versions || []).forEach(value => {
+      const option = document.createElement('option');
+
+      option.value = value;
+      this._versionList.appendChild(option);
+    });
+
+    // резолвнутая мастером версия: 'latest' в поле осталась бы ссылкой,
+    // которая завтра означает другой пакет
+    if (version) {
+      this._fields.get('version').value = version;
+    }
+
+    // разрешённая версия в поле меняет `${packageName}@${version}`, и
+    // следующий blur прошёл бы как «другой пакет»: запрет повтора обновляется
+    // фактическим ответом мастера
+    this._lastLookup = `${this._fields.get('packageName').value.trim()}@${
+      this._fields.get('version').value.trim()
+    }`;
+
+    const problems = errors || [];
+
+    if (problems.length) {
+      renderFormErrors(
+        this._submitError,
+        problems.map(error => ({ name: 'package', label: 'package', error })),
+      );
+    }
+
+    // заявка на заведомо нерабочий пакет реестру не нужна
+    this._submitBtn.disabled = problems.length > 0 || !id;
   }
 
   renderMine(games) {
@@ -166,6 +287,11 @@ export default class GamesView {
 
       item.appendChild(version);
       item.appendChild(send);
+      item.appendChild(
+        this._deleteButton(() =>
+          this.publisher.emit('delete', { id: game.id, scope: 'mine' }),
+        ),
+      );
       this._mineList.appendChild(item);
     });
   }
@@ -180,6 +306,12 @@ export default class GamesView {
     });
   }
 
+  renderWarning({ scope, code }) {
+    const container = scope === 'admin' ? this._adminError : this._submitError;
+
+    container.textContent = WARNING_MESSAGES[code] ?? code;
+  }
+
   renderError({ scope, errors }) {
     const container = scope === 'admin' ? this._adminError : this._submitError;
 
@@ -208,6 +340,23 @@ export default class GamesView {
     // у игр, засеянных миграцией, автора нет вовсе: без запасного прочерка
     // в строке печаталось бы литеральное "null"
     item.appendChild(this._line(`Author: ${game.authorNick ?? game.authorUserId ?? '—'}`));
+
+    // переназначение автора: игры платформы засеяны без него, и «My games»
+    // у их автора пуст, пока админ не проставит ник здесь. Пустое поле —
+    // снять автора
+    const author = document.createElement('input');
+
+    author.type = 'text';
+    author.className = 'field-text games-author-input';
+    author.placeholder = 'Author nick';
+    author.value = game.authorNick ?? '';
+
+    item.appendChild(author);
+    item.appendChild(
+      this._button('Set author', () =>
+        this.publisher.emit('set-author', { id: game.id, nick: author.value.trim() }),
+      ),
+    );
     this._appendRepo(item, game.repoUrl);
     item.appendChild(
       this._line(
@@ -258,6 +407,9 @@ export default class GamesView {
         this.publisher.emit('load-versions', { id: game.id }),
       ),
     );
+    item.appendChild(
+      this._deleteButton(() => this.publisher.emit('delete', { id: game.id, scope: 'admin' })),
+    );
 
     return item;
   }
@@ -307,6 +459,27 @@ export default class GamesView {
     });
   }
 
+  // Удаление необратимо и уносит рейтинги игры, поэтому кнопка требует
+  // второго нажатия: первое переводит её в «Confirm delete», второе публикует
+  // событие. Повторная отрисовка списка возвращает её в исходное состояние —
+  // незавершённое подтверждение не переживает перерисовку
+  _deleteButton(onConfirm) {
+    const btn = this._button('Delete', () => {
+      if (btn.dataset.armed !== '1') {
+        btn.dataset.armed = '1';
+        btn.value = 'Confirm delete';
+        btn.classList.add('games-delete-armed');
+        return;
+      }
+
+      onConfirm();
+    });
+
+    btn.className = 'games-delete-btn';
+
+    return btn;
+  }
+
   _button(value, onclick) {
     const btn = document.createElement('input');
 
@@ -329,6 +502,22 @@ export default class GamesView {
     return line;
   }
 
+  // Один и тот же пакет не разбирается дважды: blur поля и клик по «Load»
+  // приходят парой (mousedown → blur → click), а каждый разбор стоит мастеру
+  // скачанного тарболла и единицы общего лимитера заявок (5/мин на человека)
+  _emitLookup() {
+    const packageName = this._fields.get('packageName').value.trim();
+    const version = this._fields.get('version').value.trim();
+    const ref = `${packageName}@${version}`;
+
+    if (!packageName || ref === this._lastLookup) {
+      return;
+    }
+
+    this._lastLookup = ref;
+    this.publisher.emit('lookup', { packageName, version });
+  }
+
   _readForm() {
     const form = {};
 

package/src/client/lib/catalogState.js

@@ -0,0 +1,44 @@
+// Каталог игр платформы может быть ПУСТ, и это законное состояние лобби, а не
+// отказ загрузки: игры живут в реестре auth-сервиса, модератор вправе снять с
+// раздачи последнюю, а на первом развёртывании не одобрена ещё ни одна.
+//
+// Лобби в этом состоянии обязано жить целиком: вход, бейдж пользователя, «My
+// games» и «Moderation» от игры не зависят — и только через них каталог
+// возвращается к жизни. Раньше пустой каталог бросал из бутстрапа и стирал
+// разметку страницы: модератор, отключивший последнюю игру, запирал сам себя
+// и вернуть её мог только запросом мимо интерфейса.
+//
+// Вынесено из main.js (бутстрап, в happy-dom не поднимается) отдельным
+// модулем, чтобы обе ветки проверялись юнит-тестом.
+
+/**
+ * Приводит лобби в соответствие с активной игрой.
+ * @param {Object} [manifest] - Манифест активной игры; `undefined` — каталог
+ *   платформы пуст.
+ * @param {Object} deps - Проводка лобби.
+ * @param {HTMLElement} [deps.hostBtn] - Кнопка «Create server».
+ * @param {string} deps.emptyText - Строка отказа для пустого каталога.
+ * @param {Function} deps.bindGame - Форма комнаты и Leaderboard активной игры.
+ * @param {Function} deps.showError - Показать строку отказа лобби.
+ * @param {Function} deps.clearError - Снять строку отказа лобби.
+ * @returns {void}
+ */
+export function applyCatalogState(
+  manifest,
+  { hostBtn, emptyText, bindGame, showError, clearError },
+) {
+  if (manifest) {
+    bindGame(manifest);
+    clearError();
+  } else {
+    // форму комнаты и Leaderboard не трогаем вовсе: без игры у первой нет
+    // схемы полей, а второй — игры, за рейтингом которой идти
+    showError(emptyText);
+  }
+
+  if (hostBtn) {
+    hostBtn.disabled = !manifest;
+  }
+}
+
+export default applyCatalogState;

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';
@@ -102,6 +107,10 @@ let activeGameManifest;
 let clientPlugin;
 let gamesManifest;
 
+// почему активной игры нет, если каталог непуст: строка отказа лобби вместо
+// общего «игр пока не опубликовано» (см. pickActiveGame)
+let catalogProblem = null;
+
 // узел игрового CSS: при переключении игры его текст заменяется, иначе стили
 // двух игр жили бы в head одновременно и конфликтовали селекторами
 let gameStyleNode = null;
@@ -157,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;
 }
 
@@ -1949,11 +1978,6 @@ function populateRoomForm(manifest) {
   }
 }
 
-// роли, которым лобби показывает кнопку «Moderation» (master-game-registry,
-// этап 4). Это подсказка интерфейсу: доступ к данным проверяет мастер, а
-// запись — auth-сервис, перечитывая роль из БД
-const ADMIN_ROLES = ['admin', 'superadmin'];
-
 // каталог манифестов по id: форма и leaderboard селектора игр, а также
 // активация игры перед созданием комнаты и входом в чужую
 const gamesById = new Map(
@@ -1990,7 +2014,12 @@ async function selectActiveGame(gameId) {
   // сверка идёт с самим манифестом, а не с его id: каталог вкладки может
   // пополниться застейдженной версией той же игры (registerGameManifest), и
   // сравнение по id оставило бы активной одобренную версию
-  if (gameId === activeGameManifest.id && gamesById.get(gameId) === activeGameManifest) {
+  // activeGameManifest?. — каталог платформы может быть пуст: активной игры
+  // у вкладки тогда нет вовсе, и первая же активация обязана состояться
+  if (
+    gameId === activeGameManifest?.id &&
+    gamesById.get(gameId) === activeGameManifest
+  ) {
     return true;
   }
 
@@ -2011,6 +2040,9 @@ async function selectActiveGame(gameId) {
   }
 }
 
+// очередь активации черновиков (см. подписку на 'staged' в initLobby)
+let stagedActivation = Promise.resolve();
+
 // id игр, чей манифест в каталоге вкладки подменён застейдженной версией
 // (master-game-registry, этап 4): в селекторе такая игра помечается, чтобы
 // админ видел, что поднимет комнату НЕ на одобренной версии
@@ -2070,8 +2102,29 @@ function populateGameSelect() {
     gameSelect.appendChild(option);
   });
 
-  gameSelect.value =
-    selected && gamesById.has(selected) ? selected : 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 уже получены);
@@ -2117,7 +2170,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;
     }
 
@@ -2174,19 +2235,49 @@ function initLobby() {
   const gamesView = new GamesView(gamesModel, lobbyConfig.games);
   const games = new GamesCtrl(gamesModel, gamesView);
 
-  games.setAdmin(ADMIN_ROLES.includes(lobbyAuthModel.getRole()));
+  // кнопку «Moderation» лобби показывает роли admin (master-game-registry,
+  // этап 4). Это подсказка интерфейсу: доступ к данным проверяет мастер, а
+  // запись — auth-сервис, перечитывая роль из БД
+  games.setAdmin(lobbyAuthModel.getRole() === 'admin');
 
   // «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

@@ -1081,11 +1081,17 @@ body.hide-cursor {
   text-align: left;
 }
 
-/* заголовок панели и кнопка возврата в одной строке */
+/* заголовок панели, переключатель страниц и кнопка возврата в одной
+   строке; шапка лежит НАД карточками, поэтому ширину и поля повторяет
+   за ними — иначе flex-end колонки увёл бы её вправо от карточки */
 .games-head {
   display: flex;
   align-items: center;
   justify-content: space-between;
+  gap: 8px;
+  width: 700px;
+  padding: 0 10px;
+  box-sizing: border-box;
 }
 
 .games-list {
@@ -1141,6 +1147,18 @@ body.hide-cursor {
   color: #eee;
 }
 
+/* удаление необратимо: взведённое подтверждение обязано отличаться от
+   первого нажатия не только подписью */
+.games-delete-btn {
+  color: #d66;
+}
+
+.games-delete-armed {
+  background: #802020;
+  border-color: #d66;
+  color: #fee;
+}
+
 /* кнопки входа в панель стоят рядом с Sign out в бейдже пользователя */
 .lobby-user-actions {
   display: flex;
@@ -1150,7 +1168,8 @@ body.hide-cursor {
 
 @media (max-width: 900px) {
   #games-mine,
-  #games-moderation {
+  #games-moderation,
+  .games-head {
     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

@@ -5,32 +5,32 @@
 //- Подписи — по-английски, как и остальное лобби
 div#games-panel(style='display:none')
   div.lobby-column
+    //- Шапка панели, а не карточки: карточки «My games» и «Moderation»
+    //- показываются по одной (панель — это две разные страницы), и
+    //- кнопка выхода в лобби обязана пережить переключение между ними
+    div.games-head
+      h3#games-title.lobby-section-title= 'My games'
+      input#games-switch(type='button', value='Moderation', style='display:none')
+      input#games-close(type='button', value='Back to lobby')
+
     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
+      //- Заявка спрашивает только пакет и версию: id, title и репозиторий
+      //- мастер читает из самого пакета и показывает предпросмотром
       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')
+          input#games-lookup(type='button', value='Load')
         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')
+          input#games-field-version.field-text(type='text', name='version', maxlength='64', autocomplete='off', placeholder='latest', list='games-version-list')
+          datalist#games-version-list
+        div#games-preview.games-preview
         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/config/env.js

@@ -26,12 +26,6 @@ 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) {

package/src/config/lobby.js

@@ -201,10 +201,16 @@ export default {
     urls: {
       // заявки вызывающего со статусами и замечаниями модератора
       mine: '/games/mine',
+      // разбор npm-пакета для формы заявки: id, title, версии и репозиторий
+      // мастер читает сам — человек вводит только пакет и версию
+      lookup: '/games/lookup',
       // заявка на новую игру платформы (валидируется мастером до записи)
       submit: '/games/submit',
       // заявка на новую версию уже заведённой игры
       version: id => `/games/mine/${encodeURIComponent(id)}/version`,
+      // удаление игры: и «My games» (автор), и «Moderation» (админ) ходят
+      // одним URL — право решает auth
+      remove: id => `/games/mine/${encodeURIComponent(id)}`,
       // очередь модерации целиком плюс локальное состояние на этом мастере
       admin: '/admin/games',
       // манифесты застейдженных версий — по ним админ поднимает тестовую
@@ -247,13 +253,21 @@ export default {
       submitFormId: 'games-submit-form',
       submitErrorId: 'games-submit-error',
       submitBtnId: 'games-submit',
+      // форма спрашивает ровно две вещи; id, title и репозиторий приезжают
+      // предпросмотром из разобранного пакета
       fieldIds: {
-        id: 'games-field-id',
         packageName: 'games-field-package',
         version: 'games-field-version',
-        repoUrl: 'games-field-repo',
-        title: 'games-field-title',
       },
+      lookupBtnId: 'games-lookup',
+      previewId: 'games-preview',
+      versionListId: 'games-version-list',
+
+      // карточки панели показываются по одной; заголовок общий, как и
+      // переключатель страниц (виден только админу)
+      mineId: 'games-mine',
+      titleId: 'games-title',
+      switchBtnId: 'games-switch',
 
       // модерация
       moderationId: 'games-moderation',
@@ -269,6 +283,12 @@ export default {
   create: {
     defaultName: 'My Server',
 
+    // каталог платформы пуст: реестр ещё ничего не одобрил либо модератор
+    // снял с раздачи последнюю игру. Комнату создавать не на чем, но лобби
+    // живо — и текст называет то единственное, что выводит его из этого
+    // состояния
+    emptyCatalogText: 'No games are published yet — see “My games”',
+
     // период heartbeat/актуализации комнаты у мастера (мс); должен быть
     // меньше master.host.heartbeatTimeout (30 c), иначе комнату выметет
     heartbeatInterval: 10000,

package/src/config/master.js

@@ -23,11 +23,11 @@ export default {
   // auth-сервиса, откуда мастер скачивает одобренные пакеты сам
   // (master/GameSync.js). Движок игр не знает и зависимостями их не тянет.
   //
-  // Массив и переменная окружения GAMES_MATRIX (JSON) остаются
-  // переопределением для двух случаев: локальная разработка (каталог вдобавок
-  // дополняется собранными пакетами @vimp-games/* из node_modules,
-  // master/localGames.js — прилинкованная игра важнее реестра) и self-hosted
-  // мастер без реестра. `package` — имя npm-пакета игры, резолвится через
+  // Массив остаётся двум потребителям, и env-переопределения у него нет:
+  // локальной разработке (каталог наполняют собранные пакеты @vimp-games/*
+  // из node_modules, master/localGames.js — прилинкованная игра важнее
+  // реестра) и dedicated-серверу, который берёт отсюда игру, названную
+  // VIMP_DEDICATED_GAME. `package` — имя npm-пакета игры, резолвится через
   // node_modules; версию задаёт сама установленная зависимость.
   // maxGameScore (snakes-v3 этап 3.3, необязательное поле рядом с
   // id/package) — потолок результата ОДНОЙ игры для этой игры; мастер

package/src/devtools/pluginLoader.js

@@ -54,12 +54,14 @@ export async function loadGameForSim({ game = null, core = null } = {}) {
 }
 
 // путь --game указывает либо на пакет игры, либо прямо на манифест; сама
-// загрузка общая с dedicated-сервером (lib/loadGamePackage.js)
+// загрузка общая с dedicated-сервером (lib/loadGamePackage.js).
+// client: true — прогону виртуальные клиенты обязательны, и отказ на
+// загрузке пакета лучше отказа посреди сценария
 async function loadFromManifest(game, core) {
   const target = game.endsWith('.json')
     ? path.resolve(game)
     : path.resolve(game, 'dist');
-  const pkg = await loadGamePackage(target, { core });
+  const pkg = await loadGamePackage(target, { core, client: true });
 
   return { ...pkg, source: pkg.manifestPath };
 }

package/src/lib/loadGamePackage.js

@@ -21,10 +21,17 @@ import { ENGINE_CAPABILITIES } from './capabilities.js';
  * @param {Object} [options]
  * @param {string} [options.core] - Путь к node-сборке ядра, перекрывающий
  *   entries.wasmNode манифеста.
- * @returns {Promise<Object>} { id, manifest, hostPlugin, clientPlugin, wasmUrl,
- *   distDir, manifestPath }.
+ * @param {(boolean|'lazy')} [options.client] - Когда грузить клиентскую
+ *   половину: 'lazy' (умолчание) — только по вызову loadClientPlugin(),
+ *   true — сразу вместе с host-половиной.
+ * @returns {Promise<Object>} { id, manifest, hostPlugin, clientPlugin,
+ *   loadClientPlugin, wasmUrl, distDir, manifestPath }. В ленивом режиме
+ *   clientPlugin равен null, а половину отдаёт loadClientPlugin().
  */
-export async function loadGamePackage(distDir, { core = null } = {}) {
+export async function loadGamePackage(
+  distDir,
+  { core = null, client = 'lazy' } = {},
+) {
   // манифест под нестандартным именем нужен headless-прогону (--game
   // <path>/manifest-variant.json); dedicated-сервер всегда даёт каталог
   const manifestPath = distDir.endsWith('.json')
@@ -47,18 +54,53 @@ export async function loadGamePackage(distDir, { core = null } = {}) {
     baseDir,
     manifest.entries.host,
     assetsBase,
-  );
-  const clientPlugin = await importDefault(
-    baseDir,
-    manifest.entries.client,
-    assetsBase,
+    manifestPath,
   );
 
+  // Клиентская половина в Node нужна только виртуальным клиентам
+  // headless-прогона; dedicated-сервер её не касается вовсе (в браузер она
+  // едет статикой, и pixi.js там резолвится import map'ом). Грузить её
+  // безусловно значило бы требовать от игры самодостаточной клиентской
+  // сборки — а правило контракта A1 держит pixi.js внешним намеренно.
+  //
+  // Размен ленивого режима: расхождение engineApi между манифестом и
+  // клиентской сборкой в Node-контуре ничего не ломает — клиента собирает
+  // браузер, совместимость манифеста уже проверена checkPluginCompatibility
+  // выше, а структуру пакета проверяет checkGamePackage на стороне
+  // GameStore.
+  const clientPlugin =
+    client === true
+      ? await importDefault(
+          baseDir,
+          manifest.entries.client,
+          assetsBase,
+          manifestPath,
+        )
+      : null;
+
   assertPluginMatchesManifest(manifest, {
     host: hostPlugin,
-    client: clientPlugin,
+    ...(clientPlugin ? { client: clientPlugin } : {}),
   });
 
+  // одна форма результата при любом режиме: потребитель зовёт
+  // loadClientPlugin() и не разбирается, была ли половина уже импортирована
+  let clientLoad = clientPlugin ? Promise.resolve(clientPlugin) : null;
+  const loadClientPlugin = () => {
+    clientLoad ??= importDefault(
+      baseDir,
+      manifest.entries.client,
+      assetsBase,
+      manifestPath,
+    ).then(plugin => {
+      assertPluginMatchesManifest(manifest, { client: plugin });
+
+      return plugin;
+    });
+
+    return clientLoad;
+  };
+
   const nodeCore = core ?? manifest.entries.wasmNode ?? null;
 
   if (!nodeCore) {
@@ -88,6 +130,7 @@ export async function loadGamePackage(distDir, { core = null } = {}) {
     manifest,
     hostPlugin,
     clientPlugin,
+    loadClientPlugin,
     wasmUrl: pathToFileURL(corePath).href,
     distDir: baseDir,
     manifestPath,
@@ -195,10 +238,34 @@ function resolveNames(names) {
   );
 }
 
-function importDefault(baseDir, entry, assetsBase) {
+// Половина плагина, загружаемая в Node, обязана быть самодостаточной:
+// node_modules резолвятся вверх по дереву от файла, а пакет игры лежит там,
+// куда его положил реестр (VIMP_GAMES_DIR), — вне node_modules движка.
+// Сырой ERR_MODULE_NOT_FOUND называет только ненайденный пакет и молчит о
+// том, чья половина и какого пакета игры его просит
+function importDefault(baseDir, entry, assetsBase, manifestPath) {
   const file = path.resolve(baseDir, stripBase(entry, assetsBase));
 
-  return import(pathToFileURL(file).href).then(module => module.default);
+  return import(pathToFileURL(file).href).then(
+    module => module.default,
+    err => {
+      if (err?.code !== 'ERR_MODULE_NOT_FOUND') {
+        throw err;
+      }
+
+      // имя ненайденного пакета — из текста ошибки; не нашлось — не
+      // подставляем
+      const missing = /Cannot find package '([^']+)'/.exec(err.message)?.[1];
+
+      throw new Error(
+        `${manifestPath}: entry '${entry}'` +
+          `${missing ? ` imports '${missing}', which` : ''} cannot be ` +
+          'resolved by Node — a plugin half loaded in Node must be ' +
+          'self-contained; external dependencies (pixi.js) are allowed only ' +
+          'in the client half and only in the browser',
+      );
+    },
+  );
 }
 
 // entries.host/client — URL-ы, какими их видит браузер (`assetsBase` + путь