vimp-engine 0.38.0 → 0.38.2

package/src/client/main.js

@@ -70,6 +70,10 @@ import FpsMeter from './lib/FpsMeter.js';
 import HostUnloadGuard from './lib/hostUnloadGuard.js';
 import { createPageReload } from './lib/pageReload.js';
 import { createAuthApi } from './lib/authApi.js';
+import {
+  decideSessionStorageChange,
+  decideStoredSession,
+} from './lib/sessionSync.js';
 import { createVerifier, challengeOf } from './lib/pkce.js';
 import { createTurnstile } from './lib/turnstile.js';
 import TokenRenewer from './network/TokenRenewer.js';
@@ -930,7 +934,8 @@ socketMethods[PS_GAME_INFORM_DATA] = data => {
 };
 
 // проигрывает shimmer-волну по логотипу в начале раунда; логотип живёт вне
-// PanelView.containerId, поэтому панель им не управляет (см. docs/en/client.md)
+// PanelView.containerId, поэтому панель им не управляет
+// (см. docs.vimp.lgick.dev/en/client-api)
 const playLogoRoundStart = () => {
   const logo = document.getElementById('logo');
 
@@ -2178,8 +2183,8 @@ let roomFormFields = new Map();
 let roomFormDescriptors = [];
 
 // генерирует форму создания комнаты по явной схеме манифеста (roomForm,
-// docs/en/plugin-api.md "Form schema") — движок не выводит контролы из типа
-// значения, схема плагина полностью описывает форму
+// docs.vimp.lgick.dev/en/plugin-api "Form schema") — движок не выводит контролы
+// из типа значения, схема плагина полностью описывает форму
 function populateRoomForm(manifest) {
   const container = document.getElementById(lobbyConfig.elems.fieldsId);
 
@@ -2469,8 +2474,8 @@ function initLobby() {
   const games = new GamesCtrl(gamesModel, gamesView);
 
   // кнопку «Moderation» лобби показывает роли admin (master-game-registry,
-  // этап 4). Это подсказка интерфейсу: доступ к данным проверяет мастер, а
-  // запись — auth-сервис, перечитывая роль из БД
+  // этап 4). Это подсказка интерфейсу: права админа auth-сервис проверяет
+  // сам, по нику из VIMP_ADMIN_NICKS
   games.setAdmin(lobbyAuthModel.getRole() === 'admin');
 
   // журнал клиентских ошибок (plan/client-reports, этап 5): кнопку «Errors»
@@ -2565,13 +2570,13 @@ function initLobby() {
   hostBtn?.addEventListener('click', async () => {
     // валидация (pattern/required/min/max) — единственная граница
     // room-формы: она едет клиенту как JSON манифеста, JS-валидаторы
-    // (как в auth-форме) туда не сериализуются (docs/en/plugin-api.md
-    // "Form schema"); авторитетный клампинг всё равно в applyRoomOverrides.js
-    // (вызывается из host.worker.js при создании комнаты). Проверяем до
-    // активации игры: неверная форма не должна стоить загрузки плагина.
-    // arm() и рисует ошибки, и снимает фильтр «только тронутые поля»: клик —
-    // это ответ за форму целиком, включая поля, которых игрок не касался.
-    // Он же чистит блок, когда ошибок нет
+    // (как в auth-форме) туда не сериализуются
+    // (docs.vimp.lgick.dev/en/plugin-api "Form schema"); авторитетный клампинг
+    // всё равно в applyRoomOverrides.js (вызывается из host.worker.js при
+    // создании комнаты). Проверяем до активации игры: неверная форма не должна
+    // стоить загрузки плагина. arm() и рисует ошибки, и снимает фильтр «только
+    // тронутые поля»: клик — это ответ за форму целиком, включая поля, которых
+    // игрок не касался. Он же чистит блок, когда ошибок нет
     if (liveErrors.arm().length) {
       return;
     }
@@ -2695,7 +2700,6 @@ if (isLobbyMode) {
   const tokenRenewer = new TokenRenewer({
     getExpiresAt: getTokenExpiresAt,
     renew: () => lobbyAuthModel.refresh(),
-    onLost: () => {},
     leadMs: authClientConfig.renew.leadMs,
     retryMs: authClientConfig.renew.retryMs,
   });
@@ -2765,6 +2769,44 @@ if (isLobbyMode) {
     diagnostics.warn('engine.session.profileGone', {}, { source: 'client' });
   });
 
+  // другая вкладка сменила личность браузера (регистрация, Restore, выход,
+  // удаление): вкладка вне комнаты перечитывает её перезагрузкой
+  window.addEventListener('storage', event => {
+    if (event.storageArea !== localStorage) {
+      return;
+    }
+
+    const action = decideSessionStorageChange({
+      event,
+      sessionKey: authClientConfig.sessionStorageKey,
+      currentSession: lobbyAuthModel.getSession(),
+      inRoom: Boolean(roomCtx.roomId),
+    });
+
+    if (action === 'reload') {
+      reloadPage();
+    }
+  });
+
+  // страница, восстановленная из bfcache (возврат кнопкой «Назад» от
+  // провайдера OAuth), событий storage не получала: личность сверяется с
+  // хранилищем заново
+  window.addEventListener('pageshow', event => {
+    if (!event.persisted) {
+      return;
+    }
+
+    const action = decideStoredSession({
+      storedSession: localStorage.getItem(authClientConfig.sessionStorageKey),
+      currentSession: lobbyAuthModel.getSession(),
+      inRoom: Boolean(roomCtx.roomId),
+    });
+
+    if (action === 'reload') {
+      reloadPage();
+    }
+  });
+
   // возврат с OAuth и dev-сессия прочитаны — чистим только query, hash
   // (маршрут #/<gameId>[/<roomId>]) остаётся
   if (lobbyAuthModel.takeUrlParams(window.location.search)) {

package/src/client/network/TokenRenewer.js

@@ -1,6 +1,7 @@
 // Тихое продление identity-токена: за leadMs до exp запрашивает свежий у
 // сессии устройства. Сбой сети — повтор через retryMs без ограничения числа
-// попыток: сеть вернётся — токен продлится.
+// попыток: сеть вернётся — токен продлится. Запуски идут не чаще раза в
+// retryMs, даже если срок остаётся в окне продления (цикла не будет).
 //
 // Без DOM: срок, продление и таймеры инъектирует владелец (client/main.js).
 
@@ -9,7 +10,6 @@ export default class TokenRenewer {
    * @param {Object} options
    * @param {Function} options.getExpiresAt - () → мс эпохи | null.
    * @param {Function} options.renew - () → Promise<'ok' | 'retry' | 'lost'>.
-   * @param {Function} options.onLost - сессия потеряна, продлевать нечем.
    * @param {number} options.leadMs
    * @param {number} options.retryMs
    * @param {Function} [options.now]
@@ -18,7 +18,6 @@ export default class TokenRenewer {
   constructor({
     getExpiresAt,
     renew,
-    onLost,
     leadMs,
     retryMs,
     now = () => Date.now(),
@@ -26,12 +25,12 @@ export default class TokenRenewer {
   }) {
     this._getExpiresAt = getExpiresAt;
     this._renew = renew;
-    this._onLost = onLost;
     this._leadMs = leadMs;
     this._retryMs = retryMs;
     this._now = now;
     this._timers = timers;
     this._timer = null;
+    this._lastFireAt = null;
   }
 
   // таймер на expiresAt - leadMs, но не раньше «сейчас»; срок неизвестен —
@@ -54,7 +53,17 @@ export default class TokenRenewer {
       return null;
     }
 
-    return Math.max(0, expiresAt - this._leadMs - this._now());
+    const now = this._now();
+    // не раньше retryMs после предыдущего запуска: срок, который и со
+    // свежим токеном остаётся в окне продления, не должен завести цикл.
+    // Сверху порог ограничен тем же retryMs: часы устройства могли перевести
+    // назад, и разность с прошлым запуском уже ничего не значит
+    const floor =
+      this._lastFireAt === null
+        ? 0
+        : Math.min(this._retryMs, this._lastFireAt + this._retryMs - now);
+
+    return Math.max(0, floor, expiresAt - this._leadMs - now);
   }
 
   _schedule(delay) {
@@ -69,6 +78,7 @@ export default class TokenRenewer {
 
   async _fire() {
     this._timer = null;
+    this._lastFireAt = this._now();
 
     let result;
 
@@ -83,8 +93,7 @@ export default class TokenRenewer {
       this.arm();
     } else if (result === 'retry') {
       this._schedule(this._retryMs);
-    } else {
-      this._onLost();
     }
+    // 'lost': таймер не взводится, потерю объявляет модель
   }
 }

package/src/client/network/WebSocketTransport.js

@@ -5,7 +5,7 @@ import Publisher from '../../lib/Publisher.js';
 // publisher с 'message'/'close', connect/send/close, — поэтому клиентский код
 // про него не знает.
 //
-// Отличия от WebRTC, которые надо держать в голове (см. docs/en/network.md):
+// Отличия от WebRTC, которые надо держать в голове:
 // разделения meta/state тут нет, флаг reliable игнорируется. Значит PING/PONG
 // идут надёжным каналом (замер RTT становится замером TCP-пути), а бэкпрешер
 // вместо дропа позиционных кадров живёт на серверной стороне.

package/src/client/session/Membership.js

@@ -85,7 +85,8 @@ export default class Membership {
   }
 
   // хватит ли срока входа на роль хоста: register_host/reclaim_host
-  // предъявляют токен мастеру посреди матча, а продления нет
+  // предъявляют токен мастеру посреди матча. Страховка на случай, когда
+  // тихое продление токена не удаётся
   tokenAllowsHostRole() {
     return tokenAllowsHosting(
       this._getTokenExpiresAt(),

package/src/client/style.css

@@ -589,6 +589,7 @@ body.hide-cursor {
    держится в одном месте (#lobby-footer лежит в секции lobby ниже только
    разметкой) */
 #auth-link,
+#lobby-auth-footer,
 #lobby-footer {
   height: 15px;
   text-shadow: none;
@@ -601,15 +602,18 @@ body.hide-cursor {
   padding: 0 5px;
 }
 
+#lobby-auth-footer,
 #lobby-footer {
   font-size: 10px;
   padding: 0;
 }
 
+#lobby-auth-footer p,
 #lobby-footer p {
   margin: 0 5px;
 }
 
+#lobby-auth-footer p:not(:last-child)::after,
 #lobby-footer p:not(:last-child)::after {
   content: '|';
   padding-left: 10px;
@@ -624,6 +628,7 @@ body.hide-cursor {
 }
 
 #auth-link p a,
+#lobby-auth-footer p a,
 #lobby-footer p a {
   color: #ff0;
 }
@@ -1117,16 +1122,20 @@ body.hide-cursor {
   margin: 8px auto;
 }
 
-#lobby-auth-legal,
-#lobby-auth-lifetime {
-  color: #aaa;
-  font-size: 11px;
-  line-height: 14px;
-  margin: 8px 0;
+/* виджет Turnstile шириной 300 px не влезает в карточку 256 px */
+#lobby-auth-welcome {
+  width: 300px;
 }
 
-#lobby-auth-legal a {
-  color: #ccc;
+#lobby-auth-turnstile {
+  display: flex;
+  justify-content: center;
+}
+
+/* футер вне рамки: по центру под карточкой */
+#lobby-auth-footer {
+  justify-content: center;
+  margin: 10px auto 0;
 }
 
 /* нейтральная плашка уведомления (профиль не найден, выход, удаление) */

package/src/client/views/includes/lobby.pug

@@ -32,7 +32,8 @@ div#lobby(style='display:none')
             label.form-label(for='lobby-game')= 'Select game'
             select#lobby-game.field-select
           //- поля настроек комнаты генерируются по явной схеме roomForm
-          //- манифеста активной игры (docs/en/plugin-api.md "Form schema")
+          //- манифеста активной игры (docs.vimp.lgick.dev/en/plugin-api "Form
+          //- schema")
           div#lobby-fields
           //- ошибки формы (formBuilder.renderFormErrors) и отказ загрузки
           //- плагина выбранной игры — строкой в форме, а не в #tech-informer:

package/src/client/views/includes/lobbyAuth.pug

@@ -9,24 +9,13 @@ div#lobby-auth
 
   div#lobby-auth-welcome.card(style='display:none')
     h2= 'Welcome to VIMP!'
-    p= 'Pick a nick and play. No e-mail or password needed.'
     p#lobby-auth-notice.form-notice
-    input#lobby-auth-nick-input.field-text(type='text', maxlength='14', placeholder='Your nick', autocomplete='off')
+    input#lobby-auth-nick-input.field-text(type='text', maxlength='15', placeholder='Your nick', autocomplete='off')
     div#lobby-auth-nick-error.form-error
     input#lobby-auth-turnstile-retry(type='button', value='Retry', style='display:none')
     //- контейнер виджета Turnstile: виден, только когда проверке нужен клик
     div#lobby-auth-turnstile
     input#lobby-auth-register(type='button', value='Create profile')
-    p#lobby-auth-legal
-      | By creating a profile you agree to the
-      |
-      a#lobby-auth-terms(target='_blank', rel='noopener') Terms of Service
-      |
-      | and the
-      |
-      a#lobby-auth-privacy(target='_blank', rel='noopener') Privacy Policy
-      | .
-    p#lobby-auth-lifetime
     hr.lobby-divider
     input#lobby-auth-restore(type='button', value='Restore profile')
     div#lobby-auth-providers(style='display:none')
@@ -35,3 +24,14 @@ div#lobby-auth
       input.lobby-auth-provider(type='button', data-provider='discord', value='Continue with Discord')
       input.lobby-auth-provider(type='button', data-provider='github', value='Continue with GitHub')
     div#lobby-auth-restore-error.form-error
+
+  //- футер под карточкой Welcome: ссылки заполняет LobbyAuthView,
+  //- версию движка — он же (engineVersion.js)
+  div#lobby-auth-footer(style='display:none')
+    p
+      a#lobby-auth-terms(target='_blank', rel='noopener') Terms of Service
+      |  ·
+      |
+      a#lobby-auth-privacy(target='_blank', rel='noopener') Privacy Policy
+    p#lobby-auth-version
+    p © #{new Date().getFullYear()} VIMP

package/src/config/authClient.js

@@ -1,7 +1,6 @@
 // Конфиг клиента профиля лобби. Бандлится в клиентскую сборку, как
 // config/lobby.js — auth-сервис живёт на отдельном домене/порте, поэтому
-// serviceUrl подставляется под конкретный деплой при сборке (см.
-// docs/en/auth.md).
+// serviceUrl подставляется под конкретный деплой при сборке.
 export default {
   // базовый URL центрального auth-сервиса (packages/auth). Дефолт — dev-порт
   // из packages/auth/src/config/auth.js; в проде подставляется Vite'ом из
@@ -59,6 +58,7 @@ export default {
     statusTextId: 'lobby-auth-status-text',
     statusRetryId: 'lobby-auth-status-retry',
     welcomeId: 'lobby-auth-welcome',
+    footerId: 'lobby-auth-footer',
     noticeId: 'lobby-auth-notice',
     nickInputId: 'lobby-auth-nick-input',
     nickErrorId: 'lobby-auth-nick-error',
@@ -67,7 +67,7 @@ export default {
     registerId: 'lobby-auth-register',
     termsId: 'lobby-auth-terms',
     privacyId: 'lobby-auth-privacy',
-    lifetimeId: 'lobby-auth-lifetime',
+    versionId: 'lobby-auth-version',
     restoreId: 'lobby-auth-restore',
     providersId: 'lobby-auth-providers',
     restoreErrorId: 'lobby-auth-restore-error',

package/src/config/gameCodes.js

@@ -1,6 +1,6 @@
 // коды игровых информ-сообщений (порт GAME_INFORM_DATA, см.
-// docs/en/network.md) — общий контракт хоста (SocketManager) и клиента
-// (main.js): значение не должно расходиться между ними молча
+// docs.vimp.lgick.dev/en/snapshot) — общий контракт хоста (SocketManager) и
+// клиента (main.js): значение не должно расходиться между ними молча
 export default {
   winnerTeam: [0],
   roundStart: [1],

package/src/config/lobby.js

@@ -213,7 +213,8 @@ export default {
   // подключён по WebRTC; при смене состава отчёт уходит сразу, с дебаунсом);
   // minTokenLifetimeMs — вкладка, чей вход истечёт раньше, не объявляет
   // canHost и отказывается от промоушена (токен предъявляется мастеру
-  // посреди матча, продления нет); tokenHandoffLeadMs — за столько до
+  // посреди матча; обычно его заранее продлевает TokenRenewer, порог работает,
+  // пока продление не удаётся); tokenHandoffLeadMs — за столько до
   // истечения входа хост с бетой сам передаёт роль (плановая передача на
   // границе раунда); tokenHandoffRetryMs — через сколько повторить её, если
   // беты ещё нет, идёт эстафета Worker'ов или передача сорвалась (повторы —
@@ -459,7 +460,6 @@ export default {
       closeBtnId: 'profile-close',
       nickId: 'profile-nick',
       statusId: 'profile-status',
-      linkCardId: 'profile-link',
       benefitsId: 'profile-link-benefits',
       providersId: 'profile-providers',
       consentId: 'profile-consent',
@@ -475,7 +475,6 @@ export default {
       sessionErrorId: 'profile-session-error',
       exportBtnId: 'profile-export',
       exportErrorId: 'profile-export-error',
-      deleteCardId: 'profile-delete',
       deleteAdminNoteId: 'profile-delete-admin',
       deleteStartBtnId: 'profile-delete-start',
       deleteConfirmId: 'profile-delete-confirm',

package/src/config/wsports.js

@@ -1,5 +1,5 @@
-// Номера портов JSON-канала (docs/en/network.md). Реестр append-only, как и
-// остальные словари плагинной поверхности (этап 3 плана
+// Номера портов JSON-канала (docs.vimp.lgick.dev/en/snapshot). Реестр
+// append-only, как и остальные словари плагинной поверхности (этап 3 плана
 // plugin-forward-compat): номер НИКОГДА не переиспользуется и не
 // перенумеровывается — уже опубликованная сборка игры шлёт и слушает те
 // номера, что видела при сборке, и её dist больше никто не тронет.

package/src/devtools/builtinScenario.js

@@ -13,8 +13,8 @@ import { isFixture } from './pluginLoader.js';
 // Ввод начинается на 40-м тике, а не сразу: кадр спавна с force_reset
 // приходит примерно на interpolation.delay (движковый дефолт — 100 мс, тут
 // ~3× запаса) позже входа и чистит удержанные клавиши предиктора
-// (docs/en/debugging.md) — встроенный сценарий не должен демонстрировать
-// ровно ту ловушку, от которой предостерегает документация
+// (docs.vimp.lgick.dev/en/debugging) — встроенный сценарий не должен
+// демонстрировать ровно ту ловушку, от которой предостерегает документация
 const INPUT_DOWN_TICK = 40;
 const INPUT_UP_TICK = 100;
 const TICKS = 120;
@@ -26,7 +26,7 @@ const FIXTURE_UNUSED_KEYS = ['e1'];
 const firstKey = dict => Object.keys(dict ?? {})[0];
 
 // Клавиша для смоука обязана быть удерживаемой: по конвенции playerKeys
-// (docs/en/plugin-api.md) `type: 1` — триггер, у которого 'up'
+// (docs.vimp.lgick.dev/en/plugin-api) `type: 1` — триггер, у которого 'up'
 // игнорируется, и «нажал — отпустил» не даёт ни удержания, ни движения.
 // Порядок объявления в playerKeys контрактом не задан, поэтому берём первую
 // без type; если игра объявила одни триггеры — первую любую, смоук всё равно

package/src/devtools/contract/rules/a2-package-scripts.js

@@ -1,8 +1,9 @@
 import { ERROR, skip, verdict } from '../result.js';
 
-// Набор npm-скриптов пакета игры (docs/en/packaging.md). Это не вкусовое
-// требование: инструкции движка и CI сгенерированной игры зовут их по имени,
-// а отсутствующий core:build:node тихо оставляет headless-прогон без ядра.
+// Набор npm-скриптов пакета игры (docs.vimp.lgick.dev/en/packaging). Это не
+// вкусовое требование: инструкции движка и CI сгенерированной игры зовут их по
+// имени, а отсутствующий core:build:node тихо оставляет headless-прогон без
+// ядра.
 const REQUIRED = [
   'build',
   'build:client',

package/src/devtools/contract/rules/a4-vite-config.js

@@ -2,9 +2,10 @@ import { ERROR, skip, verdict } from '../result.js';
 
 // vite.config.js проверяется как текст, а не импортом: конфиг —
 // функция от mode и вне Vite не исполняется. Каждый пункт здесь ловит
-// молчаливую поломку сборки, а не стилистику (docs/en/packaging.md):
-// без preserveEntrySignatures default-экспорт плагина вытряхивает
-// tree-shaking, а build.lib всегда инлайнит ассеты.
+// молчаливую поломку сборки, а не стилистику
+// (docs.vimp.lgick.dev/en/packaging): без preserveEntrySignatures
+// default-экспорт плагина вытряхивает tree-shaking, а build.lib всегда инлайнит
+// ассеты.
 const REQUIRED = [
   [/emptyOutDir\s*:\s*false/, 'emptyOutDir: false (two builds share dist/)'],
   [/assetsInlineLimit\s*:\s*0/, 'assetsInlineLimit: 0'],

package/src/devtools/contract/rules/a7-package-repository.js

@@ -1,16 +1,17 @@
 import { WARN, skip, verdict } from '../result.js';
 import { resolveProjectUrl } from '../../../lib/packageLink.js';
 
-// Игра без объявленного репозитория собирается и играется — это не отказ.
-// Но движок показывает ссылку на проект в футере формы входа, и берёт он её
-// только отсюда (фолбэка нет, см. lib/packageLink.js): без поля ячейка
-// футера у игроков останется пустой, а заметить это без подсказки негде.
+// Игра без объявленного homepage/repository собирается и играется — это не
+// отказ. Но движок показывает ссылку на проект в футере формы входа, и берёт
+// он её только из этих полей (фолбэка нет, см. lib/packageLink.js): без них
+// ячейка футера у игроков останется пустой, а заметить это без подсказки негде.
 // Отсюда warn — под --strict он становится ошибкой.
 export default {
   id: 'A7',
   name: 'packageRepository',
   level: WARN,
-  title: 'package.json declares repository (the #auth footer links to it)',
+  title:
+    'package.json declares homepage or repository (the #auth footer links to it)',
 
   check(ctx) {
     if (!ctx.pkg) {

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

@@ -4,11 +4,11 @@ import { SERVICES } from '../../../config/clientServices.js';
 // Движковый пул сервисов держит реестр (config/clientServices.js), но пул
 // ими не исчерпывается: игра доливает туда свои через
 // ClientPlugin.hooks.services(core) — например геометрию предсказанной
-// динамики карты (docs/en/plugin-api.md «hooks.services»). Незнакомое имя не
-// ошибка для движка: part получает undefined и рисует пустоту — карта без
-// assetsBase выглядит как чистый холст без единой строки в консоли, ради
-// этого правило и существует. Правило остаётся ERROR: оно работает на этапе
-// разработки игры, а не в рантайме.
+// динамики карты (docs.vimp.lgick.dev/en/plugin-api «hooks.services»).
+// Незнакомое имя не ошибка для движка: part получает undefined и рисует пустоту
+// — карта без assetsBase выглядит как чистый холст без единой строки в консоли,
+// ради этого правило и существует. Правило остаётся ERROR: оно работает на
+// этапе разработки игры, а не в рантайме.
 //
 // Что именно возвращает `hooks.services(core)`, статически не видно — хук
 // требует живого ядра. Поэтому у плагина есть необязательное поле

package/src/devtools/invariants.js

@@ -484,7 +484,7 @@ function predictionDrift({ clients, scenario }) {
 // Компоненты player-блока — игровая раскладка, движок знает только их
 // порядок, поэтому нарушение адресуется индексом. Исключение — уровень 0
 // (source 'camera'): там движок сравнивает ровно мировые x/y, и называть их
-// «#0/#1» значит прятать причину (см. docs/en/debugging.md).
+// «#0/#1» значит прятать причину (см. docs.vimp.lgick.dev/en/debugging).
 const CAMERA_COMPONENTS = ['x', 'y'];
 
 function formatDivergence(record) {

package/src/devtools/pluginLoader.js

@@ -12,9 +12,9 @@ import { loadGamePackage } from '../lib/loadGamePackage.js';
 //   3. ничего         — фикстура miniGame из этого репозитория.
 //
 // entries.wasmNode — новое ОПЦИОНАЛЬНОЕ поле манифеста: конвенция
-// core/pkg-node/ уже описана в docs/en/packaging.md, не хватало только
-// пути в манифесте. Его отсутствие не ошибка — просто игра не прогоняется
-// headless своим настоящим ядром.
+// core/pkg-node/ уже описана в docs.vimp.lgick.dev/en/packaging, не хватало
+// только пути в манифесте. Его отсутствие не ошибка — просто игра не
+// прогоняется headless своим настоящим ядром.
 
 const FIXTURE_DIR = new URL('../../tests/fixtures/miniGame/', import.meta.url);
 

package/src/host/PortMachine.js

@@ -1,9 +1,10 @@
 // Хендшейк-машина клиента, вынутая из host.worker.js: автомат по клиентским
-// портам 0–10 (см. docs/en/network.md). Изоморфна — ни self, ни postMessage,
-// ни DOM: всё, что знает про транспорт, приходит через makeSocket. Поэтому её
-// крутит и Worker браузерного хоста, и inline-хост standalone SDK, и
-// Node-процесс dedicated-сервера: копий автомата быть не должно, иначе они
-// разъедутся ровно так, как разъезжались бы копии createHostRuntime.
+// портам (таблица портов — docs.vimp.lgick.dev/en/snapshot). Изоморфна — ни
+// self, ни postMessage, ни DOM: всё, что знает про транспорт, приходит через
+// makeSocket. Поэтому её крутит и Worker браузерного хоста, и inline-хост
+// standalone SDK, и Node-процесс dedicated-сервера: копий автомата быть не
+// должно, иначе они разъедутся ровно так, как разъезжались бы копии
+// createHostRuntime.
 
 import wsports from '../config/wsports.js';
 import closeCodes from '../config/closeCodes.js';

package/src/lib/loadGamePackage.js

@@ -12,7 +12,7 @@ import { ENGINE_CAPABILITIES } from './capabilities.js';
 // должен зависеть от отладочного контура (граница из CLAUDE.md).
 //
 // entries.wasmNode — node-сборка ядра игры (конвенция core/pkg-node,
-// docs/en/packaging.md). Для боевой игры она обязательна: без ядра
+// docs.vimp.lgick.dev/en/packaging). Для боевой игры она обязательна: без ядра
 // авторитетную симуляцию крутить нечем.
 
 /**

package/src/lib/packageLink.js

@@ -1,7 +1,7 @@
 // Ссылка на проект для футеров лобби и формы входа: движок показывает рядом
-// npm-версию, и клик по соседней ячейке ведёт в репозиторий этого пакета.
+// npm-версию, и клик по соседней ячейке ведёт на страницу проекта этого пакета.
 //
-// Источник — `repository` его package.json (иначе `homepage`). Фолбэка нет:
+// Источник — `homepage` его package.json (иначе `repository`). Фолбэка нет:
 // пакет, не объявивший ни того, ни другого, ссылки не получает, и ячейка
 // футера остаётся пустой. Это сознательно — прежний фолбэк на страницу пакета
 // в npm давал разнобой («GitHub» у одной игры, «npm» у другой) и молча
@@ -16,8 +16,8 @@
 // (client/lib/engineVersion.js).
 
 /**
- * Адрес проекта из package.json, приведённый к https: repository, иначе
- * homepage.
+ * Адрес проекта из package.json, приведённый к https: homepage, иначе
+ * repository.
  * @param {Object} pkg - разобранный package.json
  * @returns {string|null} https-URL либо null, если поля нет или это не адрес
  */
@@ -32,10 +32,10 @@ export function resolveProjectUrl(pkg) {
   const declared =
     typeof repository === 'string' ? repository : repository?.url;
 
-  // объявленный, но не приводящийся к http(s) repository (пустая строка,
-  // внутренний git-хост) не повод терять валидный homepage: поле проверяется
-  // по результату, а не по факту наличия
-  return normalizeRepository(declared) ?? normalize(homepage);
+  // homepage важнее repository: поле repository обязано называть
+  // репозиторий публикации (его сверяет npm Trusted Publishing), и у пакета
+  // из закрытого репозитория такая ссылка отдаёт игроку 404
+  return normalize(homepage) ?? normalizeRepository(declared);
 }
 
 /**
@@ -94,8 +94,9 @@ function normalize(raw) {
 
   url = url.replace(/^git\+/, '');
 
-  // scp-форма git@host:user/repo — двоеточие здесь разделитель, не порт
-  const scp = /^git@([^:/]+):(.+)$/.exec(url);
+  // scp-форма git@host:user/repo (в том числе с лишним ssh://, как её
+  // нередко пишет npm) — двоеточие здесь разделитель, не порт
+  const scp = /^(?:ssh:\/\/)?git@([^:/]+):(.+)$/.exec(url);
 
   if (scp) {
     url = `https://${scp[1]}/${scp[2]}`;

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/en/client.md, «Error reporting»). По
+ *   ошибок (`POST`, формат — docs.vimp.lgick.dev/en/standalone). По
  *   умолчанию `null`: в solo нет бокса, и отчёты не отправляются.
  * @returns {Promise<Object>} `{ stop() }` — останов матча.
  */
@@ -71,10 +71,10 @@ export async function startStandaloneGame({
   // возможность, которой в этой сборке движка нет, иначе всплыла бы где-то
   // в середине хендшейка непрозрачной ошибкой. Мастера тут нет, а значит нет
   // и GameManifest с его `requires` — источником служат сами половины
-  // плагина (необязательное поле `requires`, docs/en/plugin-api.md) либо
-  // опция вызова, если встраивающий знает лучше. Одна проверка вместо двух:
-  // сообщение адресовано разработчику встраивания, делить его по половинам
-  // незачем
+  // плагина (необязательное поле `requires`, docs.vimp.lgick.dev/en/plugin-api)
+  // либо опция вызова, если встраивающий знает лучше. Одна проверка вместо
+  // двух: сообщение адресовано разработчику встраивания, делить его по
+  // половинам незачем
   requireCompatible({
     id: hostPlugin.id,
     // mergeRequires, а не спред: строка вместо массива ('accolades' —