Struct ModalKeymap 

pub struct ModalKeymap { /* private fields */ }

The resolved contextual keymap: every modal verb with its keys. Built from ModalKeymap::defaults then layered with user overrides via ModalKeymap::apply_override.

Implementations

impl ModalKeymap

pub fn defaults() -> Self

Built-in defaults — mirror the historical hard-coded modal routing in src/tui/mod.rs before issue #219.

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

Replace the keys bound to action with keys and re-validate the action’s context. An empty Vec unbinds the verb.

Validation rejects the same stroke wired to two different verbs in the same context (cross-context reuse is fine — that is the whole point). A default binding in the same context silently vacates any stroke the override claims, mirroring the global keymap: explicit user intent wins over a shipped default.

pub fn resolve( &self, ctx: KeyContext, stroke: &KeyStroke, ) -> Option<ModalAction>

Resolve a single keystroke against the bindings of ctx. Returns the matched verb, or None when nothing in this context binds the stroke (the caller then applies the context’s text-input / default fallback).

pub fn bindings_for(&self, ctx: KeyContext) -> Vec<&ModalBinding>

Every binding whose verb lives in ctx, in declaration order.

pub fn list(&self) -> &[ModalBinding]

Snapshot of every binding, declaration order, for gwm tui keys / the help overlay / gwm doctor.

pub fn primary_key(&self, action: ModalAction) -> Option<String>

The first key bound to action, rendered for an inline hint (the statusbar chip / help-overlay footer). None when the verb is unbound — the caller drops it rather than advertise a phantom key. Mirrors crate::tui::keymap::Keymap::primary_chord.

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

Every key bound to action, comma-joined ("n, Esc") or empty when unbound — the help-overlay row form, matching the global keymap’s keys_for rendering.

Trait Implementations

impl Clone for ModalKeymap

fn clone(&self) -> ModalKeymap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModalKeymap

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

Formats the value using the given formatter.

impl Default for ModalKeymap

fn default() -> Self

Returns the “default value” for a type.