From 4fd83f83163754c5b647c4408b5ee70c0a804afb Mon Sep 17 00:00:00 2001
From: sommerfeld <sommerfeld@sommerfeld.dev>
Date: Wed, 13 May 2026 13:43:23 +0100
Subject: feat(sway): altgr-intl + compose key for PT typing

- xkb variant altgr-intl: AltGr dead keys + direct Euro on AltGr+5.
  Preserves bare ' " ` ~ ^ for code/shell.
- Compose on Right Ctrl (compose:rctrl). Leaves Right Alt for AltGr.
- New dot_XCompose with %L include + PT-PT guillemets, Euro, ordinals,
  em/en dashes, ellipsis.
- KEYBINDS.md: new Typing / Input section with AltGr + Compose cheatsheet.
---
 KEYBINDS.md | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

(limited to 'KEYBINDS.md')

diff --git a/KEYBINDS.md b/KEYBINDS.md
index 95db3a6..1988f6e 100644
--- a/KEYBINDS.md
+++ b/KEYBINDS.md
@@ -341,3 +341,46 @@ Mod key: `Super` (Mod4). Only personal additions beyond sway defaults listed.
 | `Super+z` then `w`      | Display QR for clipboard (wqr)                    |
 | `Super+z` then `r`      | Scan QR via webcam, copy to clipboard (rqr)       |
 | `Super+t`               | Toggle Thunderbird (tiled on current workspace)   |
+
+## Typing / Input
+
+Layout: `us(altgr-intl)` with Caps→Esc and Right Ctrl as Compose
+(`xkb_options caps:escape,compose:rctrl`). Normal `'` `"` `` ` `` `~` `^`
+behave as-is; accents only fire through AltGr or Compose.
+
+### AltGr (Right Alt) — one or two keystrokes
+
+| Keys              | Output                                  |
+| ----------------- | --------------------------------------- |
+| `AltGr+5`         | `€`                                     |
+| `AltGr+'` then v  | `á é í ó ú ý` (dead acute)              |
+| `AltGr+~` then v  | `ã õ ñ` (dead tilde)                    |
+| `AltGr+^` then v  | `â ê î ô û` (dead circumflex)           |
+| `` AltGr+` `` v   | `à è ì ò ù` (dead grave)                |
+| `AltGr+,` then c  | `ç` (dead cedilla)                      |
+| `AltGr+Shift+1`   | `¡`                                     |
+| `AltGr+Shift+/`   | `¿`                                     |
+| `AltGr+s`         | `ß`                                     |
+
+Capitals: hold Shift while pressing the target letter (`AltGr+'` then
+`Shift+a` → `Á`).
+
+### Compose (Right Ctrl) — discoverable, extensible
+
+Standard sequences from the system Compose table plus custom PT-PT extras
+in `~/.XCompose`. Press and release Compose, then the sequence.
+
+| Sequence            | Output             |
+| ------------------- | ------------------ |
+| `Compose ' a`       | `á` (any vowel)    |
+| `Compose ~ a`       | `ã` / `õ` / `ñ`    |
+| `Compose ^ a`       | `â` / `ê` / `ô`    |
+| `Compose , c`       | `ç`                |
+| `Compose < <`       | `«` (PT-PT)        |
+| `Compose > >`       | `»` (PT-PT)        |
+| `Compose = e`       | `€`                |
+| `Compose o _`       | `º`                |
+| `Compose a _`       | `ª`                |
+| `Compose - - -`     | `—` (em dash)      |
+| `Compose - - .`     | `–` (en dash)      |
+| `Compose . . .`     | `…`                |
-- 
cgit v1.3.1