vimp-engine 0.29.0 → 0.30.1

package/core/Cargo.toml

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

package/src/client/style.css

@@ -442,7 +442,6 @@ body.hide-cursor {
   text-shadow: 1px 1px 1px #000;
   font-size: 12px;
   line-height: 15px;
-  border-radius: 4px;
 }
 
 .card h2 {
@@ -546,21 +545,27 @@ body.hide-cursor {
 #auth-link {
   font-size: 9px;
   margin: 0;
-  padding: 0 10px;
+  padding: 0 5px;
 }
 
 #lobby-footer {
-  width: calc(var(--lobby-width) + var(--lobby-panel-pad));
   font-size: 10px;
   padding: 0;
-  margin: 0 calc(var(--lobby-panel-pad) / 2) 0 0;
+}
+
+#lobby-footer p {
+  margin: 0 5px;
+}
+
+#lobby-footer p:not(:last-child)::after {
+  content: '|';
+  padding-left: 10px;
 }
 
 /* три равные ячейки: середину держит не space-between, а сама равность —
    любая из крайних бывает пустой (у пакета игры может не быть метаданных),
    и при space-between версия съезжала бы с центра */
-#auth-link p,
-#lobby-footer p {
+#auth-link p {
   margin: 0;
   flex: 1;
 }
@@ -888,7 +893,8 @@ body.hide-cursor {
      колонку не нужно: с ним align-items: center увёл бы его влево на
      половину поля */
   #lobby-footer {
-    margin: 0 auto;
+    justify-content: flex-end;
+    width: calc(var(--lobby-width) + var(--lobby-panel-pad) * 2);
   }
 
   /* в столбик высоту строкой никто не задаёт — возвращаем слой в поток,

package/src/devtools/contract/rules/c4-component-dependencies.js

@@ -9,6 +9,11 @@ import { SERVICES } from '../../../config/clientServices.js';
 // assetsBase выглядит как чистый холст без единой строки в консоли, ради
 // этого правило и существует. Правило остаётся ERROR: оно работает на этапе
 // разработки игры, а не в рантайме.
+//
+// Что именно возвращает `hooks.services(core)`, статически не видно — хук
+// требует живого ядра. Поэтому у плагина есть необязательное поле
+// `serviceNames`: объявленный список имён снимает догадку, и правило снова
+// умеет краснеть (без него оно опускается до WARN и пропускает опечатку).
 export { SERVICES };
 
 export default {
@@ -24,16 +29,39 @@ export default {
       return skip('no client parts.componentDependencies');
     }
 
+    const declared = ctx.clientPlugin?.serviceNames;
+    const listed = Array.isArray(declared) ? declared : [];
+
+    if (declared !== undefined && !Array.isArray(declared)) {
+      return verdict([
+        `ClientPlugin.serviceNames is ${typeof declared}, expected an array ` +
+          'of service names returned by hooks.services(core)',
+      ]);
+    }
+
     // раскладка «сервис → парты, которым он нужен» (client.js игры)
     const unknown = Object.keys(deps).filter(
-      service => !SERVICES.includes(service),
+      service => !SERVICES.includes(service) && !listed.includes(service),
     );
 
     if (unknown.length === 0) {
       return verdict([]);
     }
 
-    const pool = SERVICES.join(', ');
+    const pool = [...SERVICES, ...listed].join(', ');
+
+    // список игровых сервисов объявлен — гадать больше не о чем: имя вне
+    // объединённого пула не даст парту ничего, кроме undefined
+    if (listed.length) {
+      return verdict(
+        unknown.map(
+          service =>
+            `componentDependencies declares service "${service}" — neither ` +
+            `the engine nor ClientPlugin.serviceNames provides it (${pool}), ` +
+            'so it is silently undefined in the part',
+        ),
+      );
+    }
     // hooks.services(core) требует живой инстанс ядра, а игровой код чекер не
     // запускает — статически перечислить игровые сервисы нечем. Поэтому при
     // объявленном хуке имя вне движкового пула остаётся строкой отчёта, но

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

@@ -140,9 +140,27 @@ function checkMap(name, map, violations) {
         `${at}: ramp ${index} tile ${ramp?.tile} is missing from ` +
           `level ${from} grid`,
       );
+      continue;
+    }
+
+    // 9. рампа, ведущая в пустоту: за верхним концом прогона обязана быть
+    // поверхность уровня `to`. Иначе танк доезжает до вершины и в тот же шаг
+    // срывается вниз — молча, потому что и подъём, и падение штатные правила
+    for (const [x, y] of rampRunExits(fromGrid ?? [], ramp?.tile, ramp?.dir)) {
+      if (!walkable(map, to, x, y)) {
+        violations.push(
+          `${at}: ramp ${index} run ends at (${x}, ${y}), which is not ` +
+            `walkable ground of level ${to}`,
+        );
+      }
     }
   }
 
+  // 10. край плиты без перил — обрыв; приземлиться с него нужно на
+  // проходимую землю, иначе танк уезжает за карту (стены уровня 0 плите не
+  // преграда) или приземляется внутри стены
+  checkLevelEdges(at, map, violations);
+
   // 6. точка респауна: [x, y, angle] либо [x, y, angle, level]
   for (const [team, points] of Object.entries(map.respawns ?? {})) {
     for (const [index, point] of (points ?? []).entries()) {
@@ -176,6 +194,136 @@ function checkMap(name, map, violations) {
   }
 }
 
+// --- геометрия уровней (зеркало vimp_engine_core::map::validate_levels) ---
+
+function cellAt(grid, x, y) {
+  if (x < 0 || y < 0) {
+    return undefined;
+  }
+
+  return grid?.[y]?.[x];
+}
+
+// земля проходима, если клетка есть в гриде и её тайл не объявлен стеной
+function groundWalkable(map, x, y) {
+  const tile = cellAt(map.map ?? [], x, y);
+
+  return tile !== undefined && !(map.physicsStatic ?? []).includes(tile);
+}
+
+function walkable(map, level, x, y) {
+  if (level === 0) {
+    return groundWalkable(map, x, y);
+  }
+
+  const cfg = (map.levels ?? {})[String(level)];
+
+  if (!cfg) {
+    return false;
+  }
+
+  const tile = cellAt(cfg.map ?? [], x, y);
+
+  return (
+    tile !== undefined &&
+    (cfg.floor ?? []).includes(tile) &&
+    !(cfg.walls ?? []).includes(tile)
+  );
+}
+
+// клетки, следующие за верхними концами прогонов рампы (прогон —
+// непрерывная линия одинаковых тайлов вдоль оси рампы)
+function rampRunExits(grid, tile, dir) {
+  const sign = dir === 'south' || dir === 'east' ? 1 : -1;
+  const vertical = dir === 'north' || dir === 'south';
+  const out = [];
+
+  if (vertical) {
+    const cols = Math.max(0, ...grid.map(row => row.length));
+
+    for (let x = 0; x < cols; x += 1) {
+      let y = 0;
+
+      while (y < grid.length) {
+        if (grid[y][x] !== tile) {
+          y += 1;
+          continue;
+        }
+
+        const y0 = y;
+
+        while (y < grid.length && grid[y][x] === tile) {
+          y += 1;
+        }
+
+        out.push([x, sign > 0 ? y : y0 - 1]);
+      }
+    }
+
+    return out;
+  }
+
+  grid.forEach((row, y) => {
+    let x = 0;
+
+    while (x < row.length) {
+      if (row[x] !== tile) {
+        x += 1;
+        continue;
+      }
+
+      const x0 = x;
+
+      while (x < row.length && row[x] === tile) {
+        x += 1;
+      }
+
+      out.push([sign > 0 ? x : x0 - 1, y]);
+    }
+  });
+
+  return out;
+}
+
+const NEIGHBOURS = [[1, 0], [-1, 0], [0, 1], [0, -1]];
+
+function checkLevelEdges(at, map, violations) {
+  for (const [key, level] of Object.entries(map.levels ?? {})) {
+    const floor = level?.floor ?? [];
+    const walls = level?.walls ?? [];
+    const grid = level?.map ?? [];
+
+    grid.forEach((row, y) => {
+      row.forEach((tile, x) => {
+        // перила закрывают край сами; клетка вне плиты краем не бывает
+        if (!floor.includes(tile) || walls.includes(tile)) {
+          return;
+        }
+
+        for (const [dx, dy] of NEIGHBOURS) {
+          const nx = x + dx;
+          const ny = y + dy;
+          const neighbour = cellAt(grid, nx, ny);
+
+          if (neighbour !== undefined && floor.includes(neighbour)) {
+            continue;
+          }
+
+          if (groundWalkable(map, nx, ny)) {
+            continue;
+          }
+
+          violations.push(
+            `${at}: level ${key} floor cell (${x}, ${y}) has an open edge ` +
+              `at (${nx}, ${ny}) with no walkable ground below — close it ` +
+              'with a wall tile',
+          );
+        }
+      });
+    });
+  }
+}
+
 function checkLayerFrames(at, where, layers, spriteSheet, violations) {
   const frames = spriteSheet?.frames;
 

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

@@ -0,0 +1,79 @@
+import { ERROR, skip, verdict } from '../result.js';
+
+// Радар рисует стены не из физики, а из рендер-слоя: парт слоя берётся за
+// работу, только если его тайл-лист (`layers`) называет хотя бы один тайл из
+// `physicsStatic`/`walls`. Карта, где тайл стены не назван ни в одном слое,
+// физически стены имеет, а на радаре — нет, и ни одной строки в консоли при
+// этом не появляется. Правило безвредно для карты без `layers`: проверять
+// тогда нечего.
+export default {
+  id: 'E5',
+  name: 'mapRadarWalls',
+  level: ERROR,
+  title: 'solid tiles are named by a render layer',
+
+  check(ctx) {
+    const maps = ctx.gameConfig?.maps;
+
+    if (!maps) {
+      return skip('no gameConfig.maps');
+    }
+
+    const violations = [];
+    let checked = 0;
+
+    for (const [name, map] of Object.entries(maps)) {
+      checked += checkMap(`map "${name}"`, map, violations);
+    }
+
+    if (!checked) {
+      return skip('no map declares render layers');
+    }
+
+    return verdict(violations);
+  },
+};
+
+/**
+ * @param {string} at - Человекочитаемое место нарушения.
+ * @param {Object} map - Карта из gameConfig.maps.
+ * @param {Array<string>} violations - Копилка нарушений.
+ * @returns {number} Сколько гридов удалось проверить (0 — слоёв нет).
+ */
+function checkMap(at, map, violations) {
+  let checked = 0;
+
+  checked += checkGrid(at, 'level 0', map?.layers, map?.physicsStatic, violations);
+
+  for (const [key, level] of Object.entries(map?.levels ?? {})) {
+    checked += checkGrid(
+      at,
+      `level ${key}`,
+      level?.layers,
+      level?.walls,
+      violations,
+    );
+  }
+
+  return checked;
+}
+
+function checkGrid(at, where, layers, solid, violations) {
+  if (!layers || !Object.keys(layers).length) {
+    return 0;
+  }
+
+  const named = new Set(Object.values(layers).flat());
+
+  for (const tile of solid ?? []) {
+    if (!named.has(tile)) {
+      violations.push(
+        `${at}: ${where} solid tile ${tile} is not named by any render ` +
+          'layer — MapRadar draws walls only from a layer that lists a ' +
+          'solid tile, so the wall silently disappears from the radar',
+      );
+    }
+  }
+
+  return 1;
+}

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

@@ -33,6 +33,7 @@ import e1 from './e1-sound-pairs.js';
 import e2 from './e2-map-images.js';
 import e3 from './e3-sound-registry.js';
 import e4 from './e4-map-layers.js';
+import e5 from './e5-map-radar-walls.js';
 
 // Порядок групп — порядок отчёта: A пакет и сборка, B host, C client,
 // D снапшот, E ассеты (plan/create-vimp-game/stage_1.md).
@@ -41,7 +42,7 @@ export const rules = [
   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,
+  e1, e2, e3, e4, e5,
 ];
 
 export default rules;

package/src/lib/coreConfig.js

@@ -34,6 +34,7 @@ export const buildCoreConfig = (gameConfig, overrides = {}) => {
     weapons,
     playerKeys: gameConfig.playerKeys,
     panel: gameConfig.panel.fields,
+    coreParams: gameConfig.coreParams,
     // keys — игровая схема (gameConfig.snapshot); version/port — движковые
     snapshot: {
       version: SNAPSHOT_FORMAT_VERSION,
@@ -57,7 +58,7 @@ export const buildCoreConfig = (gameConfig, overrides = {}) => {
       // валидирует — он лишь довозит их до `GameSim::new`. Известные ключи
       // ниже перекрывают одноимённые, чтобы игра не могла подменить
       // движковую часть контракта
-      ...(gameConfig.coreParams || {}),
+      ...(flat.coreParams || {}),
       friendlyFire: flat.friendlyFire,
       models: flat.models,
       weapons: flat.weapons,

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

@@ -48,8 +48,16 @@ export default {
       // имя файла — инертные данные: фикстура host-only, рендера в ней нет
       // и картинку никто не грузит. Реальные тайлы везёт пакет игры
       // (`${assetsBase}img/`), движок картинок не раздаёт
-      spriteSheet: { img: 'fixture-tiles.png', frames: [[0, 0, 32, 32]] },
-      layers: { 1: [0] },
+      spriteSheet: {
+        img: 'fixture-tiles.png',
+        frames: [
+          [0, 0, 32, 32],
+          [32, 0, 32, 32],
+        ],
+      },
+      // тайл стены обязан быть назван рендер-слоем: радар рисует стены
+      // только из слоя, который их перечисляет (правило E5)
+      layers: { 1: [0, 1] },
       physicsStatic: [1],
       physicsDynamic: [],
       step: 32,