vimp-engine 0.8.0 → 0.10.0

package/src/devtools/contract/rules/d1-snapshot-ids.js

@@ -0,0 +1,36 @@
+import { ERROR, skip, verdict } from '../result.js';
+
+// Уникальность id блоков — единственное, что вообще валидируется в
+// снапшот-схеме. Дубликат означает, что один блок кадра разбирается
+// схемой другого: мусор вместо ошибки.
+export default {
+  id: 'D1',
+  name: 'snapshotIds',
+  level: ERROR,
+  title: 'snapshot block ids are unique',
+
+  check(ctx) {
+    const snapshot = ctx.gameConfig?.snapshot;
+
+    if (!snapshot) {
+      return skip('no gameConfig.snapshot');
+    }
+
+    const byId = new Map();
+    const violations = [];
+
+    for (const [key, block] of Object.entries(snapshot)) {
+      const previous = byId.get(block.id);
+
+      if (previous !== undefined) {
+        violations.push(
+          `snapshot id ${block.id} is used by both "${previous}" and "${key}"`,
+        );
+      } else {
+        byId.set(block.id, key);
+      }
+    }
+
+    return verdict(violations);
+  },
+};

package/src/devtools/contract/rules/d2-snapshot-classes.js

@@ -0,0 +1,42 @@
+import { ERROR, skip, verdict } from '../result.js';
+
+// Горячий буфер несёт только indexed8/indexedNoNull8; list16 и indexed32
+// приходят через take_frames() и обязаны быть class: 'event' — иначе кадр
+// не считается надёжным и может быть выброшен ненадёжным каналом.
+const HOT_KINDS = ['indexed8', 'indexedNoNull8'];
+const EVENT_KINDS = ['list16', 'indexed32'];
+
+export default {
+  id: 'D2',
+  name: 'snapshotClasses',
+  level: ERROR,
+  title: "class 'hot' only on indexed8/indexedNoNull8 blocks",
+
+  check(ctx) {
+    const snapshot = ctx.gameConfig?.snapshot;
+
+    if (!snapshot) {
+      return skip('no gameConfig.snapshot');
+    }
+
+    const violations = [];
+
+    for (const [key, block] of Object.entries(snapshot)) {
+      if (block.class === 'hot' && !HOT_KINDS.includes(block.kind)) {
+        violations.push(
+          `snapshot "${key}": kind "${block.kind}" cannot be class 'hot' ` +
+            `(hot buffer carries ${HOT_KINDS.join(' / ')})`,
+        );
+      }
+
+      if (EVENT_KINDS.includes(block.kind) && block.class !== 'event') {
+        violations.push(
+          `snapshot "${key}": kind "${block.kind}" must be class 'event', ` +
+            `got "${block.class}" — the frame is not classified as reliable`,
+        );
+      }
+    }
+
+    return verdict(violations);
+  },
+};

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

@@ -0,0 +1,45 @@
+import { ERROR, skip, verdict } from '../result.js';
+
+// Интерполируются только f32 и только в горячих блоках. interp на u8 или
+// в event-блоке не ошибка сборки — он просто не исполняется, и поле
+// дёргается вместо плавного движения.
+export default {
+  id: 'D3',
+  name: 'snapshotInterp',
+  level: ERROR,
+  title: "interp only on f32 fields of class 'hot' blocks",
+
+  check(ctx) {
+    const snapshot = ctx.gameConfig?.snapshot;
+
+    if (!snapshot) {
+      return skip('no gameConfig.snapshot');
+    }
+
+    const violations = [];
+
+    for (const [key, block] of Object.entries(snapshot)) {
+      for (const field of block.fields ?? []) {
+        if (field.interp === undefined) {
+          continue;
+        }
+
+        if (block.class !== 'hot') {
+          violations.push(
+            `snapshot "${key}".${field.name}: interp on a class ` +
+              `"${block.class}" block is never applied`,
+          );
+        }
+
+        if (field.ty !== 'f32') {
+          violations.push(
+            `snapshot "${key}".${field.name}: interp on ty "${field.ty}" — ` +
+              'only f32 interpolates',
+          );
+        }
+      }
+    }
+
+    return verdict(violations);
+  },
+};

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

@@ -0,0 +1,40 @@
+import { ERROR, skip, verdict } from '../result.js';
+
+// Клиент перебирает codecList ['webm', 'mp3'] и берёт первый поддержанный
+// браузером. Отсутствующий .mp3 не ломает Chrome и ломает Safari — то есть
+// проявляется у части игроков и никогда у автора.
+export default {
+  id: 'E1',
+  name: 'soundPairs',
+  level: ERROR,
+  title: 'every declared sound ships as a webm + mp3 pair',
+
+  check(ctx) {
+    const sounds = ctx.clientConfig?.parts?.sounds?.sounds;
+
+    if (!ctx.distFiles) {
+      return skip('not built — no dist/');
+    }
+
+    if (!sounds) {
+      return skip('no sound registry');
+    }
+
+    const violations = [];
+
+    for (const [name, sound] of Object.entries(sounds)) {
+      const file = sound?.file ?? name;
+
+      for (const codec of ctx.clientConfig.parts.sounds.codecList ?? [
+        'webm',
+        'mp3',
+      ]) {
+        if (!ctx.distFiles.has(`sounds/${file}.${codec}`)) {
+          violations.push(`sound "${name}": dist/sounds/${file}.${codec} is missing`);
+        }
+      }
+    }
+
+    return verdict(violations);
+  },
+};

package/src/devtools/contract/rules/e2-map-images.js

@@ -0,0 +1,40 @@
+import { ERROR, skip, verdict } from '../result.js';
+
+// Тайл-лист и картинки динамических тел везёт пакет игры (dist/img/),
+// движок игровых картинок не раздаёт. Карта, назвавшая отсутствующий
+// файл, падает молча в рантайме: полотно пустое, консоль чистая.
+export default {
+  id: 'E2',
+  name: 'mapImages',
+  level: ERROR,
+  title: 'map images exist in dist/img/',
+
+  check(ctx) {
+    const maps = ctx.gameConfig?.maps;
+
+    if (!ctx.distFiles) {
+      return skip('not built — no dist/');
+    }
+
+    if (!maps) {
+      return skip('no gameConfig.maps');
+    }
+
+    const violations = [];
+
+    for (const [name, map] of Object.entries(maps)) {
+      const images = [
+        map?.spriteSheet?.img,
+        ...(map?.physicsDynamic ?? []).map(body => body?.img),
+      ].filter(Boolean);
+
+      for (const img of new Set(images)) {
+        if (!ctx.distFiles.has(`img/${img}`)) {
+          violations.push(`map "${name}": dist/img/${img} is missing`);
+        }
+      }
+    }
+
+    return verdict(violations);
+  },
+};

package/src/devtools/contract/rules/e3-sound-registry.js

@@ -0,0 +1,25 @@
+import { WARN, skip, verdict } from '../result.js';
+
+// Игра без единого звука собирается и играется — это законная стадия
+// разработки, а не отказ. Но пустой реестр почти всегда означает
+// «забыли», поэтому warn: под --strict он становится ошибкой.
+export default {
+  id: 'E3',
+  name: 'soundRegistry',
+  level: WARN,
+  title: 'the sound registry is not empty',
+
+  check(ctx) {
+    if (!ctx.distFiles) {
+      return skip('not built — no dist/');
+    }
+
+    const sounds = ctx.clientConfig?.parts?.sounds?.sounds;
+
+    if (sounds && Object.keys(sounds).length) {
+      return verdict([]);
+    }
+
+    return verdict(['no sounds are registered in client parts.sounds']);
+  },
+};

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

@@ -0,0 +1,44 @@
+import a1 from './a1-package-fields.js';
+import a2 from './a2-package-scripts.js';
+import a3 from './a3-entry-paths.js';
+import a4 from './a4-vite-config.js';
+import a5 from './a5-cargo-core.js';
+import a6 from './a6-manifest.js';
+import b1 from './b1-host-shape.js';
+import b2 from './b2-engine-api.js';
+import b3 from './b3-game-config-shape.js';
+import b4 from './b4-teams.js';
+import b5 from './b5-room-form.js';
+import b6 from './b6-panel-reserved-key.js';
+import b7 from './b7-chat-commands.js';
+import b8 from './b8-system-messages.js';
+import b9 from './b9-vote-names.js';
+import b10 from './b10-respawns.js';
+import c1 from './c1-client-shape.js';
+import c2 from './c2-parts-registered.js';
+import c3 from './c3-game-sets-coverage.js';
+import c4 from './c4-component-dependencies.js';
+import c5 from './c5-panel-time-field.js';
+import c6 from './c6-stat-columns.js';
+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 d1 from './d1-snapshot-ids.js';
+import d2 from './d2-snapshot-classes.js';
+import d3 from './d3-snapshot-interp.js';
+import e1 from './e1-sound-pairs.js';
+import e2 from './e2-map-images.js';
+import e3 from './e3-sound-registry.js';
+
+// Порядок групп — порядок отчёта: A пакет и сборка, B host, C client,
+// D снапшот, E ассеты (plan/create-vimp-game/stage_1.md).
+export const rules = [
+  a1, a2, a3, a4, a5, a6,
+  b1, b2, b3, b4, b5, b6, b7, b8, b9, b10,
+  c1, c2, c3, c4, c5, c6, c7, c8, c9, c10,
+  d1, d2, d3,
+  e1, e2, e3,
+];
+
+export default rules;

package/src/host/meta/player/ParticipantManager.js

@@ -242,6 +242,12 @@ class ParticipantManager {
   get isFull() {
     return this._maxPlayers ? this.totalCount >= this._maxPlayers : false;
   }
+
+  // потолок комнаты: игре он нужен, чтобы ограничивать пользовательский
+  // ввод до цикла (`/spawn 1e9`), а не упираться в isFull на каждой итерации
+  get maxPlayers() {
+    return this._maxPlayers;
+  }
 }
 
 export default ParticipantManager;

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

@@ -8,6 +8,10 @@ export default {
       // parts; setId карты (m1) — по нему создаётся статика полотна
       a1: ['Actor'],
       m1: ['Actor'],
+      // event-ключ схемы: строк он в фикстуре не даёт, но запись нужна —
+      // ключ снапшота без набора партов это чёрный холст на первом же
+      // кадре, где он ожил
+      e1: ['Actor'],
     },
     entitiesOnCanvas: {
       Actor: 'vimp',
@@ -35,8 +39,12 @@ export default {
 
     controls: {
       keySetList: [
-        // spectator keyset (пусто — у фикстуры нет наблюдательных команд)
-        {},
+        // spectator keyset: переключение камеры — механизм движка
+        // (hostDefaults.spectatorKeys), без него наблюдатель заперт
+        {
+          78: 'nextPlayer', // next player (n)
+          80: 'prevPlayer', // prev player (p)
+        },
         // player keyset
         {
           87: 'forward', // forward (w)

package/tests/fixtures/miniGame/config/game.js

@@ -45,15 +45,23 @@ export default {
     arena: {
       setId: 'm1',
       scale: 1,
-      spriteSheet: { img: 'tiles.png', frames: [[0, 0, 32, 32]] },
+      // имя файла — инертные данные: фикстура host-only, рендера в ней нет
+      // и картинку никто не грузит. Реальные тайлы везёт пакет игры
+      // (`${assetsBase}img/`), движок картинок не раздаёт
+      spriteSheet: { img: 'fixture-tiles.png', frames: [[0, 0, 32, 32]] },
       layers: { 1: [0] },
       physicsStatic: [1],
       physicsDynamic: [],
       step: 32,
+      // точек не меньше, чем roomDefaults.maxPlayers: длина списка —
+      // жёсткая вместимость команды на карте (RoundManager), и комната
+      // молча вмещала бы меньше, чем обещает лобби
       respawns: {
         team1: [
           [100, 100, 0],
           [200, 100, 0],
+          [100, 200, 0],
+          [200, 200, 0],
         ],
       },
       map: [