site/index.html (900 KB of HTML, CSS and JS in one file) becomes src/: a shell (src/index.html), styles/ and game/, concatenated in path order by scripts/lib/page.js. The assembled page is byte-identical to the old file, so load time and in-game performance are unchanged. - scripts/build.js replaces build.sh (same env vars, same output) - npm run dev: a zero-dependency dev server that assembles on every request - tests assemble the page in memory; npm test runs every tests/*.test.js - perf-bench takes --base-ref to build a git ref's page - scripts/legacy/split-index-html.js is the splitter, kept for older branches
52 lines
3.4 KiB
JavaScript
52 lines
3.4 KiB
JavaScript
#!/usr/bin/env node
|
|
// Builds the deployable site into _site/ (or $OUT) for GitHub Pages: copies the static files in site/,
|
|
// assembles the game page from src/ into one index.html, and stamps the version (from package.json) and
|
|
// the build date into the files that carry them. The output is plain static files and nothing else,
|
|
// because GitHub Pages is where the game lives (docs/adr/0001-github-pages-only.md).
|
|
//
|
|
// npm run build VERSION, BUILD_DATE and OUT can be set in the environment
|
|
// REQUIRE_NOTES=1 npm run build fail when CHANGELOG.md has no bullets for this version
|
|
const fs = require('node:fs');
|
|
const path = require('node:path');
|
|
const { execFileSync } = require('node:child_process');
|
|
const { assemble, ROOT } = require('./lib/page');
|
|
|
|
const VERSION = process.env.VERSION || require(path.join(ROOT, 'package.json')).version;
|
|
const BUILD_DATE = process.env.BUILD_DATE || new Date().toISOString().slice(0, 10);
|
|
const OUT = path.resolve(ROOT, process.env.OUT || '_site');
|
|
const die = (msg) => { console.error(`error: ${msg}`); process.exit(1); };
|
|
|
|
if (!/^[0-9]+\.[0-9]+\.[0-9]+([-.+][0-9A-Za-z.-]+)?$/.test(VERSION)) die(`VERSION '${VERSION}' is not a semantic version`);
|
|
if (!/^\d{4}-\d{2}-\d{2}$/.test(BUILD_DATE)) die(`BUILD_DATE '${BUILD_DATE}' is not YYYY-MM-DD`);
|
|
if (OUT === ROOT || OUT === path.join(ROOT, 'site') || OUT === path.join(ROOT, 'src')) die(`refusing to build into ${OUT}`);
|
|
|
|
fs.rmSync(OUT, { recursive: true, force: true });
|
|
fs.cpSync(path.join(ROOT, 'site'), OUT, { recursive: true });
|
|
if (fs.existsSync(path.join(OUT, 'index.html'))) die('site/index.html must not exist: the page is assembled from src/');
|
|
fs.writeFileSync(path.join(OUT, 'index.html'), assemble().html);
|
|
|
|
for (const f of ['index.html', 'sitemap.xml', 'llms.txt', 'sw.js']) {
|
|
const p = path.join(OUT, f);
|
|
fs.writeFileSync(p, fs.readFileSync(p, 'utf8').replaceAll('__VERSION__', VERSION).replaceAll('__BUILD_DATE__', BUILD_DATE));
|
|
}
|
|
|
|
// Release notes for this version, baked into the page ("What's new") and published as version.json so
|
|
// open games can spot a newer release.
|
|
const notes = execFileSync(process.execPath, [path.join(__dirname, 'release-notes.js'), VERSION], { encoding: 'utf8' });
|
|
if (process.env.REQUIRE_NOTES === '1' && notes === '[]') die(`CHANGELOG.md has no '## [${VERSION}]' section with bullets (still under [Unreleased]?)`);
|
|
const page = path.join(OUT, 'index.html'), PH = '/*__RELEASE_NOTES__*/[]', html = fs.readFileSync(page, 'utf8');
|
|
if (!html.includes(PH)) die('release-notes placeholder missing from the page');
|
|
// Function replacer: no $& / $$ expansion. Escape "<" so a note can never close the <script>.
|
|
fs.writeFileSync(page, html.replace(PH, () => notes.replace(/</g, '\\u003c')));
|
|
fs.writeFileSync(path.join(OUT, 'version.json'), JSON.stringify({ version: VERSION, date: BUILD_DATE, notes: JSON.parse(notes) }, null, 2) + '\n');
|
|
|
|
// Nothing may ship half-stamped.
|
|
const left = [];
|
|
const scan = (dir) => { for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
|
|
const p = path.join(dir, e.name);
|
|
if (e.isDirectory()) scan(p);
|
|
else if (/__VERSION__|__BUILD_DATE__/.test(fs.readFileSync(p, 'latin1'))) left.push(path.relative(OUT, p));
|
|
} };
|
|
scan(OUT);
|
|
if (left.length) die(`unreplaced placeholders left in ${left.join(', ')}`);
|
|
console.log(`Built Series of Tubes ${VERSION} (${BUILD_DATE}) into ${path.relative(ROOT, OUT) || OUT}/`);
|