fix: demo arrow keys on Widgets tab move cursor instead of switching tabs; +12 keybinding dispatch tests

src/components/keybindings.lisp

@@ -46,6 +46,21 @@
 ;;; ---------------------------------------------------------------------------
 ;;; Dispatch
 ;;; ---------------------------------------------------------------------------
+;;; dispatch-key-event — main entry point for keymap-based dispatch.
+;;;
+;;; IMPORTANT: This function is NOT called by the demo's event loop
+;;; or by any built-in widget event handlers.  Users who want to use
+;;; the keymap system MUST call dispatch-key-event explicitly in their
+;;; own event loops, e.g.:
+;;;
+;;;   (defun handle-event (event)
+;;;     (or (dispatch-key-event event)
+;;;         (handle-text-input my-input event)
+;;;         ...))
+;;;
+;;; Chords ((:ctrl+x :ctrl+s)) are not yet supported; only single
+;;; key specs work.  The *chord-timeout* and list-of-lists syntax
+;;; are reserved for future implementation.
 (defun dispatch-key-event (event &key component)
   (labels ((try-keymap (km)
              (when km