vimp-engine 0.40.0 → 0.41.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.41.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/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/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 = [];

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

@@ -11,6 +11,19 @@ const DEFAULT_BAR_MAX = 100;
 const EMPTY_BLOCK_COLOR = '#888';
 const BAR_FILL_DELAY_MS = 500;
 const BAR_FILL_DURATION_MS = 500;
+// длительность подсветки is-up / is-down у flashOnChange-поля
+const FLASH_DURATION_MS = 400;
+// свойства поля, при которых ячейка строится как span-разметка, а не голый
+// textContent (поле без них работает как раньше)
+const RICH_PROPS = [
+  'label',
+  'labelFrom',
+  'format',
+  'prefix',
+  'suffix',
+  'emptyWhen',
+  'flashOnChange',
+];
 
 // системная настройка «уменьшить движение» — округление в один момент
 // времени: matchMedia недоступен в тестовой среде без happy-dom-полифилла
@@ -22,7 +35,10 @@ export default class PanelView {
   // config — { containerId (движок), fields (схема игры: массив
   // { name, elem, type: 'bar'|'value'|'time'|'weapon', max?, blocks? }) }
   // Семантику ячейки задаёт type, а не имя поля: игра с полем `energy`
-  // вместо `health` получает тот же бар
+  // вместо `health` получает тот же бар. Необязательные свойства поля:
+  // label, labelFrom { field, labels }, hidden, format ('int' | 'money' |
+  // 'tenths' | 'fraction'), prefix, suffix, emptyWhen, flashOnChange,
+  // countdown { for }
   constructor(model, config) {
     if (panelView) {
       return panelView;
@@ -35,6 +51,12 @@ export default class PanelView {
     this._panels = {};
     this._fields = {};
     this._bars = {};
+    // последние значения полей: нужны labelFrom и пересчёту зависимых ячеек
+    this._values = {};
+    this._rich = {};
+    this._flashTimers = {};
+    // имя поля-источника → имена полей, чья подпись берётся по его значению
+    this._dependents = {};
     this._weaponList = fields
       .filter(field => field.type === 'weapon')
       .map(field => field.name);
@@ -54,22 +76,60 @@ export default class PanelView {
   _buildPanel(container, fields) {
     const table = document.createElement('table');
     const row = table.insertRow(-1);
+    const gaugeTargets = new Set(
+      fields.map(field => field.countdown?.for).filter(Boolean),
+    );
 
     for (const field of fields) {
+      this._fields[field.name] = field;
+
+      if (field.labelFrom) {
+        const { field: source } = field.labelFrom;
+
+        (this._dependents[source] ??= []).push(field.name);
+      }
+
+      // служебное поле хранит значение, но ячейки у него нет
+      if (field.hidden) {
+        continue;
+      }
+
       const cell = row.insertCell(-1);
 
       cell.setAttribute('id', field.elem);
       this._panels[field.name] = cell;
-      this._fields[field.name] = field;
 
       if (field.type === 'bar') {
         this._initBar(field, cell);
+      } else if (
+        RICH_PROPS.some(prop => prop in field) ||
+        gaugeTargets.has(field.name)
+      ) {
+        this._initRichCell(field, cell);
       }
     }
 
     container.appendChild(table);
   }
 
+  // разметка ячейки с подписью: span.panel-label + span.panel-value +
+  // div.panel-gauge
+  _initRichCell(field, cell) {
+    cell.textContent = '';
+
+    const label = document.createElement('span');
+    const value = document.createElement('span');
+    const gauge = document.createElement('div');
+
+    label.className = 'panel-label';
+    value.className = 'panel-value';
+    gauge.className = 'panel-gauge';
+    gauge.style.display = 'none';
+
+    cell.append(label, value, gauge);
+    this._rich[field.name] = { label, value, gauge };
+  }
+
   // инициализирует полосу-бар поля type: 'bar'
   _initBar(field, cell) {
     cell.textContent = '';
@@ -148,15 +208,117 @@ export default class PanelView {
   // обновляет пользовательскую панель
   update(data) {
     const { name, value } = data;
+    const field = this._fields[name];
     const elem = this._panels[name];
+    const previous = this._values[name];
 
-    if (this._fields[name]?.type === 'bar') {
+    this._values[name] = value;
+
+    if (field?.type === 'bar') {
       this._updateBar(name, value);
-    } else {
+    } else if (this._rich[name]) {
+      this._renderRich(name);
+
+      if (field.flashOnChange && previous !== undefined && value !== previous) {
+        this._flash(name, value > previous ? 'is-up' : 'is-down');
+      }
+    } else if (elem) {
       elem.textContent = value;
     }
 
-    elem.style.display = 'table-cell';
+    // подпись зависимых ячеек берётся по значению этого поля
+    for (const dependent of this._dependents[name] ?? []) {
+      if (this._rich[dependent]) {
+        this._renderRich(dependent);
+      }
+    }
+
+    if (field?.countdown) {
+      this._runCountdown(field.countdown.for, value);
+    }
+
+    if (elem) {
+      elem.style.display = 'table-cell';
+    }
+  }
+
+  // подпись и значение ячейки: объектная форма записи labelFrom.labels
+  // перекрывает format / prefix / suffix / max самого поля
+  _renderRich(name) {
+    const field = this._fields[name];
+    const { label, value } = this._rich[name];
+    const raw = this._values[name];
+    const entry =
+      field.labelFrom?.labels?.[this._values[field.labelFrom.field]];
+    const spec = typeof entry === 'object' && entry !== null ? entry : {};
+    const text = typeof entry === 'string' ? entry : spec.text;
+
+    label.textContent = [field.label, text].filter(Boolean).join(' ');
+    // значение поля-источника может прийти раньше собственного
+    value.textContent =
+      raw === undefined
+        ? ''
+        : this._format(raw, {
+            format: spec.format ?? field.format,
+            prefix: spec.prefix ?? field.prefix,
+            suffix: spec.suffix ?? field.suffix,
+            max: spec.max,
+          });
+    this._panels[name].classList.toggle(
+      'is-empty',
+      'emptyWhen' in field && raw === field.emptyWhen,
+    );
+  }
+
+  _format(raw, { format = 'int', prefix = '', suffix = '', max }) {
+    let text;
+
+    if (typeof raw === 'string') {
+      text = raw; // time уже отформатирован моделью
+    } else if (format === 'money') {
+      text = `$ ${raw}`;
+    } else if (format === 'tenths') {
+      text = raw.toFixed(1);
+    } else if (format === 'fraction') {
+      text = max === undefined ? `${raw}` : `${raw}/${max}`;
+    } else {
+      text = `${raw}`;
+    }
+
+    return `${prefix}${text}${suffix}`;
+  }
+
+  // кратко подсвечивает ячейку классом is-up / is-down
+  _flash(name, className) {
+    const cell = this._panels[name];
+
+    clearTimeout(this._flashTimers[name]);
+    cell.classList.remove('is-up', 'is-down');
+    cell.classList.add(className);
+    this._flashTimers[name] = setTimeout(() => {
+      cell.classList.remove(className);
+    }, FLASH_DURATION_MS);
+  }
+
+  // шкала div.panel-gauge ячейки target заполняется от 0 до 100 % за
+  // duration мс (повторное значение перезапускает её); 0 — скрывает
+  _runCountdown(target, duration) {
+    const gauge = this._rich[target]?.gauge;
+
+    if (!gauge) {
+      return;
+    }
+
+    gauge.style.animation = 'none';
+
+    if (!(duration > 0)) {
+      gauge.style.display = 'none';
+      return;
+    }
+
+    gauge.style.display = 'block';
+    void gauge.offsetWidth; // перезапуск CSS-анимации
+    gauge.style.animation = `panel-gauge-fill ${duration}ms linear forwards`;
   }
 
   // перерисовывает бар по текущему значению
@@ -263,7 +425,11 @@ export default class PanelView {
   }
 
   hidePanel(name) {
-    this._panels[name].style.display = 'none';
+    const elem = this._panels[name];
+
+    if (elem) {
+      elem.style.display = 'none';
+    }
   }
 
   // с задержкой BAR_FILL_DELAY_MS заполняет bar-поля (например, здоровье)
@@ -303,6 +469,10 @@ export default class PanelView {
     for (const weaponName of this._weaponList) {
       const elem = this._panels[weaponName];
 
+      if (!elem) {
+        continue;
+      }
+
       if (weaponName === activeWeaponName) {
         elem.classList.add('active');
       } else {

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

@@ -65,7 +65,12 @@ export default class VoiceView {
     this._nameElem = document.createElement('span');
     this._nameElem.className = 'voice-name';
 
-    own.append(createIcon(), ring, this._timerElem, this._textElem);
+    // кольцо центрируется на значке, а не на крайнем элементе строки
+    const mark = document.createElement('span');
+
+    mark.className = 'voice-mark';
+    mark.append(createIcon(), ring);
+    own.append(mark, this._timerElem, this._textElem);
     incoming.append(createIcon(), this._nameElem);
     this._hud.append(own, incoming);
     container.appendChild(this._hud);

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

@@ -28,11 +28,42 @@ export default class VoteView {
 
     this._mPublic.on('vote', 'createVote', this);
     this._mPublic.on('clear', 'removeVote', this);
+    this._mPublic.on('hint', 'setHint', this);
+  }
+
+  // подсказка меню: иконка под значком рации (`#menu-hints`), класс
+  // `is-on` у горящей. Узлы строятся без innerHTML — имя пришло от хоста
+  setHint({ name, on }) {
+    let box = document.getElementById('menu-hints');
+
+    if (!box) {
+      box = document.createElement('div');
+      box.setAttribute('id', 'menu-hints');
+      this._container.appendChild(box);
+    }
+
+    let hint = null;
+
+    for (const child of box.children) {
+      if (child.dataset.name === name) {
+        hint = child;
+      }
+    }
+
+    if (!hint) {
+      hint = document.createElement('div');
+      hint.setAttribute('class', 'menu-hint');
+      hint.dataset.name = name;
+      hint.appendChild(createCartIcon());
+      box.appendChild(hint);
+    }
+
+    hint.classList.toggle('is-on', on === true);
   }
 
   // создает окно голосования
   createVote(data) {
-    const { title, list, back, more, time } = data;
+    const { title, list, back, more, time, style, level } = data;
     const vote = document.createElement('div');
     const p = document.createElement('p');
     const ol = document.createElement('ol');
@@ -44,6 +75,10 @@ export default class VoteView {
 
     vote.setAttribute('id', this._voteId);
 
+    if (style) {
+      vote.classList.add(`vote-style-${style}`, `vote-level-${level}`);
+    }
+
     p.setAttribute('class', this._titleClass);
     p.textContent = title;
 
@@ -51,7 +86,22 @@ export default class VoteView {
 
     list.forEach(item => {
       const li = document.createElement('li');
-      li.textContent = item;
+
+      // личное меню передаёт объекты { text, disabled, group }
+      if (typeof item === 'object') {
+        li.textContent = item.text;
+
+        if (item.disabled) {
+          li.classList.add('disabled');
+        }
+
+        if (item.group) {
+          li.classList.add('group');
+        }
+      } else {
+        li.textContent = item;
+      }
+
       ol.appendChild(li);
     });
 
@@ -106,3 +156,22 @@ export default class VoteView {
     }
   }
 }
+
+// SVG-заглушка корзины: подсказка работает без игровых стилей и файлов
+function createCartIcon() {
+  const ns = 'http://www.w3.org/2000/svg';
+  const svg = document.createElementNS(ns, 'svg');
+  const path = document.createElementNS(ns, 'path');
+
+  svg.setAttribute('viewBox', '0 0 24 24');
+  svg.setAttribute('width', '24');
+  svg.setAttribute('height', '24');
+  path.setAttribute('fill', 'currentColor');
+  path.setAttribute(
+    'd',
+    'M7 18a2 2 0 1 0 0 4 2 2 0 0 0 0-4Zm10 0a2 2 0 1 0 0 4 2 2 0 0 0 0-4ZM1 2v2h2l3.6 7.6-1.4 2.4A2 2 0 0 0 7 17h12v-2H7.4l1.1-2h7.5a2 2 0 0 0 1.7-1l3.6-6.5A1 1 0 0 0 20.4 4H5.2l-.9-2H1Z',
+  );
+  svg.appendChild(path);
+
+  return svg;
+}

package/src/client/main.js

@@ -1045,6 +1045,10 @@ socketMethods[PS_CLEAR] = function (setIdList) {
     }
   }
 
+  // личное меню и подсказки прошлого раунда гаснут; ядро игры зажжёт
+  // подсказку заново при спавне
+  modules.vote?.clearPersonal();
+
   clientCore?.reset();
   soundManager.reset();
 };