vimp-engine 0.15.0 → 0.17.0

package/core/Cargo.toml

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

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

@@ -1,4 +1,6 @@
 import Publisher from '../../../lib/Publisher.js';
+import { ENGINE_PACKAGE, ENGINE_VERSION } from '../../lib/engineVersion.js';
+import { renderPackageLink } from '../../lib/footerLink.js';
 
 // Singleton LobbyView
 
@@ -34,6 +36,16 @@ export default class LobbyView {
     this._leaderboardTotal = document.getElementById(elems.leaderboardTotalId);
     this._myPlacement = document.getElementById(elems.myPlacementId);
 
+    // футер лобби: содержимое статично на всё время жизни вкладки, поэтому
+    // пишется здесь, а не через модель и publisher
+    const version = document.getElementById(elems.versionId);
+
+    if (version) {
+      version.textContent = ENGINE_VERSION;
+    }
+
+    renderPackageLink(document.getElementById(elems.linkId), ENGINE_PACKAGE);
+
     // заголовок игры для "<TITLE> TOP-N" (SVG-ориентир) — задаётся controller'ом
     // при выборе игры (сама модель не хранит title манифеста)
     this._gameTitle = '';

package/src/client/lib/engineVersion.js

@@ -0,0 +1,19 @@
+// Версия npm-пакета движка, запечённая в бандл на сборке: сети для неё нет
+// (у мастера нет version-эндпоинта), а лобби обязано показывать версию того
+// кода, который сейчас исполняется, а не того, что развёрнут на сервере.
+//
+// Модуль лежит в client/lib, а не в src/config: config/* импортирует мастер
+// под Node, а сюда тянется package.json пакета — он нужен только браузерному
+// бандлу (в npm-тарболле vimp-engine package.json есть всегда, поэтому
+// standalone SDK собирается у игры тем же импортом).
+import pkg from '../../../package.json' with { type: 'json' };
+import { homepageOf } from '../../lib/packageLink.js';
+
+export const ENGINE_VERSION = pkg.version;
+
+// метаданные для ссылки в футере лобби — та же форма, что мастер отдаёт про
+// пакет игры (GameCatalog), чтобы оба футера строил один resolvePackageLink
+export const ENGINE_PACKAGE = {
+  name: pkg.name,
+  homepage: homepageOf(pkg),
+};

package/src/client/lib/footerLink.js

@@ -0,0 +1,29 @@
+import { resolvePackageLink } from '../../lib/packageLink.js';
+
+// Ссылка в футере лобби и формы входа. Один рендер на оба экрана: лобби
+// подставляет пакет движка, форма входа — пакет игры из манифеста.
+//
+// Данных нет (standalone-манифест без метаданных пакета) — якорь гасится, а не
+// прячется: ячейка футера остаётся пустой, и раскладка space-between не едет.
+
+/**
+ * @param {HTMLAnchorElement|null} anchor - якорь футера
+ * @param {{name?: string, homepage?: string}|null} pkg - метаданные пакета
+ */
+export function renderPackageLink(anchor, pkg) {
+  if (!anchor) {
+    return;
+  }
+
+  const link = resolvePackageLink(pkg);
+
+  if (!link) {
+    anchor.textContent = '';
+    anchor.removeAttribute('href');
+
+    return;
+  }
+
+  anchor.textContent = link.label;
+  anchor.href = link.url;
+}

package/src/client/main.js

@@ -28,6 +28,7 @@ import VoteView from './components/view/Vote.js';
 import VoteCtrl from './components/controller/Vote.js';
 import { buildForm, mergeRoomDefaults, bindLiveErrors } from './lib/formBuilder.js';
 import { normalizeAuthParams } from './lib/authParams.js';
+import { renderPackageLink } from './lib/footerLink.js';
 import { createGameActivator } from './lib/gameActivator.js';
 import createAutostart from './lib/autostart.js';
 import { getBootConfig, resolveBootConfig } from './boot.js';
@@ -422,6 +423,22 @@ socketMethods[PS_AUTH_DATA] = data => {
 
   document.getElementById('logo').textContent = texts?.title || 'VIMP';
 
+  // футер формы входа: версия и ссылка пакета ИГРЫ. Здесь, а не в AuthView:
+  // его elems приходят из authSchema.elems игрового плагина, и футер каркаса
+  // — не его забота. Метаданные кладёт в манифест мастер (GameCatalog читает
+  // package.json пакета); в standalone-манифесте их может не быть — тогда
+  // ячейки пустые, раскладку space-between это не ломает
+  const authVersion = document.getElementById('auth-version');
+
+  if (authVersion) {
+    authVersion.textContent = activeGameManifest?.packageVersion ?? '';
+  }
+
+  renderPackageLink(document.getElementById('auth-package-link'), {
+    name: activeGameManifest?.packageName,
+    homepage: activeGameManifest?.packageHomepage,
+  });
+
   // память клиента (localStorage) + принудительное значение поля с
   // единственным вариантом. Здесь, а не в AuthView: solo-путь ниже отвечает
   // хосту вообще без формы и обязан прийти к тем же значениям

package/src/client/style.css

@@ -473,7 +473,12 @@ body.hide-cursor {
   margin: 4px auto;
 }
 
-#auth-link {
+/* футеры лобби и формы входа: одна и та же полоса из трёх ячеек —
+   ссылка на пакет, его версия, копирайт. Оба заполняет JS, поэтому вид
+   держится в одном месте (#lobby-footer лежит в секции lobby ниже только
+   разметкой) */
+#auth-link,
+#lobby-footer {
   font-size: 9px;
   height: 15px;
   margin: 0;
@@ -483,19 +488,31 @@ body.hide-cursor {
   justify-content: space-between;
 }
 
-#auth-link p {
+#auth-link p,
+#lobby-footer p {
   margin: 0;
 }
 
-#auth-link p a {
+#auth-link p a,
+#lobby-footer p a {
   color: #ff0;
 }
 
-#auth-link p:nth-child(1) {
+/* позициями заведует space-between, а не nth-child: любая из ячеек бывает
+   пустой (у пакета игры может не быть метаданных), и порядковые правила
+   тогда съезжали бы */
+#auth-link p:first-child,
+#lobby-footer p:first-child {
   text-align: left;
 }
 
-#auth-link p:nth-child(2) {
+#auth-version,
+#lobby-version {
+  text-align: center;
+}
+
+#auth-link p:last-child,
+#lobby-footer p:last-child {
   text-align: right;
 }
 
@@ -712,6 +729,14 @@ body.hide-cursor {
   color: #aaa;
 }
 
+/* колоночная обёртка панелей и футера: #lobby центрирует содержимое как
+   флекс-строка, поэтому футер обязан лежать в одном столбце с .lobby-grid,
+   а не быть её соседом */
+.lobby-column {
+  display: flex;
+  flex-direction: column;
+}
+
 /* два столбца лобби (lobby-page-plan): настройки/создание слева, вкладки
    Active Servers / Leaderboard справа; собственная ширина панелей
    переопределяет фиксированный .card { width:256px } (id сильнее класса);
@@ -768,6 +793,12 @@ body.hide-cursor {
   flex-shrink: 0;
 }
 
+/* полосу футера рисуют общие с #auth-link правила в секции auth; здесь —
+   только отступ от панелей */
+#lobby-footer {
+  margin: 6px 0 10px;
+}
+
 @media (max-width: 800px) {
   .lobby-grid {
     flex-direction: column;
@@ -775,6 +806,12 @@ body.hide-cursor {
     gap: unset;
   }
 
+  /* в столбик обёртка тянется на всю ширину: иначе она сжалась бы по
+     содержимому и увела бы панели из центра */
+  .lobby-column {
+    width: 100%;
+  }
+
   /* в столбик высоту строкой никто не задаёт — возвращаем слой в поток,
      иначе absolute-слой схлопнулся бы в 0 */
   .lobby-browser-inner {

package/src/client/views/gameShell.js

@@ -55,16 +55,10 @@ const SHELL = [
             tag: 'div',
             id: 'auth-link',
             children: [
-              {
-                tag: 'p',
-                children: [
-                  {
-                    tag: 'a',
-                    attrs: { href: 'https://github.com/lgick/vimp' },
-                    text: 'GitHub',
-                  },
-                ],
-              },
+              // ссылка и версия пакета ИГРЫ — заполняет main.js по AUTH_DATA
+              // из метаданных пакета в манифесте
+              { tag: 'p', children: [{ tag: 'a', id: 'auth-package-link' }] },
+              { tag: 'p', id: 'auth-version' },
               { tag: 'p', text: `© ${new Date().getFullYear()} VIMP` },
             ],
           },

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

@@ -15,6 +15,10 @@ div#auth
     div#auth-informs
 
     div#auth-link
+      //- ссылка и версия пакета ИГРЫ (мастер кладёт их в манифест, читая
+      //- package.json пакета) — проставляет main.js по AUTH_DATA; без данных
+      //- ячейки остаются пустыми
       p
-        a(href='https://github.com/lgick/vimp') GitHub
+        a#auth-package-link
+      p#auth-version
       p © #{new Date().getFullYear()} VIMP

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

@@ -1,54 +1,64 @@
 //- скрыт по умолчанию: открывается из main.js только после успешного логина
 //- в #lobby-auth (Этап B2, LobbyAuthCtrl 'authenticated')
 div#lobby(style='display:none')
-  div.lobby-grid
-    //- левая панель: профиль + форма создания комнаты (lobby-page-plan)
-    div#lobby-setup-panel.card
-      h2= 'VIMP'
-      //- бейдж входа (Этап B2): управляется LobbyAuthView, показывается
-      //- вместе с #lobby после успешной авторизации
-      div#lobby-user
-        div
-          span= 'Signed in as '
-          b#lobby-user-nick
-        input#lobby-user-logout(type='button', value='Sign out')
-      hr.lobby-divider
-      h3.lobby-section-title= 'HOST A GAME'
-      div#lobby-create
-        //- селектор игры (lobby-page-plan): рабочий с первой же игрой в
-        //- каталоге мастера, а не только когда их несколько
-        div.form-row
-          label.form-label(for='lobby-game')= 'Select Game'
-          select#lobby-game.field-select
-        div.form-row
-          label.form-label(for='lobby-name')= 'Server name'
-          input#lobby-name.field-text(type='text', maxlength='30')
-        //- поля настроек комнаты генерируются по явной схеме roomForm
-        //- манифеста активной игры (docs/en/plugin-api.md "Form schema")
-        div#lobby-fields
-        //- ошибки формы (formBuilder.renderFormErrors) и отказ загрузки
-        //- плагина выбранной игры — строкой в форме, а не в #tech-informer:
-        //- тот кроет вкладку непрозрачным слоем и рассчитан на терминальные
-        //- причины, а эти восстановимы (поправить поле, другая игра,
-        //- повторный клик). Над кнопкой — рядом с полями, к которым относятся
-        div#lobby-error.form-error
-        input#lobby-host(type='button', value='Create server')
-    //- правая панель: вкладки Active Servers / Leaderboard (lobby-page-plan)
-    div#lobby-browser-panel.card
-      //- абсолютный слой: высоту .card задаёт форма слева (stretch), а
-      //- список внутри скроллится, не раздувая карточку (lobby-page-plan)
-      div.lobby-browser-inner
-        div.lobby-tabs-header
-          input#btn-show-servers.lobby-tab-btn.active(type='button', value='Active Servers')
-          input#btn-show-leaderboard.lobby-tab-btn(type='button', value='Leaderboard')
-        div#lobby-servers-content
-          input#lobby-search.field-text(type='text', placeholder='Search servers…')
-          ul#lobby-list
-          p#lobby-empty= 'No servers available'
-          input#lobby-more(type='button', value='Load more')
-        div#lobby-leaderboard-content(style='display:none')
-          div.lobby-leaderboard-header
-            span#leaderboard-title
-            span#leaderboard-total
-          ol#lobby-leaderboard-list
-          p#lobby-my-placement
+  //- колоночная обёртка: сам #lobby — флекс-строка, центрирующая содержимое,
+  //- и футер под панелями иначе встал бы третьей колонкой рядом с ними
+  div.lobby-column
+    div.lobby-grid
+      //- левая панель: профиль + форма создания комнаты (lobby-page-plan)
+      div#lobby-setup-panel.card
+        h2= 'VIMP'
+        //- бейдж входа (Этап B2): управляется LobbyAuthView, показывается
+        //- вместе с #lobby после успешной авторизации
+        div#lobby-user
+          div
+            span= 'Signed in as '
+            b#lobby-user-nick
+          input#lobby-user-logout(type='button', value='Sign out')
+        hr.lobby-divider
+        h3.lobby-section-title= 'HOST A GAME'
+        div#lobby-create
+          //- селектор игры (lobby-page-plan): рабочий с первой же игрой в
+          //- каталоге мастера, а не только когда их несколько
+          div.form-row
+            label.form-label(for='lobby-game')= 'Select Game'
+            select#lobby-game.field-select
+          div.form-row
+            label.form-label(for='lobby-name')= 'Server name'
+            input#lobby-name.field-text(type='text', maxlength='30')
+          //- поля настроек комнаты генерируются по явной схеме roomForm
+          //- манифеста активной игры (docs/en/plugin-api.md "Form schema")
+          div#lobby-fields
+          //- ошибки формы (formBuilder.renderFormErrors) и отказ загрузки
+          //- плагина выбранной игры — строкой в форме, а не в #tech-informer:
+          //- тот кроет вкладку непрозрачным слоем и рассчитан на терминальные
+          //- причины, а эти восстановимы (поправить поле, другая игра,
+          //- повторный клик). Над кнопкой — рядом с полями, к которым относятся
+          div#lobby-error.form-error
+          input#lobby-host(type='button', value='Create server')
+      //- правая панель: вкладки Active Servers / Leaderboard (lobby-page-plan)
+      div#lobby-browser-panel.card
+        //- абсолютный слой: высоту .card задаёт форма слева (stretch), а
+        //- список внутри скроллится, не раздувая карточку (lobby-page-plan)
+        div.lobby-browser-inner
+          div.lobby-tabs-header
+            input#btn-show-servers.lobby-tab-btn.active(type='button', value='Active Servers')
+            input#btn-show-leaderboard.lobby-tab-btn(type='button', value='Leaderboard')
+          div#lobby-servers-content
+            input#lobby-search.field-text(type='text', placeholder='Search servers…')
+            ul#lobby-list
+            p#lobby-empty= 'No servers available'
+            input#lobby-more(type='button', value='Load more')
+          div#lobby-leaderboard-content(style='display:none')
+            div.lobby-leaderboard-header
+              span#leaderboard-title
+              span#leaderboard-total
+            ol#lobby-leaderboard-list
+            p#lobby-my-placement
+    //- футер: ссылку и версию пакета движка проставляет LobbyView
+    //- (engineVersion.js + lib/packageLink.js)
+    div#lobby-footer
+      p
+        a#lobby-link
+      p#lobby-version
+      p © #{new Date().getFullYear()} VIMP

package/src/config/lobby.js

@@ -96,6 +96,11 @@ export default {
     leaderboardTitleId: 'leaderboard-title',
     leaderboardTotalId: 'leaderboard-total',
     myPlacementId: 'lobby-my-placement',
+
+    // футер: версия npm-пакета движка, запечённая в бандл при сборке
+    // (client/lib/engineVersion.js), и ссылка на его страницу
+    versionId: 'lobby-version',
+    linkId: 'lobby-link',
   },
 
   // создание комнаты (хост в этой же вкладке); лимит игроков/время

package/src/lib/packageLink.js

@@ -0,0 +1,126 @@
+// Ссылка на пакет для футеров лобби и формы входа: движок показывает рядом
+// npm-версию, и клик по соседней ячейке должен вести на страницу этого пакета.
+//
+// Источник — `homepage`/`repository` его package.json, но объявлены они не у
+// всех (у @vimp-games/snakes нет ни того, ни другого), а footer без ссылки
+// выглядит поломкой. Поэтому фолбэк — страница пакета на npm: она выводится из
+// одного лишь имени, то есть существует всегда, и сама ведёт на репозиторий,
+// если он объявлен.
+//
+// Модуль изоморфный: мастер зовёт homepageOf для пакета игры (GameCatalog),
+// клиент — для собственного package.json движка (client/lib/engineVersion.js).
+
+const NPM_PACKAGE_BASE = 'https://www.npmjs.com/package/';
+
+/**
+ * Сырой адрес проекта из package.json: homepage, иначе repository.
+ * @param {Object} pkg - разобранный package.json
+ * @returns {string|null} адрес как объявлен (нормализует resolvePackageLink)
+ */
+export function homepageOf(pkg) {
+  if (!pkg || typeof pkg !== 'object') {
+    return null;
+  }
+
+  const { homepage, repository } = pkg;
+
+  if (typeof homepage === 'string' && homepage.trim()) {
+    return homepage;
+  }
+
+  // repository бывает и строкой ("github:user/repo"), и объектом {type, url}
+  if (typeof repository === 'string') {
+    return repository;
+  }
+
+  if (repository && typeof repository.url === 'string') {
+    return repository.url;
+  }
+
+  return null;
+}
+
+/**
+ * Ссылка футера по метаданным пакета.
+ * @param {{name?: string, homepage?: string}} [pkg] - имя пакета и сырой homepage
+ * @returns {{url: string, label: string}|null} null, если нет даже имени
+ */
+export function resolvePackageLink(pkg) {
+  const { name, homepage } = pkg ?? {};
+  const declared = normalize(homepage);
+
+  if (declared) {
+    return { url: declared, label: labelFor(declared) };
+  }
+
+  if (typeof name === 'string' && name.trim()) {
+    return { url: `${NPM_PACKAGE_BASE}${name.trim()}`, label: 'npm' };
+  }
+
+  return null;
+}
+
+// приводит объявленный адрес к https-виду; всё, что после нормализации не
+// http(s) (git@ без известной формы, file:, мусор), — не ссылка, а фолбэк
+function normalize(raw) {
+  if (typeof raw !== 'string') {
+    return null;
+  }
+
+  let url = raw.trim();
+
+  if (!url) {
+    return null;
+  }
+
+  // npm-шорткаты: "github:user/repo", "gitlab:...", "bitbucket:..."
+  const shorthand = /^(github|gitlab|bitbucket):([\w.-]+\/[\w.-]+)$/.exec(url);
+
+  if (shorthand) {
+    const hosts = {
+      github: 'github.com',
+      gitlab: 'gitlab.com',
+      bitbucket: 'bitbucket.org',
+    };
+
+    return `https://${hosts[shorthand[1]]}/${shorthand[2]}`;
+  }
+
+  url = url.replace(/^git\+/, '');
+
+  // scp-форма git@host:user/repo — двоеточие здесь разделитель, не порт
+  const scp = /^git@([^:/]+):(.+)$/.exec(url);
+
+  if (scp) {
+    url = `https://${scp[1]}/${scp[2]}`;
+  }
+
+  url = url
+    .replace(/^ssh:\/\/git@/, 'https://')
+    .replace(/^ssh:\/\//, 'https://')
+    .replace(/^git:\/\//, 'https://');
+
+  if (!/^https?:\/\//.test(url)) {
+    return null;
+  }
+
+  return (
+    url
+      .replace(/\.git(?=$|[#?])/, '')
+      // npm сам дописывает "#readme" в homepage при генерации package.json
+      .replace(/#readme$/, '')
+      .replace(/\/+$/, '')
+  );
+}
+
+function labelFor(url) {
+  if (/^https?:\/\/(www\.)?github\.com\//.test(url)) {
+    return 'GitHub';
+  }
+
+  if (url.startsWith(NPM_PACKAGE_BASE)) {
+    return 'npm';
+  }
+
+  return 'Website';
+}