vimp-engine 0.34.0 → 0.34.1

package/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "vimp-engine-core"
-version = "0.20.0"
+version = "0.21.0"
 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.34.0",
+  "version": "0.34.1",
   "description": "VIMP — движок-приложение (мастер, P2P-транспорт, Worker-хост, мета, MVC-каркас клиента)",
   "license": "MIT",
   "repository": {

package/src/devtools/ScenarioRunner.js

@@ -32,6 +32,10 @@ const RECORDED_PORTS = {
   sendTechInform: 'techInform',
 };
 
+// Сообщения, перед которыми отложенные кадры клиента доставляются сразу:
+// они сбрасывают или заменяют его мир (см. routeFrame).
+const FLUSHING_METHODS = new Set(['sendClear', 'sendMap', 'sendFirstShot']);
+
 // В headless-контуре нет ни мастера, ни auth-сервиса — участник стартует с
 // пустым профилем (lib/offlinePlayerData.js, общее со standalone/dedicated).
 const emptyProfileFetch = offlinePlayerData();
@@ -133,6 +137,12 @@ export async function runScenario(rawScenario, options = {}) {
 
 async function execute(scenario, plugin, virtualClock, { captureFrames }) {
   const clients = new Map(); // socketId → VirtualClient
+  // sendShot не вталкивается в клиента сразу: кадр момента T, доставленный
+  // до render(T), сравнивался бы детектором рассинхрона с репликой на
+  // T − timeStep — ложный дрейф v · timeStep. Кадры копятся здесь и
+  // доставляются после рендер-тика (docs/*/debugging.md, «Prediction
+  // divergence detector»)
+  const pendingShots = new Map(); // socketId → [bytes]
   const byParticipant = new Map(); // id сценария → { socketId, gameId }
   const participantLog = []; // [{ who, socketId, gameId, joinTick, leaveTick }]
   const mapChanges = [];
@@ -165,7 +175,8 @@ async function execute(scenario, plugin, virtualClock, { captureFrames }) {
     // получить те же порты и ту же игровую параметризацию
     createSocketManager: (ports, gameOpts) => {
       socketManager = new RecordingSocketManager(ports, gameOpts, {
-        onFrame: frame => routeFrame(frame, clients, virtualClock, host),
+        onFrame: frame =>
+          routeFrame(frame, clients, pendingShots, virtualClock, host),
       });
 
       return socketManager;
@@ -211,6 +222,7 @@ async function execute(scenario, plugin, virtualClock, { captureFrames }) {
         clientCfg,
         plugin,
         clients,
+        pendingShots,
         byParticipant,
         participantLog,
         inputSeq,
@@ -224,8 +236,9 @@ async function execute(scenario, plugin, virtualClock, { captureFrames }) {
       await virtualClock.advance(stepMs);
     }
 
-    for (const client of clients.values()) {
+    for (const [socketId, client] of clients) {
       client.render(virtualClock.monotonic());
+      deliverShots(socketId, clients, pendingShots, virtualClock);
     }
 
     if (dumpTicks.has(tick)) {
@@ -240,6 +253,16 @@ async function execute(scenario, plugin, virtualClock, { captureFrames }) {
     }
   }
 
+  // кадры последнего advance доставляются уже после финального дампа (срез
+  // сцены не меняется), но ещё раз проходят рендер: без него проверки
+  // finiteValues/hotLayout/renderCoverage не видели бы последнего тика, а
+  // агрегаты детектора (render вычерпывает их первым делом) — его кадров.
+  // Время то же — реплика не шагает повторно
+  for (const [socketId, client] of clients) {
+    deliverShots(socketId, clients, pendingShots, virtualClock);
+    client.render(virtualClock.monotonic());
+  }
+
   return buildReport({
     scenario,
     plugin,
@@ -261,13 +284,31 @@ async function execute(scenario, plugin, virtualClock, { captureFrames }) {
 
 // исходящий кадр хоста → клиент-получатель. sendShot несёт байты, которые в
 // проде ушли бы в data channel — их и скармливаем клиентскому ядру
-function routeFrame(frame, clients, virtualClock, host) {
+function routeFrame(frame, clients, pendingShots, virtualClock, host) {
   const client = clients.get(frame.socketId);
 
   if (!client) {
     return;
   }
 
+  // кадр ждёт рендер-тика своего момента (см. pendingShots в runScenario)
+  if (frame.method === 'sendShot') {
+    if (!pendingShots.has(frame.socketId)) {
+      pendingShots.set(frame.socketId, []);
+    }
+
+    pendingShots.get(frame.socketId).push(frame.args[0]);
+    return;
+  }
+
+  // отложенные кадры выпускают только сообщения, меняющие мир клиента: кадр
+  // старой карты не должен доехать после CLEAR/MAP/первого снапшота. Пинг
+  // (каждые rttPingInterval), панель и прочие очередь не трогают — иначе
+  // кадр их тика доставлялся бы до рендера, на шаг раньше реплики
+  if (FLUSHING_METHODS.has(frame.method)) {
+    deliverShots(frame.socketId, clients, pendingShots, virtualClock);
+  }
+
   // pong отвечается мгновенно: латентность headless-прогона равна нулю, и
   // это единственная честная её модель
   if (frame.method === 'sendPing') {
@@ -275,11 +316,6 @@ function routeFrame(frame, clients, virtualClock, host) {
     return;
   }
 
-  if (frame.method === 'sendShot') {
-    client.pushFrame(frame.args[0], virtualClock.monotonic());
-    return;
-  }
-
   // первый снапшот мира: в браузере он применяется сразу (applyShot), а не
   // едет через буфер интерполяции — сущность, доехавшая только им, иначе не
   // попадёт ни в сцену, ни в проверки
@@ -307,10 +343,27 @@ function routeFrame(frame, clients, virtualClock, host) {
   }
 }
 
+function deliverShots(socketId, clients, pendingShots, virtualClock) {
+  const queue = pendingShots.get(socketId);
+
+  if (!queue?.length) {
+    return;
+  }
+
+  pendingShots.delete(socketId);
+
+  const client = clients.get(socketId);
+
+  for (const bytes of queue) {
+    client?.pushFrame(bytes, virtualClock.monotonic());
+  }
+}
+
 async function applyOp(op, ctx) {
   const {
     host,
     clients,
+    pendingShots,
     byParticipant,
     participantLog,
     inputSeq,
@@ -333,6 +386,7 @@ async function applyOp(op, ctx) {
         // текучкой участников растит процесс
         clients.get(entry.socketId)?.destroy();
         clients.delete(entry.socketId);
+        pendingShots.delete(entry.socketId);
         byParticipant.delete(op.who);
 
         const logged = participantLog.find(

package/src/devtools/VirtualClient.js

@@ -222,7 +222,7 @@ class VirtualClient {
   render(localNow) {
     // записи копятся в ядре на push_frame, поэтому вычерпываются до sample —
     // иначе тик с пустым hot-буфером (ранний выход ниже) их бы потерял
-    this._drainDivergence();
+    this.drainDivergence();
 
     const len = this.core.sample(localNow);
 
@@ -299,8 +299,9 @@ class VirtualClient {
   }
 
   // Записи детектора рассинхрона предикта из ядра. Агрегаты накопительные,
-  // поэтому просто перезаписываются; записи — вычерпываются.
-  _drainDivergence() {
+  // поэтому просто перезаписываются; записи — вычерпываются. Публичный:
+  // раннер вычерпывает кадры, доставленные после последнего рендер-тика.
+  drainDivergence() {
     if (typeof this.core.take_divergence !== 'function') {
       return;
     }

package/tests/fixtures/miniGame/client/fakeClientCore.js

@@ -40,6 +40,10 @@ export default class FakeClientCore {
     this._inputs = []; // [{ time, vy }] в локальном времени
     this._base = null; // { x, y, time, vy } — последнее авторитетное, в серверном
     this._offset = 0;
+    // локальное время последнего sample(): реплика Rust-ядра шагает только
+    // в нём, и predicted_state() отдаёт состояние на этот момент, а не на
+    // момент кадра — фикстура сравнивает так же, чтобы сдвиг был виден
+    this._sampledAt = null;
   }
 
   push_frame(data, localNow = 0) {
@@ -66,7 +70,9 @@ export default class FakeClientCore {
     return 0;
   }
 
-  sample() {
+  sample(localNow = 0) {
+    this._sampledAt = localNow;
+
     if (!this._frame || !this._hotKey) {
       this._hot = new Float32Array(0);
 
@@ -157,7 +163,11 @@ export default class FakeClientCore {
     const time = frame.serverTime;
 
     if (this._base) {
-      const predicted = this._predictAt(time);
+      // до первого sample() момента реплики ещё нет — сравнение на момент
+      // кадра, как было до учёта sample (сдвига в этот момент нет)
+      const predicted = this._predictAt(
+        this._sampledAt === null ? time : this._sampledAt + this._offset,
+      );
 
       this._compare(predicted, authoritative, frame);
     }
@@ -273,6 +283,7 @@ export default class FakeClientCore {
     this._hot = new Float32Array(0);
     this._base = null;
     this._inputs = [];
+    this._sampledAt = null;
   }
 
   // зеркало ClientState::debug_json; у фикстуры буфер — один последний