vimp-engine 0.22.1 → 0.24.0

package/tests/fixtures/generations/gen-api4/host/fakeCore.js

@@ -0,0 +1,263 @@
+// Фейковое JS-ядро миниигры-фикстуры (Этап 7 плана отделения движка,
+// PLAN.md §4/Wasm Host ABI §3.4): реализует полную поверхность методов,
+// которую вызывает GameCoreAdapter, без Rust/WASM — доказательство, что
+// движок не завязан на конкретную реализацию ядра. Актёры — плоские
+// объекты { x, y, angle, team, alive }; тик — тривиальная линейная
+// интеграция скорости (та же идея, что у Rust-фикстуры TestClient,
+// core/src/client/game.rs: форма ABI важнее физики).
+export default class FakeGameCore {
+  constructor(configJson) {
+    this._config = JSON.parse(configJson);
+    this._actors = new Map(); // gameId -> { x, y, angle, team, alive, vx, vy, lastInputSeq }
+    this._map = null;
+    this._events = [];
+    this._lastBody = [];
+    this._lastFrame = null;
+  }
+
+  // ***** карта ***** //
+
+  load_map(mapJson) {
+    this._map = JSON.parse(mapJson);
+  }
+
+  map_info() {
+    if (!this._map) {
+      return 'null';
+    }
+
+    return JSON.stringify({
+      setId: this._map.setId,
+      respawns: this._map.respawns || {},
+    });
+  }
+
+  clear() {
+    this._actors.clear();
+    this._events.length = 0;
+    this._lastBody = [];
+  }
+
+  // ***** участники ***** //
+
+  spawn_actor(gameId, model, teamId, x, y, angle) {
+    this._actors.set(gameId, {
+      x,
+      y,
+      angle,
+      team: teamId,
+      alive: true,
+      vx: 0,
+      vy: 0,
+      lastInputSeq: 0,
+    });
+
+    this._events.push({ type: 'panelSet', id: gameId, field: 'energy', value: 100 });
+  }
+
+  remove_actor(gameId) {
+    this._actors.delete(gameId);
+  }
+
+  reset_actor(gameId, teamId, x, y, angle) {
+    const actor = this._actors.get(gameId);
+
+    if (actor) {
+      Object.assign(actor, { x, y, angle, team: teamId, alive: true, vx: 0, vy: 0 });
+    }
+  }
+
+  reset_all_vitals() {
+    for (const actor of this._actors.values()) {
+      actor.alive = true;
+    }
+  }
+
+  spawn_scripted_actor(gameId, model, teamId, x, y, angle) {
+    this.spawn_actor(gameId, model, teamId, x, y, angle);
+    this._actors.get(gameId).scripted = true;
+  }
+
+  remove_scripted_actor(gameId) {
+    this.remove_actor(gameId);
+  }
+
+  remove_players_and_shots() {
+    const names = [...this._actors.keys()].map(String);
+
+    this._actors.clear();
+
+    return JSON.stringify(names);
+  }
+
+  // ***** ввод ***** //
+
+  apply_input(gameId, seq, action, name) {
+    const actor = this._actors.get(gameId);
+
+    if (!actor) {
+      return;
+    }
+
+    actor.lastInputSeq = seq;
+
+    const magnitude = action === 'down' ? 40 : 0;
+
+    if (name === 'forward') {
+      actor.vy = -magnitude;
+    } else if (name === 'back') {
+      actor.vy = magnitude;
+    } else if (name === 'fire' && action === 'down') {
+      this._events.push({ type: 'custom', data: { kind: 'fire', id: gameId } });
+    }
+  }
+
+  // ввод указателем: миниигра просто запоминает последнюю точку и биты —
+  // движковым тестам важно, что канал доходит до ядра
+  apply_aim(gameId, seq, x, y, flags) {
+    const actor = this._actors.get(gameId);
+
+    if (!actor) {
+      return;
+    }
+
+    actor.lastInputSeq = seq;
+    actor.aim = { x, y, flags };
+  }
+
+  aim_of(gameId) {
+    return this._actors.get(gameId)?.aim ?? null;
+  }
+
+  last_input_seq(gameId) {
+    return this._actors.get(gameId)?.lastInputSeq ?? 0;
+  }
+
+  // ***** запросы состояния ***** //
+
+  is_alive(gameId) {
+    return Boolean(this._actors.get(gameId)?.alive);
+  }
+
+  position_of(gameId) {
+    const actor = this._actors.get(gameId);
+
+    return actor ? [actor.x, actor.y] : [];
+  }
+
+  // FIRST_SHOT_DATA: полный снапшот игроков в раскладке снапшот-схемы
+  // (ключ схемы -> id -> поля), а не плоским списком: ровно её разбирает
+  // клиент (applyShot браузера и VirtualClient._applyGameData). Плоский
+  // список доезжал до клиента ключами '0', '1' — сущность первого кадра
+  // не появлялась на холсте, и видно это только со второго участника
+  players_data() {
+    const entry = Object.entries(
+      this._config.engine?.snapshot?.keys ?? {},
+    ).find(([, spec]) => spec.class === 'hot' && spec.kind === 'indexed8');
+
+    if (!entry) {
+      return '{}';
+    }
+
+    const [key, spec] = entry;
+    const rows = {};
+
+    for (const [id, actor] of this._actors) {
+      rows[id] = spec.fields.map(field => Number(actor[field.name] ?? 0));
+    }
+
+    return JSON.stringify({ [key]: rows });
+  }
+
+  // ***** игровой тик ***** //
+
+  step(dt) {
+    for (const actor of this._actors.values()) {
+      actor.x += actor.vx * dt;
+      actor.y += actor.vy * dt;
+    }
+  }
+
+  take_events() {
+    const events = this._events;
+
+    this._events = [];
+
+    return JSON.stringify(events);
+  }
+
+  // ***** упаковка снапшота (фикстурный формат — не бинарный кодек ядра;
+  // достаточно для тестов меты, которые не декодируют реальный фрейминг) ***** //
+
+  // поля записи — по снапшот-схеме фикстуры (config/game.js, ключ a1):
+  // x, y, angle, team; клиентская половина фикстуры раскладывает их в
+  // hot-буфер той же ширины, что заявлена схемой
+  pack_body() {
+    this._lastBody = [...this._actors.entries()].map(([id, a]) => ({
+      id: Number(id),
+      x: a.x,
+      y: a.y,
+      angle: a.angle,
+      team: a.team,
+    }));
+  }
+
+  body_has_events() {
+    return false;
+  }
+
+  pack_frame(serverTime, seq, hasCamera, camX, camY, forceReset, shake, playerId) {
+    this._lastFrame = {
+      serverTime,
+      seq,
+      camera: hasCamera ? [camX, camY, Boolean(forceReset), shake ?? null] : null,
+      playerId,
+      body: this._lastBody,
+    };
+  }
+
+  frame_bytes() {
+    return new TextEncoder().encode(JSON.stringify(this._lastFrame));
+  }
+
+  // ***** отладка ***** //
+
+  // форма дампа — та же, что у движкового crate::debug (тела/карта/rng),
+  // с поправкой на фикстуру без физики: актёры и есть тела
+  debug_json() {
+    return JSON.stringify({
+      bodies: [...this._actors.entries()].map(([id, a]) => ({
+        handle: Number(id),
+        tag: 2,
+        userData: String(id),
+        translation: [a.x, a.y],
+        rotation: a.angle,
+        linvel: [a.vx, a.vy],
+        angvel: 0,
+        mass: 1,
+        bodyType: 'Dynamic',
+        ccd: false,
+      })),
+      colliders: [],
+      map: this._map
+        ? { setId: this._map.setId, step: this._map.step ?? null }
+        : null,
+      nav: null,
+      spatial: { cells: 0, entities: 0, cellCounts: [] },
+      rng: { state: '0' },
+      step: { timeStep: this._config.timeStep ?? null, accumulator: 0 },
+    });
+  }
+
+  // ***** handoff (задел, PLAN.md §6 «открытые вопросы») ***** //
+
+  serialize_state() {
+    return new TextEncoder().encode(JSON.stringify([...this._actors.entries()]));
+  }
+
+  deserialize_state(bytes) {
+    const entries = JSON.parse(new TextDecoder().decode(bytes));
+
+    this._actors = new Map(entries);
+  }
+}

package/tests/fixtures/generations/gen-api4/host/index.js

@@ -0,0 +1,30 @@
+// ЗАМОРОЖЕНО. Снимок плагина 2026-08-29 (поколение engineApi: 4).
+// Не править: правка фикстуры маскирует слом совместимости.
+import FakeGameCore from './fakeCore.js';
+import gameConfig from '../config/game.js';
+import authSchema from '../config/auth.js';
+import clientConfig from '../config/client.js';
+import systemMessages from './systemMessages.js';
+import spawnCommand from './spawnCommand.js';
+import createModules from './createModules.js';
+
+// HostPlugin миниигры-фикстуры (Этап 7 плана отделения движка, PLAN.md
+// §3.2): доказывает, что HostGame и движковая мета работают с любым
+// HostPlugin, реализующим контракт — не только с @vimp-games/tanks. createCore
+// не грузит WASM (fake-core — обычный JS-класс), поэтому фикстура не
+// требует собранного Rust-ядра игры.
+export default {
+  id: 'gen-api4',
+  engineApi: 4,
+
+  async createCore(coreConfigJson) {
+    return new FakeGameCore(coreConfigJson);
+  },
+
+  gameConfig,
+  authSchema,
+  chatCommands: [spawnCommand],
+  systemMessages,
+  createModules,
+  buildClientGameConfig: () => clientConfig,
+};

package/tests/fixtures/generations/gen-api4/host/spawnCommand.js

@@ -0,0 +1,14 @@
+// Игровая чат-команда фикстуры: '/spawn <count>' — создаёт scripted-
+// участников без голосования (зеркало vimp-tanks/src/host/botCommand.js,
+// упрощённое — доказывает только регистрацию HostPlugin.chatCommands).
+// Регистрируется в движковом CommandProcessor.
+export default {
+  name: '/spawn',
+  handler(ctx, gameId, args) {
+    const count = Number(args[0]) || 1;
+    const created = ctx.scripted.createScripted(count);
+
+    ctx.chat.pushSystem('SCRIPTED_SPAWNED', [created]);
+    ctx.roundManager.initiateNewRound();
+  },
+};

package/tests/fixtures/generations/gen-api4/host/systemMessages.js

@@ -0,0 +1,6 @@
+// Игровые коды системных сообщений фикстуры (группа g:*) — зеркало
+// vimp-tanks/src/host/systemMessages.js (группа b:*). Merge в движковый
+// реестр через registerCodes (HostGame конструктор).
+export default {
+  SCRIPTED_SPAWNED: 'g:0', // {0} scripted participant(s) spawned
+};

package/tests/fixtures/generations/gen-api4/manifest.json

@@ -0,0 +1,17 @@
+{
+  "id": "gen-api4",
+  "engineApi": 4,
+  "assetsBase": "",
+  "entries": {
+    "host": "host/index.js",
+    "client": "client/index.js",
+    "wasm": "core/pkg-web/core_bg.wasm",
+    "wasmNode": "core/pkg-node/core.js"
+  },
+  "roomDefaults": {
+    "maxPlayers": 4
+  },
+  "maps": [
+    "arena"
+  ]
+}

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

@@ -301,4 +301,21 @@ export default class FakeClientCore {
       return 'null';
     }
   }
+
+  // ***** расширение (этап 4 плана plugin-forward-compat) ***** //
+
+  // самоописание: фикстура представляет ядро текущего поколения, поэтому
+  // отвечает так же, как раскрытие движкового макроса
+  abi_describe() {
+    return JSON.stringify({ abi: 1, core: 'fixture', ops: ['debug.json'] });
+  }
+
+  // опкод вместо нового символа: пустой ответ — «не обработан»
+  dispatch(op) {
+    if (op === 'debug.json') {
+      return new TextEncoder().encode(this.debug_json());
+    }
+
+    return new Uint8Array(0);
+  }
 }

package/tests/fixtures/miniGame/host/fakeCore.js

@@ -145,15 +145,28 @@ export default class FakeGameCore {
     return actor ? [actor.x, actor.y] : [];
   }
 
+  // FIRST_SHOT_DATA: полный снапшот игроков в раскладке снапшот-схемы
+  // (ключ схемы -> id -> поля), а не плоским списком: ровно её разбирает
+  // клиент (applyShot браузера и VirtualClient._applyGameData). Плоский
+  // список доезжал до клиента ключами '0', '1' — сущность первого кадра
+  // не появлялась на холсте, и видно это только со второго участника
   players_data() {
-    return JSON.stringify(
-      [...this._actors.entries()].map(([id, a]) => ({
-        id: Number(id),
-        x: a.x,
-        y: a.y,
-        team: a.team,
-      })),
-    );
+    const entry = Object.entries(
+      this._config.engine?.snapshot?.keys ?? {},
+    ).find(([, spec]) => spec.class === 'hot' && spec.kind === 'indexed8');
+
+    if (!entry) {
+      return '{}';
+    }
+
+    const [key, spec] = entry;
+    const rows = {};
+
+    for (const [id, actor] of this._actors) {
+      rows[id] = spec.fields.map(field => Number(actor[field.name] ?? 0));
+    }
+
+    return JSON.stringify({ [key]: rows });
   }
 
   // ***** игровой тик ***** //
@@ -247,4 +260,21 @@ export default class FakeGameCore {
 
     this._actors = new Map(entries);
   }
+
+  // ***** расширение (этап 4 плана plugin-forward-compat) ***** //
+
+  // самоописание: фикстура представляет ядро текущего поколения, поэтому
+  // отвечает так же, как раскрытие движкового макроса
+  abi_describe() {
+    return JSON.stringify({ abi: 1, core: 'fixture', ops: ['debug.json'] });
+  }
+
+  // опкод вместо нового символа: пустой ответ — «не обработан»
+  dispatch(op) {
+    if (op === 'debug.json') {
+      return new TextEncoder().encode(this.debug_json());
+    }
+
+    return new Uint8Array(0);
+  }
 }