2.3 KiB
Prefecture Map Generator
A browser-based procedural prefecture map generator.
Project layout
src/- application modules and web workersstyles/- application stylestests/- reusable browser and Node.js testsscripts/- local development server helpersdocs/- design history and release verificationarchive/- recoverable historical and legacy files, excluded from the active appindex.html- application entry point
Run locally
On Windows:
scripts\start_server.bat 8000
On macOS or Linux:
./scripts/start_server.sh 8000
Then open http://127.0.0.1:8000/.
Tests
Run the aggregate Node.js regression runner:
node tests/test-all.mjs
Heavy full-map shards can also be run independently, which is the recommended CI layout for memory-constrained workers:
node tests/additional-generation-unit.mjs
node tests/additional-generation-coverage-worker.mjs
node tests/test.js --suite=core
node tests/test.js --suite=terrain
node tests/test.js --suite=terrain-name
node tests/test.js --suite=admin
node tests/test.js --suite=patch
node tests/test.js --suite=patch-large
node tests/test.js --suite=determinism-114514
Run the focused additional-generation release gates:
node tests/patch-worker-mirror-sync.mjs
node tests/patch-worker-cancel.mjs
node tests/additional-generation-max-worker.mjs
The maximum-visible Expansion gate accepts a world seed and Variant through environment variables. CI should run these as independent matrix jobs rather than retaining multiple full worlds in one process:
PATCH_TEST_WORLD_SEED=12345 PATCH_TEST_VARIANT=0 node tests/additional-generation-max-worker.mjs
PATCH_TEST_WORLD_SEED=54321 PATCH_TEST_VARIANT=1 node tests/additional-generation-max-worker.mjs
Run the browser smoke profile:
node tests/run-additional-generation-browser.mjs
Run the 20-sample maximum-visible Expansion browser profile:
BROWSER_E2E_PROFILE=release \
BROWSER_E2E_WORKLOADS=expansion-max-visible \
node tests/run-additional-generation-browser.mjs
The browser test page is also available at http://127.0.0.1:8000/tests/test.html.
For the current r3 additional-generation verification record, see docs/additional-generation-release-verification-20260810.md.