vimp-engine 0.40.0 → 0.42.0

package/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "vimp-engine-core"
-version = "0.23.5"
+version = "0.24.0"
 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.40.0",
+  "version": "0.42.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": {

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

@@ -3,7 +3,8 @@
 let roomMenuCtrl;
 
 export default class RoomMenuCtrl {
-  // actions — { onLeave, onHandover }: действия пунктов (client/main.js)
+  // actions — { onExit, onConfirmOpen, onConfirmClose } (client/main.js):
+  // выход подтверждён; окно открылось; окно закрыто без выхода
   constructor(model, view, actions = {}) {
     if (roomMenuCtrl) {
       return roomMenuCtrl;
@@ -13,22 +14,41 @@ export default class RoomMenuCtrl {
 
     this._model = model;
     this._view = view;
+    this._actions = actions;
 
     this._vPublic = view.publisher;
-    this._vPublic.on('toggle', () => model.toggle());
-    // меню остаётся открытым: на месте пунктов — статус передачи
-    this._vPublic.on('leave', () => actions.onLeave?.());
-    this._vPublic.on('handover', () => actions.onHandover?.());
+    this._vPublic.on('exit', () => {
+      if (model.openConfirm()) {
+        actions.onConfirmOpen?.();
+      }
+    });
+    this._vPublic.on('yes', () => {
+      if (!model.isConfirmOpen()) {
+        return;
+      }
+
+      model.closeConfirm();
+      actions.onExit?.();
+    });
+    this._vPublic.on('cancel', () => {
+      if (!model.isConfirmOpen()) {
+        return;
+      }
+
+      model.closeConfirm();
+      actions.onConfirmClose?.();
+    });
   }
 
-  // абсолютная ссылка на комнату, в которой вкладка; null — скрыть меню
+  // абсолютная ссылка на комнату, в которой вкладка; null — скрыть кнопку
   setLink(link) {
     this._model.setLink(link);
   }
 
-  // { role, othersPresent, hasSuccessor } — см. RoomMenuModel.setRole
-  setRole(state) {
-    this._model.setRole(state);
+  // закрыть окно без выхода и без возврата клавиш: пауза сессии сама ими
+  // управляет
+  closeConfirm() {
+    this._model.closeConfirm();
   }
 
   // true — кнопка внутри панели (игра её показывает), false — в углу
@@ -36,8 +56,16 @@ export default class RoomMenuCtrl {
     this._view.placeInPanel(inPanel);
   }
 
-  // null | 'pending' | 'slow' | 'failed'
+  // null | 'pending' | 'switching' | 'slow'. Передача закрывает открытое
+  // окно — как Cancel: клавиши, выключенные окном, возвращает onConfirmClose
+  // (иначе срыв передачи до заморозки оставил бы хоста без управления)
   setHandoff(status) {
+    const wasOpen = this._model.isConfirmOpen();
+
     this._model.setHandoff(status);
+
+    if (wasOpen && !this._model.isConfirmOpen()) {
+      this._actions.onConfirmClose?.();
+    }
   }
 }

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

@@ -24,6 +24,27 @@ export default class VoteCtrl {
   // {name: 'templateName', params: ['p1',..], values: ['v1',..] || 'values'}
   // ['val1', 'val2'];
   open(data) {
+    // личное меню хоста: проверяется раньше шаблона голосования (тоже объект)
+    if (typeof data === 'object' && data !== null && !Array.isArray(data)) {
+      if (Object.hasOwn(data, 'menu')) {
+        this._model.openPersonal(data.menu);
+
+        return;
+      }
+
+      if (Object.hasOwn(data, 'menuClose')) {
+        this._model.closePersonal(data.menuClose);
+
+        return;
+      }
+
+      if (Object.hasOwn(data, 'menuHint')) {
+        this._model.setHint(data.menuHint?.name, data.menuHint?.on);
+
+        return;
+      }
+    }
+
     // если данные - массив (values для созданного голосования)
     if (Array.isArray(data)) {
       this._model.updateValues(data);
@@ -64,6 +85,11 @@ export default class VoteCtrl {
     this._model.closeEngineVote(name);
   }
 
+  // CLEAR: личное меню закрывается, подсказки гаснут
+  clearPersonal() {
+    this._model.clearPersonal();
+  }
+
   // голосования хоста не пережили переподключение
   removeHostVotes() {
     this._model.removeHostVotes();

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

@@ -1,4 +1,5 @@
 import Publisher from '../../../lib/Publisher.js';
+import { VOTE_ANSWER_KEYS } from '../../../config/voteKeys.js';
 
 // Singleton ControlsModel
 
@@ -120,8 +121,15 @@ export default class ControlsModel {
         return;
       }
 
+      // цифры открытого окна голосования/меню — только ответ окну, в игру
+      // не уходят; прочие клавиши идут и в игру (танк ездит при меню)
+      const isVoteAnswer =
+        this._currentModes.vote &&
+        keyCode >= VOTE_ANSWER_KEYS[0] &&
+        keyCode <= VOTE_ANSWER_KEYS[1];
+
       // если клавиша ещё не зажата
-      if (!this._pressedKeys[keyCode]) {
+      if (!isVoteAnswer && !this._pressedKeys[keyCode]) {
         const name = this._currentKeySet[keyCode];
 
         if (name) {

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

@@ -2,19 +2,18 @@ import Publisher from '../../../lib/Publisher.js';
 
 // Singleton RoomMenuModel
 //
-// Меню комнаты внутри матча (host-migration, этапы 3 и 8d). Ссылка на
-// текущую комнату — признак «вкладка в комнате». Пункты:
-// - «Leave server» — у всех;
-// - «Hand over host» — только у текущего хоста, когда в комнате есть другие
-//   люди и мастер назначил бету (иначе передавать некому).
-// Пока идёт передача, пункты заблокированы, на их месте статус. Только
+// Выход из комнаты внутри матча: одна кнопка Exit у всех ролей, видна, пока
+// вкладка в комнате (ссылка на комнату — признак «в комнате»). Клик
+// открывает окно подтверждения «Leave the game?». Пока идёт плановая
+// передача хоста, кнопка заблокирована, на её месте статус. Только
 // лобби-режим: в solo ссылки на комнату нет
 
-// handoff: null | 'pending' | 'slow' | 'failed'
+// handoff: null | 'pending' (Exit хоста) | 'switching' (автопередача,
+// вкладка остаётся) | 'slow' (бета долго не отвечает)
 const STATUS_TEXT = {
-  pending: 'Handing over…',
+  pending: 'Leaving…',
+  switching: 'Switching host…',
   slow: 'Slow connection…',
-  failed: 'Host handover failed',
 };
 
 let roomMenuModel;
@@ -28,20 +27,18 @@ export default class RoomMenuModel {
     roomMenuModel = this;
 
     this._link = null;
-    this._open = false;
-    this._role = null; // null | 'host' | 'guest'
-    this._othersPresent = false;
-    this._hasSuccessor = false;
     this._handoff = null;
+    // окно подтверждения открыто
+    this._confirm = false;
     this.publisher = new Publisher();
   }
 
-  // абсолютная ссылка на комнату; null — вкладка не в комнате, меню скрыто
+  // абсолютная ссылка на комнату; null — вкладка не в комнате, кнопка скрыта
   setLink(link) {
     this._link = link || null;
 
     if (!this._link) {
-      this.setOpen(false);
+      this._confirm = false;
     }
 
     this._emitState();
@@ -51,70 +48,58 @@ export default class RoomMenuModel {
     return this._link;
   }
 
-  /**
-   * Роль вкладки в комнате.
-   * @param {Object} state
-   * @param {'host'|'guest'|null} state.role
-   * @param {boolean} [state.othersPresent] - в комнате есть другие люди.
-   * @param {boolean} [state.hasSuccessor] - мастер назначил бету.
-   */
-  setRole({ role, othersPresent = false, hasSuccessor = false }) {
-    this._role = role ?? null;
-    this._othersPresent = othersPresent === true;
-    this._hasSuccessor = hasSuccessor === true;
-    this._emitState();
-  }
-
-  // ход плановой передачи: null | 'pending' | 'slow' | 'failed'
+  // ход плановой передачи: null | 'pending' | 'switching' | 'slow'. Идущая
+  // передача закрывает окно: Yes посреди неё сорвал бы плановую передачу в
+  // аварийную
   setHandoff(status) {
     this._handoff = status ?? null;
+
+    if (this._handoff !== null) {
+      this._confirm = false;
+    }
+
     this._emitState();
   }
 
-  setOpen(open) {
-    const next = Boolean(open) && this._link !== null;
+  isConfirmOpen() {
+    return this._confirm;
+  }
 
-    if (next === this._open) {
-      return;
+  // окно открывается только у доступной кнопки; true — открылось сейчас
+  openConfirm() {
+    if (this._confirm || this._link === null || this._busy()) {
+      return false;
     }
 
-    this._open = next;
-    this.publisher.emit('open', next);
+    this._confirm = true;
+    this._emitState();
 
-    // ошибка передачи показана — закрытое меню её забывает
-    if (!next && this._handoff === 'failed') {
-      this.setHandoff(null);
-    }
+    return true;
   }
 
-  toggle() {
-    this.setOpen(!this._open);
+  closeConfirm() {
+    this._confirm = false;
+    this._emitState();
   }
 
   /**
    * Что показывать.
-   * @returns {{ visible: boolean, leave: Object, handover: Object,
-   *   status: string|null }} leave/handover — { visible, disabled }.
+   * @returns {{ visible: boolean, exit: { disabled: boolean },
+   *   status: string|null, confirm: boolean }}
    */
   getState() {
-    const inRoom = this._link !== null;
-    const busy = this._handoff === 'pending' || this._handoff === 'slow';
-
     return {
-      visible: inRoom,
-      leave: { visible: inRoom, disabled: busy },
-      handover: {
-        visible:
-          inRoom &&
-          this._role === 'host' &&
-          this._othersPresent &&
-          this._hasSuccessor,
-        disabled: busy,
-      },
+      visible: this._link !== null,
+      exit: { disabled: this._busy() },
       status: STATUS_TEXT[this._handoff] ?? null,
+      confirm: this._confirm,
     };
   }
 
+  _busy() {
+    return this._handoff !== null;
+  }
+
   _emitState() {
     this.publisher.emit('state', this.getState());
   }

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

@@ -1,5 +1,6 @@
 import Publisher from '../../../lib/Publisher.js';
 import { VOTE_ANSWER_KEYS } from '../../../config/voteKeys.js';
+import { MENU_NAME_PATTERN } from '../../../config/menuName.js';
 
 // Singleton VoteModel
 
@@ -7,6 +8,44 @@ import { VOTE_ANSWER_KEYS } from '../../../config/voteKeys.js';
 // его ведёт мастер, а не хост, и игра таких имён не объявляет
 const isEngineVote = name => typeof name === 'string' && name.startsWith('@');
 
+// ограничения данных личного меню: хост недоверенный
+const PERSONAL_MAX_ITEMS = 7;
+const PERSONAL_MAX_DEPTH = 2;
+const PERSONAL_MAX_TEXT = 64;
+
+// узлы личного меню: усечённые копии, глубина ≤ 2, пунктов ≤ 7
+function sanitizeNodes(nodes, depth) {
+  if (!Array.isArray(nodes)) {
+    return [];
+  }
+
+  if (nodes.length > PERSONAL_MAX_ITEMS) {
+    console.warn(
+      `[vote] personal menu level has ${nodes.length} items, max ${PERSONAL_MAX_ITEMS}`,
+    );
+  }
+
+  return nodes.slice(0, PERSONAL_MAX_ITEMS).map(node => {
+    const out = {
+      text: String(node?.text ?? '').slice(0, PERSONAL_MAX_TEXT),
+      disabled: node?.disabled === true,
+    };
+
+    if (depth < PERSONAL_MAX_DEPTH) {
+      const children = sanitizeNodes(node?.children, depth + 1);
+
+      if (children.length > 0) {
+        out.children = children;
+      } else if (node?.children !== undefined) {
+        // объявленная группа без валидных детей не должна стать листом
+        out.disabled = true;
+      }
+    }
+
+    return out;
+  });
+}
+
 let voteModel;
 
 export default class VoteModel {
@@ -41,6 +80,11 @@ export default class VoteModel {
     // затирает чужое и не затирается им (этап 10)
     this._queue = [];
 
+    // личное меню хоста (type 'personal'): { name, style, title, items,
+    // path }, path — индексы открытых групп; подсказки — имя → горит ли
+    this._personal = null;
+    this._hints = new Map();
+
     this._title = null; // заголовок голосования
     this._values = []; // все значения голосования
 
@@ -124,6 +168,137 @@ export default class VoteModel {
     if (!(this._type === 'vote' && isEngineVote(this._voteName))) {
       this.complete();
     }
+
+    this._clearHints();
+  }
+
+  /**
+   * Личное меню хоста: заменяет любое содержимое окна и начинается с
+   * 1-го уровня; открытое голосование движка уходит в начало очереди.
+   * @param {Object} menu - { name, style, title, items }.
+   * @returns {boolean} данные приняты.
+   */
+  openPersonal(menu) {
+    if (
+      !menu ||
+      !MENU_NAME_PATTERN.test(menu.name) ||
+      !MENU_NAME_PATTERN.test(menu.style)
+    ) {
+      return false;
+    }
+
+    if (
+      this._showing &&
+      this._type === 'vote' &&
+      isEngineVote(this._voteName)
+    ) {
+      this._queue.unshift({
+        engine: {
+          name: this._voteName,
+          title: this._title,
+          values: this._values,
+          deadline: this._deadline,
+        },
+      });
+    }
+
+    this._waitingValues = false;
+    this._timeOff = true;
+    this._deadline = null;
+    this._type = 'personal';
+    this._voteName = '';
+    this._personal = {
+      name: menu.name,
+      style: menu.style,
+      title: String(menu.title ?? '').slice(0, PERSONAL_MAX_TEXT),
+      items: sanitizeNodes(menu.items, 1),
+      path: [],
+    };
+
+    this.show();
+    this.open();
+
+    return true;
+  }
+
+  // закрывает окно, если оно показывает личное меню `name`
+  closePersonal(name) {
+    if (
+      this._showing &&
+      this._type === 'personal' &&
+      this._personal.name === name
+    ) {
+      this.complete();
+    }
+  }
+
+  // зажигает/гасит подсказку меню
+  setHint(name, on) {
+    if (!MENU_NAME_PATTERN.test(name)) {
+      return;
+    }
+
+    this._hints.set(name, on === true);
+    this.publisher.emit('hint', { name, on: on === true });
+  }
+
+  // CLEAR: личное меню закрывается, подсказки гаснут
+  clearPersonal() {
+    if (this._showing && this._type === 'personal') {
+      this.complete();
+    }
+
+    this._clearHints();
+  }
+
+  _clearHints() {
+    for (const [name, on] of this._hints) {
+      if (on) {
+        this.setHint(name, false);
+      }
+    }
+  }
+
+  // пункты текущего уровня личного меню
+  _personalLevel() {
+    let nodes = this._personal.items;
+
+    for (const index of this._personal.path) {
+      nodes = nodes[index].children;
+    }
+
+    return nodes;
+  }
+
+  // цифра в личном меню: 0 — выход, 8/9 — страниц нет, 1–7 — пункт
+  _updatePersonal(number) {
+    if (number === 0) {
+      this.complete();
+
+      return;
+    }
+
+    const node = this._personalLevel()[number - 1];
+
+    if (number >= 8 || !node || node.disabled) {
+      return;
+    }
+
+    if (node.children) {
+      this._personal.path.push(number - 1);
+      this.show();
+
+      return;
+    }
+
+    const answer = [...this._personal.path, number - 1]
+      .map(index => index + 1)
+      .join('.');
+    const name = this._personal.name;
+
+    // окно закрывается ДО отправки (синхронный транспорт, см. ниже)
+    this.complete();
+    this.publisher.emit('socket', [`menu:${name}`, answer]);
   }
 
   _startEngineVote({ name, title, values, deadline }) {
@@ -220,6 +395,12 @@ export default class VoteModel {
       number = String.fromCharCode(keyCode);
       number = parseInt(number, 10);
 
+      if (this._type === 'personal') {
+        this._updatePersonal(number);
+
+        return;
+      }
+
       // exit
       if (number === 0) {
         this.complete();
@@ -277,6 +458,27 @@ export default class VoteModel {
 
   // отображает голосование
   show() {
+    if (this._type === 'personal') {
+      this._showing = true;
+      this.publisher.emit('clear', this._timerId);
+
+      this.publisher.emit('vote', {
+        title: this._personal.title,
+        list: this._personalLevel().map(node => ({
+          text: node.text,
+          disabled: node.disabled,
+          group: Boolean(node.children),
+        })),
+        back: false,
+        more: false,
+        time: null,
+        style: this._personal.style,
+        level: this._personal.path.length + 1,
+      });
+
+      return;
+    }
+
     const begin = this._currentPage * 7;
     const max = begin + 7;
     let currentValues = [];