vimp-engine 0.20.0 → 0.22.0

package/src/devtools/contract/rules/c11-stat-mode.js

@@ -0,0 +1,60 @@
+import { ERROR, skip, verdict } from '../result.js';
+
+// Режим статистики по Tab объявляется ДВАЖДЫ, и обе половины обязаны
+// совпадать (snakes-v3 этап 4):
+//
+//   gameConfig.statMode              — читает хост (host/HostGame.js);
+//   modules.stat.params.mode         — читает клиент (client/…/model/Stat.js).
+//
+// Рассинхронизация не падает и ничем себя не выдаёт, поэтому её ловит
+// правило, а не рантайм:
+//
+//   объявлен только клиент — хост каждый тик собирает и рассылает таблицу
+//     комнаты, которую клиент выбрасывает первой же строкой update();
+//   объявлен только хост — хост не шлёт таблицу вовсе, а клиент рисует ту
+//     самую таблицу комнаты и она навсегда остаётся пустой.
+//
+// Первое стоит трафика, второе — пустого экрана; оба варианта — дефект
+// конфигурации, а не выбор.
+export default {
+  id: 'C11',
+  name: 'statMode',
+  level: ERROR,
+  title: 'gameConfig.statMode and modules.stat.params.mode agree',
+
+  check(ctx) {
+    const params = ctx.clientConfig?.modules?.stat?.params;
+
+    if (!params || !ctx.gameConfig) {
+      return skip('no client stat params');
+    }
+
+    const client = params.mode ?? null;
+    const host = ctx.gameConfig.statMode ?? null;
+
+    if (client === host) {
+      return verdict([], client ? `both declare '${client}'` : 'the room table');
+    }
+
+    if (client && !host) {
+      return verdict([
+        `modules.stat.params.mode is '${client}', but gameConfig.statMode is ` +
+          'not set: the host keeps broadcasting the room table every tick and ' +
+          'the client throws every one of those messages away',
+      ]);
+    }
+
+    if (host && !client) {
+      return verdict([
+        `gameConfig.statMode is '${host}', but modules.stat.params.mode is ` +
+          'not set: the host sends no stat at all and the client draws the ' +
+          'room table, which stays empty forever',
+      ]);
+    }
+
+    return verdict([
+      `gameConfig.statMode is '${host}' and modules.stat.params.mode is ` +
+        `'${client}': the two halves of the same decision disagree`,
+    ]);
+  },
+};

package/src/devtools/contract/rules/c4-component-dependencies.js

@@ -1,13 +1,20 @@
 import { ERROR, WARN, skip, verdict } from '../result.js';
 
-// Движковых сервисов ровно четыре (client/main.js), но пул ими не
+// Движковых сервисов ровно пять (client/main.js), но пул ими не
 // исчерпывается: игра доливает туда свои через ClientPlugin.hooks.services(core)
 // — например геометрию предсказанной динамики карты
 // (docs/en/plugin-api.md «hooks.services»). Незнакомое имя не ошибка для
 // движка: part получает undefined и рисует пустоту — карта без assetsBase
 // выглядит как чистый холст без единой строки в консоли, ради этого правило
 // и существует.
-const SERVICES = ['renderer', 'soundManager', 'assetsBase', 'localPlayer'];
+const SERVICES = [
+  'renderer',
+  'soundManager',
+  'assetsBase',
+  'localPlayer',
+  // места в глобальном топе (snakes-v3 этап 4)
+  'accolades',
+];
 
 export default {
   id: 'C4',

package/src/devtools/contract/rules/c6-stat-columns.js

@@ -67,6 +67,19 @@ function styledColumns(styles, total) {
   return covered;
 }
 
+// Режим 'leaderboard' (snakes-v3 этап 4): движок даёт списку только
+// каркас, внешний вид — дело игры. Достаточно любого правила плагина про
+// `.stat-leaderboard` — раскладка колонок там на контейнере, а не на ячейках
+function styledLeaderboard(styles) {
+  for (const [, selector] of String(styles || '').matchAll(RULE)) {
+    if (selector.includes('.stat-leaderboard')) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
 export default {
   id: 'C6',
   name: 'statColumns',
@@ -74,12 +87,27 @@ export default {
   title: 'stat columns past the engine layout are styled by the plugin',
 
   check(ctx) {
-    const columns = ctx.clientConfig?.modules?.stat?.params?.columns;
+    const params = ctx.clientConfig?.modules?.stat?.params;
+    const columns = params?.columns;
 
     if (!columns) {
       return skip('no client stat columns');
     }
 
+    // snakes-v3 этап 4: в режиме 'leaderboard' движковых таблиц нет вовсе —
+    // рисуется один список `.stat-leaderboard`, и число колонок движковой
+    // раскладке ничего не говорит. Проверять здесь надо другое: привезла
+    // ли игра свои стили под этот список
+    if (params.mode === 'leaderboard') {
+      return styledLeaderboard(ctx.clientPlugin?.styles)
+        ? verdict([], 'leaderboard list, laid out by the plugin\'s own styles')
+        : verdict([
+            "stat declares mode 'leaderboard', but ClientPlugin.styles says " +
+              'nothing about #stat .stat-leaderboard: the engine CSS gives ' +
+              'the list only a bare three-column skeleton',
+          ]);
+    }
+
     // меньше пяти — движковых ширин просто хватает с запасом
     if (columns.length <= ENGINE_COLUMNS) {
       return verdict([]);

package/src/devtools/contract/rules/index.js

@@ -25,6 +25,7 @@ import c7 from './c7-key-sets.js';
 import c8 from './c8-baked-assets.js';
 import c9 from './c9-chat-messages.js';
 import c10 from './c10-auth-schema.js';
+import c11 from './c11-stat-mode.js';
 import d1 from './d1-snapshot-ids.js';
 import d2 from './d2-snapshot-classes.js';
 import d3 from './d3-snapshot-interp.js';
@@ -37,7 +38,7 @@ import e3 from './e3-sound-registry.js';
 export const rules = [
   a1, a2, a3, a4, a5, a6, a7,
   b1, b2, b3, b4, b5, b6, b7, b8, b9, b10,
-  c1, c2, c3, c4, c5, c6, c7, c8, c9, c10,
+  c1, c2, c3, c4, c5, c6, c7, c8, c9, c10, c11,
   d1, d2, d3,
   e1, e2, e3,
 ];

package/src/host/HostGame.js

@@ -1,4 +1,5 @@
 import Panel from './meta/modules/Panel.js';
+import Accolades from './meta/modules/Accolades.js';
 import PlayerDataSync from './meta/modules/PlayerDataSync.js';
 import Stat from './meta/modules/Stat.js';
 import Chat from './meta/modules/chat/index.js';
@@ -117,6 +118,10 @@ export default class HostGame {
     // endlessRound — раунд не перезапускается сам. Флаги независимы
     this._noSpectators = data.noSpectators === true;
     this._endlessRound = data.endlessRound === true;
+    // statMode — чем игра занимает экран по Tab. 'leaderboard' значит, что
+    // клиент рисует глобальный топ, который тянет сам: движковый stat в
+    // этом режиме никто не рисует, и платить за его рассылку незачем
+    this._statLeaderboard = data.statMode === 'leaderboard';
     this._spectatorTeam = this._noSpectators ? null : data.spectatorTeam;
     this._spectatorId = this._noSpectators
       ? null
@@ -146,6 +151,18 @@ export default class HostGame {
       // мастера) — подменяется только там, в проде остаётся глобальный fetch
       ...(playerDataFetch ? { fetchImpl: playerDataFetch } : {}),
     });
+    // места участников в глобальном топе (snakes-v3 этап 4): косметика для
+    // parts игры, движок не знает, какой знак игра нарисует за место
+    this._accolades = new Accolades({
+      participants: this._participants,
+      gameId: this._gameId,
+      // место и очки самого участника: их привозит PlayerDataSync на входе,
+      // и без них игрок вне топа-10 не увидел бы по Tab собственной строки
+      getRating: (id, period) => this._playerDataSync.getRating(id, period),
+      // headless-прогону некуда ходить за топом — тот же подмен, что и у
+      // PlayerDataSync
+      ...(playerDataFetch ? { fetchImpl: playerDataFetch } : {}),
+    });
     this._chat = new Chat();
     this._vote = new Vote();
 
@@ -344,9 +361,20 @@ export default class HostGame {
       removedPlayersList.pop();
     }
 
+    // фоновый опрос глобального топа: сам решает, пора ли (refreshInterval)
+    this._accolades.tick();
+
     const userList = this._participants.getNetworkedReady();
     const panelUpdates = this._panel.processUpdates();
-    const stat = this._stat.getLast();
+    // getLast() — ЕДИНСТВЕННЫЙ дренаж Stat: reset() в _lastBody только
+    // дописывает. Поэтому буфер осушается всегда, даже когда рассылки не
+    // будет: пропуск вызова в режиме leaderboard растил бы эти массивы всё
+    // время жизни комнаты (endlessRound — она живёт часами), а StatBridge
+    // пишет в них на каждый подобранный кристалл. Гейтится ОТПРАВКА
+    const lastStat = this._stat.getLast();
+    // в режиме leaderboard движковый stat не рисуется вовсе — не шлём
+    const stat = this._statLeaderboard ? null : lastStat;
+    const accolades = this._accolades.shift();
     const chat = this._chat.shift();
     const vote = this._vote.shift();
 
@@ -421,6 +449,10 @@ export default class HostGame {
         this._socketManager.sendStat(socketId, stat);
       }
 
+      if (accolades) {
+        this._socketManager.sendAccolades(socketId, accolades);
+      }
+
       const chatUser = chat || this._chat.shiftByUser(gameId);
       if (chatUser) {
         this._socketManager.sendChat(socketId, chatUser);
@@ -510,6 +542,20 @@ export default class HostGame {
     user.isReady = true;
     this._socketManager.sendTechInform(socketId);
     this._socketManager.sendFirstVote(socketId);
+
+    // топ и места в нём — целиком и лично, как и первый кадр stat.
+    // Периодическая рассылка (shift() в игровом цикле) уходит только тем,
+    // кто УЖЕ готов, а места новичка посчитаны на его входе, за всю загрузку
+    // карты до этой строки: та рассылка ушла бы без него и не повторилась
+    // бы — места с тех пор не менялись, — и ни знак, ни таблица по Tab не
+    // появились бы до первого чужого входа. В комнате, куда больше никто не
+    // заходит, никогда
+    const accoladesNow = this._accolades.current();
+
+    if (Object.keys(accoladesNow.places).length) {
+      this._socketManager.sendAccolades(socketId, accoladesNow);
+    }
+
     this._chat.pushSystem('USER_JOINED', [user.name]);
 
     // noSpectators: голосования за вход нет — участник уже в играющей
@@ -643,7 +689,11 @@ export default class HostGame {
     // иначе removeUser стартует второй flush с той же накопленной дельтой
     // (двойной зачёт рейтинга), а destroy разрешился бы раньше, чем эти
     // запросы уйдут
-    await this._playerDataSync.flushAll();
+    // незакрытые игры участников закрываются здесь: их очки иначе не
+    // попали бы ни в сумму, ни в максимум и пропали бы вместе с комнатой
+    // (правило 7 snakes-v3 этап 3 — запись гарантирована в destroy())
+    this._playerDataSync.finishAllGames();
+    await this._playerDataSync.flushAll({ urgent: true });
 
     // getAll() отдаёт копию — снятие внутри цикла реестр не ломает
     for (const user of this._participants.getAll()) {
@@ -863,6 +913,11 @@ export default class HostGame {
     // вход; сбой auth-сервиса оставляет участника с дефолтами
     this._playerDataSync.load(gameId, params.token);
 
+    // место новичка в глобальном топе: знак должен появиться сразу, а не
+    // на следующем периодическом опросе. Это пересчёт по уже известным
+    // срезам, а не поход за ними — за топом ходит только tick()
+    this._accolades.noteRoster();
+
     queueMicrotask(() => {
       cb(gameId);
     });
@@ -886,9 +941,12 @@ export default class HostGame {
     this._vote.removeUser(gameId);
     this._panel.removeUser(gameId);
 
-    // финальная синхронизация rank/state перед уходом участника (Этап B4)
+    // финальная синхронизация профиля перед уходом участника (Этап B4):
+    // незавершённая игра закрывается — второго шанса записать её очки не
+    // будет, — и интервал синхронизации эта граница обходит (urgent)
+    this._playerDataSync.finishGame(gameId);
     this._playerDataSync
-      .flush(gameId)
+      .flush(gameId, { urgent: true })
       .catch(err =>
         console.warn('[playerData] final flush failed:', err.message),
       )
@@ -984,7 +1042,7 @@ export default class HostGame {
       if (message.charAt(0) === '/') {
         this._commandProcessor.parseCommand(gameId, message);
       } else {
-        this._chat.push(message, user.name, user.teamId);
+        this._chat.push(message, user.name, user.teamId, user.chatColor);
       }
     }
   }
@@ -1058,11 +1116,44 @@ export default class HostGame {
 
   // прибавка к рангу для игр, которые не эмитят CoreEvent::Death и потому
   // никогда не проходят через RoundManager.reportKill: прямая прокладка к
-  // PlayerDataSync, без раунд-логики и без проверки team-wipe
+  // PlayerDataSync, без раунд-логики и без проверки team-wipe.
+  // @deprecated snakes-v3: алиас addPlayerPoints
   addPlayerRank(gameId, delta) {
     this._playerDataSync.addRank(gameId, delta);
   }
 
+  // ***** результат игры (snakes-v3 этап 3) ***** //
+
+  // очки ТЕКУЩЕЙ игры участника: жизнь, раунд, матч — что игра называет
+  // игрой. В рейтинги они попадают только на finishPlayerGame
+  addPlayerPoints(gameId, delta) {
+    this._playerDataSync.addPoints(gameId, delta);
+  }
+
+  // игра участника закончилась: накопленные очки уходят в сумму (месячный
+  // рейтинг) и в максимум (дневной). Игра без раундов зовёт это сама — у
+  // игры с раундами обе границы закрывает RoundManager
+  finishPlayerGame(gameId) {
+    this._playerDataSync.finishGame(gameId);
+  }
+
+  // значения среза для показа: { value, placement, total } или null
+  getPlayerRating(gameId, period) {
+    return this._playerDataSync.getRating(gameId, period);
+  }
+
+  // приехал ли СРЕЗ с мастера: ноль незагруженного рейтинга и настоящий
+  // ноль — разные вещи, и игре, которая на них смотрит, надо их различать
+  isPlayerRatingLoaded(gameId, period) {
+    return this._playerDataSync.isRatingLoaded(gameId, period);
+  }
+
+  // точечный перезапрос места в срезе (чат-команда /rank): место меняют
+  // чужие игры, локально его не пересчитать. Троттлинг — в PlayerDataSync
+  refreshPlayerPlacement(gameId, period) {
+    return this._playerDataSync.refreshPlacement(gameId, period);
+  }
+
   // синхронизация профилей (rank/state) всех участников на мастер прямо
   // сейчас — для игр, у которых нет ни конца раунда, ни смены карты
   // (`endlessRound` + карта, пересобираемая через overrideMapData): обе
@@ -1072,8 +1163,13 @@ export default class HostGame {
   //
   // Best-effort, как и весь PlayerDataSync: промис не отвергается, сбой
   // логируется в `[playerData]` и повторится следующим flush'ем.
-  flushPlayerData() {
-    return this._playerDataSync.flushAll();
+  //
+  // snakes-v3 этап 3: это просьба, а не команда — участник, у которого с
+  // прошлой синхронизации прошло меньше lobbyConfig.playerData.
+  // minFlushInterval, пропускается. Срочные границы (уход участника,
+  // destroy комнаты) интервал обходят, игре они недоступны
+  flushPlayerData({ urgent = false } = {}) {
+    return this._playerDataSync.flushAll({ urgent });
   }
 
   // hostId + per-room секрет комнаты, подтверждённые мастером при

package/src/host/meta/SocketManager.js

@@ -39,6 +39,7 @@ export default class SocketManager {
     this._PORT_CHAT_DATA = ports.CHAT_DATA;
     this._PORT_VOTE_DATA = ports.VOTE_DATA;
     this._PORT_KEYSET_DATA = ports.KEYSET_DATA;
+    this._PORT_ACCOLADES_DATA = ports.ACCOLADES_DATA;
 
     this._soundCues = soundCues;
     this._initialVote = initialVote;
@@ -337,6 +338,16 @@ export default class SocketManager {
     this._send(socketId, this._PORT_STAT_DATA, data);
   }
 
+  /**
+   * Отправка мест участников в глобальном топе (snakes-v3 этап 4). Движок
+   * раздаёт числа, знак за место рисует part игры.
+   * @param {string} socketId
+   * @param {Object} data - { [gameId]: { daily, monthly } }
+   */
+  sendAccolades(socketId, data) {
+    this._send(socketId, this._PORT_ACCOLADES_DATA, data);
+  }
+
   /**
    * Отправка сообщения чата.
    * @param {string} socketId

package/src/host/meta/core/RoundManager.js

@@ -146,8 +146,11 @@ class RoundManager {
     this._stat.reset();
     this._voteCoordinator.reset();
 
-    // синхронизация накопленных rank/state на мастер перед сменой карты
-    // (Этап B4) — естественная граница жизненного цикла
+    // синхронизация накопленных профилей на мастер перед сменой карты
+    // (Этап B4) — естественная граница жизненного цикла. Смена карты
+    // заканчивает игру каждого участника (snakes-v3 этап 3): без этого у
+    // игры с раундами дневной максимум навсегда остался бы нулём
+    this._playerDataSync?.finishAllGames?.();
     this._playerDataSync?.flushAll();
 
     this._snapshotManager.reset();
@@ -696,8 +699,10 @@ class RoundManager {
       );
     }
 
-    // синхронизация накопленных rank/state на мастер по итогам раунда
-    // (Этап B4) — естественная граница жизненного цикла
+    // синхронизация накопленных профилей на мастер по итогам раунда
+    // (Этап B4) — естественная граница жизненного цикла. Конец раунда и
+    // есть конец игры участника (snakes-v3 этап 3)
+    this._playerDataSync?.finishAllGames?.();
     this._playerDataSync?.flushAll();
 
     if (winnerTeam) {