Name Print Screen, Menu and media keys as the backends do; repair more legacy key names

[JRufer]

Follow-up to #157. It brings over the parts of the closed #158 that #157 didn't cover.

Problem

• Some keys are still saved under names no backend reports. The recorder names any key it has no rule for after its DOM code:

  • Print Screen is saved as KEY_PRINTSCREEN;
  • the Menu key as KEY_CONTEXTMENU;
  • Mute as KEY_AUDIOVOLUMEMUTE, and likewise for the other media keys.

  The backends report KEY_SYSRQ, KEY_COMPOSE, KEY_MUTE and so on, and the key matcher compares names exactly, so these shortcuts never fire.

• TTS stop keys saved before v0.7.1 can still be broken. The old TTS stop-key recorder saved letters without the underscore (KEYV). Code review: fix TTS response-pipe bug, dedupe transcription finishing, trim hot-path I/O #157 fixed the recorder but did not repair stop keys already saved that way.

Changes

• src/lib/keys.ts: maps PrintScreen → KEY_SYSRQ, ContextMenu → KEY_COMPOSE, and the seven media keys to their evdev names. The wizard gets keycap labels for these (PrtSc, Menu, Mute, Vol +, …).

• Load-time repair (canonical_key_name): now also repairs:

  • the DOM names above;
  • KEY_NUMPADENTER → KEY_KPENTER;
  • KEYA…KEYZ → KEY_A…KEY_Z.

  This applies to both the TTS stop key and bindings.toml.

• Deliberately not repaired: KEY_*, which could be the keypad * or Shift+8. The repair Record punctuation, keypad and right-side modifier keys under evdev names #158 made could move a binding to the wrong key.

• Portal (trigger.rs): every key in keymap::NAMES now has a keysym. The new ones are:

  • Print, Menu, Pause, Num Lock and Scroll Lock;
  • the ISO key beside left Shift (less);
  • the XF86 media keys.

  Before this, the portal refused shortcuts that used these keys.

Tests

• tests/svelte/keys.test.ts (new): reads keymap::NAMES from win_keys.rs and checks that every key name the recorder can produce is in it. KEY_KPEQUAL is the one allowed exception: it is a valid Linux name with no Windows scan code. I checked that this test fails on the old mapping (it reports KEY_PRINTSCREEN and KEY_AUDIOVOLUMEMUTE).
• Keycaps: every mapped key must have a readable keycap label.
• Portal (trigger.rs): every name in keymap::NAMES must translate to a keysym.
• Migration: covers the new repairs, and checks that real names (KEY_A, KEY_KP1, KEYBOARD) and the ambiguous KEY_* are left alone.

Verification

• cargo test passes for voxctrl-config, voxctrl-hotkeys and voxctrl-routing.
• cargo clippy --all-targets on those crates reports no warnings.
• svelte-check reports 0 errors and 0 warnings.
• vitest passes 264/264.
• dist/ is rebuilt.

🤖 Generated with Claude Code

https://claude.ai/code/session_015v84hAqhDBdwy7Q49gAWBR

---

Generated by Claude Code