vimp-engine 0.40.0 → 0.41.0

package/src/host/meta/modules/Vote.js

@@ -56,6 +56,43 @@ class Vote {
     this._userList[gameId].push(arr);
   }
 
+  // добавляет личное сообщение меню/подсказки (`menu`, `menuClose`,
+  // `menuHint`). Ещё не отправленные сообщения того же вида и имени
+  // вытесняются: очередь не растёт от частых обновлений, порядок
+  // «закрыть → открыть» сохраняется. Списки `teams`/`maps` не трогаются
+  pushPersonal(gameId, payload) {
+    const queue = this._userList[gameId];
+
+    if (!queue) {
+      return;
+    }
+
+    const key = personalKey(payload);
+    const name = personalName(payload);
+
+    this._userList[gameId] = queue.filter(item => {
+      const itemKey = personalKey(item);
+
+      return (
+        itemKey === null ||
+        personalName(item) !== name ||
+        personalGroup(itemKey) !== personalGroup(key)
+      );
+    });
+
+    this._userList[gameId].push(payload);
+  }
+
+  // убирает неотправленные личные сообщения: CLEAR уходит синхронно, а
+  // очередь — по сообщению на кадр, и меню прошлого раунда пришло бы после
+  dropPersonal(gameId) {
+    const queue = this._userList[gameId];
+
+    if (queue) {
+      this._userList[gameId] = queue.filter(item => personalKey(item) === null);
+    }
+  }
+
   // возвращает данные
   shift() {
     return this._list.shift();
@@ -178,6 +215,34 @@ class Vote {
   }
 }
 
+const PERSONAL_KEYS = ['menu', 'menuClose', 'menuHint'];
+
+// ключ личного сообщения (`menu`/`menuClose`/`menuHint`) или null — это
+// список голосования (массив или шаблон)
+function personalKey(item) {
+  if (item === null || typeof item !== 'object' || Array.isArray(item)) {
+    return null;
+  }
+
+  return PERSONAL_KEYS.find(key => Object.hasOwn(item, key)) ?? null;
+}
+
+// имя меню, к которому относится личное сообщение
+function personalName(item) {
+  const key = personalKey(item);
+
+  if (key === 'menu') {
+    return item.menu.name;
+  }
+
+  return key === 'menuHint' ? item.menuHint.name : item[key];
+}
+
+// `menu` и `menuClose` вытесняют друг друга, `menuHint` — только себя
+function personalGroup(key) {
+  return key === 'menuHint' ? 'hint' : 'menu';
+}
+
 // Сброс синглтона. Нужен только тем, кто крутит больше одного матча в
 // процессе — headless-runner (devtools/resetHostSingletons.js) и тесты;
 // в браузерной вкладке матч всегда один, поэтому прод его не зовёт.

package/src/host/meta/player/ParticipantManager.js

@@ -24,6 +24,8 @@ class ParticipantManager {
     this._participants = new Map(); // gameId -> Participant
     this._teamSizes = {}; // team -> Set<gameId>
     this._activePlayersList = []; // gameId[]
+    // жив ли игрок в ядре; ядро появляется позже менеджера (setAliveCheck)
+    this._isAlive = () => true;
 
     this.resetTeamSizes();
   }
@@ -62,7 +64,7 @@ class ParticipantManager {
       team: this._joinTeam,
       teamId: this._joinTeamId,
       socketId,
-      watchedGameId: this._activePlayersList[0] || null,
+      watchedGameId: this.firstWatchable(),
       token: params.token,
       identityName: params.name,
     });
@@ -113,7 +115,7 @@ class ParticipantManager {
       team,
       teamId,
       socketId,
-      watchedGameId: this._activePlayersList[0] || null,
+      watchedGameId: this.firstWatchable(),
       token: record.token ?? null,
       identityName: record.identityName ?? null,
     });
@@ -335,11 +337,25 @@ class ParticipantManager {
     // перецепление наблюдателей на другого активного игрока
     for (const participant of this._participants.values()) {
       if (participant.watchedGameId === gameId) {
-        participant.watchedGameId = this._activePlayersList[0] || null;
+        participant.watchedGameId = this.firstWatchable();
       }
     }
   }
 
+  setAliveCheck(isAlive) {
+    this._isAlive = isAlive;
+  }
+
+  // первая цель наблюдателя: живой активный игрок; живых нет — первый из
+  // списка (остов), списка нет — null
+  firstWatchable() {
+    return (
+      this._activePlayersList.find(id => this._isAlive(id)) ??
+      this._activePlayersList[0] ??
+      null
+    );
+  }
+
   clearActive() {
     this._activePlayersList = [];
   }

package/src/lib/capabilities.js

@@ -55,6 +55,23 @@ export const ENGINE_CAPABILITIES = createRegistry('engine-capabilities', [
   // хуки `hooks.voiceSounds`/`hooks.voiceFilter`); опциональна — игра не
   // пишет её в `requires`
   { value: 'voice', since: '0.39.0' },
+  // личное меню игрока в окне `#vote` и подсказка под значком рации:
+  // события ядра menu/menuClose/menuHint, опкод `menu.answer`
+  { value: 'menu.personal', since: '0.41.0' },
+  // опкод `actor.forget`: участник покинул матч (в том числе наблюдатель);
+  // без него id ушедшего наследует новичок вместе с профилем игры
+  { value: 'actor.forget', since: '0.41.0' },
+  // опкод `match.reset`: новая игра (движок обнулил счёт); игра, чей баланс
+  // сбрасывается вместе со счётом, объявляет её в `requires`
+  { value: 'match.reset', since: '0.41.0' },
+  // опкоды `state.persist`/`state.restore`: состояние игры между раундами
+  // переживает мягкую миграцию хоста и эстафету Worker'а (мета `persist`)
+  { value: 'state.persist', since: '0.41.0' },
+  // поле конфига игры `voteHoldTime`: удержание голосований в начале раунда
+  { value: 'vote.hold', since: '0.41.0' },
+  // свойства ячейки панели (modules.panel.fields[]): label, labelFrom,
+  // hidden, format, prefix, suffix, emptyWhen, flashOnChange, countdown
+  { value: 'panel.cells', since: '0.41.0' },
 ]);
 
 // плоский список имён — то, чем правило контракта B2 проверяет `requires`

package/src/lib/gameConfigView.js

@@ -68,6 +68,13 @@ const FIELDS = {
 
   spectatorTeam: { derive: deriveSpectatorTeam },
 
+  // мс от старта раунда, в которые голосования удерживаются: запущенное
+  // игроком для других отклоняется, запущенное игрой откладывается; 0 — без
+  // удержания. Поле верхнего уровня, а не `timers.*`: applyRoomOverrides
+  // сливает конфиг поверхностно, и игра, задавшая `timers`, потеряла бы
+  // остальные таймеры движка
+  voteHoldTime: { default: 0 },
+
   // смена хоста посреди раунда (host-migration этап 5): true — игра
   // гарантирует, что GameSim::serialize/deserialize и хуки модулей
   // serializeState/restoreState переносят всё её состояние. Без поля —