From 57faf9e36aae731e4b01aec9cc1fb42c7e96e1d3 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Mon, 13 Apr 2026 15:12:18 +0000
Subject: [PATCH] commit built ROMs alongside .ne sources
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The compiler is deterministic: rebuilding any example produces
a byte-identical ROM, verified across all 22 examples and all
four mappers (NROM, MMC1, UxROM, MMC3). That means the .nes
files are reproducible artefacts and can live next to their
sources without drift.

Benefits:

- Users can clone the repo and open any example in an emulator
  without installing a Rust toolchain or running the compiler.
- The emulator harness can trust examples/*.nes directly, so its
  CI job no longer needs a compiler build or a "compile all
  examples" loop — it just boots jsnes against the committed
  ROMs and diffs each against its golden.
- ROM diffs in PRs are now meaningful: "this compiler change
  flipped 17 bytes in hello_sprite.nes" is visible review
  signal, not hidden behind the emulator golden.

Guard rails so the ROMs don't drift from their sources:

- .gitignore no longer excludes *.nes.
- The `examples` CI job rebuilds every .ne into /tmp and fails
  loudly (with a GitHub error annotation pointing at the exact
  cargo command to rerun) if any committed ROM differs.
- scripts/pre-commit does the same check locally.
- CLAUDE.md now states that editing a .ne file requires
  rebuilding its .nes in the same commit, so future agents
  won't miss the invariant.

Total footprint: 22 ROMs, 624 KB (avg 28 KB each — most are
NROM 24 KB; two banked examples are larger).

https://claude.ai/code/session_01BcCcHi6FUmTh8jC7UgkA3A
---
 .github/workflows/ci.yml            |  33 +++++++++++++++++-----------
 .gitignore                          |   1 -
 CLAUDE.md                           |  31 +++++++++++++++++++-------
 examples/arrays_and_functions.nes   | Bin 0 -> 24592 bytes
 examples/audio_demo.nes             | Bin 0 -> 24592 bytes
 examples/bitwise_ops.nes            | Bin 0 -> 24592 bytes
 examples/bouncing_ball.nes          | Bin 0 -> 24592 bytes
 examples/coin_cavern.nes            | Bin 0 -> 24592 bytes
 examples/comparisons.nes            | Bin 0 -> 24592 bytes
 examples/function_chain.nes         | Bin 0 -> 24592 bytes
 examples/hello_sprite.nes           | Bin 0 -> 24592 bytes
 examples/inline_asm_demo.nes        | Bin 0 -> 24592 bytes
 examples/logic_ops.nes              | Bin 0 -> 24592 bytes
 examples/loop_break_continue.nes    | Bin 0 -> 24592 bytes
 examples/match_demo.nes             | Bin 0 -> 24592 bytes
 examples/mmc1_banked.nes            | Bin 0 -> 57360 bytes
 examples/mmc3_per_state_split.nes   | Bin 0 -> 24592 bytes
 examples/palette_and_background.nes | Bin 0 -> 24592 bytes
 examples/platformer.nes             | Bin 0 -> 24592 bytes
 examples/scanline_split.nes         | Bin 0 -> 24592 bytes
 examples/sprites_and_palettes.nes   | Bin 0 -> 24592 bytes
 examples/state_machine.nes          | Bin 0 -> 24592 bytes
 examples/structs_enums_for.nes      | Bin 0 -> 24592 bytes
 examples/two_player.nes             | Bin 0 -> 24592 bytes
 examples/uxrom_banked.nes           | Bin 0 -> 90128 bytes
 scripts/pre-commit                  |  24 ++++++++++++++++++++
 26 files changed, 67 insertions(+), 22 deletions(-)
 create mode 100644 examples/arrays_and_functions.nes
 create mode 100644 examples/audio_demo.nes
 create mode 100644 examples/bitwise_ops.nes
 create mode 100644 examples/bouncing_ball.nes
 create mode 100644 examples/coin_cavern.nes
 create mode 100644 examples/comparisons.nes
 create mode 100644 examples/function_chain.nes
 create mode 100644 examples/hello_sprite.nes
 create mode 100644 examples/inline_asm_demo.nes
 create mode 100644 examples/logic_ops.nes
 create mode 100644 examples/loop_break_continue.nes
 create mode 100644 examples/match_demo.nes
 create mode 100644 examples/mmc1_banked.nes
 create mode 100644 examples/mmc3_per_state_split.nes
 create mode 100644 examples/palette_and_background.nes
 create mode 100644 examples/platformer.nes
 create mode 100644 examples/scanline_split.nes
 create mode 100644 examples/sprites_and_palettes.nes
 create mode 100644 examples/state_machine.nes
 create mode 100644 examples/structs_enums_for.nes
 create mode 100644 examples/two_player.nes
 create mode 100644 examples/uxrom_banked.nes

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 5128abe..72eec96 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -58,12 +58,26 @@ jobs:
       - uses: dtolnay/rust-toolchain@stable
       - uses: Swatinem/rust-cache@v2
       - run: cargo build --release
-      - name: Compile all .ne examples
+      - name: Verify committed ROMs match their .ne sources
+        # Every example has a committed .nes file under examples/. The
+        # compiler is deterministic (verified: same input → byte-identical
+        # output), so rebuilding each example into a tmp directory and
+        # diffing against the committed ROM catches "someone edited a .ne
+        # file but forgot to regenerate the ROM" at PR time.
         run: |
+          mkdir -p /tmp/reprotest
+          fail=0
           for f in examples/*.ne; do
-            echo "==> Compiling $f"
-            cargo run --release -- build "$f"
+            name=$(basename "$f" .ne)
+            ./target/release/nescript build "$f" --output "/tmp/reprotest/$name.nes"
+            if ! cmp -s "examples/$name.nes" "/tmp/reprotest/$name.nes"; then
+              echo "::error file=examples/$name.ne::committed examples/$name.nes is stale; rerun \`cargo run --release -- build examples/$name.ne\` and commit the new ROM"
+              fail=1
+            fi
           done
+          if [ $fail -ne 0 ]; then
+            exit 1
+          fi
       - name: Verify ROMs are valid iNES
         run: |
           for f in examples/*.nes; do
@@ -83,8 +97,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
-      - uses: Swatinem/rust-cache@v2
       - uses: actions/setup-node@v4
         with:
           node-version: '22'
@@ -110,14 +122,9 @@ jobs:
             libxkbcommon0 \
             libxrandr2 \
             libasound2t64
-      - name: Build compiler
-        run: cargo build --release
-      - name: Compile all .ne examples
-        run: |
-          for f in examples/*.ne; do
-            echo "==> Compiling $f"
-            ./target/release/nescript build "$f"
-          done
+      # No compiler build needed — the `.nes` files are committed
+      # alongside their `.ne` sources, and the `examples` CI job
+      # fails on any stale ROM, so the emulator job can trust them.
       - name: Install emulator harness dependencies
         working-directory: tests/emulator
         run: npm ci
diff --git a/.gitignore b/.gitignore
index 68204c8..3475059 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,3 @@
 /target
-*.nes
 *.dbg
 *.map
diff --git a/CLAUDE.md b/CLAUDE.md
index aa7bb6a..3be1741 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -15,6 +15,13 @@ re-derive the project conventions from scratch.
   pipeline.
 - Examples live in `examples/*.ne`. Every example is expected to compile
   cleanly and has a pinned emulator golden — see below.
+- **`examples/*.nes` is committed.** The compiler is deterministic
+  (same source → byte-identical ROM), so the ROMs travel with the
+  repo. If you edit any `.ne` file you **must** rebuild its `.nes`
+  in the same commit — CI's `examples` job rebuilds each ROM into a
+  tmp path and fails if the committed version differs, pointing at
+  the exact `cargo run -- build examples/<name>.ne` to run. The
+  pre-commit hook under `scripts/pre-commit` catches this locally.
 - `docs/future-work.md` lists the remaining gaps. If you implement
   something from that file, update the doc in the same PR.
 
@@ -63,22 +70,30 @@ tests/emulator/
 The harness is **separate** from `cargo test`. You have to run it by hand:
 
 ```bash
-# 1. Build every example first. The harness reads pre-built .nes files
-#    from examples/ — it will not invoke cargo.
-cargo build --release
-for f in examples/*.ne; do ./target/release/nescript build "$f"; done
-
-# 2. Install node deps (once per worktree; node_modules/ is gitignored).
+# 1. Install node deps (once per worktree; node_modules/ is gitignored).
 cd tests/emulator
 npm install          # or `npm ci` in CI
 
-# 3. Verify every example still matches its golden.
+# 2. Verify every committed ROM still matches its golden.
 node run_examples.mjs
-# → "21/21 ROMs match their goldens" on success
+# → "22/22 ROMs match their goldens" on success
 # → FAIL / MISS lines + `actual/<name>.png`, `actual/<name>.diff.png`,
 #   `actual/<name>.wav` written for any ROM that mismatched
 ```
 
+The harness reads the committed `examples/*.nes` files directly —
+since those are rebuilt and diffed by the `examples` CI job, the
+emulator job doesn't need a compiler toolchain at all. If you're
+iterating on the compiler locally, rebuild the example ROM(s) you
+care about before re-running the harness:
+
+```bash
+cargo build --release
+./target/release/nescript build examples/hello_sprite.ne
+# then:
+(cd tests/emulator && node run_examples.mjs)
+```
+
 ### Updating goldens
 
 If a change is supposed to flip goldens (you added a new example, changed
diff --git a/examples/arrays_and_functions.nes b/examples/arrays_and_functions.nes
new file mode 100644
index 0000000000000000000000000000000000000000..71509e643f604e2eaf35d9bc62d920d7b819514d
GIT binary patch
literal 24592
zcmeI)KWGzC90&0C=k9V>2QOOF+Cff{(u#<PLy>?-Q3(=65X3Qy7#CeTmDu(z;*$;z
zM#vI;;41{gT`(z1(<zJKScjHQ<(wQ8>+dz~QBZIezL)U3-}}8^-sOE>=G?k|XM%H<
zUvppD>GQF)z5B{C%@WNMeIm8eg^QY{+DmPyd8+-?vhyN|e^}OLEk<u{f3=vfl*tzJ
zTFh^;pv4N?gRjHB1})bSiM^_Wgx02TR2N)EA$B2gVXqdrtmMLEUW;6I(uL`~#$8r)
z;dEa6+j^sJ_N)t+^S%j}opa$zUOVQpGcH_mA*S8ihKlW)D%w+;Nqbv!X&1DRc1=rZ
zr?ls4zO-{XkhZJ~(lR9t%YM?G8QEt8SzYf|uXT<0(a)l{zGc-1UCT3R{F?FTotNib
zIWXSLCe8RWn=~0HKY85MAvG({6o#Wnc0$<?m)%nD+-Ht=qJwd7Z)wYGmety9??ATc
z8hod(6B$0uGqDxZU1Z{uyL&V)(mkYc(ZtHL89n4)SH-4CgN@;!NQX2cJ0r61?LBp>
zXF2WbbB{_Z?>#yGkgG+Po5hyr`dqQUvA^BB)SX4HO23W$X(m-;zfUc>=hEYR(@=p~
zQibGMS09mmp1B>q_{XOgUPor3>3(-jE}BA^MpKHdX!x>xXGB&fdZtKS#lv0kp)NWd
z+AEz~JG>#53*$!K_mm90^+9H2?O-bKCZ&-xn_`(Jw`g*Qj<52x^0Hz?#mEX7$;1jh
znp&<)DGf_$JM5Iwo0GgVMloC;e6w7!x{`Gz>Tl{R^)%hZ1px>^00Izz00bZa0SG_<
z0uX=z1Rwwb2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb
z2tWV=5P$##AOHafK;Tb-3#;tIqt)`Pd19Kg<?_7im@nsl41fdz5P$##AOHafKmY;|
jfB*y_009U<00Izz00bZa0SG_<0uX=z1Rwx`|3=_9#YT;O

literal 0
HcmV?d00001

diff --git a/examples/audio_demo.nes b/examples/audio_demo.nes
new file mode 100644
index 0000000000000000000000000000000000000000..b72ed1002d25cf8107c45d103b66eb5aaa9d94db
GIT binary patch
literal 24592
zcmeI)Ply{;90%|>ZzjomGx?vm)m7>!b|F$lrH4`i9SW7Oj3Nr2JnTi9qoB||lyw!J
zU|~u@P$L92_+(#~J*-t!wC*-ris_-`px{k<Xs8Eu77J}@HU3_TVJp3h@SRD1^PBg3
z^P8E^Os;wM@C&n!!=}sPPrc~GuBbQuz_5gci4!LGM8>t@iG)Ro7a5T_QId%a+sni9
zO~ZPu%jn~nzq*VY%G@sVx-8RW*)Gdn8D6?QZ<*Sy@z5MhvLW@RP)c$(qfoXXv|%!q
zwb_gfbJH<tv-@mlOvfCXRcv@@I(D~ybz6PJhJDj{vo?Fwh6B^Fs?8p@;VB!+boXXi
zmCd567^bSKrd-X^Ta+{H4p{2O;n^OW-1ik)hS#VfwbO7?J}T3er~JI#dbD4mt)P9o
zT~24ra|ySUZe-q5d9$SoW~_XwMN|u?wcZ`Ia#}a5DreSJQDx|ulFAxK1$0!H2K0P9
zdMGNVf>Bjh2fNdZVet=VjdRD@R(5o(4i+bqZrDkW+gsGNw7jE{s>O}|-A<`$y7GzC
zm5zPl9fx-~*X54ONAmVcFv_EbZcjYTPv-8`?#rHXv)+Yas@;WuN?C8t)$abw{3I1e
zRQyeQ3))Zb|A?*Uhxy4HM@{_r<37E6qx_JM3OYxuN6!btS7}mlC?;1M|Jomn)5Gy*
z{}k0Xl}E8TKcDgB1m!`+Ny|OH{};z!S?5VM`krDg8WpKy$@U?$NgnUsqC=fD&>2<K
zSyhTx`#U@q#-)F++ojh_wbEMgnc^RXZXqtP!dLm%^851FgN@+r;Kg7rxZz*)KlPXW
zm;3|%tbbGfEYHbR`Hnm$kI3icLHU?`K<4G2;&*XL{3r(Ej5sZf_)xqnPKdX}k~k_}
z5gXr~`SzQyzx?9#Ivd}*es!DC0PTPN8QW8D)c4k(q;I1>9=DFS-fwB%(rzn!vrj)R
zH#9t{N5)BJ=;ff$6KgZk{G7A4i=wzN+@?2(wUygeyuH#s)sCVu76?E90uX=z1Rwwb
z2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb2tWV=5P$##
zAOHafKmY;|fB*y_009U<;J+5w*kYUfT=S5ALw61}n@je3mYUN)20#J<2tWV=5P$##
nAOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uX?}|3=_%tyDb@

literal 0
HcmV?d00001

diff --git a/examples/bitwise_ops.nes b/examples/bitwise_ops.nes
new file mode 100644
index 0000000000000000000000000000000000000000..94e82bb72437bec77fbe3f9d5d28290d40b74967
GIT binary patch
literal 24592
zcmeI)&1(}u7zXh9NYZRUvXPp89Aqt0jCfG-AQJ3QsKgq)c=A?+Li`VMD%;itDXi9;
z5poF*Izm9a2_9?%(iW7QM7;H2>8Y$I4;Je?X?9sb!K1>nEiaRKpP9`3*mG{q-kRW?
zB~Rm1TRj+6?ZYRAh0F`N7oJc?+HyW*D$FR854j4n%CK|7bH5wbW-Uhl-27-UVQ3^<
zEYo7y7R$BR&|YunDCg659pRbjFz3<UR0`pc9Z_*@@oeeO<?N_r%TzMw*wMHx<z$ZA
zQPGxD$=vVu8?oKfwp>bb6LxggmMh8JaXXr{<)SSv-QGM5T*HE5AT^5)XvDPKVv(#(
zthZVJ#(VVizEQ`~Md~;&vxe1ftQ#JQcSX(1el*f=*y%eo?XY0Ec6VJbN5k5^u4wy0
zU~?*!Ta9y%;+&V{+*IyWoO>PT+$86va-ZYePMq@xIk#L0nWV4hskpPzKc-)EH?$v(
zc9`5Mtl9HVQX`W4OqzWE%p$eu>d~U*+Uy41ZQL%3HE#EpeHbir%h53=1GnsNv7X(v
zVcRE7<EdjBP5TNpxo8SOAEelIj{dY;R)hGnzl(c=_{TrQ@Bg~HJBVkyzduYp6{ow+
zg<R6RD`ZE=_gwaMlwCS)&ICS9R?ToA>fXI>u%i93g_U5*Y|;fcQy0`rsXYzf7qWJt
zOD|TCp|?r4^Vh`M(3qABnLy?;+r3E3`M8zKOi3*-e-Ufc+@<Ee&dgU=tB<Q%R5g7$
z3#Dg7IHC*>ONu_0R6E}(sktfM8Ks)v?tL{pVD&)O>738&FX~Di;(-7JAOHafKmY;|
zfB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb2tWV=5P$##AOHafKmY;|fB*y_009U<
z00Izz00bZa0SG_<0uX=z1pW<yH(mDjpj(;IOS(BzsVv%4Emo2r2EYIU5P$##AOHaf
nKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1Rwx`|3=^^pH4ce

literal 0
HcmV?d00001

diff --git a/examples/bouncing_ball.nes b/examples/bouncing_ball.nes
new file mode 100644
index 0000000000000000000000000000000000000000..0c92f5751e916a6a364412ae7afb1842411c5712
GIT binary patch
literal 24592
zcmeI)y^9k;7{~E>*}PTmCTH%vY844679tiR0ha?MNYLW`fiyz?gsToMwoz8DG;-Sn
z2OJ?_VP$2mILK8gEwwOQC2M7&c+MndD;rDUy9vKMJTuR3_Oq$;;O_3Wl%hQLK8};;
zo5}d>r4^ZoGZ|;+6RUk(&qR_1iLGZc$tsBz*Hj$-uwpE7;oj2z%7wD7(zyt7QOQL$
z7q!#*=heQ)?sO9s+dEk`cIS3+F01*<Md%~;vFufS)%MXTdktS*@NuQ=Nnb@iE|$H&
zoo~ahUiNXb+_&wkt3Ga*y{4}&`MBXDba!u)G)yBa(`MSTBGpC|Ki#J=dL|0pkEdg?
zyzf(Y%)h&phH1`ZQL&=`aB5|-wFpf(E8hCXz&8T7r`g}19{avnZroe--8D?>&+N0+
zY-FO@r{(P7dbZVnKRx#S)$F_VY|BKi8YUX~M=+9Vq?8FqS}hu@m;0uvzqB6L@2P{@
zmeG%bR9AzOd13Tmy;Kc4+UQ$f)PY-ExW%s~81$a@Ui6IW8QpVFOUG7a8;O-!+x-Mw
zjO&wja=#-dn=b1o^KTAI3{yQ!)$sN3%`i#MI1oSp0R#|0009ILKmY**5I_I{1Q0*~
z0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**
z{z0I1BtGmOb$84YGur8P_x<R8xBO!O3Iq^9009ILKmY**5I_I{1Q0*~0R#|0009IL
SKmY**5I_I{1Q7Ud1bzcpTSuV)

literal 0
HcmV?d00001

diff --git a/examples/coin_cavern.nes b/examples/coin_cavern.nes
new file mode 100644
index 0000000000000000000000000000000000000000..3e72b7f8293cbbc3ae9dce5888d315a613694370
GIT binary patch
literal 24592
zcmeI)KWGzC90&0C=bAr7@RBBJ4G3qE(n<#rhav%wLM2FaadYa>LY!SXl{&l*!bwLX
zWC?xX6ABJ>H!X<QK{7gY(7{j_IVTat`ukn=2-Lw<{9Z1<_q*TwbMHP$*4$pYQ<qX?
z$J*Oo_-Hch9Y1j*5<w(`s2V!W;c_Ix$O~N|l3_F!Ix(*T|C<v%(G_$`_oFM6qfB>&
z*A-)3k?V^5(ct~bxD8rvM+NSBlnZEW3TLA{XB2!60f)4f<E+MECaV=WJI7%zt4YpE
z94=(FKdo2c-isWrX5;FdUE**ptCcyM=5U3BPfzb=jqhHYk`t!vq?w?$;<Tw!tF1`B
zQ!A{FMKT-9fo{F%$BLRad#(At_2MKcJ|A<Ub+_+iqMcZ_-f~Z*P)BqOzR>idTiK>}
zhwVC2b(EqDt%k*umz8sVGETSF!FHckrE_FY>0VARNt0w!xBk>UW&CUx?|2uUON>wb
zDmiccSf$(h${pj@U-(GFTg5%vm2W5Lp?L4LJ?fmcrK#1jDGkf<VLD}=t7qIH$(*Q^
zY0ZsflBUUY+ASVXpp_<^XUcS|-E`gxm*;FLUP&+S^JRTlc~!O5U-#SOQr;<}*|4--
zw51Un>yOx+mfIcarRjfRy*4r<wa(L?`POtAkMmyPhT6(cS-t8Ro%0R`iPg)$yK>%)
zwtC@%+M>=Ob$+6cxcRX8xM@|>>Lz`^b>LJ~37w2;^rNBBE9}(5n=^7}l49Xt@R<lj
z+vv7Y?WgT$?JzvX0Rad=00Izz00bZa0SG_<0uX=z1Rwwb2tWV=5P$##AOHafKmY;|
zfB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb2tWV=5P$##AOHaf{MQ0Y`{Je9Z!Fpe
zwzJr1tTV=XBl}|jBoKfA1Rwwb2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZa
K0SNpv0zUzc0g!P3

literal 0
HcmV?d00001

diff --git a/examples/comparisons.nes b/examples/comparisons.nes
new file mode 100644
index 0000000000000000000000000000000000000000..c09cb40be32728546dadc2c3fceae201752accf5
GIT binary patch
literal 24592
zcmeI)KZ_GV9LDk4na#h-RnDBAAgf3~u@JEk2{;@miySt-fq)2k38{`)Y$L3sG{S<c
z4md)<Hz3@l%T+0DMGRMn#L7bPoXO!5!lhUE?uLh7W*&y!52^F;-lMG`5areTSm@`Q
zx;T1iMJD1bh_kcWDjzp8p|eoidKT!cqOG_t<LIXqg~)~b1on3>q;-?ZMVO09E~>ex
z9Zo+T_xkR*k&Nx#tQxzsU7X5lesU4{h<z;9s(xzvXq9UXKb`k+wOkAQblS(Ia_yw^
zHvH}tAGgZhmY=TqxKpm3@zZ4=H+@9z?X5_oR2eb<<tAa&M9kGrbH5Oaw>@;%^oQGN
z%p%)+)3CjvCm05DD5Z&pO3oU`_oP3sSh4eX-v;xGHgeTyscPe;s);83sV@)Kl=Vt^
z;L9J@lshZsd2Lbux~AS=tvBBL(=Uuqe(qN*^+h>ZQ{G!DJHs?|aH^=^mxJ0lqn?DR
zs)h&Cxlx_JTh*|ojJo|r4&3I<ZGJOhCwZ2<NQ_L3O5CqU#a3n;+6GxuyRS`M)JIMI
zpcRZZUDgk#-))eJZmPPe?7r>3>uP<(g#ZEwAb<b@2q1s}0tg_000IagfB*srAb<b@
z2q1s}0tg_000IagfB*srAb<b@2q1s}0tg_000IagfB*srAb<b@2q1s}0to!m0<Xtn
z@AJ65ZJwIpcDudnA9lB0{xJXp0tg_000IagfB*srAb<b@2q1s}0tg_000IagfB*sr
NAb<b@2>dq!e*opn>Hz=%

literal 0
HcmV?d00001

diff --git a/examples/function_chain.nes b/examples/function_chain.nes
new file mode 100644
index 0000000000000000000000000000000000000000..6471e4862ef9cbed09611aa8bc86d9faa03872a6
GIT binary patch
literal 24592
zcmeI)F^dyH6bJA(Gn-^%<0@zFylNE*cnFGEs017jlpsM6zd$U6Sb3$@aTZ%BjHEON
z+bj+^LcovUUUj)DrLBb_mBh+I@qF*1tB7Af_-~d!Z{FJ-c7N&j?ydXlN>Oz@d0*HU
ztF}1Y4df_wDs`u9FcOy>Sr^$5J7rzX2D+fr<ZGaUa^h2k?>XtfmB}f}sg_ecr^bBx
zVR_vSZ#ULyxZ&z4@6B=CHKgK5BvOf^UR|n|M7!!Wr8+HfzUnEdPDq@odjHyQMW*K@
zu2k2pOSK_!z3QEm>a4_NiG<%iP?luI)8ZRf<jsVprng)6TBVOB`-|q=TA<#wGN^?K
z`+Xnr>Bvlyq4e)bzsCEJ8I#GPbfe_?Wd8HEEg8pQ&V!pWSmrTaK9HqTX6+F_gWR}N
z_6s@!p7SyN!Vl97YL@WmS?RP1Td$g7Yb5?7rAJziwHX;bYc78w=5hSTm>0jN{4!a@
zJDMWCt%r>@ZyrXOsYeIXg*W|Qqk7af-dz2thdi9|@Dsmn_j&ha*Xyn~UH&Ic8nj!n
zLAjRYWy==vxMlCO)p(UNKA3(EDx*PW2ALkb9=sV?dx!%95P$##AOHafKmY;|fB*y_
z009U<00Izz00bZa0SG_<0uX=z1Rwwb2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz
z00bZa0SG_<0uX=z1pX4ZxJU0E?{zl)Q$O15bhc%@-KjndfC2&#fB*y_009U<00Izz
i00bZa0SG_<0uX=z1Rwwb2tWV=5P$##AOL~?M&Jiiye}01

literal 0
HcmV?d00001

diff --git a/examples/hello_sprite.nes b/examples/hello_sprite.nes
new file mode 100644
index 0000000000000000000000000000000000000000..97eaccfae1fd468a68bcab0f28c6df9e5cb1e140
GIT binary patch
literal 24592
zcmeI)KWh|07{~GXv$;Q5xGV7zgT*Qmh*$)%2y);MP!16r-#{ASd<UsQEVdCwQhLHR
zivx~u@4?s^n=5TC46%{3vQUik<Zvr{5x#TB@1AF#W%l-S{XM+<XiaO?uHBD~d%ohD
z)0a_sReD|ei!NG;O|P8KT<m%6{F006hAHzOQ8lVo>8<0hTA7$CTdS;AOSS6Ms(Ui~
zw770R9XB;)yyH7%Iy=RA-<2vwE>TLH?RBIYNUXPeeW@-<Y_xk?szTyQyZ5*AmSuWP
z;#PaznpD>%Znt|Eq`E3`QzB1KANQ*~?p8%ql?`hCGkvOH->bQOaQU!NXU}|+*6e$l
z^n>2e^KQsjpO`97jge;S%c99rQ^=%9lb$p(DMIn8ABu_4O|+R96Y_~Q$Nj}C-KEOp
z=1uROIq0qi`#7s?Cp((WgWdTv>SXIS*sagzAPtYx@N39+M$bksM!}4N9VKO3M&p-V
z)P9hDx)e=sI&k;b^>ig=?`ZZd>Pn3(JFd+5_4v)$xl<Mb2q1s}0tg_000IagfB*sr
zAb<b@2q1s}0tg_000IagfB*srAb<b@2q1s}0tg_000IagfB*srAb<b@2q1s}0tg_0
z00IagfWSWx_;9G+o_jak4o|~mdpO*audp|4{}_M*0R#|0009ILKmY**5I_I{1Q0*~
Y0R#|0009ILKmY**5I_I{1pXU=-*}E|$^ZZW

literal 0
HcmV?d00001

diff --git a/examples/inline_asm_demo.nes b/examples/inline_asm_demo.nes
new file mode 100644
index 0000000000000000000000000000000000000000..caee039fce598f613f4c0827dc48776e2b3f35ba
GIT binary patch
literal 24592
zcmeI)KZ_GV7{~EvXEy(?ag#f9dWEba0Yy*_3z2}sff7V)d;=*I@)E2LEw&Lxt~3YR
zEDqcVc@IV_uS#iaVYo_SWubV^+;Lmki}0N+zdU(ncsBca0sHv=ldU9?dOiPKnb(`9
zI^OqUCAUd#&l|5}+_GY9YJA%!#x{(X8!FF!da0z8a3%hCDawaRmy(v!D5Y6S>uB-i
z^xTUuZl-d7&o=WgJH$ELidBd#Mjqp&*Njy^#-Q$XVs$abwYrzYsvF~S-TT|TjktR?
z#_jstR;;eaxLfynvAPmtJ4P0s-b<1Br$sk>_X_P~^($23^e0*M9$lKd)QWcNYiq^&
zO!T;t6NIC%7C*wl&axLCu#tz$^@=pVIWIETecN%}X{4GaYO0jWrdlmKr=PPsgxN(J
zCg`gDK<%|IIQ=XwbTd6%tehU7Z8g(@cKXg&wHG#*Ve^|y$D>!HHzTJ;PLIOPb?%kj
zFg~$;6Mpth)t>du!$C6J4B0+heD_HqlR{4lH945Pn;3J<LI42-5I_I{1Q0*~0R#|0
z009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{
z1Q0*~0R#~EhXNnx@?L)!?zoq3x-%T^#=o*VtX~X3fdB#sAb<b@2q1s}0tg_000Iag
ZfB*srAb<b@2q1s}0tg_000RGwz#mkpaen{+

literal 0
HcmV?d00001

diff --git a/examples/logic_ops.nes b/examples/logic_ops.nes
new file mode 100644
index 0000000000000000000000000000000000000000..511a9efcad5b91b0e4bed6a83389179255b509fd
GIT binary patch
literal 24592
zcmeI)&ubGw6bJCxnQgK;nID@}dkCvYu~kHh2a$kF!4hQg;z>p5K_Mp(f>19d7S@Bf
z(xVY_i5+kX1^)z-LLoiHn^zBpUX&FC4@&EMn|4W{{R0Z$O?W$b^JeDlr^&T<Z{M4-
zERkL-UpxNWX}@#u-iSzek>y2Y-zW~(BH>52Z=A^Tqbc8rE7HsVHKHThg5H+dZwqN?
zq}sx6i>bEAv_*Dr@NHDrr0uq(XKqCqkM^c;Cd%@NLY{-iA<1QURN*k2=5jnb$6+qb
zSv)FmIG^T@+t20MiyW?}bu&Dg=WsL46?t@l!vcpqJ-xBQyb)o+JPwOyB`nd{4a;FA
zR9eLU=#$W@FJcwUcRL~x*rRLkhh}oRLNmEfQ$_?2yT*#;PDNXD`PfY+IQ@*$IT5Y}
zFS>dyF6ly?rG<sy4dv-fH{=EW*n$tE1<hcytDCVy#reak=2%t#XxjmA>m<*>d-2f)
z>WPp3aa8l0YdkuK8XOksE~!zzJ9ID6-KKnLSf=Jwu+Y=_!ws(XlHQxthYB9`bh%$m
z9(9TGahW<RYquY-^I7*fC5P@r15Zcm*MjFgYM`o18#!HS@i(Yt$(EG5*iv$s8@*_&
z(e4|(Rn@o~IpdBM(}#)TTGGmw6N;;o#SfC={S%5WO%|^t#h15_Z)0Jsn7$IBO%AH#
zEXnokS*@Pfp~~31gIKHOqp6HNtF*fDU9QvQkS2d>d%6C){;sZNU8_3%K$K@><od>n
zD)g(P&~dgZ{+(HCYnr07JNQL^VbKUxBb1Ggjm?JdAK-!j1Rwwb2tWV=5P$##AOHaf
zKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb2tWV=5P$##AOHafKmY;|fB*y_
z009U<00Izz00d66z^iTXd1t$}s9);VVy(8y&$3!e|1kgt5P$##AOHafKmY;|fB*y_
g009U<00Izz00bZa0SG_<0uX=z1Rwwb2%H*$|4aa4IsgCw

literal 0
HcmV?d00001

diff --git a/examples/loop_break_continue.nes b/examples/loop_break_continue.nes
new file mode 100644
index 0000000000000000000000000000000000000000..a3792b989d686af3636b6cc19d2d625d18d38a5d
GIT binary patch
literal 24592
zcmeI)&ubGw6bJB`d7E^jQIobtEeh)oiWLtc9;yUf1SLq(gBOoED8zq2dXlEH7jdLV
zBLpQl;1mKLyjE=effWxui6=p%rCubSJSggWyENqBkDDNTx8d!~n|<>ppX|BkPG1<)
zTJ^8#x1IRbj=1yVj#pMiR!4Sw>`B5At703(KD0Wvx!9}2CMtdPs-xP9KiYq9E8}@Y
zZ56atuC4NIHMG9+K6`G4x9gh7pS1ai_vWz84#|i^NkSwc&E;iOkucuR6=bwa!bCr(
zWmJ~1x1amfextH_K*F*9b7L|(B;iCqH!P!l5{^nJ@wfNdDzcjRoQ8Np<PX|_eBI{A
z-?Mr0FYOTdstw8Cv<32)>?ZP$>}K-QNhv9Nl?*2%2|3mK#$)AZS@oi+i;FIJp6eAJ
z=DeDkUi7+`cfsUpuI_S^t3kb^Qp|O}R=#jq!RZOzGixQjo1S?g_kibRzK1+d+t?y?
zi?kf1d%l)EY3lqEr{))wbd^>gBprJFsYp|g7t^(Xk{MS@0ymT7qAQDbi|jJL5K_`~
zWllG<^j7L_q2=P7>@u;$yX@|6-IyPjdC}`+m`jrp?z+*ztF*aJo7d&B!;<2jvvQXv
z_Y1Dsk{73?P0JWJ+aj}8$o{+@D8HMPbBfEGvc%=HTs}Kk-W)791Lg0sa!#e)`Tp1L
znOt`GJx|lab1Lng3H`CVEA!dPgJ&xZoXrg{XB%IYjrY6q<i{|%&K1{xSHUk$67b7F
zo$!pA8`|mUa*$9yc(u}VRNq+22jk>ua@EZ7;u<f0azVXzqjtOIOwCb^Uu25Bv7<4+
z&6Sv^mADgjEAiQJ-QB@4e6{kKe@fLzsF9e)gT{O#j(^~S00bZa0SG_<0uX=z1Rwwb
z2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb2tWV=5P$##
zAOHafKmY;|fB*#krNEn~>Ph8U^^|M6)~Rasn)JR_?f+u{3?Kjj2tWV=5P$##AOHaf
iKmY;|fB*y_009U<00Izz00bZa0SG_<0ucCb1bzaJdL}CX

literal 0
HcmV?d00001

diff --git a/examples/match_demo.nes b/examples/match_demo.nes
new file mode 100644
index 0000000000000000000000000000000000000000..772ecae55dae569bbaaf2ab0cab3a6e3699d344f
GIT binary patch
literal 24592
zcmeI)ziSjh6bJCxna%yE+}k@ZF*a)mfvAXxMUVrBfO>>QBKZeW7`PNd%2aX&wh>m+
z=?Q0XWWW&u))r#!P%zb%wkZs;k+rf=jPLE5<s#8u`R*N$H}hs^-+cDc=Jt)HNyicS
zwf>=}AC2qY;ZrMO5yVaqpVn4!xEu=|yV{mwN5^B@ii<MvzFE-|T|r;R{^$y6DN|kH
zcEwm%6uP2#Fx<=5wQ0L;8QAM_A)vh}oQjK_QSdkf9MZW0XLSxU`COT^GaP2~Ift_f
zhjaPdN&D5fI?dr~zHXAU^Bk__b3SKN9IkNi==4@Zo?VYBb}jNLuSUv<<U3`;sP`gK
z;nYq~q$fY1YxtEaWmBa}`Q?}u;nI$E68WxbJeuN(yF78ru5Fd=T8Fthj_gQj7duMs
zm$Q#?X1%1A?!vb`rd!G)YKPBuOgkxAhdQc7)$r1Qc6HKSU(u4G3YYtItCJK>WnxuE
z6&gq$%zerRE)9IH_*5zJfGfW7x5~yJX~tBJHxrCBGu{8y%!Pj1jLe#$4fV*Xg>2PE
zc&BeRsAV<UvP@gPM@y2Gzdze964T;HXLkM1oxMJK=G*L<$Cy<5%sqbQ3HZP5+8#Mc
zZIGUKBRo4uPr^Tk44>Y#M{hrJDN()BO}SZ|Flxn(RKeXHCPpnEl?v{RGHULl+@#_@
z6+atyx%sg9q-kW+s3!dlsKCm&rmYj#H4W>!SK6-Yg&AjioMLHr_=R4(Xho_O$=37M
zi<Z`hxF7%l2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb
z2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZaf&W%ubs*l@L1W%LFrE2E<31ns
zek1?K07xJJ0SG_<0uX=z1Rwwb2tWV=5P$##AOHafKmY;|fB*y_009U<00I#BX9Ru%
DKnHCh

literal 0
HcmV?d00001

diff --git a/examples/mmc1_banked.nes b/examples/mmc1_banked.nes
new file mode 100644
index 0000000000000000000000000000000000000000..3d281388f069b2aaee3093f985df97f169e32d3c
GIT binary patch
literal 57360
zcmeIyziSg=7{KxO-uIFwUA&|*jh)USfr^8OLy>?-K@Fwo&{Z%?B_i&fBo4O-S2~(X
zmf#D%Lcu@5v`f<|qoWRn>QK(fL9xDX(guG!3*R@%!*lQR-h0n|?#Rt+t8>aLh?8-|
zKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~
z0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**
z5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0
z0D+_R*WGAiHtHU28Ig!E@xtVEWRwdR6A>kTWO9iYC7H;G3o;Bo8_^XVVZWaF+7Z&&
zOm&3c5t)w2cEr@d;O%%_%Wh|EXt|AB#``h2xosJmt4TJr3v4)*Ou5X4z=hC-(OlML
zWf!WGxxCBHxUevp^ITSN;p}AYcl(uG^_&ZrC+p^1cHV_6lewbH=3ThtLSSu76bEK6
zE*KFP;~C?{C7Y@6X-|vvi%o@AeUYyAy@6V}y|Z$or~SIl#IhM4?lkmF-%B$_tgQEp
zmxjZlE>zZvaiPEW(#>wT+3DlmXX0XGaxr_EMpulu59}CxvRBG$Z^28;M#jD_#hLI<
zFA+)yl?Ot_fvw53qJzFn^P{~#xV@)zu=rk%s;zX^b|XgJWOr;WXYXakWa46Yzh}=I
z9-lYwYSXr+!ds);DLl*TLfbv|wkO+C>Y%OUFhBm-`!&<YK=O}0+cqlqPMRF`G(Pyg
zr>$Rl@)knd$QawX{;QEVNW`1vpMH(lcUyFG*X8C^MXNPGR#|_4kZLt4W&NtsYVn=i
zw8fz<9%{c)e_Vf3*Rrlv-M*qKG%_hg_LVM2_OKjvbKB);x$14t+L+rPe6(Vs8LOs!
z^3R(uno-0*4FU)tfB*srAb<b@2q1s}0tg_000IagfB*srAb<b@2q1s}0tg_000Iag
zfB*srAb<b@2q1s}0tg_000IagfB*srAb<b@2q5qmf$FY!b$7S6q#x<_QmyvTEqz!M
u3<MBB009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q7V|1ik@|V<J8P

literal 0
HcmV?d00001

diff --git a/examples/mmc3_per_state_split.nes b/examples/mmc3_per_state_split.nes
new file mode 100644
index 0000000000000000000000000000000000000000..f80e03987321101f8b2c8f5053cb55103264235e
GIT binary patch
literal 24592
zcmeI)KWGzi6bJD4yWi!KK&h8BHrhc>k<v;B5eJcgM?nn|bZ~Jqi;&r=Q;Ene(w}rR
zg`kH1z@JcXa!yhxwA10_SO-I0<eWPAr@r6Co&`G#%J*`-yu5dJdH4BU*4(~+cSeYi
z4!5QEz3^!@>>aEbQWPi=sFR_QHe6H`DmOF*B|?=84J|l<|J6{By2QIMKf2@?&SaO|
zF6Fx9bt%6We;6Ov=F1sRQJXI;+9q!^VKbrVg`(XJCotEP7jT=y36-}Q2j7OkhP39{
zY}$s|tX8zyX&dIVny^{PhO=4ixa(DH_q+|4v*TuLcEN_LS*>idb2ePE!Dksmksp<!
zax@jm;QqkeQPfw0_uYG%l5gB5Ew?EtZHrhos>8<3!T6MBk5a5X-r{|(6-QGef2*W@
zm9uxvVQ#%><~r81Bb<)o@CWIPisP4A;qJ=O?$VL2F7tO5-{cH6-VKaMoUO7J^L|oE
z8@Bw3%SDRXjbxzP$)piHzn_kGCMxrkx^y^4^DhtlczEo<Yg|qTemP7BrWD+I{xNX<
zN&Q)!4Qbcf$EEd&(L|qOFUSoW`*!EW_+5PatJr$gdff{7W+&3KCXcLTV_}m|nKaL{
z)#Xb11<lB>r%!Z?ALC}^^69cyxZ$kkPigtUjil%9#EF(!%X4R?mRCMHtK1xM^RsrF
z!S`W0vv%rQ+R0^L990SVcQMTqap)B`ro&saVx!8juoHjb1*29ZTah!KJ3PP!0SG_<
z0uX=z1Rwwb2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb
z2tWV=5P$##AOHafKmY;|fB*y_009X6R{{?=sXrLj7WE_DS*+ET?aeLM4*wSb?+}0h
u1Rwwb2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZa0SNp%0zUzmBXP_C

literal 0
HcmV?d00001

diff --git a/examples/palette_and_background.nes b/examples/palette_and_background.nes
new file mode 100644
index 0000000000000000000000000000000000000000..d65391d3ce7f538350e4e46a94f5b5990c5bbb57
GIT binary patch
literal 24592
zcmeI(ziSjh6bJD6vAG{8tQYUcu8OQd5`!sH2(dVH2`GmI8?mvFG{RkFC8P>xF^#a2
zCg2GNVR66_0{R~$7Qvj&ijA$HM=DthW1$$|?3p7G0yZ|uckdW>-n=)n_qi)xb2qQu
zI>k8~UJD=M@Nq4Scb*y+u^{3>R0)l=!*s;L$O%m$;$bur8a5?@6F&@#S(nk9n_pcf
z4Bg2tbGmG#%W_?o-%36X^4hfBstC;0C>PM)G~8CgyjF6By%JGAc(WEH+cqH>CM*vU
zVrQ6=CfizgtyBpuTTIDb@+sS9W6w5WvTe@NgBzwi<twRK`jhUNmYXb<bMMz;mObhg
zUCDP^DfT_>ZQgk~V%VIsZg}e3(!Q_#O((TM-v%8D`jp4B&=iFdIrnXyl2{hGVw1+`
zX-4Tooz$fwS0%Ho$~3D`v}!g~tteE93I<!;9~3<JhXRqEuyW7|8-Gsd4Ns6+!MlS_
z_`AUKT6NVn3(tyXp<}<q4i_CEbh{%(zc_dioU#ToE?gH&c~8rGj*>a2m!w+G?=Iz>
zajE6y&ti!d`?UB)JM%6topZ(Ln0x%plzZ&-#cW=kn0CwOFJ<#wb==L@CftH|!7cie
zuAT2$AO1RV0|5v?00Izzz>yJXJZd~?XwlHJL7k%vjEKsiE~R%TsaM<AQ&OWiy4y?Y
z(xgad_H~q5Ct1!CY$sW^on%>8T1-`_lceHmwq`p>M%^2as?_Gv5EoXf;f-;=TBEVh
zOTHSeSX0TS63yq$7tJu-!36;bKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb
z2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZa0SG|gzX>e&*xJn7`mBDaJG1rr
zqCIG_eq{b*h7Sq>2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uVSv
G0>1&`5Xc4q

literal 0
HcmV?d00001

diff --git a/examples/platformer.nes b/examples/platformer.nes
new file mode 100644
index 0000000000000000000000000000000000000000..0ed5185196d0cb27f2c24d212db299957ea49af3
GIT binary patch
literal 24592
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
AzW@LL

literal 0
HcmV?d00001

diff --git a/examples/scanline_split.nes b/examples/scanline_split.nes
new file mode 100644
index 0000000000000000000000000000000000000000..5f9570837c1aa0d0ee1b463e3cd1ff5b92ab3325
GIT binary patch
literal 24592
zcmeI)ziU%b6bJBg?|pemB<M?0)7a@LQmi_tI1~x^C@4W{7Z)eVBE-MIP9+`QB3$X<
zV1z&kx!@K0KcpE1J7sjNgP|@GCkMrPPC`Ni|AE5y<#BR;-1l<xd6~2I;K_<o3C)h}
z&)wwpa?(A0=gCrRRctRN-blD*DX~G~b5<oblX$wR<LH;CE_H}c<^Oa@d(KRUf(~Um
z6m}?kGW;@K*W%mx&{B(UtXe)RnUYLd+P8FkpksgEhB1#hT(DWmI7AX+36owZSw+I?
zyqA~kl7zK+Pf1pkaCzSQ-~E<kdR4;R`MMR!u1mN#@0BFGBH@mNh-EybQCjrdY02-W
zWv)#8?9jio)VGSy<EM_szqw7$e4=q_^YP)oS2VgbF+1U7_>*V(QS`Cs)S4P+U8(v)
zrzI}56zkunMUIQI6lI<SQpmEhulDl3+7|w{(rvB%wYJft{Pg9@y}T<gOkHVl8rh6c
zXJX!<E6$2W{Z;*Ko%?hw+aDHtg;AkT!!SNQ+`KX1v-!UHp_%Zu3zG%s7ry!C)?jjF
zBaP~lXWrxo-ADsoY`VFJdM{gb=6R5sFgO~HotclqVAVLY{#EbsaKyv!E@;HJ2b0Y>
zU3W&dWMZ%FQo_HS3V%L_ZtkFxJX%!;%N%n@!yjIy)J#n?)ze)jr#K)00SG_<0uX=z
z1Rwwb2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb2tWV=
z5P$##AOHafKmY;|fB*y_009V`8G$zg>Yp3bHr%djZ`5i#vhkhT?0*694gm;200Izz
p00bZa0SG_<0uX=z1Rwwb2tWV=5P$##AOHafKmY;|fWX-i_zSQL?hOC{

literal 0
HcmV?d00001

diff --git a/examples/sprites_and_palettes.nes b/examples/sprites_and_palettes.nes
new file mode 100644
index 0000000000000000000000000000000000000000..e307e0a56615cdd2ffd246575da18cd4ccdf0916
GIT binary patch
literal 24592
zcmeI)zl#$=6bJA(Gn-#F?uIiLk3&|Gz=?&3#UTNQ10@_{<3DhX690p%j+0{=VdP39
zY_mAv2>BoMI<HD;YhgGWiIs(t_}+zVb(NLHcN4z*=Do?V`}qU%<l)l|rKr00zm)d%
zx-A!PBYDcb%Ka4^jl>;K)+aVLy|TV$Bi+_{`a4od1@TwKc|kgIWeQ3Psuff(sBt#=
zy4-ij$BlI!ANYFCXLDTk4XHR%iCp5mSC^_I(W`nbsjf<FRXrtDCUL#$U3A`>Om9lu
ztM+Y3bxY!Y)oV+2L*lMP%5NVJT^jdY7Rj}p2{ik|6$SH|X6Es=PbHnd^%-B2Up#3A
zwWVf_kak~am-0f(V*C4Yk?<muNyd|=EM$^R+oA1iLQ%^@>b2p@n2^0|g>1y6YNXh8
zq;*I~Mo(MIkNh}wN4)7sHt7pD@gur~pUafZNBX$Y4dz+mOg%ZB%!1iljp|9y1hf53
zAM<d^!yh5p8@w9483a8DW+2a#NA1^aRK8<**|BAF+_AeoHD2dzo=$#7<!I>4(COj(
z;fJBM3tSL@00bZa0SG_<0uX=z1Rwwb2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz
z00bZa0SG_<0uX=z1Rwwb2tWV=5P$##AOHafKmY;|fB*y_@Gk<FPUz$ANq;B245OWX
z|3J<-=yx~gi^Y7iyZVEG=gTgw?yElT5P$##AOHafKmY;|fB*y_009U<00Izz00bZa
V0SG_<0uX=z1Rwwb2>d?+e*w5<P167X

literal 0
HcmV?d00001

diff --git a/examples/state_machine.nes b/examples/state_machine.nes
new file mode 100644
index 0000000000000000000000000000000000000000..9b438f45c23e3eed39364ac0335a7066a93b4ed9
GIT binary patch
literal 24592
zcmeI)ziSjx5C`!0-fS+rN5EC$<wp@#kx0Zs#Nv<x*MM?JkbwWd6%jB0L8=go1(Cdv
z(i5&ZvfvX|Ec^q!q{*ea(l&)5HeszS6ywY#Sq_c%!gueO%)B>mclL9A9zS?8t+gty
zl~0{`V<PSxzjn&1$m+;mjvYz3WmRmw*!fn+b|iM{risGuPIXjU@mIT_ZDky1)K*?w
zjkHy%tws;~`zL*Ce7np<?w&10d~XgH?5JcMLJ5(C!CFbOiiFu>Es$(V!d$VYCA%o$
zO0jm{{l;bYnuI$=-?U^mB-}05E=hJ(!fgp5zr9mQm{3&hrYirzg-WTX@`;}A)53nY
zXZX*?_QF(`-$PTQqXr0veD%L^cW|W1Ep7#Fu_ZJuZCb{-r52fk;N+8O>dkD9IJL0a
zbvmDM>)gHmukKnNyqErW($5J$H`Q}tUUr%X-R<%)GS8az$?e*JxT8#sv+@5Nkq_%U
z$b6byHhhLlGbpQHPD`K5fTRp$*Bg}59MDmjvNH8PoQ`yVn@75shLg+XBy@(yc_B7@
zDB|%H*HxK~@3tkk9C}NB{1A%Fuk6@)o@3;eSZHbJtXmm6nvGF!<#e3Bj5G9Hp5u3>
z#FMc){zJ1lI+@Z_FQJmR*UwXGoNbl7SxTw;*=+LW0dF3qUZei9{;HmudP;Sklp<&B
zc<i*T#9UV5j-OTHN3%Mc;OOu5zw&RRnh7-%(|pr>+l=F5To8Z&1Rwwb2tWV=5P$##
zAOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb2tWV=5P$##AOHafKmY;|
zfB*y_009U<00Izz00jOjaD7L8e6~}YPoJl)`C4sN8dqz@KL$Vo0SG_<0uX=z1Rwwb
k2tWV=5P$##AOHafKmY;|fB*y_009U<00Izzz<(p~3;j2fe*gdg

literal 0
HcmV?d00001

diff --git a/examples/structs_enums_for.nes b/examples/structs_enums_for.nes
new file mode 100644
index 0000000000000000000000000000000000000000..553f6d05bccad2de26f885d8e6c66ebe081b2eb8
GIT binary patch
literal 24592
zcmeI)&ubGw6bJB`d7EU{9E?&^?P(PWR0Kslhy+{;N|5*i{0Dka$kAg@B_8%7OwG{<
z3$k>;DeRvhnBH1Yauhsyu=EtxlLy86UP6~1{0GGECVcZ|-ez{@L(X}4_sNRZs=78l
z=gHP`k{`YC%BtAv*q%!~NnE!ou|eWPs}oyGyt-=Q)=#f;l_`E}|2tF0b48g7GF8h|
zJyVUt>DR@5Ltd^hvA<*MF|W;W+BT%(Xi3Bp^SQcIZHZ1b7fE$NVzrvnQk{{wSk3)y
zy(Q^hmbh8nw<6UQiQCoOS*b2b+>mJT>HUUP<eytjyi-G#$ZH$Ope9wFWZUE)+mQTQ
z8<C&dQ{<nfEw55?s{F;D%F&)GssCV-t2xpkU(+AliJV?FW%!97VR%&@=`x)0h!&%e
zd-EsHdja=&B+oB2ZATnq5g%(aHl|QCCUX!iUcA936;0X;Mm4YcUnX9c*Lb}1zCr2G
zwYDSII`L&UJo#NcYf}H?<aqnM@idV0<l#LtYMgiUEJ&#y>`zNa>&LBn&>=^+zL^m>
z54bsV!Fumy?{&|ao}(V`h+;nGQo<)_^UsGP4~uqkzoUy~&TxPF-Ro2hQW~UY@NTd(
zNRlI55P$##AOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb2tWV=5P$##
zAOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1pYgLN4x67tKIIJd*Q}w-R`CU
zY<8<Z20#G;2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uX?}KO^u5
DtK$;v

literal 0
HcmV?d00001

diff --git a/examples/two_player.nes b/examples/two_player.nes
new file mode 100644
index 0000000000000000000000000000000000000000..26112727982cba5f446e89f2fa155f1e8174a1a0
GIT binary patch
literal 24592
zcmeI)JBt%h6bJD8m?V?ROkS&7jSm)AEJQ3833ypp2@-7l0^0~FEd^mocDc>M$d(%+
z&EN&EkWXN<Ng-^il(rTd)<(w4LUBDO(IJ8#K;b_L=bX7`&OCmZI*)grtV=2K?fHk)
zyj(Ns#Vaoo5hpTE8pdl5cM@Te!1yqcCMg&%ZmYQR&5KkF1%0LeF%-&ErH3LIio#G7
zhoW>o`?x%=N2eR9*gr^$F`b*jrKH3ag$jq5!(y$-Rg=R;zE<Yy3Wv>nO>z}+xSFs1
z?R<6a-r#UAKW?3?TO97^YgMkUak$H&LQn6Ft@vj)@+Y=Rx#oqf+lJLnWZ$V4PM?ZQ
zcW#bTv3UM-+Gby=Q+9GwW$Jx}vdq++b4dFU<$(4%_h|CPm<m%CcHix1B`<Bgb2#R!
zxNtFFrOfl3dA>%O=Q;EIyD=3!-*dgie4{hv`G$*Lmt8dApJX7_Kq*%lXf-b{KdwgI
z+G@AD+O40;tl&kbHt{mM?xL+vp*^69gVl*Y&e!-gv9p}0@kE~{`l}PG*B~<+(2eRe
ze5j5}mz{nZSX~UJv&`w;->qV>p`G43Q%BUCQ}eS6cH4*T<F-?6r`z=Y=-8{IZoEvI
z^iont!%@>b+K{6)is5wjg;Yh?>aJDYH{G{gV=k~k00Izz00bZa0SG_<0uX=z1Rwwb
z2tWV=5P$##AOHafKmY;|fB*y_009U<00Izz00bZa0SG_<0uX=z1Rwwb2tWV=5P$##
zAOHafKmY;|_=g4DM4X&WTHCJg2HUOH9^dL-EB|8v6cB&_1Rwwb2tWV=5P$##AOHaf
eKmY;|fB*y_009U<00Izz00bZa0SNpz0zU!rqvaa_

literal 0
HcmV?d00001

diff --git a/examples/uxrom_banked.nes b/examples/uxrom_banked.nes
new file mode 100644
index 0000000000000000000000000000000000000000..dbff6c6b715ec46fa3284497ed33b1efc1101f10
GIT binary patch
literal 90128
zcmeIyX>=1+7{>8COVY%RNhmE;#R0KeL`6ic5M`)>5i5$guXRD=j*42h3d*<ug9Swi
z8kfi@gI00hm4c$JTikIMl~^|%+(1Ffy;SnakACr-|4q&_@44@rdosT>XGV`0TNTl4
zv2k^>5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~
z0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**
z5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0
z009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{
z1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009IL
zKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~
z0R#|0009ILkOGZM^Um~2C*L_I5T39-&GvdYfuUlcCmhdof|#c{Uc?E+0Nu9M1R^hT
zLVmSiT~6qMtc;v6b0U%x(VQsjC@kxmn<$TK(d}TE7q#WtGP-$Xs*+);uvKi>i>j(Z
zMRjQ}uBu)tYD#;WsuC*tl=lAZymHm;r($qvu1Zz?RSYTZB~{f|#UK@yy!)WhwSw_(
zA`ouUHGC1Sm6h;~HW3>2y<78Q!(DgCRahlE@nX_XwhayA3nGE2AJZCWp{aiAYc*P^
z7cF_!!|uM-ru{QAL5=83RKt`533-jlfkbIwR@XqnPt1+`iL4UNYI;`JeJg9|#dz08
z{uS5q!p;Vv>4q7Jmc`<mY`WRzTXeG$$?oMnDk^*Ss@ig^t$S}{_vyQBzwN5G-=U`e
zjsteud6$8^4%%(-?tAQ6yVsDRslE3Z<_xdfcfS!M_fH=%>cIMgMjw30m_x@NcK8uT
z9(D9F#~ye52`4t3bn+>ujyvu2%o%5%b@n;uo;Uvd3oe{+(Z!cEUV7Q(S6tb2)x=3x
zUo+Xg_PXnDm@;*mH~q%u88dIXdDbnr&d$!c?e^Rqciwe({+_x1z4y%v=HLH7%YzRs
zc=(Y=AA9_XC!c!ynP;DS{)HD8wk}%y(#uO;d9|(mwb$Qx^R2?$@4Wlo`yYI`^rMeI
z`Si2TzxZ<5S6_d#y!dU$ci;c;<4-Go4p;v2>u<mRv1;|7f2~>j_qtA3aU1#ANWHnN
zr*DiiT_b9?7ee1?*w~7i)rN1>F4vo7vnZP@e6t}vB|SUs>uKLe%SY0%1Klfk0?n(C
z&$*0ztfj&kRjsvD%8a!aRtB0YGOm$v^~}7?{EXx9_CNpu1Q0*~0R#|0009ILKmY**
z5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0
z009L4GlA8M#KPLesXBj>pRG%!n$*EfDZxSj0R#|0009ILKmY**5I_I{1Q0*~0R#|0
T009ILKmY**5I_Kd|DC{k_Il-0

literal 0
HcmV?d00001

diff --git a/scripts/pre-commit b/scripts/pre-commit
index af6ada2..e9539d1 100755
--- a/scripts/pre-commit
+++ b/scripts/pre-commit
@@ -15,4 +15,28 @@ cargo clippy --all-targets -- -D warnings
 echo "  Running tests..."
 cargo test --all-targets
 
+# Committed ROMs must match their .ne sources — the compiler is
+# deterministic, so any example whose on-disk .nes differs from a
+# fresh build means someone edited the .ne file but forgot to
+# rebuild. Rebuild each to a tmp path and fail if any differ, then
+# point the user at the exact `cargo run` command to fix it.
+echo "  Checking committed ROMs match .ne sources..."
+cargo build --release --quiet
+tmp=$(mktemp -d)
+trap 'rm -rf "$tmp"' EXIT
+stale=0
+for f in examples/*.ne; do
+    name=$(basename "$f" .ne)
+    ./target/release/nescript build "$f" --output "$tmp/$name.nes" >/dev/null
+    if ! cmp -s "examples/$name.nes" "$tmp/$name.nes"; then
+        echo "    STALE: examples/$name.nes"
+        echo "           rerun: cargo run --release -- build $f"
+        stale=1
+    fi
+done
+if [ $stale -ne 0 ]; then
+    echo "one or more committed ROMs are out of date"
+    exit 1
+fi
+
 echo "All pre-commit checks passed."