feat(core): add a Super modifier to custom shortcut chords

[sungyongcho]

Summary

CustomShortcut / HoldShortcut chords have no way to press the platform logo key. Cmd (and its Meta / Win aliases) is folded into Control on Linux and Windows, so a chord like Super+End cannot be written, and every GNOME / KDE shortcut that is bound to Super is out of reach from a mouse button. This adds a distinct Super modifier that always presses the logo key: KEY_LEFTMETA on Linux, the Windows key on Windows, Command on macOS.

Cmd keeps its current cross-platform meaning, so existing configs are unchanged.

Changes

• openlogi-core: KeyCombo gains MOD_SUPER (bit 4), has_super(), the Super parser token, and Super in rendered_label(). Meta / Win stay aliases of Cmd. Wire deserialization accepts the new bit through ALL_MODIFIERS. New test parses_super_as_its_own_modifier.
• openlogi-inject: Super in immediate chords maps to KEY_LEFTMETA on Linux, VK_LWIN on Windows, and CGEventFlagCommand on macOS. For HoldShortcut chords, Linux and Windows get a HeldKey::Super owner; on macOS the logo key is Command, so Super chords own the existing HeldKey::Command — one physical key, one owner, the same way Cmd and Ctrl already share HeldKey::Control on Linux/Windows. Tests cover both shapes (super_and_command_share_one_physical_output, super_plus_command_owns_the_physical_key_once, super_is_distinct_from_control).
• docs: CONFIGURATION.md documents the chord modifiers and what Cmd vs Super press on each platform.

Testing

Local gate on Linux (Ubuntu 26.04, rustc 1.98.1):

cargo test -p openlogi-core -p openlogi-inject
cargo xtask ci
cargo xtask ci clippy-windows

cargo xtask ci: rustfmt, publish closure, clippy, MSRV (linux), rustdoc (non-GUI crates), tests (linux), wasm — all pass. clippy-windows (the x86_64-pc-windows-gnu proxy) passes. Not run on this host: typos, shell, tests (macos), cargo-deny. The macOS cfg block was hand-audited against master (every HeldKey match stays exhaustive) but was not compiled.

Hardware: runtime-tested on Linux (GNOME 50, Wayland) with an MX Master 3 over a Bolt receiver. Gesture button Left = { CustomShortcut = "Super+Shift+Left" } / Right = "Super+Shift+Right" moves the focused window between monitors, and Super+End reaches GNOME's "move to last workspace". Not runtime-tested on macOS or Windows.

Fixes #724

[greptile-apps]

Confidence Score: 5/5

The PR appears safe to merge; the previously reported macOS held-key aliasing problem is resolved and no new actionable issues were found.

Summary

Adds a distinct Super modifier for custom shortcut chords while preserving the existing cross-platform behavior of Cmd, Meta, and Win.

• Extends KeyCombo parsing, serialization validation, labels, and tests.
• Maps Super to the platform logo key across Linux, Windows, and macOS.
• Shares physical-key ownership between Super and Command on macOS to prevent duplicate or premature held-key transitions.
• Documents platform-specific modifier behavior.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart LR
    Config["Shortcut configuration"] --> Parser["KeyCombo parser"]
    Parser -->|"Super bit"| Injector{"Platform injector"}
    Injector -->|"Linux"| Linux["KEY_LEFTMETA"]
    Injector -->|"Windows"| Windows["VK_LWIN"]
    Injector -->|"macOS"| Mac["Command flag / HeldKey::Command"]

Loading

_{Reviews (5) · Last reviewed commit: "fix(inject): share the Command owner bet..."}