- docs/adr/0001: GitHub Pages is the only host, not open for renegotiation - docs/adr/0002: source in many files, shipped as one page assembled at build - tests/pages.test.js: builds stay static files Pages can serve, all local references resolve, only release.yml deploys and only via the Pages actions - tests/build.test.js: partial naming and layout rules - new skills: github-pages, edit-the-game; add-strings, performance, release and write-tests updated for src/, sorted dictionaries and --base-ref - CLAUDE.md, ARCHITECTURE.md, CONTRIBUTING.md (incl. porting older branches), README.md and the PR template describe the new layout
55 lines
3.3 KiB
JavaScript
55 lines
3.3 KiB
JavaScript
const test = require('node:test');
|
|
const assert = require('node:assert/strict');
|
|
const fs = require('node:fs');
|
|
const path = require('node:path');
|
|
const { execFileSync } = require('node:child_process');
|
|
|
|
const OUT = require('node:fs').mkdtempSync(require('node:path').join(require('node:os').tmpdir(), 'tubes-build-'));
|
|
const root = path.join(__dirname, '..');
|
|
|
|
test('build stamps version and date into the site', () => {
|
|
execFileSync(process.execPath, ['scripts/build.js'], { cwd: root, env: { ...process.env, OUT, VERSION: '9.9.9', BUILD_DATE: '2030-01-01' } });
|
|
const html = fs.readFileSync(path.join(OUT, 'index.html'), 'utf8');
|
|
assert.match(html, /const APP_VERSION='9\.9\.9'/);
|
|
assert.match(html, /"softwareVersion": "9\.9\.9"/);
|
|
assert.match(fs.readFileSync(path.join(OUT, 'sitemap.xml'), 'utf8'), /<lastmod>2030-01-01<\/lastmod>/);
|
|
for (const f of ['favicon.svg', 'favicon.ico', 'apple-touch-icon.png', 'icon-192.png', 'icon-512.png', 'site.webmanifest', 'robots.txt', 'images/og-image.png', '404.html', 'CNAME', 'version.json']) {
|
|
assert.ok(fs.existsSync(path.join(OUT, f)), `${f} is shipped`);
|
|
}
|
|
});
|
|
|
|
test('version.json carries the release notes from the changelog', () => {
|
|
execFileSync(process.execPath, ['scripts/build.js'], { cwd: root, env: { ...process.env, OUT, VERSION: '1.0.0', BUILD_DATE: '2026-10-23' } });
|
|
const v = JSON.parse(fs.readFileSync(path.join(OUT, 'version.json'), 'utf8'));
|
|
assert.equal(v.version, '1.0.0');
|
|
assert.ok(v.notes.length >= 5);
|
|
assert.ok(v.notes.every((n) => !n.startsWith('-')));
|
|
});
|
|
|
|
test('head carries the SEO and social metadata', () => {
|
|
const html = require('../scripts/lib/page').assemble().html;
|
|
for (const needle of ['<link rel="canonical" href="https://seriesoftub.es/">', 'property="og:image"', 'name="twitter:card"', 'application/ld+json', 'rel="manifest"', 'name="description"']) {
|
|
assert.ok(html.includes(needle), `missing ${needle}`);
|
|
}
|
|
for (const block of html.match(/<script type="application\/ld\+json">([\s\S]*?)<\/script>/g)) {
|
|
JSON.parse(block.replace(/<\/?script[^>]*>/g, ''));
|
|
}
|
|
});
|
|
|
|
test('a release build refuses to ship without release notes', () => {
|
|
assert.throws(() => execFileSync(process.execPath, ['scripts/build.js'], { cwd: root, stdio: 'pipe', env: { ...process.env, OUT, VERSION: '9.9.9', REQUIRE_NOTES: '1' } }));
|
|
assert.throws(() => execFileSync(process.execPath, ['scripts/build.js'], { cwd: root, stdio: 'pipe', env: { ...process.env, OUT, VERSION: '1.0; rm -rf /' } }), 'junk versions are rejected');
|
|
});
|
|
|
|
test('src: partials follow the layout rules (docs/adr/0002-one-page-assembled-at-build.md)', () => {
|
|
const { listFiles, assemble } = require('../scripts/lib/page');
|
|
const src = path.join(root, 'src');
|
|
for (const f of listFiles(src)) {
|
|
if (f === 'index.html') continue;
|
|
assert.match(f, /^(styles\/(\d\d-[a-z0-9-]+\/)*\d\d-[a-z0-9-]+\.css|game\/(\d\d-[a-z0-9-]+\/)*\d\d-[a-z0-9-]+\.js)$/, `${f}: name it NN-lower-case under styles/ or game/`);
|
|
}
|
|
const { html, map } = assemble();
|
|
assert.equal((html.match(/^const ACT=\{$/gm) || []).length, 1, 'ACT is declared once; other action files use Object.assign(ACT,{…})');
|
|
assert.equal((html.match(/<script>/g) || []).length, 2, 'the language loader and the game: one inline game script');
|
|
assert.ok(map.length > 50 && map.every((m) => m.to >= m.from), 'the line map covers every partial');
|
|
});
|