The command tables and the page-side reads, screens and dispatch (scripts/lib/mcp-commands.js and
mcp-page.js) become src/agent/, the facade window.TUBES.call(tool, args) in the page's own scope.
A new <!-- @include-dev agent --> line in src/index.html pastes it in after the game, but only in the
development page (npm run dev, the MCP server, i18n-check, tests that ask with load({agent:true})).
The build drops the line whole: _site/ is byte for byte what main builds.
Tests load the page players get by default, the build test fails if anything outside src/agent/ names
the facade's api/API_ names, and the pages test checks the built page carries none of it and still
plays. ADR 0004 records the rule.
112 lines
7.6 KiB
JavaScript
112 lines
7.6 KiB
JavaScript
// Loads the game page in jsdom with the animation loop disabled, so tests can drive the simulation
|
|
// directly through the game's globals (ACT, S, R, dayTick…). The page is assembled from src/ once per
|
|
// test process (scripts/lib/page.js), so tests always run what is in src/, never a stale build.
|
|
// It is the page players get; {agent: true} loads the development page instead, with the agent facade
|
|
// (src/agent/) the MCP server drives. Only the tests of that facade ask for it, so core code that leans on
|
|
// it fails here rather than in production.
|
|
const fs = require('node:fs');
|
|
const path = require('node:path');
|
|
const { JSDOM, VirtualConsole } = require('jsdom');
|
|
const { assemble } = require('../scripts/lib/page');
|
|
|
|
const PAGE = {};
|
|
const page = (dev) => PAGE[dev] || (PAGE[dev] = assemble({ dev }).html);
|
|
|
|
// opts.file: a built or older page to load instead (the perf bench, the release build test).
|
|
// opts.agent: the development page, with src/agent/.
|
|
function load(opts = {}) {
|
|
const html = opts.file ? fs.readFileSync(opts.file, 'utf8') : page(!!opts.agent);
|
|
const errors = [];
|
|
const vc = new VirtualConsole();
|
|
vc.on('jsdomError', (e) => {
|
|
// jsdom has no canvas; drawing calls are expected to be unimplemented.
|
|
if (!/getContext|Not implemented/.test(e.message)) errors.push(e.message);
|
|
});
|
|
const dom = new JSDOM(html, {
|
|
url: 'https://tests.invalid/',
|
|
runScripts: 'dangerously',
|
|
pretendToBeVisual: true,
|
|
virtualConsole: vc,
|
|
beforeParse(window) {
|
|
window.__TUBES_TEST__ = true;
|
|
// Seed before the game script runs, so nothing random happens at load time either.
|
|
if (opts.seed !== false) { let r = opts.seed || 12345; window.Math.random = () => { r = (r * 16807) % 2147483647; return r / 2147483647; }; window.__reseed = (n) => { r = n; }; }
|
|
// opts.browser (from browser()): windows of one browser share localStorage, its storage events, a broadcast
|
|
// channel and Web Locks, like real tabs; opts.tab is one tab's sessionStorage, which survives a reload.
|
|
if (opts.browser) opts.browser.attach(window, opts.tab || new Map(), opts);
|
|
for (const [k, v] of Object.entries(opts.storage || {})) window.localStorage.setItem(k, v);
|
|
if (opts.navigatorLanguage) Object.defineProperty(window.navigator, 'language', { value: opts.navigatorLanguage });
|
|
// A non-English game: jsdom does not fetch the dictionary script, so register it up front.
|
|
// (opts.dir: the folder the dictionary comes from, e.g. a build's _site/i18n.)
|
|
if (opts.lang) { window.localStorage.setItem('sot-lang', opts.lang); window.eval(fs.readFileSync(path.join(opts.dir || path.join(__dirname, '..', 'site', 'i18n'), opts.lang + '.js'), 'utf8')); }
|
|
// jsdom has no CompressionStream; {gzip:true} lends the page Node's, the same API browsers have (#176).
|
|
if (opts.gzip) for (const k of ['CompressionStream', 'DecompressionStream', 'TextEncoder', 'TextDecoder']) window[k] = globalThis[k];
|
|
window.Path2D = class { moveTo() {} lineTo() {} quadraticCurveTo() {} bezierCurveTo() {} arc() {} rect() {} closePath() {} };
|
|
// A recording 2D context, so draw code really runs under test (jsdom has no canvas).
|
|
const fake = () => { const calls = { n: 0 };
|
|
const grad = { addColorStop() {} };
|
|
return new Proxy({ calls }, { get(t, k) {
|
|
if (k in t) return t[k];
|
|
if (k === 'measureText') return (s) => ({ width: String(s).length * 7 });
|
|
if (k === 'createLinearGradient' || k === 'createRadialGradient' || k === 'createPattern') return () => grad;
|
|
if (k === 'getImageData') return () => ({ data: new Uint8ClampedArray(4) });
|
|
if (k === 'canvas') return null;
|
|
return (...a) => { calls.n++; };
|
|
}, set(t, k, v) { t[k] = v; return true; } }); };
|
|
window.HTMLCanvasElement.prototype.getContext = function () { return this.__ctx || (this.__ctx = fake()); };
|
|
window.HTMLCanvasElement.prototype.toDataURL = () => 'data:image/png;base64,';
|
|
window.HTMLCanvasElement.prototype.toBlob = (cb) => cb(null);
|
|
},
|
|
});
|
|
const ev = (src) => dom.window.eval(src);
|
|
// Deterministic by default so a test never passes or fails by luck; pass {seed:false} to opt out.
|
|
// (Seeded in beforeParse, so the game's own seeded-games wrapper around Math.random stays in place.)
|
|
return { dom, ev, errors };
|
|
}
|
|
|
|
// Deterministic Math.random so failures are reproducible.
|
|
function seed(ev, n) {
|
|
ev(`if(window.__reseed)__reseed(${n});else Math.random=(()=>{let s=${n};return()=>{s=(s*16807)%2147483647;return s/2147483647;};})();`);
|
|
}
|
|
|
|
// A fake browser for several windows at once (see opts.browser). Storage events, broadcast messages and lock
|
|
// hand-overs arrive asynchronously, as in browsers: await settle() or flush() before checking them.
|
|
function browser({ locks = true, channel = true } = {}) {
|
|
const ls = new Map(), wins = new Set(), held = new Map(), log = [];
|
|
const later = (f) => setTimeout(f, 0);
|
|
const store = (map, win, shared) => {
|
|
const fire = (key, oldValue, newValue) => { if (shared) for (const w of wins) if (w !== win && !w.closed) later(() => { try { w.dispatchEvent(new w.StorageEvent('storage', { key, oldValue, newValue })); } catch (e) {} }); };
|
|
return {
|
|
getItem: (k) => { if (shared) log.push(['get', String(k)]); return map.has(String(k)) ? map.get(String(k)) : null; },
|
|
setItem: (k, v) => { if (win.closed) return; k = String(k); v = String(v); if (shared && b.quota && k.startsWith('sot-save-v1:') && v.length > b.quota) { const e = new win.Error('full'); e.name = 'QuotaExceededError'; throw e; } const o = map.has(k) ? map.get(k) : null; map.set(k, v); if (shared) { log.push(['set', k]); fire(k, o, v); } },
|
|
removeItem: (k) => { k = String(k); if (!map.has(k)) return; const o = map.get(k); map.delete(k); if (shared) fire(k, o, null); },
|
|
key: (i) => [...map.keys()][i] ?? null,
|
|
get length() { return map.size; },
|
|
clear: () => map.clear(),
|
|
};
|
|
};
|
|
const b = { ls, wins, log, quota: 0,
|
|
attach(win, tab, opts) {
|
|
wins.add(win);
|
|
Object.defineProperty(win, 'localStorage', { configurable: true, get: () => store(ls, win, true) });
|
|
Object.defineProperty(win, 'sessionStorage', { configurable: true, get: () => store(tab, win, false) });
|
|
if (channel) win.BroadcastChannel = class { constructor(name) { this.name = name; (b.chans = b.chans || []).push({ c: this, win }); }
|
|
postMessage(data) { const msg = JSON.parse(JSON.stringify(data)); for (const o of b.chans) if (o.c !== this && o.c.name === this.name && !o.win.closed && o.c.onmessage) later(() => o.c.onmessage({ data: msg })); }
|
|
close() {} };
|
|
if (locks) Object.defineProperty(win.navigator, 'locks', { configurable: true, value: {
|
|
request(name, o, cb) {
|
|
const cur = held.get(name);
|
|
if (cur && !cur.win.closed && !o.steal) { if (o.ifAvailable) return win.Promise.resolve().then(() => cb(null)); return win.Promise.reject(new win.Error('busy')); }
|
|
if (cur) { held.delete(name); cur.reject(new win.DOMException('stolen', 'AbortError')); }
|
|
return new win.Promise((res, rej) => { const me = { win, reject: rej }; held.set(name, me);
|
|
win.Promise.resolve().then(() => cb({ name })).then((v) => { if (held.get(name) === me) held.delete(name); res(v); }, rej); });
|
|
} } });
|
|
},
|
|
// A tab closing: its locks go with it.
|
|
close(win) { win.closed = true; for (const [k, v] of held) if (v.win === win) held.delete(k); wins.delete(win); },
|
|
};
|
|
return b;
|
|
}
|
|
const flush = (n = 3) => new Promise((r) => { const go = (i) => (i ? setTimeout(() => go(i - 1), 2) : r()); go(n); });
|
|
|
|
module.exports = { load, seed, browser, flush };
|