bundle a WASM version of ca65, convert build scripts to a universal node format - only dependency now is node

Author: kirjavascript

README.md

@@ -440,11 +440,9 @@ Dictate if the NTSC or PAL gameplay mechanics should be used. Should automatical
 
 ## Development
 
-To build, you need a copy of `node` and `cc65` installed on your system.
+To build, you need a copy of `node` installed on your system. No other dependencies are required.
 
-Provide a `clean.nes` file of the unpatched ROM and run `sh build.sh` in a shell or `build.bat` on Windows.
-
-CHR files are autogenerated from PNG on build, and nametables are generated via JS.
+Provide a `clean.nes` file of the unpatched ROM and run `node build.js`
 
 This project descends from the TAUS disassembly of NES Tetris and has been heavily modified. Large parts have been replaced, lots of optimisations, removal of unused code, non-game-mechanics related bugfixes, tooling, and different approaches to the disassembly work itself has taken place.
 

build.bat

@@ -0,0 +1,176 @@
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const { spawnSync } = require('child_process');
+
+console.log('TetrisGYM buildscript');
+console.time('build');
+
+const mappers = [1, 3, 4, 5];
+
+// options handling
+
+const args = process.argv.slice(2);
+
+if (args.includes('-h')) {
+    console.log(`usage: node [-h] [-v] [-m<${mappers.join('|')}>] [-a] [-s] [-k]
+
+-m  mapper
+-a  faster aeppoz + press select to end game
+-s  disable highscores/SRAM
+-k  Famicom Keyboard support
+-h  you are here
+`);
+    process.exit(0);
+}
+
+const compileFlags = [];
+
+// compiler options
+
+const nativeCC65 = process.env.PATH.split(path.delimiter).some((dir) =>
+    fs.statSync(path.join(dir, 'cc65'), { throwIfNoEntry: false })?.isFile(),
+);
+
+console.log(`using ${nativeCC65 ? 'system' : 'wasm'} ca65/ld65`);
+
+// mapper options
+
+const mapper = args.find((d) => d.startsWith('-m'))?.slice(2) ?? 1;
+
+if (!mappers.includes(+mapper)) {
+    console.error(
+        `Invalid INES_MAPPER - options are ${mappers
+            .map((d) => `-m${d}`)
+            .join(', ')}`,
+    );
+    process.exit(0);
+}
+
+// compileFlags
+
+compileFlags.push('-D', `INES_MAPPER=${mapper}`);
+
+console.log(`using mapper ${mapper}`);
+
+if (args.includes('-a')) {
+    compileFlags.push('-D', 'AUTO_WIN=1');
+    console.log('using fast aeppoz');
+}
+
+if (args.includes('-k')) {
+    compileFlags.push('-D', 'KEYBOARD=1');
+    console.log('using Famicom Keyboard support');
+}
+
+if (args.includes('-s')) {
+    compileFlags.push('-D', 'SAVE_HIGHSCORES=0');
+    console.log('highscore saving disabled');
+}
+
+console.log();
+
+// build / compress nametables
+
+console.time('nametables');
+require('./src/nametables/build');
+console.timeEnd('nametables');
+
+// PNG -> CHR
+
+console.time('CHR');
+
+const png2chr = require('./tools/png2chr/convert');
+
+const dir = path.join(__dirname, 'src', 'chr');
+
+fs.readdirSync(dir)
+    .filter((name) => name.endsWith('.png'))
+    .forEach((name) => {
+        const chr = png2chr(fs.readFileSync(path.join(dir, name)));
+        const dst = path.join(dir, name.replace('.png', '.chr'));
+        fs.writeFileSync(dst, chr);
+    });
+
+console.timeEnd('CHR');
+
+// build object files
+
+function handleSpawn(exe, ...args) {
+    const output = spawnSync(exe, args).output.flatMap(
+        (d) => d?.toString() || [],
+    );
+    if (output.length) {
+        console.log(output.join('\n'));
+        process.exit(0);
+    }
+}
+
+const ca65bin = nativeCC65 ? ['ca65'] : ['node', './tools/assemble/ca65.js'];
+
+console.time('assemble');
+
+handleSpawn(
+    ...ca65bin,
+    ...compileFlags,
+    ...'-g src/header.asm -o header.o'.split(' '),
+);
+
+handleSpawn(
+    ...ca65bin,
+    ...compileFlags,
+    ...'-l tetris.lst -g src/main.asm -o main.o'.split(' '),
+);
+
+console.timeEnd('assemble');
+
+// link object files
+
+const ld65bin = nativeCC65 ? ['ld65'] : ['node', './tools/assemble/ld65.js'];
+
+console.time('link');
+
+handleSpawn(
+    ...ld65bin,
+    ...'-m tetris.map -Ln tetris.lbl --dbgfile tetris.dbg -o tetris.nes -C src/tetris.nes.cfg main.o header.o'.split(
+        ' ',
+    ),
+);
+
+console.timeEnd('link');
+
+// create patch
+
+if (!fs.existsSync('clean.nes')) {
+    console.log('clean.nes not found, skipping patch creation');
+} else {
+    console.time('patch');
+    const patcher = require('./tools/patch/create');
+    patcher('clean.nes', 'tetris.nes', 'tetris.bps');
+    console.timeEnd('patch');
+}
+
+// stats
+
+console.log();
+
+if (fs.existsSync('tetris.map')) {
+    const memMap = fs.readFileSync('tetris.map', 'utf8');
+
+    console.log((memMap.match(/PRG_chunk\d+\s+0.+$/gm) ?? []).join('\n'));
+}
+
+function hashFile(filename) {
+    if (fs.existsSync(filename)) {
+        const shasum = crypto.createHash('sha1');
+        shasum.update(fs.readFileSync(filename));
+        console.log(`${filename} => ${shasum.digest('hex')}`);
+    }
+}
+
+hashFile('tetris.nes');
+hashFile('tetris.bps');
+
+console.log();
+
+console.timeEnd('build');

build.js

@@ -47,10 +47,10 @@ function drawRect(buffer, x, y, w, h, offset) {
 
 function drawAttrs(buffer, attrs) {
     const palettes = p => p.trim().match(/.+\n.+$/gm)
-        .flatMap(line=>(
-            [t,b]=line.split('\n'),
-            t.trim().match(r=/../g).map((d,i)=>d+b.trim().match(r)[i])
-        ))
+        .flatMap(line=>{
+            const [t,b]=line.split('\n');
+            return t.trim().match(r=/../g).map((d,i)=>d+b.trim().match(r)[i])
+        })
         .map(d=>+('0b'+[...d].reverse().map(d=>(+d).toString(2).padStart(2,0)).join``));
 
     [

build.sh

@@ -0,0 +1,9 @@
+cc65 binaries ported to WebAssembly for TetrisGYM
+
+generated with emscripten 
+
+```bash
+emmake make ld65 CC=emcc CFLAGS="-O3 -Wall" -Isrc/common/ LD=emcc OBJDIR="" HOST_OBJEXTENSION=".o" LDFLAGS="-sEXPORTED_RUNTIME_METHODS=FS -s FORCE_FILESYSTEM=1 -lnodefs.js -lnoderawfs.js"
+```
+
+Original source: https://github.com/cc65/cc65