vimp-engine 0.35.6 → 0.37.0

package/src/devtools/contract/rules/a2-package-scripts.js

@@ -29,8 +29,6 @@ export default {
     const scripts = ctx.pkg.scripts ?? {};
     const missing = REQUIRED.filter(name => !scripts[name]);
 
-    return verdict(
-      missing.map(name => `script "${name}" is missing`),
-    );
+    return verdict(missing.map(name => `script "${name}" is missing`));
   },
 };

package/src/devtools/contract/rules/b8-system-messages.js

@@ -3,8 +3,8 @@ import { ERROR, skip, verdict } from '../result.js';
 // Регистрация игровых кодов — слепой Object.assign поверх движкового
 // реестра: код в зарезервированном диапазоне затирает движковое сообщение
 // без предупреждения, и вместо «Vote passed» игрок видит игровой текст.
-// Диапазоны — длины движковых групп (client/config/chat messages).
-const RESERVED = { s: 6, v: 5, m: 1, c: 1, n: 1 };
+// Диапазоны — длины движковых групп (config/chatMessages.js).
+export const RESERVED = { s: 11, v: 15, m: 1, c: 1, n: 1 };
 
 export default {
   id: 'B8',

package/src/devtools/contract/rules/b9-vote-names.js

@@ -8,11 +8,19 @@ import { ERROR, skip, verdict } from '../result.js';
 const ENGINE_MENU = ['teamChange', 'mapChange'];
 const ENGINE_TEMPLATES = ['teamChange', 'mapChangeBySystem', 'mapChangeByUser'];
 
+// Имена с '@' — голосования самого движка (host-migration этап 10:
+// '@changeHost' — окно «Change host?» от мастера). Ответ на голосование с
+// таким именем клиент перехватывает до хоста — игровое голосование под ним
+// не дошло бы до игры никогда
+const ENGINE_PREFIX = '@';
+const isEngineName = name =>
+  typeof name === 'string' && name.startsWith(ENGINE_PREFIX);
+
 export default {
   id: 'B9',
   name: 'voteNames',
   level: ERROR,
-  title: 'custom votes do not reuse the reserved vote names',
+  title: 'custom votes do not reuse the reserved vote names or the @ prefix',
 
   check(ctx) {
     const vote = ctx.clientConfig?.modules?.vote?.params;
@@ -25,6 +33,14 @@ export default {
     const violations = [];
 
     for (const name of templates) {
+      if (isEngineName(name)) {
+        violations.push(
+          `vote template "${name}" starts with "${ENGINE_PREFIX}" — names ` +
+            `with this prefix are reserved for engine votes`,
+        );
+        continue;
+      }
+
       if (ENGINE_MENU.includes(name) && !ENGINE_TEMPLATES.includes(name)) {
         violations.push(
           `vote template "${name}" reuses a reserved vote name — the engine ` +
@@ -36,6 +52,14 @@ export default {
     for (const entry of vote.menu ?? []) {
       const name = Array.isArray(entry) ? entry[0] : entry;
 
+      if (isEngineName(name)) {
+        violations.push(
+          `vote menu entry "${name}" starts with "${ENGINE_PREFIX}" — names ` +
+            `with this prefix are reserved for engine votes`,
+        );
+        continue;
+      }
+
       if (!ENGINE_MENU.includes(name) && !templates.includes(name)) {
         violations.push(
           `vote menu entry "${name}" has no template — the vote renders empty`,

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

@@ -33,7 +33,10 @@ export default {
     const host = ctx.gameConfig.statMode ?? null;
 
     if (client === host) {
-      return verdict([], client ? `both declare '${client}'` : 'the room table');
+      return verdict(
+        [],
+        client ? `both declare '${client}'` : 'the room table',
+      );
     }
 
     if (client && !host) {

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

@@ -100,7 +100,7 @@ export default {
     // ли игра свои стили под этот список
     if (params.mode === 'leaderboard') {
       return styledLeaderboard(ctx.clientPlugin?.styles)
-        ? verdict([], 'leaderboard list, laid out by the plugin\'s own 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 ' +

package/src/devtools/contract/rules/c7-key-sets.js

@@ -4,7 +4,13 @@ import { ERROR, skip, verdict } from '../result.js';
 // prevPlayer наблюдатель заперт на одной камере; занятый движковый код
 // (чат, голосование, статистика, escape, enter) до игры не доходит;
 // расхождение имён с playerKeys даёт клавишу, которая ничего не шлёт.
-const ENGINE_CODES = { 9: 'stat', 13: 'enter', 27: 'escape', 67: 'chat', 77: 'vote' };
+const ENGINE_CODES = {
+  9: 'stat',
+  13: 'enter',
+  27: 'escape',
+  67: 'chat',
+  77: 'vote',
+};
 const SPECTATOR_ACTIONS = ['nextPlayer', 'prevPlayer'];
 
 export default {
@@ -51,9 +57,7 @@ export default {
 
       for (const action of declared) {
         if (!bound.has(action)) {
-          violations.push(
-            `playerKeys."${action}" has no key in keySetList[1]`,
-          );
+          violations.push(`playerKeys."${action}" has no key in keySetList[1]`);
         }
       }
 

package/src/devtools/contract/rules/d3-snapshot-interp.js

@@ -12,7 +12,8 @@ export default {
   id: 'D3',
   name: 'snapshotInterp',
   level: ERROR,
-  title: "interp only on f32 fields of class 'hot' blocks; role 'state' is a u8 right after the row head",
+  title:
+    "interp only on f32 fields of class 'hot' blocks; role 'state' is a u8 right after the row head",
 
   check(ctx) {
     const snapshot = ctx.gameConfig?.snapshot;

package/src/devtools/contract/rules/e1-sound-pairs.js

@@ -30,7 +30,9 @@ export default {
         'mp3',
       ]) {
         if (!ctx.distFiles.has(`sounds/${file}.${codec}`)) {
-          violations.push(`sound "${name}": dist/sounds/${file}.${codec} is missing`);
+          violations.push(
+            `sound "${name}": dist/sounds/${file}.${codec} is missing`,
+          );
         }
       }
     }

package/src/devtools/contract/rules/e4-map-layers.js

@@ -133,7 +133,13 @@ function checkMap(name, map, violations) {
     }
 
     // 8. тайл рендер-слоя обязан существовать в тайл-листе по индексу
-    checkLayerFrames(at, `level ${key}`, level?.layers, map.spriteSheet, violations);
+    checkLayerFrames(
+      at,
+      `level ${key}`,
+      level?.layers,
+      map.spriteSheet,
+      violations,
+    );
 
     // 11. высоты объёмов уровня
     checkVolumes(at, key, level?.layers, level?.volumes, violations);
@@ -325,7 +331,12 @@ function rampRunExits(grid, tile, dir) {
   return out;
 }
 
-const NEIGHBOURS = [[1, 0], [-1, 0], [0, 1], [0, -1]];
+const NEIGHBOURS = [
+  [1, 0],
+  [-1, 0],
+  [0, 1],
+  [0, -1],
+];
 
 function checkLevelEdges(at, map, violations) {
   for (const [key, level] of Object.entries(map.levels ?? {})) {

package/src/devtools/contract/rules/e5-map-radar-walls.js

@@ -43,7 +43,13 @@ export default {
 function checkMap(at, map, violations) {
   let checked = 0;
 
-  checked += checkGrid(at, 'level 0', map?.layers, map?.physicsStatic, violations);
+  checked += checkGrid(
+    at,
+    'level 0',
+    map?.layers,
+    map?.physicsStatic,
+    violations,
+  );
 
   for (const [key, level] of Object.entries(map?.levels ?? {})) {
     checked += checkGrid(

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

@@ -40,11 +40,44 @@ import e7 from './e7-map-game-field.js';
 // Порядок групп — порядок отчёта: A пакет и сборка, B host, C client,
 // D снапшот, E ассеты (plan/create-vimp-game/stage_1.md).
 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, c11,
-  d1, d2, d3,
-  e1, e2, e3, e4, e5, e6, e7,
+  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,
+  c11,
+  d1,
+  d2,
+  d3,
+  e1,
+  e2,
+  e3,
+  e4,
+  e5,
+  e6,
+  e7,
 ];
 
 export default rules;

package/src/devtools/invariants.js

@@ -35,7 +35,9 @@ const CHECKS = [
   [12, 'determinism', 'two runs produce a byte-identical frame stream'],
 ];
 
-const TITLES = new Map(CHECKS.map(([id, name, title]) => [name, { id, title }]));
+const TITLES = new Map(
+  CHECKS.map(([id, name, title]) => [name, { id, title }]),
+);
 
 /**
  * Выполняет проверки 1–11 по итогам прогона (12 — только по требованию,
@@ -223,7 +225,9 @@ function frameFormat({ clients, socketManager }) {
 
   for (const client of clients) {
     for (const error of client.decodeErrors) {
-      violations.push(`${client.socketId}: push_frame threw — ${error.message}`);
+      violations.push(
+        `${client.socketId}: push_frame threw — ${error.message}`,
+      );
     }
   }
 
@@ -277,7 +281,7 @@ function hotLayout({ clients }) {
         item.message
           ? `${client.socketId}: ${item.message} (len ${item.len})`
           : `${client.socketId}: hot buffer len ${item.len}, traversal consumed ` +
-            `${item.consumed} — record width or group order drifted`,
+              `${item.consumed} — record width or group order drifted`,
       );
     }
 
@@ -463,7 +467,9 @@ function predictionDrift({ clients, scenario }) {
       (client.divergenceStats.dropped ?? 0);
 
     if (hidden) {
-      violations.push(`${client.socketId}: +${hidden} more divergence record(s)`);
+      violations.push(
+        `${client.socketId}: +${hidden} more divergence record(s)`,
+      );
     }
   }
 

package/src/devtools/pluginLoader.js

@@ -16,10 +16,7 @@ import { loadGamePackage } from '../lib/loadGamePackage.js';
 // пути в манифесте. Его отсутствие не ошибка — просто игра не прогоняется
 // headless своим настоящим ядром.
 
-const FIXTURE_DIR = new URL(
-  '../../tests/fixtures/miniGame/',
-  import.meta.url,
-);
+const FIXTURE_DIR = new URL('../../tests/fixtures/miniGame/', import.meta.url);
 
 // значение поля source у фикстуры: по нему отличается «своя игра, схему
 // которой инструмент знает» от чужого плагина (см. builtinScenario.js)

package/src/devtools/report.js

@@ -103,6 +103,20 @@ export function formatMarkdown(report) {
     }
   }
 
+  // смены хоста через контрольную точку: 'soft' у игры, которая ждала
+  // 'midRound', — первое, что автор должен увидеть
+  if (report.checkpointRestores?.length) {
+    lines.push('');
+    lines.push('## Host checkpoints');
+    lines.push('');
+
+    for (const restore of report.checkpointRestores) {
+      lines.push(
+        `- tick ${restore.tick}: \`${restore.mode}\`, ${restore.bytes} B`,
+      );
+    }
+  }
+
   lines.push('');
 
   return `${lines.join('\n')}\n`;
@@ -191,7 +205,9 @@ function invariantSection(report) {
     const mark = { pass: '✅', fail: '❌', skip: '⏭️' }[check.status];
     const note = check.note ? ` — ${check.note}` : '';
 
-    lines.push(`- ${mark} ${check.id}. \`${check.name}\`: ${check.title}${note}`);
+    lines.push(
+      `- ${mark} ${check.id}. \`${check.name}\`: ${check.title}${note}`,
+    );
 
     for (const violation of check.violations) {
       lines.push(`  - ${violation}`);

package/src/host/DebugRecorder.js

@@ -48,7 +48,12 @@ export default class DebugRecorder {
    * @param {Array} [params.participants] - [{ gameId, name, model, socketId,
    *   team }] — люди, уже находящиеся в комнате.
    */
-  start({ seed = null, map = null, networkSendRate = null, participants = [] }) {
+  start({
+    seed = null,
+    map = null,
+    networkSendRate = null,
+    participants = [],
+  }) {
     this._reset();
 
     this._recording = true;

package/src/host/GameCoreAdapter.js

@@ -241,6 +241,45 @@ export default class GameCoreAdapter {
     );
   }
 
+  // ***** контрольная точка (host-migration этап 5) ***** //
+
+  /**
+   * Дамп состояния ядра (замороженный ABI `serialize_state`). Звать только
+   * на границе кадра — сразу после packBody: накопители снапшота должны
+   * быть опустошены (предусловие ядра).
+   * @returns {Uint8Array} Собственная копия байтов в JS-куче.
+   * @throws {Error} Ядро не смогло сериализовать мир — точка пропускается.
+   */
+  serializeState() {
+    let bytes;
+
+    try {
+      bytes = this._core.serialize_state();
+    } catch (e) {
+      throw new Error(`core serialize_state failed: ${errorText(e)}`);
+    }
+
+    if (!(bytes instanceof Uint8Array)) {
+      throw new Error('core serialize_state returned no bytes');
+    }
+
+    return bytes;
+  }
+
+  /**
+   * Поднимает мир ядра из дампа. Конфиг ядра обязан совпадать с конфигом
+   * ядра, снявшего дамп.
+   * @param {Uint8Array} bytes
+   * @throws {Error} Битый или несовместимый дамп.
+   */
+  deserializeState(bytes) {
+    try {
+      this._core.deserialize_state(bytes);
+    } catch (e) {
+      throw new Error(`core deserialize_state failed: ${errorText(e)}`);
+    }
+  }
+
   // ***** отладка ***** //
 
   /**
@@ -296,3 +335,9 @@ export default class GameCoreAdapter {
     return Boolean(participant && participant.isScripted);
   }
 }
+
+// JsError wasm-bindgen и обычный Error — у обоих есть message; строка из
+// throw внутри фейка — тоже ответ
+function errorText(e) {
+  return e && e.message ? e.message : String(e);
+}