Split the game page into partials under src/, assembled into one index.html at build
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
This commit is contained in:
parent
295e68cc46
commit
67a40942b4
113 changed files with 5584 additions and 5195 deletions
52
scripts/build.js
Normal file
52
scripts/build.js
Normal file
|
|
@ -0,0 +1,52 @@
|
|||
#!/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}/`);
|
||||
Loading…
Add table
Add a link
Reference in a new issue