vimp-engine 0.39.0 → 0.41.0

package/src/lib/loadGamePackage.js

@@ -6,13 +6,11 @@ import { ENGINE_CAPABILITIES } from './capabilities.js';
 
 // Загрузка пакета игры в Node по его собранному dist/ (Этап 4 плана
 // standalone-sdk). В браузере плагин грузится по URL из GameManifest мастера;
-// в Node URL-ов нет — оба Node-контура (headless-runner devtools/pluginLoader.js
-// и dedicated-сервер) читают манифест с диска и импортируют половины плагина
-// как обычные модули. Модуль живёт в lib/, а не в devtools/: прод-сервер не
-// должен зависеть от отладочного контура (граница из CLAUDE.md).
+// в Node URL-ов нет — headless-runner (devtools/pluginLoader.js) читает
+// манифест с диска и импортирует половины плагина как обычные модули.
 //
 // entries.wasmNode — node-сборка ядра игры (конвенция core/pkg-node,
-// docs.vimp.lgick.dev/en/packaging). Для боевой игры она обязательна: без ядра
+// VIMP docs: packaging.md). Для боевой игры она обязательна: без ядра
 // авторитетную симуляцию крутить нечем.
 
 /**
@@ -33,7 +31,7 @@ export async function loadGamePackage(
   { core = null, client = 'lazy' } = {},
 ) {
   // манифест под нестандартным именем нужен headless-прогону (--game
-  // <path>/manifest-variant.json); dedicated-сервер всегда даёт каталог
+  // <path>/manifest-variant.json)
   const manifestPath = distDir.endsWith('.json')
     ? path.resolve(distDir)
     : path.join(path.resolve(distDir), 'manifest.json');
@@ -58,8 +56,8 @@ export async function loadGamePackage(
   );
 
   // Клиентская половина в Node нужна только виртуальным клиентам
-  // headless-прогона; dedicated-сервер её не касается вовсе (в браузер она
-  // едет статикой, и pixi.js там резолвится import map'ом). Грузить её
+  // headless-прогона (в браузер она едет статикой, и pixi.js там
+  // резолвится import map'ом). Грузить её
   // безусловно значило бы требовать от игры самодостаточной клиентской
   // сборки — а правило контракта A1 держит pixi.js внешним намеренно.
   //
@@ -160,7 +158,7 @@ function assertPluginMatchesManifest(manifest, plugins) {
 // лобби честно отвергается, а в solo-режиме тихо недоигрывает.
 //
 // Здесь это ПРЕДУПРЕЖДЕНИЕ, а не отказ, и разница принципиальная. Node-путь
-// (dedicated, vimp-sim, inline host) читает авторитетный манифест, и его
+// (vimp-sim, inline host) читает авторитетный манифест, и его
 // совместимость уже проверена выше (checkPluginCompatibility): рассинхрон с
 // половинами ничего здесь не ломает. Бросить значило бы отвергнуть пакет,
 // который грузился раньше, — прямое нарушение И4 плана

package/src/lib/offlinePlayerData.js

@@ -1,5 +1,5 @@
 // Профиль участника в контуре без мастера и auth-сервиса (headless-прогон,
-// standalone SDK, dedicated-сервер). Это не заглушка ради тишины: пустой
+// standalone SDK). Это не заглушка ради тишины: пустой
 // профиль и есть корректное состояние такого матча, а настоящий fetch по
 // относительному URL вне браузерной вкладки просто не разрешается.
 

package/src/lib/validators.js

@@ -24,8 +24,8 @@ export const isValidNick = nick =>
 // потолок длины поля формы, когда maxlength в дескрипторе не объявлен.
 // regExp игры исполняется на хосте против строки, которую прислал клиент, и
 // катастрофический паттерн вроде "(a+)+b" превращает три десятка символов в
-// минуты заблокированного event loop — а хост это либо Worker с авторитетным
-// матчем (замирает комната целиком), либо процесс dedicated. 256 — с запасом
+// минуты заблокированного event loop — а хост это Worker с авторитетным
+// матчем (замирает комната целиком). 256 — с запасом
 // на любое поле auth-формы (ник, имя модели): длиннее не бывает у формы и не
 // нужно тому, кто её обошёл
 const MAX_FIELD_LENGTH = 256;

package/src/lib/voicePacket.js

@@ -7,7 +7,7 @@ import {
 } from '../config/voiceProtocol.js';
 
 // Кодек голосового пакета (раскладка — config/voiceProtocol.js). Изоморфный:
-// им пользуются клиент и ретранслятор вкладки хоста (dedicated голоса не имеет).
+// им пользуются клиент и ретранслятор вкладки хоста.
 
 const isByte = value => Number.isInteger(value) && value >= 0 && value <= 0xff;
 

package/src/standalone/index.js

@@ -44,7 +44,7 @@ import { ensureGameShell } from '../client/views/gameShell.js';
  * @param {boolean} [options.devMode] - room.isDevMode: рекордер и хостовый
  *   CONSOLE-лог.
  * @param {string|null} [options.reportUrl] - Адрес приёма журнала клиентских
- *   ошибок (`POST`, формат — docs.vimp.lgick.dev/en/standalone). По
+ *   ошибок (`POST`, формат — VIMP docs: standalone.md). По
  *   умолчанию `null`: в solo нет бокса, и отчёты не отправляются.
  * @returns {Promise<Object>} `{ stop() }` — останов матча.
  */
@@ -71,7 +71,8 @@ export async function startStandaloneGame({
   // возможность, которой в этой сборке движка нет, иначе всплыла бы где-то
   // в середине хендшейка непрозрачной ошибкой. Мастера тут нет, а значит нет
   // и GameManifest с его `requires` — источником служат сами половины
-  // плагина (необязательное поле `requires`, docs.vimp.lgick.dev/en/plugin-api)
+  // плагина (необязательное поле `requires`,
+  // VIMP docs: plugin-api.md § "requires and engine capabilities")
   // либо опция вызова, если встраивающий знает лучше. Одна проверка вместо
   // двух: сообщение адресовано разработчику встраивания, делить его по
   // половинам незачем

package/src/client/lib/footerLink.js

@@ -1,30 +0,0 @@
-// Ссылка на документацию в футере формы входа игры. Показывается только в
-// dev-сборке: разработчик игры при локальном запуске видит, где читать
-// документацию, а игрок на проде — нет. Футер лобби несёт ту же ссылку
-// статичной разметкой (lobby.pug). Тот же адрес — литералом в lobby.pug и в
-// `homepage` пакета; совпадение сторожит tests/client/footerLink.test.js.
-export const DOCS_URL = 'https://docs.vimp.lgick.dev';
-
-/**
- * @param {HTMLAnchorElement|null} anchor - якорь футера
- * @param {boolean} enabled - true только в dev-сборке
- */
-export function renderDocsLink(anchor, enabled) {
-  if (!anchor) {
-    return;
-  }
-
-  if (!enabled) {
-    anchor.textContent = '';
-    anchor.removeAttribute('href');
-    anchor.removeAttribute('target');
-    anchor.removeAttribute('rel');
-
-    return;
-  }
-
-  anchor.textContent = 'docs';
-  anchor.href = DOCS_URL;
-  anchor.target = '_blank';
-  anchor.rel = 'noopener';
-}

package/src/client/network/WebSocketTransport.js

@@ -1,78 +0,0 @@
-import Publisher from '../../lib/Publisher.js';
-
-// Третий транспорт клиента (Этап 2 плана standalone-sdk): прямой WebSocket к
-// dedicated-серверу. Интерфейсный близнец WebRtcManager и LoopbackTransport —
-// publisher с 'message'/'close', connect/send/close, — поэтому клиентский код
-// про него не знает.
-//
-// Отличия от WebRTC, которые надо держать в голове:
-// разделения meta/state тут нет, флаг reliable игнорируется. Значит PING/PONG
-// идут надёжным каналом (замер RTT становится замером TCP-пути), а бэкпрешер
-// вместо дропа позиционных кадров живёт на серверной стороне.
-
-// WebSocket.OPEN: константа класса, а не инстанса — у фейкового сокета в
-// тестах её может не быть вовсе
-const WS_OPEN = 1;
-
-export default class WebSocketTransport {
-  /**
-   * @param {string} url - Адрес игрового WebSocket.
-   * @param {Object} [options]
-   * @param {Function} [options.socketFactory] - Фабрика сокета (тесты).
-   */
-  constructor(url, { socketFactory = u => new WebSocket(u) } = {}) {
-    this._url = url;
-    this._socketFactory = socketFactory;
-    this._ws = null;
-    this._closed = false;
-
-    this.publisher = new Publisher();
-  }
-
-  connect() {
-    this._ws = this._socketFactory(this._url);
-
-    // обязательно: клиент различает кадр снапшота и JSON-порт по
-    // `data instanceof ArrayBuffer`, а дефолтный браузерный WS отдаёт Blob
-    this._ws.binaryType = 'arraybuffer';
-
-    this._ws.onopen = () => this.publisher.emit('open');
-    this._ws.onmessage = event => this.publisher.emit('message', event.data);
-    // код закрытия уезжает подписчику: политические отказы сервера (лимит
-    // подключений, таймаут хендшейка) клиент лечить перезагрузкой не должен —
-    // см. handleDisconnect в main.js
-    this._ws.onclose = event => this._emitClose(event?.code);
-    // ошибка сокета всегда сопровождается close — отдельного события наружу
-    // не даём, иначе клиент погасил бы матч дважды
-    this._ws.onerror = () => {};
-  }
-
-  /**
-   * @param {string|ArrayBuffer} data - Кадр.
-   * @param {boolean} [reliable] - Игнорируется: у WebSocket нет уровней
-   *   надёжности, всё едет надёжно и по порядку.
-   */
-  send(data) {
-    if (this._ws && this._ws.readyState === WS_OPEN) {
-      this._ws.send(data);
-    }
-  }
-
-  close() {
-    if (this._closed) {
-      return;
-    }
-
-    this._ws?.close();
-    this._emitClose();
-  }
-
-  _emitClose(code) {
-    if (this._closed) {
-      return;
-    }
-
-    this._closed = true;
-    this.publisher.emit('close', code);
-  }
-}