vimp-engine 0.35.6 → 0.36.0

package/bin/vimp-sim.js

@@ -26,6 +26,11 @@ const USAGE = `Usage: vimp-sim [options]
   --out <dir>        report root (default: .debug)
   --no-write         print the report to stdout instead of writing files
   --determinism      run the scenario twice and compare the frame streams
+  --checkpoint-every <ms>
+                     every <ms> of match time take a host checkpoint, raise a
+                     NEW host from it and resume every client (RESUME) —
+                     checks the game survives a host change; overrides the
+                     scenario's checkpointEvery
   --help
 `;
 
@@ -43,7 +48,7 @@ const BUILTIN_NOTICE =
 // wasmUrl не смотрит, поэтому прогон был бы зелёным, не тронув ядро игры
 const STRAY_CORE_NOTICE =
   'notice: --core without --game does nothing: the run falls back to the\n' +
-  "notice: built-in fixture, whose core is plain JS. Add --game <path>.\n\n";
+  'notice: built-in fixture, whose core is plain JS. Add --game <path>.\n\n';
 
 async function main(argv) {
   const args = parseArgs(argv);
@@ -70,6 +75,18 @@ async function main(argv) {
   const scenario = args.scenario
     ? JSON.parse(await readFile(args.scenario, 'utf8'))
     : builtinScenario(plugin);
+
+  if (args['checkpoint-every'] !== undefined) {
+    const every = Number(args['checkpoint-every']);
+
+    if (!Number.isFinite(every) || every <= 0) {
+      throw new UsageError(
+        `option '--checkpoint-every' needs a positive number of ms\n\n${USAGE}`,
+      );
+    }
+
+    scenario.checkpointEvery = every;
+  }
   // хеши потока кадров собираются только под --determinism: их единственный
   // потребитель — сравнение двух прогонов, а объём линеен по длине матча
   const captureFrames = args.determinism === true;
@@ -132,6 +149,7 @@ function parseArgs(argv) {
       case '--game':
       case '--core':
       case '--out':
+      case '--checkpoint-every':
         i += 1;
 
         // «--game» последним аргументом (или перед следующим флагом) тихо

package/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "vimp-engine-core"
-version = "0.23.1"
+version = "0.23.2"
 edition = "2024"
 description = "VIMP — движковый каркас симуляции (физика, карта, снапшот-фрейминг, интерполяция/предикт/raycast-примитивы, нав-утилиты). Без wasm-bindgen — обёртки для WASM-ABI собирает game-crate."
 license = "MIT"

package/package.json

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

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

@@ -49,6 +49,11 @@ export default class ControlsCtrl {
     this._model.setKeysEnabled(false);
   }
 
+  // повторяет нажатия удерживаемых клавиш (возобновление сессии)
+  resendHeld() {
+    this._model.resendHeld();
+  }
+
   // скрывает курсор
   resetCursorHideTimer() {
     this._view.resetCursorHideTimer();

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

@@ -64,12 +64,12 @@ export default class LobbyCtrl {
     this._model.loadMore();
   }
 
-  pingHost(hostId) {
-    this._model.pingHost(hostId, this._clock());
+  pingHost(roomId) {
+    this._model.pingHost(roomId, this._clock());
   }
 
-  join(hostId) {
-    this._model.join(hostId);
+  join(roomId) {
+    this._model.join(roomId);
   }
 
   showTab(tab) {

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

@@ -0,0 +1,43 @@
+// Singleton RoomMenuCtrl
+
+let roomMenuCtrl;
+
+export default class RoomMenuCtrl {
+  // actions — { onLeave, onHandover }: действия пунктов (client/main.js)
+  constructor(model, view, actions = {}) {
+    if (roomMenuCtrl) {
+      return roomMenuCtrl;
+    }
+
+    roomMenuCtrl = this;
+
+    this._model = model;
+    this._view = view;
+
+    this._vPublic = view.publisher;
+    this._vPublic.on('toggle', () => model.toggle());
+    // меню остаётся открытым: на месте пунктов — статус передачи
+    this._vPublic.on('leave', () => actions.onLeave?.());
+    this._vPublic.on('handover', () => actions.onHandover?.());
+  }
+
+  // абсолютная ссылка на комнату, в которой вкладка; null — скрыть меню
+  setLink(link) {
+    this._model.setLink(link);
+  }
+
+  // { role, othersPresent, hasSuccessor } — см. RoomMenuModel.setRole
+  setRole(state) {
+    this._model.setRole(state);
+  }
+
+  // true — кнопка внутри панели (игра её показывает), false — в углу
+  setInPanel(inPanel) {
+    this._view.placeInPanel(inPanel);
+  }
+
+  // null | 'pending' | 'slow' | 'failed'
+  setHandoff(status) {
+    this._model.setHandoff(status);
+  }
+}

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

@@ -29,8 +29,10 @@ export default class VoteCtrl {
       this._model.updateValues(data);
       // если данные - объект (данные для создания голосования)
     } else if (typeof data === 'object' && data !== null) {
-      this._model.createWithTemplate(data);
-      this._model.open();
+      // false — ждёт закрытия открытого голосования движка
+      if (this._model.createWithTemplate(data) !== false) {
+        this._model.open();
+      }
       // иначе открыть меню
     } else {
       this._model.createMenu();
@@ -52,4 +54,18 @@ export default class VoteCtrl {
   removeVote() {
     this._model.complete();
   }
+
+  // голосование движка (host-migration этап 10: «Change host?» от мастера)
+  openEngineVote(vote) {
+    this._model.createEngineVote(vote);
+  }
+
+  closeEngineVote(name) {
+    this._model.closeEngineVote(name);
+  }
+
+  // голосования хоста не пережили переподключение
+  removeHostVotes() {
+    this._model.removeHostVotes();
+  }
 }

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

@@ -90,7 +90,9 @@ export default class ClientReportsModel {
     this._error = null;
     this._emit();
 
-    const { ok, json } = await this._request(`${this._config.urls.list}?${query}`);
+    const { ok, json } = await this._request(
+      `${this._config.urls.list}?${query}`,
+    );
 
     if (seq !== this._seq) {
       return;
@@ -128,7 +130,9 @@ export default class ClientReportsModel {
     this._error = null;
 
     if (this._status === 'all' || report.status === this._status) {
-      this._items = this._items.map(item => (item.id === report.id ? report : item));
+      this._items = this._items.map(item =>
+        item.id === report.id ? report : item,
+      );
     } else {
       const before = this._items.length;
 

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

@@ -20,6 +20,10 @@ export default class ControlsModel {
     this._currentKeySet = this._keySetList[0]; // текущий набор клавиш
     this._currentModes = {}; // статусы режимов
     this._pressedKeys = {}; // объект для хранения состояния зажатых клавиш
+    // физически зажатые клавиши (keyCode) — независимо от набора и запрета
+    // ввода: _pressedKeys сбрасывает смена набора, а resendHeld() после
+    // возобновления сессии должен знать, что игрок держит на самом деле
+    this._heldCodes = new Set();
     this._areKeysEnabled = false; // статус возможности нажатия клавиш
 
     // канал указателя: игра, не объявившая modules.controls.pointer, его не
@@ -51,6 +55,8 @@ export default class ControlsModel {
     const mode = this._modes[keyCode];
     const cmd = this._cmds[keyCode];
 
+    this._heldCodes.add(keyCode);
+
     // если запрет на ввод клавиш,
     // то доступны только stat и chat
     if (
@@ -103,6 +109,8 @@ export default class ControlsModel {
     const keyCode = event.keyCode;
     const mode = this._modes[keyCode];
 
+    this._heldCodes.delete(keyCode);
+
     // если клавиша была зажата
     if (this._pressedKeys[keyCode]) {
       const name = this._currentKeySet[keyCode];
@@ -226,6 +234,25 @@ export default class ControlsModel {
     this._releasePointer(this._lastTapX, this._lastTapY);
   }
 
+  // снова отправляет нажатия удерживаемых команд (host-migration этап 4):
+  // при обрыве транспорта хост отпустил все клавиши игрока, а тот их так и
+  // держит. Зовётся после пакета входа — смена набора в нём уже сбросила
+  // _pressedKeys, поэтому источник — физически зажатые клавиши
+  resendHeld() {
+    if (this._areKeysEnabled === false || this._currentModes.chat) {
+      return;
+    }
+
+    for (const keyCode of this._heldCodes) {
+      const name = this._currentKeySet[keyCode];
+
+      if (name && !this._pressedKeys[keyCode]) {
+        this._pressedKeys[keyCode] = true;
+        this.publisher.emit('socket', `down:${name}`);
+      }
+    }
+  }
+
   // задаёт возможность нажатия клавиш
   // (stat и chat доступны при любом значении)
   setKeysEnabled(isEnabled) {

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

@@ -214,7 +214,11 @@ export default class GamesModel {
       return;
     }
 
-    this.publisher.emit('staged', { id, version: json.version, manifest: json.manifest });
+    this.publisher.emit('staged', {
+      id,
+      version: json.version,
+      manifest: json.manifest,
+    });
     await this.loadAdmin();
   }
 

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

@@ -18,16 +18,16 @@ export default class LobbyModel {
     this._pageSize = params.pageSize;
     this._pingInterval = params.pingInterval;
 
-    this._servers = new Map(); // hostId -> { ...server, latency }
-    this._order = []; // hostId в порядке выдачи мастером
+    this._servers = new Map(); // roomId -> { ...server, latency }
+    this._order = []; // roomId в порядке выдачи мастером
     this._total = 0; // всего серверов у мастера (для «Загрузить ещё»)
     this._offset = 0;
     this._search = '';
 
     this._pingCounter = 0;
-    this._pending = new Map(); // pingId -> { hostId, time }
-    this._lastPing = new Map(); // hostId -> time последнего пинга
-    this._latencies = new Map(); // hostId -> latency (переживает refresh)
+    this._pending = new Map(); // pingId -> { roomId, time }
+    this._lastPing = new Map(); // roomId -> time последнего пинга
+    this._latencies = new Map(); // roomId -> latency (переживает refresh)
 
     // Leaderboard выбранной игры (lobby-page-plan) — сетевого I/O не делает,
     // как и остальная модель; fetch живёт в main.js (fetchLeaderboard/fetchPlacement)
@@ -49,7 +49,7 @@ export default class LobbyModel {
     this._emitFetch();
   }
 
-  // задаёт поиск по имени и запрашивает список заново
+  // задаёт поиск (roomId, игра, карта) и запрашивает список заново
   setSearch(text) {
     this._search = typeof text === 'string' ? text.trim() : '';
     this._offset = 0;
@@ -72,14 +72,18 @@ export default class LobbyModel {
     this._total = total || 0;
 
     (servers || []).forEach(server => {
-      if (!this._servers.has(server.hostId)) {
-        this._order.push(server.hostId);
+      // hostId — имя roomId у мастера до host-migration этапа 2
+      const roomId = server.roomId ?? server.hostId;
+
+      if (!this._servers.has(roomId)) {
+        this._order.push(roomId);
       }
 
       // latency живёт в _latencies и переживает refresh/пагинацию
-      this._servers.set(server.hostId, {
+      this._servers.set(roomId, {
         ...server,
-        latency: this._latencies.get(server.hostId) ?? null,
+        roomId,
+        latency: this._latencies.get(roomId) ?? null,
       });
     });
 
@@ -87,35 +91,35 @@ export default class LobbyModel {
   }
 
   // пользователь выбрал сервер — во внешнего подписчика (P2P-подключение).
-  // gameId едет вместе с hostId: комната может быть по другой игре, и клиент
+  // gameId едет вместе с roomId: комната может быть по другой игре, и клиент
   // обязан активировать её ClientPlugin до подключения
-  join(hostId) {
-    const server = this._servers.get(hostId);
+  join(roomId) {
+    const server = this._servers.get(roomId);
 
     if (server) {
-      this.publisher.emit('join', { hostId, gameId: server.gameId });
+      this.publisher.emit('join', { roomId, gameId: server.gameId });
     }
   }
 
   // готовит пинг видимого сервера; false — если пинговали недавно/сервер ушёл
-  pingHost(hostId, now) {
-    const last = this._lastPing.get(hostId);
+  pingHost(roomId, now) {
+    const last = this._lastPing.get(roomId);
 
     if (last !== undefined && now - last < this._pingInterval) {
       return false;
     }
 
-    if (!this._servers.has(hostId)) {
+    if (!this._servers.has(roomId)) {
       return false;
     }
 
-    this._lastPing.set(hostId, now);
+    this._lastPing.set(roomId, now);
     this._pingCounter = (this._pingCounter + 1) >>> 0;
 
     const pingId = this._pingCounter;
 
-    this._pending.set(pingId, { hostId, time: now });
-    this.publisher.emit('ping-request', { hostId, pingId });
+    this._pending.set(pingId, { roomId, time: now });
+    this.publisher.emit('ping-request', { roomId, pingId });
 
     return true;
   }
@@ -130,17 +134,17 @@ export default class LobbyModel {
 
     this._pending.delete(pingId);
 
-    const server = this._servers.get(pending.hostId);
+    const server = this._servers.get(pending.roomId);
 
     if (!server) {
       return;
     }
 
     server.latency = Math.round(now - pending.time);
-    this._latencies.set(pending.hostId, server.latency);
+    this._latencies.set(pending.roomId, server.latency);
 
     this.publisher.emit('ping-update', {
-      hostId: pending.hostId,
+      roomId: pending.roomId,
       latency: server.latency,
     });
   }
@@ -157,7 +161,11 @@ export default class LobbyModel {
   // позиция вызывающего, применяется ответом GET /auth/placement;
   // placement === null — игрок ещё не ранжирован в этой игре
   setPlacement({ placement, total, rank } = {}) {
-    this._myPlacement = { placement: placement ?? null, total: total || 0, rank: rank || 0 };
+    this._myPlacement = {
+      placement: placement ?? null,
+      total: total || 0,
+      rank: rank || 0,
+    };
 
     this._scheduleLeaderboardEmit();
   }

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

@@ -60,9 +60,12 @@ export default class LobbyAuthModel {
   }
 
   // URL редиректа на старт OAuth-потока auth-сервиса; вызывающий должен сам
-  // сделать переход (window.location.href) — модель не трогает location
+  // сделать переход (window.location.href) — модель не трогает location.
+  // hash (#/<gameId>[/<roomId>]) едет в returnUrl: после логина игрок
+  // попадает туда, куда вёл открытый URL, а не в общее лобби
   loginUrl(provider) {
-    const returnUrl = `${window.location.origin}${window.location.pathname}`;
+    const { origin, pathname, hash } = window.location;
+    const returnUrl = `${origin}${pathname}${hash}`;
 
     return `${this._config.serviceUrl}/oauth/${provider}/start?returnUrl=${encodeURIComponent(returnUrl)}`;
   }
@@ -125,6 +128,15 @@ export default class LobbyAuthModel {
     return decodeJwtPayload(this._identityToken)?.role ?? 'user';
   }
 
+  // срок входа (мс эпохи) или null — неизвестен. Вкладка с кончающимся
+  // токеном не принимает роль хоста: register_host/reclaim_host предъявят
+  // его мастеру посреди матча (host-migration-review этап 7)
+  getTokenExpiresAt() {
+    const exp = decodeJwtPayload(this._identityToken)?.exp;
+
+    return typeof exp === 'number' ? exp * 1000 : null;
+  }
+
   _restore(tokenStorageKey) {
     const token = localStorage[tokenStorageKey];
 
@@ -141,7 +153,8 @@ export default class LobbyAuthModel {
   // показывает «залогинен» токеном, который хост уже отклонит при входе в игру
   _setIdentity(token, tokenStorageKey, persist = true) {
     const payload = decodeJwtPayload(token);
-    const isExpired = typeof payload?.exp === 'number' && Date.now() >= payload.exp * 1000;
+    const isExpired =
+      typeof payload?.exp === 'number' && Date.now() >= payload.exp * 1000;
 
     if (!payload || !payload.nick || isExpired) {
       delete localStorage[tokenStorageKey];
@@ -150,7 +163,10 @@ export default class LobbyAuthModel {
       // битый токен — штатная ситуация возврата на сайт, не ошибка. login-error
       // — только на интерактивном пути.
       if (persist) {
-        this.publisher.emit('login-error', isExpired ? 'tokenExpired' : 'invalidToken');
+        this.publisher.emit(
+          'login-error',
+          isExpired ? 'tokenExpired' : 'invalidToken',
+        );
       }
 
       this.publisher.emit('login-required', this._config.providers);

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

@@ -0,0 +1,121 @@
+import Publisher from '../../../lib/Publisher.js';
+
+// Singleton RoomMenuModel
+//
+// Меню комнаты внутри матча (host-migration, этапы 3 и 8d). Ссылка на
+// текущую комнату — признак «вкладка в комнате». Пункты:
+// - «Leave server» — у всех;
+// - «Hand over host» — только у текущего хоста, когда в комнате есть другие
+//   люди и мастер назначил бету (иначе передавать некому).
+// Пока идёт передача, пункты заблокированы, на их месте статус. Только
+// лобби-режим: в solo/dedicated ссылки на комнату нет
+
+// handoff: null | 'pending' | 'slow' | 'failed'
+const STATUS_TEXT = {
+  pending: 'Handing over…',
+  slow: 'Slow connection…',
+  failed: 'Host handover failed',
+};
+
+let roomMenuModel;
+
+export default class RoomMenuModel {
+  constructor() {
+    if (roomMenuModel) {
+      return roomMenuModel;
+    }
+
+    roomMenuModel = this;
+
+    this._link = null;
+    this._open = false;
+    this._role = null; // null | 'host' | 'guest'
+    this._othersPresent = false;
+    this._hasSuccessor = false;
+    this._handoff = null;
+    this.publisher = new Publisher();
+  }
+
+  // абсолютная ссылка на комнату; null — вкладка не в комнате, меню скрыто
+  setLink(link) {
+    this._link = link || null;
+
+    if (!this._link) {
+      this.setOpen(false);
+    }
+
+    this._emitState();
+  }
+
+  getLink() {
+    return this._link;
+  }
+
+  /**
+   * Роль вкладки в комнате.
+   * @param {Object} state
+   * @param {'host'|'guest'|null} state.role
+   * @param {boolean} [state.othersPresent] - в комнате есть другие люди.
+   * @param {boolean} [state.hasSuccessor] - мастер назначил бету.
+   */
+  setRole({ role, othersPresent = false, hasSuccessor = false }) {
+    this._role = role ?? null;
+    this._othersPresent = othersPresent === true;
+    this._hasSuccessor = hasSuccessor === true;
+    this._emitState();
+  }
+
+  // ход плановой передачи: null | 'pending' | 'slow' | 'failed'
+  setHandoff(status) {
+    this._handoff = status ?? null;
+    this._emitState();
+  }
+
+  setOpen(open) {
+    const next = Boolean(open) && this._link !== null;
+
+    if (next === this._open) {
+      return;
+    }
+
+    this._open = next;
+    this.publisher.emit('open', next);
+
+    // ошибка передачи показана — закрытое меню её забывает
+    if (!next && this._handoff === 'failed') {
+      this.setHandoff(null);
+    }
+  }
+
+  toggle() {
+    this.setOpen(!this._open);
+  }
+
+  /**
+   * Что показывать.
+   * @returns {{ visible: boolean, leave: Object, handover: Object,
+   *   status: string|null }} leave/handover — { visible, disabled }.
+   */
+  getState() {
+    const inRoom = this._link !== null;
+    const busy = this._handoff === 'pending' || this._handoff === 'slow';
+
+    return {
+      visible: inRoom,
+      leave: { visible: inRoom, disabled: busy },
+      handover: {
+        visible:
+          inRoom &&
+          this._role === 'host' &&
+          this._othersPresent &&
+          this._hasSuccessor,
+        disabled: busy,
+      },
+      status: STATUS_TEXT[this._handoff] ?? null,
+    };
+  }
+
+  _emitState() {
+    this.publisher.emit('state', this.getState());
+  }
+}

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

@@ -174,7 +174,8 @@ export default class StatModel {
 
     // в топе игрока нет — его собственное место знает только рассылка хоста
     const myId = this._localPlayer?.id ?? null;
-    const mine = myId === null ? null : this._accolades.selfOf(myId, this._period);
+    const mine =
+      myId === null ? null : this._accolades.selfOf(myId, this._period);
 
     if (!mine || !nick) {
       return marked;