vimp-engine 0.38.2 → 0.39.0

package/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "vimp-engine-core"
-version = "0.23.3"
+version = "0.23.4"
 edition = "2024"
 description = "VIMP engine simulation core: physics, map, snapshot framing, interpolation/prediction/raycast primitives, navigation utilities. No wasm-bindgen — the game crate builds the WASM ABI wrappers."
 license = "MIT"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vimp-engine",
-  "version": "0.38.2",
+  "version": "0.39.0",
   "description": "VIMP engine SDK: browser host and client runtime, standalone mode and CLI tools (vimp-sim, vimp-contract) for VIMP game plugins",
   "license": "MIT",
   "repository": {
@@ -35,6 +35,8 @@
     "!src/client/_*",
     "src/standalone",
     "src/devtools",
+    "!src/devtools/surface/abiParse.js",
+    "!src/devtools/surface/collect.js",
     "tests/fixtures",
     "core/Cargo.toml",
     "bin",

package/src/client/InputListener.js

@@ -20,6 +20,9 @@ export default class InputListener {
       this.publisher.emit('keyUp', event),
     );
 
+    // keyup за пределами окна не приходит — эфир залип бы до таймаута
+    window.addEventListener('blur', () => this.publisher.emit('blur'));
+
     const emitMouse = () => this.publisher.emit('mouseAction');
 
     window.addEventListener('mouseup', emitMouse);

package/src/client/SoundManager.js

@@ -892,6 +892,19 @@ export default class SoundManager {
     }
   }
 
+  /**
+   * Выход Web Audio движка для голосовой связи: контекст Howler и его master
+   * gain. Голос подчиняется общей громкости и mute (скрытая вкладка, пауза
+   * миграции).
+   * @returns {{ ctx: AudioContext, destination: AudioNode } | null} null —
+   *   Web Audio недоступен.
+   */
+  getAudioOutput() {
+    return Howler.usingWebAudio && Howler.ctx && Howler.masterGain
+      ? { ctx: Howler.ctx, destination: Howler.masterGain }
+      : null;
+  }
+
   /**
    * Выключает все звуки.
    */

package/src/client/boot.js

@@ -11,8 +11,14 @@
 // window не вводим: они переживают перезагрузку бандла и ломают вторую
 // вкладку SDK в том же документе.
 
+import {
+  bodyReadFailure,
+  fetchRetrying,
+  isNetworkFailure,
+} from './lib/retryOnNetworkError.js';
+
 // эндпоинт режима: его отдаёт dedicated-сервер, у мастера его нет —
-// 404/сеть/мусор означают прод-лобби (обратная совместимость)
+// 404 и мусор означают прод-лобби; сбой сети — отказ загрузки
 const CONFIG_URL = '/config';
 
 // умолчание игрового WS dedicated-сервера: тот же хост, путь /game
@@ -65,23 +71,40 @@ export function resetBootConfig() {
 /**
  * Разрешает режим загрузки: инъекция SDK → GET /config → лобби.
  * @param {Function} [fetchImpl] - Реализация fetch (тесты подставляют свою).
- * @returns {Promise<Object>} Конфиг загрузки.
+ * @param {Object} [retry] - Параметры fetchRetrying (тесты отключают паузы).
+ * @returns {Promise<Object>} Конфиг загрузки; отклоняется NetworkFailure, если
+ *   сеть не ответила после повторов.
  */
-export async function resolveBootConfig(fetchImpl) {
+export async function resolveBootConfig(fetchImpl, retry) {
   if (bootConfig) {
     return bootConfig;
   }
 
   const doFetch = fetchImpl ?? ((...args) => fetch(...args));
+  let res = null;
 
   try {
-    const res = await doFetch(CONFIG_URL);
+    res = await fetchRetrying(doFetch, CONFIG_URL, retry);
+  } catch (e) {
+    // сети нет: режим неизвестен, и лобби здесь — догадка, а не факт
+    if (isNetworkFailure(e)) {
+      throw e;
+    }
+  }
 
-    if (res.ok) {
+  if (res?.ok) {
+    try {
       bootConfig = normalize(await res.json());
+    } catch (e) {
+      // мусор в JSON — лобби; обрыв при чтении тела — сбой сети
+      const failure = bodyReadFailure(e);
+
+      if (isNetworkFailure(failure)) {
+        throw failure;
+      }
+
+      bootConfig = null;
     }
-  } catch (e) {
-    // сети/эндпоинта нет — это и есть прод-лобби, шуметь не о чем
   }
 
   bootConfig = bootConfig ?? { mode: 'lobby' };

package/src/client/components/controller/ClientReports.js

@@ -2,7 +2,7 @@
 
 let clientReportsCtrl;
 
-// Контроллер журнала клиентских ошибок (plan/client-reports, этап 5):
+// Контроллер журнала клиентских ошибок:
 // связывает view-события с моделью, собственного сетевого I/O не делает
 export default class ClientReportsCtrl {
   constructor(model, view) {

package/src/client/components/controller/Controls.js

@@ -54,6 +54,16 @@ export default class ControlsCtrl {
     this._model.resendHeld();
   }
 
+  // назначает клавишу связи (push-to-talk)
+  setPushToTalk(keyCode) {
+    this._model.setPushToTalk(keyCode);
+  }
+
+  // отпускает связь (потеря фокуса, скрытая вкладка)
+  releasePtt() {
+    this._model.releasePtt();
+  }
+
   // скрывает курсор
   resetCursorHideTimer() {
     this._view.resetCursorHideTimer();

package/src/client/components/controller/Games.js

@@ -95,7 +95,7 @@ export default class GamesCtrl {
   }
 
   approve({ id }) {
-    this._model.moderate(id, { status: 'approved' });
+    this._model.approve(id);
   }
 
   reject({ id, note }) {

package/src/client/components/controller/Voice.js

@@ -0,0 +1,31 @@
+// Singleton VoiceCtrl
+
+let voiceCtrl;
+
+export default class VoiceCtrl {
+  constructor(model, view) {
+    if (voiceCtrl) {
+      return voiceCtrl;
+    }
+
+    voiceCtrl = this;
+
+    this._model = model;
+    this._view = view;
+  }
+
+  // состояние своего эфира
+  showOwn(kind, data) {
+    this._model.showOwn(kind, data);
+  }
+
+  // чужой эфир (null — скрыть)
+  setIncoming(speaker) {
+    this._model.setIncoming(speaker);
+  }
+
+  destroy() {
+    this._model.destroy();
+    this._view.destroy();
+  }
+}

package/src/client/components/model/ClientReports.js

@@ -4,7 +4,7 @@ import Publisher from '../../../lib/Publisher.js';
 
 let clientReportsModel;
 
-// Модель журнала клиентских ошибок в лобби (plan/client-reports, этап 5):
+// Модель журнала клиентских ошибок в лобби:
 // страницы журнала, фильтры и решение админа по строке. Как GamesModel,
 // сетевые запросы делает сама (простой REST к мастеру) и DOM не трогает.
 // Наружу — одно событие 'changed' с полным состоянием: список, счётчик,

package/src/client/components/model/Controls.js

@@ -2,6 +2,17 @@ import Publisher from '../../../lib/Publisher.js';
 
 // Singleton ControlsModel
 
+// keyCode самих модификаторов: Ctrl, Alt, Meta (два кода и Firefox)
+const MODIFIER_CODES = new Set([17, 18, 91, 93, 224]);
+
+// фокус в поле ввода: клавиша печатает букву
+function isEditableTarget(target) {
+  return (
+    target?.isContentEditable === true ||
+    ['INPUT', 'TEXTAREA', 'SELECT'].includes(target?.tagName)
+  );
+}
+
 let controlsModel;
 
 export default class ControlsModel {
@@ -25,6 +36,8 @@ export default class ControlsModel {
     // возобновления сессии должен знать, что игрок держит на самом деле
     this._heldCodes = new Set();
     this._areKeysEnabled = false; // статус возможности нажатия клавиш
+    this._pttKey = null; // keyCode клавиши связи, null — связи нет
+    this._pttHeld = false;
 
     // канал указателя: игра, не объявившая modules.controls.pointer, его не
     // получает вовсе — ни одного лишнего сообщения по проводу
@@ -79,6 +92,34 @@ export default class ControlsModel {
         this.publisher.emit('mode', mode);
       }
     } else {
+      // Cmd, нажатый при уже зажатой клавише связи: её keyup на macOS не
+      // придёт — эфир отпускается сразу
+      if (event.metaKey && this._pttHeld && keyCode !== this._pttKey) {
+        this.releasePtt();
+      }
+
+      // клавиша связи никогда не уходит в игру командой. Автоповтор keydown
+      // игнорируется — удержание и так длится до keyup. Фокус в поле ввода
+      // (любом, не только в строке чата) — клавиша печатает букву. С
+      // Ctrl/Cmd/Alt — системная комбинация (вставка), не связь: на macOS при
+      // Cmd keyup обычной клавиши не приходит и связь залипла бы
+      // Сам модификатор может быть клавишей связи: его keydown несёт свой флаг
+      if (
+        keyCode === this._pttKey &&
+        (MODIFIER_CODES.has(keyCode) ||
+          !(event.ctrlKey || event.metaKey || event.altKey)) &&
+        !isEditableTarget(event.target)
+      ) {
+        event.preventDefault();
+
+        if (!event.repeat && !this._pttHeld) {
+          this._pttHeld = true;
+          this.publisher.emit('ptt', true);
+        }
+
+        return;
+      }
+
       // если клавиша ещё не зажата
       if (!this._pressedKeys[keyCode]) {
         const name = this._currentKeySet[keyCode];
@@ -111,6 +152,11 @@ export default class ControlsModel {
 
     this._heldCodes.delete(keyCode);
 
+    // отпускание засчитывается всегда, без проверки цели
+    if (keyCode === this._pttKey && this._pttHeld) {
+      this.releasePtt();
+    }
+
     // если клавиша была зажата
     if (this._pressedKeys[keyCode]) {
       const name = this._currentKeySet[keyCode];
@@ -131,6 +177,10 @@ export default class ControlsModel {
     if (status === 'opened') {
       this._currentModes[mode] = true;
 
+      if (mode === 'chat') {
+        this.releasePtt();
+      }
+
       // иначе змейка так и ехала бы к последней точке, пока игрок набирает
       // сообщение в чат
       this._releasePointer(this._lastTapX, this._lastTapY);
@@ -260,6 +310,20 @@ export default class ControlsModel {
 
     if (isEnabled === false) {
       this._releasePointer(this._lastTapX, this._lastTapY);
+      this.releasePtt();
+    }
+  }
+
+  // клавиша связи (push-to-talk); null выключает
+  setPushToTalk(keyCode) {
+    this._pttKey = keyCode ?? null;
+  }
+
+  // отпускает связь (клавиша вверх, потеря фокуса, чат, запрет ввода)
+  releasePtt() {
+    if (this._pttHeld) {
+      this._pttHeld = false;
+      this.publisher.emit('ptt', false);
     }
   }
 }

package/src/client/components/model/Games.js

@@ -222,6 +222,24 @@ export default class GamesModel {
     await this.loadAdmin();
   }
 
+  // одобрение называет заявку, которую модератор видит в карточке
+  // (this._all — то, что нарисовано): переподанная после загрузки очереди
+  // заявка вернёт 409 moderationStale
+  async approve(id) {
+    const game = this._all.find(item => item.id === id);
+
+    if (!game) {
+      this._fail('admin', { error: 'unknownGame' });
+      return;
+    }
+
+    await this.moderate(id, {
+      status: 'approved',
+      expectedPendingVersion: game.pendingVersion ?? null,
+      expectedPendingRepoUrl: game.pendingRepoUrl ?? null,
+    });
+  }
+
   async moderate(id, patch) {
     const { ok, json } = await this._request(this._config.urls.moderate(id), {
       method: 'PATCH',
@@ -229,6 +247,12 @@ export default class GamesModel {
     });
 
     if (!ok) {
+      // карточка устарела: показать свежую и только потом отказ — иначе
+      // перерисовка сотрёт его тем же тиком
+      if (json?.error === 'moderationStale') {
+        await this.loadAdmin();
+      }
+
       this._fail('admin', json);
       return;
     }

package/src/client/components/model/Voice.js

@@ -0,0 +1,96 @@
+import Publisher from '../../../lib/Publisher.js';
+
+// вспышка ошибки гаснет сама
+const ERROR_FLASH_MS = 1500;
+
+// Singleton VoiceModel
+
+let voiceModel;
+
+export default class VoiceModel {
+  /**
+   * @param {Object} data
+   * @param {Object} data.texts - CONFIG_DATA.voice.texts.
+   */
+  constructor({ texts }) {
+    if (voiceModel) {
+      return voiceModel;
+    }
+
+    voiceModel = this;
+
+    this._texts = texts ?? {};
+    // один таймер авто-скрытия: новый показ снимает прежний, иначе таймер
+    // старой ошибки погасил бы эфир, начатый после неё
+    this._timer = null;
+
+    // 'own' ({ kind, text, endsAt, totalMs }) и 'incoming' (speaker | null)
+    this.publisher = new Publisher();
+  }
+
+  /**
+   * Состояние своего эфира.
+   * @param {'hidden'|'talking'|'busy'|'cooldown'|'error'} kind
+   * @param {Object} [data] - talking: { endsAt, totalMs }, cooldown:
+   *   { endsAt }, error: { textKey }.
+   */
+  showOwn(kind, data = {}) {
+    this._clearTimer();
+
+    let text = '';
+    let endsAt = 0;
+    let totalMs = 0;
+
+    if (kind === 'busy') {
+      text = this._texts.busy ?? '';
+    } else if (kind === 'cooldown') {
+      text = this._texts.cooldown ?? '';
+      endsAt = data.endsAt;
+    } else if (kind === 'error') {
+      text = this._texts[data.textKey] ?? '';
+    } else if (kind === 'talking') {
+      endsAt = data.endsAt;
+      totalMs = data.totalMs;
+    }
+
+    this.publisher.emit('own', { kind, text, endsAt, totalMs });
+
+    if (kind === 'error') {
+      this._arm(ERROR_FLASH_MS);
+    } else if (kind === 'cooldown') {
+      this._arm(Math.max(0, endsAt - performance.now()));
+    }
+  }
+
+  /**
+   * Чужой эфир.
+   * @param {{ name: string, teamId: number|null, color: string|null }|null}
+   *   speaker - null скрывает.
+   */
+  setIncoming(speaker) {
+    this.publisher.emit('incoming', speaker);
+  }
+
+  destroy() {
+    this._clearTimer();
+  }
+
+  _arm(ms) {
+    this._timer = setTimeout(() => {
+      this._timer = null;
+      this.publisher.emit('own', {
+        kind: 'hidden',
+        text: '',
+        endsAt: 0,
+        totalMs: 0,
+      });
+    }, ms);
+  }
+
+  _clearTimer() {
+    if (this._timer !== null) {
+      clearTimeout(this._timer);
+      this._timer = null;
+    }
+  }
+}

package/src/client/components/model/Vote.js

@@ -1,4 +1,5 @@
 import Publisher from '../../../lib/Publisher.js';
+import { VOTE_ANSWER_KEYS } from '../../../config/voteKeys.js';
 
 // Singleton VoteModel
 
@@ -215,7 +216,7 @@ export default class VoteModel {
     }
 
     // если keyCode это число от 0 до 9
-    if (48 <= keyCode && keyCode <= 57) {
+    if (VOTE_ANSWER_KEYS[0] <= keyCode && keyCode <= VOTE_ANSWER_KEYS[1]) {
       number = String.fromCharCode(keyCode);
       number = parseInt(number, 10);
 

package/src/client/components/view/ClientReports.js

@@ -57,7 +57,7 @@ function truncate(text, max) {
   return text.length > max ? `${text.slice(0, max - 1)}…` : text;
 }
 
-// Представление журнала клиентских ошибок (plan/client-reports, этап 5).
+// Представление журнала клиентских ошибок.
 //
 // ***** БЕЗОПАСНОСТЬ *****
 //

package/src/client/components/view/Games.js

@@ -19,6 +19,9 @@ const ERROR_MESSAGES = {
   gameExists: 'A game with this id already exists',
   tooManyGames: 'Too many submissions from one author',
   unknownGame: 'Game is not in the registry',
+  // автор переподал заявку, пока модератор смотрел карточку
+  moderationStale:
+    'The request changed while you were reviewing it — check the refreshed card',
   gamePublished: 'Published game — ask an admin to disable it first',
   unknownUser: 'No player with this nick',
   invalidGameId: 'Invalid game id',
@@ -270,6 +273,7 @@ export default class GamesView {
       );
       item.appendChild(this._line(this._statusLine(game)));
       this._appendRepo(item, game.repoUrl);
+      this._appendPendingRepo(item, game);
 
       if (game.moderatorNote) {
         item.appendChild(this._line(`Note: ${game.moderatorNote}`));
@@ -390,6 +394,7 @@ export default class GamesView {
       ),
     );
     this._appendRepo(item, game.repoUrl);
+    this._appendPendingRepo(item, game);
     item.appendChild(
       this._line(
         `Served: ${game.version ?? '—'}; requested: ${game.pendingVersion ?? '—'}` +
@@ -460,7 +465,7 @@ export default class GamesView {
   // принимает только http(s): href — единственное место представления, где
   // содержимое поля становится исполняемым (javascript:), и полагаться на
   // одну проверку на другой стороне сети тут не стоит
-  _appendRepo(item, url) {
+  _appendRepo(item, url, prefix = '') {
     if (typeof url !== 'string' || !/^https?:\/\//i.test(url)) {
       return;
     }
@@ -472,10 +477,23 @@ export default class GamesView {
     link.textContent = url;
     link.target = '_blank';
     link.rel = 'noopener noreferrer';
+
+    if (prefix) {
+      line.append(prefix);
+    }
+
     line.appendChild(link);
     item.appendChild(line);
   }
 
+  // адрес, который версия на модерации принесёт при одобрении: строка
+  // появляется, только если он отличается от текущего
+  _appendPendingRepo(item, game) {
+    if (game.pendingRepoUrl && game.pendingRepoUrl !== game.repoUrl) {
+      this._appendRepo(item, game.pendingRepoUrl, 'After approval: ');
+    }
+  }
+
   _statusLine(game) {
     const status = STATUS_TITLES[game.status] ?? game.status;
     const date = game.createdAt

package/src/client/components/view/Lobby.js

@@ -1,6 +1,5 @@
 import Publisher from '../../../lib/Publisher.js';
-import { ENGINE_PROJECT_URL, ENGINE_VERSION } from '../../lib/engineVersion.js';
-import { renderProjectLink } from '../../lib/footerLink.js';
+import { ENGINE_VERSION } from '../../lib/engineVersion.js';
 import { absoluteLink, formatRoomLink } from '../../lib/roomLink.js';
 
 // Singleton LobbyView
@@ -65,11 +64,6 @@ export default class LobbyView {
       version.textContent = ENGINE_VERSION;
     }
 
-    renderProjectLink(
-      document.getElementById(elems.linkId),
-      ENGINE_PROJECT_URL,
-    );
-
     // заголовок игры для "<TITLE> TOP-N" (SVG-ориентир) — задаётся controller'ом
     // при выборе игры (сама модель не хранит title манифеста)
     this._gameTitle = '';