kbd-iced 0.1.0

iced bridge for kbd — converts iced key events and modifiers to kbd types.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

# kbd-iced

[![crates.io](https://img.shields.io/crates/v/kbd-iced.svg)](https://crates.io/crates/kbd-iced)
[![docs.rs](https://docs.rs/kbd-iced/badge.svg)](https://docs.rs/kbd-iced)

[`kbd`](https://crates.io/crates/kbd) bridge for [iced](https://docs.rs/iced) — converts key events and modifiers to `kbd` types.

This lets GUI key events (from iced) and global hotkey events (from [`kbd-global`](https://docs.rs/kbd-global)) feed into the same `Dispatcher`. Useful in iced apps that want both in-window shortcuts and system-wide hotkeys handled through a single hotkey registry.

Iced defines its own W3C-derived key types: `key::Code` for physical key positions and `key::Physical` wrapping `Code` with an unidentified fallback. This crate only converts physical keys — they are layout-independent and match `kbd`'s model.

```toml
[dependencies]
kbd = "0.1"
kbd-iced = "0.1"
```

## Extension traits

- **`IcedKeyExt`** — converts an iced `key::Code` or `key::Physical` to a `kbd::Key`
- **`IcedModifiersExt`** — converts iced `Modifiers` to a `Vec<Modifier>`
- **`IcedEventExt`** — converts an iced keyboard `Event` to a `kbd::Hotkey`

## Usage

```rust
use iced_core::keyboard::{key::Code, Modifiers};
use kbd::prelude::*;
use kbd_iced::{IcedKeyExt, IcedModifiersExt};

let key = Code::KeyA.to_key();
assert_eq!(key, Some(Key::A));

let mods = Modifiers::CTRL.to_modifiers();
assert_eq!(mods, vec![Modifier::Ctrl]);
```

## Key mapping

| iced | kbd | Notes |
|---|---|---|
| `Code::KeyA` – `Code::KeyZ` | `Key::A` – `Key::Z` | Letters |
| `Code::Digit0` – `Code::Digit9` | `Key::DIGIT0` – `Key::DIGIT9` | Digits |
| `Code::F1` – `Code::F35` | `Key::F1` – `Key::F35` | Function keys |
| `Code::Numpad0` – `Code::Numpad9` | `Key::NUMPAD0` – `Key::NUMPAD9` | Numpad |
| `Code::Enter`, `Code::Escape`, … | `Key::ENTER`, `Key::ESCAPE`, … | Navigation / editing |
| `Code::ControlLeft`, … | `Key::CONTROL_LEFT`, … | Modifier keys as triggers |
| `Code::SuperLeft` / `Code::Meta` | `Key::META_LEFT` | iced's Super = kbd's Meta |
| `Code::MediaPlayPause`, … | `Key::MEDIA_PLAY_PAUSE`, … | Media keys |
| `Code::BrowserBack`, … | `Key::BROWSER_BACK`, … | Browser keys |
| `Physical::Unidentified(_)` | `None` | No mapping possible |

## Modifier mapping

| iced | kbd |
|---|---|
| `CTRL` | `Modifier::Ctrl` |
| `SHIFT` | `Modifier::Shift` |
| `ALT` | `Modifier::Alt` |
| `LOGO` | `Modifier::Super` |

## License

kbd-iced is licensed under the MIT license. See the [`LICENSE`](../../LICENSE) file for more information.