Игра запускается и играется: три рантайм-бага и адаптивная вёрстка

Проверено вживую в Chrome: лобби -> матч -> бот ходит -> результат ->
статистика в лобби. Полный матч отыгран, оба исхода видел.

Баги, которые собирались и типизировались, но падали только в рантайме:

1. Canvas не менял размер под экран. Своего cc.Widget у него не было,
   а alignCanvasWithScreen правит только камеру. Canvas оставался
   1280x720, и все растянутые по нему дети — тоже.
2. [...map.values()] превращается сборкой в [].concat(map.values()),
   а concat не разворачивает итератор, а кладёт его одним элементом.
   Отсюда "view.cancelAnimations is not a function" на первой же уборке
   карт. Теперь Array.from.
3. Рубашка козыря рисовалась поверх колоды, а не под ней.

Вёрстка переделана под требование UI.md (4:3 .. 21:9):
- fitWidth даёт постоянную ширину, но не высоту: на 4:3 видно только
  ±720 юнитов. Кнопка "Leave" на y=840 и низ руки на -860 были за
  экраном именно там, где это важнее всего
- рука и панель действий считаются от нижней границы экрана,
  "Leave" прибит виджетом к левому верхнему углу
- стол — один ряд до шести карт вместо двух рядов по три: экономит
  ~215 юнитов высоты, которых на 4:3 нет. Ряд центрируется по тем
  картам, что реально на столе
- затемнение под окном результата рисуется непрозрачным спрайтом:
  тонировать и без того полупрозрачный спрайт почти ничего не даёт

Инструменты:
- npm run serve — отдаёт сборку и роут /_aspects: игра в трёх
  фиксированных iframe-ах 4:3 / 16:9 / 21:9. Движок подгоняет себя
  под окно, поэтому iframe — единственный простой способ увидеть
  вёрстку в форме, которой окно не имеет
- npm run check:spreads — ловит спред неитерируемого в массив
- npm run check — чистота core, спреды, сцены, типы, тесты

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
ftc
2026-09-13 12:41:47 +03:00
co-authored by Claude Opus 5
parent 43f5bc5df3
commit 7fbe4c324d
14 changed files with 710 additions and 152 deletions
+64
View File
@@ -0,0 +1,64 @@
// Flags array-spread of things that are not arrays.
//
// npm run check:spreads
//
// The engine's build transpiles `[...a, ...b]` to `[].concat(a, b)`. That is
// correct for arrays, but `Array.prototype.concat` does NOT expand an arbitrary
// iterable — it appends it as a single element. So
//
// for (const view of [...this._views.values()]) // Map iterator
//
// silently loops once, over the iterator object itself, and every property
// access on it is undefined. It type-checks, it reads perfectly, and it only
// fails at runtime on a real build. That cost a debugging session; hence this
// check. Use `Array.from(...)` instead, which transpiles safely.
import { readdirSync, readFileSync, statSync } from 'node:fs';
import { join } from 'node:path';
const ROOT = 'assets/scripts';
/** Spreads of an iterator or collection, rather than an array. */
const HAZARDS = [
{ pattern: /\.\.\.[\w.$]*\.values\(\)/, what: '.values()' },
{ pattern: /\.\.\.[\w.$]*\.keys\(\)/, what: '.keys()' },
{ pattern: /\.\.\.[\w.$]*\.entries\(\)/, what: '.entries()' },
{ pattern: /\.\.\.new (?:Map|Set)\b/, what: 'a new Map/Set' },
{ pattern: /\.\.\.[\w.$]*(?:Map|Set)\b(?!\s*\()/, what: 'something named like a Map/Set' },
];
const offenders = [];
function walk(dir) {
for (const entry of readdirSync(dir)) {
const path = join(dir, entry);
if (statSync(path).isDirectory()) walk(path);
else if (path.endsWith('.ts')) inspect(path);
}
}
function inspect(path) {
readFileSync(path, 'utf8').split('\n').forEach((line, index) => {
const code = line.trim();
if (code.startsWith('*') || code.startsWith('//')) return;
for (const { pattern, what } of HAZARDS) {
if (pattern.test(code)) {
offenders.push(`${path}:${index + 1} spreads ${what} — use Array.from(...)\n ${code}`);
return;
}
}
});
}
walk(ROOT);
if (offenders.length > 0) {
console.error(
'Array spread of a non-array. The build turns [...x] into [].concat(x),\n'
+ 'which appends an iterator instead of expanding it:\n - '
+ offenders.join('\n - '),
);
process.exit(1);
}
console.log('spreads OK');