imjasonh/nescript
1
0
Fork 0
mirror of https://github.com/imjasonh/nescript synced 2026-07-18 14:45:58 +00:00
Code Activity

Update future-work.md to reflect IR codegen completion

Browse source
This commit is contained in:
Claude 2026-04-12 10:24:12 +00:00
parent 1ede169f1e
commit 7e94cf37e3
No known key found for this signature in database
1 changed files with 24 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

33
docs/future-work.md
View file

@ -370,17 +370,32 @@ These items were documented as future work but have since been implemented:
`Statement::DebugAssert`, codegen emits runtime writes to $4800 when `Statement::DebugAssert`, codegen emits runtime writes to $4800 when
`--debug` is set, stripped in release mode `--debug` is set, stripped in release mode
- **--debug CLI flag wired** — threads through `CodeGen::with_debug` - **--debug CLI flag wired** — threads through `CodeGen::with_debug`
- **IR-based codegen** — `src/codegen/ir_codegen.rs` walks `IrProgram` and
emits 6502, handling all IR ops (load/store, arithmetic, comparisons,
arrays, calls, draws, input, control flow). Enabled via `--use-ir` flag;
all 7 examples compile through it. Default is still AST codegen while
IR path is experimental.
- **IR lowering bug fixes** — `ReadInput` now has a destination temp,
`ButtonRead` uses the proper input temp, logical AND/OR use a new
`emit_move` helper instead of the buggy raw VarId temp storage
- **Asset pipeline @binary / @chr loading** — `resolve_sprites()` reads
raw binary files and converts PNGs via `png_to_chr()`. Missing files
are silently skipped (documentation-friendly)
### Remaining priority order ### Remaining priority order
For someone picking up this codebase, the recommended order of work: For someone picking up this codebase, the recommended order of work:
1. **IR-based codegen** (#1) — enables optimizer to affect output 1. **Make IR codegen the default** — currently behind `--use-ir`. Once
2. **Asset pipeline wiring for PNG files** (#9) — `@chr("file.png")` and it matches AST codegen for all code paths (state dispatch, multi-OAM,
`@binary("file.bin")` are parsed but not resolved at compile time debug statements), switch over and delete AST codegen.
(only inline sprite data works) 2. **IR codegen: state dispatch** — currently no main loop / dispatch
3. **Audio** (#12) — SFX/music driver table; IR codegen only generates function bodies. Need to emit the
4. **on_scanline for MMC3** (#11) — scanline IRQ handlers state machine dispatch like the AST codegen does.
5. **Language features** (#13) — structs, enums, fixed-point 3. **IR codegen: multi-OAM** — currently all draws use slot 0
6. **Register allocator** (#20) — proper A/X/Y allocation 4. **Audio** — SFX/music driver
7. **Inline assembly** (#14) — `asm { }` blocks 5. **on_scanline for MMC3** — scanline IRQ handlers
6. **Language features** — structs, enums, fixed-point
7. **Register allocator** — proper A/X/Y allocation to replace
zero-page spills used by the current IR codegen
8. **Inline assembly** — `asm { }` blocks