[nooga]

Summary

• Musical typing (docs/40). KEYS in the transport bar plays the selected track from the computer keyboard. There are three layouts:

  • PIANO: one chromatic row.
  • GRID: Push-style fourths, in key when a scale is set.
  • CHORD: in-key chords on the Z row under a melody on the A/Q rows; keys 1–6 pick the chord type.

  Octave is - =, velocity [ ] (on PIANO also Z X / C V). Held notes use the KEYS velocity (Engine.holdNoteVel). While KEYS is on, its keys switch off the panes' unmodified shortcuts on those keys; ⌘ combinations, text fields and menus still get them.

• Recording. With KEYS on, REC records into the clip open in the piano roll, or into a new "Take" clip. The clip grows by bars. Loop passes layer on top of each other, with one undo step per pass. Held notes draw growing, outlined in red.

• Piano roll. A pressed key lights faintly in every octave on the keys and the grid. In DRAW mode (or with ⌘ held) a ghost shows the note a click would add, with outlines in its other octaves. A picked scale stripes its keys (solid on the root), greys the keys outside it, and tints its rows in the track color.

• Transport. STOP and PLAY are separate buttons. STOP pressed again while stopped returns to the loop start, or to the song start when the loop is off.

Test plan

• zig build test: new unit tests for the layouts, chords, scale degrees, key claims, the velocity ladder, and the take recorder (presses, releases, loop-wrap split)
• App launches with the KEYS tile and the ■ ▶ buttons in the transport bar
• By hand: play each layout, record over a loop, check the octave echoes, ghost and scale marks on retina

🤖 Generated with Claude Code