# keymap/chord
Build the canonical chord string for a key event map. Named-key events produce modifiers in the fixed order `ctrl-alt-shift-key`; `:text` events yield the literal character.
## Syntax
[keymap/chord $event]
## Parameters
- `$event` — event map. Key events: `%{ :type :key-down :key :left :ctrl true :shift true :alt false }` (`:key` may be a keyword or a single-char string). Text events: `%{ :type :text :text "s" }`.
## Examples
[keymap/chord %{ :type :key-down :key :left :ctrl true :shift true }] # → "ctrl-shift-left"
[keymap/chord %{ :type :key-down :key :left :alt true }] # → "alt-left"
[keymap/chord %{ :type :key-down :key :x :ctrl true :alt true :shift true }] # → "ctrl-alt-shift-x"
[keymap/chord %{ :type :text :text "s" }] # → "s"
## Returns
Chord string. `nil` when `:key` is missing or not string/keyword-like, or when a `:text` event's text is not exactly one character. `%Err{:message}` when the argument is not a map.
## See Also
`keymap/get`, `keymap/lookup`, `keymap/set`