Struct Keymap 

pub struct Keymap { /* private fields */ }

Implementations

impl Keymap

pub fn defaults() -> Self

Built-in defaults. Mirrors the historical hard-coded set in src/tui/mod.rs before issue #87. Adding a default binding here automatically surfaces it in gwm tui keys and the help overlay.

pub fn apply_override( &mut self, action: Action, chords: Vec<Vec<KeyStroke>>, ) -> Result<()>

Replace the chords bound to action with chords and re-validate the full keymap. An empty Vec unbinds the action. The validation pass rejects:

• the same chord wired to two different actions (conflict);
• a chord that is a strict prefix of another (g while g g is bound) — see the module-level chord/prefix policy note.

Returns Err(GwmError::Config(_)) on failure; the keymap is left untouched on error so callers can surface the message and move on.

pub fn lookup(&self, keys: &[KeyStroke]) -> ChordResolution

Resolve a pending-keys buffer against the keymap.

pub fn list(&self) -> Vec<Binding>

Snapshot the resolved keymap for gwm tui keys / help overlay. Order matches the declarative define_actions! invocation so the rendered table stays stable across runs.

pub fn primary_chord(&self, action: Action) -> Option<String>

The canonical rendering of the first chord bound to action, or None when the action is unbound. Used by UI copy that names a key inline (e.g. pane titles such as Issue / PR [F], issue #224) so the hint tracks user overrides under [tui.keys] instead of hard-coding a default that may have been rebound. A multi-chord action returns its first chord in declaration order, matching what gwm tui keys lists first.

pub fn keys_display(&self, action: Action) -> String

Every chord bound to action, comma-joined ("j, Down") or empty when unbound — the help-overlay / Keys-tab row form. Mirrors crate::tui::modal_keymap::ModalKeymap::keys_display.

Trait Implementations

impl Clone for Keymap

fn clone(&self) -> Keymap

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Keymap

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.