vimp-engine 0.16.0 → 0.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vimp-engine",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "VIMP — движок-приложение (мастер, P2P-транспорт, Worker-хост, мета, MVC-каркас клиента)",
   "license": "MIT",
   "repository": {

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

@@ -1,5 +1,6 @@
 import Publisher from '../../../lib/Publisher.js';
-import { ENGINE_VERSION } from '../../lib/engineVersion.js';
+import { ENGINE_PROJECT_URL, ENGINE_VERSION } from '../../lib/engineVersion.js';
+import { renderProjectLink } from '../../lib/footerLink.js';
 
 // Singleton LobbyView
 
@@ -35,14 +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 = `vimp-engine ${ENGINE_VERSION}`;
+      version.textContent = ENGINE_VERSION;
     }
 
+    renderProjectLink(document.getElementById(elems.linkId), ENGINE_PROJECT_URL);
+
     // заголовок игры для "<TITLE> TOP-N" (SVG-ориентир) — задаётся controller'ом
     // при выборе игры (сама модель не хранит title манифеста)
     this._gameTitle = '';

package/src/client/lib/engineVersion.js

@@ -7,5 +7,11 @@
 // бандлу (в npm-тарболле vimp-engine package.json есть всегда, поэтому
 // standalone SDK собирается у игры тем же импортом).
 import pkg from '../../../package.json' with { type: 'json' };
+import { resolveProjectUrl } from '../../lib/packageLink.js';
 
 export const ENGINE_VERSION = pkg.version;
+
+// адрес проекта для ссылки в футере лобби — то же поле, что мастер отдаёт
+// про пакет игры (GameCatalog.packageUrl), чтобы оба футера строил один
+// projectLink
+export const ENGINE_PROJECT_URL = resolveProjectUrl(pkg);

package/src/client/lib/footerLink.js

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

package/src/client/lib/formBuilder.js

@@ -97,7 +97,9 @@ function buildSelect(descriptor, ctx) {
       el.value = value;
     },
     onChange(cb) {
-      el.addEventListener('change', () => cb({ name: descriptor.name, value: el.value }));
+      el.addEventListener('change', () =>
+        cb({ name: descriptor.name, value: el.value }),
+      );
     },
   };
 }
@@ -110,6 +112,11 @@ function buildText(descriptor) {
   const numeric = isNumeric(descriptor);
 
   el.type = 'text';
+  // выпадашка прошлых значений/автозаполнения кроет форму, а подставить в
+  // игровое поле ей нечего. Только у текстового поля: у select такого списка
+  // нет, там autocomplete управлял бы лишь восстановлением значения при
+  // перезагрузке — а <option> создаёт JS, восстанавливать нечего
+  el.autocomplete = 'off';
   el.name = descriptor.name;
 
   // pattern/required — семантика контрола (a11y, автозаполнение), НЕ
@@ -157,7 +164,9 @@ function buildText(descriptor) {
       el.value = numeric ? toDisplay(descriptor, value) : (value ?? '');
     },
     onChange(cb) {
-      el.addEventListener('change', () => cb({ name: descriptor.name, value: getValue() }));
+      el.addEventListener('change', () =>
+        cb({ name: descriptor.name, value: getValue() }),
+      );
     },
   };
 }
@@ -182,7 +191,9 @@ function buildCheckbox(descriptor) {
       el.checked = Boolean(value);
     },
     onChange(cb) {
-      el.addEventListener('change', () => cb({ name: descriptor.name, value: el.checked }));
+      el.addEventListener('change', () =>
+        cb({ name: descriptor.name, value: el.checked }),
+      );
     },
   };
 }
@@ -239,7 +250,9 @@ function buildRadio(descriptor, ctx) {
     },
     onChange(cb) {
       inputs.forEach(input => {
-        input.addEventListener('change', () => cb({ name: descriptor.name, value: getValue() }));
+        input.addEventListener('change', () =>
+          cb({ name: descriptor.name, value: getValue() }),
+        );
       });
     },
   };
@@ -458,7 +471,9 @@ export function renderFormErrors(container, errors) {
     // для них, как и раньше, остаётся имя поля
     const title = String(label || name).toUpperCase();
 
-    line.textContent = error ? `${title}: ${error}` : `${title} is not correctly!`;
+    line.textContent = error
+      ? `${title}: ${error}`
+      : `${title} is not correctly!`;
 
     container.appendChild(line);
   });
@@ -556,7 +571,9 @@ export function buildForm(descriptors, container, ctx = {}, onChange) {
     } catch (e) {
       // одно поле с кривой/неизвестной схемой не должно ронять всю форму
       // (room-форма и особенно auth-форма — единственный путь к кнопке Start)
-      console.error(`formBuilder: skipping field "${descriptor.name}" — ${e.message}`);
+      console.error(
+        `formBuilder: skipping field "${descriptor.name}" — ${e.message}`,
+      );
       return;
     }
 
@@ -602,7 +619,8 @@ export function buildForm(descriptors, container, ctx = {}, onChange) {
     const label = document.createElement(field.labelFor ? 'label' : 'span');
 
     label.className = 'form-label';
-    label.textContent = (descriptor.label || descriptor.name) + buildLabelSuffix(descriptor);
+    label.textContent =
+      (descriptor.label || descriptor.name) + buildLabelSuffix(descriptor);
 
     if (field.labelFor) {
       label.htmlFor = field.labelFor;

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 { renderProjectLink } from './lib/footerLink.js';
 import { createGameActivator } from './lib/gameActivator.js';
 import createAutostart from './lib/autostart.js';
 import { getBootConfig, resolveBootConfig } from './boot.js';
@@ -422,18 +423,22 @@ socketMethods[PS_AUTH_DATA] = data => {
 
   document.getElementById('logo').textContent = texts?.title || 'VIMP';
 
-  // версия пакета игры в футере формы входа. Здесь, а не в AuthView: его
-  // elems приходят из authSchema.elems игрового плагина, и футер каркаса —
-  // не его забота. Игра, собранная до появления packageVersion, оставляет
-  // строку пустой (#auth-link держит раскладку через space-between)
+  // футер формы входа: версия и ссылка пакета ИГРЫ. Здесь, а не в AuthView:
+  // его elems приходят из authSchema.elems игрового плагина, и футер каркаса
+  // — не его забота. Метаданные кладёт в манифест мастер (GameCatalog читает
+  // package.json пакета); в standalone-манифесте их может не быть — тогда
+  // ячейки пустые, раскладку space-between это не ломает
   const authVersion = document.getElementById('auth-version');
 
   if (authVersion) {
-    const packageVersion = activeGameManifest?.packageVersion;
-
-    authVersion.textContent = packageVersion ? `v${packageVersion}` : '';
+    authVersion.textContent = activeGameManifest?.packageVersion ?? '';
   }
 
+  renderProjectLink(
+    document.getElementById('auth-package-link'),
+    activeGameManifest?.packageUrl,
+  );
+
   // память клиента (localStorage) + принудительное значение поля с
   // единственным вариантом. Здесь, а не в AuthView: solo-путь ниже отвечает
   // хосту вообще без формы и обязан прийти к тем же значениям

package/src/client/style.css

@@ -385,10 +385,11 @@ body.hide-cursor {
   background-color: #333;
   border: 1px solid #eee;
   padding: 10px;
-  margin: 10px auto;
+  margin: 10px auto 5px;
   text-shadow: 1px 1px 1px #000;
   font-size: 12px;
   line-height: 15px;
+  border-radius: 4px;
 }
 
 .card h2 {
@@ -396,17 +397,19 @@ body.hide-cursor {
   line-height: 30px;
   margin: 0 0 10px 0;
   text-align: center;
+  border-bottom: 1px solid #444;
+  padding: 5px 0 10px;
 }
 
-/* кнопки: провайдеры логина, Create server, Start, Load more, Sign out —
-   нативный вид input[type=button], без декоративных стилей, только размер */
+/* кнопки: провайдеры логина, Choose nick, Start, Load more — нативный вид
+   input[type=button], без декоративных стилей, только размер. Create server и
+   Sign out сюда не входят: они лежат во флекс-контейнерах с gap и
+   центрируются через align-self (секция lobby-auth ниже) */
 .lobby-auth-provider,
 #lobby-auth-nick-submit,
-#lobby-host,
-#lobby-user-logout,
 #lobby-more,
 #auth-enter {
-  margin: 4px;
+  margin: 15px auto;
 }
 
 /* один вертикальный ритм для всех строк формы (room-форма и auth-форма) */
@@ -415,7 +418,7 @@ body.hide-cursor {
   align-items: center;
   justify-content: space-between;
   gap: 8px;
-  margin: 8px 0;
+  margin: 0;
 }
 
 .form-row input[type='text'] {
@@ -423,6 +426,10 @@ body.hide-cursor {
   text-align: center;
 }
 
+#lobby-fields .form-row {
+  margin: 6px 0;
+}
+
 .form-label {
   color: #aaa;
 }
@@ -470,43 +477,71 @@ body.hide-cursor {
 
 #auth-enter {
   display: block;
-  margin: 4px auto;
 }
 
-#auth-link {
-  font-size: 9px;
+/* футеры лобби и формы входа: одна и та же полоса из трёх ячеек —
+   ссылка на пакет, его версия, копирайт. Оба заполняет JS, поэтому вид
+   держится в одном месте (#lobby-footer лежит в секции lobby ниже только
+   разметкой) */
+#auth-link,
+#lobby-footer {
   height: 15px;
-  margin: 0;
-  padding: 0 5px;
   text-shadow: none;
   display: flex;
-  justify-content: space-between;
 }
 
-#auth-link p {
+#auth-link {
+  font-size: 9px;
+  margin: 0;
+  padding: 0 10px;
+}
+
+/* ширина — контентная область правой панели лобби (её ширина минус
+   собственные поля .lobby-browser-inner), под которой футер и стоит;
+   max-width, а не width: в одну колонку он обязан ужиматься по экрану */
+#lobby-footer {
+  width: 100%;
+  max-width: calc(var(--lobby-browser-width) - 2 * var(--lobby-panel-pad));
+  font-size: 10px;
+  padding: 0;
+  margin: 0 var(--lobby-panel-pad) 0 0;
+}
+
+/* три равные ячейки: середину держит не space-between, а сама равность —
+   любая из крайних бывает пустой (у пакета игры может не быть метаданных),
+   и при space-between версия съезжала бы с центра */
+#auth-link p,
+#lobby-footer p {
   margin: 0;
+  flex: 1;
 }
 
-#auth-link p a {
+#auth-link p a,
+#lobby-footer p a {
   color: #ff0;
 }
 
-/* три колонки: GitHub — версия игры — копирайт. Позициями заведует
-   space-between, а не nth-child: средний элемент бывает пустым (игра
-   собрана без packageVersion), и порядковые правила тогда съезжали бы */
-#auth-link p:first-child {
+/* позиция текста внутри ячейки; сами ячейки уже разложены flex: 1 выше */
+#auth-link p:first-child,
+#lobby-footer p:first-child {
   text-align: left;
 }
 
-#auth-version {
+#auth-version,
+#lobby-version {
   text-align: center;
 }
 
-#auth-link p:last-child {
+#auth-link p:last-child,
+#lobby-footer p:last-child {
   text-align: right;
 }
 
-.auth-inform {
+/* коробка контента: блок помощи формы входа и группа полей комнаты.
+   .lobby-card сюда не входит — ей нужен фон темнее, иначе он совпадёт с
+   её собственным hover'ом и наведение перестанет быть видно */
+.auth-inform,
+#lobby-fields {
   background-color: #444;
   padding: 7px 13px;
   margin: 10px 0;
@@ -514,6 +549,12 @@ body.hide-cursor {
   border: 1px solid #999;
 }
 
+/* вертикаль внутри #lobby-create держит его gap — собственный margin
+   коробки удвоил бы отступ до соседей */
+#lobby-fields {
+  margin: 0;
+}
+
 .auth-inform h4 {
   margin: 0 0 4px 0;
   text-align: center;
@@ -582,6 +623,13 @@ body.hide-cursor {
 /*lobby*/
 
 #lobby {
+  /* ширины панелей и их внутренние поля: по ним же считается ширина футера
+     (секция auth выше), поэтому числа живут в одном месте — иначе смена
+     ширины любой панели молча разъезжает вёрстку */
+  --lobby-setup-width: 410px;
+  --lobby-browser-width: 430px;
+  --lobby-panel-pad: 10px;
+
   background-color: #222;
   position: absolute;
   width: 100%;
@@ -592,16 +640,20 @@ body.hide-cursor {
   display: flex;
   align-items: flex-start;
   justify-content: center;
-  padding: 10px 0 0;
+  padding: 0;
   box-sizing: border-box;
 }
 
+#lobby-user,
+.lobby-section-title,
+#lobby-create {
+  padding: 8px;
+}
+
 #lobby-create {
   display: flex;
   flex-direction: column;
-  gap: 8px;
-  margin-bottom: 12px;
-  padding: 8px;
+  gap: 10px;
 }
 
 /* поле имени сервера — строка формы, а не узкий числовой инпут
@@ -628,13 +680,10 @@ body.hide-cursor {
   margin: 0;
 }
 
-#lobby-host {
-  margin: 16px auto 0;
-}
-
 #lobby-search {
   display: block;
   width: 100%;
+  margin-bottom: 10px;
 }
 
 #lobby-list {
@@ -652,9 +701,10 @@ body.hide-cursor {
   column-gap: 8px;
   row-gap: 2px;
   padding: 10px 12px;
-  margin-bottom: 6px;
+  margin: 0 0 6px;
   background-color: #363636;
-  border: 1px solid #444;
+  border: 1px solid #999;
+  border-radius: 4px;
   cursor: pointer;
   align-items: center;
 }
@@ -725,6 +775,7 @@ body.hide-cursor {
 .lobby-column {
   display: flex;
   flex-direction: column;
+  align-items: flex-end;
 }
 
 /* два столбца лобби (lobby-page-plan): настройки/создание слева, вкладки
@@ -734,12 +785,12 @@ body.hide-cursor {
    высоты более высокой панели */
 .lobby-grid {
   display: flex;
-  gap: 20px;
+  gap: 10px;
   justify-content: center;
 }
 
 #lobby-setup-panel {
-  width: 410px;
+  width: var(--lobby-setup-width);
 }
 
 /* высоту правой .card задаёт форма слева: обе панели тянутся до высоты
@@ -748,7 +799,7 @@ body.hide-cursor {
    вынесен в абсолютный слой .lobby-browser-inner (его высота не участвует в
    расчёте высоты строки) */
 #lobby-browser-panel {
-  width: 430px;
+  width: var(--lobby-browser-width);
   position: relative;
   padding: 0;
 }
@@ -758,7 +809,7 @@ body.hide-cursor {
   inset: 0;
   display: flex;
   flex-direction: column;
-  padding: 10px;
+  padding: var(--lobby-panel-pad);
   box-sizing: border-box;
 }
 
@@ -783,31 +834,23 @@ body.hide-cursor {
   flex-shrink: 0;
 }
 
-/* версия пакета движка под панелями — тем же мелким кеглем, что и футер
-   формы входа (#auth-link) */
-#lobby-footer {
-  font-size: 9px;
-  padding: 0 5px;
-  margin: 6px 0 10px;
-  text-align: center;
-  text-shadow: none;
-}
-
-#lobby-footer p {
-  margin: 0;
-}
-
 @media (max-width: 800px) {
   .lobby-grid {
-    flex-direction: column;
-    align-items: stretch;
-    gap: unset;
+    display: block;
   }
 
   /* в столбик обёртка тянется на всю ширину: иначе она сжалась бы по
      содержимому и увела бы панели из центра */
   .lobby-column {
     width: 100%;
+    align-items: center;
+  }
+
+  /* правое поле, прижимавшее футер к контенту правой панели, в одну
+     колонку не нужно: с ним align-items: center увёл бы его влево на
+     половину поля */
+  #lobby-footer {
+    margin: 0 auto;
   }
 
   /* в столбик высоту строкой никто не задаёт — возвращаем слой в поток,

package/src/client/views/gameShell.js

@@ -55,18 +55,9 @@ const SHELL = [
             tag: 'div',
             id: 'auth-link',
             children: [
-              {
-                tag: 'p',
-                children: [
-                  {
-                    tag: 'a',
-                    attrs: { href: 'https://github.com/lgick/vimp' },
-                    text: 'GitHub',
-                  },
-                ],
-              },
-              // версия пакета игры (manifest.packageVersion) — текст пишет
-              // main.js по AUTH_DATA
+              // ссылка и версия пакета ИГРЫ — заполняет 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,9 +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
-      //- версия пакета игры (manifest.packageVersion): проставляет main.js,
-      //- у игры, собранной до появления поля, строка остаётся пустой
+        a#auth-package-link
       p#auth-version
       p © #{new Date().getFullYear()} VIMP

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

@@ -2,4 +2,4 @@ div#chat
   div#chat-box
   //- maxlength — лишь UX-подсказка; авторитетный лимит на сервере
   //- (chatMaxLength в src/config/hostDefaults.js). Значения держать синхронными.
-  input#cmd(type='text', maxlength='60' autocomplete="off")
+  input#cmd(type='text', maxlength='60', autocomplete='off')

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

@@ -21,11 +21,11 @@ div#lobby(style='display:none')
           //- селектор игры (lobby-page-plan): рабочий с первой же игрой в
           //- каталоге мастера, а не только когда их несколько
           div.form-row
-            label.form-label(for='lobby-game')= 'Select Game'
+            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')
+            input#lobby-name.field-text(type='text', maxlength='30', autocomplete='off')
           //- поля настроек комнаты генерируются по явной схеме roomForm
           //- манифеста активной игры (docs/en/plugin-api.md "Form schema")
           div#lobby-fields
@@ -45,7 +45,7 @@ div#lobby(style='display:none')
             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…')
+            input#lobby-search.field-text(type='text', placeholder='Search servers…', autocomplete='off')
             ul#lobby-list
             p#lobby-empty= 'No servers available'
             input#lobby-more(type='button', value='Load more')
@@ -55,6 +55,10 @@ div#lobby(style='display:none')
               span#leaderboard-total
             ol#lobby-leaderboard-list
             p#lobby-my-placement
-    //- футер: версию пакета движка проставляет LobbyView (engineVersion.js)
+    //- футер: ссылку и версию пакета движка проставляет LobbyView
+    //- (engineVersion.js + lib/packageLink.js)
     div#lobby-footer
+      p
+        a#lobby-link
       p#lobby-version
+      p © #{new Date().getFullYear()} VIMP

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

@@ -14,6 +14,6 @@ div#lobby-auth
 
   div#lobby-auth-nick.card(style='display:none')
     h2= 'Choose your nick'
-    input#lobby-auth-nick-input.field-text(type='text', maxlength='14', placeholder='YourNick')
+    input#lobby-auth-nick-input.field-text(type='text', maxlength='14', placeholder='YourNick', autocomplete='off')
     div#lobby-auth-nick-error
     input#lobby-auth-nick-submit(type='button', value='Continue')

package/src/config/lobby.js

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

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

@@ -0,0 +1,29 @@
+import { WARN, skip, verdict } from '../result.js';
+import { resolveProjectUrl } from '../../../lib/packageLink.js';
+
+// Игра без объявленного репозитория собирается и играется — это не отказ.
+// Но движок показывает ссылку на проект в футере формы входа, и берёт он её
+// только отсюда (фолбэка нет, см. lib/packageLink.js): без поля ячейка
+// футера у игроков останется пустой, а заметить это без подсказки негде.
+// Отсюда warn — под --strict он становится ошибкой.
+export default {
+  id: 'A7',
+  name: 'packageRepository',
+  level: WARN,
+  title: 'package.json declares repository (the #auth footer links to it)',
+
+  check(ctx) {
+    if (!ctx.pkg) {
+      return skip('no package.json');
+    }
+
+    if (resolveProjectUrl(ctx.pkg)) {
+      return verdict([]);
+    }
+
+    return verdict([
+      'neither "repository" nor "homepage" resolves to a project URL — ' +
+        "the game's entry form will show no project link",
+    ]);
+  },
+};

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

@@ -4,6 +4,7 @@ import a3 from './a3-entry-paths.js';
 import a4 from './a4-vite-config.js';
 import a5 from './a5-cargo-core.js';
 import a6 from './a6-manifest.js';
+import a7 from './a7-package-repository.js';
 import b1 from './b1-host-shape.js';
 import b2 from './b2-engine-api.js';
 import b3 from './b3-game-config-shape.js';
@@ -34,7 +35,7 @@ import e3 from './e3-sound-registry.js';
 // Порядок групп — порядок отчёта: A пакет и сборка, B host, C client,
 // D снапшот, E ассеты (plan/create-vimp-game/stage_1.md).
 export const rules = [
-  a1, a2, a3, a4, a5, a6,
+  a1, a2, a3, a4, a5, a6, a7,
   b1, b2, b3, b4, b5, b6, b7, b8, b9, b10,
   c1, c2, c3, c4, c5, c6, c7, c8, c9, c10,
   d1, d2, d3,

package/src/lib/packageLink.js

@@ -0,0 +1,121 @@
+// Ссылка на проект для футеров лобби и формы входа: движок показывает рядом
+// npm-версию, и клик по соседней ячейке ведёт в репозиторий этого пакета.
+//
+// Источник — `repository` его package.json (иначе `homepage`). Фолбэка нет:
+// пакет, не объявивший ни того, ни другого, ссылки не получает, и ячейка
+// футера остаётся пустой. Это сознательно — прежний фолбэк на страницу пакета
+// в npm давал разнобой («GitHub» у одной игры, «npm» у другой) и молча
+// маскировал недостающие метаданные вместо того, чтобы показать их отсутствие.
+// О пропущенном поле предупреждает правило контракта A7.
+//
+// Хостинг не ограничен github.com: подпись выводится из хоста, поэтому чужой
+// плагин на GitLab получает честную ссылку, а не пустую ячейку.
+//
+// Модуль изоморфный: мастер зовёт resolveProjectUrl для пакета игры
+// (GameCatalog), клиент — для собственного package.json движка
+// (client/lib/engineVersion.js).
+
+/**
+ * Адрес проекта из package.json, приведённый к https: repository, иначе
+ * homepage.
+ * @param {Object} pkg - разобранный package.json
+ * @returns {string|null} https-URL либо null, если поля нет или это не адрес
+ */
+export function resolveProjectUrl(pkg) {
+  if (!pkg || typeof pkg !== 'object') {
+    return null;
+  }
+
+  const { homepage, repository } = pkg;
+
+  // repository бывает и строкой ("github:user/repo"), и объектом {type, url}
+  const declared =
+    (typeof repository === 'string' ? repository : repository?.url) ?? homepage;
+
+  return normalize(declared);
+}
+
+/**
+ * Ссылка футера по готовому адресу проекта.
+ * @param {string|null} [url] - результат resolveProjectUrl
+ * @returns {{url: string, label: string}|null} null, если адреса нет
+ */
+export function projectLink(url) {
+  if (typeof url !== 'string' || !url.trim()) {
+    return null;
+  }
+
+  return { url, label: labelFor(url) };
+}
+
+// приводит объявленный адрес к 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:...", а также
+  // голое "user/repo" — его принимает флаг --repository скаффолдера
+  const bare = /^([\w.-]+\/[\w.-]+)$/.exec(url);
+
+  if (bare) {
+    return `https://github.com/${bare[1]}`;
+  }
+
+  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(/\/+$/, '')
+  );
+}
+
+// подпись ячейки: у наших пакетов это всегда GitHub, у чужого хостинга —
+// его хост, чтобы подпись не врала об источнике
+function labelFor(url) {
+  if (/^https?:\/\/(www\.)?github\.com\//.test(url)) {
+    return 'GitHub';
+  }
+
+  const host = /^https?:\/\/(?:www\.)?([^/:]+)/.exec(url);
+
+  return host ? host[1] : 'Website';
+}